diff --git a/google/cloud/compute/v1/compute.proto b/google/cloud/compute/v1/compute.proto index f739533..f77687a 100644 --- a/google/cloud/compute/v1/compute.proto +++ b/google/cloud/compute/v1/compute.proto @@ -1,4 +1,4 @@ -// Copyright 2020 Google LLC +// Copyright 2021 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -14,7 +14,7 @@ // Generated by the disco-to-proto3-converter. DO NOT EDIT! // Source Discovery file: compute.v1.json -// Source file revision: 20201122 +// Source file revision: 20210415 // API name: compute // API version: v1 @@ -371,7 +371,7 @@ message Address { // - `DNS_RESOLVER` for a DNS resolver address in a subnetwork // - `VPC_PEERING` for addresses that are reserved for VPC peer networks. // - `NAT_AUTO` for addresses that are external IP addresses automatically reserved for Cloud NAT. - // - `IPSEC_INTERCONNECT` for addresses created from a private IP range that are reserved for a VLAN attachment in an IPsec encrypted Interconnect configuration. These addresses are regional resources. + // - `IPSEC_INTERCONNECT` for addresses created from a private IP range that are reserved for a VLAN attachment in an IPsec-encrypted Cloud Interconnect configuration. These addresses are regional resources. enum Purpose { // A value indicating that the enum field is not set. UNDEFINED_PURPOSE = 0; @@ -380,8 +380,12 @@ message Address { GCE_ENDPOINT = 230515243; + IPSEC_INTERCONNECT = 340437251; + NAT_AUTO = 163666477; + PRIVATE_SERVICE_CONNECT = 48134724; + SHARED_LOADBALANCER_VIP = 294447572; VPC_PEERING = 400800170; @@ -433,7 +437,7 @@ message Address { // If this field is not specified, it is assumed to be PREMIUM. optional NetworkTier network_tier = 517397843; - // The prefix length if the resource reprensents an IP range. + // The prefix length if the resource represents an IP range. optional int32 prefix_length = 453565747; // The purpose of this resource, which can be one of the following values: @@ -441,10 +445,10 @@ message Address { // - `DNS_RESOLVER` for a DNS resolver address in a subnetwork // - `VPC_PEERING` for addresses that are reserved for VPC peer networks. // - `NAT_AUTO` for addresses that are external IP addresses automatically reserved for Cloud NAT. - // - `IPSEC_INTERCONNECT` for addresses created from a private IP range that are reserved for a VLAN attachment in an IPsec encrypted Interconnect configuration. These addresses are regional resources. + // - `IPSEC_INTERCONNECT` for addresses created from a private IP range that are reserved for a VLAN attachment in an IPsec-encrypted Cloud Interconnect configuration. These addresses are regional resources. optional Purpose purpose = 316407070; - // [Output Only] The URL of the region where the regional address resides. This field is not applicable to global addresses. You must specify this field as part of the HTTP request URL. + // [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 = 138946292; // [Output Only] Server-defined URL for the resource. @@ -518,6 +522,16 @@ message AddressList { } +// 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 = 16639365; + + // 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 = 352611671; + +} + // 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). @@ -557,6 +571,9 @@ message AllocationSpecificSKUAllocationReservedInstanceProperties { // Specifies amount of local ssd to reserve with each instance. The type of disk is local-ssd. repeated AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk local_ssds = 229951299; + // 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 = 350519505; + // 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 = 227711026; @@ -666,6 +683,9 @@ message AttachedDiskInitializeParams { // Specifies which action to take on instance update with this disk. Default is to use the existing disk. optional OnUpdateAction on_update_action = 202451980; + // Indicates how many IOPS must be provisioned for the disk. + optional string provisioned_iops = 186769108; + // 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 = 22220385; @@ -940,6 +960,37 @@ message AutoscalingPolicy { optional AutoscalingPolicyScaleInControl scale_in_control = 527670872; + // 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 = 355416580; + +} + +// +message ScalingScheduleStatus { + // [Output Only] The current state of a scaling schedule. + enum State { + // A value indicating that the enum field is not set. + UNDEFINED_STATE = 0; + + ACTIVE = 314733318; + + DISABLED = 516696700; + + OBSOLETE = 66532761; + + READY = 77848963; + + } + + // [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 = 34545107; + + // [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 = 97270102; + + // [Output Only] The current state of a scaling schedule. + optional State state = 109757585; + } // @@ -995,6 +1046,10 @@ message AutoscalerStatusDetails { SCALING_TARGET_DOES_NOT_EXIST = 122636699; + SCHEDULED_INSTANCES_GREATER_THAN_AUTOSCALER_MAX = 29275586; + + SCHEDULED_INSTANCES_LESS_THAN_AUTOSCALER_MIN = 398287669; + UNKNOWN = 433141802; UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION = 330845009; @@ -1058,7 +1113,7 @@ message Autoscaler { } - // The configuration parameters for the autoscaling algorithm. You can define one or more of the policies for an autoscaler: cpuUtilization, customMetricUtilizations, and loadBalancingUtilization. + // 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 = 221950041; @@ -1084,6 +1139,9 @@ message Autoscaler { // [Output Only] URL of the region where the instance group resides (for autoscalers living in regional scope). optional string region = 138946292; + // [Output Only] Status information of existing scaling schedules. + map scaling_schedule_status = 465950178; + // [Output Only] Server-defined URL for the resource. optional string self_link = 456214797; @@ -1164,6 +1222,24 @@ message AutoscalerList { // 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. + enum PredictiveMethod { + // A value indicating that the enum field is not set. + UNDEFINED_PREDICTIVE_METHOD = 0; + + NONE = 2402104; + + OPTIMIZE_AVAILABILITY = 11629437; + + } + + // 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. + optional PredictiveMethod predictive_method = 390220737; + // 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. @@ -1241,6 +1317,28 @@ message AutoscalingPolicyScaleInControl { } +// 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 = 422937596; + + // 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 = 270940796; + + // 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 = 212356902; + + // 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 = 365514414; + + // 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 = 375820951; + + // The time zone to use when interpreting the schedule. The value of this field must be a time zone name from the tz database: http://en.wikipedia.org/wiki/Tz_database. This field is assigned a default value of ?UTC? if left empty. + optional string time_zone = 36848094; + +} + // 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. @@ -1260,23 +1358,7 @@ message FixedOrPercent { // Message containing information of one individual backend. message Backend { - // Specifies the balancing mode for the backend. - // - // When choosing a balancing mode, you need to consider the loadBalancingScheme, and protocol for the backend service, as well as the type of backend (instance group or NEG). - // - // - // - If the load balancing mode is CONNECTION, then the load is spread based on how many concurrent connections the backend can handle. - // You can use the CONNECTION balancing mode if the protocol for the backend service is SSL, TCP, or UDP. - // - // If the loadBalancingScheme for the backend service is EXTERNAL (SSL Proxy and TCP Proxy load balancers), you must also specify exactly one of the following parameters: maxConnections (except for regional managed instance groups), maxConnectionsPerInstance, or maxConnectionsPerEndpoint. - // - // If the loadBalancingScheme for the backend service is INTERNAL (internal TCP/UDP Load Balancers) or EXTERNAL (Network Load Balancing), you cannot specify any additional parameters. - // - // - If the load balancing mode is RATE, the load is spread based on the rate of HTTP requests per second (RPS). - // You can use the RATE balancing mode if the protocol for the backend service is HTTP, HTTP2, or HTTPS. You must specify exactly one of the following parameters: maxRate (except for regional managed instance groups), maxRatePerInstance, or maxRatePerEndpoint. - // - // - If the load balancing mode is UTILIZATION, the load is spread based on the backend utilization of instances in an instance group. - // You can use the UTILIZATION balancing mode if the loadBalancingScheme of the backend service is EXTERNAL (except Network Load Balancing), INTERNAL_SELF_MANAGED, or INTERNAL_MANAGED and the backends are instance groups. There are no restrictions on the backend service protocol. + // 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. enum BalancingMode { // A value indicating that the enum field is not set. UNDEFINED_BALANCING_MODE = 0; @@ -1289,28 +1371,14 @@ message Backend { } - // Specifies the balancing mode for the backend. - // - // When choosing a balancing mode, you need to consider the loadBalancingScheme, and protocol for the backend service, as well as the type of backend (instance group or NEG). - // - // - // - If the load balancing mode is CONNECTION, then the load is spread based on how many concurrent connections the backend can handle. - // You can use the CONNECTION balancing mode if the protocol for the backend service is SSL, TCP, or UDP. - // - // If the loadBalancingScheme for the backend service is EXTERNAL (SSL Proxy and TCP Proxy load balancers), you must also specify exactly one of the following parameters: maxConnections (except for regional managed instance groups), maxConnectionsPerInstance, or maxConnectionsPerEndpoint. - // - // If the loadBalancingScheme for the backend service is INTERNAL (internal TCP/UDP Load Balancers) or EXTERNAL (Network Load Balancing), you cannot specify any additional parameters. - // - // - If the load balancing mode is RATE, the load is spread based on the rate of HTTP requests per second (RPS). - // You can use the RATE balancing mode if the protocol for the backend service is HTTP, HTTP2, or HTTPS. You must specify exactly one of the following parameters: maxRate (except for regional managed instance groups), maxRatePerInstance, or maxRatePerEndpoint. - // - // - If the load balancing mode is UTILIZATION, the load is spread based on the backend utilization of instances in an instance group. - // You can use the UTILIZATION balancing mode if the loadBalancingScheme of the backend service is EXTERNAL (except Network Load Balancing), INTERNAL_SELF_MANAGED, or INTERNAL_MANAGED and the backends are instance groups. There are no restrictions on the backend service protocol. + // 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. optional BalancingMode balancing_mode = 430286217; - // A multiplier applied to the group's maximum servicing capacity (based on UTILIZATION, RATE or CONNECTION). Default value is 1, which means the group will serve 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. Valid range is 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. + // 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. // - // This cannot be used for Internal TCP/UDP Load Balancing and Network Load Balancing. + // Not supported by: + // + // - Internal TCP/UDP Load Balancing - Network Load Balancing optional float capacity_scaler = 315958157; // An optional description of this resource. Provide this property when you create the resource. @@ -1332,45 +1400,40 @@ message Backend { // 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. optional string group = 98629247; - // Defines a target maximum number of simultaneous connections that the backend can handle. Valid for network endpoint group and instance group backends (except for regional managed instance groups). If the backend's balancingMode is UTILIZATION, this is an optional parameter. If the backend's balancingMode is CONNECTION, and backend is attached to a backend service whose loadBalancingScheme is EXTERNAL (except Network Load Balancing), you must specify either this parameter, maxConnectionsPerInstance, or 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. Not supported by: // - // Not available if the backend's balancingMode is RATE. Cannot be specified for Network Load Balancing or Internal TCP/UDP Load Balancing, even though those load balancers require a balancing mode of CONNECTION. + // - Internal TCP/UDP Load Balancing - Network Load Balancing optional int32 max_connections = 110652154; - // Defines a target maximum number of simultaneous connections for an endpoint of a NEG. This is multiplied by the number of endpoints in the NEG to implicitly calculate a maximum number of target maximum simultaneous connections for the NEG. If the backend's balancingMode is CONNECTION, and backend is attached to a backend service whose loadBalancingScheme is EXTERNAL (except Network Load Balancing), you must specify either this parameter, maxConnections, or maxConnectionsPerInstance. + // 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. Not supported by: // - // Not available if the backend's balancingMode is RATE. Cannot be specified for Network Load Balancing or Internal TCP/UDP Load Balancing, even though those load balancers require a balancing mode of CONNECTION. + // - Internal TCP/UDP Load Balancing - Network Load Balancing. optional int32 max_connections_per_endpoint = 216904604; - // Defines a target maximum number of simultaneous connections for a single VM in a backend instance group. This is multiplied by the number of instances in the instance group to implicitly calculate a target maximum number of simultaneous connections for the whole instance group. If the backend's balancingMode is UTILIZATION, this is an optional parameter. If the backend's balancingMode is CONNECTION, and backend is attached to a backend service whose loadBalancingScheme is EXTERNAL (except Network Load Balancing), you must specify either this parameter, maxConnections, or 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. Cannot be specified for Network Load Balancing or Internal TCP/UDP Load Balancing, even though those load balancers require a balancing mode of CONNECTION. + // Not available if the backend's balancingMode is RATE. Not supported by: + // + // - Internal TCP/UDP Load Balancing - Network Load Balancing. optional int32 max_connections_per_instance = 104671900; - // Defines a maximum number of HTTP requests per second (RPS) that the backend can handle. Valid for network endpoint group and instance group backends (except for regional managed instance groups). Must not be defined if the backend is a managed instance group that uses autoscaling based on load balancing. - // - // If the backend's balancingMode is UTILIZATION, this is an optional parameter. If the backend's balancingMode is RATE, you must specify maxRate, maxRatePerInstance, or maxRatePerEndpoint. + // 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. optional int32 max_rate = 408035035; - // Defines a maximum target for requests per second (RPS) for an endpoint of a NEG. This is multiplied by the number of endpoints in the NEG to implicitly calculate a target maximum rate for the NEG. - // - // If the backend's balancingMode is RATE, you must specify either this parameter, maxRate (except for regional managed instance groups), or maxRatePerInstance. + // 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. optional float max_rate_per_endpoint = 129832283; - // Defines a maximum target for requests per second (RPS) for a single VM in a backend instance group. This is multiplied by the number of instances in the instance group to implicitly calculate a target maximum rate for the whole instance group. - // - // If the backend's balancingMode is UTILIZATION, this is an optional parameter. If the backend's balancingMode is RATE, you must specify either this parameter, maxRate (except for regional managed instance groups), or 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. optional float max_rate_per_instance = 17599579; - // Defines the maximum average backend utilization of a backend VM in an instance group. The valid range is [0.0, 1.0]. This is an optional parameter if the backend's balancingMode is UTILIZATION. - // - // This parameter can be used in conjunction with maxRate, maxRatePerInstance, maxConnections (except for regional managed instance groups), or maxConnectionsPerInstance. optional float max_utilization = 148192199; } @@ -1398,6 +1461,9 @@ 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 = 486203082; + // 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. @@ -1407,7 +1473,7 @@ message BackendBucketCdnPolicy { // 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. optional CacheMode cache_mode = 28877888; - // Specifies a separate client (e.g. browser client) TTL, separate from the TTL for Cloud CDN's edge caches. Leaving this empty will use the same cache TTL for both Cloud CDN and the client-facing response. The maximum allowed value is 86400s (1 day). + // 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 86400s (1 day). optional int32 client_ttl = 29034360; // Specifies the default TTL for cached content served by this origin for responses that do not have an existing valid TTL (max-age or s-max-age). Setting a TTL of "0" means "always revalidate". The value of defaultTTL cannot be set to a value greater than that of maxTTL, but can be equal. When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL will overwrite the TTL set in all responses. The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. @@ -1416,6 +1482,18 @@ message BackendBucketCdnPolicy { // 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 = 307578001; + // 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 = 336110005; + + // 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 = 155359996; + + // 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 = 532808276; + + // Serve existing content from the cache (if available) when revalidating content with the origin, or when an error is encountered when refreshing the cache. This setting defines the default "max-stale" duration for any cached responses that do not specify a max-stale directive. Stale responses that exceed the TTL configured here will not be served. The default limit (max-stale) is 86400s (1 day), which will allow stale content to be served up to this limit beyond the max-age (or s-max-age) of a cached response. The maximum allowed value is 604800 (1 week). Set this to zero (0) to disable serve-while-stale. + optional int32 serve_while_stale = 236682203; + // 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 = 269374534; @@ -1460,6 +1538,23 @@ message BackendBucket { } +// 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 = 110223613; + +} + +// 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 = 3059181; + + // 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 = 115180; + +} + // Contains a list of BackendBucket resources. message BackendBucketList { // [Output Only] Unique identifier for the resource; defined by the server. @@ -1505,6 +1600,9 @@ 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. + repeated BackendServiceCdnPolicyBypassCacheOnRequestHeader bypass_cache_on_request_headers = 486203082; + // The CacheKeyPolicy for this CdnPolicy. optional CacheKeyPolicy cache_key_policy = 159263727; @@ -1517,7 +1615,7 @@ message BackendServiceCdnPolicy { // 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. optional CacheMode cache_mode = 28877888; - // Specifies a separate client (e.g. browser client) TTL, separate from the TTL for Cloud CDN's edge caches. Leaving this empty will use the same cache TTL for both Cloud CDN and the client-facing response. The maximum allowed value is 86400s (1 day). + // 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 86400s (1 day). optional int32 client_ttl = 29034360; // Specifies the default TTL for cached content served by this origin for responses that do not have an existing valid TTL (max-age or s-max-age). Setting a TTL of "0" means "always revalidate". The value of defaultTTL cannot be set to a value greater than that of maxTTL, but can be equal. When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL will overwrite the TTL set in all responses. The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. @@ -1526,6 +1624,18 @@ message BackendServiceCdnPolicy { // 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 = 307578001; + // 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 = 336110005; + + // 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 = 155359996; + + // 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 = 532808276; + + // Serve existing content from the cache (if available) when revalidating content with the origin, or when an error is encountered when refreshing the cache. This setting defines the default "max-stale" duration for any cached responses that do not specify a max-stale directive. Stale responses that exceed the TTL configured here will not be served. The default limit (max-stale) is 86400s (1 day), which will allow stale content to be served up to this limit beyond the max-age (or s-max-age) of a cached response. The maximum allowed value is 604800 (1 week). Set this to zero (0) to disable serve-while-stale. + optional int32 serve_while_stale = 236682203; + // 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 = 269374534; @@ -1555,7 +1665,7 @@ message CircuitBreakers { // Message containing connection draining configuration. message ConnectionDraining { - // The amount of time in seconds to allow existing connections to persist while on unhealthy backend VMs. Only applicable if the protocol is not UDP. The valid range is [0, 3600]. + // Configures a duration timeout for existing requests on a removed backend instance. For supported load balancers and protocols, as described in Enabling connection draining. optional int32 draining_timeout_sec = 225127070; } @@ -1614,6 +1724,16 @@ message BackendServiceLogConfig { } +// 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 = 104586303; + + // 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 = 359484031; + +} + // Settings controlling the eviction of unhealthy hosts from the load balancing pool for the backend service. message OutlierDetection { // The base time that a host is ejected for. The real ejection time is equal to the base ejection time multiplied by the number of times the host has been ejected. Defaults to 30000ms or 30s. @@ -1758,7 +1878,7 @@ message BackendService { // Type of session affinity to use. The default is NONE. // - // When the loadBalancingScheme is EXTERNAL: * For Network Load Balancing, the possible values are NONE, CLIENT_IP, CLIENT_IP_PROTO, or CLIENT_IP_PORT_PROTO. * For all other load balancers that use loadBalancingScheme=EXTERNAL, the possible values are NONE, CLIENT_IP, or GENERATED_COOKIE. * You can use GENERATED_COOKIE if the protocol is HTTP, HTTP2, or HTTPS. + // When the loadBalancingScheme is EXTERNAL: * For Network Load Balancing, the possible values are NONE, CLIENT_IP, CLIENT_IP_PROTO, or CLIENT_IP_PORT_PROTO. * For all other load balancers that use loadBalancingScheme=EXTERNAL, the possible values are NONE, CLIENT_IP, or GENERATED_COOKIE. * You can use GENERATED_COOKIE if the protocol is HTTP, HTTP2, or HTTPS. // // When the loadBalancingScheme is INTERNAL, possible values are NONE, CLIENT_IP, CLIENT_IP_PROTO, or CLIENT_IP_PORT_PROTO. // @@ -1771,6 +1891,8 @@ message BackendService { CLIENT_IP = 345665051; + CLIENT_IP_NO_DESTINATION = 106122516; + CLIENT_IP_PORT_PROTO = 221722926; CLIENT_IP_PROTO = 25322148; @@ -1795,7 +1917,7 @@ message BackendService { // The list of backends that serve this BackendService. repeated Backend backends = 510839903; - // Cloud CDN configuration for this BackendService. Not available for Internal TCP/UDP Load Balancing and Network Load Balancing. + // Cloud CDN configuration for this BackendService. Only available for external HTTP(S) Load Balancing. optional BackendServiceCdnPolicy cdn_policy = 213976452; // Settings controlling the volume of connections to a backend service. If not set, this feature is considered disabled. @@ -1876,6 +1998,11 @@ message BackendService { // 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. optional BackendServiceLogConfig log_config = 351299741; + // 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 field is only allowed when the loadBalancingScheme of the backend service is INTERNAL_SELF_MANAGED. + optional Duration max_stream_duration = 61428376; + // 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 = 3373707; @@ -1893,7 +2020,7 @@ message BackendService { // Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80. // - // This cannot be used if the loadBalancingScheme is INTERNAL (Internal TCP/UDP Load Balancing). + // Backend services for Internal TCP/UDP Load Balancing and Network Load Balancing require you omit port. optional int32 port = 3446913; // A named port on a backend instance group representing the port for communication to the backend VMs in that group. Required when the loadBalancingScheme is EXTERNAL (except Network Load Balancing), INTERNAL_MANAGED, or INTERNAL_SELF_MANAGED and the backends are instance groups. The named port must be defined on each backend instance group. This parameter has no meaning if the backends are NEGs. @@ -1926,7 +2053,7 @@ message BackendService { // Type of session affinity to use. The default is NONE. // - // When the loadBalancingScheme is EXTERNAL: * For Network Load Balancing, the possible values are NONE, CLIENT_IP, CLIENT_IP_PROTO, or CLIENT_IP_PORT_PROTO. * For all other load balancers that use loadBalancingScheme=EXTERNAL, the possible values are NONE, CLIENT_IP, or GENERATED_COOKIE. * You can use GENERATED_COOKIE if the protocol is HTTP, HTTP2, or HTTPS. + // When the loadBalancingScheme is EXTERNAL: * For Network Load Balancing, the possible values are NONE, CLIENT_IP, CLIENT_IP_PROTO, or CLIENT_IP_PORT_PROTO. * For all other load balancers that use loadBalancingScheme=EXTERNAL, the possible values are NONE, CLIENT_IP, or GENERATED_COOKIE. * You can use GENERATED_COOKIE if the protocol is HTTP, HTTP2, or HTTPS. // // When the loadBalancingScheme is INTERNAL, possible values are NONE, CLIENT_IP, CLIENT_IP_PROTO, or CLIENT_IP_PORT_PROTO. // @@ -1935,7 +2062,7 @@ message BackendService { // 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 SessionAffinity session_affinity = 463888561; - // 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 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 is 1 - 2,147,483,647 seconds. optional int32 timeout_sec = 79994995; } @@ -1975,6 +2102,13 @@ message BackendServiceAggregatedList { } +// 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. + optional string header_name = 110223613; + +} + // Message containing what to include in the cache key for a request for Cloud CDN. message CacheKeyPolicy { // If true, requests to different hosts will be cached separately. @@ -1994,6 +2128,16 @@ message CacheKeyPolicy { } +// 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. + optional int32 code = 3059181; + + // 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 = 115180; + +} + // message HealthStatus { // Health state of the instance. @@ -2025,13 +2169,19 @@ message HealthStatus { // Metadata defined as annotations for network endpoint. map annotations = 112032548; + // URL of the forwarding rule associated with the health status of the instance. + optional string forwarding_rule = 269964030; + + // A forwarding rule IP address assigned to this instance. + optional string forwarding_rule_ip = 172250632; + // Health state of the instance. optional HealthState health_state = 324007150; // URL of the instance resource. optional string instance = 18257045; - // A forwarding rule IP address assigned to this 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 = 406272220; // The named port of the instance group, not necessarily the port that is health-checked. @@ -2161,6 +2311,122 @@ message Binding { } +// +message InstanceProperties { + // The private IPv6 google access type for VMs. If not specified, use INHERIT_FROM_SUBNETWORK as default. + enum PrivateIpv6GoogleAccess { + // A value indicating that the enum field is not set. + UNDEFINED_PRIVATE_IPV6_GOOGLE_ACCESS = 0; + + ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE = 427975994; + + ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE = 288210263; + + INHERIT_FROM_SUBNETWORK = 530256959; + + } + + // Controls for advanced machine-related behavior features. + optional AdvancedMachineFeatures advanced_machine_features = 409646002; + + // 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 = 467731324; + + // Specifies the Confidential Instance options. + optional ConfidentialInstanceConfig confidential_instance_config = 490637685; + + // An optional text description for the instances that are created from these properties. + optional string description = 422937596; + + // An array of disks that are associated with the instances that are created from these properties. + repeated AttachedDisk disks = 95594102; + + // A list of guest accelerator cards' type and count to use for instances created from these properties. + repeated AcceleratorConfig guest_accelerators = 463595119; + + // Labels to apply to instances that are created from these properties. + map labels = 500195327; + + // The machine type to use for instances that are created from these properties. + optional string machine_type = 227711026; + + // 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 = 86866735; + + // 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 = 242912759; + + // An array of network access configurations for this interface. + repeated NetworkInterface network_interfaces = 52735243; + + // The private IPv6 google access type for VMs. If not specified, use INHERIT_FROM_SUBNETWORK as default. + optional PrivateIpv6GoogleAccess private_ipv6_google_access = 48277006; + + // Specifies the reservations that instances can consume from. + optional ReservationAffinity reservation_affinity = 157850683; + + // Resource policies (names, not ULRs) applied to instances created from these properties. + repeated string resource_policies = 22220385; + + // Specifies the scheduling options for the instances that are created from these properties. + optional Scheduling scheduling = 386688404; + + // 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 = 277537328; + + optional ShieldedInstanceConfig shielded_instance_config = 12862901; + + // 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 = 3552281; + +} + +// 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 = 413423454; + +} + +// Per-instance properties to be set on individual instances. To be extended in the future. +message BulkInsertInstanceResourcePerInstanceProperties { + // This field is only temporary. It will be removed. Do not use it. + optional string name = 3373707; + +} + +// +message BulkInsertInstanceResource { + // The maximum number of instances to create. + optional string count = 94851343; + + // The instance properties defining the VM instances to be created. Required if sourceInstanceTemplate is not provided. + optional InstanceProperties instance_properties = 215355165; + + // Policy for chosing target zone. + optional LocationPolicy location_policy = 465689852; + + // 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 = 523228386; + + // The string pattern used for the names of the VMs. Either name_pattern or per_instance_properties must be set. The pattern should contain one continuous sequence of placeholder hash characters (#) with each character corresponding to one digit of the generated instance name. Example: name_pattern of inst-#### will generate instance names such as inst-0001, inst-0002, ... . If there already exist instance(s) whose names match the name pattern in the same project and zone, then the generated instance numbers will 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-#### will be inst-0051, inst-0052, etc. The name pattern placeholder #...# can contain up to 18 characters. + optional string name_pattern = 413815260; + + // 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 = 108502267; + + // 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 = 332423616; + +} + // message CacheInvalidationRule { // If set, this invalidation rule will only apply to requests with a Host header matching host. @@ -2220,6 +2486,9 @@ message Reservation { // 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 = 3373707; + // [Output Only] Reserved for future use. + optional bool satisfies_pzs = 480964267; + // [Output Only] Server-defined fully-qualified URL for this resource. optional string self_link = 456214797; @@ -2458,16 +2727,6 @@ message ConsistentHashLoadBalancerSettingsHttpCookie { } -// 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 = 104586303; - - // 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 = 359484031; - -} - // The specification for allowing client side cross-origin requests. Please see W3C Recommendation for Cross Origin Resource Sharing message CorsPolicy { // In response to a preflight request, setting this to true indicates that the actual request can include user credentials. This translates to the Access-Control-Allow-Credentials header. @@ -2480,7 +2739,7 @@ message CorsPolicy { // Specifies the content for the Access-Control-Allow-Methods header. repeated string allow_methods = 205405372; - // Specifies the regualar expression patterns that match allowed origins. For regular expression grammar please see en.cppreference.com/w/cpp/regex/ecmascript + // Specifies the regualar expression patterns that match allowed origins. For regular expression grammar please see github.com/google/re2/wiki/Syntax // An origin is allowed if it matches either an item in allowOrigins or an item in allowOriginRegexes. repeated string allow_origin_regexes = 215385810; @@ -2521,7 +2780,12 @@ message CustomerEncryptionKeyProtectedDisk { // // The regionDisks resource represents a regional persistent disk. For more information, read Regional resources. (== resource_for {$api_version}.disks ==) (== resource_for {$api_version}.regionDisks ==) message Disk { - // [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. + // [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. enum Status { // A value indicating that the enum field is not set. UNDEFINED_STATUS = 0; @@ -2582,6 +2846,9 @@ message Disk { // A list of publicly visible licenses. Reserved for Google's use. repeated string licenses = 337642578; + // 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 = 350519505; + // 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 = 3373707; @@ -2591,6 +2858,9 @@ message Disk { // 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 = 420007943; + // Indicates how many IOPS must be provisioned for the disk. + optional string provisioned_iops = 186769108; + // [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 = 138946292; @@ -2600,6 +2870,9 @@ message Disk { // Resource policies applied to this disk for automatic snapshot creations. repeated string resource_policies = 22220385; + // [Output Only] Reserved for future use. + optional bool satisfies_pzs = 480964267; + // [Output Only] Server-defined fully-qualified URL for this resource. optional string self_link = 456214797; @@ -2610,8 +2883,11 @@ message Disk { // 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 = 451753793; // [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. @@ -2653,7 +2929,15 @@ message Disk { // [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 = 98962258; - // [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. + // 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 = 233052711; + + // [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. optional Status status = 181260274; // 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-standard or pd-ssd @@ -2928,6 +3212,22 @@ message DistributionPolicyZoneConfiguration { // message DistributionPolicy { + // The distribution shape to which the group converges either proactively or on resize events (depending on the value set in updatePolicy.instanceRedistributionType). + enum TargetShape { + // A value indicating that the enum field is not set. + UNDEFINED_TARGET_SHAPE = 0; + + ANY = 64972; + + BALANCED = 468409608; + + EVEN = 2140442; + + } + + // The distribution shape to which the group converges either proactively or on resize events (depending on the value set in updatePolicy.instanceRedistributionType). + optional TargetShape target_shape = 338621299; + // Zones where the regional managed instance group will create and manage its instances. repeated DistributionPolicyZoneConfiguration zones = 116085319; @@ -3245,31 +3545,200 @@ message FirewallList { } -// Opaque filter criteria used by loadbalancers to restrict routing configuration to a limited set of loadbalancing proxies. Proxies and sidecars involved in loadbalancing would typically present metadata to the loadbalancers which 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 loadbalancing involves Envoys, they will only receive routing configuration when values in metadataFilters match values supplied in labels = 500195327; + // Specifies the forwarding rule type. // // @@ -3505,12 +3995,20 @@ message ForwardingRule { // For more information, see [Port specifications](/load-balancing/docs/forwarding-rule-concepts#port_specifications). repeated string ports = 106854418; + // [Output Only] The PSC connection id of the PSC Forwarding Rule. + optional string psc_connection_id = 292082397; + // [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 = 138946292; // [Output Only] Server-defined URL for the resource. optional string self_link = 456214797; + // Service Directory resources to register this forwarding rule with. Currently, only supports a single Service Directory resource. + // + // It is only supported for Internal TCP/UDP Load Balancing and Internal HTTP(S) Load Balancing. + repeated ForwardingRuleServiceDirectoryRegistration service_directory_registrations = 223549694; + // 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. @@ -3530,13 +4028,6 @@ message ForwardingRule { // If the network specified is in auto subnet mode, this field is optional. However, if the network is in custom subnet mode, a subnetwork must be specified. optional string subnetwork = 307827694; - // 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 more information, see the "Target" column in [Port specifications](/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. Currently, the supported Google API bundles include: - // - // - // - vpc-sc - GCP APIs that support VPC Service Controls. For more information about which APIs support VPC Service Controls, refer to VPC-SC supported products and limitations. - // - all-apis - All GCP APIs. For more information about which APIs are supported with this bundle, refer to Private Google Access-specific domains and VIPs. optional string target = 192835985; } @@ -3664,7 +4155,7 @@ message NetworkEndpoint { // 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. optional string ip_address = 406272220; - // Optional port number of network endpoint. If not specified and the NetworkEndpointGroup.network_endpoint_type is GCE_IP_PORT, the defaultPort for the network endpoint group will be used. + // Optional port number of network endpoint. If not specified, the defaultPort for the network endpoint group will be used. optional int32 port = 3446913; } @@ -3683,16 +4174,6 @@ message GlobalNetworkEndpointGroupsDetachEndpointsRequest { } -// -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 = 178124825; - - // A list of labels to apply for this resource. Each label key & value must comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be 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 example, "webserver-frontend": "images". A label value can also be empty (e.g. "my-label": ""). - map labels = 500195327; - -} - // An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. // // @@ -3744,6 +4225,29 @@ message Policy { } +// +message GlobalOrganizationSetPolicyRequest { + // Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify bindings. + repeated Binding bindings = 403251854; + + // Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify the etag. + optional string etag = 3123477; + + // 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 = 91071794; + +} + +// +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 = 178124825; + + // A list of labels to apply for this resource. Each label key & value must comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be 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 example, "webserver-frontend": "images". A label value can also be empty (e.g. "my-label": ""). + map labels = 500195327; + +} + // message GlobalSetPolicyRequest { // Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify bindings. @@ -4172,7 +4676,7 @@ message HealthCheck { // Configure logging on this health check. optional HealthCheckLogConfig log_config = 351299741; - // 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. + // 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 = 3373707; // [Output Only] Region where the health check resides. Not applicable to global health checks. @@ -4505,7 +5009,7 @@ message HttpHeaderMatch { // Note that rangeMatch is not supported for Loadbalancers that have their loadBalancingScheme set to EXTERNAL. optional Int64RangeMatch range_match = 97244227; - // The value of the header must match the regular expression specified in regexMatch. For regular expression grammar, please see: en.cppreference.com/w/cpp/regex/ecmascript + // The value of the header must match the regular expression specified in regexMatch. For regular expression grammar, please see: github.com/google/re2/wiki/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. // Note that regexMatch only applies to Loadbalancers that have their loadBalancingScheme set to INTERNAL_SELF_MANAGED. @@ -4530,7 +5034,7 @@ message HttpQueryParameterMatch { // Only one of presentMatch, exactMatch or regexMatch must be set. optional bool present_match = 67435841; - // The queryParameterMatch matches if the value of the parameter matches the regular expression specified by regexMatch. For the regular expression grammar, please see en.cppreference.com/w/cpp/regex/ecmascript + // The queryParameterMatch matches if the value of the parameter matches the regular expression specified by regexMatch. For the regular expression grammar, please see github.com/google/re2/wiki/Syntax // Only one of presentMatch, exactMatch or regexMatch must be set. // Note that regexMatch only applies when the loadBalancingScheme is set to INTERNAL_SELF_MANAGED. optional string regex_match = 107387853; @@ -4668,6 +5172,11 @@ message HttpRouteAction { // Not supported when the URL map is bound to target gRPC proxy that has validateForProxyless field set to true. optional HttpFaultInjection fault_injection_policy = 412781079; + // 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 (i.e. end-of-stream), the duration in this field 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, will use the largest maxStreamDuration 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 = 61428376; + // Specifies the policy on how requests intended for the route's backends are shadowed to a separate mirrored backend service. Loadbalancer does not wait for responses from the shadow service. Prior to sending traffic to the shadow service, the host / authority header is suffixed with -shadow. // Not supported when the URL map is bound to target gRPC proxy that has validateForProxyless field set to true. optional RequestMirrorPolicy request_mirror_policy = 220196866; @@ -4724,7 +5233,7 @@ message HttpRouteRuleMatch { // Not supported when the URL map is bound to target gRPC proxy. repeated HttpQueryParameterMatch query_parameter_matches = 286231270; - // 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 regular expression grammar please see en.cppreference.com/w/cpp/regex/ecmascript + // 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 regular expression grammar please see github.com/google/re2/wiki/Syntax // Only one of prefixMatch, fullPathMatch or regexMatch must be specified. // Note that regexMatch only applies to Loadbalancers that have their loadBalancingScheme set to INTERNAL_SELF_MANAGED. optional string regex_match = 107387853; @@ -4873,6 +5382,9 @@ message Image { // The parameters of the raw disk image. optional RawDisk raw_disk = 503113556; + // [Output Only] Reserved for future use. + optional bool satisfies_pzs = 480964267; + // [Output Only] Server-defined URL for the resource. optional string self_link = 456214797; @@ -4991,7 +5503,7 @@ message NetworkInterface { // 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 = 165085631; - // 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, otherwise the request will fail with error 412 conditionNotMet. + // 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 = 234678500; // [Output Only] An IPv6 internal network address for this network interface. @@ -5052,7 +5564,7 @@ message ReservationAffinity { } -// Sets the scheduling options for an Instance. NextID: 13 +// Sets the scheduling options for an Instance. NextID: 20 message Scheduling { // 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 Setting Instance Scheduling Options. enum OnHostMaintenance { @@ -5173,6 +5685,9 @@ message Instance { } + // Controls for advanced machine-related behavior features. + optional AdvancedMachineFeatures advanced_machine_features = 409646002; + // 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 = 467731324; @@ -5264,6 +5779,9 @@ message Instance { // Resource policies applied to this instance. repeated string resource_policies = 22220385; + // [Output Only] Reserved for future use. + optional bool satisfies_pzs = 480964267; + // Sets the scheduling options for this instance. optional Scheduling scheduling = 386688404; @@ -5529,7 +6047,7 @@ message InstanceGroupManagerUpdatePolicy { // - NONE: For non-autoscaled groups, proactive redistribution is disabled. optional string instance_redistribution_type = 292630424; - // The maximum number of instances that can be created above the specified targetSize during the update process. By default, a fixed value of 1 is used. This value can be either a fixed number or a percentage if the instance group has 10 or more instances. If you set a percentage, the number of instances will be rounded up if necessary. + // 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 up 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 = 302572691; @@ -5538,7 +6056,7 @@ message InstanceGroupManagerUpdatePolicy { // // // - The instance's status is RUNNING. - // - If there is a health check on the instance group, the instance's liveness health check result 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. By default, a fixed value of 1 is used. This value can be either a fixed number or a percentage if the instance group has 10 or more instances. If you set a percentage, the number of instances will be rounded up if necessary. + // - 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 up 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 = 404940277; @@ -6248,73 +6766,6 @@ message InstanceMoveRequest { } -// -message InstanceProperties { - // The private IPv6 google access type for VMs. If not specified, use INHERIT_FROM_SUBNETWORK as default. - enum PrivateIpv6GoogleAccess { - // A value indicating that the enum field is not set. - UNDEFINED_PRIVATE_IPV6_GOOGLE_ACCESS = 0; - - ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE = 427975994; - - ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE = 288210263; - - INHERIT_FROM_SUBNETWORK = 530256959; - - } - - // 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 = 467731324; - - // Specifies the Confidential Instance options. - optional ConfidentialInstanceConfig confidential_instance_config = 490637685; - - // An optional text description for the instances that are created from these properties. - optional string description = 422937596; - - // An array of disks that are associated with the instances that are created from these properties. - repeated AttachedDisk disks = 95594102; - - // A list of guest accelerator cards' type and count to use for instances created from these properties. - repeated AcceleratorConfig guest_accelerators = 463595119; - - // Labels to apply to instances that are created from these properties. - map labels = 500195327; - - // The machine type to use for instances that are created from these properties. - optional string machine_type = 227711026; - - // 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 = 86866735; - - // 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 = 242912759; - - // An array of network access configurations for this interface. - repeated NetworkInterface network_interfaces = 52735243; - - // The private IPv6 google access type for VMs. If not specified, use INHERIT_FROM_SUBNETWORK as default. - optional PrivateIpv6GoogleAccess private_ipv6_google_access = 48277006; - - // Specifies the reservations that instances can consume from. - optional ReservationAffinity reservation_affinity = 157850683; - - // Resource policies (names, not ULRs) applied to instances created from these properties. - repeated string resource_policies = 22220385; - - // Specifies the scheduling options for the instances that are created from these properties. - optional Scheduling scheduling = 386688404; - - // 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 = 277537328; - - optional ShieldedInstanceConfig shielded_instance_config = 12862901; - - // 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 = 3552281; - -} - // 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, 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. @@ -6387,14 +6838,54 @@ message InstancesAddResourcePoliciesRequest { } // -message InstancesRemoveResourcePoliciesRequest { - // Resource policies to be removed from this instance. - repeated string resource_policies = 22220385; +message InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy { + // [Output Only] The type of the firewall policy. + enum Type { + // A value indicating that the enum field is not set. + UNDEFINED_TYPE = 0; -} + HIERARCHY = 69902869; -// -message InstancesSetLabelsRequest { + UNSPECIFIED = 526786327; + + } + + // [Output Only] Deprecated, please use short name instead. The display name of the firewall policy. + optional string display_name = 4473832; + + // [Output Only] The name of the firewall policy. + optional string name = 3373707; + + // The rules that apply to the network. + repeated FirewallPolicyRule rules = 108873975; + + // [Output Only] The short name of the firewall policy. + optional string short_name = 492051566; + + // [Output Only] The type of the firewall policy. + optional Type type = 3575610; + +} + +// +message InstancesGetEffectiveFirewallsResponse { + // Effective firewalls from firewall policies. + repeated InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy firewall_policys = 410985794; + + // Effective firewalls on the instance. + repeated Firewall firewalls = 272245619; + +} + +// +message InstancesRemoveResourcePoliciesRequest { + // Resource policies to be removed from this instance. + repeated string resource_policies = 22220385; + +} + +// +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 = 178124825; @@ -6759,6 +7250,20 @@ message InterconnectAttachment { } + // Indicates the user-supplied encryption option of this interconnect attachment: + // - NONE is the default value, which means that the attachment carries unencrypted traffic. VMs can send traffic to, or receive traffic from, this type of attachment. + // - IPSEC indicates that the attachment carries only traffic encrypted by an IPsec device such as an HA VPN gateway. VMs cannot directly send traffic to, or receive traffic from, such an attachment. To use IPsec-encrypted Cloud Interconnect, create the attachment using this option. + // Not currently available in all Interconnect locations. + enum Encryption { + // A value indicating that the enum field is not set. + UNDEFINED_ENCRYPTION = 0; + + IPSEC = 69882282; + + NONE = 2402104; + + } + // [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. @@ -6857,6 +7362,12 @@ message InterconnectAttachment { // - 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. optional EdgeAvailabilityDomain edge_availability_domain = 71289510; + // Indicates the user-supplied encryption option of this interconnect attachment: + // - NONE is the default value, which means that the attachment carries unencrypted traffic. VMs can send traffic to, or receive traffic from, this type of attachment. + // - IPSEC indicates that the attachment carries only traffic encrypted by an IPsec device such as an HA VPN gateway. VMs cannot directly send traffic to, or receive traffic from, such an attachment. To use IPsec-encrypted Cloud Interconnect, create the attachment using this option. + // Not currently available in all Interconnect locations. + optional Encryption encryption = 97980291; + // [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 = 534944469; @@ -6866,6 +7377,10 @@ message InterconnectAttachment { // URL of the underlying Interconnect object that this attachment's traffic will traverse through. optional string interconnect = 224601230; + // URL of addresses that have been reserved for the interconnect attachment, Used only for interconnect attachment that has the encryption option as IPSEC. The addresses must be RFC 1918 IP address ranges. When creating HA VPN gateway over the interconnect attachment, if the attachment is configured to use an RFC 1918 IP address, then the VPN gateway's IP address will be allocated from the IP address range specified here. For example, if the HA VPN gateway's interface 0 is paired to this interconnect attachment, then an RFC 1918 IP address for the VPN gateway interface 0 will be allocated from the IP address specified for this interconnect attachment. If this field is not specified for interconnect attachment that has encryption option as IPSEC, later on when creating HA VPN gateway on this interconnect attachment, the HA VPN gateway's IP address will be allocated from regional external IP address pool. + // Not currently available in all Interconnect locations. + repeated string ipsec_internal_addresses = 407648565; + // [Output Only] Type of the resource. Always compute#interconnectAttachment for interconnect attachments. optional string kind = 3292052; @@ -7405,6 +7920,26 @@ message LocalDisk { } +// +message LocationPolicyLocation { + // Preference for a given locaction: ALLOW or DENY. + enum Preference { + // A value indicating that the enum field is not set. + UNDEFINED_PREFERENCE = 0; + + ALLOW = 62368553; + + DENY = 2094604; + + PREFERENCE_UNSPECIFIED = 496219571; + + } + + // Preference for a given locaction: ALLOW or DENY. + optional Preference preference = 150781147; + +} + // Write a Cloud Audit log message LogConfigCloudAuditOptions { // The log_name to populate in the Cloud Audit Record. @@ -7890,6 +8425,8 @@ message NetworkEndpointGroup { // A value indicating that the enum field is not set. UNDEFINED_NETWORK_ENDPOINT_TYPE = 0; + GCE_VM_IP = 401880793; + GCE_VM_IP_PORT = 501838375; INTERNET_FQDN_PORT = 404154477; @@ -8111,6 +8648,48 @@ message NetworksAddPeeringRequest { } +// +message NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy { + // [Output Only] The type of the firewall policy. + enum Type { + // A value indicating that the enum field is not set. + UNDEFINED_TYPE = 0; + + HIERARCHY = 69902869; + + NETWORK = 413984270; + + UNSPECIFIED = 526786327; + + } + + // [Output Only] Deprecated, please use short name instead. The display name of the firewall policy. + optional string display_name = 4473832; + + // [Output Only] The name of the firewall policy. + optional string name = 3373707; + + // The rules that apply to the network. + repeated FirewallPolicyRule rules = 108873975; + + // [Output Only] The short name of the firewall policy. + optional string short_name = 492051566; + + // [Output Only] The type of the firewall policy. + optional Type type = 3575610; + +} + +// +message NetworksGetEffectiveFirewallsResponse { + // Effective firewalls from firewall policy. + repeated NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy firewall_policys = 410985794; + + // Effective firewalls on the network. + repeated Firewall firewalls = 272245619; + +} + // message NetworksRemovePeeringRequest { // Name of the peering, which should conform to RFC1035. @@ -8213,6 +8792,9 @@ message NodeGroup { // [Output Only] The type of the resource. Always compute#nodeGroup for node group. optional string kind = 3292052; + // 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 = 350519505; + // 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. optional MaintenancePolicy maintenance_policy = 528327646; @@ -8363,6 +8945,9 @@ message NodeGroupNode { // The type of this node. optional string node_type = 465832791; + // [Output Only] Reserved for future use. + optional bool satisfies_pzs = 480964267; + // Binding properties for the physical server. optional ServerBinding server_binding = 208179593; @@ -8880,6 +9465,9 @@ message Operation { // [Output Only] Name of the operation. optional string name = 3373707; + // [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 = 40171187; + // [Output Only] The type of operation, such as `insert`, `update`, or `delete`, and so on. optional string operation_type = 177650450; @@ -9361,22 +9949,30 @@ message Quota { BACKEND_SERVICES = 269623753; + C2D_CPUS = 508182517; + C2_CPUS = 317601211; COMMITMENTS = 456141790; COMMITTED_A2_CPUS = 59330902; + COMMITTED_C2D_CPUS = 282390904; + COMMITTED_C2_CPUS = 223725528; COMMITTED_CPUS = 292394702; + COMMITTED_E2_CPUS = 388120154; + COMMITTED_LICENSES = 357606869; COMMITTED_LOCAL_SSD_TOTAL_GB = 308393480; COMMITTED_MEMORY_OPTIMIZED_CPUS = 489057886; + COMMITTED_N2A_CPUS = 40064304; + COMMITTED_N2D_CPUS = 125951757; COMMITTED_N2_CPUS = 322589603; @@ -9399,6 +9995,8 @@ message Quota { DISKS_TOTAL_GB = 353520543; + E2_CPUS = 481995837; + EXTERNAL_NETWORK_LB_FORWARDING_RULES = 374298265; EXTERNAL_PROTOCOL_FORWARDING_RULES = 63478888; @@ -9453,6 +10051,8 @@ message Quota { MACHINE_IMAGES = 446986640; + N2A_CPUS = 265855917; + N2D_CPUS = 351743370; N2_CPUS = 416465286; @@ -9487,6 +10087,8 @@ message Quota { PACKET_MIRRORINGS = 15578407; + PD_EXTREME_TOTAL_PROVISIONED_IOPS = 69593965; + PREEMPTIBLE_CPUS = 251184841; PREEMPTIBLE_LOCAL_SSD_GB = 260819336; @@ -9733,62 +10335,97 @@ message ProjectsSetDefaultNetworkTierRequest { } -// Represents a Region resource. -// -// A region is a geographical area where a resource is located. For more information, read Regions and Zones. (== resource_for {$api_version}.regions ==) -message Region { - // [Output Only] Status of the region, either UP or DOWN. +// 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 = 145092645; + + // The name of the public delegated prefix + optional string name = 3373707; + + // The project number of the public delegated prefix + optional string project = 227560217; + + // The region of the public delegated prefix if it is regional. If absent, the prefix is global. + optional string region = 138946292; + + // 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 = 181260274; + +} + +// 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 { + // The status of the public advertised prefix. enum Status { // A value indicating that the enum field is not set. UNDEFINED_STATUS = 0; - DOWN = 2104482; + INITIAL = 518841124; - UP = 2715; + PREFIX_CONFIGURATION_COMPLETE = 480889551; + + PREFIX_CONFIGURATION_IN_PROGRESS = 378550961; + + PREFIX_REMOVAL_IN_PROGRESS = 284375783; + + PTR_CONFIGURED = 513497167; + + REVERSE_DNS_LOOKUP_FAILED = 295755183; + + VALIDATED = 66197998; } // [Output Only] Creation timestamp in RFC3339 text format. optional string creation_timestamp = 30525366; - // [Output Only] The deprecation status associated with this region. - optional DeprecationStatus deprecated = 515138995; - - // [Output Only] Textual description of the resource. + // An optional description of this resource. Provide this property when you create the resource. optional string description = 422937596; - // [Output Only] The unique identifier for the resource. This identifier is defined by the server. + // The IPv4 address to be used for reverse DNS verification. + optional string dns_verification_ip = 241011381; + + // 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 = 234678500; + + // [Output Only] The unique identifier for the resource type. The server generates this identifier. optional string id = 3355; - // [Output Only] Type of the resource. Always compute#region for regions. + // The IPv4 address range, in CIDR format, represented by this public advertised prefix. + optional string ip_cidr_range = 98117322; + + // [Output Only] Type of the resource. Always compute#publicAdvertisedPrefix for public advertised prefixes. optional string kind = 3292052; - // [Output Only] Name of the resource. + // 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 = 3373707; - // [Output Only] Quotas assigned to this region. - repeated Quota quotas = 125341947; + // [Output Only] The list of public delegated prefixes that exist for this public advertised prefix. + repeated PublicAdvertisedPrefixPublicDelegatedPrefix public_delegated_prefixs = 425811723; // [Output Only] Server-defined URL for the resource. optional string self_link = 456214797; - // [Output Only] Status of the region, either UP or DOWN. - optional Status status = 181260274; + // [Output Only] The shared secret to be used for reverse DNS verification. + optional string shared_secret = 381932490; - // [Output Only] A list of zones available in this region, in the form of resource URLs. - repeated string zones = 116085319; + // The status of the public advertised prefix. + optional Status status = 181260274; } -// Contains a list of autoscalers. -message RegionAutoscalerList { +// +message PublicAdvertisedPrefixList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 3355; - // A list of Autoscaler resources. - repeated Autoscaler items = 100526016; + // A list of PublicAdvertisedPrefix resources. + repeated PublicAdvertisedPrefix items = 100526016; - // Type of resource. + // [Output Only] Type of the resource. Always compute#publicAdvertisedPrefix for public advertised prefixes. optional string kind = 3292052; // [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. @@ -9802,58 +10439,119 @@ message RegionAutoscalerList { } -// -message RegionDiskTypeList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 3355; +// Represents a sub PublicDelegatedPrefix. +message PublicDelegatedPrefixPublicDelegatedSubPrefix { + // [Output Only] The status of the sub public delegated prefix. + enum Status { + // A value indicating that the enum field is not set. + UNDEFINED_STATUS = 0; - // A list of DiskType resources. - repeated DiskType items = 100526016; + ACTIVE = 314733318; - // [Output Only] Type of resource. Always compute#regionDiskTypeList for region disk types. - optional string kind = 3292052; + INACTIVE = 270421099; - // [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. - optional string next_page_token = 79797525; + } - // [Output Only] Server-defined URL for this resource. - optional string self_link = 456214797; + // Name of the project scoping this PublicDelegatedSubPrefix. + optional string delegatee_project = 414860634; - // [Output Only] Informational warning message. - optional Warning warning = 50704284; + // An optional description of this resource. Provide this property when you create the resource. + optional string description = 422937596; -} + // The IPv4 address range, in CIDR format, represented by this sub public delegated prefix. + optional string ip_cidr_range = 98117322; -// -message RegionDisksAddResourcePoliciesRequest { - // Resource policies to be added to this disk. - repeated string resource_policies = 22220385; + // Whether the sub prefix is delegated to create Address resources in the delegatee project. + optional bool is_address = 352617951; + + // The name of the sub public delegated prefix. + optional string name = 3373707; + + // [Output Only] The region of the sub public delegated prefix if it is regional. If absent, the sub prefix is global. + optional string region = 138946292; + + // [Output Only] The status of the sub public delegated prefix. + optional Status status = 181260274; } -// -message RegionDisksRemoveResourcePoliciesRequest { - // Resource policies to be removed from this disk. - repeated string resource_policies = 22220385; +// 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 { + // [Output Only] The status of the public delegated prefix. + enum Status { + // A value indicating that the enum field is not set. + UNDEFINED_STATUS = 0; + + ANNOUNCED = 365103355; + + DELETING = 528602024; + + INITIALIZING = 306588749; + + } + + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 30525366; + + // An optional description of this resource. Provide this property when you create the resource. + optional string description = 422937596; + + // 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 = 234678500; + + // [Output Only] The unique identifier for the resource type. The server generates this identifier. + optional string id = 3355; + + // The IPv4 address range, in CIDR format, represented by this public delegated prefix. + optional string ip_cidr_range = 98117322; + + // If true, the prefix will be live migrated. + optional bool is_live_migration = 511823856; + + // [Output Only] Type of the resource. Always compute#publicDelegatedPrefix for public delegated prefixes. + optional string kind = 3292052; + + // 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 = 3373707; + + // The URL of parent prefix. Either PublicAdvertisedPrefix or PublicDelegatedPrefix. + optional string parent_prefix = 15233991; + + // The list of sub public delegated prefixes that exist for this public delegated prefix. + repeated PublicDelegatedPrefixPublicDelegatedSubPrefix public_delegated_sub_prefixs = 188940044; + + // [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 = 138946292; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 456214797; + + // [Output Only] The status of the public delegated prefix. + optional Status status = 181260274; } // -message RegionDisksResizeRequest { - // The new size of the regional persistent disk, which is specified in GB. - optional string size_gb = 494929369; +message PublicDelegatedPrefixesScopedList { + // [Output Only] A list of PublicDelegatedPrefixes contained in this scope. + repeated PublicDelegatedPrefix public_delegated_prefixes = 315261206; + + // [Output Only] Informational warning which replaces the list of public delegated prefixes when the list is empty. + optional Warning warning = 50704284; } -// Contains a list of InstanceGroup resources. -message RegionInstanceGroupList { +// +message PublicDelegatedPrefixAggregatedList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 3355; - // A list of InstanceGroup resources. - repeated InstanceGroup items = 100526016; + // A list of PublicDelegatedPrefixesScopedList resources. + map items = 100526016; - // The resource type. + // [Output Only] Type of the resource. Always compute#publicDelegatedPrefixAggregatedList for aggregated lists of public delegated prefixes. optional string kind = 3292052; // [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. @@ -9862,27 +10560,23 @@ message RegionInstanceGroupList { // [Output Only] Server-defined URL for this resource. optional string self_link = 456214797; + // [Output Only] Unreachable resources. + repeated string unreachables = 243372063; + // [Output Only] Informational warning message. optional Warning warning = 50704284; } -// 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 = 104585032; - -} - -// Contains a list of managed instance groups. -message RegionInstanceGroupManagerList { +// +message PublicDelegatedPrefixList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 3355; - // A list of InstanceGroupManager resources. - repeated InstanceGroupManager items = 100526016; + // A list of PublicDelegatedPrefix resources. + repeated PublicDelegatedPrefix items = 100526016; - // [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] Type of the resource. Always compute#publicDelegatedPrefixList for public delegated prefixes. optional string kind = 3292052; // [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. @@ -9896,14 +10590,180 @@ message RegionInstanceGroupManagerList { } -// RegionInstanceGroupManagers.patchPerInstanceConfigs -message RegionInstanceGroupManagerPatchInstanceConfigReq { - // The list of per-instance configs to insert or patch on this managed instance group. - repeated PerInstanceConfig per_instance_configs = 526265001; +// Represents a Region resource. +// +// A region is a geographical area where a resource is located. For more information, read Regions and Zones. (== resource_for {$api_version}.regions ==) +message Region { + // [Output Only] Status of the region, either UP or DOWN. + enum Status { + // A value indicating that the enum field is not set. + UNDEFINED_STATUS = 0; -} + DOWN = 2104482; -// RegionInstanceGroupManagers.updatePerInstanceConfigs + UP = 2715; + + } + + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 30525366; + + // [Output Only] The deprecation status associated with this region. + optional DeprecationStatus deprecated = 515138995; + + // [Output Only] Textual description of the resource. + optional string description = 422937596; + + // [Output Only] The unique identifier for the resource. This identifier is defined by the server. + optional string id = 3355; + + // [Output Only] Type of the resource. Always compute#region for regions. + optional string kind = 3292052; + + // [Output Only] Name of the resource. + optional string name = 3373707; + + // [Output Only] Quotas assigned to this region. + repeated Quota quotas = 125341947; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 456214797; + + // [Output Only] Status of the region, either UP or DOWN. + optional Status status = 181260274; + + // [Output Only] Reserved for future use. + optional bool supports_pzs = 83983214; + + // [Output Only] A list of zones available in this region, in the form of resource URLs. + repeated string zones = 116085319; + +} + +// Contains a list of autoscalers. +message RegionAutoscalerList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 3355; + + // A list of Autoscaler resources. + repeated Autoscaler items = 100526016; + + // Type of resource. + optional string kind = 3292052; + + // [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + optional string next_page_token = 79797525; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 456214797; + + // [Output Only] Informational warning message. + optional Warning warning = 50704284; + +} + +// +message RegionDiskTypeList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 3355; + + // A list of DiskType resources. + repeated DiskType items = 100526016; + + // [Output Only] Type of resource. Always compute#regionDiskTypeList for region disk types. + optional string kind = 3292052; + + // [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + optional string next_page_token = 79797525; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 456214797; + + // [Output Only] Informational warning message. + optional Warning warning = 50704284; + +} + +// +message RegionDisksAddResourcePoliciesRequest { + // Resource policies to be added to this disk. + repeated string resource_policies = 22220385; + +} + +// +message RegionDisksRemoveResourcePoliciesRequest { + // Resource policies to be removed from this disk. + repeated string resource_policies = 22220385; + +} + +// +message RegionDisksResizeRequest { + // The new size of the regional persistent disk, which is specified in GB. + optional string size_gb = 494929369; + +} + +// Contains a list of InstanceGroup resources. +message RegionInstanceGroupList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 3355; + + // A list of InstanceGroup resources. + repeated InstanceGroup items = 100526016; + + // The resource type. + optional string kind = 3292052; + + // [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + optional string next_page_token = 79797525; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 456214797; + + // [Output Only] Informational warning message. + optional Warning warning = 50704284; + +} + +// 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 = 104585032; + +} + +// Contains a list of managed instance groups. +message RegionInstanceGroupManagerList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 3355; + + // A list of InstanceGroupManager resources. + repeated InstanceGroupManager items = 100526016; + + // [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 = 3292052; + + // [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. + optional string next_page_token = 79797525; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 456214797; + + // [Output Only] Informational warning message. + optional Warning warning = 50704284; + +} + +// RegionInstanceGroupManagers.patchPerInstanceConfigs +message RegionInstanceGroupManagerPatchInstanceConfigReq { + // The list of per-instance configs to insert or patch on this managed instance group. + repeated PerInstanceConfig per_instance_configs = 526265001; + +} + +// RegionInstanceGroupManagers.updatePerInstanceConfigs message RegionInstanceGroupManagerUpdateInstanceConfigReq { // The list of per-instance configs to insert or patch on this managed instance group. repeated PerInstanceConfig per_instance_configs = 526265001; @@ -10286,6 +11146,8 @@ message ResourcePolicy { DELETING = 528602024; + EXPIRED = 482489093; + INVALID = 530283991; READY = 77848963; @@ -10303,6 +11165,9 @@ message ResourcePolicy { // [Output Only] The unique identifier for the resource. This identifier is defined by the server. optional string id = 3355; + // Resource policy for scheduling instance operations. + optional ResourcePolicyInstanceSchedulePolicy instance_schedule_policy = 344877104; + // [Output Only] Type of the resource. Always compute#resource_policies for resource policies. optional string kind = 3292052; @@ -10311,6 +11176,9 @@ message ResourcePolicy { optional string region = 138946292; + // [Output Only] The system status of the resource policy. + optional ResourcePolicyResourceStatus resource_status = 249429315; + // [Output Only] Server-defined fully-qualified URL for this resource. optional string self_link = 456214797; @@ -10356,6 +11224,32 @@ message ResourcePolicyGroupPlacementPolicy { } +// 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 = 230299229; + + // The start time of the schedule. The timestamp is an RFC3339 string. + optional string start_time = 37467274; + + // 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: http://en.wikipedia.org/wiki/Tz_database. + optional string time_zone = 36848094; + + // Specifies the schedule for starting instances. + optional ResourcePolicyInstanceSchedulePolicySchedule vm_start_schedule = 17762396; + + // Specifies the schedule for stopping instances. + optional ResourcePolicyInstanceSchedulePolicySchedule vm_stop_schedule = 426242732; + +} + +// 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 = 344877104; + +} + // 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. @@ -10422,6 +11316,13 @@ message ResourcePolicyHourlyCycle { } +// Schedule for an instance operation. +message ResourcePolicyInstanceSchedulePolicySchedule { + // Specifies the frequency for the operation, using the unix-cron format. + optional string schedule = 375820951; + +} + // message ResourcePolicyList { optional string etag = 3123477; @@ -10446,6 +11347,16 @@ message ResourcePolicyList { } +// +message ResourcePolicyResourceStatusInstanceSchedulePolicyStatus { + // [Output Only] The last time the schedule successfully ran. The timestamp is an RFC3339 string. + optional string last_run_start_time = 303069063; + + // [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 = 318642570; + +} + // Policy for retention of scheduled snapshots. message ResourcePolicySnapshotSchedulePolicyRetentionPolicy { // Specifies the behavior to apply to scheduled snapshots when the source disk is deleted. @@ -10700,8 +11611,7 @@ message RouterBgpPeer { // User-specified list of prefix groups to advertise in custom mode, which can take one of the following options: // - ALL_SUBNETS: Advertises all available subnets, including peer VPC subnets. - // - ALL_VPC_SUBNETS: Advertises the router's own VPC subnets. - // - ALL_PEER_VPC_SUBNETS: Advertises peer subnets of the router's VPC network. 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. + // - ALL_VPC_SUBNETS: Advertises the router's own VPC subnets. 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 AdvertisedGroups advertised_groups = 21065526; // 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. @@ -10858,6 +11768,10 @@ message Router { // An optional description of this resource. Provide this property when you create the resource. optional string description = 422937596; + // Field to indicate if a router is dedicated to use with encrypted Interconnect Attachment (IPsec-encrypted Cloud Interconnect feature). + // Not currently available in all Interconnect locations. + optional bool encrypted_interconnect_router = 297996575; + // [Output Only] The unique identifier for the resource. This identifier is defined by the server. optional string id = 3355; @@ -11164,7 +12078,7 @@ message SecurityPoliciesListPreconfiguredExpressionSetsResponse { // 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 preform when the client connection triggers the rule. Can currently be either "allow" or "deny()" where valid values for status are 403, 404, and 502. + // The Action to perform when the client connection triggers the rule. Can currently be either "allow" or "deny()" where valid values for status are 403, 404, and 502. optional string action = 187661878; // An optional description of this resource. Provide this property when you create the resource. @@ -11392,9 +12306,15 @@ message Snapshot { // [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 = 337642578; + // 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 = 350519505; + // 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 = 3373707; + // [Output Only] Reserved for future use. + optional bool satisfies_pzs = 480964267; + // [Output Only] Server-defined URL for the resource. optional string self_link = 456214797; @@ -11476,7 +12396,7 @@ message SslCertificateManagedSslCertificate { // [Output only] Detailed statuses of the domains specified for managed certificate resource. map domain_status = 360305613; - // The domains for which a managed SSL certificate will be generated. Currently only single-domain certs are supported. + // 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 = 226935855; // [Output only] Status of the managed certificate resource. @@ -11778,7 +12698,7 @@ message SubnetworkLogConfig { } - // 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 INCLUDE_ALL_METADATA. + // 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. enum Metadata { // A value indicating that the enum field is not set. UNDEFINED_METADATA = 0; @@ -11803,7 +12723,7 @@ message SubnetworkLogConfig { // 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, which means half of all collected logs are reported. optional float flow_sampling = 530150360; - // 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 INCLUDE_ALL_METADATA. + // 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. optional Metadata metadata = 86866735; // Can only be specified if VPC flow logs for this subnetwork is enabled and "metadata" was set to CUSTOM_METADATA. @@ -11813,7 +12733,7 @@ message SubnetworkLogConfig { // 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. This may be a RFC 1918 IP range, or a privately, non-RFC 1918 IP range, not belonging to Google. + // 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 = 98117322; // 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. @@ -11864,7 +12784,7 @@ message Subnetwork { } - // [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 CREATING: Subnetwork is provisioning DELETING: Subnetwork is being deleted UPDATING: Subnetwork is being updated + // [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 enum State { // A value indicating that the enum field is not set. UNDEFINED_STATE = 0; @@ -11895,7 +12815,7 @@ message Subnetwork { // [Output Only] The unique identifier for the resource. This identifier is defined by the server. optional string id = 3355; - // The range of internal addresses that are owned by this subnetwork. Provide this property when you create the subnetwork. For example, 10.0.0.0/8 or 100.64.0.0/10. Ranges must be unique and non-overlapping within a network. Only IPv4 is supported. This field is set at resource creation time. This may be a RFC 1918 IP range, or a privately routed, non-RFC 1918 IP range, not belonging to Google. The range can be expanded after creation using expandIpCidrRange. + // 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 = 98117322; // [Output Only] The range of internal IPv6 addresses that are owned by this subnetwork. @@ -11936,7 +12856,7 @@ message Subnetwork { // [Output Only] Server-defined URL for the resource. optional string self_link = 456214797; - // [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 CREATING: Subnetwork is provisioning DELETING: Subnetwork is being deleted UPDATING: Subnetwork is being updated + // [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 optional State state = 109757585; } @@ -12013,7 +12933,7 @@ message SubnetworksSetPrivateIpGoogleAccessRequest { // Represents a Target gRPC Proxy resource. // -// A target gRPC proxy is a component of load balancers intended for load balancing gRPC traffic. Global forwarding rules reference a target gRPC proxy. The Target gRPC Proxy references a URL map which specifies how traffic routes to gRPC backend services. (== resource_for {$api_version}.targetGrpcProxies ==) +// 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. (== resource_for {$api_version}.targetGrpcProxies ==) message TargetGrpcProxy { // [Output Only] Creation timestamp in RFC3339 text format. optional string creation_timestamp = 30525366; @@ -12188,7 +13108,6 @@ message TargetHttpsProxy { // - 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. - // - enum QuicOverride { // A value indicating that the enum field is not set. UNDEFINED_QUIC_OVERRIDE = 0; @@ -12213,6 +13132,9 @@ message TargetHttpsProxy { // An optional description of this resource. Provide this property when you create the resource. optional string description = 422937596; + // 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 = 234678500; + // [Output Only] The unique identifier for the resource. This identifier is defined by the server. optional string id = 3355; @@ -12234,7 +13156,6 @@ message TargetHttpsProxy { // - 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. - // - optional QuicOverride quic_override = 456577197; // [Output Only] URL of the region where the regional TargetHttpsProxy resides. This field is not applicable to global TargetHttpsProxies. @@ -12463,6 +13384,8 @@ message TargetPool { CLIENT_IP = 345665051; + CLIENT_IP_NO_DESTINATION = 106122516; + CLIENT_IP_PORT_PROTO = 221722926; CLIENT_IP_PROTO = 25322148; @@ -12497,7 +13420,7 @@ message TargetPool { // 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 = 212667006; - // The URL of the HttpHealthCheck resource. A member instance in this pool is considered healthy if and only if the health checks pass. An empty list means all member instances will be considered healthy at all times. Only legacy HttpHealthChecks are supported. Only one health check may be specified. + // 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 = 448370606; // [Output Only] The unique identifier for the resource. This identifier is defined by the server. @@ -12788,6 +13711,13 @@ message TargetTcpProxy { // 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 = 3373707; + // 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 = 286025582; + // Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE. optional ProxyHeader proxy_header = 160374142; @@ -12932,14 +13862,39 @@ message TargetVpnGatewayList { } +// HTTP headers used in UrlMapTests. +message UrlMapTestHeader { + // Header name. + optional string name = 3373707; + + // Header value. + optional string value = 111972721; + +} + // message TestFailure { + // The actual output URL evaluated by load balancer containing the scheme, host, path and query parameters. + optional string actual_output_url = 287075458; + + // Actual HTTP status code for rule with `urlRedirect` calculated by load balancer + optional int32 actual_redirect_response_code = 42926553; + // BackendService or BackendBucket returned by load balancer. optional string actual_service = 440379652; + // The expected output URL evaluated by load balancer containing the scheme, host, path and query parameters. + optional string expected_output_url = 433967384; + + // Expected HTTP status code for rule with `urlRedirect` calculated by load balancer + optional int32 expected_redirect_response_code = 18888047; + // Expected BackendService or BackendBucket resource the given URL should be mapped to. optional string expected_service = 133987374; + // HTTP headers of the request. + repeated UrlMapTestHeader headers = 258436998; + // Host portion of the URL. optional string host = 3208616; @@ -12967,6 +13922,19 @@ message UrlMapTest { // Description of this test case. optional string description = 422937596; + // The expected output URL evaluated by 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 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 = 433967384; + + // 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 = 18888047; + + // HTTP headers for this request. If headers contains a host header, then host must also match the header value. + repeated UrlMapTestHeader headers = 258436998; + // Host portion of the URL. If headers contains a host header, then host must also match the header value. optional string host = 3208616; @@ -13175,6 +14143,10 @@ message VpnGatewayVpnGatewayInterface { // The numeric ID of this VPN gateway interface. optional uint32 id = 3355; + // URL of the interconnect attachment resource. When the value of this field is present, the VPN Gateway will be used for IPsec-encrypted Cloud Interconnect; all Egress or Ingress traffic for this VPN Gateway interface will go through the specified interconnect attachment resource. + // Not currently available in all Interconnect locations. + optional string interconnect_attachment = 308135284; + // [Output Only] The external IP address for this VPN gateway interface. optional string ip_address = 406272220; @@ -13365,7 +14337,7 @@ message VpnTunnel { // - 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 blacklisted. + // - 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. @@ -13467,7 +14439,7 @@ message VpnTunnel { // - 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 blacklisted. + // - 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. @@ -13616,6 +14588,9 @@ message Zone { // [Output Only] Status of the zone, either UP or DOWN. optional Status status = 181260274; + // [Output Only] Reserved for future use. + optional bool supports_pzs = 83983214; + } // Contains a list of zone resources. @@ -13693,7 +14668,7 @@ message AggregatedListAcceleratorTypesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -13738,7 +14713,7 @@ message ListAcceleratorTypesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; // The name of the zone for this request. @@ -13776,7 +14751,7 @@ message AggregatedListAddressesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -13864,7 +14839,7 @@ message ListAddressesRequest { // Name of the region for this request. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -13899,7 +14874,7 @@ message AggregatedListAutoscalersRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -13984,7 +14959,7 @@ message ListAutoscalersRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; // Name of the zone for this request. @@ -14149,7 +15124,7 @@ message ListBackendBucketsRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -14244,7 +15219,7 @@ message AggregatedListBackendServicesRequest { // Name of the project scoping this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -14352,7 +15327,7 @@ message ListBackendServicesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -14447,7 +15422,7 @@ message AggregatedListDiskTypesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -14492,7 +15467,7 @@ message ListDiskTypesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; // The name of the zone for this request. @@ -14553,7 +15528,7 @@ message AggregatedListDisksRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -14648,7 +15623,7 @@ message InsertDiskRequest { // The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). optional string request_id = 37109963; - // Optional. Source image to restore onto a disk. + // Source image to restore onto a disk. This field is optional. optional string source_image = 50443319; // The name of the zone for this request. @@ -14683,7 +15658,7 @@ message ListDisksRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; // The name of the zone for this request. @@ -14863,7 +15838,7 @@ message ListExternalVpnGatewaysRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -14894,13 +15869,16 @@ message TestIamPermissionsExternalVpnGatewayRequest { } -// A request message for Firewalls.Delete. See the method description for details. -message DeleteFirewallRequest { - // Name of the firewall rule to delete. - string firewall = 511016192 [(google.api.field_behavior) = REQUIRED]; +// A request message for FirewallPolicies.AddAssociation. See the method description for details. +message AddAssociationFirewallPolicyRequest { + // Name of the firewall policy to update. + string firewall_policy = 498173265 [(google.api.field_behavior) = REQUIRED]; - // Project ID for this request. - string project = 227560217 [(google.api.field_behavior) = REQUIRED]; + // The body resource for this request + FirewallPolicyAssociation firewall_policy_association_resource = 259546170 [(google.api.field_behavior) = REQUIRED]; + + // 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 = 209541240; // An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. // @@ -14911,23 +15889,13 @@ message DeleteFirewallRequest { } -// A request message for Firewalls.Get. See the method description for details. -message GetFirewallRequest { - // Name of the firewall rule to return. - string firewall = 511016192 [(google.api.field_behavior) = REQUIRED]; - - // Project ID for this request. - string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - -} +// A request message for FirewallPolicies.AddRule. See the method description for details. +message AddRuleFirewallPolicyRequest { + // Name of the firewall policy to update. + string firewall_policy = 498173265 [(google.api.field_behavior) = REQUIRED]; -// A request message for Firewalls.Insert. See the method description for details. -message InsertFirewallRequest { // The body resource for this request - Firewall firewall_resource = 41425005 [(google.api.field_behavior) = REQUIRED]; - - // Project ID for this request. - string project = 227560217 [(google.api.field_behavior) = REQUIRED]; + FirewallPolicyRule firewall_policy_rule_resource = 250523523 [(google.api.field_behavior) = REQUIRED]; // An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. // @@ -14938,22 +15906,298 @@ message InsertFirewallRequest { } -// A request message for Firewalls.List. See the method description for details. -message ListFirewallsRequest { - // A filter expression that filters resources listed in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either `=`, `!=`, `>`, or `<`. - // - // For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. +// A request message for FirewallPolicies.CloneRules. See the method description for details. +message CloneRulesFirewallPolicyRequest { + // Name of the firewall policy to update. + string firewall_policy = 498173265 [(google.api.field_behavior) = REQUIRED]; + + // An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. // - // You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. + // For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. // - // To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` - optional string filter = 336120696; + // The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + optional string request_id = 37109963; - // The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` 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 = 54715419; + // The firewall policy from which to copy rules. + optional string source_firewall_policy = 25013549; - // Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. - // +} + +// A request message for FirewallPolicies.Delete. See the method description for details. +message DeleteFirewallPolicyRequest { + // Name of the firewall policy to delete. + string firewall_policy = 498173265 [(google.api.field_behavior) = REQUIRED]; + + // An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. + // + // For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + optional string request_id = 37109963; + +} + +// A request message for FirewallPolicies.Get. See the method description for details. +message GetFirewallPolicyRequest { + // Name of the firewall policy to get. + string firewall_policy = 498173265 [(google.api.field_behavior) = REQUIRED]; + +} + +// A request message for FirewallPolicies.GetAssociation. See the method description for details. +message GetAssociationFirewallPolicyRequest { + // Name of the firewall policy to which the queried rule belongs. + string firewall_policy = 498173265 [(google.api.field_behavior) = REQUIRED]; + + // The name of the association to get from the firewall policy. + optional string name = 3373707; + +} + +// A request message for FirewallPolicies.GetIamPolicy. See the method description for details. +message GetIamPolicyFirewallPolicyRequest { + // Requested IAM Policy version. + optional int32 options_requested_policy_version = 499220029; + + // Name or id of the resource for this request. + string resource = 195806222 [(google.api.field_behavior) = REQUIRED]; + +} + +// A request message for FirewallPolicies.GetRule. See the method description for details. +message GetRuleFirewallPolicyRequest { + // Name of the firewall policy to which the queried rule belongs. + string firewall_policy = 498173265 [(google.api.field_behavior) = REQUIRED]; + + // The priority of the rule to get from the firewall policy. + optional int32 priority = 445151652; + +} + +// A request message for FirewallPolicies.Insert. See the method description for details. +message InsertFirewallPolicyRequest { + // The body resource for this request + FirewallPolicy firewall_policy_resource = 495049532 [(google.api.field_behavior) = REQUIRED]; + + // 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 = 459714768; + + // An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. + // + // For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + optional string request_id = 37109963; + +} + +// A request message for FirewallPolicies.List. See the method description for details. +message ListFirewallPoliciesRequest { + // A filter expression that filters resources listed in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either `=`, `!=`, `>`, or `<`. + // + // For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. + // + // You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. + // + // To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` + optional string filter = 336120696; + + // The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` 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 = 54715419; + + // Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use 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 = 160562920; + + // 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 = 19994697; + + // Parent ID for this request. + optional string parent_id = 459714768; + + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. + optional bool return_partial_success = 517198390; + +} + +// A request message for FirewallPolicies.ListAssociations. See the method description for details. +message ListAssociationsFirewallPolicyRequest { + // The target resource to list associations. It is an organization, or a folder. + optional string target_resource = 467318524; + +} + +// A request message for FirewallPolicies.Move. See the method description for details. +message MoveFirewallPolicyRequest { + // Name of the firewall policy to update. + string firewall_policy = 498173265 [(google.api.field_behavior) = REQUIRED]; + + // The new parent of the firewall policy. + optional string parent_id = 459714768; + + // An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. + // + // For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + optional string request_id = 37109963; + +} + +// A request message for FirewallPolicies.Patch. See the method description for details. +message PatchFirewallPolicyRequest { + // Name of the firewall policy to update. + string firewall_policy = 498173265 [(google.api.field_behavior) = REQUIRED]; + + // The body resource for this request + FirewallPolicy firewall_policy_resource = 495049532 [(google.api.field_behavior) = REQUIRED]; + + // An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. + // + // For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + optional string request_id = 37109963; + +} + +// A request message for FirewallPolicies.PatchRule. See the method description for details. +message PatchRuleFirewallPolicyRequest { + // Name of the firewall policy to update. + string firewall_policy = 498173265 [(google.api.field_behavior) = REQUIRED]; + + // The body resource for this request + FirewallPolicyRule firewall_policy_rule_resource = 250523523 [(google.api.field_behavior) = REQUIRED]; + + // The priority of the rule to patch. + optional int32 priority = 445151652; + + // An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. + // + // For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + optional string request_id = 37109963; + +} + +// A request message for FirewallPolicies.RemoveAssociation. See the method description for details. +message RemoveAssociationFirewallPolicyRequest { + // Name of the firewall policy to update. + string firewall_policy = 498173265 [(google.api.field_behavior) = REQUIRED]; + + // Name for the attachment that will be removed. + optional string name = 3373707; + + // An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. + // + // For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + optional string request_id = 37109963; + +} + +// A request message for FirewallPolicies.RemoveRule. See the method description for details. +message RemoveRuleFirewallPolicyRequest { + // Name of the firewall policy to update. + string firewall_policy = 498173265 [(google.api.field_behavior) = REQUIRED]; + + // The priority of the rule to remove from the firewall policy. + optional int32 priority = 445151652; + + // An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. + // + // For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + optional string request_id = 37109963; + +} + +// A request message for FirewallPolicies.SetIamPolicy. See the method description for details. +message SetIamPolicyFirewallPolicyRequest { + // The body resource for this request + GlobalOrganizationSetPolicyRequest global_organization_set_policy_request_resource = 177408606 [(google.api.field_behavior) = REQUIRED]; + + // Name or id of the resource for this request. + string resource = 195806222 [(google.api.field_behavior) = REQUIRED]; + +} + +// A request message for FirewallPolicies.TestIamPermissions. See the method description for details. +message TestIamPermissionsFirewallPolicyRequest { + // Name or id of the resource for this request. + string resource = 195806222 [(google.api.field_behavior) = REQUIRED]; + + // The body resource for this request + TestPermissionsRequest test_permissions_request_resource = 439214758 [(google.api.field_behavior) = REQUIRED]; + +} + +// A request message for Firewalls.Delete. See the method description for details. +message DeleteFirewallRequest { + // Name of the firewall rule to delete. + string firewall = 511016192 [(google.api.field_behavior) = REQUIRED]; + + // Project ID for this request. + string project = 227560217 [(google.api.field_behavior) = REQUIRED]; + + // An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. + // + // For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + optional string request_id = 37109963; + +} + +// A request message for Firewalls.Get. See the method description for details. +message GetFirewallRequest { + // Name of the firewall rule to return. + string firewall = 511016192 [(google.api.field_behavior) = REQUIRED]; + + // Project ID for this request. + string project = 227560217 [(google.api.field_behavior) = REQUIRED]; + +} + +// A request message for Firewalls.Insert. See the method description for details. +message InsertFirewallRequest { + // The body resource for this request + Firewall firewall_resource = 41425005 [(google.api.field_behavior) = REQUIRED]; + + // Project ID for this request. + string project = 227560217 [(google.api.field_behavior) = REQUIRED]; + + // An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. + // + // For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + optional string request_id = 37109963; + +} + +// A request message for Firewalls.List. See the method description for details. +message ListFirewallsRequest { + // A filter expression that filters resources listed in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either `=`, `!=`, `>`, or `<`. + // + // For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. + // + // You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. + // + // To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` + optional string filter = 336120696; + + // The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` 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 = 54715419; + + // Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. + // // You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. // // Currently, only sorting by `name` or `creationTimestamp desc` is supported. @@ -14965,7 +16209,7 @@ message ListFirewallsRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -15040,7 +16284,7 @@ message AggregatedListForwardingRulesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -15128,7 +16372,7 @@ message ListForwardingRulesRequest { // Name of the region scoping this request. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -15156,6 +16400,29 @@ message PatchForwardingRuleRequest { } +// A request message for ForwardingRules.SetLabels. See the method description for details. +message SetLabelsForwardingRuleRequest { + // Project ID for this request. + string project = 227560217 [(google.api.field_behavior) = REQUIRED]; + + // The region for this request. + string region = 138946292 [(google.api.field_behavior) = REQUIRED]; + + // The body resource for this request + RegionSetLabelsRequest region_set_labels_request_resource = 259357782 [(google.api.field_behavior) = REQUIRED]; + + // An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. + // + // For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + optional string request_id = 37109963; + + // Name or id of the resource for this request. + string resource = 195806222 [(google.api.field_behavior) = REQUIRED]; + +} + // A request message for ForwardingRules.SetTarget. See the method description for details. message SetTargetForwardingRuleRequest { // Name of the ForwardingRule resource in which target is to be set. @@ -15250,7 +16517,7 @@ message ListGlobalAddressesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -15326,7 +16593,7 @@ message ListGlobalForwardingRulesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -15351,6 +16618,19 @@ message PatchGlobalForwardingRuleRequest { } +// A request message for GlobalForwardingRules.SetLabels. See the method description for details. +message SetLabelsGlobalForwardingRuleRequest { + // The body resource for this request + GlobalSetLabelsRequest global_set_labels_request_resource = 319917189 [(google.api.field_behavior) = REQUIRED]; + + // Project ID for this request. + string project = 227560217 [(google.api.field_behavior) = REQUIRED]; + + // Name or id of the resource for this request. + string resource = 195806222 [(google.api.field_behavior) = REQUIRED]; + +} + // A request message for GlobalForwardingRules.SetTarget. See the method description for details. message SetTargetGlobalForwardingRuleRequest { // Name of the ForwardingRule resource in which target is to be set. @@ -15482,7 +16762,7 @@ message ListGlobalNetworkEndpointGroupsRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -15517,7 +16797,7 @@ message ListNetworkEndpointsGlobalNetworkEndpointGroupsRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -15552,7 +16832,7 @@ message AggregatedListGlobalOperationsRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -15608,7 +16888,7 @@ message ListGlobalOperationsRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -15674,11 +16954,107 @@ message ListGlobalOrganizationOperationsRequest { // Parent ID for this request. optional string parent_id = 459714768; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } +// A request message for GlobalPublicDelegatedPrefixes.Delete. See the method description for details. +message DeleteGlobalPublicDelegatedPrefixeRequest { + // Project ID for this request. + string project = 227560217 [(google.api.field_behavior) = REQUIRED]; + + // Name of the PublicDelegatedPrefix resource to delete. + string public_delegated_prefix = 204238440 [(google.api.field_behavior) = REQUIRED]; + + // An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. + // + // For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + optional string request_id = 37109963; + +} + +// A request message for GlobalPublicDelegatedPrefixes.Get. See the method description for details. +message GetGlobalPublicDelegatedPrefixeRequest { + // Project ID for this request. + string project = 227560217 [(google.api.field_behavior) = REQUIRED]; + + // Name of the PublicDelegatedPrefix resource to return. + string public_delegated_prefix = 204238440 [(google.api.field_behavior) = REQUIRED]; + +} + +// A request message for GlobalPublicDelegatedPrefixes.Insert. See the method description for details. +message InsertGlobalPublicDelegatedPrefixeRequest { + // Project ID for this request. + string project = 227560217 [(google.api.field_behavior) = REQUIRED]; + + // The body resource for this request + PublicDelegatedPrefix public_delegated_prefix_resource = 47594501 [(google.api.field_behavior) = REQUIRED]; + + // An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. + // + // For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + optional string request_id = 37109963; + +} + +// A request message for GlobalPublicDelegatedPrefixes.List. See the method description for details. +message ListGlobalPublicDelegatedPrefixesRequest { + // A filter expression that filters resources listed in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either `=`, `!=`, `>`, or `<`. + // + // For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. + // + // You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. + // + // To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` + optional string filter = 336120696; + + // The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` 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 = 54715419; + + // Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use 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 = 160562920; + + // 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 = 19994697; + + // Project ID for this request. + string project = 227560217 [(google.api.field_behavior) = REQUIRED]; + + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. + optional bool return_partial_success = 517198390; + +} + +// A request message for GlobalPublicDelegatedPrefixes.Patch. See the method description for details. +message PatchGlobalPublicDelegatedPrefixeRequest { + // Project ID for this request. + string project = 227560217 [(google.api.field_behavior) = REQUIRED]; + + // Name of the PublicDelegatedPrefix resource to patch. + string public_delegated_prefix = 204238440 [(google.api.field_behavior) = REQUIRED]; + + // The body resource for this request + PublicDelegatedPrefix public_delegated_prefix_resource = 47594501 [(google.api.field_behavior) = REQUIRED]; + + // An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. + // + // For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + optional string request_id = 37109963; + +} + // A request message for HealthChecks.AggregatedList. See the method description for details. message AggregatedListHealthChecksRequest { // A filter expression that filters resources listed in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either `=`, `!=`, `>`, or `<`. @@ -15709,7 +17085,7 @@ message AggregatedListHealthChecksRequest { // Name of the project scoping this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -15785,7 +17161,7 @@ message ListHealthChecksRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -15947,7 +17323,7 @@ message ListImagesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -16064,7 +17440,7 @@ message AggregatedListInstanceGroupManagersRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -16227,7 +17603,7 @@ message ListInstanceGroupManagersRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; // The name of the zone where the managed instance group is located. @@ -16265,7 +17641,7 @@ message ListErrorsInstanceGroupManagersRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; // The name of the zone where the managed instance group is located. It should conform to RFC1035. @@ -16303,7 +17679,7 @@ message ListManagedInstancesInstanceGroupManagersRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; // The name of the zone where the managed instance group is located. @@ -16341,7 +17717,7 @@ message ListPerInstanceConfigsInstanceGroupManagersRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; // The name of the zone where the managed instance group is located. It should conform to RFC1035. @@ -16563,7 +17939,7 @@ message AggregatedListInstanceGroupsRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -16648,7 +18024,7 @@ message ListInstanceGroupsRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; // The name of the zone where the instance group is located. @@ -16689,7 +18065,7 @@ message ListInstancesInstanceGroupsRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; // The name of the zone where the instance group is located. @@ -16827,7 +18203,7 @@ message ListInstanceTemplatesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -16937,21 +18313,41 @@ message AggregatedListInstancesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. - optional bool return_partial_success = 517198390; + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. + optional bool return_partial_success = 517198390; + +} + +// A request message for Instances.AttachDisk. See the method description for details. +message AttachDiskInstanceRequest { + // The body resource for this request + AttachedDisk attached_disk_resource = 90605845 [(google.api.field_behavior) = REQUIRED]; + + // 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 = 142758425; + + // The instance name for this request. + string instance = 18257045 [(google.api.field_behavior) = REQUIRED]; + + // Project ID for this request. + string project = 227560217 [(google.api.field_behavior) = REQUIRED]; + + // An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. + // + // For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + optional string request_id = 37109963; + + // The name of the zone for this request. + string zone = 3744684 [(google.api.field_behavior) = REQUIRED]; } -// A request message for Instances.AttachDisk. See the method description for details. -message AttachDiskInstanceRequest { +// A request message for Instances.BulkInsert. See the method description for details. +message BulkInsertInstanceRequest { // The body resource for this request - AttachedDisk attached_disk_resource = 90605845 [(google.api.field_behavior) = REQUIRED]; - - // 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 = 142758425; - - // The instance name for this request. - string instance = 18257045 [(google.api.field_behavior) = REQUIRED]; + BulkInsertInstanceResource bulk_insert_instance_resource_resource = 41427278 [(google.api.field_behavior) = REQUIRED]; // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; @@ -17050,6 +18446,22 @@ message GetInstanceRequest { } +// A request message for Instances.GetEffectiveFirewalls. See the method description for details. +message GetEffectiveFirewallsInstanceRequest { + // Name of the instance scoping this request. + string instance = 18257045 [(google.api.field_behavior) = REQUIRED]; + + // The name of the network interface to get the effective firewalls. + string network_interface = 365387880 [(google.api.field_behavior) = REQUIRED]; + + // Project ID for this request. + string project = 227560217 [(google.api.field_behavior) = REQUIRED]; + + // The name of the zone for this request. + string zone = 3744684 [(google.api.field_behavior) = REQUIRED]; + +} + // A request message for Instances.GetGuestAttributes. See the method description for details. message GetGuestAttributesInstanceRequest { // Name of the instance scoping this request. @@ -17189,7 +18601,7 @@ message ListInstancesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; // The name of the zone for this request. @@ -17227,7 +18639,7 @@ message ListReferrersInstancesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; // The name of the zone for this request. @@ -17799,7 +19211,7 @@ message AggregatedListInterconnectAttachmentsRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -17890,7 +19302,7 @@ message ListInterconnectAttachmentsRequest { // Name of the region for this request. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -17955,7 +19367,7 @@ message ListInterconnectLocationsRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -18041,7 +19453,7 @@ message ListInterconnectsRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -18173,7 +19585,7 @@ message ListLicensesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -18234,7 +19646,7 @@ message AggregatedListMachineTypesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -18279,7 +19691,7 @@ message ListMachineTypesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; // The name of the zone for this request. @@ -18317,7 +19729,7 @@ message AggregatedListNetworkEndpointGroupsRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -18448,7 +19860,7 @@ message ListNetworkEndpointGroupsRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; // The name of the zone where the network endpoint group is located. It should comply with RFC1035. @@ -18489,7 +19901,7 @@ message ListNetworkEndpointsNetworkEndpointGroupsRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; // The name of the zone where the network endpoint group is located. It should comply with RFC1035. @@ -18560,6 +19972,16 @@ message GetNetworkRequest { } +// A request message for Networks.GetEffectiveFirewalls. See the method description for details. +message GetEffectiveFirewallsNetworkRequest { + // Name of the network for this request. + string network = 232872494 [(google.api.field_behavior) = REQUIRED]; + + // Project ID for this request. + string project = 227560217 [(google.api.field_behavior) = REQUIRED]; + +} + // A request message for Networks.Insert. See the method description for details. message InsertNetworkRequest { // The body resource for this request @@ -18604,7 +20026,7 @@ message ListNetworksRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -18659,7 +20081,7 @@ message ListPeeringRoutesNetworksRequest { // The region of the request. The response will include all subnet routes, static routes and dynamic routes in the region. optional string region = 138946292; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -18794,7 +20216,7 @@ message AggregatedListNodeGroupsRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -18921,7 +20343,7 @@ message ListNodeGroupsRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; // The name of the zone for this request. @@ -18959,7 +20381,7 @@ message ListNodesNodeGroupsRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; // The name of the zone for this request. @@ -19075,7 +20497,7 @@ message AggregatedListNodeTemplatesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -19179,7 +20601,7 @@ message ListNodeTemplatesRequest { // The name of the region for this request. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -19246,7 +20668,7 @@ message AggregatedListNodeTypesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -19291,7 +20713,7 @@ message ListNodeTypesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; // The name of the zone for this request. @@ -19329,7 +20751,7 @@ message AggregatedListPacketMirroringsRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -19417,7 +20839,7 @@ message ListPacketMirroringsRequest { // Name of the region for this request. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -19564,7 +20986,7 @@ message GetXpnResourcesProjectsRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -19599,7 +21021,7 @@ message ListXpnHostsProjectsRequest { // The body resource for this request ProjectsListXpnHostsRequest projects_list_xpn_hosts_request_resource = 238266391 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -19689,6 +21111,248 @@ message SetUsageExportBucketProjectRequest { } +// A request message for PublicAdvertisedPrefixes.Delete. See the method description for details. +message DeletePublicAdvertisedPrefixeRequest { + // Project ID for this request. + string project = 227560217 [(google.api.field_behavior) = REQUIRED]; + + // Name of the PublicAdvertisedPrefix resource to delete. + string public_advertised_prefix = 101874590 [(google.api.field_behavior) = REQUIRED]; + + // An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. + // + // For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + optional string request_id = 37109963; + +} + +// A request message for PublicAdvertisedPrefixes.Get. See the method description for details. +message GetPublicAdvertisedPrefixeRequest { + // Project ID for this request. + string project = 227560217 [(google.api.field_behavior) = REQUIRED]; + + // Name of the PublicAdvertisedPrefix resource to return. + string public_advertised_prefix = 101874590 [(google.api.field_behavior) = REQUIRED]; + +} + +// A request message for PublicAdvertisedPrefixes.Insert. See the method description for details. +message InsertPublicAdvertisedPrefixeRequest { + // Project ID for this request. + string project = 227560217 [(google.api.field_behavior) = REQUIRED]; + + // The body resource for this request + PublicAdvertisedPrefix public_advertised_prefix_resource = 233614223 [(google.api.field_behavior) = REQUIRED]; + + // An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. + // + // For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + optional string request_id = 37109963; + +} + +// A request message for PublicAdvertisedPrefixes.List. See the method description for details. +message ListPublicAdvertisedPrefixesRequest { + // A filter expression that filters resources listed in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either `=`, `!=`, `>`, or `<`. + // + // For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. + // + // You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. + // + // To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` + optional string filter = 336120696; + + // The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` 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 = 54715419; + + // Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use 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 = 160562920; + + // 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 = 19994697; + + // Project ID for this request. + string project = 227560217 [(google.api.field_behavior) = REQUIRED]; + + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. + optional bool return_partial_success = 517198390; + +} + +// A request message for PublicAdvertisedPrefixes.Patch. See the method description for details. +message PatchPublicAdvertisedPrefixeRequest { + // Project ID for this request. + string project = 227560217 [(google.api.field_behavior) = REQUIRED]; + + // Name of the PublicAdvertisedPrefix resource to patch. + string public_advertised_prefix = 101874590 [(google.api.field_behavior) = REQUIRED]; + + // The body resource for this request + PublicAdvertisedPrefix public_advertised_prefix_resource = 233614223 [(google.api.field_behavior) = REQUIRED]; + + // An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. + // + // For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + optional string request_id = 37109963; + +} + +// A request message for PublicDelegatedPrefixes.AggregatedList. See the method description for details. +message AggregatedListPublicDelegatedPrefixesRequest { + // A filter expression that filters resources listed in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either `=`, `!=`, `>`, or `<`. + // + // For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. + // + // You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. + // + // To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` + optional string filter = 336120696; + + // 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 = 391327988; + + // The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` 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 = 54715419; + + // Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use 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 = 160562920; + + // 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 = 19994697; + + // Name of the project scoping this request. + string project = 227560217 [(google.api.field_behavior) = REQUIRED]; + + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. + optional bool return_partial_success = 517198390; + +} + +// A request message for PublicDelegatedPrefixes.Delete. See the method description for details. +message DeletePublicDelegatedPrefixeRequest { + // Project ID for this request. + string project = 227560217 [(google.api.field_behavior) = REQUIRED]; + + // Name of the PublicDelegatedPrefix resource to delete. + string public_delegated_prefix = 204238440 [(google.api.field_behavior) = REQUIRED]; + + // Name of the region of this request. + string region = 138946292 [(google.api.field_behavior) = REQUIRED]; + + // An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. + // + // For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + optional string request_id = 37109963; + +} + +// A request message for PublicDelegatedPrefixes.Get. See the method description for details. +message GetPublicDelegatedPrefixeRequest { + // Project ID for this request. + string project = 227560217 [(google.api.field_behavior) = REQUIRED]; + + // Name of the PublicDelegatedPrefix resource to return. + string public_delegated_prefix = 204238440 [(google.api.field_behavior) = REQUIRED]; + + // Name of the region of this request. + string region = 138946292 [(google.api.field_behavior) = REQUIRED]; + +} + +// A request message for PublicDelegatedPrefixes.Insert. See the method description for details. +message InsertPublicDelegatedPrefixeRequest { + // Project ID for this request. + string project = 227560217 [(google.api.field_behavior) = REQUIRED]; + + // The body resource for this request + PublicDelegatedPrefix public_delegated_prefix_resource = 47594501 [(google.api.field_behavior) = REQUIRED]; + + // Name of the region of this request. + string region = 138946292 [(google.api.field_behavior) = REQUIRED]; + + // An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. + // + // For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + optional string request_id = 37109963; + +} + +// A request message for PublicDelegatedPrefixes.List. See the method description for details. +message ListPublicDelegatedPrefixesRequest { + // A filter expression that filters resources listed in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either `=`, `!=`, `>`, or `<`. + // + // For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. + // + // You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. + // + // To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` + optional string filter = 336120696; + + // The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` 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 = 54715419; + + // Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. + // + // You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use 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 = 160562920; + + // 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 = 19994697; + + // Project ID for this request. + string project = 227560217 [(google.api.field_behavior) = REQUIRED]; + + // Name of the region of this request. + string region = 138946292 [(google.api.field_behavior) = REQUIRED]; + + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. + optional bool return_partial_success = 517198390; + +} + +// A request message for PublicDelegatedPrefixes.Patch. See the method description for details. +message PatchPublicDelegatedPrefixeRequest { + // Project ID for this request. + string project = 227560217 [(google.api.field_behavior) = REQUIRED]; + + // Name of the PublicDelegatedPrefix resource to patch. + string public_delegated_prefix = 204238440 [(google.api.field_behavior) = REQUIRED]; + + // The body resource for this request + PublicDelegatedPrefix public_delegated_prefix_resource = 47594501 [(google.api.field_behavior) = REQUIRED]; + + // Name of the region for this request. + string region = 138946292 [(google.api.field_behavior) = REQUIRED]; + + // An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. + // + // For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + optional string request_id = 37109963; + +} + // A request message for RegionAutoscalers.Delete. See the method description for details. message DeleteRegionAutoscalerRequest { // Name of the autoscaler to delete. @@ -19772,7 +21436,7 @@ message ListRegionAutoscalersRequest { // Name of the region scoping this request. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -19921,7 +21585,7 @@ message ListRegionBackendServicesRequest { // Name of the region scoping this request. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -20002,7 +21666,7 @@ message AggregatedListRegionCommitmentsRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -20070,7 +21734,7 @@ message ListRegionCommitmentsRequest { // Name of the region for this request. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -20118,7 +21782,7 @@ message ListRegionDiskTypesRequest { // The name of the region for this request. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -20236,7 +21900,7 @@ message InsertRegionDiskRequest { // The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). optional string request_id = 37109963; - // Optional. Source image to restore onto a disk. + // Source image to restore onto a disk. This field is optional. optional string source_image = 50443319; } @@ -20271,7 +21935,7 @@ message ListRegionDisksRequest { // Name of the region for this request. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -20460,7 +22124,7 @@ message ListRegionHealthCheckServicesRequest { // Name of the region scoping this request. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -20571,7 +22235,7 @@ message ListRegionHealthChecksRequest { // Name of the region scoping this request. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -20806,7 +22470,7 @@ message ListRegionInstanceGroupManagersRequest { // Name of the region scoping this request. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -20844,7 +22508,7 @@ message ListErrorsRegionInstanceGroupManagersRequest { // Name of the region scoping this request. This should conform to RFC1035. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -20882,7 +22546,7 @@ message ListManagedInstancesRegionInstanceGroupManagersRequest { // Name of the region scoping this request. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -20920,7 +22584,7 @@ message ListPerInstanceConfigsRegionInstanceGroupManagersRequest { // Name of the region scoping this request, should conform to RFC1035. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -21129,7 +22793,7 @@ message ListRegionInstanceGroupsRequest { // Name of the region scoping this request. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -21170,25 +22834,45 @@ message ListInstancesRegionInstanceGroupsRequest { // The body resource for this request RegionInstanceGroupsListInstancesRequest region_instance_groups_list_instances_request_resource = 48239828 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } -// A request message for RegionInstanceGroups.SetNamedPorts. See the method description for details. -message SetNamedPortsRegionInstanceGroupRequest { - // The name of the regional instance group where the named ports are updated. - string instance_group = 81095253 [(google.api.field_behavior) = REQUIRED]; +// A request message for RegionInstanceGroups.SetNamedPorts. See the method description for details. +message SetNamedPortsRegionInstanceGroupRequest { + // The name of the regional instance group where the named ports are updated. + string instance_group = 81095253 [(google.api.field_behavior) = REQUIRED]; + + // Project ID for this request. + string project = 227560217 [(google.api.field_behavior) = REQUIRED]; + + // Name of the region scoping this request. + string region = 138946292 [(google.api.field_behavior) = REQUIRED]; + + // The body resource for this request + RegionInstanceGroupsSetNamedPortsRequest region_instance_groups_set_named_ports_request_resource = 1574938 [(google.api.field_behavior) = REQUIRED]; + + // An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. + // + // For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + optional string request_id = 37109963; + +} + +// A request message for RegionInstances.BulkInsert. See the method description for details. +message BulkInsertRegionInstanceRequest { + // The body resource for this request + BulkInsertInstanceResource bulk_insert_instance_resource_resource = 41427278 [(google.api.field_behavior) = REQUIRED]; // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Name of the region scoping this request. + // The name of the region for this request. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // The body resource for this request - RegionInstanceGroupsSetNamedPortsRequest region_instance_groups_set_named_ports_request_resource = 1574938 [(google.api.field_behavior) = REQUIRED]; - // An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. // // For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. @@ -21281,7 +22965,7 @@ message ListRegionNetworkEndpointGroupsRequest { // The name of the region where the network endpoint group is located. It should comply with RFC1035. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -21369,7 +23053,7 @@ message ListRegionNotificationEndpointsRequest { // Name of the region scoping this request. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -21434,7 +23118,7 @@ message ListRegionOperationsRequest { // Name of the region for this request. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -21535,7 +23219,7 @@ message ListRegionSslCertificatesRequest { // Name of the region scoping this request. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -21623,7 +23307,7 @@ message ListRegionTargetHttpProxiesRequest { // Name of the region scoping this request. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -21734,7 +23418,7 @@ message ListRegionTargetHttpsProxiesRequest { // Name of the region scoping this request. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -21860,7 +23544,7 @@ message ListRegionUrlMapsRequest { // Name of the region scoping this request. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -21956,7 +23640,7 @@ message ListRegionsRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -21991,7 +23675,7 @@ message AggregatedListReservationsRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -22092,7 +23776,7 @@ message ListReservationsRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; // Name of the zone for this request. @@ -22185,7 +23869,7 @@ message AggregatedListResourcePoliciesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -22289,7 +23973,7 @@ message ListResourcePoliciesRequest { // Name of the region for this request. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -22356,7 +24040,7 @@ message AggregatedListRoutersRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -22424,7 +24108,7 @@ message GetNatMappingInfoRoutersRequest { // Name of the region for this request. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; // Name of the Router resource to query for Nat Mapping information of VM endpoints. @@ -22495,7 +24179,7 @@ message ListRoutersRequest { // Name of the region for this request. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -22633,7 +24317,7 @@ message ListRoutesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -22735,7 +24419,7 @@ message ListSecurityPoliciesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -22767,7 +24451,7 @@ message ListPreconfiguredExpressionSetsSecurityPoliciesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -22888,7 +24572,7 @@ message ListSnapshotsRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -22962,7 +24646,7 @@ message AggregatedListSslCertificatesRequest { // Name of the project scoping this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -23038,7 +24722,7 @@ message ListSslCertificatesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -23114,7 +24798,7 @@ message ListSslPoliciesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -23146,7 +24830,7 @@ message ListAvailableFeaturesSslPoliciesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -23201,7 +24885,7 @@ message AggregatedListSubnetworksRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -23328,7 +25012,7 @@ message ListSubnetworksRequest { // Name of the region scoping this request. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -23360,7 +25044,7 @@ message ListUsableSubnetworksRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -23517,7 +25201,7 @@ message ListTargetGrpcProxiesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -23572,7 +25256,7 @@ message AggregatedListTargetHttpProxiesRequest { // Name of the project scoping this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -23648,7 +25332,7 @@ message ListTargetHttpProxiesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -23723,7 +25407,7 @@ message AggregatedListTargetHttpsProxiesRequest { // Name of the project scoping this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -23799,11 +25483,31 @@ message ListTargetHttpsProxiesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } +// A request message for TargetHttpsProxies.Patch. See the method description for details. +message PatchTargetHttpsProxyRequest { + // Project ID for this request. + string project = 227560217 [(google.api.field_behavior) = REQUIRED]; + + // An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. + // + // For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. + // + // The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + optional string request_id = 37109963; + + // Name of the TargetHttpsProxy resource to patch. + string target_https_proxy = 52336748 [(google.api.field_behavior) = REQUIRED]; + + // The body resource for this request + TargetHttpsProxy target_https_proxy_resource = 433657473 [(google.api.field_behavior) = REQUIRED]; + +} + // A request message for TargetHttpsProxies.SetQuicOverride. See the method description for details. message SetQuicOverrideTargetHttpsProxyRequest { // Project ID for this request. @@ -23914,7 +25618,7 @@ message AggregatedListTargetInstancesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -23999,7 +25703,7 @@ message ListTargetInstancesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; // Name of the zone scoping this request. @@ -24083,7 +25787,7 @@ message AggregatedListTargetPoolsRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -24187,7 +25891,7 @@ message ListTargetPoolsRequest { // Name of the region scoping this request. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -24335,7 +26039,7 @@ message ListTargetSslProxiesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -24491,7 +26195,7 @@ message ListTargetTcpProxiesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -24566,7 +26270,7 @@ message AggregatedListTargetVpnGatewaysRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -24654,7 +26358,7 @@ message ListTargetVpnGatewaysRequest { // Name of the region for this request. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -24689,7 +26393,7 @@ message AggregatedListUrlMapsRequest { // Name of the project scoping this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -24785,7 +26489,7 @@ message ListUrlMapsRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -24873,7 +26577,7 @@ message AggregatedListVpnGatewaysRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -24974,7 +26678,7 @@ message ListVpnGatewaysRequest { // Name of the region for this request. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -25048,7 +26752,7 @@ message AggregatedListVpnTunnelsRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -25136,7 +26840,7 @@ message ListVpnTunnelsRequest { // Name of the region for this request. string region = 138946292 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -25198,7 +26902,7 @@ message ListZoneOperationsRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; // Name of the zone for request. @@ -25256,7 +26960,7 @@ message ListZonesRequest { // Project ID for this request. string project = 227560217 [(google.api.field_behavior) = REQUIRED]; - // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today. + // Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. optional bool return_partial_success = 517198390; } @@ -25590,7 +27294,7 @@ service BackendServices { option (google.api.method_signature) = "project,backend_service,backend_service_resource"; } - // Sets the security policy for the specified backend service. + // Sets the Google Cloud Armor security policy for the specified backend service. For more information, see Google Cloud Armor Overview rpc SetSecurityPolicy(SetSecurityPolicyBackendServiceRequest) returns (Operation) { option (google.api.http) = { post: "/compute/v1/projects/{project}/global/backendServices/{backend_service}/setSecurityPolicy" @@ -25831,6 +27535,168 @@ service ExternalVpnGateways { } +// The FirewallPolicies API. +service FirewallPolicies { + option (google.api.default_host) = + "compute.googleapis.com"; + + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/compute," + "https://www.googleapis.com/auth/cloud-platform"; + + // Inserts an association for the specified firewall policy. + rpc AddAssociation(AddAssociationFirewallPolicyRequest) returns (Operation) { + option (google.api.http) = { + post: "/compute/v1/locations/global/firewallPolicies/{firewall_policy}/addAssociation" + body: "firewall_policy_association_resource" + }; + option (google.api.method_signature) = "firewall_policy,firewall_policy_association_resource"; + } + + // Inserts a rule into a firewall policy. + rpc AddRule(AddRuleFirewallPolicyRequest) returns (Operation) { + option (google.api.http) = { + post: "/compute/v1/locations/global/firewallPolicies/{firewall_policy}/addRule" + body: "firewall_policy_rule_resource" + }; + option (google.api.method_signature) = "firewall_policy,firewall_policy_rule_resource"; + } + + // Copies rules to the specified firewall policy. + rpc CloneRules(CloneRulesFirewallPolicyRequest) returns (Operation) { + option (google.api.http) = { + post: "/compute/v1/locations/global/firewallPolicies/{firewall_policy}/cloneRules" + }; + option (google.api.method_signature) = "firewall_policy"; + } + + // Deletes the specified policy. + rpc Delete(DeleteFirewallPolicyRequest) returns (Operation) { + option (google.api.http) = { + delete: "/compute/v1/locations/global/firewallPolicies/{firewall_policy}" + }; + option (google.api.method_signature) = "firewall_policy"; + } + + // Returns the specified firewall policy. + rpc Get(GetFirewallPolicyRequest) returns (FirewallPolicy) { + option (google.api.http) = { + get: "/compute/v1/locations/global/firewallPolicies/{firewall_policy}" + }; + option (google.api.method_signature) = "firewall_policy"; + } + + // Gets an association with the specified name. + rpc GetAssociation(GetAssociationFirewallPolicyRequest) returns (FirewallPolicyAssociation) { + option (google.api.http) = { + get: "/compute/v1/locations/global/firewallPolicies/{firewall_policy}/getAssociation" + }; + option (google.api.method_signature) = "firewall_policy"; + } + + // Gets the access control policy for a resource. May be empty if no such policy or resource exists. + rpc GetIamPolicy(GetIamPolicyFirewallPolicyRequest) returns (Policy) { + option (google.api.http) = { + get: "/compute/v1/locations/global/firewallPolicies/{resource}/getIamPolicy" + }; + option (google.api.method_signature) = "resource"; + } + + // Gets a rule of the specified priority. + rpc GetRule(GetRuleFirewallPolicyRequest) returns (FirewallPolicyRule) { + option (google.api.http) = { + get: "/compute/v1/locations/global/firewallPolicies/{firewall_policy}/getRule" + }; + option (google.api.method_signature) = "firewall_policy"; + } + + // Creates a new policy in the specified project using the data included in the request. + rpc Insert(InsertFirewallPolicyRequest) returns (Operation) { + option (google.api.http) = { + post: "/compute/v1/locations/global/firewallPolicies" + body: "firewall_policy_resource" + }; + option (google.api.method_signature) = "firewall_policy_resource"; + } + + // Lists all the policies that have been configured for the specified project. + rpc List(ListFirewallPoliciesRequest) returns (FirewallPolicyList) { + option (google.api.http) = { + get: "/compute/v1/locations/global/firewallPolicies" + }; + option (google.api.method_signature) = ""; + } + + // Lists associations of a specified target, i.e., organization or folder. + rpc ListAssociations(ListAssociationsFirewallPolicyRequest) returns (FirewallPoliciesListAssociationsResponse) { + option (google.api.http) = { + get: "/compute/v1/locations/global/firewallPolicies/listAssociations" + }; + option (google.api.method_signature) = ""; + } + + // Moves the specified firewall policy. + rpc Move(MoveFirewallPolicyRequest) returns (Operation) { + option (google.api.http) = { + post: "/compute/v1/locations/global/firewallPolicies/{firewall_policy}/move" + }; + option (google.api.method_signature) = "firewall_policy"; + } + + // Patches the specified policy with the data included in the request. + rpc Patch(PatchFirewallPolicyRequest) returns (Operation) { + option (google.api.http) = { + patch: "/compute/v1/locations/global/firewallPolicies/{firewall_policy}" + body: "firewall_policy_resource" + }; + option (google.api.method_signature) = "firewall_policy,firewall_policy_resource"; + } + + // Patches a rule of the specified priority. + rpc PatchRule(PatchRuleFirewallPolicyRequest) returns (Operation) { + option (google.api.http) = { + post: "/compute/v1/locations/global/firewallPolicies/{firewall_policy}/patchRule" + body: "firewall_policy_rule_resource" + }; + option (google.api.method_signature) = "firewall_policy,firewall_policy_rule_resource"; + } + + // Removes an association for the specified firewall policy. + rpc RemoveAssociation(RemoveAssociationFirewallPolicyRequest) returns (Operation) { + option (google.api.http) = { + post: "/compute/v1/locations/global/firewallPolicies/{firewall_policy}/removeAssociation" + }; + option (google.api.method_signature) = "firewall_policy"; + } + + // Deletes a rule of the specified priority. + rpc RemoveRule(RemoveRuleFirewallPolicyRequest) returns (Operation) { + option (google.api.http) = { + post: "/compute/v1/locations/global/firewallPolicies/{firewall_policy}/removeRule" + }; + option (google.api.method_signature) = "firewall_policy"; + } + + // Sets the access control policy on the specified resource. Replaces any existing policy. + rpc SetIamPolicy(SetIamPolicyFirewallPolicyRequest) returns (Policy) { + option (google.api.http) = { + post: "/compute/v1/locations/global/firewallPolicies/{resource}/setIamPolicy" + body: "global_organization_set_policy_request_resource" + }; + option (google.api.method_signature) = "resource,global_organization_set_policy_request_resource"; + } + + // Returns permissions that a caller has on the specified resource. + rpc TestIamPermissions(TestIamPermissionsFirewallPolicyRequest) returns (TestPermissionsResponse) { + option (google.api.http) = { + post: "/compute/v1/locations/global/firewallPolicies/{resource}/testIamPermissions" + body: "test_permissions_request_resource" + }; + option (google.api.method_signature) = "resource,test_permissions_request_resource"; + } + +} + // The Firewalls API. service Firewalls { option (google.api.default_host) = @@ -25952,6 +27818,15 @@ service ForwardingRules { option (google.api.method_signature) = "project,region,forwarding_rule,forwarding_rule_resource"; } + // Sets the labels on the specified resource. To learn more about labels, read the Labeling Resources documentation. + rpc SetLabels(SetLabelsForwardingRuleRequest) returns (Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/forwardingRules/{resource}/setLabels" + body: "region_set_labels_request_resource" + }; + option (google.api.method_signature) = "project,region,resource,region_set_labels_request_resource"; + } + // Changes target URL for forwarding rule. The new target should be of the same type as the old target. rpc SetTarget(SetTargetForwardingRuleRequest) returns (Operation) { option (google.api.http) = { @@ -26058,6 +27933,15 @@ service GlobalForwardingRules { option (google.api.method_signature) = "project,forwarding_rule,forwarding_rule_resource"; } + // Sets the labels on the specified resource. To learn more about labels, read the Labeling Resources documentation. + rpc SetLabels(SetLabelsGlobalForwardingRuleRequest) returns (Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/global/forwardingRules/{resource}/setLabels" + body: "global_set_labels_request_resource" + }; + option (google.api.method_signature) = "project,resource,global_set_labels_request_resource"; + } + // Changes target URL for the GlobalForwardingRule resource. The new target should be of the same type as the old target. rpc SetTarget(SetTargetGlobalForwardingRuleRequest) returns (Operation) { option (google.api.http) = { @@ -26229,6 +28113,59 @@ service GlobalOrganizationOperations { } +// The GlobalPublicDelegatedPrefixes API. +service GlobalPublicDelegatedPrefixes { + option (google.api.default_host) = + "compute.googleapis.com"; + + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/compute," + "https://www.googleapis.com/auth/cloud-platform"; + + // Deletes the specified global PublicDelegatedPrefix. + rpc Delete(DeleteGlobalPublicDelegatedPrefixeRequest) returns (Operation) { + option (google.api.http) = { + delete: "/compute/v1/projects/{project}/global/publicDelegatedPrefixes/{public_delegated_prefix}" + }; + option (google.api.method_signature) = "project,public_delegated_prefix"; + } + + // Returns the specified global PublicDelegatedPrefix resource. + rpc Get(GetGlobalPublicDelegatedPrefixeRequest) returns (PublicDelegatedPrefix) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/global/publicDelegatedPrefixes/{public_delegated_prefix}" + }; + option (google.api.method_signature) = "project,public_delegated_prefix"; + } + + // Creates a global PublicDelegatedPrefix in the specified project using the parameters that are included in the request. + rpc Insert(InsertGlobalPublicDelegatedPrefixeRequest) returns (Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/global/publicDelegatedPrefixes" + body: "public_delegated_prefix_resource" + }; + option (google.api.method_signature) = "project,public_delegated_prefix_resource"; + } + + // Lists the global PublicDelegatedPrefixes for a project. + rpc List(ListGlobalPublicDelegatedPrefixesRequest) returns (PublicDelegatedPrefixList) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/global/publicDelegatedPrefixes" + }; + option (google.api.method_signature) = "project"; + } + + // 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. + rpc Patch(PatchGlobalPublicDelegatedPrefixeRequest) returns (Operation) { + option (google.api.http) = { + patch: "/compute/v1/projects/{project}/global/publicDelegatedPrefixes/{public_delegated_prefix}" + body: "public_delegated_prefix_resource" + }; + option (google.api.method_signature) = "project,public_delegated_prefix,public_delegated_prefix_resource"; + } + +} + // The HealthChecks API. service HealthChecks { option (google.api.default_host) = @@ -26553,7 +28490,7 @@ service InstanceGroupManagers { option (google.api.method_signature) = "project,zone,instance_group_manager,instance_group_managers_patch_per_instance_configs_req_resource"; } - // Flags the specified instances in the managed instance group to be immediately recreated. The instances are deleted and recreated using the current instance template for the managed instance group. 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 the recreating action with the listmanagedinstances method. + // 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. // @@ -26819,7 +28756,16 @@ service Instances { option (google.api.method_signature) = "project,zone,instance,attached_disk_resource"; } - // Deletes the specified Instance resource. For more information, see Stopping or Deleting an Instance. + // Creates multiple instances. Count specifies the number of instances to create. + rpc BulkInsert(BulkInsertInstanceRequest) returns (Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/zones/{zone}/instances/bulkInsert" + body: "bulk_insert_instance_resource_resource" + }; + option (google.api.method_signature) = "project,zone,bulk_insert_instance_resource_resource"; + } + + // Deletes the specified Instance resource. For more information, see Deleting an instance. rpc Delete(DeleteInstanceRequest) returns (Operation) { option (google.api.http) = { delete: "/compute/v1/projects/{project}/zones/{zone}/instances/{instance}" @@ -26851,6 +28797,14 @@ service Instances { option (google.api.method_signature) = "project,zone,instance"; } + // Returns effective firewalls applied to an interface of the instance. + rpc GetEffectiveFirewalls(GetEffectiveFirewallsInstanceRequest) returns (InstancesGetEffectiveFirewallsResponse) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/zones/{zone}/instances/{instance}/getEffectiveFirewalls" + }; + option (google.api.method_signature) = "project,zone,instance,network_interface"; + } + // Returns the specified guest attributes entry. rpc GetGuestAttributes(GetGuestAttributesInstanceRequest) returns (GuestAttributes) { option (google.api.http) = { @@ -27108,7 +29062,7 @@ service Instances { option (google.api.method_signature) = "project,zone,instance,display_device_resource"; } - // Updates an instance's network interface. This method follows PATCH semantics. + // 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. rpc UpdateNetworkInterface(UpdateNetworkInterfaceInstanceRequest) returns (Operation) { option (google.api.http) = { patch: "/compute/v1/projects/{project}/zones/{zone}/instances/{instance}/updateNetworkInterface" @@ -27535,6 +29489,14 @@ service Networks { option (google.api.method_signature) = "project,network"; } + // Returns the effective firewalls on a given network. + rpc GetEffectiveFirewalls(GetEffectiveFirewallsNetworkRequest) returns (NetworksGetEffectiveFirewallsResponse) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/global/networks/{network}/getEffectiveFirewalls" + }; + option (google.api.method_signature) = "project,network"; + } + // Creates a network in the specified project using the data included in the request. rpc Insert(InsertNetworkRequest) returns (Operation) { option (google.api.http) = { @@ -28026,6 +29988,120 @@ service Projects { } +// The PublicAdvertisedPrefixes API. +service PublicAdvertisedPrefixes { + option (google.api.default_host) = + "compute.googleapis.com"; + + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/compute," + "https://www.googleapis.com/auth/cloud-platform"; + + // Deletes the specified PublicAdvertisedPrefix + rpc Delete(DeletePublicAdvertisedPrefixeRequest) returns (Operation) { + option (google.api.http) = { + delete: "/compute/v1/projects/{project}/global/publicAdvertisedPrefixes/{public_advertised_prefix}" + }; + option (google.api.method_signature) = "project,public_advertised_prefix"; + } + + // Returns the specified PublicAdvertisedPrefix resource. + rpc Get(GetPublicAdvertisedPrefixeRequest) returns (PublicAdvertisedPrefix) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/global/publicAdvertisedPrefixes/{public_advertised_prefix}" + }; + 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. + rpc Insert(InsertPublicAdvertisedPrefixeRequest) returns (Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/global/publicAdvertisedPrefixes" + body: "public_advertised_prefix_resource" + }; + option (google.api.method_signature) = "project,public_advertised_prefix_resource"; + } + + // Lists the PublicAdvertisedPrefixes for a project. + rpc List(ListPublicAdvertisedPrefixesRequest) returns (PublicAdvertisedPrefixList) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/global/publicAdvertisedPrefixes" + }; + option (google.api.method_signature) = "project"; + } + + // 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. + rpc Patch(PatchPublicAdvertisedPrefixeRequest) returns (Operation) { + option (google.api.http) = { + patch: "/compute/v1/projects/{project}/global/publicAdvertisedPrefixes/{public_advertised_prefix}" + body: "public_advertised_prefix_resource" + }; + option (google.api.method_signature) = "project,public_advertised_prefix,public_advertised_prefix_resource"; + } + +} + +// The PublicDelegatedPrefixes API. +service PublicDelegatedPrefixes { + option (google.api.default_host) = + "compute.googleapis.com"; + + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/compute," + "https://www.googleapis.com/auth/cloud-platform"; + + // Lists all PublicDelegatedPrefix resources owned by the specific project across all scopes. + rpc AggregatedList(AggregatedListPublicDelegatedPrefixesRequest) returns (PublicDelegatedPrefixAggregatedList) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/aggregated/publicDelegatedPrefixes" + }; + option (google.api.method_signature) = "project"; + } + + // Deletes the specified PublicDelegatedPrefix in the given region. + rpc Delete(DeletePublicDelegatedPrefixeRequest) returns (Operation) { + option (google.api.http) = { + delete: "/compute/v1/projects/{project}/regions/{region}/publicDelegatedPrefixes/{public_delegated_prefix}" + }; + option (google.api.method_signature) = "project,region,public_delegated_prefix"; + } + + // Returns the specified PublicDelegatedPrefix resource in the given region. + rpc Get(GetPublicDelegatedPrefixeRequest) returns (PublicDelegatedPrefix) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/regions/{region}/publicDelegatedPrefixes/{public_delegated_prefix}" + }; + option (google.api.method_signature) = "project,region,public_delegated_prefix"; + } + + // Creates a PublicDelegatedPrefix in the specified project in the given region using the parameters that are included in the request. + rpc Insert(InsertPublicDelegatedPrefixeRequest) returns (Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/publicDelegatedPrefixes" + body: "public_delegated_prefix_resource" + }; + option (google.api.method_signature) = "project,region,public_delegated_prefix_resource"; + } + + // Lists the PublicDelegatedPrefixes for a project in the given region. + rpc List(ListPublicDelegatedPrefixesRequest) returns (PublicDelegatedPrefixList) { + option (google.api.http) = { + get: "/compute/v1/projects/{project}/regions/{region}/publicDelegatedPrefixes" + }; + option (google.api.method_signature) = "project,region"; + } + + // 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. + rpc Patch(PatchPublicDelegatedPrefixeRequest) returns (Operation) { + option (google.api.http) = { + patch: "/compute/v1/projects/{project}/regions/{region}/publicDelegatedPrefixes/{public_delegated_prefix}" + body: "public_delegated_prefix_resource" + }; + option (google.api.method_signature) = "project,region,public_delegated_prefix,public_delegated_prefix_resource"; + } + +} + // The RegionAutoscalers API. service RegionAutoscalers { option (google.api.default_host) = @@ -28600,7 +30676,7 @@ service RegionInstanceGroupManagers { option (google.api.method_signature) = "project,region,instance_group_manager,region_instance_group_manager_patch_instance_config_req_resource"; } - // Flags the specified instances in the managed instance group to be immediately recreated. The instances are deleted and recreated using the current instance template for the managed instance group. 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 the recreating action with the listmanagedinstances method. + // 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. // @@ -28699,6 +30775,26 @@ service RegionInstanceGroups { } +// The RegionInstances API. +service RegionInstances { + option (google.api.default_host) = + "compute.googleapis.com"; + + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/compute," + "https://www.googleapis.com/auth/cloud-platform"; + + // Creates multiple instances in a given region. Count specifies the number of instances to create. + rpc BulkInsert(BulkInsertRegionInstanceRequest) returns (Operation) { + option (google.api.http) = { + post: "/compute/v1/projects/{project}/regions/{region}/instances/bulkInsert" + body: "bulk_insert_instance_resource_resource" + }; + option (google.api.method_signature) = "project,region,bulk_insert_instance_resource_resource"; + } + +} + // The RegionNetworkEndpointGroups API. service RegionNetworkEndpointGroups { option (google.api.default_host) = @@ -29962,6 +32058,15 @@ service TargetHttpsProxies { option (google.api.method_signature) = "project"; } + // 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. (== suppress_warning http-rest-shadowed ==) + rpc Patch(PatchTargetHttpsProxyRequest) returns (Operation) { + option (google.api.http) = { + patch: "/compute/v1/projects/{project}/global/targetHttpsProxies/{target_https_proxy}" + body: "target_https_proxy_resource" + }; + option (google.api.method_signature) = "project,target_https_proxy,target_https_proxy_resource"; + } + // Sets the QUIC override policy for TargetHttpsProxy. rpc SetQuicOverride(SetQuicOverrideTargetHttpsProxyRequest) returns (Operation) { option (google.api.http) = { diff --git a/google/cloud/compute/v1/compute.v1.json b/google/cloud/compute/v1/compute.v1.json index b278418..c127548 100644 --- a/google/cloud/compute/v1/compute.v1.json +++ b/google/cloud/compute/v1/compute.v1.json @@ -1,11 +1,11 @@ { "kind": "discovery#restDescription", - "etag": "\"-2NioU2H8y8siEzrBOV_qzRI6kQ/m_4nvWuSVQoEemlfuQ_d59dNy8Q\"", + "etag": "\"uWj2hSb4GVjzdDlAnRd2gbM1ZQ8/PpBdeGiizCXCXx-f24-1pqppw9k\"", "discoveryVersion": "v1", "id": "compute:v1", "name": "compute", "version": "v1", - "revision": "20201122", + "revision": "20210415", "title": "Compute Engine API", "description": "Creates and runs virtual machines on Google Cloud Platform.", "ownerDomain": "google.com", @@ -70,7 +70,7 @@ "oauth2": { "scopes": { "https://www.googleapis.com/auth/cloud-platform": { - "description": "View and manage your data across Google Cloud Platform services" + "description": "See, edit, configure, and delete your Google Cloud Platform data" }, "https://www.googleapis.com/auth/compute": { "description": "View and manage your Google Compute Engine resources" @@ -625,16 +625,18 @@ }, "prefixLength": { "type": "integer", - "description": "The prefix length if the resource reprensents an IP range.", + "description": "The prefix length if the resource represents an IP range.", "format": "int32" }, "purpose": { "type": "string", - "description": "The purpose of this resource, which can be one of the following values: \n- `GCE_ENDPOINT` for addresses that are used by VM instances, alias IP ranges, internal load balancers, and similar resources. \n- `DNS_RESOLVER` for a DNS resolver address in a subnetwork \n- `VPC_PEERING` for addresses that are reserved for VPC peer networks. \n- `NAT_AUTO` for addresses that are external IP addresses automatically reserved for Cloud NAT. \n- `IPSEC_INTERCONNECT` for addresses created from a private IP range that are reserved for a VLAN attachment in an IPsec encrypted Interconnect configuration. These addresses are regional resources.", + "description": "The purpose of this resource, which can be one of the following values: \n- `GCE_ENDPOINT` for addresses that are used by VM instances, alias IP ranges, internal load balancers, and similar resources. \n- `DNS_RESOLVER` for a DNS resolver address in a subnetwork \n- `VPC_PEERING` for addresses that are reserved for VPC peer networks. \n- `NAT_AUTO` for addresses that are external IP addresses automatically reserved for Cloud NAT. \n- `IPSEC_INTERCONNECT` for addresses created from a private IP range that are reserved for a VLAN attachment in an IPsec-encrypted Cloud Interconnect configuration. These addresses are regional resources.", "enum": [ "DNS_RESOLVER", "GCE_ENDPOINT", + "IPSEC_INTERCONNECT", "NAT_AUTO", + "PRIVATE_SERVICE_CONNECT", "SHARED_LOADBALANCER_VIP", "VPC_PEERING" ], @@ -643,12 +645,14 @@ "", "", "", + "", + "", "" ] }, "region": { "type": "string", - "description": "[Output Only] The URL of the region where the regional address resides. This field is not applicable to global addresses. You must specify this field as part of the HTTP request URL." + "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." }, "selfLink": { "type": "string", @@ -1018,6 +1022,22 @@ } } }, + "AdvancedMachineFeatures": { + "id": "AdvancedMachineFeatures", + "type": "object", + "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).", + "properties": { + "enableNestedVirtualization": { + "type": "boolean", + "description": "Whether to enable nested virtualization or not (default is false)." + }, + "threadsPerCore": { + "type": "integer", + "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.", + "format": "int32" + } + } + }, "AliasIpRange": { "id": "AliasIpRange", "type": "object", @@ -1075,6 +1095,10 @@ "$ref": "AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk" } }, + "locationHint": { + "type": "string", + "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." + }, "machineType": { "type": "string", "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." @@ -1249,6 +1273,11 @@ "" ] }, + "provisionedIops": { + "type": "string", + "description": "Indicates how many IOPS must be provisioned for the disk.", + "format": "int64" + }, "resourcePolicies": { "type": "array", "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.", @@ -1365,7 +1394,7 @@ "properties": { "autoscalingPolicy": { "$ref": "AutoscalingPolicy", - "description": "The configuration parameters for the autoscaling algorithm. You can define one or more of the policies for an autoscaler: cpuUtilization, customMetricUtilizations, and loadBalancingUtilization.\n\nIf none of these are specified, the default will be to autoscale based on cpuUtilization to 0.6 or 60%." + "description": "The configuration parameters for the autoscaling algorithm. You can define one or more signals for an autoscaler: cpuUtilization, customMetricUtilizations, and loadBalancingUtilization.\n\nIf none of these are specified, the default will be to autoscale based on cpuUtilization to 0.6 or 60%." }, "creationTimestamp": { "type": "string", @@ -1404,6 +1433,13 @@ "type": "string", "description": "[Output Only] URL of the region where the instance group resides (for autoscalers living in regional scope)." }, + "scalingScheduleStatus": { + "type": "object", + "description": "[Output Only] Status information of existing scaling schedules.", + "additionalProperties": { + "$ref": "ScalingScheduleStatus" + } + }, "selfLink": { "type": "string", "description": "[Output Only] Server-defined URL for the resource." @@ -1707,6 +1743,8 @@ "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" @@ -1729,6 +1767,8 @@ "", "", "", + "", + "", "" ] } @@ -1885,6 +1925,13 @@ }, "scaleInControl": { "$ref": "AutoscalingPolicyScaleInControl" + }, + "scalingSchedules": { + "type": "object", + "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.", + "additionalProperties": { + "$ref": "AutoscalingPolicyScalingSchedule" + } } } }, @@ -1893,6 +1940,18 @@ "type": "object", "description": "CPU utilization policy.", "properties": { + "predictiveMethod": { + "type": "string", + "description": "Indicates whether predictive autoscaling based on CPU metric is enabled. Valid values are:\n\n* 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.", + "enum": [ + "NONE", + "OPTIMIZE_AVAILABILITY" + ], + "enumDescriptions": [ + "", + "" + ] + }, "utilizationTarget": { "type": "number", "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.\n\nIf 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.\n\nIf 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.", @@ -1967,6 +2026,39 @@ } } }, + "AutoscalingPolicyScalingSchedule": { + "id": "AutoscalingPolicyScalingSchedule", + "type": "object", + "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.", + "properties": { + "description": { + "type": "string", + "description": "A description of a scaling schedule." + }, + "disabled": { + "type": "boolean", + "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." + }, + "durationSec": { + "type": "integer", + "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.", + "format": "int32" + }, + "minRequiredReplicas": { + "type": "integer", + "description": "The minimum number of VM instances that the autoscaler will recommend in time intervals starting according to schedule. This field is required.", + "format": "int32" + }, + "schedule": { + "type": "string", + "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." + }, + "timeZone": { + "type": "string", + "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: http://en.wikipedia.org/wiki/Tz_database. This field is assigned a default value of ?UTC? if left empty." + } + } + }, "Backend": { "id": "Backend", "type": "object", @@ -1974,7 +2066,7 @@ "properties": { "balancingMode": { "type": "string", - "description": "Specifies the balancing mode for the backend.\n\nWhen choosing a balancing mode, you need to consider the loadBalancingScheme, and protocol for the backend service, as well as the type of backend (instance group or NEG).\n\n \n- If the load balancing mode is CONNECTION, then the load is spread based on how many concurrent connections the backend can handle.\nYou can use the CONNECTION balancing mode if the protocol for the backend service is SSL, TCP, or UDP.\n\nIf the loadBalancingScheme for the backend service is EXTERNAL (SSL Proxy and TCP Proxy load balancers), you must also specify exactly one of the following parameters: maxConnections (except for regional managed instance groups), maxConnectionsPerInstance, or maxConnectionsPerEndpoint.\n\nIf the loadBalancingScheme for the backend service is INTERNAL (internal TCP/UDP Load Balancers) or EXTERNAL (Network Load Balancing), you cannot specify any additional parameters.\n \n- If the load balancing mode is RATE, the load is spread based on the rate of HTTP requests per second (RPS).\nYou can use the RATE balancing mode if the protocol for the backend service is HTTP, HTTP2, or HTTPS. You must specify exactly one of the following parameters: maxRate (except for regional managed instance groups), maxRatePerInstance, or maxRatePerEndpoint.\n \n- If the load balancing mode is UTILIZATION, the load is spread based on the backend utilization of instances in an instance group.\nYou can use the UTILIZATION balancing mode if the loadBalancingScheme of the backend service is EXTERNAL (except Network Load Balancing), INTERNAL_SELF_MANAGED, or INTERNAL_MANAGED and the backends are instance groups. There are no restrictions on the backend service protocol.", + "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.", "enum": [ "CONNECTION", "RATE", @@ -1988,7 +2080,7 @@ }, "capacityScaler": { "type": "number", - "description": "A multiplier applied to the group's maximum servicing capacity (based on UTILIZATION, RATE or CONNECTION). Default value is 1, which means the group will serve 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. Valid range is 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.\n\nThis cannot be used for Internal TCP/UDP Load Balancing and Network Load Balancing.", + "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.\n\nNot supported by:\n\n- Internal TCP/UDP Load Balancing - Network Load Balancing", "format": "float" }, "description": { @@ -2005,37 +2097,36 @@ }, "maxConnections": { "type": "integer", - "description": "Defines a target maximum number of simultaneous connections that the backend can handle. Valid for network endpoint group and instance group backends (except for regional managed instance groups). If the backend's balancingMode is UTILIZATION, this is an optional parameter. If the backend's balancingMode is CONNECTION, and backend is attached to a backend service whose loadBalancingScheme is EXTERNAL (except Network Load Balancing), you must specify either this parameter, maxConnectionsPerInstance, or maxConnectionsPerEndpoint.\n\nNot available if the backend's balancingMode is RATE. Cannot be specified for Network Load Balancing or Internal TCP/UDP Load Balancing, even though those load balancers require a balancing mode of CONNECTION.", + "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. Not supported by:\n\n- Internal TCP/UDP Load Balancing - Network Load Balancing", "format": "int32" }, "maxConnectionsPerEndpoint": { "type": "integer", - "description": "Defines a target maximum number of simultaneous connections for an endpoint of a NEG. This is multiplied by the number of endpoints in the NEG to implicitly calculate a maximum number of target maximum simultaneous connections for the NEG. If the backend's balancingMode is CONNECTION, and backend is attached to a backend service whose loadBalancingScheme is EXTERNAL (except Network Load Balancing), you must specify either this parameter, maxConnections, or maxConnectionsPerInstance.\n\nNot available if the backend's balancingMode is RATE. Cannot be specified for Network Load Balancing or Internal TCP/UDP Load Balancing, even though those load balancers require a balancing mode of CONNECTION.", + "description": "Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode.\n\nNot available if the backend's balancingMode is RATE. Not supported by:\n\n- Internal TCP/UDP Load Balancing - Network Load Balancing.", "format": "int32" }, "maxConnectionsPerInstance": { "type": "integer", - "description": "Defines a target maximum number of simultaneous connections for a single VM in a backend instance group. This is multiplied by the number of instances in the instance group to implicitly calculate a target maximum number of simultaneous connections for the whole instance group. If the backend's balancingMode is UTILIZATION, this is an optional parameter. If the backend's balancingMode is CONNECTION, and backend is attached to a backend service whose loadBalancingScheme is EXTERNAL (except Network Load Balancing), you must specify either this parameter, maxConnections, or maxConnectionsPerEndpoint.\n\nNot available if the backend's balancingMode is RATE. Cannot be specified for Network Load Balancing or Internal TCP/UDP Load Balancing, even though those load balancers require a balancing mode of CONNECTION.", + "description": "Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode.\n\nNot available if the backend's balancingMode is RATE. Not supported by:\n\n- Internal TCP/UDP Load Balancing - Network Load Balancing.", "format": "int32" }, "maxRate": { "type": "integer", - "description": "Defines a maximum number of HTTP requests per second (RPS) that the backend can handle. Valid for network endpoint group and instance group backends (except for regional managed instance groups). Must not be defined if the backend is a managed instance group that uses autoscaling based on load balancing.\n\nIf the backend's balancingMode is UTILIZATION, this is an optional parameter. If the backend's balancingMode is RATE, you must specify maxRate, maxRatePerInstance, or maxRatePerEndpoint.\n\nNot available if the backend's balancingMode is CONNECTION.", + "description": "Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode.\n\nNot available if the backend's balancingMode is CONNECTION.", "format": "int32" }, "maxRatePerEndpoint": { "type": "number", - "description": "Defines a maximum target for requests per second (RPS) for an endpoint of a NEG. This is multiplied by the number of endpoints in the NEG to implicitly calculate a target maximum rate for the NEG.\n\nIf the backend's balancingMode is RATE, you must specify either this parameter, maxRate (except for regional managed instance groups), or maxRatePerInstance.\n\nNot available if the backend's balancingMode is CONNECTION.", + "description": "Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode.\n\nNot available if the backend's balancingMode is CONNECTION.", "format": "float" }, "maxRatePerInstance": { "type": "number", - "description": "Defines a maximum target for requests per second (RPS) for a single VM in a backend instance group. This is multiplied by the number of instances in the instance group to implicitly calculate a target maximum rate for the whole instance group.\n\nIf the backend's balancingMode is UTILIZATION, this is an optional parameter. If the backend's balancingMode is RATE, you must specify either this parameter, maxRate (except for regional managed instance groups), or maxRatePerEndpoint.\n\nNot available if the backend's balancingMode is CONNECTION.", + "description": "Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode.\n\nNot available if the backend's balancingMode is CONNECTION.", "format": "float" }, "maxUtilization": { "type": "number", - "description": "Defines the maximum average backend utilization of a backend VM in an instance group. The valid range is [0.0, 1.0]. This is an optional parameter if the backend's balancingMode is UTILIZATION.\n\nThis parameter can be used in conjunction with maxRate, maxRatePerInstance, maxConnections (except for regional managed instance groups), or maxConnectionsPerInstance.", "format": "float" } } @@ -2098,6 +2189,13 @@ "type": "object", "description": "Message containing Cloud CDN configuration for a backend bucket.", "properties": { + "bypassCacheOnRequestHeaders": { + "type": "array", + "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.", + "items": { + "$ref": "BackendBucketCdnPolicyBypassCacheOnRequestHeader" + } + }, "cacheMode": { "type": "string", "description": "Specifies the cache setting for all responses from this backend. The possible values are:\n\nUSE_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.\n\nFORCE_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.\n\nCACHE_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.", @@ -2116,7 +2214,7 @@ }, "clientTtl": { "type": "integer", - "description": "Specifies a separate client (e.g. browser client) TTL, separate from the TTL for Cloud CDN's edge caches. Leaving this empty will use the same cache TTL for both Cloud CDN and the client-facing response. The maximum allowed value is 86400s (1 day).", + "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 86400s (1 day).", "format": "int32" }, "defaultTtl": { @@ -2129,6 +2227,26 @@ "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.", "format": "int32" }, + "negativeCaching": { + "type": "boolean", + "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." + }, + "negativeCachingPolicy": { + "type": "array", + "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.", + "items": { + "$ref": "BackendBucketCdnPolicyNegativeCachingPolicy" + } + }, + "requestCoalescing": { + "type": "boolean", + "description": "If true then Cloud CDN will combine multiple concurrent cache fill requests into a small number of requests to the origin." + }, + "serveWhileStale": { + "type": "integer", + "description": "Serve existing content from the cache (if available) when revalidating content with the origin, or when an error is encountered when refreshing the cache. This setting defines the default \"max-stale\" duration for any cached responses that do not specify a max-stale directive. Stale responses that exceed the TTL configured here will not be served. The default limit (max-stale) is 86400s (1 day), which will allow stale content to be served up to this limit beyond the max-age (or s-max-age) of a cached response. The maximum allowed value is 604800 (1 week). Set this to zero (0) to disable serve-while-stale.", + "format": "int32" + }, "signedUrlCacheMaxAgeSec": { "type": "string", "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.", @@ -2143,6 +2261,34 @@ } } }, + "BackendBucketCdnPolicyBypassCacheOnRequestHeader": { + "id": "BackendBucketCdnPolicyBypassCacheOnRequestHeader", + "type": "object", + "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.", + "properties": { + "headerName": { + "type": "string", + "description": "The header field name to match on when bypassing cache. Values are case-insensitive." + } + } + }, + "BackendBucketCdnPolicyNegativeCachingPolicy": { + "id": "BackendBucketCdnPolicyNegativeCachingPolicy", + "type": "object", + "description": "Specify CDN TTLs for response error codes.", + "properties": { + "code": { + "type": "integer", + "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.", + "format": "int32" + }, + "ttl": { + "type": "integer", + "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.", + "format": "int32" + } + } + }, "BackendBucketList": { "id": "BackendBucketList", "type": "object", @@ -2278,7 +2424,7 @@ }, "cdnPolicy": { "$ref": "BackendServiceCdnPolicy", - "description": "Cloud CDN configuration for this BackendService. Not available for Internal TCP/UDP Load Balancing and Network Load Balancing." + "description": "Cloud CDN configuration for this BackendService. Only available for external HTTP(S) Load Balancing." }, "circuitBreakers": { "$ref": "CircuitBreakers", @@ -2391,6 +2537,10 @@ "$ref": "BackendServiceLogConfig", "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." }, + "maxStreamDuration": { + "$ref": "Duration", + "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.\nIf not specified, there will be no timeout limit, i.e. the maximum duration is infinite.\nThis field is only allowed when the loadBalancingScheme of the backend service is INTERNAL_SELF_MANAGED." + }, "name": { "type": "string", "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.", @@ -2406,7 +2556,7 @@ }, "port": { "type": "integer", - "description": "Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80.\n\nThis cannot be used if the loadBalancingScheme is INTERNAL (Internal TCP/UDP Load Balancing).", + "description": "Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80.\n\nBackend services for Internal TCP/UDP Load Balancing and Network Load Balancing require you omit port.", "format": "int32" }, "portName": { @@ -2453,9 +2603,10 @@ }, "sessionAffinity": { "type": "string", - "description": "Type of session affinity to use. The default is NONE.\n\nWhen the loadBalancingScheme is EXTERNAL: * For Network Load Balancing, the possible values are NONE, CLIENT_IP, CLIENT_IP_PROTO, or CLIENT_IP_PORT_PROTO. * For all other load balancers that use loadBalancingScheme=EXTERNAL, the possible values are NONE, CLIENT_IP, or GENERATED_COOKIE. * You can use GENERATED_COOKIE if the protocol is HTTP, HTTP2, or HTTPS.\n\nWhen the loadBalancingScheme is INTERNAL, possible values are NONE, CLIENT_IP, CLIENT_IP_PROTO, or CLIENT_IP_PORT_PROTO.\n\nWhen the loadBalancingScheme is INTERNAL_SELF_MANAGED, or INTERNAL_MANAGED, possible values are NONE, CLIENT_IP, GENERATED_COOKIE, HEADER_FIELD, or HTTP_COOKIE.\n\nNot 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.", + "description": "Type of session affinity to use. The default is NONE.\n\nWhen the loadBalancingScheme is EXTERNAL: * For Network Load Balancing, the possible values are NONE, CLIENT_IP, CLIENT_IP_PROTO, or CLIENT_IP_PORT_PROTO. * For all other load balancers that use loadBalancingScheme=EXTERNAL, the possible values are NONE, CLIENT_IP, or GENERATED_COOKIE. * You can use GENERATED_COOKIE if the protocol is HTTP, HTTP2, or HTTPS.\n\nWhen the loadBalancingScheme is INTERNAL, possible values are NONE, CLIENT_IP, CLIENT_IP_PROTO, or CLIENT_IP_PORT_PROTO.\n\nWhen the loadBalancingScheme is INTERNAL_SELF_MANAGED, or INTERNAL_MANAGED, possible values are NONE, CLIENT_IP, GENERATED_COOKIE, HEADER_FIELD, or HTTP_COOKIE.\n\nNot 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.", "enum": [ "CLIENT_IP", + "CLIENT_IP_NO_DESTINATION", "CLIENT_IP_PORT_PROTO", "CLIENT_IP_PROTO", "GENERATED_COOKIE", @@ -2470,12 +2621,13 @@ "", "", "", + "", "" ] }, "timeoutSec": { "type": "integer", - "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.", + "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 is 1 - 2,147,483,647 seconds.", "format": "int32" } } @@ -2609,6 +2761,13 @@ "type": "object", "description": "Message containing Cloud CDN configuration for a backend service.", "properties": { + "bypassCacheOnRequestHeaders": { + "type": "array", + "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.", + "items": { + "$ref": "BackendServiceCdnPolicyBypassCacheOnRequestHeader" + } + }, "cacheKeyPolicy": { "$ref": "CacheKeyPolicy", "description": "The CacheKeyPolicy for this CdnPolicy." @@ -2631,7 +2790,7 @@ }, "clientTtl": { "type": "integer", - "description": "Specifies a separate client (e.g. browser client) TTL, separate from the TTL for Cloud CDN's edge caches. Leaving this empty will use the same cache TTL for both Cloud CDN and the client-facing response. The maximum allowed value is 86400s (1 day).", + "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 86400s (1 day).", "format": "int32" }, "defaultTtl": { @@ -2644,6 +2803,26 @@ "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.", "format": "int32" }, + "negativeCaching": { + "type": "boolean", + "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." + }, + "negativeCachingPolicy": { + "type": "array", + "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.", + "items": { + "$ref": "BackendServiceCdnPolicyNegativeCachingPolicy" + } + }, + "requestCoalescing": { + "type": "boolean", + "description": "If true then Cloud CDN will combine multiple concurrent cache fill requests into a small number of requests to the origin." + }, + "serveWhileStale": { + "type": "integer", + "description": "Serve existing content from the cache (if available) when revalidating content with the origin, or when an error is encountered when refreshing the cache. This setting defines the default \"max-stale\" duration for any cached responses that do not specify a max-stale directive. Stale responses that exceed the TTL configured here will not be served. The default limit (max-stale) is 86400s (1 day), which will allow stale content to be served up to this limit beyond the max-age (or s-max-age) of a cached response. The maximum allowed value is 604800 (1 week). Set this to zero (0) to disable serve-while-stale.", + "format": "int32" + }, "signedUrlCacheMaxAgeSec": { "type": "string", "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.", @@ -2658,6 +2837,34 @@ } } }, + "BackendServiceCdnPolicyBypassCacheOnRequestHeader": { + "id": "BackendServiceCdnPolicyBypassCacheOnRequestHeader", + "type": "object", + "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.", + "properties": { + "headerName": { + "type": "string", + "description": "The header field name to match on when bypassing cache. Values are case-insensitive." + } + } + }, + "BackendServiceCdnPolicyNegativeCachingPolicy": { + "id": "BackendServiceCdnPolicyNegativeCachingPolicy", + "type": "object", + "description": "Specify CDN TTLs for response error codes.", + "properties": { + "code": { + "type": "integer", + "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.", + "format": "int32" + }, + "ttl": { + "type": "integer", + "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.", + "format": "int32" + } + } + }, "BackendServiceFailoverPolicy": { "id": "BackendServiceFailoverPolicy", "type": "object", @@ -2991,6 +3198,56 @@ } } }, + "BulkInsertInstanceResource": { + "id": "BulkInsertInstanceResource", + "type": "object", + "properties": { + "count": { + "type": "string", + "description": "The maximum number of instances to create.", + "format": "int64" + }, + "instanceProperties": { + "$ref": "InstanceProperties", + "description": "The instance properties defining the VM instances to be created. Required if sourceInstanceTemplate is not provided." + }, + "locationPolicy": { + "$ref": "LocationPolicy", + "description": "Policy for chosing target zone." + }, + "minCount": { + "type": "string", + "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.", + "format": "int64" + }, + "namePattern": { + "type": "string", + "description": "The string pattern used for the names of the VMs. Either name_pattern or per_instance_properties must be set. The pattern should contain one continuous sequence of placeholder hash characters (#) with each character corresponding to one digit of the generated instance name. Example: name_pattern of inst-#### will generate instance names such as inst-0001, inst-0002, ... . If there already exist instance(s) whose names match the name pattern in the same project and zone, then the generated instance numbers will 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-#### will be inst-0051, inst-0052, etc. The name pattern placeholder #...# can contain up to 18 characters." + }, + "perInstanceProperties": { + "type": "object", + "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.", + "additionalProperties": { + "$ref": "BulkInsertInstanceResourcePerInstanceProperties" + } + }, + "sourceInstanceTemplate": { + "type": "string", + "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.\n\nIt can be a full or partial URL. For example, the following are all valid URLs to an instance template: \n- https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate \n- projects/project/global/instanceTemplates/instanceTemplate \n- global/instanceTemplates/instanceTemplate \n\nThis field is optional." + } + } + }, + "BulkInsertInstanceResourcePerInstanceProperties": { + "id": "BulkInsertInstanceResourcePerInstanceProperties", + "type": "object", + "description": "Per-instance properties to be set on individual instances. To be extended in the future.", + "properties": { + "name": { + "type": "string", + "description": "This field is only temporary. It will be removed. Do not use it." + } + } + }, "CacheInvalidationRule": { "id": "CacheInvalidationRule", "type": "object", @@ -3616,7 +3873,7 @@ "properties": { "drainingTimeoutSec": { "type": "integer", - "description": "The amount of time in seconds to allow existing connections to persist while on unhealthy backend VMs. Only applicable if the protocol is not UDP. The valid range is [0, 3600].", + "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.", "format": "int32" } } @@ -3685,7 +3942,7 @@ }, "allowOriginRegexes": { "type": "array", - "description": "Specifies the regualar expression patterns that match allowed origins. For regular expression grammar please see en.cppreference.com/w/cpp/regex/ecmascript \nAn origin is allowed if it matches either an item in allowOrigins or an item in allowOriginRegexes.", + "description": "Specifies the regualar expression patterns that match allowed origins. For regular expression grammar please see github.com/google/re2/wiki/Syntax \nAn origin is allowed if it matches either an item in allowOrigins or an item in allowOriginRegexes.", "items": { "type": "string" } @@ -3859,6 +4116,10 @@ "type": "string" } }, + "locationHint": { + "type": "string", + "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." + }, "name": { "type": "string", "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.", @@ -3878,6 +4139,11 @@ "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.", "format": "int64" }, + "provisionedIops": { + "type": "string", + "description": "Indicates how many IOPS must be provisioned for the disk.", + "format": "int64" + }, "region": { "type": "string", "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." @@ -3896,6 +4162,10 @@ "type": "string" } }, + "satisfiesPzs": { + "type": "boolean", + "description": "[Output Only] Reserved for future use." + }, "selfLink": { "type": "string", "description": "[Output Only] Server-defined fully-qualified URL for this resource." @@ -3907,7 +4177,7 @@ }, "sourceDisk": { "type": "string", - "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: \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" + "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: \n- https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk \n- https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk \n- projects/project/zones/zone/disks/disk \n- projects/project/regions/region/disks/disk \n- zones/zone/disks/disk \n- regions/region/disks/disk" }, "sourceDiskId": { "type": "string", @@ -3937,9 +4207,13 @@ "type": "string", "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." }, + "sourceStorageObject": { + "type": "string", + "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." + }, "status": { "type": "string", - "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.", + "description": "[Output Only] The status of disk creation. \n- CREATING: Disk is provisioning. \n- RESTORING: Source data is being copied into the disk. \n- FAILED: Disk creation failed. \n- READY: Disk is ready for use. \n- DELETING: Disk is deleting.", "enum": [ "CREATING", "DELETING", @@ -4808,6 +5082,20 @@ "id": "DistributionPolicy", "type": "object", "properties": { + "targetShape": { + "type": "string", + "description": "The distribution shape to which the group converges either proactively or on resize events (depending on the value set in updatePolicy.instanceRedistributionType).", + "enum": [ + "ANY", + "BALANCED", + "EVEN" + ], + "enumDescriptions": [ + "", + "", + "" + ] + }, "zones": { "type": "array", "description": "Zones where the regional managed instance group will create and manage its instances.", @@ -5546,68 +5834,35 @@ } } }, - "FixedOrPercent": { - "id": "FixedOrPercent", + "FirewallPoliciesListAssociationsResponse": { + "id": "FirewallPoliciesListAssociationsResponse", "type": "object", - "description": "Encapsulates numeric value that can be either absolute or relative.", "properties": { - "calculated": { - "type": "integer", - "description": "[Output Only] Absolute value of VM instances calculated based on the specific mode.\n\n \n- If the value is fixed, then the calculated value is equal to the fixed value. \n- 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 up.", - "format": "int32" - }, - "fixed": { - "type": "integer", - "description": "Specifies a fixed number of VM instances. This must be a positive integer.", - "format": "int32" + "associations": { + "type": "array", + "description": "A list of associations.", + "items": { + "$ref": "FirewallPolicyAssociation" + } }, - "percent": { - "type": "integer", - "description": "Specifies a percentage of instances between 0 to 100%, inclusive. For example, specify 80 for 80%.", - "format": "int32" + "kind": { + "type": "string", + "description": "[Output Only] Type of firewallPolicy associations. Always compute#FirewallPoliciesListAssociations for lists of firewallPolicy associations.", + "default": "compute#firewallPoliciesListAssociationsResponse" } } }, - "ForwardingRule": { - "id": "ForwardingRule", + "FirewallPolicy": { + "id": "FirewallPolicy", "type": "object", - "description": "Represents a Forwarding Rule resource.\n\nForwarding rule resources in GCP can be either regional or global in scope:\n\n* [Global](/compute/docs/reference/rest/{$api_version}/globalForwardingRules) * [Regional](/compute/docs/reference/rest/{$api_version}/forwardingRules)\n\nA forwarding rule and its corresponding IP address represent the frontend configuration of a Google Cloud Platform load balancer. Forwarding rules can also reference target instances and Cloud VPN Classic gateways (targetVpnGateway).\n\nFor more information, read Forwarding rule concepts and Using protocol forwarding.\n\n(== resource_for {$api_version}.forwardingRules ==) (== resource_for {$api_version}.globalForwardingRules ==) (== resource_for {$api_version}.regionForwardingRules ==)", + "description": "Represents a Firewall Policy resource. (== resource_for {$api_version}.firewallPolicies ==)", "properties": { - "IPAddress": { - "type": "string", - "description": "IP address that this forwarding rule serves. When a client sends traffic to this IP address, the forwarding rule directs the traffic to the target that you specify in the forwarding rule.\n\nIf you don't specify a reserved IP address, an ephemeral IP address is assigned. Methods for specifying an IP address:\n\n* IPv4 dotted decimal, as in `100.1.2.3` * Full URL, as in https://www.googleapis.com/compute/v1/projects/project_id/regions/region/addresses/address-name * Partial URL or by name, as in: \n- projects/project_id/regions/region/addresses/address-name \n- regions/region/addresses/address-name \n- global/addresses/address-name \n- address-name \n\nThe loadBalancingScheme and the forwarding rule's target determine the type of IP address that you can use. For detailed information, refer to [IP address specifications](/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications).\n\nMust be set to `0.0.0.0` when the target is targetGrpcProxy that has validateForProxyless field set to true.\n\nFor Private Service Connect forwarding rules that forward traffic to Google APIs, IP address must be provided." - }, - "IPProtocol": { - "type": "string", - "description": "The IP protocol to which this rule applies.\n\nFor protocol forwarding, valid options are TCP, UDP, ESP, AH, SCTP and ICMP.\n\nThe valid IP protocols are different for different load balancing products: \n- Internal TCP/UDP Load Balancing: The load balancing scheme is INTERNAL, and one of TCP, UDP or ALL is valid. \n- Traffic Director: The load balancing scheme is INTERNAL_SELF_MANAGED, and only TCP is valid. \n- Internal HTTP(S) Load Balancing: The load balancing scheme is INTERNAL_MANAGED, and only TCP is valid. \n- HTTP(S), SSL Proxy, and TCP Proxy Load Balancing: The load balancing scheme is EXTERNAL and only TCP is valid. \n- Network Load Balancing: The load balancing scheme is EXTERNAL, and one of TCP or UDP is valid.", - "enum": [ - "AH", - "ESP", - "ICMP", - "SCTP", - "TCP", - "UDP" - ], - "enumDescriptions": [ - "", - "", - "", - "", - "", - "" - ] - }, - "allPorts": { - "type": "boolean", - "description": "This field is used along with the backend_service field for internal load balancing or with the target field for internal TargetInstance. This field cannot be used with port or portRange fields.\n\nWhen the load balancing scheme is INTERNAL and protocol is TCP/UDP, specify this field to allow packets addressed to any ports will be forwarded to the backends configured with this forwarding rule." - }, - "allowGlobalAccess": { - "type": "boolean", - "description": "This field is used along with the backend_service field for internal load balancing or with the target field for internal TargetInstance. If the field is set to TRUE, clients can access ILB from all regions. Otherwise only allows access from clients in the same region as the internal load balancer." - }, - "backendService": { - "type": "string", - "description": "Identifies the backend service to which the forwarding rule sends traffic. Required for Internal TCP/UDP Load Balancing and Network Load Balancing; must be omitted for all other load balancer types." + "associations": { + "type": "array", + "description": "A list of associations that belong to this firewall policy.", + "items": { + "$ref": "FirewallPolicyAssociation" + } }, "creationTimestamp": { "type": "string", @@ -5617,9 +5872,14 @@ "type": "string", "description": "An optional description of this resource. Provide this property when you create the resource." }, + "displayName": { + "type": "string", + "description": "Depreacted, please use short name instead. User-provided name of the Organization firewall plicy. The name should be unique in the organization in which the firewall policy 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])?" + }, "fingerprint": { "type": "string", - "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.\n\nTo see the latest fingerprint, make a get() request to retrieve a ForwardingRule.", + "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.\n\nTo see the latest fingerprint, make get() request to the firewall policy.", "format": "byte" }, "id": { @@ -5627,115 +5887,74 @@ "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", "format": "uint64" }, - "ipVersion": { - "type": "string", - "description": "The IP Version that will be used by this forwarding rule. Valid options are IPV4 or IPV6. This can only be specified for an external global forwarding rule.", - "enum": [ - "IPV4", - "IPV6", - "UNSPECIFIED_VERSION" - ], - "enumDescriptions": [ - "", - "", - "" - ] - }, - "isMirroringCollector": { - "type": "boolean", - "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." - }, "kind": { "type": "string", - "description": "[Output Only] Type of the resource. Always compute#forwardingRule for Forwarding Rule resources.", - "default": "compute#forwardingRule" - }, - "loadBalancingScheme": { - "type": "string", - "description": "Specifies the forwarding rule type.\n\n \n- EXTERNAL is used for: \n- Classic Cloud VPN gateways \n- Protocol forwarding to VMs from an external IP address \n- HTTP(S), SSL Proxy, TCP Proxy, and Network Load Balancing \n- INTERNAL is used for: \n- Protocol forwarding to VMs from an internal IP address \n- Internal TCP/UDP Load Balancing \n- INTERNAL_MANAGED is used for: \n- Internal HTTP(S) Load Balancing \n- INTERNAL_SELF_MANAGED is used for: \n- Traffic Director \n\nFor more information about forwarding rules, refer to Forwarding rule concepts.", - "enum": [ - "EXTERNAL", - "INTERNAL", - "INTERNAL_MANAGED", - "INTERNAL_SELF_MANAGED", - "INVALID" - ], - "enumDescriptions": [ - "", - "", - "", - "", - "" - ] - }, - "metadataFilters": { - "type": "array", - "description": "Opaque filter criteria used by Loadbalancer to restrict routing configuration to a limited set of xDS compliant clients. In their xDS requests to Loadbalancer, 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 will not be visible to those proxies.\nFor 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.\nmetadataFilters specified here will be applifed before those specified in the UrlMap that this ForwardingRule references.\nmetadataFilters only applies to Loadbalancers that have their loadBalancingScheme set to INTERNAL_SELF_MANAGED.", - "items": { - "$ref": "MetadataFilter" - } + "description": "[Output only] Type of the resource. Always compute#firewallPolicyfor firewall policies", + "default": "compute#firewallPolicy" }, "name": { "type": "string", - "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])?" + "description": "[Output Only] Name of the resource. It is a numeric ID allocated by GCP which uniquely identifies the Firewall Policy." }, - "network": { + "parent": { "type": "string", - "description": "This field is not used for external load balancing.\n\nFor Internal TCP/UDP Load Balancing, this field identifies the network that the load balanced IP should belong to for this Forwarding Rule. If this field is not specified, the default network will be used.\n\nFor Private Service Connect forwarding rules that forward traffic to Google APIs, a network must be provided." + "description": "[Output Only] The parent of the firewall policy." }, - "networkTier": { - "type": "string", - "description": "This signifies the networking tier used for configuring this load balancer and can only take the following values: PREMIUM, STANDARD.\n\nFor regional ForwardingRule, the valid values are PREMIUM and STANDARD. For GlobalForwardingRule, the valid value is PREMIUM.\n\nIf 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.", - "enum": [ - "PREMIUM", - "STANDARD" - ], - "enumDescriptions": [ - "", - "" - ] - }, - "portRange": { - "type": "string", - "description": "This field can be used only if: * Load balancing scheme is one of EXTERNAL, INTERNAL_SELF_MANAGED or INTERNAL_MANAGED, and * IPProtocol is one of TCP, UDP, or SCTP.\n\nPackets addressed to ports in the specified range will be forwarded to target or backend_service. You can only use one of ports, port_range, or allPorts. The three are mutually exclusive. Forwarding rules with the same [IPAddress, IPProtocol] pair must have disjoint port ranges.\n\nSome types of forwarding target have constraints on the acceptable ports: \n- TargetHttpProxy: 80, 8080 \n- TargetHttpsProxy: 443 \n- TargetGrpcProxy: no constraints \n- TargetTcpProxy: 25, 43, 110, 143, 195, 443, 465, 587, 700, 993, 995, 1688, 1883, 5222 \n- TargetSslProxy: 25, 43, 110, 143, 195, 443, 465, 587, 700, 993, 995, 1688, 1883, 5222 \n- TargetVpnGateway: 500, 4500" + "ruleTupleCount": { + "type": "integer", + "description": "[Output Only] Total count of all firewall policy rule tuples. A firewall policy can not exceed a set number of tuples.", + "format": "int32" }, - "ports": { + "rules": { "type": "array", - "description": "The ports field is only supported when the forwarding rule references a backend_service directly. Supported load balancing products are Internal TCP/UDP Load Balancing and Network Load Balancing. Only packets addressed to the specified list of ports are forwarded to backends.\n\nYou can only use one of ports and port_range, or allPorts. The three are mutually exclusive.\n\nYou can specify a list of up to five ports, which can be non-contiguous.\n\nFor Internal TCP/UDP Load Balancing, if you specify allPorts, you should not specify ports.\n\nFor more information, see [Port specifications](/load-balancing/docs/forwarding-rule-concepts#port_specifications).", + "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.", "items": { - "type": "string" + "$ref": "FirewallPolicyRule" } }, - "region": { - "type": "string", - "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." - }, "selfLink": { "type": "string", "description": "[Output Only] Server-defined URL for the resource." }, - "serviceLabel": { + "selfLinkWithId": { "type": "string", - "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.\n\nThe 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.\n\nThis field is only used for internal load balancing.", + "description": "[Output Only] Server-defined URL for this resource with the resource id." + }, + "shortName": { + "type": "string", + "description": "User-provided name of the Organization firewall plicy. The name should be unique in the organization in which the firewall policy 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])?" + } + } + }, + "FirewallPolicyAssociation": { + "id": "FirewallPolicyAssociation", + "type": "object", + "properties": { + "attachmentTarget": { + "type": "string", + "description": "The target that the firewall policy is attached to." }, - "serviceName": { + "displayName": { "type": "string", - "description": "[Output Only] The internal fully qualified service name for this Forwarding Rule.\n\nThis field is only used for internal load balancing." + "description": "[Output Only] Deprecated, please use short name instead. The display name of the firewall policy of the association." }, - "subnetwork": { + "firewallPolicyId": { "type": "string", - "description": "This field is only used for internal load balancing.\n\nFor internal load balancing, this field identifies the subnetwork that the load balanced IP should belong to for this Forwarding Rule.\n\nIf the network specified is in auto subnet mode, this field is optional. However, if the network is in custom subnet mode, a subnetwork must be specified." + "description": "[Output Only] The firewall policy ID of the association." }, - "target": { + "name": { + "type": "string", + "description": "The name for an association." + }, + "shortName": { "type": "string", - "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 more information, see the \"Target\" column in [Port specifications](/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications).\n\nFor Private Service Connect forwarding rules that forward traffic to Google APIs, provide the name of a supported Google API bundle. Currently, the supported Google API bundles include:\n\n \n- vpc-sc - GCP APIs that support VPC Service Controls. For more information about which APIs support VPC Service Controls, refer to VPC-SC supported products and limitations. \n- all-apis - All GCP APIs. For more information about which APIs are supported with this bundle, refer to Private Google Access-specific domains and VIPs." + "description": "[Output Only] The short name of the firewall policy of the association." } } }, - "ForwardingRuleAggregatedList": { - "id": "ForwardingRuleAggregatedList", + "FirewallPolicyList": { + "id": "FirewallPolicyList", "type": "object", "properties": { "id": { @@ -5743,33 +5962,468 @@ "description": "[Output Only] Unique identifier for the resource; defined by the server." }, "items": { - "type": "object", - "description": "A list of ForwardingRulesScopedList resources.", - "additionalProperties": { - "$ref": "ForwardingRulesScopedList", - "description": "Name of the scope containing this set of addresses." + "type": "array", + "description": "A list of FirewallPolicy resources.", + "items": { + "$ref": "FirewallPolicy" } }, "kind": { "type": "string", - "description": "[Output Only] Type of resource. Always compute#forwardingRuleAggregatedList for lists of forwarding rules.", - "default": "compute#forwardingRuleAggregatedList" + "description": "[Output Only] Type of resource. Always compute#firewallPolicyList for listsof FirewallPolicies", + "default": "compute#firewallPolicyList" }, "nextPageToken": { "type": "string", "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results." }, - "selfLink": { - "type": "string", - "description": "[Output Only] Server-defined URL for this resource." - }, - "unreachables": { - "type": "array", - "description": "[Output Only] Unreachable resources.", - "items": { - "type": "string" - } - }, + "warning": { + "type": "object", + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "type": "string", + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are 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", + "LARGE_DEPLOYMENT_WARNING", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "" + ] + }, + "data": { + "type": "array", + "description": "[Output Only] Metadata about this warning in key: value format. For example:\n\"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" }", + "items": { + "type": "object", + "properties": { + "key": { + "type": "string", + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding)." + }, + "value": { + "type": "string", + "description": "[Output Only] A warning data value corresponding to the key." + } + } + } + }, + "message": { + "type": "string", + "description": "[Output Only] A human-readable description of the warning code." + } + } + } + } + }, + "FirewallPolicyRule": { + "id": "FirewallPolicyRule", + "type": "object", + "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).", + "properties": { + "action": { + "type": "string", + "description": "The Action to perform when the client connection triggers the rule. Can currently be either \"allow\" or \"deny()\" where valid values for status are 403, 404, and 502." + }, + "description": { + "type": "string", + "description": "An optional description for this resource." + }, + "direction": { + "type": "string", + "description": "The direction in which this rule applies.", + "enum": [ + "EGRESS", + "INGRESS" + ], + "enumDescriptions": [ + "", + "" + ] + }, + "disabled": { + "type": "boolean", + "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." + }, + "enableLogging": { + "type": "boolean", + "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." + }, + "kind": { + "type": "string", + "description": "[Output only] Type of the resource. Always compute#firewallPolicyRule for firewall policy rules", + "default": "compute#firewallPolicyRule" + }, + "match": { + "$ref": "FirewallPolicyRuleMatcher", + "description": "A match condition that incoming traffic is evaluated against. If it evaluates to true, the corresponding 'action' is enforced." + }, + "priority": { + "type": "integer", + "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 prority.", + "format": "int32" + }, + "ruleTupleCount": { + "type": "integer", + "description": "[Output Only] Calculation of the complexity of a single firewall policy rule.", + "format": "int32" + }, + "targetResources": { + "type": "array", + "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.", + "items": { + "type": "string" + } + }, + "targetServiceAccounts": { + "type": "array", + "description": "A list of service accounts indicating the sets of instances that are applied with this rule.", + "items": { + "type": "string" + } + } + } + }, + "FirewallPolicyRuleMatcher": { + "id": "FirewallPolicyRuleMatcher", + "type": "object", + "description": "Represents a match condition that incoming traffic is evaluated against. Exactly one field must be specified.", + "properties": { + "destIpRanges": { + "type": "array", + "description": "CIDR IP address range. Maximum number of destination CIDR IP ranges allowed is 256.", + "items": { + "type": "string" + } + }, + "layer4Configs": { + "type": "array", + "description": "Pairs of IP protocols and ports that the rule should match.", + "items": { + "$ref": "FirewallPolicyRuleMatcherLayer4Config" + } + }, + "srcIpRanges": { + "type": "array", + "description": "CIDR IP address range. Maximum number of source CIDR IP ranges allowed is 256.", + "items": { + "type": "string" + } + } + } + }, + "FirewallPolicyRuleMatcherLayer4Config": { + "id": "FirewallPolicyRuleMatcherLayer4Config", + "type": "object", + "properties": { + "ipProtocol": { + "type": "string", + "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." + }, + "ports": { + "type": "array", + "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.\n\nExample inputs include: [\"22\"], [\"80\",\"443\"], and [\"12345-12349\"].", + "items": { + "type": "string" + } + } + } + }, + "FixedOrPercent": { + "id": "FixedOrPercent", + "type": "object", + "description": "Encapsulates numeric value that can be either absolute or relative.", + "properties": { + "calculated": { + "type": "integer", + "description": "[Output Only] Absolute value of VM instances calculated based on the specific mode.\n\n \n- If the value is fixed, then the calculated value is equal to the fixed value. \n- 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 up.", + "format": "int32" + }, + "fixed": { + "type": "integer", + "description": "Specifies a fixed number of VM instances. This must be a positive integer.", + "format": "int32" + }, + "percent": { + "type": "integer", + "description": "Specifies a percentage of instances between 0 to 100%, inclusive. For example, specify 80 for 80%.", + "format": "int32" + } + } + }, + "ForwardingRule": { + "id": "ForwardingRule", + "type": "object", + "description": "Represents a Forwarding Rule resource.\n\nForwarding rule resources in GCP can be either regional or global in scope:\n\n* [Global](/compute/docs/reference/rest/{$api_version}/globalForwardingRules) * [Regional](/compute/docs/reference/rest/{$api_version}/forwardingRules)\n\nA forwarding rule and its corresponding IP address represent the frontend configuration of a Google Cloud Platform load balancer. Forwarding rules can also reference target instances and Cloud VPN Classic gateways (targetVpnGateway).\n\nFor more information, read Forwarding rule concepts and Using protocol forwarding.\n\n(== resource_for {$api_version}.forwardingRules ==) (== resource_for {$api_version}.globalForwardingRules ==) (== resource_for {$api_version}.regionForwardingRules ==)", + "properties": { + "IPAddress": { + "type": "string", + "description": "IP address that this forwarding rule serves. When a client sends traffic to this IP address, the forwarding rule directs the traffic to the target that you specify in the forwarding rule.\n\nIf you don't specify a reserved IP address, an ephemeral IP address is assigned. Methods for specifying an IP address:\n\n* IPv4 dotted decimal, as in `100.1.2.3` * Full URL, as in https://www.googleapis.com/compute/v1/projects/project_id/regions/region/addresses/address-name * Partial URL or by name, as in: \n- projects/project_id/regions/region/addresses/address-name \n- regions/region/addresses/address-name \n- global/addresses/address-name \n- address-name \n\nThe loadBalancingScheme and the forwarding rule's target determine the type of IP address that you can use. For detailed information, refer to [IP address specifications](/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications).\n\nMust be set to `0.0.0.0` when the target is targetGrpcProxy that has validateForProxyless field set to true.\n\nFor Private Service Connect forwarding rules that forward traffic to Google APIs, IP address must be provided." + }, + "IPProtocol": { + "type": "string", + "description": "The IP protocol to which this rule applies.\n\nFor protocol forwarding, valid options are TCP, UDP, ESP, AH, SCTP and ICMP.\n\nThe valid IP protocols are different for different load balancing products: \n- Internal TCP/UDP Load Balancing: The load balancing scheme is INTERNAL, and one of TCP, UDP or ALL is valid. \n- Traffic Director: The load balancing scheme is INTERNAL_SELF_MANAGED, and only TCP is valid. \n- Internal HTTP(S) Load Balancing: The load balancing scheme is INTERNAL_MANAGED, and only TCP is valid. \n- HTTP(S), SSL Proxy, and TCP Proxy Load Balancing: The load balancing scheme is EXTERNAL and only TCP is valid. \n- Network Load Balancing: The load balancing scheme is EXTERNAL, and one of TCP or UDP is valid.", + "enum": [ + "AH", + "ESP", + "ICMP", + "SCTP", + "TCP", + "UDP" + ], + "enumDescriptions": [ + "", + "", + "", + "", + "", + "" + ] + }, + "allPorts": { + "type": "boolean", + "description": "This field is used along with the backend_service field for internal load balancing or with the target field for internal TargetInstance. This field cannot be used with port or portRange fields.\n\nWhen the load balancing scheme is INTERNAL and protocol is TCP/UDP, specify this field to allow packets addressed to any ports will be forwarded to the backends configured with this forwarding rule." + }, + "allowGlobalAccess": { + "type": "boolean", + "description": "This field is used along with the backend_service field for internal load balancing or with the target field for internal TargetInstance. If the field is set to TRUE, clients can access ILB from all regions. Otherwise only allows access from clients in the same region as the internal load balancer." + }, + "backendService": { + "type": "string", + "description": "Identifies the backend service to which the forwarding rule sends traffic. Required for Internal TCP/UDP Load Balancing and Network Load Balancing; must be omitted for all other load balancer types." + }, + "creationTimestamp": { + "type": "string", + "description": "[Output Only] Creation timestamp in RFC3339 text format." + }, + "description": { + "type": "string", + "description": "An optional description of this resource. Provide this property when you create the resource." + }, + "fingerprint": { + "type": "string", + "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.\n\nTo see the latest fingerprint, make a get() request to retrieve a ForwardingRule.", + "format": "byte" + }, + "id": { + "type": "string", + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "format": "uint64" + }, + "ipVersion": { + "type": "string", + "description": "The IP Version that will be used by this forwarding rule. Valid options are IPV4 or IPV6. This can only be specified for an external global forwarding rule.", + "enum": [ + "IPV4", + "IPV6", + "UNSPECIFIED_VERSION" + ], + "enumDescriptions": [ + "", + "", + "" + ] + }, + "isMirroringCollector": { + "type": "boolean", + "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." + }, + "kind": { + "type": "string", + "description": "[Output Only] Type of the resource. Always compute#forwardingRule for Forwarding Rule resources.", + "default": "compute#forwardingRule" + }, + "labelFingerprint": { + "type": "string", + "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.\n\nTo see the latest fingerprint, make a get() request to retrieve a ForwardingRule.", + "format": "byte" + }, + "labels": { + "type": "object", + "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.", + "additionalProperties": { + "type": "string" + } + }, + "loadBalancingScheme": { + "type": "string", + "description": "Specifies the forwarding rule type.\n\n \n- EXTERNAL is used for: \n- Classic Cloud VPN gateways \n- Protocol forwarding to VMs from an external IP address \n- HTTP(S), SSL Proxy, TCP Proxy, and Network Load Balancing \n- INTERNAL is used for: \n- Protocol forwarding to VMs from an internal IP address \n- Internal TCP/UDP Load Balancing \n- INTERNAL_MANAGED is used for: \n- Internal HTTP(S) Load Balancing \n- INTERNAL_SELF_MANAGED is used for: \n- Traffic Director \n\nFor more information about forwarding rules, refer to Forwarding rule concepts.", + "enum": [ + "EXTERNAL", + "INTERNAL", + "INTERNAL_MANAGED", + "INTERNAL_SELF_MANAGED", + "INVALID" + ], + "enumDescriptions": [ + "", + "", + "", + "", + "" + ] + }, + "metadataFilters": { + "type": "array", + "description": "Opaque filter criteria used by Loadbalancer to restrict routing configuration to a limited set of xDS compliant clients. In their xDS requests to Loadbalancer, 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 will not be visible to those proxies.\nFor 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.\nmetadataFilters specified here will be applifed before those specified in the UrlMap that this ForwardingRule references.\nmetadataFilters only applies to Loadbalancers that have their loadBalancingScheme set to INTERNAL_SELF_MANAGED.", + "items": { + "$ref": "MetadataFilter" + } + }, + "name": { + "type": "string", + "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])?" + }, + "network": { + "type": "string", + "description": "This field is not used for external load balancing.\n\nFor Internal TCP/UDP Load Balancing, this field identifies the network that the load balanced IP should belong to for this Forwarding Rule. If this field is not specified, the default network will be used.\n\nFor Private Service Connect forwarding rules that forward traffic to Google APIs, a network must be provided." + }, + "networkTier": { + "type": "string", + "description": "This signifies the networking tier used for configuring this load balancer and can only take the following values: PREMIUM, STANDARD.\n\nFor regional ForwardingRule, the valid values are PREMIUM and STANDARD. For GlobalForwardingRule, the valid value is PREMIUM.\n\nIf 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.", + "enum": [ + "PREMIUM", + "STANDARD" + ], + "enumDescriptions": [ + "", + "" + ] + }, + "portRange": { + "type": "string", + "description": "This field can be used only if: * Load balancing scheme is one of EXTERNAL, INTERNAL_SELF_MANAGED or INTERNAL_MANAGED, and * IPProtocol is one of TCP, UDP, or SCTP.\n\nPackets addressed to ports in the specified range will be forwarded to target or backend_service. You can only use one of ports, port_range, or allPorts. The three are mutually exclusive. Forwarding rules with the same [IPAddress, IPProtocol] pair must have disjoint port ranges.\n\nSome types of forwarding target have constraints on the acceptable ports: \n- TargetHttpProxy: 80, 8080 \n- TargetHttpsProxy: 443 \n- TargetGrpcProxy: no constraints \n- TargetTcpProxy: 25, 43, 110, 143, 195, 443, 465, 587, 700, 993, 995, 1688, 1883, 5222 \n- TargetSslProxy: 25, 43, 110, 143, 195, 443, 465, 587, 700, 993, 995, 1688, 1883, 5222 \n- TargetVpnGateway: 500, 4500" + }, + "ports": { + "type": "array", + "description": "The ports field is only supported when the forwarding rule references a backend_service directly. Supported load balancing products are Internal TCP/UDP Load Balancing and Network Load Balancing. Only packets addressed to the specified list of ports are forwarded to backends.\n\nYou can only use one of ports and port_range, or allPorts. The three are mutually exclusive.\n\nYou can specify a list of up to five ports, which can be non-contiguous.\n\nFor Internal TCP/UDP Load Balancing, if you specify allPorts, you should not specify ports.\n\nFor more information, see [Port specifications](/load-balancing/docs/forwarding-rule-concepts#port_specifications).", + "items": { + "type": "string" + } + }, + "pscConnectionId": { + "type": "string", + "description": "[Output Only] The PSC connection id of the PSC Forwarding Rule.", + "format": "uint64" + }, + "region": { + "type": "string", + "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." + }, + "selfLink": { + "type": "string", + "description": "[Output Only] Server-defined URL for the resource." + }, + "serviceDirectoryRegistrations": { + "type": "array", + "description": "Service Directory resources to register this forwarding rule with. Currently, only supports a single Service Directory resource.\n\nIt is only supported for Internal TCP/UDP Load Balancing and Internal HTTP(S) Load Balancing.", + "items": { + "$ref": "ForwardingRuleServiceDirectoryRegistration" + } + }, + "serviceLabel": { + "type": "string", + "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.\n\nThe 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.\n\nThis field is only used for internal load balancing.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?" + }, + "serviceName": { + "type": "string", + "description": "[Output Only] The internal fully qualified service name for this Forwarding Rule.\n\nThis field is only used for internal load balancing." + }, + "subnetwork": { + "type": "string", + "description": "This field is only used for internal load balancing.\n\nFor internal load balancing, this field identifies the subnetwork that the load balanced IP should belong to for this Forwarding Rule.\n\nIf the network specified is in auto subnet mode, this field is optional. However, if the network is in custom subnet mode, a subnetwork must be specified." + }, + "target": { + "type": "string" + } + } + }, + "ForwardingRuleAggregatedList": { + "id": "ForwardingRuleAggregatedList", + "type": "object", + "properties": { + "id": { + "type": "string", + "description": "[Output Only] Unique identifier for the resource; defined by the server." + }, + "items": { + "type": "object", + "description": "A list of ForwardingRulesScopedList resources.", + "additionalProperties": { + "$ref": "ForwardingRulesScopedList", + "description": "Name of the scope containing this set of addresses." + } + }, + "kind": { + "type": "string", + "description": "[Output Only] Type of resource. Always compute#forwardingRuleAggregatedList for lists of forwarding rules.", + "default": "compute#forwardingRuleAggregatedList" + }, + "nextPageToken": { + "type": "string", + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results." + }, + "selfLink": { + "type": "string", + "description": "[Output Only] Server-defined URL for this resource." + }, + "unreachables": { + "type": "array", + "description": "[Output Only] Unreachable resources.", + "items": { + "type": "string" + } + }, "warning": { "type": "object", "description": "[Output Only] Informational warning message.", @@ -5982,6 +6636,25 @@ } } }, + "ForwardingRuleServiceDirectoryRegistration": { + "id": "ForwardingRuleServiceDirectoryRegistration", + "type": "object", + "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.", + "properties": { + "namespace": { + "type": "string", + "description": "Service Directory namespace to register the forwarding rule under." + }, + "service": { + "type": "string", + "description": "Service Directory service to register the forwarding rule under." + }, + "serviceDirectoryRegion": { + "type": "string", + "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." + } + } + }, "ForwardingRulesScopedList": { "id": "ForwardingRulesScopedList", "type": "object", @@ -6139,6 +6812,28 @@ } } }, + "GlobalOrganizationSetPolicyRequest": { + "id": "GlobalOrganizationSetPolicyRequest", + "type": "object", + "properties": { + "bindings": { + "type": "array", + "description": "Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify bindings.", + "items": { + "$ref": "Binding" + } + }, + "etag": { + "type": "string", + "description": "Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify the etag.", + "format": "byte" + }, + "policy": { + "$ref": "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." + } + } + }, "GlobalSetLabelsRequest": { "id": "GlobalSetLabelsRequest", "type": "object", @@ -6484,7 +7179,7 @@ }, "name": { "type": "string", - "description": "Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.", + "description": "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])?" }, "region": { @@ -7105,6 +7800,14 @@ "type": "string" } }, + "forwardingRule": { + "type": "string", + "description": "URL of the forwarding rule associated with the health status of the instance." + }, + "forwardingRuleIp": { + "type": "string", + "description": "A forwarding rule IP address assigned to this instance." + }, "healthState": { "type": "string", "description": "Health state of the instance.", @@ -7123,7 +7826,7 @@ }, "ipAddress": { "type": "string", - "description": "A forwarding rule IP address assigned to this instance." + "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." }, "port": { "type": "integer", @@ -7324,7 +8027,7 @@ }, "regexMatch": { "type": "string", - "description": "The value of the header must match the regular expression specified in regexMatch. For regular expression grammar, please see: en.cppreference.com/w/cpp/regex/ecmascript \nFor 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.\nOnly one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set.\nNote that regexMatch only applies to Loadbalancers that have their loadBalancingScheme set to INTERNAL_SELF_MANAGED." + "description": "The value of the header must match the regular expression specified in regexMatch. For regular expression grammar, please see: github.com/google/re2/wiki/Syntax \nFor 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.\nOnly one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set.\nNote that regexMatch only applies to Loadbalancers that have their loadBalancingScheme set to INTERNAL_SELF_MANAGED." }, "suffixMatch": { "type": "string", @@ -7553,7 +8256,7 @@ }, "regexMatch": { "type": "string", - "description": "The queryParameterMatch matches if the value of the parameter matches the regular expression specified by regexMatch. For the regular expression grammar, please see en.cppreference.com/w/cpp/regex/ecmascript \nOnly one of presentMatch, exactMatch or regexMatch must be set.\nNote that regexMatch only applies when the loadBalancingScheme is set to INTERNAL_SELF_MANAGED." + "description": "The queryParameterMatch matches if the value of the parameter matches the regular expression specified by regexMatch. For the regular expression grammar, please see github.com/google/re2/wiki/Syntax \nOnly one of presentMatch, exactMatch or regexMatch must be set.\nNote that regexMatch only applies when the loadBalancingScheme is set to INTERNAL_SELF_MANAGED." } } }, @@ -7637,6 +8340,10 @@ "$ref": "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 Loadbalancer on a percentage of requests before sending those request to the backend service. Similarly requests from clients can be aborted by the Loadbalancer for a percentage of requests.\ntimeout and retry_policy will be ignored by clients that are configured with a fault_injection_policy.\nNot supported when the URL map is bound to target gRPC proxy that has validateForProxyless field set to true." }, + "maxStreamDuration": { + "$ref": "Duration", + "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 (i.e. end-of-stream), the duration in this field 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.\nIf not specified, will use the largest maxStreamDuration among all backend services associated with the route.\nThis field is only allowed if the Url map is used with backend services with loadBalancingScheme set to INTERNAL_SELF_MANAGED." + }, "requestMirrorPolicy": { "$ref": "RequestMirrorPolicy", "description": "Specifies the policy on how requests intended for the route's backends are shadowed to a separate mirrored backend service. Loadbalancer does not wait for responses from the shadow service. Prior to sending traffic to the shadow service, the host / authority header is suffixed with -shadow.\nNot supported when the URL map is bound to target gRPC proxy that has validateForProxyless field set to true." @@ -7741,7 +8448,7 @@ }, "regexMatch": { "type": "string", - "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 regular expression grammar please see en.cppreference.com/w/cpp/regex/ecmascript \nOnly one of prefixMatch, fullPathMatch or regexMatch must be specified.\nNote that regexMatch only applies to Loadbalancers that have their loadBalancingScheme set to INTERNAL_SELF_MANAGED." + "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 regular expression grammar please see github.com/google/re2/wiki/Syntax \nOnly one of prefixMatch, fullPathMatch or regexMatch must be specified.\nNote that regexMatch only applies to Loadbalancers that have their loadBalancingScheme set to INTERNAL_SELF_MANAGED." } } }, @@ -8047,6 +8754,10 @@ } } }, + "satisfiesPzs": { + "type": "boolean", + "description": "[Output Only] Reserved for future use." + }, "selfLink": { "type": "string", "description": "[Output Only] Server-defined URL for the resource." @@ -8280,6 +8991,10 @@ "type": "object", "description": "Represents an Instance resource.\n\nAn instance is a virtual machine that is hosted on Google Cloud Platform. For more information, read Virtual Machine Instances. (== resource_for {$api_version}.instances ==)", "properties": { + "advancedMachineFeatures": { + "$ref": "AdvancedMachineFeatures", + "description": "Controls for advanced machine-related behavior features." + }, "canIpForward": { "type": "boolean", "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." @@ -8423,6 +9138,10 @@ "type": "string" } }, + "satisfiesPzs": { + "type": "boolean", + "description": "[Output Only] Reserved for future use." + }, "scheduling": { "$ref": "Scheduling", "description": "Sets the scheduling options for this instance." @@ -9434,11 +10153,11 @@ }, "maxSurge": { "$ref": "FixedOrPercent", - "description": "The maximum number of instances that can be created above the specified targetSize during the update process. By default, a fixed value of 1 is used. This value can be either a fixed number or a percentage if the instance group has 10 or more instances. If you set a percentage, the number of instances will be rounded up if necessary.\n\nAt least one of either maxSurge or maxUnavailable must be greater than 0. Learn more about 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 up if necessary. The default value for maxSurge is a fixed value equal to the number of zones in which the managed instance group operates.\n\nAt least one of either maxSurge or maxUnavailable 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 process. An instance is considered available if all of the following conditions are satisfied:\n\n \n- The instance's status is RUNNING. \n- If there is a health check on the instance group, the instance's liveness health check result 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. By default, a fixed value of 1 is used. This value can be either a fixed number or a percentage if the instance group has 10 or more instances. If you set a percentage, the number of instances will be rounded up if necessary.\n\nAt least one of either maxSurge or maxUnavailable must be greater than 0. Learn more about 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:\n\n \n- The instance's status is RUNNING. \n- 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 up if necessary. The default value for maxUnavailable is a fixed value equal to the number of zones in which the managed instance group operates.\n\nAt least one of either maxSurge or maxUnavailable must be greater than 0. Learn more about maxUnavailable." }, "minimalAction": { "type": "string", @@ -10505,6 +11224,10 @@ "type": "object", "description": "", "properties": { + "advancedMachineFeatures": { + "$ref": "AdvancedMachineFeatures", + "description": "Controls for advanced machine-related behavior features." + }, "canIpForward": { "type": "boolean", "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." @@ -10842,6 +11565,63 @@ } } }, + "InstancesGetEffectiveFirewallsResponse": { + "id": "InstancesGetEffectiveFirewallsResponse", + "type": "object", + "properties": { + "firewallPolicys": { + "type": "array", + "description": "Effective firewalls from firewall policies.", + "items": { + "$ref": "InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy" + } + }, + "firewalls": { + "type": "array", + "description": "Effective firewalls on the instance.", + "items": { + "$ref": "Firewall" + } + } + } + }, + "InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy": { + "id": "InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy", + "type": "object", + "properties": { + "displayName": { + "type": "string", + "description": "[Output Only] Deprecated, please use short name instead. The display name of the firewall policy." + }, + "name": { + "type": "string", + "description": "[Output Only] The name of the firewall policy." + }, + "rules": { + "type": "array", + "description": "The rules that apply to the network.", + "items": { + "$ref": "FirewallPolicyRule" + } + }, + "shortName": { + "type": "string", + "description": "[Output Only] The short name of the firewall policy." + }, + "type": { + "type": "string", + "description": "[Output Only] The type of the firewall policy.", + "enum": [ + "HIERARCHY", + "UNSPECIFIED" + ], + "enumDescriptions": [ + "", + "" + ] + } + } + }, "InstancesRemoveResourcePoliciesRequest": { "id": "InstancesRemoveResourcePoliciesRequest", "type": "object", @@ -11281,6 +12061,18 @@ "" ] }, + "encryption": { + "type": "string", + "description": "Indicates the user-supplied encryption option of this interconnect attachment: \n- NONE is the default value, which means that the attachment carries unencrypted traffic. VMs can send traffic to, or receive traffic from, this type of attachment. \n- IPSEC indicates that the attachment carries only traffic encrypted by an IPsec device such as an HA VPN gateway. VMs cannot directly send traffic to, or receive traffic from, such an attachment. To use IPsec-encrypted Cloud Interconnect, create the attachment using this option. \nNot currently available in all Interconnect locations.", + "enum": [ + "IPSEC", + "NONE" + ], + "enumDescriptions": [ + "", + "" + ] + }, "googleReferenceId": { "type": "string", "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." @@ -11294,6 +12086,13 @@ "type": "string", "description": "URL of the underlying Interconnect object that this attachment's traffic will traverse through." }, + "ipsecInternalAddresses": { + "type": "array", + "description": "URL of addresses that have been reserved for the interconnect attachment, Used only for interconnect attachment that has the encryption option as IPSEC. The addresses must be RFC 1918 IP address ranges. When creating HA VPN gateway over the interconnect attachment, if the attachment is configured to use an RFC 1918 IP address, then the VPN gateway's IP address will be allocated from the IP address range specified here. For example, if the HA VPN gateway's interface 0 is paired to this interconnect attachment, then an RFC 1918 IP address for the VPN gateway interface 0 will be allocated from the IP address specified for this interconnect attachment. If this field is not specified for interconnect attachment that has encryption option as IPSEC, later on when creating HA VPN gateway on this interconnect attachment, the HA VPN gateway's IP address will be allocated from regional external IP address pool.\nNot currently available in all Interconnect locations.", + "items": { + "type": "string" + } + }, "kind": { "type": "string", "description": "[Output Only] Type of the resource. Always compute#interconnectAttachment for interconnect attachments.", @@ -12666,6 +13465,40 @@ } } }, + "LocationPolicy": { + "id": "LocationPolicy", + "type": "object", + "description": "Configuration for location policy among multiple possible locations (e.g. preferences for zone selection among zones in a single region).", + "properties": { + "locations": { + "type": "object", + "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.", + "additionalProperties": { + "$ref": "LocationPolicyLocation" + } + } + } + }, + "LocationPolicyLocation": { + "id": "LocationPolicyLocation", + "type": "object", + "properties": { + "preference": { + "type": "string", + "description": "Preference for a given locaction: ALLOW or DENY.", + "enum": [ + "ALLOW", + "DENY", + "PREFERENCE_UNSPECIFIED" + ], + "enumDescriptions": [ + "", + "", + "" + ] + } + } + }, "LogConfig": { "id": "LogConfig", "type": "object", @@ -13582,7 +14415,7 @@ }, "port": { "type": "integer", - "description": "Optional port number of network endpoint. If not specified and the NetworkEndpointGroup.network_endpoint_type is GCE_IP_PORT, the defaultPort for the network endpoint group will be used.", + "description": "Optional port number of network endpoint. If not specified, the defaultPort for the network endpoint group will be used.", "format": "int32" } } @@ -13646,6 +14479,7 @@ "type": "string", "description": "Type of network endpoints in this network endpoint group. Can be one of GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, INTERNET_IP_PORT, or SERVERLESS.", "enum": [ + "GCE_VM_IP", "GCE_VM_IP_PORT", "INTERNET_FQDN_PORT", "INTERNET_IP_PORT", @@ -13657,6 +14491,7 @@ "", "", "", + "", "" ] }, @@ -14265,7 +15100,7 @@ }, "fingerprint": { "type": "string", - "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, otherwise the request will fail with error 412 conditionNotMet.", + "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.", "format": "byte" }, "ipv6Address": { @@ -14531,6 +15366,65 @@ } } }, + "NetworksGetEffectiveFirewallsResponse": { + "id": "NetworksGetEffectiveFirewallsResponse", + "type": "object", + "properties": { + "firewallPolicys": { + "type": "array", + "description": "Effective firewalls from firewall policy.", + "items": { + "$ref": "NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy" + } + }, + "firewalls": { + "type": "array", + "description": "Effective firewalls on the network.", + "items": { + "$ref": "Firewall" + } + } + } + }, + "NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy": { + "id": "NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy", + "type": "object", + "properties": { + "displayName": { + "type": "string", + "description": "[Output Only] Deprecated, please use short name instead. The display name of the firewall policy." + }, + "name": { + "type": "string", + "description": "[Output Only] The name of the firewall policy." + }, + "rules": { + "type": "array", + "description": "The rules that apply to the network.", + "items": { + "$ref": "FirewallPolicyRule" + } + }, + "shortName": { + "type": "string", + "description": "[Output Only] The short name of the firewall policy." + }, + "type": { + "type": "string", + "description": "[Output Only] The type of the firewall policy.", + "enum": [ + "HIERARCHY", + "NETWORK", + "UNSPECIFIED" + ], + "enumDescriptions": [ + "", + "", + "" + ] + } + } + }, "NetworksRemovePeeringRequest": { "id": "NetworksRemovePeeringRequest", "type": "object", @@ -14581,6 +15475,10 @@ "description": "[Output Only] The type of the resource. Always compute#nodeGroup for node group.", "default": "compute#nodeGroup" }, + "locationHint": { + "type": "string", + "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." + }, "maintenancePolicy": { "type": "string", "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.", @@ -14971,6 +15869,10 @@ "type": "string", "description": "The type of this node." }, + "satisfiesPzs": { + "type": "boolean", + "description": "[Output Only] Reserved for future use." + }, "serverBinding": { "$ref": "ServerBinding", "description": "Binding properties for the physical server." @@ -16357,6 +17259,10 @@ "type": "string", "description": "[Output Only] Name of the operation." }, + "operationGroupId": { + "type": "string", + "description": "[Output Only] An ID that represents a group of operations, such as when a group of operations results from a `bulkInsert` API request." + }, "operationType": { "type": "string", "description": "[Output Only] The type of operation, such as `insert`, `update`, or `delete`, and so on." @@ -17809,6 +18715,693 @@ } } }, + "PublicAdvertisedPrefix": { + "id": "PublicAdvertisedPrefix", + "type": "object", + "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.", + "properties": { + "creationTimestamp": { + "type": "string", + "description": "[Output Only] Creation timestamp in RFC3339 text format." + }, + "description": { + "type": "string", + "description": "An optional description of this resource. Provide this property when you create the resource." + }, + "dnsVerificationIp": { + "type": "string", + "description": "The IPv4 address to be used for reverse DNS verification." + }, + "fingerprint": { + "type": "string", + "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.\n\nTo see the latest fingerprint, make a get() request to retrieve a PublicAdvertisedPrefix.", + "format": "byte" + }, + "id": { + "type": "string", + "description": "[Output Only] The unique identifier for the resource type. The server generates this identifier.", + "format": "uint64" + }, + "ipCidrRange": { + "type": "string", + "description": "The IPv4 address range, in CIDR format, represented by this public advertised prefix." + }, + "kind": { + "type": "string", + "description": "[Output Only] Type of the resource. Always compute#publicAdvertisedPrefix for public advertised prefixes.", + "default": "compute#publicAdvertisedPrefix" + }, + "name": { + "type": "string", + "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" + ] + } + }, + "publicDelegatedPrefixs": { + "type": "array", + "description": "[Output Only] The list of public delegated prefixes that exist for this public advertised prefix.", + "items": { + "$ref": "PublicAdvertisedPrefixPublicDelegatedPrefix" + } + }, + "selfLink": { + "type": "string", + "description": "[Output Only] Server-defined URL for the resource." + }, + "sharedSecret": { + "type": "string", + "description": "[Output Only] The shared secret to be used for reverse DNS verification." + }, + "status": { + "type": "string", + "description": "The status of the public advertised prefix.", + "enum": [ + "INITIAL", + "PREFIX_CONFIGURATION_COMPLETE", + "PREFIX_CONFIGURATION_IN_PROGRESS", + "PREFIX_REMOVAL_IN_PROGRESS", + "PTR_CONFIGURED", + "REVERSE_DNS_LOOKUP_FAILED", + "VALIDATED" + ], + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "" + ] + } + } + }, + "PublicAdvertisedPrefixList": { + "id": "PublicAdvertisedPrefixList", + "type": "object", + "properties": { + "id": { + "type": "string", + "description": "[Output Only] Unique identifier for the resource; defined by the server." + }, + "items": { + "type": "array", + "description": "A list of PublicAdvertisedPrefix resources.", + "items": { + "$ref": "PublicAdvertisedPrefix" + } + }, + "kind": { + "type": "string", + "description": "[Output Only] Type of the resource. Always compute#publicAdvertisedPrefix for public advertised prefixes.", + "default": "compute#publicAdvertisedPrefixList" + }, + "nextPageToken": { + "type": "string", + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results." + }, + "selfLink": { + "type": "string", + "description": "[Output Only] Server-defined URL for this resource." + }, + "warning": { + "type": "object", + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "type": "string", + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are 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", + "LARGE_DEPLOYMENT_WARNING", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "" + ] + }, + "data": { + "type": "array", + "description": "[Output Only] Metadata about this warning in key: value format. For example:\n\"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" }", + "items": { + "type": "object", + "properties": { + "key": { + "type": "string", + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding)." + }, + "value": { + "type": "string", + "description": "[Output Only] A warning data value corresponding to the key." + } + } + } + }, + "message": { + "type": "string", + "description": "[Output Only] A human-readable description of the warning code." + } + } + } + } + }, + "PublicAdvertisedPrefixPublicDelegatedPrefix": { + "id": "PublicAdvertisedPrefixPublicDelegatedPrefix", + "type": "object", + "description": "Represents a CIDR range which can be used to assign addresses.", + "properties": { + "ipRange": { + "type": "string", + "description": "The IP address range of the public delegated prefix" + }, + "name": { + "type": "string", + "description": "The name of the public delegated prefix" + }, + "project": { + "type": "string", + "description": "The project number of the public delegated prefix" + }, + "region": { + "type": "string", + "description": "The region of the public delegated prefix if it is regional. If absent, the prefix is global." + }, + "status": { + "type": "string", + "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." + } + } + }, + "PublicDelegatedPrefix": { + "id": "PublicDelegatedPrefix", + "type": "object", + "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.", + "properties": { + "creationTimestamp": { + "type": "string", + "description": "[Output Only] Creation timestamp in RFC3339 text format." + }, + "description": { + "type": "string", + "description": "An optional description of this resource. Provide this property when you create the resource." + }, + "fingerprint": { + "type": "string", + "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.\n\nTo see the latest fingerprint, make a get() request to retrieve a PublicDelegatedPrefix.", + "format": "byte" + }, + "id": { + "type": "string", + "description": "[Output Only] The unique identifier for the resource type. The server generates this identifier.", + "format": "uint64" + }, + "ipCidrRange": { + "type": "string", + "description": "The IPv4 address range, in CIDR format, represented by this public delegated prefix." + }, + "isLiveMigration": { + "type": "boolean", + "description": "If true, the prefix will be live migrated." + }, + "kind": { + "type": "string", + "description": "[Output Only] Type of the resource. Always compute#publicDelegatedPrefix for public delegated prefixes.", + "default": "compute#publicDelegatedPrefix" + }, + "name": { + "type": "string", + "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" + ] + } + }, + "parentPrefix": { + "type": "string", + "description": "The URL of parent prefix. Either PublicAdvertisedPrefix or PublicDelegatedPrefix." + }, + "publicDelegatedSubPrefixs": { + "type": "array", + "description": "The list of sub public delegated prefixes that exist for this public delegated prefix.", + "items": { + "$ref": "PublicDelegatedPrefixPublicDelegatedSubPrefix" + } + }, + "region": { + "type": "string", + "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." + }, + "selfLink": { + "type": "string", + "description": "[Output Only] Server-defined URL for the resource." + }, + "status": { + "type": "string", + "description": "[Output Only] The status of the public delegated prefix.", + "enum": [ + "ANNOUNCED", + "DELETING", + "INITIALIZING" + ], + "enumDescriptions": [ + "", + "", + "" + ] + } + } + }, + "PublicDelegatedPrefixAggregatedList": { + "id": "PublicDelegatedPrefixAggregatedList", + "type": "object", + "properties": { + "id": { + "type": "string", + "description": "[Output Only] Unique identifier for the resource; defined by the server." + }, + "items": { + "type": "object", + "description": "A list of PublicDelegatedPrefixesScopedList resources.", + "additionalProperties": { + "$ref": "PublicDelegatedPrefixesScopedList", + "description": "[Output Only] Name of the scope containing this set of PublicDelegatedPrefixes." + } + }, + "kind": { + "type": "string", + "description": "[Output Only] Type of the resource. Always compute#publicDelegatedPrefixAggregatedList for aggregated lists of public delegated prefixes.", + "default": "compute#publicDelegatedPrefixAggregatedList" + }, + "nextPageToken": { + "type": "string", + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results." + }, + "selfLink": { + "type": "string", + "description": "[Output Only] Server-defined URL for this resource." + }, + "unreachables": { + "type": "array", + "description": "[Output Only] Unreachable resources.", + "items": { + "type": "string" + } + }, + "warning": { + "type": "object", + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "type": "string", + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are 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", + "LARGE_DEPLOYMENT_WARNING", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "" + ] + }, + "data": { + "type": "array", + "description": "[Output Only] Metadata about this warning in key: value format. For example:\n\"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" }", + "items": { + "type": "object", + "properties": { + "key": { + "type": "string", + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding)." + }, + "value": { + "type": "string", + "description": "[Output Only] A warning data value corresponding to the key." + } + } + } + }, + "message": { + "type": "string", + "description": "[Output Only] A human-readable description of the warning code." + } + } + } + } + }, + "PublicDelegatedPrefixList": { + "id": "PublicDelegatedPrefixList", + "type": "object", + "properties": { + "id": { + "type": "string", + "description": "[Output Only] Unique identifier for the resource; defined by the server." + }, + "items": { + "type": "array", + "description": "A list of PublicDelegatedPrefix resources.", + "items": { + "$ref": "PublicDelegatedPrefix" + } + }, + "kind": { + "type": "string", + "description": "[Output Only] Type of the resource. Always compute#publicDelegatedPrefixList for public delegated prefixes.", + "default": "compute#publicDelegatedPrefixList" + }, + "nextPageToken": { + "type": "string", + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results." + }, + "selfLink": { + "type": "string", + "description": "[Output Only] Server-defined URL for this resource." + }, + "warning": { + "type": "object", + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "type": "string", + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are 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", + "LARGE_DEPLOYMENT_WARNING", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "" + ] + }, + "data": { + "type": "array", + "description": "[Output Only] Metadata about this warning in key: value format. For example:\n\"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" }", + "items": { + "type": "object", + "properties": { + "key": { + "type": "string", + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding)." + }, + "value": { + "type": "string", + "description": "[Output Only] A warning data value corresponding to the key." + } + } + } + }, + "message": { + "type": "string", + "description": "[Output Only] A human-readable description of the warning code." + } + } + } + } + }, + "PublicDelegatedPrefixPublicDelegatedSubPrefix": { + "id": "PublicDelegatedPrefixPublicDelegatedSubPrefix", + "type": "object", + "description": "Represents a sub PublicDelegatedPrefix.", + "properties": { + "delegateeProject": { + "type": "string", + "description": "Name of the project scoping this PublicDelegatedSubPrefix." + }, + "description": { + "type": "string", + "description": "An optional description of this resource. Provide this property when you create the resource." + }, + "ipCidrRange": { + "type": "string", + "description": "The IPv4 address range, in CIDR format, represented by this sub public delegated prefix." + }, + "isAddress": { + "type": "boolean", + "description": "Whether the sub prefix is delegated to create Address resources in the delegatee project." + }, + "name": { + "type": "string", + "description": "The name of the sub public delegated prefix." + }, + "region": { + "type": "string", + "description": "[Output Only] The region of the sub public delegated prefix if it is regional. If absent, the sub prefix is global." + }, + "status": { + "type": "string", + "description": "[Output Only] The status of the sub public delegated prefix.", + "enum": [ + "ACTIVE", + "INACTIVE" + ], + "enumDescriptions": [ + "", + "" + ] + } + } + }, + "PublicDelegatedPrefixesScopedList": { + "id": "PublicDelegatedPrefixesScopedList", + "type": "object", + "properties": { + "publicDelegatedPrefixes": { + "type": "array", + "description": "[Output Only] A list of PublicDelegatedPrefixes contained in this scope.", + "items": { + "$ref": "PublicDelegatedPrefix" + } + }, + "warning": { + "type": "object", + "description": "[Output Only] Informational warning which replaces the list of public delegated prefixes when the list is empty.", + "properties": { + "code": { + "type": "string", + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are 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", + "LARGE_DEPLOYMENT_WARNING", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "" + ] + }, + "data": { + "type": "array", + "description": "[Output Only] Metadata about this warning in key: value format. For example:\n\"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" }", + "items": { + "type": "object", + "properties": { + "key": { + "type": "string", + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding)." + }, + "value": { + "type": "string", + "description": "[Output Only] A warning data value corresponding to the key." + } + } + } + }, + "message": { + "type": "string", + "description": "[Output Only] A human-readable description of the warning code." + } + } + } + } + }, "Quota": { "id": "Quota", "type": "object", @@ -17828,14 +19421,18 @@ "AUTOSCALERS", "BACKEND_BUCKETS", "BACKEND_SERVICES", + "C2D_CPUS", "C2_CPUS", "COMMITMENTS", "COMMITTED_A2_CPUS", + "COMMITTED_C2D_CPUS", "COMMITTED_C2_CPUS", "COMMITTED_CPUS", + "COMMITTED_E2_CPUS", "COMMITTED_LICENSES", "COMMITTED_LOCAL_SSD_TOTAL_GB", "COMMITTED_MEMORY_OPTIMIZED_CPUS", + "COMMITTED_N2A_CPUS", "COMMITTED_N2D_CPUS", "COMMITTED_N2_CPUS", "COMMITTED_NVIDIA_A100_GPUS", @@ -17847,6 +19444,7 @@ "CPUS", "CPUS_ALL_REGIONS", "DISKS_TOTAL_GB", + "E2_CPUS", "EXTERNAL_NETWORK_LB_FORWARDING_RULES", "EXTERNAL_PROTOCOL_FORWARDING_RULES", "EXTERNAL_VPN_GATEWAYS", @@ -17874,6 +19472,7 @@ "M1_CPUS", "M2_CPUS", "MACHINE_IMAGES", + "N2A_CPUS", "N2D_CPUS", "N2_CPUS", "NETWORKS", @@ -17891,6 +19490,7 @@ "NVIDIA_T4_VWS_GPUS", "NVIDIA_V100_GPUS", "PACKET_MIRRORINGS", + "PD_EXTREME_TOTAL_PROVISIONED_IOPS", "PREEMPTIBLE_CPUS", "PREEMPTIBLE_LOCAL_SSD_GB", "PREEMPTIBLE_NVIDIA_A100_GPUS", @@ -18040,6 +19640,13 @@ "", "", "", + "", + "", + "", + "", + "", + "", + "", "" ] }, @@ -18132,6 +19739,10 @@ "" ] }, + "supportsPzs": { + "type": "boolean", + "description": "[Output Only] Reserved for future use." + }, "zones": { "type": "array", "description": "[Output Only] A list of zones available in this region, in the form of resource URLs.", @@ -19333,6 +20944,10 @@ ] } }, + "satisfiesPzs": { + "type": "boolean", + "description": "[Output Only] Reserved for future use." + }, "selfLink": { "type": "string", "description": "[Output Only] Server-defined fully-qualified URL for this resource." @@ -19914,6 +21529,10 @@ "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", "format": "uint64" }, + "instanceSchedulePolicy": { + "$ref": "ResourcePolicyInstanceSchedulePolicy", + "description": "Resource policy for scheduling instance operations." + }, "kind": { "type": "string", "description": "[Output Only] Type of the resource. Always compute#resource_policies for resource policies.", @@ -19932,6 +21551,10 @@ "region": { "type": "string" }, + "resourceStatus": { + "$ref": "ResourcePolicyResourceStatus", + "description": "[Output Only] The system status of the resource policy." + }, "selfLink": { "type": "string", "description": "[Output Only] Server-defined fully-qualified URL for this resource." @@ -19946,6 +21569,7 @@ "enum": [ "CREATING", "DELETING", + "EXPIRED", "INVALID", "READY" ], @@ -19953,6 +21577,7 @@ "", "", "", + "", "" ] } @@ -20154,6 +21779,44 @@ } } }, + "ResourcePolicyInstanceSchedulePolicy": { + "id": "ResourcePolicyInstanceSchedulePolicy", + "type": "object", + "description": "An InstanceSchedulePolicy specifies when and how frequent certain operations are performed on the instance.", + "properties": { + "expirationTime": { + "type": "string", + "description": "The expiration time of the schedule. The timestamp is an RFC3339 string." + }, + "startTime": { + "type": "string", + "description": "The start time of the schedule. The timestamp is an RFC3339 string." + }, + "timeZone": { + "type": "string", + "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: http://en.wikipedia.org/wiki/Tz_database." + }, + "vmStartSchedule": { + "$ref": "ResourcePolicyInstanceSchedulePolicySchedule", + "description": "Specifies the schedule for starting instances." + }, + "vmStopSchedule": { + "$ref": "ResourcePolicyInstanceSchedulePolicySchedule", + "description": "Specifies the schedule for stopping instances." + } + } + }, + "ResourcePolicyInstanceSchedulePolicySchedule": { + "id": "ResourcePolicyInstanceSchedulePolicySchedule", + "type": "object", + "description": "Schedule for an instance operation.", + "properties": { + "schedule": { + "type": "string", + "description": "Specifies the frequency for the operation, using the unix-cron format." + } + } + }, "ResourcePolicyList": { "id": "ResourcePolicyList", "type": "object", @@ -20272,6 +21935,31 @@ } } }, + "ResourcePolicyResourceStatus": { + "id": "ResourcePolicyResourceStatus", + "type": "object", + "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.", + "properties": { + "instanceSchedulePolicy": { + "$ref": "ResourcePolicyResourceStatusInstanceSchedulePolicyStatus", + "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." + } + } + }, + "ResourcePolicyResourceStatusInstanceSchedulePolicyStatus": { + "id": "ResourcePolicyResourceStatusInstanceSchedulePolicyStatus", + "type": "object", + "properties": { + "lastRunStartTime": { + "type": "string", + "description": "[Output Only] The last time the schedule successfully ran. The timestamp is an RFC3339 string." + }, + "nextRunStartTime": { + "type": "string", + "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." + } + } + }, "ResourcePolicySnapshotSchedulePolicy": { "id": "ResourcePolicySnapshotSchedulePolicy", "type": "object", @@ -20749,6 +22437,10 @@ "type": "string", "description": "An optional description of this resource. Provide this property when you create the resource." }, + "encryptedInterconnectRouter": { + "type": "boolean", + "description": "Field to indicate if a router is dedicated to use with encrypted Interconnect Attachment (IPsec-encrypted Cloud Interconnect feature).\nNot currently available in all Interconnect locations." + }, "id": { "type": "string", "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", @@ -21003,7 +22695,7 @@ }, "advertisedGroups": { "type": "array", - "description": "User-specified list of prefix groups to advertise in custom mode, which can take one of the following options: \n- ALL_SUBNETS: Advertises all available subnets, including peer VPC subnets. \n- ALL_VPC_SUBNETS: Advertises the router's own VPC subnets. \n- ALL_PEER_VPC_SUBNETS: Advertises peer subnets of the router's VPC network. 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.", + "description": "User-specified list of prefix groups to advertise in custom mode, which can take one of the following options: \n- ALL_SUBNETS: Advertises all available subnets, including peer VPC subnets. \n- ALL_VPC_SUBNETS: Advertises the router's own VPC subnets. 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.", "items": { "type": "string", "enum": [ @@ -21768,10 +23460,40 @@ } } }, + "ScalingScheduleStatus": { + "id": "ScalingScheduleStatus", + "type": "object", + "properties": { + "lastStartTime": { + "type": "string", + "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." + }, + "nextStartTime": { + "type": "string", + "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." + }, + "state": { + "type": "string", + "description": "[Output Only] The current state of a scaling schedule.", + "enum": [ + "ACTIVE", + "DISABLED", + "OBSOLETE", + "READY" + ], + "enumDescriptions": [ + "", + "", + "", + "" + ] + } + } + }, "Scheduling": { "id": "Scheduling", "type": "object", - "description": "Sets the scheduling options for an Instance. NextID: 13", + "description": "Sets the scheduling options for an Instance. NextID: 20", "properties": { "automaticRestart": { "type": "boolean", @@ -22050,7 +23772,7 @@ "properties": { "action": { "type": "string", - "description": "The Action to preform when the client connection triggers the rule. Can currently be either \"allow\" or \"deny()\" where valid values for status are 403, 404, and 502." + "description": "The Action to perform when the client connection triggers the rule. Can currently be either \"allow\" or \"deny()\" where valid values for status are 403, 404, and 502." }, "description": { "type": "string", @@ -22348,11 +24070,19 @@ "type": "string" } }, + "locationHint": { + "type": "string", + "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." + }, "name": { "type": "string", "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])?" }, + "satisfiesPzs": { + "type": "boolean", + "description": "[Output Only] Reserved for future use." + }, "selfLink": { "type": "string", "description": "[Output Only] Server-defined URL for the resource." @@ -22897,7 +24627,7 @@ }, "domains": { "type": "array", - "description": "The domains for which a managed SSL certificate will be generated. Currently only single-domain certs are supported.", + "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).", "items": { "type": "string" } @@ -23419,7 +25149,7 @@ }, "ipCidrRange": { "type": "string", - "description": "The range of internal addresses that are owned by this subnetwork. Provide this property when you create the subnetwork. For example, 10.0.0.0/8 or 100.64.0.0/10. Ranges must be unique and non-overlapping within a network. Only IPv4 is supported. This field is set at resource creation time. This may be a RFC 1918 IP range, or a privately routed, non-RFC 1918 IP range, not belonging to Google. The range can be expanded after creation using expandIpCidrRange." + "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." }, "ipv6CidrRange": { "type": "string", @@ -23504,7 +25234,7 @@ }, "state": { "type": "string", - "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 CREATING: Subnetwork is provisioning DELETING: Subnetwork is being deleted UPDATING: Subnetwork is being updated", + "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", "enum": [ "DRAINING", "READY" @@ -23795,7 +25525,7 @@ }, "metadata": { "type": "string", - "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 INCLUDE_ALL_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.", "enum": [ "CUSTOM_METADATA", "EXCLUDE_ALL_METADATA", @@ -23823,7 +25553,7 @@ "properties": { "ipCidrRange": { "type": "string", - "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. This may be a RFC 1918 IP range, or a privately, non-RFC 1918 IP range, not belonging to Google." + "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." }, "rangeName": { "type": "string", @@ -24019,7 +25749,7 @@ "TargetGrpcProxy": { "id": "TargetGrpcProxy", "type": "object", - "description": "Represents a Target gRPC Proxy resource.\n\nA target gRPC proxy is a component of load balancers intended for load balancing gRPC traffic. Global forwarding rules reference a target gRPC proxy. The Target gRPC Proxy references a URL map which specifies how traffic routes to gRPC backend services. (== resource_for {$api_version}.targetGrpcProxies ==)", + "description": "Represents a Target gRPC Proxy resource.\n\nA 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. (== resource_for {$api_version}.targetGrpcProxies ==)", "properties": { "creationTimestamp": { "type": "string", @@ -24638,6 +26368,11 @@ "type": "string", "description": "An optional description of this resource. Provide this property when you create the resource." }, + "fingerprint": { + "type": "string", + "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.", + "format": "byte" + }, "id": { "type": "string", "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", @@ -24659,7 +26394,7 @@ }, "quicOverride": { "type": "string", - "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. \n- When quic-override is set to NONE, Google manages whether QUIC is used. \n- When quic-override is set to ENABLE, the load balancer uses QUIC when possible. \n- When quic-override is set to DISABLE, the load balancer doesn't use QUIC. \n- If the quic-override flag is not specified, NONE is implied.\n-", + "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. \n- When quic-override is set to NONE, Google manages whether QUIC is used. \n- When quic-override is set to ENABLE, the load balancer uses QUIC when possible. \n- When quic-override is set to DISABLE, the load balancer doesn't use QUIC. \n- If the quic-override flag is not specified, NONE is implied.", "enum": [ "DISABLE", "ENABLE", @@ -25352,7 +27087,7 @@ }, "healthChecks": { "type": "array", - "description": "The URL of the HttpHealthCheck resource. A member instance in this pool is considered healthy if and only if the health checks pass. An empty list means all member instances will be considered healthy at all times. Only legacy HttpHealthChecks are supported. Only one health check may be specified.", + "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.", "items": { "type": "string" } @@ -25392,6 +27127,7 @@ "description": "Session affinity option, must be one of the following values:\nNONE: Connections from the same client IP may go to any instance in the pool.\nCLIENT_IP: Connections from the same client IP will go to the same instance in the pool while that instance remains healthy.\nCLIENT_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.", "enum": [ "CLIENT_IP", + "CLIENT_IP_NO_DESTINATION", "CLIENT_IP_PORT_PROTO", "CLIENT_IP_PROTO", "GENERATED_COOKIE", @@ -25406,6 +27142,7 @@ "", "", "", + "", "" ] } @@ -26100,6 +27837,10 @@ "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])?" }, + "proxyBind": { + "type": "boolean", + "description": "This field only applies when the forwarding rule that references this target proxy has a loadBalancingScheme set to INTERNAL_SELF_MANAGED.\n\nWhen 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.\n\nThe default is false." + }, "proxyHeader": { "type": "string", "description": "Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE.", @@ -26657,279 +28398,335 @@ } } }, - "TestFailure": { - "id": "TestFailure", - "type": "object", - "properties": { - "actualService": { - "type": "string", - "description": "BackendService or BackendBucket returned by load balancer." - }, - "expectedService": { - "type": "string", - "description": "Expected BackendService or BackendBucket resource the given URL should be mapped to." - }, - "host": { - "type": "string", - "description": "Host portion of the URL." - }, - "path": { - "type": "string", - "description": "Path portion including query parameters in the URL." - } - } - }, - "TestPermissionsRequest": { - "id": "TestPermissionsRequest", - "type": "object", - "properties": { - "permissions": { - "type": "array", - "description": "The set of permissions to check for the 'resource'. Permissions with wildcards (such as '*' or 'storage.*') are not allowed.", - "items": { - "type": "string" - } - } - } - }, - "TestPermissionsResponse": { - "id": "TestPermissionsResponse", + "TestFailure": { + "id": "TestFailure", + "type": "object", + "properties": { + "actualOutputUrl": { + "type": "string", + "description": "The actual output URL evaluated by load balancer containing the scheme, host, path and query parameters." + }, + "actualRedirectResponseCode": { + "type": "integer", + "description": "Actual HTTP status code for rule with `urlRedirect` calculated by load balancer", + "format": "int32" + }, + "actualService": { + "type": "string", + "description": "BackendService or BackendBucket returned by load balancer." + }, + "expectedOutputUrl": { + "type": "string", + "description": "The expected output URL evaluated by load balancer containing the scheme, host, path and query parameters." + }, + "expectedRedirectResponseCode": { + "type": "integer", + "description": "Expected HTTP status code for rule with `urlRedirect` calculated by load balancer", + "format": "int32" + }, + "expectedService": { + "type": "string", + "description": "Expected BackendService or BackendBucket resource the given URL should be mapped to." + }, + "headers": { + "type": "array", + "description": "HTTP headers of the request.", + "items": { + "$ref": "UrlMapTestHeader" + } + }, + "host": { + "type": "string", + "description": "Host portion of the URL." + }, + "path": { + "type": "string", + "description": "Path portion including query parameters in the URL." + } + } + }, + "TestPermissionsRequest": { + "id": "TestPermissionsRequest", + "type": "object", + "properties": { + "permissions": { + "type": "array", + "description": "The set of permissions to check for the 'resource'. Permissions with wildcards (such as '*' or 'storage.*') are not allowed.", + "items": { + "type": "string" + } + } + } + }, + "TestPermissionsResponse": { + "id": "TestPermissionsResponse", + "type": "object", + "properties": { + "permissions": { + "type": "array", + "description": "A subset of `TestPermissionsRequest.permissions` that the caller is allowed.", + "items": { + "type": "string" + } + } + } + }, + "UrlMap": { + "id": "UrlMap", + "type": "object", + "description": "Represents a URL Map resource.\n\nGoogle Compute Engine has two URL Map resources:\n\n* [Global](/compute/docs/reference/rest/{$api_version}/urlMaps) * [Regional](/compute/docs/reference/rest/{$api_version}/regionUrlMaps)\n\nA URL map resource is a component of certain types of GCP load balancers and Traffic Director.\n\n* urlMaps are used by external HTTP(S) load balancers and Traffic Director. * regionUrlMaps are used by internal HTTP(S) load balancers.\n\nFor a list of supported URL map features by load balancer type, see the Load balancing features: Routing and traffic management table.\n\nFor a list of supported URL map features for Traffic Director, see the Traffic Director features: Routing and traffic management table.\n\nThis resource defines mappings from host names and URL paths to either a backend service or a backend bucket.\n\nTo use the global urlMaps resource, the backend service must have a loadBalancingScheme of either EXTERNAL or INTERNAL_SELF_MANAGED. To use the regionUrlMaps resource, the backend service must have a loadBalancingScheme of INTERNAL_MANAGED. For more information, read URL Map Concepts.", + "properties": { + "creationTimestamp": { + "type": "string", + "description": "[Output Only] Creation timestamp in RFC3339 text format." + }, + "defaultRouteAction": { + "$ref": "HttpRouteAction", + "description": "defaultRouteAction takes effect when none of the hostRules match. The load balancer performs advanced routing actions like URL rewrites, header transformations, etc. prior to forwarding the request to the selected backend. If defaultRouteAction specifies any weightedBackendServices, defaultService must not be set. Conversely if defaultService is set, defaultRouteAction cannot contain any weightedBackendServices.\nOnly one of defaultRouteAction or defaultUrlRedirect must be set.\nUrlMaps for external HTTP(S) load balancers support only the urlRewrite action within defaultRouteAction.\ndefaultRouteAction has no effect when the URL map is bound to target gRPC proxy that has validateForProxyless field set to true." + }, + "defaultService": { + "type": "string", + "description": "The full or partial URL of the defaultService resource to which traffic is directed if none of the hostRules match. If defaultRouteAction is additionally specified, advanced routing actions like URL Rewrites, etc. take effect prior to sending the request to the backend. However, if defaultService is specified, defaultRouteAction cannot contain any weightedBackendServices. Conversely, if routeAction specifies any weightedBackendServices, service must not be specified.\nOnly one of defaultService, defaultUrlRedirect or defaultRouteAction.weightedBackendService must be set.\ndefaultService has no effect when the URL map is bound to target gRPC proxy that has validateForProxyless field set to true." + }, + "defaultUrlRedirect": { + "$ref": "HttpRedirectAction", + "description": "When none of the specified hostRules match, the request is redirected to a URL specified by defaultUrlRedirect.\nIf defaultUrlRedirect is specified, defaultService or defaultRouteAction must not be set.\nNot supported when the URL map is bound to target gRPC proxy." + }, + "description": { + "type": "string", + "description": "An optional description of this resource. Provide this property when you create the resource." + }, + "fingerprint": { + "type": "string", + "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 UrlMap. An up-to-date fingerprint must be provided in order to update the UrlMap, otherwise the request will fail with error 412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to retrieve a UrlMap.", + "format": "byte" + }, + "headerAction": { + "$ref": "HttpHeaderAction", + "description": "Specifies changes to request and response headers that need to take effect for the selected backendService.\nThe headerAction specified here take effect after headerAction specified under pathMatcher.\nNote that headerAction is not supported for Loadbalancers that have their loadBalancingScheme set to EXTERNAL.\nNot supported when the URL map is bound to target gRPC proxy that has validateForProxyless field set to true." + }, + "hostRules": { + "type": "array", + "description": "The list of HostRules to use against the URL.", + "items": { + "$ref": "HostRule" + } + }, + "id": { + "type": "string", + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "format": "uint64" + }, + "kind": { + "type": "string", + "description": "[Output Only] Type of the resource. Always compute#urlMaps for url maps.", + "default": "compute#urlMap" + }, + "name": { + "type": "string", + "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])?" + }, + "pathMatchers": { + "type": "array", + "description": "The list of named PathMatchers to use against the URL.", + "items": { + "$ref": "PathMatcher" + } + }, + "region": { + "type": "string", + "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." + }, + "selfLink": { + "type": "string", + "description": "[Output Only] Server-defined URL for the resource." + }, + "tests": { + "type": "array", + "description": "The list of expected URL mapping tests. Request to update this UrlMap will succeed only if all of the test cases pass. You can specify a maximum of 100 tests per UrlMap.\nNot supported when the URL map is bound to target gRPC proxy that has validateForProxyless field set to true.", + "items": { + "$ref": "UrlMapTest" + } + } + } + }, + "UrlMapList": { + "id": "UrlMapList", + "type": "object", + "description": "Contains a list of UrlMap resources.", + "properties": { + "id": { + "type": "string", + "description": "[Output Only] Unique identifier for the resource; defined by the server." + }, + "items": { + "type": "array", + "description": "A list of UrlMap resources.", + "items": { + "$ref": "UrlMap" + } + }, + "kind": { + "type": "string", + "description": "Type of resource.", + "default": "compute#urlMapList" + }, + "nextPageToken": { + "type": "string", + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results." + }, + "selfLink": { + "type": "string", + "description": "[Output Only] Server-defined URL for this resource." + }, + "warning": { + "type": "object", + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "type": "string", + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are 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", + "LARGE_DEPLOYMENT_WARNING", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "" + ] + }, + "data": { + "type": "array", + "description": "[Output Only] Metadata about this warning in key: value format. For example:\n\"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" }", + "items": { + "type": "object", + "properties": { + "key": { + "type": "string", + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding)." + }, + "value": { + "type": "string", + "description": "[Output Only] A warning data value corresponding to the key." + } + } + } + }, + "message": { + "type": "string", + "description": "[Output Only] A human-readable description of the warning code." + } + } + } + } + }, + "UrlMapReference": { + "id": "UrlMapReference", "type": "object", "properties": { - "permissions": { - "type": "array", - "description": "A subset of `TestPermissionsRequest.permissions` that the caller is allowed.", - "items": { - "type": "string" - } + "urlMap": { + "type": "string" } } }, - "UrlMap": { - "id": "UrlMap", + "UrlMapTest": { + "id": "UrlMapTest", "type": "object", - "description": "Represents a URL Map resource.\n\nGoogle Compute Engine has two URL Map resources:\n\n* [Global](/compute/docs/reference/rest/{$api_version}/urlMaps) * [Regional](/compute/docs/reference/rest/{$api_version}/regionUrlMaps)\n\nA URL map resource is a component of certain types of GCP load balancers and Traffic Director.\n\n* urlMaps are used by external HTTP(S) load balancers and Traffic Director. * regionUrlMaps are used by internal HTTP(S) load balancers.\n\nFor a list of supported URL map features by load balancer type, see the Load balancing features: Routing and traffic management table.\n\nFor a list of supported URL map features for Traffic Director, see the Traffic Director features: Routing and traffic management table.\n\nThis resource defines mappings from host names and URL paths to either a backend service or a backend bucket.\n\nTo use the global urlMaps resource, the backend service must have a loadBalancingScheme of either EXTERNAL or INTERNAL_SELF_MANAGED. To use the regionUrlMaps resource, the backend service must have a loadBalancingScheme of INTERNAL_MANAGED. For more information, read URL Map Concepts.", + "description": "Message for the expected URL mappings.", "properties": { - "creationTimestamp": { - "type": "string", - "description": "[Output Only] Creation timestamp in RFC3339 text format." - }, - "defaultRouteAction": { - "$ref": "HttpRouteAction", - "description": "defaultRouteAction takes effect when none of the hostRules match. The load balancer performs advanced routing actions like URL rewrites, header transformations, etc. prior to forwarding the request to the selected backend. If defaultRouteAction specifies any weightedBackendServices, defaultService must not be set. Conversely if defaultService is set, defaultRouteAction cannot contain any weightedBackendServices.\nOnly one of defaultRouteAction or defaultUrlRedirect must be set.\nUrlMaps for external HTTP(S) load balancers support only the urlRewrite action within defaultRouteAction.\ndefaultRouteAction has no effect when the URL map is bound to target gRPC proxy that has validateForProxyless field set to true." - }, - "defaultService": { - "type": "string", - "description": "The full or partial URL of the defaultService resource to which traffic is directed if none of the hostRules match. If defaultRouteAction is additionally specified, advanced routing actions like URL Rewrites, etc. take effect prior to sending the request to the backend. However, if defaultService is specified, defaultRouteAction cannot contain any weightedBackendServices. Conversely, if routeAction specifies any weightedBackendServices, service must not be specified.\nOnly one of defaultService, defaultUrlRedirect or defaultRouteAction.weightedBackendService must be set.\ndefaultService has no effect when the URL map is bound to target gRPC proxy that has validateForProxyless field set to true." - }, - "defaultUrlRedirect": { - "$ref": "HttpRedirectAction", - "description": "When none of the specified hostRules match, the request is redirected to a URL specified by defaultUrlRedirect.\nIf defaultUrlRedirect is specified, defaultService or defaultRouteAction must not be set.\nNot supported when the URL map is bound to target gRPC proxy." - }, "description": { "type": "string", - "description": "An optional description of this resource. Provide this property when you create the resource." - }, - "fingerprint": { - "type": "string", - "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 UrlMap. An up-to-date fingerprint must be provided in order to update the UrlMap, otherwise the request will fail with error 412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to retrieve a UrlMap.", - "format": "byte" - }, - "headerAction": { - "$ref": "HttpHeaderAction", - "description": "Specifies changes to request and response headers that need to take effect for the selected backendService.\nThe headerAction specified here take effect after headerAction specified under pathMatcher.\nNote that headerAction is not supported for Loadbalancers that have their loadBalancingScheme set to EXTERNAL.\nNot supported when the URL map is bound to target gRPC proxy that has validateForProxyless field set to true." - }, - "hostRules": { - "type": "array", - "description": "The list of HostRules to use against the URL.", - "items": { - "$ref": "HostRule" - } - }, - "id": { - "type": "string", - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "format": "uint64" - }, - "kind": { - "type": "string", - "description": "[Output Only] Type of the resource. Always compute#urlMaps for url maps.", - "default": "compute#urlMap" - }, - "name": { - "type": "string", - "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])?" - }, - "pathMatchers": { - "type": "array", - "description": "The list of named PathMatchers to use against the URL.", - "items": { - "$ref": "PathMatcher" - } - }, - "region": { - "type": "string", - "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." + "description": "Description of this test case." }, - "selfLink": { + "expectedOutputUrl": { "type": "string", - "description": "[Output Only] Server-defined URL for the resource." + "description": "The expected output URL evaluated by load balancer containing the scheme, host, path and query parameters.\nFor rules that forward requests to backends, the test passes only when expectedOutputUrl matches the request forwarded by 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.\nFor 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.\nexpectedOutputUrl is optional when service is specified." }, - "tests": { - "type": "array", - "description": "The list of expected URL mapping tests. Request to update this UrlMap will succeed only if all of the test cases pass. You can specify a maximum of 100 tests per UrlMap.\nNot supported when the URL map is bound to target gRPC proxy that has validateForProxyless field set to true.", - "items": { - "$ref": "UrlMapTest" - } - } - } - }, - "UrlMapList": { - "id": "UrlMapList", - "type": "object", - "description": "Contains a list of UrlMap resources.", - "properties": { - "id": { - "type": "string", - "description": "[Output Only] Unique identifier for the resource; defined by the server." + "expectedRedirectResponseCode": { + "type": "integer", + "description": "For rules with urlRedirect, the test passes only if expectedRedirectResponseCode matches the HTTP status code in load balancer's redirect response.\nexpectedRedirectResponseCode cannot be set when service is set.", + "format": "int32" }, - "items": { + "headers": { "type": "array", - "description": "A list of UrlMap resources.", + "description": "HTTP headers for this request. If headers contains a host header, then host must also match the header value.", "items": { - "$ref": "UrlMap" + "$ref": "UrlMapTestHeader" } }, - "kind": { + "host": { "type": "string", - "description": "Type of resource.", - "default": "compute#urlMapList" + "description": "Host portion of the URL. If headers contains a host header, then host must also match the header value." }, - "nextPageToken": { + "path": { "type": "string", - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results." + "description": "Path portion of the URL." }, - "selfLink": { + "service": { "type": "string", - "description": "[Output Only] Server-defined URL for this resource." - }, - "warning": { - "type": "object", - "description": "[Output Only] Informational warning message.", - "properties": { - "code": { - "type": "string", - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are 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", - "LARGE_DEPLOYMENT_WARNING", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ], - "enumDescriptions": [ - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "" - ] - }, - "data": { - "type": "array", - "description": "[Output Only] Metadata about this warning in key: value format. For example:\n\"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" }", - "items": { - "type": "object", - "properties": { - "key": { - "type": "string", - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding)." - }, - "value": { - "type": "string", - "description": "[Output Only] A warning data value corresponding to the key." - } - } - } - }, - "message": { - "type": "string", - "description": "[Output Only] A human-readable description of the warning code." - } - } - } - } - }, - "UrlMapReference": { - "id": "UrlMapReference", - "type": "object", - "properties": { - "urlMap": { - "type": "string" + "description": "Expected BackendService or BackendBucket resource the given URL should be mapped to.\nservice cannot be set if expectedRedirectResponseCode is set." } } }, - "UrlMapTest": { - "id": "UrlMapTest", + "UrlMapTestHeader": { + "id": "UrlMapTestHeader", "type": "object", - "description": "Message for the expected URL mappings.", + "description": "HTTP headers used in UrlMapTests.", "properties": { - "description": { - "type": "string", - "description": "Description of this test case." - }, - "host": { - "type": "string", - "description": "Host portion of the URL. If headers contains a host header, then host must also match the header value." - }, - "path": { + "name": { "type": "string", - "description": "Path portion of the URL." + "description": "Header name." }, - "service": { + "value": { "type": "string", - "description": "Expected BackendService or BackendBucket resource the given URL should be mapped to.\nservice cannot be set if expectedRedirectResponseCode is set." + "description": "Header value." } } }, @@ -27967,6 +29764,10 @@ "description": "The numeric ID of this VPN gateway interface.", "format": "uint32" }, + "interconnectAttachment": { + "type": "string", + "description": "URL of the interconnect attachment resource. When the value of this field is present, the VPN Gateway will be used for IPsec-encrypted Cloud Interconnect; all Egress or Ingress traffic for this VPN Gateway interface will go through the specified interconnect attachment resource.\nNot currently available in all Interconnect locations." + }, "ipAddress": { "type": "string", "description": "[Output Only] The external IP address for this VPN gateway interface." @@ -28175,7 +29976,7 @@ }, "status": { "type": "string", - "description": "[Output Only] The status of the VPN tunnel, which can be one of the following: \n- PROVISIONING: Resource is being allocated for the VPN tunnel. \n- 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. \n- FIRST_HANDSHAKE: Successful first handshake with the peer VPN. \n- ESTABLISHED: Secure session is successfully established with the peer VPN. \n- NETWORK_ERROR: Deprecated, replaced by NO_INCOMING_PACKETS \n- AUTHORIZATION_ERROR: Auth error (for example, bad shared secret). \n- NEGOTIATION_FAILURE: Handshake failed. \n- DEPROVISIONING: Resources are being deallocated for the VPN tunnel. \n- FAILED: Tunnel creation has failed and the tunnel is not ready to be used. \n- NO_INCOMING_PACKETS: No incoming packets from peer. \n- REJECTED: Tunnel configuration was rejected, can be result of being blacklisted. \n- ALLOCATING_RESOURCES: Cloud VPN is in the process of allocating all required resources. \n- STOPPED: Tunnel is stopped due to its Forwarding Rules being deleted for Classic VPN tunnels or the project is in frozen state. \n- PEER_IDENTITY_MISMATCH: Peer identity does not match peer IP, probably behind NAT. \n- TS_NARROWING_NOT_ALLOWED: Traffic selector narrowing not allowed for an HA-VPN tunnel.", + "description": "[Output Only] The status of the VPN tunnel, which can be one of the following: \n- PROVISIONING: Resource is being allocated for the VPN tunnel. \n- 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. \n- FIRST_HANDSHAKE: Successful first handshake with the peer VPN. \n- ESTABLISHED: Secure session is successfully established with the peer VPN. \n- NETWORK_ERROR: Deprecated, replaced by NO_INCOMING_PACKETS \n- AUTHORIZATION_ERROR: Auth error (for example, bad shared secret). \n- NEGOTIATION_FAILURE: Handshake failed. \n- DEPROVISIONING: Resources are being deallocated for the VPN tunnel. \n- FAILED: Tunnel creation has failed and the tunnel is not ready to be used. \n- NO_INCOMING_PACKETS: No incoming packets from peer. \n- REJECTED: Tunnel configuration was rejected, can be result of being denied access. \n- ALLOCATING_RESOURCES: Cloud VPN is in the process of allocating all required resources. \n- STOPPED: Tunnel is stopped due to its Forwarding Rules being deleted for Classic VPN tunnels or the project is in frozen state. \n- PEER_IDENTITY_MISMATCH: Peer identity does not match peer IP, probably behind NAT. \n- TS_NARROWING_NOT_ALLOWED: Traffic selector narrowing not allowed for an HA-VPN tunnel.", "enum": [ "ALLOCATING_RESOURCES", "AUTHORIZATION_ERROR", @@ -28808,6 +30609,10 @@ "", "" ] + }, + "supportsPzs": { + "type": "boolean", + "description": "[Output Only] Reserved for future use." } } }, @@ -29014,7 +30819,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -29110,7 +30915,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" }, "zone": { @@ -29181,7 +30986,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -29371,7 +31176,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -29435,7 +31240,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -29618,7 +31423,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" }, "zone": { @@ -29967,7 +31772,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -30152,7 +31957,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -30391,7 +32196,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -30452,7 +32257,7 @@ "id": "compute.backendServices.setSecurityPolicy", "path": "projects/{project}/global/backendServices/{backendService}/setSecurityPolicy", "httpMethod": "POST", - "description": "Sets the security policy for the specified backend service.", + "description": "Sets the Google Cloud Armor security policy for the specified backend service. For more information, see Google Cloud Armor Overview", "parameters": { "backendService": { "type": "string", @@ -30576,7 +32381,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -30672,7 +32477,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" }, "zone": { @@ -30792,7 +32597,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -31017,7 +32822,7 @@ }, "sourceImage": { "type": "string", - "description": "Optional. Source image to restore onto a disk.", + "description": "Source image to restore onto a disk. This field is optional.", "location": "query" }, "zone": { @@ -31081,7 +32886,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" }, "zone": { @@ -31479,24 +33284,435 @@ "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", "location": "query" }, - "project": { + "project": { + "type": "string", + "description": "Project ID for this request.", + "required": true, + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path" + }, + "returnPartialSuccess": { + "type": "boolean", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", + "location": "query" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "ExternalVpnGatewayList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "setLabels": { + "id": "compute.externalVpnGateways.setLabels", + "path": "projects/{project}/global/externalVpnGateways/{resource}/setLabels", + "httpMethod": "POST", + "description": "Sets the labels on an ExternalVpnGateway. To learn more about labels, read the Labeling Resources documentation.", + "parameters": { + "project": { + "type": "string", + "description": "Project ID for this request.", + "required": true, + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path" + }, + "resource": { + "type": "string", + "description": "Name or id of the resource for this request.", + "required": true, + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path" + } + }, + "parameterOrder": [ + "project", + "resource" + ], + "request": { + "$ref": "GlobalSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "testIamPermissions": { + "id": "compute.externalVpnGateways.testIamPermissions", + "path": "projects/{project}/global/externalVpnGateways/{resource}/testIamPermissions", + "httpMethod": "POST", + "description": "Returns permissions that a caller has on the specified resource.", + "parameters": { + "project": { + "type": "string", + "description": "Project ID for this request.", + "required": true, + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path" + }, + "resource": { + "type": "string", + "description": "Name or id of the resource for this request.", + "required": true, + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path" + } + }, + "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" + ] + } + } + }, + "firewallPolicies": { + "methods": { + "addAssociation": { + "id": "compute.firewallPolicies.addAssociation", + "path": "locations/global/firewallPolicies/{firewallPolicy}/addAssociation", + "httpMethod": "POST", + "description": "Inserts an association for the specified firewall policy.", + "parameters": { + "firewallPolicy": { + "type": "string", + "description": "Name of the firewall policy to update.", + "required": true, + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "location": "path" + }, + "replaceExistingAssociation": { + "type": "boolean", + "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" + }, + "requestId": { + "type": "string", + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.\n\nFor example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query" + } + }, + "parameterOrder": [ + "firewallPolicy" + ], + "request": { + "$ref": "FirewallPolicyAssociation" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "addRule": { + "id": "compute.firewallPolicies.addRule", + "path": "locations/global/firewallPolicies/{firewallPolicy}/addRule", + "httpMethod": "POST", + "description": "Inserts a rule into a firewall policy.", + "parameters": { + "firewallPolicy": { + "type": "string", + "description": "Name of the firewall policy to update.", + "required": true, + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "location": "path" + }, + "requestId": { + "type": "string", + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.\n\nFor example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query" + } + }, + "parameterOrder": [ + "firewallPolicy" + ], + "request": { + "$ref": "FirewallPolicyRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "cloneRules": { + "id": "compute.firewallPolicies.cloneRules", + "path": "locations/global/firewallPolicies/{firewallPolicy}/cloneRules", + "httpMethod": "POST", + "description": "Copies rules to the specified firewall policy.", + "parameters": { + "firewallPolicy": { + "type": "string", + "description": "Name of the firewall policy to update.", + "required": true, + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "location": "path" + }, + "requestId": { + "type": "string", + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.\n\nFor example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query" + }, + "sourceFirewallPolicy": { + "type": "string", + "description": "The firewall policy from which to copy rules.", + "location": "query" + } + }, + "parameterOrder": [ + "firewallPolicy" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "delete": { + "id": "compute.firewallPolicies.delete", + "path": "locations/global/firewallPolicies/{firewallPolicy}", + "httpMethod": "DELETE", + "description": "Deletes the specified policy.", + "parameters": { + "firewallPolicy": { + "type": "string", + "description": "Name of the firewall policy to delete.", + "required": true, + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "location": "path" + }, + "requestId": { + "type": "string", + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.\n\nFor example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query" + } + }, + "parameterOrder": [ + "firewallPolicy" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "get": { + "id": "compute.firewallPolicies.get", + "path": "locations/global/firewallPolicies/{firewallPolicy}", + "httpMethod": "GET", + "description": "Returns the specified firewall policy.", + "parameters": { + "firewallPolicy": { + "type": "string", + "description": "Name of the firewall policy to get.", + "required": true, + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "location": "path" + } + }, + "parameterOrder": [ + "firewallPolicy" + ], + "response": { + "$ref": "FirewallPolicy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "getAssociation": { + "id": "compute.firewallPolicies.getAssociation", + "path": "locations/global/firewallPolicies/{firewallPolicy}/getAssociation", + "httpMethod": "GET", + "description": "Gets an association with the specified name.", + "parameters": { + "firewallPolicy": { + "type": "string", + "description": "Name of the firewall policy to which the queried rule belongs.", + "required": true, + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "location": "path" + }, + "name": { + "type": "string", + "description": "The name of the association to get from the firewall policy.", + "location": "query" + } + }, + "parameterOrder": [ + "firewallPolicy" + ], + "response": { + "$ref": "FirewallPolicyAssociation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "getIamPolicy": { + "id": "compute.firewallPolicies.getIamPolicy", + "path": "locations/global/firewallPolicies/{resource}/getIamPolicy", + "httpMethod": "GET", + "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists.", + "parameters": { + "optionsRequestedPolicyVersion": { + "type": "integer", + "description": "Requested IAM Policy version.", + "format": "int32", + "location": "query" + }, + "resource": { + "type": "string", + "description": "Name or id of the resource for this request.", + "required": true, + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "location": "path" + } + }, + "parameterOrder": [ + "resource" + ], + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "getRule": { + "id": "compute.firewallPolicies.getRule", + "path": "locations/global/firewallPolicies/{firewallPolicy}/getRule", + "httpMethod": "GET", + "description": "Gets a rule of the specified priority.", + "parameters": { + "firewallPolicy": { + "type": "string", + "description": "Name of the firewall policy to which the queried rule belongs.", + "required": true, + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "location": "path" + }, + "priority": { + "type": "integer", + "description": "The priority of the rule to get from the firewall policy.", + "format": "int32", + "location": "query" + } + }, + "parameterOrder": [ + "firewallPolicy" + ], + "response": { + "$ref": "FirewallPolicyRule" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "insert": { + "id": "compute.firewallPolicies.insert", + "path": "locations/global/firewallPolicies", + "httpMethod": "POST", + "description": "Creates a new policy in the specified project using the data included in the request.", + "parameters": { + "parentId": { + "type": "string", + "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" + }, + "requestId": { + "type": "string", + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.\n\nFor example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query" + } + }, + "request": { + "$ref": "FirewallPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "list": { + "id": "compute.firewallPolicies.list", + "path": "locations/global/firewallPolicies", + "httpMethod": "GET", + "description": "Lists all the policies that have been configured for the specified project.", + "parameters": { + "filter": { + "type": "string", + "description": "A filter expression that filters resources listed in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either `=`, `!=`, `\u003e`, or `\u003c`.\n\nFor example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`.\n\nYou can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels.\n\nTo filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ```", + "location": "query" + }, + "maxResults": { + "type": "integer", + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "format": "uint32", + "minimum": "0", + "location": "query" + }, + "orderBy": { + "type": "string", + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query" + }, + "pageToken": { + "type": "string", + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query" + }, + "parentId": { "type": "string", - "description": "Project ID for this request.", - "required": true, - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path" + "description": "Parent ID for this request.", + "location": "query" }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, - "parameterOrder": [ - "project" - ], "response": { - "$ref": "ExternalVpnGatewayList" + "$ref": "FirewallPolicyList" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", @@ -31504,33 +33720,85 @@ "https://www.googleapis.com/auth/compute.readonly" ] }, - "setLabels": { - "id": "compute.externalVpnGateways.setLabels", - "path": "projects/{project}/global/externalVpnGateways/{resource}/setLabels", + "listAssociations": { + "id": "compute.firewallPolicies.listAssociations", + "path": "locations/global/firewallPolicies/listAssociations", + "httpMethod": "GET", + "description": "Lists associations of a specified target, i.e., organization or folder.", + "parameters": { + "targetResource": { + "type": "string", + "description": "The target resource to list associations. It is an organization, or a folder.", + "location": "query" + } + }, + "response": { + "$ref": "FirewallPoliciesListAssociationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "move": { + "id": "compute.firewallPolicies.move", + "path": "locations/global/firewallPolicies/{firewallPolicy}/move", "httpMethod": "POST", - "description": "Sets the labels on an ExternalVpnGateway. To learn more about labels, read the Labeling Resources documentation.", + "description": "Moves the specified firewall policy.", "parameters": { - "project": { + "firewallPolicy": { "type": "string", - "description": "Project ID for this request.", + "description": "Name of the firewall policy to update.", "required": true, - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", "location": "path" }, - "resource": { + "parentId": { "type": "string", - "description": "Name or id of the resource for this request.", + "description": "The new parent of the firewall policy.", + "location": "query" + }, + "requestId": { + "type": "string", + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.\n\nFor example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query" + } + }, + "parameterOrder": [ + "firewallPolicy" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "patch": { + "id": "compute.firewallPolicies.patch", + "path": "locations/global/firewallPolicies/{firewallPolicy}", + "httpMethod": "PATCH", + "description": "Patches the specified policy with the data included in the request.", + "parameters": { + "firewallPolicy": { + "type": "string", + "description": "Name of the firewall policy to update.", "required": true, - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", "location": "path" + }, + "requestId": { + "type": "string", + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.\n\nFor example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query" } }, "parameterOrder": [ - "project", - "resource" + "firewallPolicy" ], "request": { - "$ref": "GlobalSetLabelsRequest" + "$ref": "FirewallPolicy" }, "response": { "$ref": "Operation" @@ -31540,29 +33808,159 @@ "https://www.googleapis.com/auth/compute" ] }, - "testIamPermissions": { - "id": "compute.externalVpnGateways.testIamPermissions", - "path": "projects/{project}/global/externalVpnGateways/{resource}/testIamPermissions", + "patchRule": { + "id": "compute.firewallPolicies.patchRule", + "path": "locations/global/firewallPolicies/{firewallPolicy}/patchRule", "httpMethod": "POST", - "description": "Returns permissions that a caller has on the specified resource.", + "description": "Patches a rule of the specified priority.", "parameters": { - "project": { + "firewallPolicy": { "type": "string", - "description": "Project ID for this request.", + "description": "Name of the firewall policy to update.", "required": true, - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "location": "path" + }, + "priority": { + "type": "integer", + "description": "The priority of the rule to patch.", + "format": "int32", + "location": "query" + }, + "requestId": { + "type": "string", + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.\n\nFor example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query" + } + }, + "parameterOrder": [ + "firewallPolicy" + ], + "request": { + "$ref": "FirewallPolicyRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "removeAssociation": { + "id": "compute.firewallPolicies.removeAssociation", + "path": "locations/global/firewallPolicies/{firewallPolicy}/removeAssociation", + "httpMethod": "POST", + "description": "Removes an association for the specified firewall policy.", + "parameters": { + "firewallPolicy": { + "type": "string", + "description": "Name of the firewall policy to update.", + "required": true, + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "location": "path" + }, + "name": { + "type": "string", + "description": "Name for the attachment that will be removed.", + "location": "query" + }, + "requestId": { + "type": "string", + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.\n\nFor example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query" + } + }, + "parameterOrder": [ + "firewallPolicy" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "removeRule": { + "id": "compute.firewallPolicies.removeRule", + "path": "locations/global/firewallPolicies/{firewallPolicy}/removeRule", + "httpMethod": "POST", + "description": "Deletes a rule of the specified priority.", + "parameters": { + "firewallPolicy": { + "type": "string", + "description": "Name of the firewall policy to update.", + "required": true, + "pattern": "(firewallPolicies/)?[0-9]{0,20}", "location": "path" }, + "priority": { + "type": "integer", + "description": "The priority of the rule to remove from the firewall policy.", + "format": "int32", + "location": "query" + }, + "requestId": { + "type": "string", + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.\n\nFor example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query" + } + }, + "parameterOrder": [ + "firewallPolicy" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "setIamPolicy": { + "id": "compute.firewallPolicies.setIamPolicy", + "path": "locations/global/firewallPolicies/{resource}/setIamPolicy", + "httpMethod": "POST", + "description": "Sets the access control policy on the specified resource. Replaces any existing policy.", + "parameters": { "resource": { "type": "string", "description": "Name or id of the resource for this request.", "required": true, - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "location": "path" + } + }, + "parameterOrder": [ + "resource" + ], + "request": { + "$ref": "GlobalOrganizationSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "testIamPermissions": { + "id": "compute.firewallPolicies.testIamPermissions", + "path": "locations/global/firewallPolicies/{resource}/testIamPermissions", + "httpMethod": "POST", + "description": "Returns permissions that a caller has on the specified resource.", + "parameters": { + "resource": { + "type": "string", + "description": "Name or id of the resource for this request.", + "required": true, + "pattern": "(firewallPolicies/)?[0-9]{0,20}", "location": "path" } }, "parameterOrder": [ - "project", "resource" ], "request": { @@ -31724,7 +34122,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -31869,7 +34267,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -32059,7 +34457,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -32125,6 +34523,55 @@ "https://www.googleapis.com/auth/compute" ] }, + "setLabels": { + "id": "compute.forwardingRules.setLabels", + "path": "projects/{project}/regions/{region}/forwardingRules/{resource}/setLabels", + "httpMethod": "POST", + "description": "Sets the labels on the specified resource. To learn more about labels, read the Labeling Resources documentation.", + "parameters": { + "project": { + "type": "string", + "description": "Project ID for this request.", + "required": true, + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path" + }, + "region": { + "type": "string", + "description": "The region for this request.", + "required": true, + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path" + }, + "requestId": { + "type": "string", + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.\n\nFor example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query" + }, + "resource": { + "type": "string", + "description": "Name or id of the resource for this request.", + "required": true, + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path" + } + }, + "parameterOrder": [ + "project", + "region", + "resource" + ], + "request": { + "$ref": "RegionSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, "setTarget": { "id": "compute.forwardingRules.setTarget", "path": "projects/{project}/regions/{region}/forwardingRules/{forwardingRule}/setTarget", @@ -32321,7 +34768,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -32484,7 +34931,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -32541,6 +34988,42 @@ "https://www.googleapis.com/auth/compute" ] }, + "setLabels": { + "id": "compute.globalForwardingRules.setLabels", + "path": "projects/{project}/global/forwardingRules/{resource}/setLabels", + "httpMethod": "POST", + "description": "Sets the labels on the specified resource. To learn more about labels, read the Labeling Resources documentation.", + "parameters": { + "project": { + "type": "string", + "description": "Project ID for this request.", + "required": true, + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path" + }, + "resource": { + "type": "string", + "description": "Name or id of the resource for this request.", + "required": true, + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path" + } + }, + "parameterOrder": [ + "project", + "resource" + ], + "request": { + "$ref": "GlobalSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, "setTarget": { "id": "compute.globalForwardingRules.setTarget", "path": "projects/{project}/global/forwardingRules/{forwardingRule}/setTarget", @@ -32807,7 +35290,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -32867,7 +35350,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -32931,7 +35414,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -33049,7 +35532,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -33197,7 +35680,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -33212,6 +35695,210 @@ } } }, + "globalPublicDelegatedPrefixes": { + "methods": { + "delete": { + "id": "compute.globalPublicDelegatedPrefixes.delete", + "path": "projects/{project}/global/publicDelegatedPrefixes/{publicDelegatedPrefix}", + "httpMethod": "DELETE", + "description": "Deletes the specified global PublicDelegatedPrefix.", + "parameters": { + "project": { + "type": "string", + "description": "Project ID for this request.", + "required": true, + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path" + }, + "publicDelegatedPrefix": { + "type": "string", + "description": "Name of the PublicDelegatedPrefix resource to delete.", + "required": true, + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path" + }, + "requestId": { + "type": "string", + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.\n\nFor example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query" + } + }, + "parameterOrder": [ + "project", + "publicDelegatedPrefix" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "get": { + "id": "compute.globalPublicDelegatedPrefixes.get", + "path": "projects/{project}/global/publicDelegatedPrefixes/{publicDelegatedPrefix}", + "httpMethod": "GET", + "description": "Returns the specified global PublicDelegatedPrefix resource.", + "parameters": { + "project": { + "type": "string", + "description": "Project ID for this request.", + "required": true, + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path" + }, + "publicDelegatedPrefix": { + "type": "string", + "description": "Name of the PublicDelegatedPrefix resource to return.", + "required": true, + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path" + } + }, + "parameterOrder": [ + "project", + "publicDelegatedPrefix" + ], + "response": { + "$ref": "PublicDelegatedPrefix" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "insert": { + "id": "compute.globalPublicDelegatedPrefixes.insert", + "path": "projects/{project}/global/publicDelegatedPrefixes", + "httpMethod": "POST", + "description": "Creates a global PublicDelegatedPrefix in the specified project using the parameters that are included in the request.", + "parameters": { + "project": { + "type": "string", + "description": "Project ID for this request.", + "required": true, + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path" + }, + "requestId": { + "type": "string", + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.\n\nFor example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "PublicDelegatedPrefix" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "list": { + "id": "compute.globalPublicDelegatedPrefixes.list", + "path": "projects/{project}/global/publicDelegatedPrefixes", + "httpMethod": "GET", + "description": "Lists the global PublicDelegatedPrefixes for a project.", + "parameters": { + "filter": { + "type": "string", + "description": "A filter expression that filters resources listed in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either `=`, `!=`, `\u003e`, or `\u003c`.\n\nFor example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`.\n\nYou can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels.\n\nTo filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ```", + "location": "query" + }, + "maxResults": { + "type": "integer", + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "format": "uint32", + "minimum": "0", + "location": "query" + }, + "orderBy": { + "type": "string", + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query" + }, + "pageToken": { + "type": "string", + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query" + }, + "project": { + "type": "string", + "description": "Project ID for this request.", + "required": true, + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path" + }, + "returnPartialSuccess": { + "type": "boolean", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", + "location": "query" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "PublicDelegatedPrefixList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "patch": { + "id": "compute.globalPublicDelegatedPrefixes.patch", + "path": "projects/{project}/global/publicDelegatedPrefixes/{publicDelegatedPrefix}", + "httpMethod": "PATCH", + "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.", + "parameters": { + "project": { + "type": "string", + "description": "Project ID for this request.", + "required": true, + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path" + }, + "publicDelegatedPrefix": { + "type": "string", + "description": "Name of the PublicDelegatedPrefix resource to patch.", + "required": true, + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path" + }, + "requestId": { + "type": "string", + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.\n\nFor example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query" + } + }, + "parameterOrder": [ + "project", + "publicDelegatedPrefix" + ], + "request": { + "$ref": "PublicDelegatedPrefix" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + } + } + }, "healthChecks": { "methods": { "aggregatedList": { @@ -33257,7 +35944,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -33416,7 +36103,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -33661,7 +36348,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -33906,7 +36593,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -34274,7 +36961,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -34534,7 +37221,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -34890,7 +37577,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" }, "zone": { @@ -34957,7 +37644,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" }, "zone": { @@ -35025,7 +37712,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" }, "zone": { @@ -35093,7 +37780,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" }, "zone": { @@ -35215,7 +37902,7 @@ "id": "compute.instanceGroupManagers.recreateInstances", "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/recreateInstances", "httpMethod": "POST", - "description": "Flags the specified instances in the managed instance group to be immediately recreated. The instances are deleted and recreated using the current instance template for the managed instance group. 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 the recreating action with the listmanagedinstances method.\n\nIf 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.\n\nYou can specify a maximum of 1000 instances with this method per request.", + "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.\n\nIf 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.\n\nYou can specify a maximum of 1000 instances with this method per request.", "parameters": { "instanceGroupManager": { "type": "string", @@ -35545,7 +38232,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -35723,7 +38410,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" }, "zone": { @@ -35790,7 +38477,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" }, "zone": { @@ -36098,7 +38785,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -36339,7 +39026,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -36409,11 +39096,52 @@ "https://www.googleapis.com/auth/compute" ] }, + "bulkInsert": { + "id": "compute.instances.bulkInsert", + "path": "projects/{project}/zones/{zone}/instances/bulkInsert", + "httpMethod": "POST", + "description": "Creates multiple instances. Count specifies the number of instances to create.", + "parameters": { + "project": { + "type": "string", + "description": "Project ID for this request.", + "required": true, + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path" + }, + "requestId": { + "type": "string", + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.\n\nFor example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query" + }, + "zone": { + "type": "string", + "description": "The name of the zone for this request.", + "required": true, + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path" + } + }, + "parameterOrder": [ + "project", + "zone" + ], + "request": { + "$ref": "BulkInsertInstanceResource" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, "delete": { "id": "compute.instances.delete", "path": "projects/{project}/zones/{zone}/instances/{instance}", "httpMethod": "DELETE", - "description": "Deletes the specified Instance resource. For more information, see Stopping or Deleting an Instance.", + "description": "Deletes the specified Instance resource. For more information, see Deleting an instance.", "parameters": { "instance": { "type": "string", @@ -36610,6 +39338,55 @@ "https://www.googleapis.com/auth/compute.readonly" ] }, + "getEffectiveFirewalls": { + "id": "compute.instances.getEffectiveFirewalls", + "path": "projects/{project}/zones/{zone}/instances/{instance}/getEffectiveFirewalls", + "httpMethod": "GET", + "description": "Returns effective firewalls applied to an interface of the instance.", + "parameters": { + "instance": { + "type": "string", + "description": "Name of the instance scoping this request.", + "required": true, + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path" + }, + "networkInterface": { + "type": "string", + "description": "The name of the network interface to get the effective firewalls.", + "required": true, + "location": "query" + }, + "project": { + "type": "string", + "description": "Project ID for this request.", + "required": true, + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path" + }, + "zone": { + "type": "string", + "description": "The name of the zone for this request.", + "required": true, + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path" + } + }, + "parameterOrder": [ + "project", + "zone", + "instance", + "networkInterface" + ], + "response": { + "$ref": "InstancesGetEffectiveFirewallsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, "getGuestAttributes": { "id": "compute.instances.getGuestAttributes", "path": "projects/{project}/zones/{zone}/instances/{instance}/getGuestAttributes", @@ -36935,7 +39712,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" }, "zone": { @@ -37004,7 +39781,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" }, "zone": { @@ -38141,7 +40918,7 @@ "id": "compute.instances.updateNetworkInterface", "path": "projects/{project}/zones/{zone}/instances/{instance}/updateNetworkInterface", "httpMethod": "PATCH", - "description": "Updates an instance's network interface. This method follows PATCH semantics.", + "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.", "parameters": { "instance": { "type": "string", @@ -38289,7 +41066,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -38484,7 +41261,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -38626,7 +41403,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -38823,7 +41600,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -39145,7 +41922,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -39281,7 +42058,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -39377,7 +42154,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" }, "zone": { @@ -39448,7 +42225,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -39720,7 +42497,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" }, "zone": { @@ -39787,7 +42564,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" }, "zone": { @@ -39976,6 +42753,40 @@ "https://www.googleapis.com/auth/compute.readonly" ] }, + "getEffectiveFirewalls": { + "id": "compute.networks.getEffectiveFirewalls", + "path": "projects/{project}/global/networks/{network}/getEffectiveFirewalls", + "httpMethod": "GET", + "description": "Returns the effective firewalls on a given network.", + "parameters": { + "network": { + "type": "string", + "description": "Name of the network for this request.", + "required": true, + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path" + }, + "project": { + "type": "string", + "description": "Project ID for this request.", + "required": true, + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path" + } + }, + "parameterOrder": [ + "project", + "network" + ], + "response": { + "$ref": "NetworksGetEffectiveFirewallsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, "insert": { "id": "compute.networks.insert", "path": "projects/{project}/global/networks", @@ -40047,7 +42858,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -40131,7 +42942,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -40405,7 +43216,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -40693,7 +43504,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" }, "zone": { @@ -40762,7 +43573,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" }, "zone": { @@ -41021,7 +43832,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -41259,7 +44070,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -41412,7 +44223,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -41508,7 +44319,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" }, "zone": { @@ -41579,7 +44390,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -41769,7 +44580,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -42092,14 +44903,504 @@ }, "project": { "type": "string", - "description": "Project ID for this request.", + "description": "Project ID for this request.", + "required": true, + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path" + }, + "returnPartialSuccess": { + "type": "boolean", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", + "location": "query" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "ProjectsGetXpnResources" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "listXpnHosts": { + "id": "compute.projects.listXpnHosts", + "path": "projects/{project}/listXpnHosts", + "httpMethod": "POST", + "description": "Lists all shared VPC host projects visible to the user in an organization.", + "parameters": { + "filter": { + "type": "string", + "description": "A filter expression that filters resources listed in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either `=`, `!=`, `\u003e`, or `\u003c`.\n\nFor example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`.\n\nYou can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels.\n\nTo filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ```", + "location": "query" + }, + "maxResults": { + "type": "integer", + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "format": "uint32", + "minimum": "0", + "location": "query" + }, + "orderBy": { + "type": "string", + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query" + }, + "pageToken": { + "type": "string", + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query" + }, + "project": { + "type": "string", + "description": "Project ID for this request.", + "required": true, + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path" + }, + "returnPartialSuccess": { + "type": "boolean", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", + "location": "query" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "ProjectsListXpnHostsRequest" + }, + "response": { + "$ref": "XpnHostList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "moveDisk": { + "id": "compute.projects.moveDisk", + "path": "projects/{project}/moveDisk", + "httpMethod": "POST", + "description": "Moves a persistent disk from one zone to another.", + "parameters": { + "project": { + "type": "string", + "description": "Project ID for this request.", + "required": true, + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path" + }, + "requestId": { + "type": "string", + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.\n\nFor example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "DiskMoveRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "moveInstance": { + "id": "compute.projects.moveInstance", + "path": "projects/{project}/moveInstance", + "httpMethod": "POST", + "description": "Moves an instance and its attached persistent disks from one zone to another.", + "parameters": { + "project": { + "type": "string", + "description": "Project ID for this request.", + "required": true, + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path" + }, + "requestId": { + "type": "string", + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.\n\nFor example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "InstanceMoveRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "setCommonInstanceMetadata": { + "id": "compute.projects.setCommonInstanceMetadata", + "path": "projects/{project}/setCommonInstanceMetadata", + "httpMethod": "POST", + "description": "Sets metadata common to all instances within the specified project using the data included in the request.", + "parameters": { + "project": { + "type": "string", + "description": "Project ID for this request.", + "required": true, + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path" + }, + "requestId": { + "type": "string", + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.\n\nFor example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "Metadata" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "setDefaultNetworkTier": { + "id": "compute.projects.setDefaultNetworkTier", + "path": "projects/{project}/setDefaultNetworkTier", + "httpMethod": "POST", + "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.", + "parameters": { + "project": { + "type": "string", + "description": "Project ID for this request.", + "required": true, + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path" + }, + "requestId": { + "type": "string", + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.\n\nFor example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "ProjectsSetDefaultNetworkTierRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "setUsageExportBucket": { + "id": "compute.projects.setUsageExportBucket", + "path": "projects/{project}/setUsageExportBucket", + "httpMethod": "POST", + "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.", + "parameters": { + "project": { + "type": "string", + "description": "Project ID for this request.", + "required": true, + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path" + }, + "requestId": { + "type": "string", + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.\n\nFor example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "UsageExportLocation" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/devstorage.full_control", + "https://www.googleapis.com/auth/devstorage.read_only", + "https://www.googleapis.com/auth/devstorage.read_write" + ] + } + } + }, + "publicAdvertisedPrefixes": { + "methods": { + "delete": { + "id": "compute.publicAdvertisedPrefixes.delete", + "path": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}", + "httpMethod": "DELETE", + "description": "Deletes the specified PublicAdvertisedPrefix", + "parameters": { + "project": { + "type": "string", + "description": "Project ID for this request.", + "required": true, + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path" + }, + "publicAdvertisedPrefix": { + "type": "string", + "description": "Name of the PublicAdvertisedPrefix resource to delete.", + "required": true, + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path" + }, + "requestId": { + "type": "string", + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.\n\nFor example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query" + } + }, + "parameterOrder": [ + "project", + "publicAdvertisedPrefix" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "get": { + "id": "compute.publicAdvertisedPrefixes.get", + "path": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}", + "httpMethod": "GET", + "description": "Returns the specified PublicAdvertisedPrefix resource.", + "parameters": { + "project": { + "type": "string", + "description": "Project ID for this request.", + "required": true, + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path" + }, + "publicAdvertisedPrefix": { + "type": "string", + "description": "Name of the PublicAdvertisedPrefix resource to return.", + "required": true, + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path" + } + }, + "parameterOrder": [ + "project", + "publicAdvertisedPrefix" + ], + "response": { + "$ref": "PublicAdvertisedPrefix" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "insert": { + "id": "compute.publicAdvertisedPrefixes.insert", + "path": "projects/{project}/global/publicAdvertisedPrefixes", + "httpMethod": "POST", + "description": "Creates a PublicAdvertisedPrefix in the specified project using the parameters that are included in the request.", + "parameters": { + "project": { + "type": "string", + "description": "Project ID for this request.", + "required": true, + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path" + }, + "requestId": { + "type": "string", + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.\n\nFor example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "PublicAdvertisedPrefix" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "list": { + "id": "compute.publicAdvertisedPrefixes.list", + "path": "projects/{project}/global/publicAdvertisedPrefixes", + "httpMethod": "GET", + "description": "Lists the PublicAdvertisedPrefixes for a project.", + "parameters": { + "filter": { + "type": "string", + "description": "A filter expression that filters resources listed in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either `=`, `!=`, `\u003e`, or `\u003c`.\n\nFor example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`.\n\nYou can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels.\n\nTo filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ```", + "location": "query" + }, + "maxResults": { + "type": "integer", + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "format": "uint32", + "minimum": "0", + "location": "query" + }, + "orderBy": { + "type": "string", + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query" + }, + "pageToken": { + "type": "string", + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query" + }, + "project": { + "type": "string", + "description": "Project ID for this request.", + "required": true, + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path" + }, + "returnPartialSuccess": { + "type": "boolean", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", + "location": "query" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "PublicAdvertisedPrefixList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "patch": { + "id": "compute.publicAdvertisedPrefixes.patch", + "path": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}", + "httpMethod": "PATCH", + "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.", + "parameters": { + "project": { + "type": "string", + "description": "Project ID for this request.", + "required": true, + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path" + }, + "publicAdvertisedPrefix": { + "type": "string", + "description": "Name of the PublicAdvertisedPrefix resource to patch.", + "required": true, + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path" + }, + "requestId": { + "type": "string", + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.\n\nFor example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query" + } + }, + "parameterOrder": [ + "project", + "publicAdvertisedPrefix" + ], + "request": { + "$ref": "PublicAdvertisedPrefix" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + } + } + }, + "publicDelegatedPrefixes": { + "methods": { + "aggregatedList": { + "id": "compute.publicDelegatedPrefixes.aggregatedList", + "path": "projects/{project}/aggregated/publicDelegatedPrefixes", + "httpMethod": "GET", + "description": "Lists all PublicDelegatedPrefix resources owned by the specific project across all scopes.", + "parameters": { + "filter": { + "type": "string", + "description": "A filter expression that filters resources listed in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either `=`, `!=`, `\u003e`, or `\u003c`.\n\nFor example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`.\n\nYou can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels.\n\nTo filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ```", + "location": "query" + }, + "includeAllScopes": { + "type": "boolean", + "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" + }, + "maxResults": { + "type": "integer", + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "format": "uint32", + "minimum": "0", + "location": "query" + }, + "orderBy": { + "type": "string", + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query" + }, + "pageToken": { + "type": "string", + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query" + }, + "project": { + "type": "string", + "description": "Name of the project scoping this request.", "required": true, "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "location": "path" }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -42107,42 +45408,20 @@ "project" ], "response": { - "$ref": "ProjectsGetXpnResources" + "$ref": "PublicDelegatedPrefixAggregatedList" }, "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" ] }, - "listXpnHosts": { - "id": "compute.projects.listXpnHosts", - "path": "projects/{project}/listXpnHosts", - "httpMethod": "POST", - "description": "Lists all shared VPC host projects visible to the user in an organization.", + "delete": { + "id": "compute.publicDelegatedPrefixes.delete", + "path": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}", + "httpMethod": "DELETE", + "description": "Deletes the specified PublicDelegatedPrefix in the given region.", "parameters": { - "filter": { - "type": "string", - "description": "A filter expression that filters resources listed in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either `=`, `!=`, `\u003e`, or `\u003c`.\n\nFor example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`.\n\nYou can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels.\n\nTo filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ```", - "location": "query" - }, - "maxResults": { - "type": "integer", - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "format": "uint32", - "minimum": "0", - "location": "query" - }, - "orderBy": { - "type": "string", - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query" - }, - "pageToken": { - "type": "string", - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query" - }, "project": { "type": "string", "description": "Project ID for this request.", @@ -42150,37 +45429,18 @@ "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "location": "path" }, - "returnPartialSuccess": { - "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", - "location": "query" - } - }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "ProjectsListXpnHostsRequest" - }, - "response": { - "$ref": "XpnHostList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ] - }, - "moveDisk": { - "id": "compute.projects.moveDisk", - "path": "projects/{project}/moveDisk", - "httpMethod": "POST", - "description": "Moves a persistent disk from one zone to another.", - "parameters": { - "project": { + "publicDelegatedPrefix": { "type": "string", - "description": "Project ID for this request.", + "description": "Name of the PublicDelegatedPrefix resource to delete.", "required": true, - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path" + }, + "region": { + "type": "string", + "description": "Name of the region of this request.", + "required": true, + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "location": "path" }, "requestId": { @@ -42190,11 +45450,10 @@ } }, "parameterOrder": [ - "project" + "project", + "region", + "publicDelegatedPrefix" ], - "request": { - "$ref": "DiskMoveRequest" - }, "response": { "$ref": "Operation" }, @@ -42203,11 +45462,11 @@ "https://www.googleapis.com/auth/compute" ] }, - "moveInstance": { - "id": "compute.projects.moveInstance", - "path": "projects/{project}/moveInstance", - "httpMethod": "POST", - "description": "Moves an instance and its attached persistent disks from one zone to another.", + "get": { + "id": "compute.publicDelegatedPrefixes.get", + "path": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}", + "httpMethod": "GET", + "description": "Returns the specified PublicDelegatedPrefix resource in the given region.", "parameters": { "project": { "type": "string", @@ -42216,31 +45475,40 @@ "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "location": "path" }, - "requestId": { + "publicDelegatedPrefix": { "type": "string", - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.\n\nFor example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", - "location": "query" + "description": "Name of the PublicDelegatedPrefix resource to return.", + "required": true, + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path" + }, + "region": { + "type": "string", + "description": "Name of the region of this request.", + "required": true, + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path" } }, "parameterOrder": [ - "project" + "project", + "region", + "publicDelegatedPrefix" ], - "request": { - "$ref": "InstanceMoveRequest" - }, "response": { - "$ref": "Operation" + "$ref": "PublicDelegatedPrefix" }, "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" ] }, - "setCommonInstanceMetadata": { - "id": "compute.projects.setCommonInstanceMetadata", - "path": "projects/{project}/setCommonInstanceMetadata", + "insert": { + "id": "compute.publicDelegatedPrefixes.insert", + "path": "projects/{project}/regions/{region}/publicDelegatedPrefixes", "httpMethod": "POST", - "description": "Sets metadata common to all instances within the specified project using the data included in the request.", + "description": "Creates a PublicDelegatedPrefix in the specified project in the given region using the parameters that are included in the request.", "parameters": { "project": { "type": "string", @@ -42249,6 +45517,13 @@ "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "location": "path" }, + "region": { + "type": "string", + "description": "Name of the region of this request.", + "required": true, + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path" + }, "requestId": { "type": "string", "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.\n\nFor example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", @@ -42256,10 +45531,11 @@ } }, "parameterOrder": [ - "project" + "project", + "region" ], "request": { - "$ref": "Metadata" + "$ref": "PublicDelegatedPrefix" }, "response": { "$ref": "Operation" @@ -42269,12 +45545,35 @@ "https://www.googleapis.com/auth/compute" ] }, - "setDefaultNetworkTier": { - "id": "compute.projects.setDefaultNetworkTier", - "path": "projects/{project}/setDefaultNetworkTier", - "httpMethod": "POST", - "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.", + "list": { + "id": "compute.publicDelegatedPrefixes.list", + "path": "projects/{project}/regions/{region}/publicDelegatedPrefixes", + "httpMethod": "GET", + "description": "Lists the PublicDelegatedPrefixes for a project in the given region.", "parameters": { + "filter": { + "type": "string", + "description": "A filter expression that filters resources listed in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either `=`, `!=`, `\u003e`, or `\u003c`.\n\nFor example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`.\n\nYou can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels.\n\nTo filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ```", + "location": "query" + }, + "maxResults": { + "type": "integer", + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "format": "uint32", + "minimum": "0", + "location": "query" + }, + "orderBy": { + "type": "string", + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query" + }, + "pageToken": { + "type": "string", + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query" + }, "project": { "type": "string", "description": "Project ID for this request.", @@ -42282,31 +45581,37 @@ "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "location": "path" }, - "requestId": { + "region": { "type": "string", - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.\n\nFor example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "description": "Name of the region of this request.", + "required": true, + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path" + }, + "returnPartialSuccess": { + "type": "boolean", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, "parameterOrder": [ - "project" + "project", + "region" ], - "request": { - "$ref": "ProjectsSetDefaultNetworkTierRequest" - }, "response": { - "$ref": "Operation" + "$ref": "PublicDelegatedPrefixList" }, "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" ] }, - "setUsageExportBucket": { - "id": "compute.projects.setUsageExportBucket", - "path": "projects/{project}/setUsageExportBucket", - "httpMethod": "POST", - "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.", + "patch": { + "id": "compute.publicDelegatedPrefixes.patch", + "path": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}", + "httpMethod": "PATCH", + "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.", "parameters": { "project": { "type": "string", @@ -42315,6 +45620,20 @@ "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "location": "path" }, + "publicDelegatedPrefix": { + "type": "string", + "description": "Name of the PublicDelegatedPrefix resource to patch.", + "required": true, + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path" + }, + "region": { + "type": "string", + "description": "Name of the region for this request.", + "required": true, + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path" + }, "requestId": { "type": "string", "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.\n\nFor example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", @@ -42322,20 +45641,19 @@ } }, "parameterOrder": [ - "project" + "project", + "region", + "publicDelegatedPrefix" ], "request": { - "$ref": "UsageExportLocation" + "$ref": "PublicDelegatedPrefix" }, "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" + "https://www.googleapis.com/auth/compute" ] } } @@ -42516,7 +45834,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -42849,7 +46167,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -43011,7 +46329,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -43155,7 +46473,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -43263,7 +46581,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -43544,7 +46862,7 @@ }, "sourceImage": { "type": "string", - "description": "Optional. Source image to restore onto a disk.", + "description": "Source image to restore onto a disk. This field is optional.", "location": "query" } }, @@ -43608,7 +46926,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -44037,7 +47355,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -44280,7 +47598,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -44792,7 +48110,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -44859,7 +48177,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -44927,7 +48245,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -44995,7 +48313,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -45111,7 +48429,7 @@ "id": "compute.regionInstanceGroupManagers.recreateInstances", "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/recreateInstances", "httpMethod": "POST", - "description": "Flags the specified instances in the managed instance group to be immediately recreated. The instances are deleted and recreated using the current instance template for the managed instance group. 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 the recreating action with the listmanagedinstances method.\n\nIf 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.\n\nYou can specify a maximum of 1000 instances with this method per request.", + "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.\n\nIf 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.\n\nYou can specify a maximum of 1000 instances with this method per request.", "parameters": { "instanceGroupManager": { "type": "string", @@ -45436,7 +48754,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -45503,7 +48821,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -45573,6 +48891,51 @@ } } }, + "regionInstances": { + "methods": { + "bulkInsert": { + "id": "compute.regionInstances.bulkInsert", + "path": "projects/{project}/regions/{region}/instances/bulkInsert", + "httpMethod": "POST", + "description": "Creates multiple instances in a given region. Count specifies the number of instances to create.", + "parameters": { + "project": { + "type": "string", + "description": "Project ID for this request.", + "required": true, + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path" + }, + "region": { + "type": "string", + "description": "The name of the region for this request.", + "required": true, + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path" + }, + "requestId": { + "type": "string", + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.\n\nFor example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "BulkInsertInstanceResource" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + } + } + }, "regionNetworkEndpointGroups": { "methods": { "delete": { @@ -45743,7 +49106,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -45938,7 +49301,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -46084,7 +49447,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -46321,7 +49684,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -46516,7 +49879,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -46760,7 +50123,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -47053,7 +50416,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -47288,7 +50651,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -47351,7 +50714,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -47582,7 +50945,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" }, "zone": { @@ -47791,7 +51154,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -48029,7 +51392,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -48182,7 +51545,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -48331,7 +51694,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" }, "router": { @@ -48484,7 +51847,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -48791,7 +52154,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -49030,7 +52393,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -49084,7 +52447,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -49375,7 +52738,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -49547,7 +52910,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -49706,7 +53069,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -49867,7 +53230,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -49921,7 +53284,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -50024,7 +53387,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -50311,7 +53674,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -50366,7 +53729,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -50722,7 +54085,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -50826,7 +54189,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -50985,7 +54348,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -51130,7 +54493,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -51289,7 +54652,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -51305,6 +54668,47 @@ "https://www.googleapis.com/auth/compute.readonly" ] }, + "patch": { + "id": "compute.targetHttpsProxies.patch", + "path": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}", + "httpMethod": "PATCH", + "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. (== suppress_warning http-rest-shadowed ==)", + "parameters": { + "project": { + "type": "string", + "description": "Project ID for this request.", + "required": true, + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path" + }, + "requestId": { + "type": "string", + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.\n\nFor example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query" + }, + "targetHttpsProxy": { + "type": "string", + "description": "Name of the TargetHttpsProxy resource to patch.", + "required": true, + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path" + } + }, + "parameterOrder": [ + "project", + "targetHttpsProxy" + ], + "request": { + "$ref": "TargetHttpsProxy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, "setQuicOverride": { "id": "compute.targetHttpsProxies.setQuicOverride", "path": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}/setQuicOverride", @@ -51514,7 +54918,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -51697,7 +55101,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" }, "zone": { @@ -51866,7 +55270,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -52101,7 +55505,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -52418,7 +55822,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -52744,7 +56148,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -52889,7 +56293,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -53079,7 +56483,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -53143,7 +56547,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -53343,7 +56747,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -53524,7 +56928,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -53756,7 +57160,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -53914,7 +57318,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -54104,7 +57508,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } }, @@ -54243,7 +57647,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" }, "zone": { @@ -54385,7 +57789,7 @@ }, "returnPartialSuccess": { "type": "boolean", - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.", + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.", "location": "query" } },