diff --git a/api-list.json b/api-list.json index 6429e210d03..05d830f4733 100644 --- a/api-list.json +++ b/api-list.json @@ -1111,51 +1111,6 @@ "documentationLink": "https://cloud.google.com/billing/", "preferred": true }, - { - "kind": "discovery#directoryItem", - "id": "cloudbuild:v1alpha1", - "name": "cloudbuild", - "version": "v1alpha1", - "title": "Cloud Build API", - "description": "Creates and manages builds on Google Cloud Platform.", - "discoveryRestUrl": "https://cloudbuild.googleapis.com/$discovery/rest?version=v1alpha1", - "icons": { - "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png", - "x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png" - }, - "documentationLink": "https://cloud.google.com/cloud-build/docs/", - "preferred": false - }, - { - "kind": "discovery#directoryItem", - "id": "cloudbuild:v1alpha2", - "name": "cloudbuild", - "version": "v1alpha2", - "title": "Cloud Build API", - "description": "Creates and manages builds on Google Cloud Platform.", - "discoveryRestUrl": "https://cloudbuild.googleapis.com/$discovery/rest?version=v1alpha2", - "icons": { - "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png", - "x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png" - }, - "documentationLink": "https://cloud.google.com/cloud-build/docs/", - "preferred": false - }, - { - "kind": "discovery#directoryItem", - "id": "cloudbuild:v1beta1", - "name": "cloudbuild", - "version": "v1beta1", - "title": "Cloud Build API", - "description": "Creates and manages builds on Google Cloud Platform.", - "discoveryRestUrl": "https://cloudbuild.googleapis.com/$discovery/rest?version=v1beta1", - "icons": { - "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png", - "x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png" - }, - "documentationLink": "https://cloud.google.com/cloud-build/docs/", - "preferred": false - }, { "kind": "discovery#directoryItem", "id": "cloudbuild:v1", diff --git a/bigqueryreservation/v1/bigqueryreservation-api.json b/bigqueryreservation/v1/bigqueryreservation-api.json index 656798d15af..f5c75627497 100644 --- a/bigqueryreservation/v1/bigqueryreservation-api.json +++ b/bigqueryreservation/v1/bigqueryreservation-api.json @@ -823,7 +823,7 @@ } } }, - "revision": "20221112", + "revision": "20230121", "rootUrl": "https://bigqueryreservation.googleapis.com/", "schemas": { "Assignment": { @@ -875,6 +875,24 @@ }, "type": "object" }, + "Autoscale": { + "description": "Auto scaling settings. max_slots and budget are mutually exclusive. If max_slots is set: * The system will create a dedicated `FLEX` capacity commitment to hold the slots for auto-scale. Users won't be able to manage it, to avoid conflicts. * Scale-up will happen if there are always pending tasks for the past 10 minutes. * Scale-down will happen, if the system detects that scale-up won't be triggered again. If budget is set: * The system will try to use more slots immediately. * At a particular moment, the number of slots scaled is determined by the sytsem, based on the remaining budget and system limit. But overall the usage will conform to the budget if there is enough traffic. * The system will round the slot usage every minute. **Note** this is an alpha feature.", + "id": "Autoscale", + "properties": { + "currentSlots": { + "description": "Output only. The slot capacity added to this reservation when autoscale happens. Will be between [0, max_slots].", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "maxSlots": { + "description": "Number of slots to be scaled when needed.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, "BiReservation": { "description": "Represents a BI Reservation.", "id": "BiReservation", @@ -920,6 +938,18 @@ "readOnly": true, "type": "string" }, + "edition": { + "description": "Edition of the capacity commitment.", + "enum": [ + "EDITION_UNSPECIFIED", + "ENTERPRISE" + ], + "enumDescriptions": [ + "Default value, only for legacy reservations and capacity commitments.", + "Enterprise edition." + ], + "type": "string" + }, "failureStatus": { "$ref": "Status", "description": "Output only. For FAILED commitment plan, provides the reason of failure.", @@ -941,14 +971,16 @@ "FLEX", "TRIAL", "MONTHLY", - "ANNUAL" + "ANNUAL", + "NONE" ], "enumDescriptions": [ "Invalid plan value. Requests with this value will be rejected with error code `google.rpc.Code.INVALID_ARGUMENT`.", "Flex commitments have committed period of 1 minute after becoming ACTIVE. After that, they are not in a committed period anymore and can be removed any time.", "Trial commitments have a committed period of 182 days after becoming ACTIVE. After that, they are converted to a new commitment based on the `renewal_plan`. Default `renewal_plan` for Trial commitment is Flex so that it can be deleted right after committed period ends.", "Monthly commitments have a committed period of 30 days after becoming ACTIVE. After that, they are not in a committed period anymore and can be removed any time.", - "Annual commitments have a committed period of 365 days after becoming ACTIVE. After that they are converted to a new commitment based on the renewal_plan." + "Annual commitments have a committed period of 365 days after becoming ACTIVE. After that they are converted to a new commitment based on the renewal_plan.", + "Should only be used for `renewal_plan` and is only meaningful if edition is specified to values other than EDITION_UNSPECIFIED. Otherwise CreateCapacityCommitmentRequest or UpdateCapacityCommitmentRequest will be rejected with error code `google.rpc.Code.INVALID_ARGUMENT`. If the renewal_plan is NONE, capacity commitment will be removed at the end of its commitment period." ], "type": "string" }, @@ -959,14 +991,16 @@ "FLEX", "TRIAL", "MONTHLY", - "ANNUAL" + "ANNUAL", + "NONE" ], "enumDescriptions": [ "Invalid plan value. Requests with this value will be rejected with error code `google.rpc.Code.INVALID_ARGUMENT`.", "Flex commitments have committed period of 1 minute after becoming ACTIVE. After that, they are not in a committed period anymore and can be removed any time.", "Trial commitments have a committed period of 182 days after becoming ACTIVE. After that, they are converted to a new commitment based on the `renewal_plan`. Default `renewal_plan` for Trial commitment is Flex so that it can be deleted right after committed period ends.", "Monthly commitments have a committed period of 30 days after becoming ACTIVE. After that, they are not in a committed period anymore and can be removed any time.", - "Annual commitments have a committed period of 365 days after becoming ACTIVE. After that they are converted to a new commitment based on the renewal_plan." + "Annual commitments have a committed period of 365 days after becoming ACTIVE. After that they are converted to a new commitment based on the renewal_plan.", + "Should only be used for `renewal_plan` and is only meaningful if edition is specified to values other than EDITION_UNSPECIFIED. Otherwise CreateCapacityCommitmentRequest or UpdateCapacityCommitmentRequest will be rejected with error code `google.rpc.Code.INVALID_ARGUMENT`. If the renewal_plan is NONE, capacity commitment will be removed at the end of its commitment period." ], "type": "string" }, @@ -1084,6 +1118,10 @@ "description": "A reservation is a mechanism used to guarantee slots to users.", "id": "Reservation", "properties": { + "autoscale": { + "$ref": "Autoscale", + "description": "The configuration parameters for the auto scaling feature. Note this is an alpha feature." + }, "concurrency": { "description": "Job concurrency target which sets a soft upper bound on the number of jobs that can run concurrently in this reservation. This is a soft target due to asynchronous nature of the system and various optimizations for small queries. Default value is 0 which means that concurrency target will be automatically computed by the system. NOTE: this field is exposed as `target_job_concurrency` in the Information Schema, DDL and BQ CLI.", "format": "int64", @@ -1095,6 +1133,18 @@ "readOnly": true, "type": "string" }, + "edition": { + "description": "Edition of the reservation.", + "enum": [ + "EDITION_UNSPECIFIED", + "ENTERPRISE" + ], + "enumDescriptions": [ + "Default value, only for legacy reservations and capacity commitments.", + "Enterprise edition." + ], + "type": "string" + }, "ignoreIdleSlots": { "description": "If false, any query or pipeline job using this reservation will use idle slots from other reservations within the same admin project. If true, a query or pipeline job using this reservation will execute with the slot capacity specified in the slot_capacity field at most.", "type": "boolean" diff --git a/bigqueryreservation/v1/bigqueryreservation-gen.go b/bigqueryreservation/v1/bigqueryreservation-gen.go index 09c6013bff6..6211f126459 100644 --- a/bigqueryreservation/v1/bigqueryreservation-gen.go +++ b/bigqueryreservation/v1/bigqueryreservation-gen.go @@ -267,6 +267,49 @@ func (s *Assignment) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// Autoscale: Auto scaling settings. max_slots and budget are mutually +// exclusive. If max_slots is set: * The system will create a dedicated +// `FLEX` capacity commitment to hold the slots for auto-scale. Users +// won't be able to manage it, to avoid conflicts. * Scale-up will +// happen if there are always pending tasks for the past 10 minutes. * +// Scale-down will happen, if the system detects that scale-up won't be +// triggered again. If budget is set: * The system will try to use more +// slots immediately. * At a particular moment, the number of slots +// scaled is determined by the sytsem, based on the remaining budget and +// system limit. But overall the usage will conform to the budget if +// there is enough traffic. * The system will round the slot usage every +// minute. **Note** this is an alpha feature. +type Autoscale struct { + // CurrentSlots: Output only. The slot capacity added to this + // reservation when autoscale happens. Will be between [0, max_slots]. + CurrentSlots int64 `json:"currentSlots,omitempty,string"` + + // MaxSlots: Number of slots to be scaled when needed. + MaxSlots int64 `json:"maxSlots,omitempty,string"` + + // ForceSendFields is a list of field names (e.g. "CurrentSlots") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "CurrentSlots") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *Autoscale) MarshalJSON() ([]byte, error) { + type NoMethod Autoscale + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // BiReservation: Represents a BI Reservation. type BiReservation struct { // Name: The resource name of the singleton BI reservation. Reservation @@ -326,6 +369,14 @@ type CapacityCommitment struct { // period. It is applicable only for ACTIVE capacity commitments. CommitmentStartTime string `json:"commitmentStartTime,omitempty"` + // Edition: Edition of the capacity commitment. + // + // Possible values: + // "EDITION_UNSPECIFIED" - Default value, only for legacy reservations + // and capacity commitments. + // "ENTERPRISE" - Enterprise edition. + Edition string `json:"edition,omitempty"` + // FailureStatus: Output only. For FAILED commitment plan, provides the // reason of failure. FailureStatus *Status `json:"failureStatus,omitempty"` @@ -364,6 +415,13 @@ type CapacityCommitment struct { // "ANNUAL" - Annual commitments have a committed period of 365 days // after becoming ACTIVE. After that they are converted to a new // commitment based on the renewal_plan. + // "NONE" - Should only be used for `renewal_plan` and is only + // meaningful if edition is specified to values other than + // EDITION_UNSPECIFIED. Otherwise CreateCapacityCommitmentRequest or + // UpdateCapacityCommitmentRequest will be rejected with error code + // `google.rpc.Code.INVALID_ARGUMENT`. If the renewal_plan is NONE, + // capacity commitment will be removed at the end of its commitment + // period. Plan string `json:"plan,omitempty"` // RenewalPlan: The plan this capacity commitment is converted to after @@ -389,6 +447,13 @@ type CapacityCommitment struct { // "ANNUAL" - Annual commitments have a committed period of 365 days // after becoming ACTIVE. After that they are converted to a new // commitment based on the renewal_plan. + // "NONE" - Should only be used for `renewal_plan` and is only + // meaningful if edition is specified to values other than + // EDITION_UNSPECIFIED. Otherwise CreateCapacityCommitmentRequest or + // UpdateCapacityCommitmentRequest will be rejected with error code + // `google.rpc.Code.INVALID_ARGUMENT`. If the renewal_plan is NONE, + // capacity commitment will be removed at the end of its commitment + // period. RenewalPlan string `json:"renewalPlan,omitempty"` // SlotCount: Number of slots in this commitment. @@ -632,6 +697,10 @@ func (s *MoveAssignmentRequest) MarshalJSON() ([]byte, error) { // Reservation: A reservation is a mechanism used to guarantee slots to // users. type Reservation struct { + // Autoscale: The configuration parameters for the auto scaling feature. + // Note this is an alpha feature. + Autoscale *Autoscale `json:"autoscale,omitempty"` + // Concurrency: Job concurrency target which sets a soft upper bound on // the number of jobs that can run concurrently in this reservation. // This is a soft target due to asynchronous nature of the system and @@ -644,6 +713,14 @@ type Reservation struct { // CreationTime: Output only. Creation time of the reservation. CreationTime string `json:"creationTime,omitempty"` + // Edition: Edition of the reservation. + // + // Possible values: + // "EDITION_UNSPECIFIED" - Default value, only for legacy reservations + // and capacity commitments. + // "ENTERPRISE" - Enterprise edition. + Edition string `json:"edition,omitempty"` + // IgnoreIdleSlots: If false, any query or pipeline job using this // reservation will use idle slots from other reservations within the // same admin project. If true, a query or pipeline job using this @@ -684,7 +761,7 @@ type Reservation struct { // server. googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "Concurrency") to + // ForceSendFields is a list of field names (e.g. "Autoscale") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -692,10 +769,10 @@ type Reservation struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Concurrency") to include - // in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. However, any field with - // an empty value appearing in NullFields will be sent to the server as + // NullFields is a list of field names (e.g. "Autoscale") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` diff --git a/container/v1/container-api.json b/container/v1/container-api.json index 22a19aae60f..272baf8ed5e 100644 --- a/container/v1/container-api.json +++ b/container/v1/container-api.json @@ -2487,7 +2487,7 @@ } } }, - "revision": "20230104", + "revision": "20230117", "rootUrl": "https://container.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -2632,7 +2632,7 @@ "type": "string" }, "imageType": { - "description": "The image type to use for NAP created node.", + "description": "The image type to use for NAP created node. Please see https://cloud.google.com/kubernetes-engine/docs/concepts/node-images for available image types.", "type": "string" }, "management": { @@ -2640,7 +2640,7 @@ "description": "Specifies the node management options for NAP created node-pools." }, "minCpuPlatform": { - "description": "Deprecated. Minimum CPU platform to be used for NAP created node pools. 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 [how to specify min CPU platform](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform). This field is deprecated, min_cpu_platform should be specified using https://cloud.google.com/requested-min-cpu-platform label selector on the pod. To unset the min cpu platform field pass \"automatic\" as field value.", + "description": "Deprecated. Minimum CPU platform to be used for NAP created node pools. 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 [how to specify min CPU platform](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform). This field is deprecated, min_cpu_platform should be specified using `cloud.google.com/requested-min-cpu-platform` label selector on the pod. To unset the min cpu platform field pass \"automatic\" as field value.", "type": "string" }, "oauthScopes": { @@ -3930,6 +3930,11 @@ "description": "The IP address range of the services IPs in this cluster. If blank, a range will be automatically chosen with the default size. This field is only applicable when `use_ip_aliases` is true. Set to blank to have a range chosen with the default size. Set to /netmask (e.g. `/14`) to have a range chosen with a specific netmask. Set to a [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g. `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range to use.", "type": "string" }, + "servicesIpv6CidrBlock": { + "description": "Output only. [Output only] The services IPv6 CIDR block for the cluster.", + "readOnly": true, + "type": "string" + }, "servicesSecondaryRangeName": { "description": "The name of the secondary range to be used as for the services CIDR block. The secondary range will be used for service ClusterIPs. This must be an existing secondary range associated with the cluster subnetwork. This field is only applicable with use_ip_aliases is true and create_subnetwork is false.", "type": "string" @@ -3948,6 +3953,11 @@ ], "type": "string" }, + "subnetIpv6CidrBlock": { + "description": "Output only. [Output only] The subnet's IPv6 CIDR block used by nodes and pods.", + "readOnly": true, + "type": "string" + }, "subnetworkName": { "description": "A custom subnetwork name to be used if `create_subnetwork` is true. If this field is empty, then an automatic name will be chosen for the new subnetwork.", "type": "string" @@ -4628,7 +4638,7 @@ "description": "Enable or disable gvnic in the node pool." }, "imageType": { - "description": "The image type to use for this node. Note that for a given image type, the latest version of it will be used.", + "description": "The image type to use for this node. Note that for a given image type, the latest version of it will be used. Please see https://cloud.google.com/kubernetes-engine/docs/concepts/node-images for available image types.", "type": "string" }, "kubeletConfig": { @@ -4947,7 +4957,7 @@ "description": "Upgrade settings control disruption and speed of the upgrade." }, "version": { - "description": "The version of the Kubernetes of this node.", + "description": "The version of Kubernetes running on this NodePool's nodes. If unspecified, it defaults as described [here](https://cloud.google.com/kubernetes-engine/versioning#specifying_node_version).", "type": "string" } }, @@ -6324,7 +6334,7 @@ "description": "Enable or disable gvnic on the node pool." }, "imageType": { - "description": "Required. The desired image type for the node pool.", + "description": "Required. The desired image type for the node pool. Please see https://cloud.google.com/kubernetes-engine/docs/concepts/node-images for available image types.", "type": "string" }, "kubeletConfig": { @@ -6502,7 +6512,7 @@ "SURGE" ], "enumDescriptions": [ - "Default value.", + "Default value if unset. GKE internally defaults the update strategy to SURGE for unspecified strategies.", "blue-green upgrade.", "SURGE is the traditional way of upgrade a node pool. max_surge and max_unavailable determines the level of upgrade parallelism." ], diff --git a/container/v1/container-gen.go b/container/v1/container-gen.go index 2b04bd42566..14e070acf2c 100644 --- a/container/v1/container-gen.go +++ b/container/v1/container-gen.go @@ -553,7 +553,9 @@ type AutoprovisioningNodePoolDefaults struct { // 'pd-standard' DiskType string `json:"diskType,omitempty"` - // ImageType: The image type to use for NAP created node. + // ImageType: The image type to use for NAP created node. Please see + // https://cloud.google.com/kubernetes-engine/docs/concepts/node-images + // for available image types. ImageType string `json:"imageType,omitempty"` // Management: Specifies the node management options for NAP created @@ -568,9 +570,9 @@ type AutoprovisioningNodePoolDefaults struct { // platform // (https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform). // This field is deprecated, min_cpu_platform should be specified using - // https://cloud.google.com/requested-min-cpu-platform label selector on - // the pod. To unset the min cpu platform field pass "automatic" as - // field value. + // `cloud.google.com/requested-min-cpu-platform` label selector on the + // pod. To unset the min cpu platform field pass "automatic" as field + // value. MinCpuPlatform string `json:"minCpuPlatform,omitempty"` // OauthScopes: Scopes that are used by NAP when creating node pools. @@ -2644,6 +2646,10 @@ type IPAllocationPolicy struct { // specific range to use. ServicesIpv4CidrBlock string `json:"servicesIpv4CidrBlock,omitempty"` + // ServicesIpv6CidrBlock: Output only. [Output only] The services IPv6 + // CIDR block for the cluster. + ServicesIpv6CidrBlock string `json:"servicesIpv6CidrBlock,omitempty"` + // ServicesSecondaryRangeName: The name of the secondary range to be // used as for the services CIDR block. The secondary range will be used // for service ClusterIPs. This must be an existing secondary range @@ -2660,6 +2666,10 @@ type IPAllocationPolicy struct { // "IPV4_IPV6" - Cluster can use both IPv4 and IPv6 StackType string `json:"stackType,omitempty"` + // SubnetIpv6CidrBlock: Output only. [Output only] The subnet's IPv6 + // CIDR block used by nodes and pods. + SubnetIpv6CidrBlock string `json:"subnetIpv6CidrBlock,omitempty"` + // SubnetworkName: A custom subnetwork name to be used if // `create_subnetwork` is true. If this field is empty, then an // automatic name will be chosen for the new subnetwork. @@ -3935,7 +3945,9 @@ type NodeConfig struct { Gvnic *VirtualNIC `json:"gvnic,omitempty"` // ImageType: The image type to use for this node. Note that for a given - // image type, the latest version of it will be used. + // image type, the latest version of it will be used. Please see + // https://cloud.google.com/kubernetes-engine/docs/concepts/node-images + // for available image types. ImageType string `json:"imageType,omitempty"` // KubeletConfig: Node kubelet configs. @@ -4415,7 +4427,9 @@ type NodePool struct { // upgrade. UpgradeSettings *UpgradeSettings `json:"upgradeSettings,omitempty"` - // Version: The version of the Kubernetes of this node. + // Version: The version of Kubernetes running on this NodePool's nodes. + // If unspecified, it defaults as described here + // (https://cloud.google.com/kubernetes-engine/versioning#specifying_node_version). Version string `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -6773,7 +6787,10 @@ type UpdateNodePoolRequest struct { // Gvnic: Enable or disable gvnic on the node pool. Gvnic *VirtualNIC `json:"gvnic,omitempty"` - // ImageType: Required. The desired image type for the node pool. + // ImageType: Required. The desired image type for the node pool. Please + // see + // https://cloud.google.com/kubernetes-engine/docs/concepts/node-images + // for available image types. ImageType string `json:"imageType,omitempty"` // KubeletConfig: Node kubelet configs. @@ -7035,7 +7052,9 @@ type UpgradeSettings struct { // Strategy: Update strategy of the node pool. // // Possible values: - // "NODE_POOL_UPDATE_STRATEGY_UNSPECIFIED" - Default value. + // "NODE_POOL_UPDATE_STRATEGY_UNSPECIFIED" - Default value if unset. + // GKE internally defaults the update strategy to SURGE for unspecified + // strategies. // "BLUE_GREEN" - blue-green upgrade. // "SURGE" - SURGE is the traditional way of upgrade a node pool. // max_surge and max_unavailable determines the level of upgrade diff --git a/container/v1beta1/container-api.json b/container/v1beta1/container-api.json index c9b4db7cd43..5a51855deea 100644 --- a/container/v1beta1/container-api.json +++ b/container/v1beta1/container-api.json @@ -2512,7 +2512,7 @@ } } }, - "revision": "20230104", + "revision": "20230117", "rootUrl": "https://container.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -2670,7 +2670,7 @@ "type": "string" }, "imageType": { - "description": "The image type to use for NAP created node.", + "description": "The image type to use for NAP created node. Please see https://cloud.google.com/kubernetes-engine/docs/concepts/node-images for available image types.", "type": "string" }, "management": { @@ -2678,7 +2678,7 @@ "description": "NodeManagement configuration for this NodePool." }, "minCpuPlatform": { - "description": "Deprecated. Minimum CPU platform to be used for NAP created node pools. 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 [how to specify min CPU platform](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform). This field is deprecated, min_cpu_platform should be specified using https://cloud.google.com/requested-min-cpu-platform label selector on the pod. To unset the min cpu platform field pass \"automatic\" as field value.", + "description": "Deprecated. Minimum CPU platform to be used for NAP created node pools. 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 [how to specify min CPU platform](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform). This field is deprecated, min_cpu_platform should be specified using `cloud.google.com/requested-min-cpu-platform` label selector on the pod. To unset the min cpu platform field pass \"automatic\" as field value.", "type": "string" }, "oauthScopes": { @@ -4920,7 +4920,7 @@ "description": "Enable or disable gvnic on the node pool." }, "imageType": { - "description": "The image type to use for this node. Note that for a given image type, the latest version of it will be used.", + "description": "The image type to use for this node. Note that for a given image type, the latest version of it will be used. Please see https://cloud.google.com/kubernetes-engine/docs/concepts/node-images for available image types.", "type": "string" }, "kubeletConfig": { @@ -5239,7 +5239,7 @@ "description": "Upgrade settings control disruption and speed of the upgrade." }, "version": { - "description": "The version of the Kubernetes of this node.", + "description": "The version of Kubernetes running on this NodePool's nodes. If unspecified, it defaults as described [here](https://cloud.google.com/kubernetes-engine/versioning#specifying_node_version).", "type": "string" } }, @@ -6689,7 +6689,7 @@ "description": "Enable or disable gvnic on the node pool." }, "imageType": { - "description": "Required. The desired image type for the node pool.", + "description": "Required. The desired image type for the node pool. Please see https://cloud.google.com/kubernetes-engine/docs/concepts/node-images for available image types.", "type": "string" }, "kubeletConfig": { @@ -6871,7 +6871,7 @@ "SURGE" ], "enumDescriptions": [ - "Default value.", + "Default value if unset. GKE internally defaults the update strategy to SURGE for unspecified strategies.", "blue-green upgrade.", "SURGE is the traditional way of upgrading a node pool. max_surge and max_unavailable determines the level of upgrade parallelism." ], diff --git a/container/v1beta1/container-gen.go b/container/v1beta1/container-gen.go index 4197803f9a8..7c6e6c623f7 100644 --- a/container/v1beta1/container-gen.go +++ b/container/v1beta1/container-gen.go @@ -566,7 +566,9 @@ type AutoprovisioningNodePoolDefaults struct { // 'pd-standard' DiskType string `json:"diskType,omitempty"` - // ImageType: The image type to use for NAP created node. + // ImageType: The image type to use for NAP created node. Please see + // https://cloud.google.com/kubernetes-engine/docs/concepts/node-images + // for available image types. ImageType string `json:"imageType,omitempty"` // Management: NodeManagement configuration for this NodePool. @@ -580,9 +582,9 @@ type AutoprovisioningNodePoolDefaults struct { // platform // (https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform). // This field is deprecated, min_cpu_platform should be specified using - // https://cloud.google.com/requested-min-cpu-platform label selector on - // the pod. To unset the min cpu platform field pass "automatic" as - // field value. + // `cloud.google.com/requested-min-cpu-platform` label selector on the + // pod. To unset the min cpu platform field pass "automatic" as field + // value. MinCpuPlatform string `json:"minCpuPlatform,omitempty"` // OauthScopes: The set of Google API scopes to be made available on all @@ -4355,7 +4357,9 @@ type NodeConfig struct { Gvnic *VirtualNIC `json:"gvnic,omitempty"` // ImageType: The image type to use for this node. Note that for a given - // image type, the latest version of it will be used. + // image type, the latest version of it will be used. Please see + // https://cloud.google.com/kubernetes-engine/docs/concepts/node-images + // for available image types. ImageType string `json:"imageType,omitempty"` // KubeletConfig: Node kubelet configs. @@ -4845,7 +4849,9 @@ type NodePool struct { // upgrade. UpgradeSettings *UpgradeSettings `json:"upgradeSettings,omitempty"` - // Version: The version of the Kubernetes of this node. + // Version: The version of Kubernetes running on this NodePool's nodes. + // If unspecified, it defaults as described here + // (https://cloud.google.com/kubernetes-engine/versioning#specifying_node_version). Version string `json:"version,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -7327,7 +7333,10 @@ type UpdateNodePoolRequest struct { // Gvnic: Enable or disable gvnic on the node pool. Gvnic *VirtualNIC `json:"gvnic,omitempty"` - // ImageType: Required. The desired image type for the node pool. + // ImageType: Required. The desired image type for the node pool. Please + // see + // https://cloud.google.com/kubernetes-engine/docs/concepts/node-images + // for available image types. ImageType string `json:"imageType,omitempty"` // KubeletConfig: Node kubelet configs. @@ -7577,7 +7586,9 @@ type UpgradeSettings struct { // Strategy: Update strategy of the node pool. // // Possible values: - // "NODE_POOL_UPDATE_STRATEGY_UNSPECIFIED" - Default value. + // "NODE_POOL_UPDATE_STRATEGY_UNSPECIFIED" - Default value if unset. + // GKE internally defaults the update strategy to SURGE for unspecified + // strategies. // "BLUE_GREEN" - blue-green upgrade. // "SURGE" - SURGE is the traditional way of upgrading a node pool. // max_surge and max_unavailable determines the level of upgrade diff --git a/containeranalysis/v1/containeranalysis-api.json b/containeranalysis/v1/containeranalysis-api.json index 0d4e5cf9cda..d98b7c896b4 100644 --- a/containeranalysis/v1/containeranalysis-api.json +++ b/containeranalysis/v1/containeranalysis-api.json @@ -755,7 +755,7 @@ } } }, - "revision": "20221107", + "revision": "20230120", "rootUrl": "https://containeranalysis.googleapis.com/", "schemas": { "AliasContext": { @@ -1972,7 +1972,7 @@ "type": "array" }, "timeout": { - "description": "Amount of time that this build should be allowed to run, to second granularity. If this amount of time elapses, work on the build will cease and the build status will be `TIMEOUT`. `timeout` starts ticking from `startTime`. Default time is ten minutes.", + "description": "Amount of time that this build should be allowed to run, to second granularity. If this amount of time elapses, work on the build will cease and the build status will be `TIMEOUT`. `timeout` starts ticking from `startTime`. Default time is 60 minutes.", "format": "google-duration", "type": "string" }, diff --git a/containeranalysis/v1/containeranalysis-gen.go b/containeranalysis/v1/containeranalysis-gen.go index 7a4cc0da916..7e6810d43d1 100644 --- a/containeranalysis/v1/containeranalysis-gen.go +++ b/containeranalysis/v1/containeranalysis-gen.go @@ -1855,7 +1855,7 @@ type ContaineranalysisGoogleDevtoolsCloudbuildV1Build struct { // Timeout: Amount of time that this build should be allowed to run, to // second granularity. If this amount of time elapses, work on the build // will cease and the build status will be `TIMEOUT`. `timeout` starts - // ticking from `startTime`. Default time is ten minutes. + // ticking from `startTime`. Default time is 60 minutes. Timeout string `json:"timeout,omitempty"` // Timing: Output only. Stores timing information for phases of the diff --git a/containeranalysis/v1alpha1/containeranalysis-api.json b/containeranalysis/v1alpha1/containeranalysis-api.json index 8eb89b7078e..b883a5f6290 100644 --- a/containeranalysis/v1alpha1/containeranalysis-api.json +++ b/containeranalysis/v1alpha1/containeranalysis-api.json @@ -1229,7 +1229,7 @@ } } }, - "revision": "20221107", + "revision": "20230120", "rootUrl": "https://containeranalysis.googleapis.com/", "schemas": { "AnalysisCompleted": { @@ -2271,7 +2271,7 @@ "type": "array" }, "timeout": { - "description": "Amount of time that this build should be allowed to run, to second granularity. If this amount of time elapses, work on the build will cease and the build status will be `TIMEOUT`. `timeout` starts ticking from `startTime`. Default time is ten minutes.", + "description": "Amount of time that this build should be allowed to run, to second granularity. If this amount of time elapses, work on the build will cease and the build status will be `TIMEOUT`. `timeout` starts ticking from `startTime`. Default time is 60 minutes.", "format": "google-duration", "type": "string" }, diff --git a/containeranalysis/v1alpha1/containeranalysis-gen.go b/containeranalysis/v1alpha1/containeranalysis-gen.go index 03abbb85807..ecc33f9ea96 100644 --- a/containeranalysis/v1alpha1/containeranalysis-gen.go +++ b/containeranalysis/v1alpha1/containeranalysis-gen.go @@ -1738,7 +1738,7 @@ type ContaineranalysisGoogleDevtoolsCloudbuildV1Build struct { // Timeout: Amount of time that this build should be allowed to run, to // second granularity. If this amount of time elapses, work on the build // will cease and the build status will be `TIMEOUT`. `timeout` starts - // ticking from `startTime`. Default time is ten minutes. + // ticking from `startTime`. Default time is 60 minutes. Timeout string `json:"timeout,omitempty"` // Timing: Output only. Stores timing information for phases of the diff --git a/containeranalysis/v1beta1/containeranalysis-api.json b/containeranalysis/v1beta1/containeranalysis-api.json index 2bac5252920..846ba09b32d 100644 --- a/containeranalysis/v1beta1/containeranalysis-api.json +++ b/containeranalysis/v1beta1/containeranalysis-api.json @@ -755,7 +755,7 @@ } } }, - "revision": "20221112", + "revision": "20230120", "rootUrl": "https://containeranalysis.googleapis.com/", "schemas": { "AliasContext": { @@ -1903,7 +1903,7 @@ "type": "array" }, "timeout": { - "description": "Amount of time that this build should be allowed to run, to second granularity. If this amount of time elapses, work on the build will cease and the build status will be `TIMEOUT`. `timeout` starts ticking from `startTime`. Default time is ten minutes.", + "description": "Amount of time that this build should be allowed to run, to second granularity. If this amount of time elapses, work on the build will cease and the build status will be `TIMEOUT`. `timeout` starts ticking from `startTime`. Default time is 60 minutes.", "format": "google-duration", "type": "string" }, diff --git a/containeranalysis/v1beta1/containeranalysis-gen.go b/containeranalysis/v1beta1/containeranalysis-gen.go index 77180610222..847aa1ea335 100644 --- a/containeranalysis/v1beta1/containeranalysis-gen.go +++ b/containeranalysis/v1beta1/containeranalysis-gen.go @@ -1746,7 +1746,7 @@ type ContaineranalysisGoogleDevtoolsCloudbuildV1Build struct { // Timeout: Amount of time that this build should be allowed to run, to // second granularity. If this amount of time elapses, work on the build // will cease and the build status will be `TIMEOUT`. `timeout` starts - // ticking from `startTime`. Default time is ten minutes. + // ticking from `startTime`. Default time is 60 minutes. Timeout string `json:"timeout,omitempty"` // Timing: Output only. Stores timing information for phases of the diff --git a/file/v1/file-api.json b/file/v1/file-api.json index e5d84df98f8..0a30ee5b90d 100644 --- a/file/v1/file-api.json +++ b/file/v1/file-api.json @@ -846,7 +846,7 @@ } } }, - "revision": "20221207", + "revision": "20230118", "rootUrl": "https://file.googleapis.com/", "schemas": { "Backup": { @@ -875,6 +875,10 @@ "readOnly": true, "type": "string" }, + "kmsKey": { + "description": "Immutable. KMS key name used for data encryption.", + "type": "string" + }, "labels": { "additionalProperties": { "type": "string" @@ -1048,10 +1052,11 @@ "type": "object" }, "GoogleCloudSaasacceleratorManagementProvidersV1Instance": { + "description": "Instance represents the interface for SLM services to actuate the state of control plane resources. Example Instance in JSON, where consumer-project-number=123456, producer-project-id=cloud-sql: ```json Instance: { \"name\": \"projects/123456/locations/us-east1/instances/prod-instance\", \"create_time\": { \"seconds\": 1526406431, }, \"labels\": { \"env\": \"prod\", \"foo\": \"bar\" }, \"state\": READY, \"software_versions\": { \"software_update\": \"cloud-sql-09-28-2018\", }, \"maintenance_policy_names\": { \"UpdatePolicy\": \"projects/123456/locations/us-east1/maintenancePolicies/prod-update-policy\", } \"tenant_project_id\": \"cloud-sql-test-tenant\", \"producer_metadata\": { \"cloud-sql-tier\": \"basic\", \"cloud-sql-instance-size\": \"1G\", }, \"provisioned_resources\": [ { \"resource-type\": \"compute-instance\", \"resource-url\": \"https://www.googleapis.com/compute/v1/projects/cloud-sql/zones/us-east1-b/instances/vm-1\", } ], \"maintenance_schedules\": { \"csa_rollout\": { \"start_time\": { \"seconds\": 1526406431, }, \"end_time\": { \"seconds\": 1535406431, }, }, \"ncsa_rollout\": { \"start_time\": { \"seconds\": 1526406431, }, \"end_time\": { \"seconds\": 1535406431, }, } }, \"consumer_defined_name\": \"my-sql-instance1\", } ``` LINT.IfChange", "id": "GoogleCloudSaasacceleratorManagementProvidersV1Instance", "properties": { "consumerDefinedName": { - "description": "consumer_defined_name is the name that is set by the consumer. On the other hand Name field represents system-assigned id of an instance so consumers are not necessarily aware of it. consumer_defined_name is used for notification/UI purposes for consumer to recognize their instances.", + "description": "consumer_defined_name is the name of the instance set by the service consumers. Generally this is different from the `name` field which reperesents the system-assigned id of the instance which the service consumers do not recognize. This is a required field for tenants onboarding to Maintenance Window notifications (go/slm-rollout-maintenance-policies#prerequisites).", "type": "string" }, "createTime": { @@ -1075,7 +1080,7 @@ "additionalProperties": { "type": "string" }, - "description": "Optional. Deprecated. The MaintenancePolicies that have been attached to the instance. The key must be of the type name of the oneof policy name defined in MaintenancePolicy, and the referenced policy must define the same policy type. For complete details of MaintenancePolicy, please refer to go/cloud-saas-mw-ug.", + "description": "Optional. The MaintenancePolicies that have been attached to the instance. The key must be of the type name of the oneof policy name defined in MaintenancePolicy, and the referenced policy must define the same policy type. For details, please refer to go/cloud-saas-mw-ug. Should not be set if maintenance_settings.maintenance_policies is set.", "type": "object" }, "maintenanceSchedules": { @@ -1215,7 +1220,7 @@ "additionalProperties": { "$ref": "MaintenancePolicy" }, - "description": "Optional. The MaintenancePolicies that have been attached to the instance. The key must be of the type name of the oneof policy name defined in MaintenancePolicy, and the embedded policy must define the same policy type. For complete details of MaintenancePolicy, please refer to go/cloud-saas-mw-ug. If only the name is needed, then only populate MaintenancePolicy.name.", + "description": "Optional. The MaintenancePolicies that have been attached to the instance. The key must be of the type name of the oneof policy name defined in MaintenancePolicy, and the embedded policy must define the same policy type. For details, please refer to go/cloud-saas-mw-ug. Should not be set if maintenance_policy_names is set. If only the name is needed, then only populate MaintenancePolicy.name.", "type": "object" } }, diff --git a/file/v1/file-gen.go b/file/v1/file-gen.go index a6786811017..ae86b435241 100644 --- a/file/v1/file-gen.go +++ b/file/v1/file-gen.go @@ -224,6 +224,9 @@ type Backup struct { // since sequential backups of the same disk will share storage. DownloadBytes int64 `json:"downloadBytes,omitempty,string"` + // KmsKey: Immutable. KMS key name used for data encryption. + KmsKey string `json:"kmsKey,omitempty"` + // Labels: Resource labels to represent user provided metadata. Labels map[string]string `json:"labels,omitempty"` @@ -490,12 +493,34 @@ func (s *FileShareConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudSaasacceleratorManagementProvidersV1Instance: Instance +// represents the interface for SLM services to actuate the state of +// control plane resources. Example Instance in JSON, where +// consumer-project-number=123456, producer-project-id=cloud-sql: +// ```json Instance: { "name": +// "projects/123456/locations/us-east1/instances/prod-instance", +// "create_time": { "seconds": 1526406431, }, "labels": { "env": "prod", +// "foo": "bar" }, "state": READY, "software_versions": { +// "software_update": "cloud-sql-09-28-2018", }, +// "maintenance_policy_names": { "UpdatePolicy": +// "projects/123456/locations/us-east1/maintenancePolicies/prod-update-po +// licy", } "tenant_project_id": "cloud-sql-test-tenant", +// "producer_metadata": { "cloud-sql-tier": "basic", +// "cloud-sql-instance-size": "1G", }, "provisioned_resources": [ { +// "resource-type": "compute-instance", "resource-url": +// "https://www.googleapis.com/compute/v1/projects/cloud-sql/zones/us-eas +// t1-b/instances/vm-1", } ], "maintenance_schedules": { "csa_rollout": +// { "start_time": { "seconds": 1526406431, }, "end_time": { "seconds": +// 1535406431, }, }, "ncsa_rollout": { "start_time": { "seconds": +// 1526406431, }, "end_time": { "seconds": 1535406431, }, } }, +// "consumer_defined_name": "my-sql-instance1", } ``` LINT.IfChange type GoogleCloudSaasacceleratorManagementProvidersV1Instance struct { - // ConsumerDefinedName: consumer_defined_name is the name that is set by - // the consumer. On the other hand Name field represents system-assigned - // id of an instance so consumers are not necessarily aware of it. - // consumer_defined_name is used for notification/UI purposes for - // consumer to recognize their instances. + // ConsumerDefinedName: consumer_defined_name is the name of the + // instance set by the service consumers. Generally this is different + // from the `name` field which reperesents the system-assigned id of the + // instance which the service consumers do not recognize. This is a + // required field for tenants onboarding to Maintenance Window + // notifications (go/slm-rollout-maintenance-policies#prerequisites). ConsumerDefinedName string `json:"consumerDefinedName,omitempty"` // CreateTime: Output only. Timestamp when the resource was created. @@ -515,11 +540,12 @@ type GoogleCloudSaasacceleratorManagementProvidersV1Instance struct { // value are arbitrary strings provided by the user. Labels map[string]string `json:"labels,omitempty"` - // MaintenancePolicyNames: Optional. Deprecated. The MaintenancePolicies - // that have been attached to the instance. The key must be of the type - // name of the oneof policy name defined in MaintenancePolicy, and the - // referenced policy must define the same policy type. For complete - // details of MaintenancePolicy, please refer to go/cloud-saas-mw-ug. + // MaintenancePolicyNames: Optional. The MaintenancePolicies that have + // been attached to the instance. The key must be of the type name of + // the oneof policy name defined in MaintenancePolicy, and the + // referenced policy must define the same policy type. For details, + // please refer to go/cloud-saas-mw-ug. Should not be set if + // maintenance_settings.maintenance_policies is set. MaintenancePolicyNames map[string]string `json:"maintenancePolicyNames,omitempty"` // MaintenanceSchedules: The MaintenanceSchedule contains the scheduling @@ -686,9 +712,10 @@ type GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings struct { // MaintenancePolicies: Optional. The MaintenancePolicies that have been // attached to the instance. The key must be of the type name of the // oneof policy name defined in MaintenancePolicy, and the embedded - // policy must define the same policy type. For complete details of - // MaintenancePolicy, please refer to go/cloud-saas-mw-ug. If only the - // name is needed, then only populate MaintenancePolicy.name. + // policy must define the same policy type. For details, please refer to + // go/cloud-saas-mw-ug. Should not be set if maintenance_policy_names is + // set. If only the name is needed, then only populate + // MaintenancePolicy.name. MaintenancePolicies map[string]MaintenancePolicy `json:"maintenancePolicies,omitempty"` // ForceSendFields is a list of field names (e.g. "Exclude") to diff --git a/file/v1beta1/file-api.json b/file/v1beta1/file-api.json index 70fa4987daa..d0176bce481 100644 --- a/file/v1beta1/file-api.json +++ b/file/v1beta1/file-api.json @@ -1041,7 +1041,7 @@ } } }, - "revision": "20230103", + "revision": "20230118", "rootUrl": "https://file.googleapis.com/", "schemas": { "Backup": { @@ -1247,10 +1247,11 @@ "type": "object" }, "GoogleCloudSaasacceleratorManagementProvidersV1Instance": { + "description": "Instance represents the interface for SLM services to actuate the state of control plane resources. Example Instance in JSON, where consumer-project-number=123456, producer-project-id=cloud-sql: ```json Instance: { \"name\": \"projects/123456/locations/us-east1/instances/prod-instance\", \"create_time\": { \"seconds\": 1526406431, }, \"labels\": { \"env\": \"prod\", \"foo\": \"bar\" }, \"state\": READY, \"software_versions\": { \"software_update\": \"cloud-sql-09-28-2018\", }, \"maintenance_policy_names\": { \"UpdatePolicy\": \"projects/123456/locations/us-east1/maintenancePolicies/prod-update-policy\", } \"tenant_project_id\": \"cloud-sql-test-tenant\", \"producer_metadata\": { \"cloud-sql-tier\": \"basic\", \"cloud-sql-instance-size\": \"1G\", }, \"provisioned_resources\": [ { \"resource-type\": \"compute-instance\", \"resource-url\": \"https://www.googleapis.com/compute/v1/projects/cloud-sql/zones/us-east1-b/instances/vm-1\", } ], \"maintenance_schedules\": { \"csa_rollout\": { \"start_time\": { \"seconds\": 1526406431, }, \"end_time\": { \"seconds\": 1535406431, }, }, \"ncsa_rollout\": { \"start_time\": { \"seconds\": 1526406431, }, \"end_time\": { \"seconds\": 1535406431, }, } }, \"consumer_defined_name\": \"my-sql-instance1\", } ``` LINT.IfChange", "id": "GoogleCloudSaasacceleratorManagementProvidersV1Instance", "properties": { "consumerDefinedName": { - "description": "consumer_defined_name is the name that is set by the consumer. On the other hand Name field represents system-assigned id of an instance so consumers are not necessarily aware of it. consumer_defined_name is used for notification/UI purposes for consumer to recognize their instances.", + "description": "consumer_defined_name is the name of the instance set by the service consumers. Generally this is different from the `name` field which reperesents the system-assigned id of the instance which the service consumers do not recognize. This is a required field for tenants onboarding to Maintenance Window notifications (go/slm-rollout-maintenance-policies#prerequisites).", "type": "string" }, "createTime": { @@ -1274,7 +1275,7 @@ "additionalProperties": { "type": "string" }, - "description": "Optional. Deprecated. The MaintenancePolicies that have been attached to the instance. The key must be of the type name of the oneof policy name defined in MaintenancePolicy, and the referenced policy must define the same policy type. For complete details of MaintenancePolicy, please refer to go/cloud-saas-mw-ug.", + "description": "Optional. The MaintenancePolicies that have been attached to the instance. The key must be of the type name of the oneof policy name defined in MaintenancePolicy, and the referenced policy must define the same policy type. For details, please refer to go/cloud-saas-mw-ug. Should not be set if maintenance_settings.maintenance_policies is set.", "type": "object" }, "maintenanceSchedules": { @@ -1414,7 +1415,7 @@ "additionalProperties": { "$ref": "MaintenancePolicy" }, - "description": "Optional. The MaintenancePolicies that have been attached to the instance. The key must be of the type name of the oneof policy name defined in MaintenancePolicy, and the embedded policy must define the same policy type. For complete details of MaintenancePolicy, please refer to go/cloud-saas-mw-ug. If only the name is needed, then only populate MaintenancePolicy.name.", + "description": "Optional. The MaintenancePolicies that have been attached to the instance. The key must be of the type name of the oneof policy name defined in MaintenancePolicy, and the embedded policy must define the same policy type. For details, please refer to go/cloud-saas-mw-ug. Should not be set if maintenance_policy_names is set. If only the name is needed, then only populate MaintenancePolicy.name.", "type": "object" } }, diff --git a/file/v1beta1/file-gen.go b/file/v1beta1/file-gen.go index f179f43f256..33de0d7896a 100644 --- a/file/v1beta1/file-gen.go +++ b/file/v1beta1/file-gen.go @@ -505,12 +505,34 @@ func (s *FileShareConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudSaasacceleratorManagementProvidersV1Instance: Instance +// represents the interface for SLM services to actuate the state of +// control plane resources. Example Instance in JSON, where +// consumer-project-number=123456, producer-project-id=cloud-sql: +// ```json Instance: { "name": +// "projects/123456/locations/us-east1/instances/prod-instance", +// "create_time": { "seconds": 1526406431, }, "labels": { "env": "prod", +// "foo": "bar" }, "state": READY, "software_versions": { +// "software_update": "cloud-sql-09-28-2018", }, +// "maintenance_policy_names": { "UpdatePolicy": +// "projects/123456/locations/us-east1/maintenancePolicies/prod-update-po +// licy", } "tenant_project_id": "cloud-sql-test-tenant", +// "producer_metadata": { "cloud-sql-tier": "basic", +// "cloud-sql-instance-size": "1G", }, "provisioned_resources": [ { +// "resource-type": "compute-instance", "resource-url": +// "https://www.googleapis.com/compute/v1/projects/cloud-sql/zones/us-eas +// t1-b/instances/vm-1", } ], "maintenance_schedules": { "csa_rollout": +// { "start_time": { "seconds": 1526406431, }, "end_time": { "seconds": +// 1535406431, }, }, "ncsa_rollout": { "start_time": { "seconds": +// 1526406431, }, "end_time": { "seconds": 1535406431, }, } }, +// "consumer_defined_name": "my-sql-instance1", } ``` LINT.IfChange type GoogleCloudSaasacceleratorManagementProvidersV1Instance struct { - // ConsumerDefinedName: consumer_defined_name is the name that is set by - // the consumer. On the other hand Name field represents system-assigned - // id of an instance so consumers are not necessarily aware of it. - // consumer_defined_name is used for notification/UI purposes for - // consumer to recognize their instances. + // ConsumerDefinedName: consumer_defined_name is the name of the + // instance set by the service consumers. Generally this is different + // from the `name` field which reperesents the system-assigned id of the + // instance which the service consumers do not recognize. This is a + // required field for tenants onboarding to Maintenance Window + // notifications (go/slm-rollout-maintenance-policies#prerequisites). ConsumerDefinedName string `json:"consumerDefinedName,omitempty"` // CreateTime: Output only. Timestamp when the resource was created. @@ -530,11 +552,12 @@ type GoogleCloudSaasacceleratorManagementProvidersV1Instance struct { // value are arbitrary strings provided by the user. Labels map[string]string `json:"labels,omitempty"` - // MaintenancePolicyNames: Optional. Deprecated. The MaintenancePolicies - // that have been attached to the instance. The key must be of the type - // name of the oneof policy name defined in MaintenancePolicy, and the - // referenced policy must define the same policy type. For complete - // details of MaintenancePolicy, please refer to go/cloud-saas-mw-ug. + // MaintenancePolicyNames: Optional. The MaintenancePolicies that have + // been attached to the instance. The key must be of the type name of + // the oneof policy name defined in MaintenancePolicy, and the + // referenced policy must define the same policy type. For details, + // please refer to go/cloud-saas-mw-ug. Should not be set if + // maintenance_settings.maintenance_policies is set. MaintenancePolicyNames map[string]string `json:"maintenancePolicyNames,omitempty"` // MaintenanceSchedules: The MaintenanceSchedule contains the scheduling @@ -701,9 +724,10 @@ type GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings struct { // MaintenancePolicies: Optional. The MaintenancePolicies that have been // attached to the instance. The key must be of the type name of the // oneof policy name defined in MaintenancePolicy, and the embedded - // policy must define the same policy type. For complete details of - // MaintenancePolicy, please refer to go/cloud-saas-mw-ug. If only the - // name is needed, then only populate MaintenancePolicy.name. + // policy must define the same policy type. For details, please refer to + // go/cloud-saas-mw-ug. Should not be set if maintenance_policy_names is + // set. If only the name is needed, then only populate + // MaintenancePolicy.name. MaintenancePolicies map[string]MaintenancePolicy `json:"maintenancePolicies,omitempty"` // ForceSendFields is a list of field names (e.g. "Exclude") to diff --git a/iap/v1/iap-api.json b/iap/v1/iap-api.json index 1910eff2789..a45b795a4c1 100644 --- a/iap/v1/iap-api.json +++ b/iap/v1/iap-api.json @@ -652,7 +652,7 @@ } } }, - "revision": "20230118", + "revision": "20230125", "rootUrl": "https://iap.googleapis.com/", "schemas": { "AccessDeniedPageSettings": { @@ -1101,13 +1101,15 @@ "METHOD_UNSPECIFIED", "LOGIN", "PASSWORD", - "SECURE_KEY" + "SECURE_KEY", + "ENROLLED_SECOND_FACTORS" ], "enumDescriptions": [ "Reauthentication disabled.", "Prompts the user to log in again.", "Deprecated, no longer accepted by IAP APIs.", - "User must use their secure key 2nd factor device." + "User must use their secure key 2nd factor device.", + "User can use any enabled 2nd factor." ], "type": "string" }, diff --git a/iap/v1/iap-gen.go b/iap/v1/iap-gen.go index 3d0956c55ae..7523e7c8097 100644 --- a/iap/v1/iap-gen.go +++ b/iap/v1/iap-gen.go @@ -1250,6 +1250,7 @@ type ReauthSettings struct { // "LOGIN" - Prompts the user to log in again. // "PASSWORD" - Deprecated, no longer accepted by IAP APIs. // "SECURE_KEY" - User must use their secure key 2nd factor device. + // "ENROLLED_SECOND_FACTORS" - User can use any enabled 2nd factor. Method string `json:"method,omitempty"` // PolicyType: How IAP determines the effective policy in cases of diff --git a/memcache/v1beta2/memcache-api.json b/memcache/v1beta2/memcache-api.json index cb4441fe431..cc42e6eadb9 100644 --- a/memcache/v1beta2/memcache-api.json +++ b/memcache/v1beta2/memcache-api.json @@ -584,7 +584,7 @@ } } }, - "revision": "20230103", + "revision": "20230111", "rootUrl": "https://memcache.googleapis.com/", "schemas": { "ApplyParametersRequest": { @@ -787,6 +787,7 @@ "type": "object" }, "GoogleCloudSaasacceleratorManagementProvidersV1Instance": { + "description": "Instance represents the interface for SLM services to actuate the state of control plane resources. Example Instance in JSON, where consumer-project-number=123456, producer-project-id=cloud-sql: ```json Instance: { \"name\": \"projects/123456/locations/us-east1/instances/prod-instance\", \"create_time\": { \"seconds\": 1526406431, }, \"labels\": { \"env\": \"prod\", \"foo\": \"bar\" }, \"state\": READY, \"software_versions\": { \"software_update\": \"cloud-sql-09-28-2018\", }, \"maintenance_policy_names\": { \"UpdatePolicy\": \"projects/123456/locations/us-east1/maintenancePolicies/prod-update-policy\", } \"tenant_project_id\": \"cloud-sql-test-tenant\", \"producer_metadata\": { \"cloud-sql-tier\": \"basic\", \"cloud-sql-instance-size\": \"1G\", }, \"provisioned_resources\": [ { \"resource-type\": \"compute-instance\", \"resource-url\": \"https://www.googleapis.com/compute/v1/projects/cloud-sql/zones/us-east1-b/instances/vm-1\", } ], \"maintenance_schedules\": { \"csa_rollout\": { \"start_time\": { \"seconds\": 1526406431, }, \"end_time\": { \"seconds\": 1535406431, }, }, \"ncsa_rollout\": { \"start_time\": { \"seconds\": 1526406431, }, \"end_time\": { \"seconds\": 1535406431, }, } }, \"consumer_defined_name\": \"my-sql-instance1\", } ``` LINT.IfChange", "id": "GoogleCloudSaasacceleratorManagementProvidersV1Instance", "properties": { "consumerDefinedName": { @@ -814,7 +815,7 @@ "additionalProperties": { "type": "string" }, - "description": "Optional. Deprecated. The MaintenancePolicies that have been attached to the instance. The key must be of the type name of the oneof policy name defined in MaintenancePolicy, and the referenced policy must define the same policy type. For complete details of MaintenancePolicy, please refer to go/cloud-saas-mw-ug.", + "description": "Optional. The MaintenancePolicies that have been attached to the instance. The key must be of the type name of the oneof policy name defined in MaintenancePolicy, and the referenced policy must define the same policy type. For details, please refer to go/cloud-saas-mw-ug. Should not be set if maintenance_settings.maintenance_policies is set.", "type": "object" }, "maintenanceSchedules": { @@ -954,7 +955,7 @@ "additionalProperties": { "$ref": "MaintenancePolicy" }, - "description": "Optional. The MaintenancePolicies that have been attached to the instance. The key must be of the type name of the oneof policy name defined in MaintenancePolicy, and the embedded policy must define the same policy type. For complete details of MaintenancePolicy, please refer to go/cloud-saas-mw-ug. If only the name is needed, then only populate MaintenancePolicy.name.", + "description": "Optional. The MaintenancePolicies that have been attached to the instance. The key must be of the type name of the oneof policy name defined in MaintenancePolicy, and the embedded policy must define the same policy type. For details, please refer to go/cloud-saas-mw-ug. Should not be set if maintenance_policy_names is set. If only the name is needed, then only populate MaintenancePolicy.name.", "type": "object" } }, diff --git a/memcache/v1beta2/memcache-gen.go b/memcache/v1beta2/memcache-gen.go index 9b01a85690d..7d36a77db86 100644 --- a/memcache/v1beta2/memcache-gen.go +++ b/memcache/v1beta2/memcache-gen.go @@ -520,6 +520,27 @@ func (s *GoogleCloudMemcacheV1beta2OperationMetadata) MarshalJSON() ([]byte, err type GoogleCloudMemcacheV1beta2ZoneMetadata struct { } +// GoogleCloudSaasacceleratorManagementProvidersV1Instance: Instance +// represents the interface for SLM services to actuate the state of +// control plane resources. Example Instance in JSON, where +// consumer-project-number=123456, producer-project-id=cloud-sql: +// ```json Instance: { "name": +// "projects/123456/locations/us-east1/instances/prod-instance", +// "create_time": { "seconds": 1526406431, }, "labels": { "env": "prod", +// "foo": "bar" }, "state": READY, "software_versions": { +// "software_update": "cloud-sql-09-28-2018", }, +// "maintenance_policy_names": { "UpdatePolicy": +// "projects/123456/locations/us-east1/maintenancePolicies/prod-update-po +// licy", } "tenant_project_id": "cloud-sql-test-tenant", +// "producer_metadata": { "cloud-sql-tier": "basic", +// "cloud-sql-instance-size": "1G", }, "provisioned_resources": [ { +// "resource-type": "compute-instance", "resource-url": +// "https://www.googleapis.com/compute/v1/projects/cloud-sql/zones/us-eas +// t1-b/instances/vm-1", } ], "maintenance_schedules": { "csa_rollout": +// { "start_time": { "seconds": 1526406431, }, "end_time": { "seconds": +// 1535406431, }, }, "ncsa_rollout": { "start_time": { "seconds": +// 1526406431, }, "end_time": { "seconds": 1535406431, }, } }, +// "consumer_defined_name": "my-sql-instance1", } ``` LINT.IfChange type GoogleCloudSaasacceleratorManagementProvidersV1Instance struct { // ConsumerDefinedName: consumer_defined_name is the name that is set by // the consumer. On the other hand Name field represents system-assigned @@ -545,11 +566,12 @@ type GoogleCloudSaasacceleratorManagementProvidersV1Instance struct { // value are arbitrary strings provided by the user. Labels map[string]string `json:"labels,omitempty"` - // MaintenancePolicyNames: Optional. Deprecated. The MaintenancePolicies - // that have been attached to the instance. The key must be of the type - // name of the oneof policy name defined in MaintenancePolicy, and the - // referenced policy must define the same policy type. For complete - // details of MaintenancePolicy, please refer to go/cloud-saas-mw-ug. + // MaintenancePolicyNames: Optional. The MaintenancePolicies that have + // been attached to the instance. The key must be of the type name of + // the oneof policy name defined in MaintenancePolicy, and the + // referenced policy must define the same policy type. For details, + // please refer to go/cloud-saas-mw-ug. Should not be set if + // maintenance_settings.maintenance_policies is set. MaintenancePolicyNames map[string]string `json:"maintenancePolicyNames,omitempty"` // MaintenanceSchedules: The MaintenanceSchedule contains the scheduling @@ -716,9 +738,10 @@ type GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings struct { // MaintenancePolicies: Optional. The MaintenancePolicies that have been // attached to the instance. The key must be of the type name of the // oneof policy name defined in MaintenancePolicy, and the embedded - // policy must define the same policy type. For complete details of - // MaintenancePolicy, please refer to go/cloud-saas-mw-ug. If only the - // name is needed, then only populate MaintenancePolicy.name. + // policy must define the same policy type. For details, please refer to + // go/cloud-saas-mw-ug. Should not be set if maintenance_policy_names is + // set. If only the name is needed, then only populate + // MaintenancePolicy.name. MaintenancePolicies map[string]MaintenancePolicy `json:"maintenancePolicies,omitempty"` // ForceSendFields is a list of field names (e.g. "Exclude") to diff --git a/mybusinessverifications/v1/mybusinessverifications-api.json b/mybusinessverifications/v1/mybusinessverifications-api.json index dd3b282373c..83de1829394 100644 --- a/mybusinessverifications/v1/mybusinessverifications-api.json +++ b/mybusinessverifications/v1/mybusinessverifications-api.json @@ -256,7 +256,7 @@ } } }, - "revision": "20220815", + "revision": "20230126", "rootUrl": "https://mybusinessverifications.googleapis.com/", "schemas": { "AddressVerificationData": { @@ -516,6 +516,10 @@ "description": "A verification represents a verification attempt on a location.", "id": "Verification", "properties": { + "announcement": { + "description": "Optional. Response announcement set only if the method is VETTED_PARTNER.", + "type": "string" + }, "createTime": { "description": "The timestamp when the verification is requested.", "format": "google-datetime", @@ -574,6 +578,10 @@ "$ref": "AddressVerificationData", "description": "Set only if the method is MAIL." }, + "announcement": { + "description": "Set only if the method is VETTED_PARTNER.", + "type": "string" + }, "emailData": { "$ref": "EmailVerificationData", "description": "Set only if the method is EMAIL." diff --git a/mybusinessverifications/v1/mybusinessverifications-gen.go b/mybusinessverifications/v1/mybusinessverifications-gen.go index 97eeedd2ecc..434b7d29eea 100644 --- a/mybusinessverifications/v1/mybusinessverifications-gen.go +++ b/mybusinessverifications/v1/mybusinessverifications-gen.go @@ -732,6 +732,10 @@ func (s *ServiceBusinessContext) MarshalJSON() ([]byte, error) { // Verification: A verification represents a verification attempt on a // location. type Verification struct { + // Announcement: Optional. Response announcement set only if the method + // is VETTED_PARTNER. + Announcement string `json:"announcement,omitempty"` + // CreateTime: The timestamp when the verification is requested. CreateTime string `json:"createTime,omitempty"` @@ -769,7 +773,7 @@ type Verification struct { // "FAILED" - The verification is failed. State string `json:"state,omitempty"` - // ForceSendFields is a list of field names (e.g. "CreateTime") to + // ForceSendFields is a list of field names (e.g. "Announcement") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -777,10 +781,10 @@ type Verification struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "CreateTime") to include in - // API requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. However, any field with an - // empty value appearing in NullFields will be sent to the server as + // NullFields is a list of field names (e.g. "Announcement") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` @@ -799,6 +803,9 @@ type VerificationOption struct { // AddressData: Set only if the method is MAIL. AddressData *AddressVerificationData `json:"addressData,omitempty"` + // Announcement: Set only if the method is VETTED_PARTNER. + Announcement string `json:"announcement,omitempty"` + // EmailData: Set only if the method is EMAIL. EmailData *EmailVerificationData `json:"emailData,omitempty"` diff --git a/run/v2/run-api.json b/run/v2/run-api.json index 9f94a578c07..fb2c2aa0ef4 100644 --- a/run/v2/run-api.json +++ b/run/v2/run-api.json @@ -1087,7 +1087,7 @@ } } }, - "revision": "20230113", + "revision": "20230122", "rootUrl": "https://run.googleapis.com/", "schemas": { "GoogleCloudRunV2BinaryAuthorization": { @@ -1287,7 +1287,7 @@ "type": "array" }, "image": { - "description": "Required. URL of the Container image in Google Container Registry or Google Artifact Registry. More info: https://kubernetes.io/docs/concepts/containers/images", + "description": "Required. Name of the container image in Dockerhub, Google Artifact Registry, or Google Container Registry. If the host is not provided, Dockerhub is assumed. More info: https://kubernetes.io/docs/concepts/containers/images", "type": "string" }, "livenessProbe": { diff --git a/run/v2/run-gen.go b/run/v2/run-gen.go index 5fee604abf3..ba04ab64809 100644 --- a/run/v2/run-gen.go +++ b/run/v2/run-gen.go @@ -468,8 +468,9 @@ type GoogleCloudRunV2Container struct { // Env: List of environment variables to set in the container. Env []*GoogleCloudRunV2EnvVar `json:"env,omitempty"` - // Image: Required. URL of the Container image in Google Container - // Registry or Google Artifact Registry. More info: + // Image: Required. Name of the container image in Dockerhub, Google + // Artifact Registry, or Google Container Registry. If the host is not + // provided, Dockerhub is assumed. More info: // https://kubernetes.io/docs/concepts/containers/images Image string `json:"image,omitempty"` diff --git a/runtimeconfig/v1beta1/runtimeconfig-api.json b/runtimeconfig/v1beta1/runtimeconfig-api.json index cdf6426b69c..9831036baa3 100644 --- a/runtimeconfig/v1beta1/runtimeconfig-api.json +++ b/runtimeconfig/v1beta1/runtimeconfig-api.json @@ -805,7 +805,7 @@ } } }, - "revision": "20220829", + "revision": "20230123", "rootUrl": "https://runtimeconfig.googleapis.com/", "schemas": { "Binding": { @@ -817,7 +817,7 @@ "description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)." }, "members": { - "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ", + "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding.", "items": { "type": "string" }, diff --git a/runtimeconfig/v1beta1/runtimeconfig-gen.go b/runtimeconfig/v1beta1/runtimeconfig-gen.go index eb7dc5692a6..93be9dde4fc 100644 --- a/runtimeconfig/v1beta1/runtimeconfig-gen.go +++ b/runtimeconfig/v1beta1/runtimeconfig-gen.go @@ -231,7 +231,9 @@ type Binding struct { // (https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). // For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. // * `group:{emailid}`: An email address that represents a Google group. - // For example, `admins@example.com`. * + // For example, `admins@example.com`. * `domain:{domain}`: The G Suite + // domain (primary) that represents all the users of that domain. For + // example, `google.com` or `example.com`. * // `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus // unique identifier) representing a user that has been recently // deleted. For example, `alice@example.com?uid=123456789012345678901`. @@ -248,9 +250,7 @@ type Binding struct { // that has been recently deleted. For example, // `admins@example.com?uid=123456789012345678901`. If the group is // recovered, this value reverts to `group:{emailid}` and the recovered - // group retains the role in the binding. * `domain:{domain}`: The G - // Suite domain (primary) that represents all the users of that domain. - // For example, `google.com` or `example.com`. + // group retains the role in the binding. Members []string `json:"members,omitempty"` // Role: Role that is assigned to the list of `members`, or principals. diff --git a/speech/v1/speech-api.json b/speech/v1/speech-api.json index 984d00bda4a..48ae9148360 100644 --- a/speech/v1/speech-api.json +++ b/speech/v1/speech-api.json @@ -524,7 +524,7 @@ } } }, - "revision": "20221202", + "revision": "20230119", "rootUrl": "https://speech.googleapis.com/", "schemas": { "ABNFGrammar": { @@ -781,11 +781,11 @@ "type": "object" }, "Phrase": { - "description": "A phrases containing words and phrase \"hints\" so that the speech recognition is more likely to recognize them. This can be used to improve the accuracy for specific words and phrases, for example, if specific commands are typically spoken by the user. This can also be used to add additional words to the vocabulary of the recognizer. See [usage limits](https://cloud.google.com/speech-to-text/quotas#content). List items can also include pre-built or custom classes containing groups of words that represent common concepts that occur in natural language. For example, rather than providing a phrase hint for every month of the year (e.g. \"i was born in january\", \"i was born in febuary\", ...), use the pre-built `$MONTH` class improves the likelihood of correctly transcribing audio that includes months (e.g. \"i was born in $month\"). To refer to pre-built classes, use the class' symbol prepended with `$` e.g. `$MONTH`. To refer to custom classes that were defined inline in the request, set the class's `custom_class_id` to a string unique to all class resources and inline classes. Then use the class' id wrapped in $`{...}` e.g. \"${my-months}\". To refer to custom classes resources, use the class' id wrapped in `${}` (e.g. `${my-months}`). Speech-to-Text supports three locations: `global`, `us` (US North America), and `eu` (Europe). If you are calling the `speech.googleapis.com` endpoint, use the `global` location. To specify a region, use a [regional endpoint](/speech-to-text/docs/endpoints) with matching `us` or `eu` location value.", + "description": "A phrases containing words and phrase \"hints\" so that the speech recognition is more likely to recognize them. This can be used to improve the accuracy for specific words and phrases, for example, if specific commands are typically spoken by the user. This can also be used to add additional words to the vocabulary of the recognizer. See [usage limits](https://cloud.google.com/speech-to-text/quotas#content). List items can also include pre-built or custom classes containing groups of words that represent common concepts that occur in natural language. For example, rather than providing a phrase hint for every month of the year (e.g. \"i was born in january\", \"i was born in febuary\", ...), use the pre-built `$MONTH` class improves the likelihood of correctly transcribing audio that includes months (e.g. \"i was born in $month\"). To refer to pre-built classes, use the class' symbol prepended with `$` e.g. `$MONTH`. To refer to custom classes that were defined inline in the request, set the class's `custom_class_id` to a string unique to all class resources and inline classes. Then use the class' id wrapped in $`{...}` e.g. \"${my-months}\". To refer to custom classes resources, use the class' id wrapped in `${}` (e.g. `${my-months}`). Speech-to-Text supports three locations: `global`, `us` (US North America), and `eu` (Europe). If you are calling the `speech.googleapis.com` endpoint, use the `global` location. To specify a region, use a [regional endpoint](https://cloud.google.com/speech-to-text/docs/endpoints) with matching `us` or `eu` location value.", "id": "Phrase", "properties": { "boost": { - "description": "Hint Boost. Overrides the boost set at the phrase set level. Positive value will increase the probability that a specific phrase will be recognized over other similar sounding phrases. The higher the boost, the higher the chance of false positive recognition as well. Negative boost will simply be ignored. Though `boost` can accept a wide range of positive values, most use cases are best served with values between 0 and 20. We recommend using a binary search approach to finding the optimal value for your use case. Speech recognition will skip PhraseSets with a boost value of 0.", + "description": "Hint Boost. Overrides the boost set at the phrase set level. Positive value will increase the probability that a specific phrase will be recognized over other similar sounding phrases. The higher the boost, the higher the chance of false positive recognition as well. Negative boost will simply be ignored. Though `boost` can accept a wide range of positive values, most use cases are best served with values between 0 and 20. We recommend using a binary search approach to finding the optimal value for your use case as well as adding phrases both with and without boost to your requests.", "format": "float", "type": "number" }, @@ -801,7 +801,7 @@ "id": "PhraseSet", "properties": { "boost": { - "description": "Hint Boost. Positive value will increase the probability that a specific phrase will be recognized over other similar sounding phrases. The higher the boost, the higher the chance of false positive recognition as well. Negative boost values would correspond to anti-biasing. Anti-biasing is not enabled, so negative boost will simply be ignored. Though `boost` can accept a wide range of positive values, most use cases are best served with values between 0 (exclusive) and 20. We recommend using a binary search approach to finding the optimal value for your use case. Speech recognition will skip PhraseSets with a boost value of 0.", + "description": "Hint Boost. Positive value will increase the probability that a specific phrase will be recognized over other similar sounding phrases. The higher the boost, the higher the chance of false positive recognition as well. Negative boost values would correspond to anti-biasing. Anti-biasing is not enabled, so negative boost will simply be ignored. Though `boost` can accept a wide range of positive values, most use cases are best served with values between 0 (exclusive) and 20. We recommend using a binary search approach to finding the optimal value for your use case as well as adding phrases both with and without boost to your requests.", "format": "float", "type": "number" }, diff --git a/speech/v1/speech-gen.go b/speech/v1/speech-gen.go index 8a295e33ad1..7b330311d68 100644 --- a/speech/v1/speech-gen.go +++ b/speech/v1/speech-gen.go @@ -721,8 +721,8 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // `us` (US North America), and `eu` (Europe). If you are calling the // `speech.googleapis.com` endpoint, use the `global` location. To // specify a region, use a regional endpoint -// (/speech-to-text/docs/endpoints) with matching `us` or `eu` location -// value. +// (https://cloud.google.com/speech-to-text/docs/endpoints) with +// matching `us` or `eu` location value. type Phrase struct { // Boost: Hint Boost. Overrides the boost set at the phrase set level. // Positive value will increase the probability that a specific phrase @@ -731,8 +731,8 @@ type Phrase struct { // well. Negative boost will simply be ignored. Though `boost` can // accept a wide range of positive values, most use cases are best // served with values between 0 and 20. We recommend using a binary - // search approach to finding the optimal value for your use case. - // Speech recognition will skip PhraseSets with a boost value of 0. + // search approach to finding the optimal value for your use case as + // well as adding phrases both with and without boost to your requests. Boost float64 `json:"boost,omitempty"` // Value: The phrase itself. @@ -786,8 +786,8 @@ type PhraseSet struct { // simply be ignored. Though `boost` can accept a wide range of positive // values, most use cases are best served with values between 0 // (exclusive) and 20. We recommend using a binary search approach to - // finding the optimal value for your use case. Speech recognition will - // skip PhraseSets with a boost value of 0. + // finding the optimal value for your use case as well as adding phrases + // both with and without boost to your requests. Boost float64 `json:"boost,omitempty"` // Name: The resource name of the phrase set. diff --git a/speech/v1p1beta1/speech-api.json b/speech/v1p1beta1/speech-api.json index 1e52679c5f2..1a041ac5cf8 100644 --- a/speech/v1p1beta1/speech-api.json +++ b/speech/v1p1beta1/speech-api.json @@ -524,7 +524,7 @@ } } }, - "revision": "20221202", + "revision": "20230119", "rootUrl": "https://speech.googleapis.com/", "schemas": { "ABNFGrammar": { @@ -805,11 +805,11 @@ "type": "object" }, "Phrase": { - "description": "A phrases containing words and phrase \"hints\" so that the speech recognition is more likely to recognize them. This can be used to improve the accuracy for specific words and phrases, for example, if specific commands are typically spoken by the user. This can also be used to add additional words to the vocabulary of the recognizer. See [usage limits](https://cloud.google.com/speech-to-text/quotas#content). List items can also include pre-built or custom classes containing groups of words that represent common concepts that occur in natural language. For example, rather than providing a phrase hint for every month of the year (e.g. \"i was born in january\", \"i was born in febuary\", ...), use the pre-built `$MONTH` class improves the likelihood of correctly transcribing audio that includes months (e.g. \"i was born in $month\"). To refer to pre-built classes, use the class' symbol prepended with `$` e.g. `$MONTH`. To refer to custom classes that were defined inline in the request, set the class's `custom_class_id` to a string unique to all class resources and inline classes. Then use the class' id wrapped in $`{...}` e.g. \"${my-months}\". To refer to custom classes resources, use the class' id wrapped in `${}` (e.g. `${my-months}`). Speech-to-Text supports three locations: `global`, `us` (US North America), and `eu` (Europe). If you are calling the `speech.googleapis.com` endpoint, use the `global` location. To specify a region, use a [regional endpoint](/speech-to-text/docs/endpoints) with matching `us` or `eu` location value.", + "description": "A phrases containing words and phrase \"hints\" so that the speech recognition is more likely to recognize them. This can be used to improve the accuracy for specific words and phrases, for example, if specific commands are typically spoken by the user. This can also be used to add additional words to the vocabulary of the recognizer. See [usage limits](https://cloud.google.com/speech-to-text/quotas#content). List items can also include pre-built or custom classes containing groups of words that represent common concepts that occur in natural language. For example, rather than providing a phrase hint for every month of the year (e.g. \"i was born in january\", \"i was born in febuary\", ...), use the pre-built `$MONTH` class improves the likelihood of correctly transcribing audio that includes months (e.g. \"i was born in $month\"). To refer to pre-built classes, use the class' symbol prepended with `$` e.g. `$MONTH`. To refer to custom classes that were defined inline in the request, set the class's `custom_class_id` to a string unique to all class resources and inline classes. Then use the class' id wrapped in $`{...}` e.g. \"${my-months}\". To refer to custom classes resources, use the class' id wrapped in `${}` (e.g. `${my-months}`). Speech-to-Text supports three locations: `global`, `us` (US North America), and `eu` (Europe). If you are calling the `speech.googleapis.com` endpoint, use the `global` location. To specify a region, use a [regional endpoint](https://cloud.google.com/speech-to-text/docs/endpoints) with matching `us` or `eu` location value.", "id": "Phrase", "properties": { "boost": { - "description": "Hint Boost. Overrides the boost set at the phrase set level. Positive value will increase the probability that a specific phrase will be recognized over other similar sounding phrases. The higher the boost, the higher the chance of false positive recognition as well. Negative boost will simply be ignored. Though `boost` can accept a wide range of positive values, most use cases are best served with values between 0 and 20. We recommend using a binary search approach to finding the optimal value for your use case. Speech recognition will skip PhraseSets with a boost value of 0.", + "description": "Hint Boost. Overrides the boost set at the phrase set level. Positive value will increase the probability that a specific phrase will be recognized over other similar sounding phrases. The higher the boost, the higher the chance of false positive recognition as well. Negative boost will simply be ignored. Though `boost` can accept a wide range of positive values, most use cases are best served with values between 0 and 20. We recommend using a binary search approach to finding the optimal value for your use case as well as adding phrases both with and without boost to your requests.", "format": "float", "type": "number" }, @@ -825,7 +825,7 @@ "id": "PhraseSet", "properties": { "boost": { - "description": "Hint Boost. Positive value will increase the probability that a specific phrase will be recognized over other similar sounding phrases. The higher the boost, the higher the chance of false positive recognition as well. Negative boost values would correspond to anti-biasing. Anti-biasing is not enabled, so negative boost will simply be ignored. Though `boost` can accept a wide range of positive values, most use cases are best served with values between 0 (exclusive) and 20. We recommend using a binary search approach to finding the optimal value for your use case. Speech recognition will skip PhraseSets with a boost value of 0.", + "description": "Hint Boost. Positive value will increase the probability that a specific phrase will be recognized over other similar sounding phrases. The higher the boost, the higher the chance of false positive recognition as well. Negative boost values would correspond to anti-biasing. Anti-biasing is not enabled, so negative boost will simply be ignored. Though `boost` can accept a wide range of positive values, most use cases are best served with values between 0 (exclusive) and 20. We recommend using a binary search approach to finding the optimal value for your use case as well as adding phrases both with and without boost to your requests.", "format": "float", "type": "number" }, diff --git a/speech/v1p1beta1/speech-gen.go b/speech/v1p1beta1/speech-gen.go index 0d4b73e96d7..8ea31de28b6 100644 --- a/speech/v1p1beta1/speech-gen.go +++ b/speech/v1p1beta1/speech-gen.go @@ -759,8 +759,8 @@ func (s *Operation) MarshalJSON() ([]byte, error) { // `us` (US North America), and `eu` (Europe). If you are calling the // `speech.googleapis.com` endpoint, use the `global` location. To // specify a region, use a regional endpoint -// (/speech-to-text/docs/endpoints) with matching `us` or `eu` location -// value. +// (https://cloud.google.com/speech-to-text/docs/endpoints) with +// matching `us` or `eu` location value. type Phrase struct { // Boost: Hint Boost. Overrides the boost set at the phrase set level. // Positive value will increase the probability that a specific phrase @@ -769,8 +769,8 @@ type Phrase struct { // well. Negative boost will simply be ignored. Though `boost` can // accept a wide range of positive values, most use cases are best // served with values between 0 and 20. We recommend using a binary - // search approach to finding the optimal value for your use case. - // Speech recognition will skip PhraseSets with a boost value of 0. + // search approach to finding the optimal value for your use case as + // well as adding phrases both with and without boost to your requests. Boost float64 `json:"boost,omitempty"` // Value: The phrase itself. @@ -824,8 +824,8 @@ type PhraseSet struct { // simply be ignored. Though `boost` can accept a wide range of positive // values, most use cases are best served with values between 0 // (exclusive) and 20. We recommend using a binary search approach to - // finding the optimal value for your use case. Speech recognition will - // skip PhraseSets with a boost value of 0. + // finding the optimal value for your use case as well as adding phrases + // both with and without boost to your requests. Boost float64 `json:"boost,omitempty"` // Name: The resource name of the phrase set.