From 918e3d247ec3b8846ef27768755753653e6c9810 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Wed, 7 Aug 2024 00:28:18 -0700 Subject: [PATCH] feat(all): auto-regenerate discovery clients (#2724) --- aiplatform/v1/aiplatform-api.json | 158 +++++- aiplatform/v1/aiplatform-gen.go | 158 +++++- aiplatform/v1beta1/aiplatform-api.json | 234 ++++++++- aiplatform/v1beta1/aiplatform-gen.go | 325 +++++++++++- .../v1/androidmanagement-api.json | 8 +- androidmanagement/v1/androidmanagement-gen.go | 13 +- androidpublisher/v3/androidpublisher-api.json | 14 +- androidpublisher/v3/androidpublisher-gen.go | 42 +- backupdr/v1/backupdr-api.json | 446 +++++++++++++++- backupdr/v1/backupdr-gen.go | 472 ++++++++++++++++- batch/v1/batch-api.json | 22 +- batch/v1/batch-gen.go | 86 +-- beyondcorp/v1alpha/beyondcorp-api.json | 68 ++- beyondcorp/v1alpha/beyondcorp-gen.go | 66 +++ bigquery/v2/bigquery-api.json | 35 +- bigquery/v2/bigquery-gen.go | 42 ++ .../v1/bigqueryconnection-api.json | 4 +- .../v1/bigqueryconnection-gen.go | 3 +- .../v1/certificatemanager-api.json | 157 +++--- .../v1/certificatemanager-gen.go | 245 ++++++--- chat/v1/chat-api.json | 8 +- chat/v1/chat-gen.go | 1 - cloudasset/v1/cloudasset-api.json | 10 +- cloudasset/v1/cloudasset-gen.go | 28 +- cloudasset/v1beta1/cloudasset-api.json | 6 +- cloudasset/v1beta1/cloudasset-gen.go | 16 +- cloudasset/v1p1beta1/cloudasset-api.json | 6 +- cloudasset/v1p1beta1/cloudasset-gen.go | 16 +- cloudasset/v1p5beta1/cloudasset-api.json | 6 +- cloudasset/v1p5beta1/cloudasset-gen.go | 16 +- cloudasset/v1p7beta1/cloudasset-api.json | 6 +- cloudasset/v1p7beta1/cloudasset-gen.go | 16 +- cloudbuild/v2/cloudbuild-api.json | 8 +- cloudbuild/v2/cloudbuild-gen.go | 4 +- clouddeploy/v1/clouddeploy-api.json | 146 +++++- clouddeploy/v1/clouddeploy-gen.go | 161 ++++-- connectors/v1/connectors-api.json | 67 ++- connectors/v1/connectors-gen.go | 59 +++ connectors/v2/connectors-api.json | 39 +- connectors/v2/connectors-gen.go | 76 ++- dataplex/v1/dataplex-api.json | 4 +- dataplex/v1/dataplex-gen.go | 4 +- dialogflow/v3beta1/dialogflow-api.json | 118 ++++- dialogflow/v3beta1/dialogflow-gen.go | 147 +++++- dlp/v2/dlp-api.json | 14 +- dlp/v2/dlp-gen.go | 14 +- docs/v1/docs-api.json | 38 +- docs/v1/docs-gen.go | 90 +++- domains/v1/domains-api.json | 13 +- domains/v1/domains-gen.go | 20 +- domains/v1alpha2/domains-api.json | 13 +- domains/v1alpha2/domains-gen.go | 20 +- domains/v1beta1/domains-api.json | 13 +- domains/v1beta1/domains-gen.go | 20 +- drive/v2/drive-api.json | 4 +- drive/v2/drive-gen.go | 10 +- drive/v3/drive-api.json | 4 +- drive/v3/drive-gen.go | 10 +- firebaseml/v2beta/firebaseml-api.json | 6 +- firebaseml/v2beta/firebaseml-gen.go | 6 +- gkehub/v1/gkehub-api.json | 22 +- gkehub/v1/gkehub-gen.go | 23 + gkehub/v1alpha/gkehub-api.json | 22 +- gkehub/v1alpha/gkehub-gen.go | 23 + gkehub/v1beta/gkehub-api.json | 22 +- gkehub/v1beta/gkehub-gen.go | 23 + monitoring/v3/monitoring-api.json | 14 +- monitoring/v3/monitoring-gen.go | 9 +- .../v1/networkmanagement-api.json | 22 +- networkmanagement/v1/networkmanagement-gen.go | 24 +- .../v1beta1/networkmanagement-api.json | 22 +- .../v1beta1/networkmanagement-gen.go | 24 +- retail/v2/retail-api.json | 22 +- retail/v2/retail-gen.go | 30 +- retail/v2alpha/retail-api.json | 48 +- retail/v2alpha/retail-gen.go | 164 +++++- retail/v2beta/retail-api.json | 187 ++++++- retail/v2beta/retail-gen.go | 495 +++++++++++++++++- run/v1/run-api.json | 4 +- run/v1/run-gen.go | 15 +- sasportal/v1alpha1/sasportal-api.json | 6 +- sasportal/v1alpha1/sasportal-gen.go | 1 + secretmanager/v1/secretmanager-api.json | 7 +- secretmanager/v1beta1/secretmanager-api.json | 7 +- secretmanager/v1beta2/secretmanager-api.json | 7 +- workstations/v1/workstations-api.json | 10 +- workstations/v1/workstations-gen.go | 19 +- workstations/v1beta/workstations-api.json | 16 +- workstations/v1beta/workstations-gen.go | 27 +- 89 files changed, 4507 insertions(+), 669 deletions(-) diff --git a/aiplatform/v1/aiplatform-api.json b/aiplatform/v1/aiplatform-api.json index d5bf9b39f63..9842240bbdc 100644 --- a/aiplatform/v1/aiplatform-api.json +++ b/aiplatform/v1/aiplatform-api.json @@ -16976,7 +16976,7 @@ } } }, - "revision": "20240725", + "revision": "20240727", "rootUrl": "https://aiplatform.googleapis.com/", "schemas": { "CloudAiLargeModelsVisionGenerateVideoResponse": { @@ -19475,6 +19475,16 @@ "readOnly": true, "type": "string" }, + "satisfiesPzi": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "satisfiesPzs": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, "startTime": { "description": "Output only. Time when the CustomJob for the first time entered the `JOB_STATE_RUNNING` state.", "format": "google-datetime", @@ -19972,6 +19982,10 @@ "description": "Required. Immutable. The minimum number of machine replicas this DeployedModel will be always deployed on. This value must be greater than or equal to 1. If traffic against the DeployedModel increases, it may dynamically be deployed onto more replicas, and as traffic decreases, some of these extra replicas may be freed.", "format": "int32", "type": "integer" + }, + "spot": { + "description": "Optional. If true, schedule the deployment workload on [spot VMs](https://cloud.google.com/kubernetes-engine/docs/concepts/spot-vms).", + "type": "boolean" } }, "type": "object" @@ -23673,10 +23687,9 @@ "$ref": "GoogleCloudAiplatformV1Schema", "description": "Optional. The `Schema` object allows the definition of input and output data types. These types can be objects, but also primitives and arrays. Represents a select subset of an [OpenAPI 3.0 schema object](https://spec.openapis.org/oas/v3.0.3#schema). If set, a compatible response_mime_type must also be set. Compatible mimetypes: `application/json`: Schema for JSON response." }, - "seed": { - "description": "Optional. Seed.", - "format": "int32", - "type": "integer" + "routingConfig": { + "$ref": "GoogleCloudAiplatformV1GenerationConfigRoutingConfig", + "description": "Optional. Routing configuration." }, "stopSequences": { "description": "Optional. Stop sequences.", @@ -23703,6 +23716,55 @@ }, "type": "object" }, + "GoogleCloudAiplatformV1GenerationConfigRoutingConfig": { + "description": "Routing config.", + "id": "GoogleCloudAiplatformV1GenerationConfigRoutingConfig", + "properties": { + "autoMode": { + "$ref": "GoogleCloudAiplatformV1GenerationConfigRoutingConfigAutoRoutingMode", + "description": "Automated routing." + }, + "manualMode": { + "$ref": "GoogleCloudAiplatformV1GenerationConfigRoutingConfigManualRoutingMode", + "description": "Manual routing." + } + }, + "type": "object" + }, + "GoogleCloudAiplatformV1GenerationConfigRoutingConfigAutoRoutingMode": { + "description": "When automated routing is specified, the routing will be determined by the pretrained routing model and customer provided model routing preference.", + "id": "GoogleCloudAiplatformV1GenerationConfigRoutingConfigAutoRoutingMode", + "properties": { + "modelRoutingPreference": { + "description": "The model routing preference.", + "enum": [ + "UNKNOWN", + "PRIORITIZE_QUALITY", + "BALANCED", + "PRIORITIZE_COST" + ], + "enumDescriptions": [ + "Unspecified model routing preference.", + "Prefer higher quality over low cost.", + "Balanced model routing preference.", + "Prefer lower cost over higher quality." + ], + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudAiplatformV1GenerationConfigRoutingConfigManualRoutingMode": { + "description": "When manual routing is set, the specified model will be used directly.", + "id": "GoogleCloudAiplatformV1GenerationConfigRoutingConfigManualRoutingMode", + "properties": { + "modelName": { + "description": "The model name to use. Only the public LLM models are accepted. e.g. gemini-1.5-pro-001.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudAiplatformV1GenericOperationMetadata": { "description": "Generic Metadata shared by all operations.", "id": "GoogleCloudAiplatformV1GenericOperationMetadata", @@ -23973,6 +24035,16 @@ "format": "int32", "type": "integer" }, + "satisfiesPzi": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "satisfiesPzs": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, "startTime": { "description": "Output only. Time when the HyperparameterTuningJob for the first time entered the `JOB_STATE_RUNNING` state.", "format": "google-datetime", @@ -25666,7 +25738,7 @@ ], "enumDescriptions": [ "Unspecified accelerator type, which means no accelerator.", - "Nvidia Tesla K80 GPU.", + "Deprecated: Nvidia Tesla K80 GPU has reached end of support, see https://cloud.google.com/compute/docs/eol/k80-eol.", "Nvidia Tesla P100 GPU.", "Nvidia Tesla V100 GPU.", "Nvidia Tesla P4 GPU.", @@ -25686,6 +25758,10 @@ "description": "Immutable. The type of the machine. See the [list of machine types supported for prediction](https://cloud.google.com/vertex-ai/docs/predictions/configure-compute#machine-types) See the [list of machine types supported for custom training](https://cloud.google.com/vertex-ai/docs/training/configure-compute#machine-types). For DeployedModel this field is optional, and the default value is `n1-standard-2`. For BatchPredictionJob or as part of WorkerPoolSpec this field is required.", "type": "string" }, + "reservationAffinity": { + "$ref": "GoogleCloudAiplatformV1ReservationAffinity", + "description": "Optional. Immutable. Configuration controlling how this resource pool consumes reservation." + }, "tpuTopology": { "description": "Immutable. The topology of the TPUs. Corresponds to the TPU topologies available from GKE. (Example: tpu_topology: \"2x2x1\").", "type": "string" @@ -27361,6 +27437,16 @@ "$ref": "GoogleCloudAiplatformV1NasJobSpec", "description": "Required. The specification of a NasJob." }, + "satisfiesPzi": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "satisfiesPzs": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, "startTime": { "description": "Output only. Time when the NasJob for the first time entered the `JOB_STATE_RUNNING` state.", "format": "google-datetime", @@ -28040,6 +28126,10 @@ "description": "The display name of the NotebookExecutionJob. The name can be up to 128 characters long and can consist of any UTF-8 characters.", "type": "string" }, + "encryptionSpec": { + "$ref": "GoogleCloudAiplatformV1EncryptionSpec", + "description": "Customer-managed encryption key spec for the notebook execution job. This field is auto-populated if the NotebookRuntimeTemplate has an encryption spec." + }, "executionTimeout": { "description": "Max running time of the execution job in seconds (default 86400s / 24 hrs).", "format": "google-duration", @@ -29461,6 +29551,11 @@ "type": "string" }, "type": "array" + }, + "serviceAttachment": { + "description": "Output only. The name of the generated service attachment resource. This is only populated if the endpoint is deployed with PrivateServiceConnect.", + "readOnly": true, + "type": "string" } }, "type": "object" @@ -30714,6 +30809,40 @@ "properties": {}, "type": "object" }, + "GoogleCloudAiplatformV1ReservationAffinity": { + "description": "A ReservationAffinity can be used to configure a Vertex AI resource (e.g., a DeployedModel) to draw its Compute Engine resources from a Shared Reservation, or exclusively from on-demand capacity.", + "id": "GoogleCloudAiplatformV1ReservationAffinity", + "properties": { + "key": { + "description": "Optional. Corresponds to the label key of a reservation resource. To target a SPECIFIC_RESERVATION by name, use `compute.googleapis.com/reservation-name` as the key and specify the name of your reservation as its value.", + "type": "string" + }, + "reservationAffinityType": { + "description": "Required. Specifies the reservation affinity type.", + "enum": [ + "TYPE_UNSPECIFIED", + "NO_RESERVATION", + "ANY_RESERVATION", + "SPECIFIC_RESERVATION" + ], + "enumDescriptions": [ + "Default value. This should not be used.", + "Do not consume from any reserved capacity, only use on-demand.", + "Consume any reservation available, falling back to on-demand.", + "Consume from a specific reservation. When chosen, the reservation must be identified via the `key` and `values` fields." + ], + "type": "string" + }, + "values": { + "description": "Optional. Corresponds to the label values of a reservation resource. This must be the full resource name of the reservation.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudAiplatformV1ResourcePool": { "description": "Represents the spec of a group of resources of the same type, for example machine type, disk, and accelerators, in a PersistentResource.", "id": "GoogleCloudAiplatformV1ResourcePool", @@ -31407,12 +31536,23 @@ "enum": [ "STRATEGY_UNSPECIFIED", "ON_DEMAND", - "LOW_COST" + "LOW_COST", + "STANDARD", + "SPOT" + ], + "enumDeprecated": [ + false, + true, + true, + false, + false ], "enumDescriptions": [ - "Strategy will default to ON_DEMAND.", + "Strategy will default to STANDARD.", "Regular on-demand provisioning strategy.", - "Low cost by making potential use of spot resources." + "Low cost by making potential use of spot resources.", + "Standard provisioning strategy uses regular on-demand resources.", + "Spot provisioning strategy uses spot resources." ], "type": "string" }, diff --git a/aiplatform/v1/aiplatform-gen.go b/aiplatform/v1/aiplatform-gen.go index 49cdaeb0ab5..e775748bca7 100644 --- a/aiplatform/v1/aiplatform-gen.go +++ b/aiplatform/v1/aiplatform-gen.go @@ -5075,6 +5075,10 @@ type GoogleCloudAiplatformV1CustomJob struct { Labels map[string]string `json:"labels,omitempty"` // Name: Output only. Resource name of a CustomJob. Name string `json:"name,omitempty"` + // SatisfiesPzi: Output only. Reserved for future use. + SatisfiesPzi bool `json:"satisfiesPzi,omitempty"` + // SatisfiesPzs: Output only. Reserved for future use. + SatisfiesPzs bool `json:"satisfiesPzs,omitempty"` // StartTime: Output only. Time when the CustomJob for the first time entered // the `JOB_STATE_RUNNING` state. StartTime string `json:"startTime,omitempty"` @@ -5612,6 +5616,9 @@ type GoogleCloudAiplatformV1DedicatedResources struct { // dynamically be deployed onto more replicas, and as traffic decreases, some // of these extra replicas may be freed. MinReplicaCount int64 `json:"minReplicaCount,omitempty"` + // Spot: Optional. If true, schedule the deployment workload on spot VMs + // (https://cloud.google.com/kubernetes-engine/docs/concepts/spot-vms). + Spot bool `json:"spot,omitempty"` // ForceSendFields is a list of field names (e.g. "AutoscalingMetricSpecs") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -11118,8 +11125,8 @@ type GoogleCloudAiplatformV1GenerationConfig struct { // response_mime_type must also be set. Compatible mimetypes: // `application/json`: Schema for JSON response. ResponseSchema *GoogleCloudAiplatformV1Schema `json:"responseSchema,omitempty"` - // Seed: Optional. Seed. - Seed int64 `json:"seed,omitempty"` + // RoutingConfig: Optional. Routing configuration. + RoutingConfig *GoogleCloudAiplatformV1GenerationConfigRoutingConfig `json:"routingConfig,omitempty"` // StopSequences: Optional. Stop sequences. StopSequences []string `json:"stopSequences,omitempty"` // Temperature: Optional. Controls the randomness of predictions. @@ -11168,6 +11175,84 @@ func (s *GoogleCloudAiplatformV1GenerationConfig) UnmarshalJSON(data []byte) err return nil } +// GoogleCloudAiplatformV1GenerationConfigRoutingConfig: Routing config. +type GoogleCloudAiplatformV1GenerationConfigRoutingConfig struct { + // AutoMode: Automated routing. + AutoMode *GoogleCloudAiplatformV1GenerationConfigRoutingConfigAutoRoutingMode `json:"autoMode,omitempty"` + // ManualMode: Manual routing. + ManualMode *GoogleCloudAiplatformV1GenerationConfigRoutingConfigManualRoutingMode `json:"manualMode,omitempty"` + // ForceSendFields is a list of field names (e.g. "AutoMode") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AutoMode") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAiplatformV1GenerationConfigRoutingConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1GenerationConfigRoutingConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudAiplatformV1GenerationConfigRoutingConfigAutoRoutingMode: When +// automated routing is specified, the routing will be determined by the +// pretrained routing model and customer provided model routing preference. +type GoogleCloudAiplatformV1GenerationConfigRoutingConfigAutoRoutingMode struct { + // ModelRoutingPreference: The model routing preference. + // + // Possible values: + // "UNKNOWN" - Unspecified model routing preference. + // "PRIORITIZE_QUALITY" - Prefer higher quality over low cost. + // "BALANCED" - Balanced model routing preference. + // "PRIORITIZE_COST" - Prefer lower cost over higher quality. + ModelRoutingPreference string `json:"modelRoutingPreference,omitempty"` + // ForceSendFields is a list of field names (e.g. "ModelRoutingPreference") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ModelRoutingPreference") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAiplatformV1GenerationConfigRoutingConfigAutoRoutingMode) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1GenerationConfigRoutingConfigAutoRoutingMode + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudAiplatformV1GenerationConfigRoutingConfigManualRoutingMode: When +// manual routing is set, the specified model will be used directly. +type GoogleCloudAiplatformV1GenerationConfigRoutingConfigManualRoutingMode struct { + // ModelName: The model name to use. Only the public LLM models are accepted. + // e.g. gemini-1.5-pro-001. + ModelName string `json:"modelName,omitempty"` + // ForceSendFields is a list of field names (e.g. "ModelName") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ModelName") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAiplatformV1GenerationConfigRoutingConfigManualRoutingMode) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1GenerationConfigRoutingConfigManualRoutingMode + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAiplatformV1GenericOperationMetadata: Generic Metadata shared by // all operations. type GoogleCloudAiplatformV1GenericOperationMetadata struct { @@ -11532,6 +11617,10 @@ type GoogleCloudAiplatformV1HyperparameterTuningJob struct { // ParallelTrialCount: Required. The desired number of Trials to run in // parallel. ParallelTrialCount int64 `json:"parallelTrialCount,omitempty"` + // SatisfiesPzi: Output only. Reserved for future use. + SatisfiesPzi bool `json:"satisfiesPzi,omitempty"` + // SatisfiesPzs: Output only. Reserved for future use. + SatisfiesPzs bool `json:"satisfiesPzs,omitempty"` // StartTime: Output only. Time when the HyperparameterTuningJob for the first // time entered the `JOB_STATE_RUNNING` state. StartTime string `json:"startTime,omitempty"` @@ -13992,7 +14081,8 @@ type GoogleCloudAiplatformV1MachineSpec struct { // Possible values: // "ACCELERATOR_TYPE_UNSPECIFIED" - Unspecified accelerator type, which means // no accelerator. - // "NVIDIA_TESLA_K80" - Nvidia Tesla K80 GPU. + // "NVIDIA_TESLA_K80" - Deprecated: Nvidia Tesla K80 GPU has reached end of + // support, see https://cloud.google.com/compute/docs/eol/k80-eol. // "NVIDIA_TESLA_P100" - Nvidia Tesla P100 GPU. // "NVIDIA_TESLA_V100" - Nvidia Tesla V100 GPU. // "NVIDIA_TESLA_P4" - Nvidia Tesla P4 GPU. @@ -14015,6 +14105,9 @@ type GoogleCloudAiplatformV1MachineSpec struct { // `n1-standard-2`. For BatchPredictionJob or as part of WorkerPoolSpec this // field is required. MachineType string `json:"machineType,omitempty"` + // ReservationAffinity: Optional. Immutable. Configuration controlling how this + // resource pool consumes reservation. + ReservationAffinity *GoogleCloudAiplatformV1ReservationAffinity `json:"reservationAffinity,omitempty"` // TpuTopology: Immutable. The topology of the TPUs. Corresponds to the TPU // topologies available from GKE. (Example: tpu_topology: "2x2x1"). TpuTopology string `json:"tpuTopology,omitempty"` @@ -16391,6 +16484,10 @@ type GoogleCloudAiplatformV1NasJob struct { NasJobOutput *GoogleCloudAiplatformV1NasJobOutput `json:"nasJobOutput,omitempty"` // NasJobSpec: Required. The specification of a NasJob. NasJobSpec *GoogleCloudAiplatformV1NasJobSpec `json:"nasJobSpec,omitempty"` + // SatisfiesPzi: Output only. Reserved for future use. + SatisfiesPzi bool `json:"satisfiesPzi,omitempty"` + // SatisfiesPzs: Output only. Reserved for future use. + SatisfiesPzs bool `json:"satisfiesPzs,omitempty"` // StartTime: Output only. Time when the NasJob for the first time entered the // `JOB_STATE_RUNNING` state. StartTime string `json:"startTime,omitempty"` @@ -17286,6 +17383,10 @@ type GoogleCloudAiplatformV1NotebookExecutionJob struct { // DisplayName: The display name of the NotebookExecutionJob. The name can be // up to 128 characters long and can consist of any UTF-8 characters. DisplayName string `json:"displayName,omitempty"` + // EncryptionSpec: Customer-managed encryption key spec for the notebook + // execution job. This field is auto-populated if the NotebookRuntimeTemplate + // has an encryption spec. + EncryptionSpec *GoogleCloudAiplatformV1EncryptionSpec `json:"encryptionSpec,omitempty"` // ExecutionTimeout: Max running time of the execution job in seconds (default // 86400s / 24 hrs). ExecutionTimeout string `json:"executionTimeout,omitempty"` @@ -18935,6 +19036,10 @@ type GoogleCloudAiplatformV1PrivateServiceConnectConfig struct { // ProjectAllowlist: A list of Projects from which the forwarding rule will // target the service attachment. ProjectAllowlist []string `json:"projectAllowlist,omitempty"` + // ServiceAttachment: Output only. The name of the generated service attachment + // resource. This is only populated if the endpoint is deployed with + // PrivateServiceConnect. + ServiceAttachment string `json:"serviceAttachment,omitempty"` // ForceSendFields is a list of field names (e.g. // "EnablePrivateServiceConnect") to unconditionally include in API requests. // By default, fields with empty or default values are omitted from API @@ -20835,6 +20940,48 @@ type GoogleCloudAiplatformV1RemoveDatapointsResponse struct { googleapi.ServerResponse `json:"-"` } +// GoogleCloudAiplatformV1ReservationAffinity: A ReservationAffinity can be +// used to configure a Vertex AI resource (e.g., a DeployedModel) to draw its +// Compute Engine resources from a Shared Reservation, or exclusively from +// on-demand capacity. +type GoogleCloudAiplatformV1ReservationAffinity struct { + // Key: Optional. Corresponds to the label key of a reservation resource. To + // target a SPECIFIC_RESERVATION by name, use + // `compute.googleapis.com/reservation-name` as the key and specify the name of + // your reservation as its value. + Key string `json:"key,omitempty"` + // ReservationAffinityType: Required. Specifies the reservation affinity type. + // + // Possible values: + // "TYPE_UNSPECIFIED" - Default value. This should not be used. + // "NO_RESERVATION" - Do not consume from any reserved capacity, only use + // on-demand. + // "ANY_RESERVATION" - Consume any reservation available, falling back to + // on-demand. + // "SPECIFIC_RESERVATION" - Consume from a specific reservation. When chosen, + // the reservation must be identified via the `key` and `values` fields. + ReservationAffinityType string `json:"reservationAffinityType,omitempty"` + // Values: Optional. Corresponds to the label values of a reservation resource. + // This must be the full resource name of the reservation. + Values []string `json:"values,omitempty"` + // ForceSendFields is a list of field names (e.g. "Key") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Key") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAiplatformV1ReservationAffinity) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1ReservationAffinity + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAiplatformV1ResourcePool: Represents the spec of a group of // resources of the same type, for example machine type, disk, and // accelerators, in a PersistentResource. @@ -21800,9 +21947,12 @@ type GoogleCloudAiplatformV1Scheduling struct { // use. // // Possible values: - // "STRATEGY_UNSPECIFIED" - Strategy will default to ON_DEMAND. + // "STRATEGY_UNSPECIFIED" - Strategy will default to STANDARD. // "ON_DEMAND" - Regular on-demand provisioning strategy. // "LOW_COST" - Low cost by making potential use of spot resources. + // "STANDARD" - Standard provisioning strategy uses regular on-demand + // resources. + // "SPOT" - Spot provisioning strategy uses spot resources. Strategy string `json:"strategy,omitempty"` // Timeout: The maximum job running time. The default is 7 days. Timeout string `json:"timeout,omitempty"` diff --git a/aiplatform/v1beta1/aiplatform-api.json b/aiplatform/v1beta1/aiplatform-api.json index a5334b89b55..429f83057ce 100644 --- a/aiplatform/v1beta1/aiplatform-api.json +++ b/aiplatform/v1beta1/aiplatform-api.json @@ -20452,7 +20452,7 @@ } } }, - "revision": "20240725", + "revision": "20240727", "rootUrl": "https://aiplatform.googleapis.com/", "schemas": { "CloudAiLargeModelsVisionGenerateVideoResponse": { @@ -23291,6 +23291,16 @@ "readOnly": true, "type": "string" }, + "satisfiesPzi": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "satisfiesPzs": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, "startTime": { "description": "Output only. Time when the CustomJob for the first time entered the `JOB_STATE_RUNNING` state.", "format": "google-datetime", @@ -23924,6 +23934,10 @@ "description": "Required. Immutable. The minimum number of machine replicas this DeployedModel will be always deployed on. This value must be greater than or equal to 1. If traffic against the DeployedModel increases, it may dynamically be deployed onto more replicas, and as traffic decreases, some of these extra replicas may be freed.", "format": "int32", "type": "integer" + }, + "spot": { + "description": "Optional. If true, schedule the deployment workload on [spot VMs](https://cloud.google.com/kubernetes-engine/docs/concepts/spot-vms).", + "type": "boolean" } }, "type": "object" @@ -28089,10 +28103,9 @@ "$ref": "GoogleCloudAiplatformV1beta1Schema", "description": "Optional. The `Schema` object allows the definition of input and output data types. These types can be objects, but also primitives and arrays. Represents a select subset of an [OpenAPI 3.0 schema object](https://spec.openapis.org/oas/v3.0.3#schema). If set, a compatible response_mime_type must also be set. Compatible mimetypes: `application/json`: Schema for JSON response." }, - "seed": { - "description": "Optional. Seed.", - "format": "int32", - "type": "integer" + "routingConfig": { + "$ref": "GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfig", + "description": "Optional. Routing configuration." }, "stopSequences": { "description": "Optional. Stop sequences.", @@ -28119,6 +28132,55 @@ }, "type": "object" }, + "GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfig": { + "description": "Routing config.", + "id": "GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfig", + "properties": { + "autoMode": { + "$ref": "GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfigAutoRoutingMode", + "description": "Automated routing." + }, + "manualMode": { + "$ref": "GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfigManualRoutingMode", + "description": "Manual routing." + } + }, + "type": "object" + }, + "GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfigAutoRoutingMode": { + "description": "When automated routing is specified, the routing will be determined by the pretrained routing model and customer provided model routing preference.", + "id": "GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfigAutoRoutingMode", + "properties": { + "modelRoutingPreference": { + "description": "The model routing preference.", + "enum": [ + "UNKNOWN", + "PRIORITIZE_QUALITY", + "BALANCED", + "PRIORITIZE_COST" + ], + "enumDescriptions": [ + "Unspecified model routing preference.", + "Prefer higher quality over low cost.", + "Balanced model routing preference.", + "Prefer lower cost over higher quality." + ], + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfigManualRoutingMode": { + "description": "When manual routing is set, the specified model will be used directly.", + "id": "GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfigManualRoutingMode", + "properties": { + "modelName": { + "description": "The model name to use. Only the public LLM models are accepted. e.g. gemini-1.5-pro-001.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudAiplatformV1beta1GenericOperationMetadata": { "description": "Generic Metadata shared by all operations.", "id": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", @@ -28435,6 +28497,16 @@ "format": "int32", "type": "integer" }, + "satisfiesPzi": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "satisfiesPzs": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, "startTime": { "description": "Output only. Time when the HyperparameterTuningJob for the first time entered the `JOB_STATE_RUNNING` state.", "format": "google-datetime", @@ -30424,7 +30496,7 @@ ], "enumDescriptions": [ "Unspecified accelerator type, which means no accelerator.", - "Nvidia Tesla K80 GPU.", + "Deprecated: Nvidia Tesla K80 GPU has reached end of support, see https://cloud.google.com/compute/docs/eol/k80-eol.", "Nvidia Tesla P100 GPU.", "Nvidia Tesla V100 GPU.", "Nvidia Tesla P4 GPU.", @@ -30444,6 +30516,10 @@ "description": "Immutable. The type of the machine. See the [list of machine types supported for prediction](https://cloud.google.com/vertex-ai/docs/predictions/configure-compute#machine-types) See the [list of machine types supported for custom training](https://cloud.google.com/vertex-ai/docs/training/configure-compute#machine-types). For DeployedModel this field is optional, and the default value is `n1-standard-2`. For BatchPredictionJob or as part of WorkerPoolSpec this field is required.", "type": "string" }, + "reservationAffinity": { + "$ref": "GoogleCloudAiplatformV1beta1ReservationAffinity", + "description": "Optional. Immutable. Configuration controlling how this resource pool consumes reservation." + }, "tpuTopology": { "description": "Immutable. The topology of the TPUs. Corresponds to the TPU topologies available from GKE. (Example: tpu_topology: \"2x2x1\").", "type": "string" @@ -32886,6 +32962,16 @@ "$ref": "GoogleCloudAiplatformV1beta1NasJobSpec", "description": "Required. The specification of a NasJob." }, + "satisfiesPzi": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "satisfiesPzs": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, "startTime": { "description": "Output only. Time when the NasJob for the first time entered the `JOB_STATE_RUNNING` state.", "format": "google-datetime", @@ -33565,6 +33651,10 @@ "description": "The display name of the NotebookExecutionJob. The name can be up to 128 characters long and can consist of any UTF-8 characters.", "type": "string" }, + "encryptionSpec": { + "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec", + "description": "Customer-managed encryption key spec for the notebook execution job. This field is auto-populated if the NotebookRuntimeTemplate has an encryption spec." + }, "executionTimeout": { "description": "Max running time of the execution job in seconds (default 86400s / 24 hrs).", "format": "google-duration", @@ -35017,6 +35107,11 @@ "type": "string" }, "type": "array" + }, + "serviceAttachment": { + "description": "Output only. The name of the generated service attachment resource. This is only populated if the endpoint is deployed with PrivateServiceConnect.", + "readOnly": true, + "type": "string" } }, "type": "object" @@ -36048,7 +36143,7 @@ "id": "GoogleCloudAiplatformV1beta1RagContextsContext", "properties": { "distance": { - "description": "The distance between the query vector and the context text vector.", + "description": "The distance between the query dense embedding vector and the context text vector.", "format": "double", "type": "number" }, @@ -36056,6 +36151,11 @@ "description": "For vertex RagStore, if the file is imported from Cloud Storage or Google Drive, source_uri will be original file URI in Cloud Storage or Google Drive; if file is uploaded, source_uri will be file display name.", "type": "string" }, + "sparseDistance": { + "description": "The distance between the query sparse embedding vector and the context text vector.", + "format": "double", + "type": "number" + }, "text": { "description": "The text chunk.", "type": "string" @@ -36103,9 +36203,60 @@ "description": "Config for the embedding model to use for RAG.", "id": "GoogleCloudAiplatformV1beta1RagEmbeddingModelConfig", "properties": { + "hybridSearchConfig": { + "$ref": "GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigHybridSearchConfig", + "description": "Configuration for hybrid search." + }, "vertexPredictionEndpoint": { "$ref": "GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigVertexPredictionEndpoint", - "description": "The Vertex AI Prediction Endpoint that either refers to a publisher model or an endpoint that is hosting a 1P fine-tuned text embedding model. Endpoints hosting non-1P fine-tuned text embedding models are currently not supported." + "description": "The Vertex AI Prediction Endpoint that either refers to a publisher model or an endpoint that is hosting a 1P fine-tuned text embedding model. Endpoints hosting non-1P fine-tuned text embedding models are currently not supported. This is used for dense vector search." + } + }, + "type": "object" + }, + "GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigHybridSearchConfig": { + "description": "Config for hybrid search.", + "id": "GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigHybridSearchConfig", + "properties": { + "denseEmbeddingModelPredictionEndpoint": { + "$ref": "GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigVertexPredictionEndpoint", + "description": "Required. The Vertex AI Prediction Endpoint that hosts the embedding model for dense embedding generations." + }, + "sparseEmbeddingConfig": { + "$ref": "GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigSparseEmbeddingConfig", + "description": "Optional. The configuration for sparse embedding generation. This field is optional the default behavior depends on the vector database choice on the RagCorpus." + } + }, + "type": "object" + }, + "GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigSparseEmbeddingConfig": { + "description": "Configuration for sparse emebdding generation.", + "id": "GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigSparseEmbeddingConfig", + "properties": { + "bm25": { + "$ref": "GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigSparseEmbeddingConfigBm25", + "description": "Use BM25 scoring algorithm." + } + }, + "type": "object" + }, + "GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigSparseEmbeddingConfigBm25": { + "description": "Message for BM25 parameters.", + "id": "GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigSparseEmbeddingConfigBm25", + "properties": { + "b": { + "description": "Optional. The parameter to control document length normalization. It determines how much the document length affects the final score. b is in the range of [0, 1]. The default value is 0.75.", + "format": "float", + "type": "number" + }, + "k1": { + "description": "Optional. The parameter to control term frequency saturation. It determines the scaling between the matching term frequency and final score. k1 is in the range of [1.2, 3]. The default value is 1.2.", + "format": "float", + "type": "number" + }, + "multilingual": { + "description": "Optional. Use multilingual tokenizer if set to true.", + "type": "boolean" } }, "type": "object" @@ -36748,6 +36899,40 @@ }, "type": "object" }, + "GoogleCloudAiplatformV1beta1ReservationAffinity": { + "description": "A ReservationAffinity can be used to configure a Vertex AI resource (e.g., a DeployedModel) to draw its Compute Engine resources from a Shared Reservation, or exclusively from on-demand capacity.", + "id": "GoogleCloudAiplatformV1beta1ReservationAffinity", + "properties": { + "key": { + "description": "Optional. Corresponds to the label key of a reservation resource. To target a SPECIFIC_RESERVATION by name, use `compute.googleapis.com/reservation-name` as the key and specify the name of your reservation as its value.", + "type": "string" + }, + "reservationAffinityType": { + "description": "Required. Specifies the reservation affinity type.", + "enum": [ + "TYPE_UNSPECIFIED", + "NO_RESERVATION", + "ANY_RESERVATION", + "SPECIFIC_RESERVATION" + ], + "enumDescriptions": [ + "Default value. This should not be used.", + "Do not consume from any reserved capacity, only use on-demand.", + "Consume any reservation available, falling back to on-demand.", + "Consume from a specific reservation. When chosen, the reservation must be identified via the `key` and `values` fields." + ], + "type": "string" + }, + "values": { + "description": "Optional. Corresponds to the label values of a reservation resource. This must be the full resource name of the reservation.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudAiplatformV1beta1ResourcePool": { "description": "Represents the spec of a group of resources of the same type, for example machine type, disk, and accelerators, in a PersistentResource.", "id": "GoogleCloudAiplatformV1beta1ResourcePool", @@ -36930,6 +37115,10 @@ }, "type": "array" }, + "ranking": { + "$ref": "GoogleCloudAiplatformV1beta1RetrieveContextsRequestVertexRagStoreRanking", + "description": "Optional. Configurations for hybrid search results ranking." + }, "vectorDistanceThreshold": { "description": "Optional. Only return contexts with vector distance smaller than the threshold.", "format": "double", @@ -36956,6 +37145,18 @@ }, "type": "object" }, + "GoogleCloudAiplatformV1beta1RetrieveContextsRequestVertexRagStoreRanking": { + "description": "Configurations for hybrid search results ranking.", + "id": "GoogleCloudAiplatformV1beta1RetrieveContextsRequestVertexRagStoreRanking", + "properties": { + "alpha": { + "description": "Optional. Alpha value controls the weight between dense and sparse vector search results. The range is [0, 1], while 0 means sparse vector search only and 1 means dense vector search only. The default value is 0.5 which balances sparse and dense vector search equally.", + "format": "float", + "type": "number" + } + }, + "type": "object" + }, "GoogleCloudAiplatformV1beta1RetrieveContextsResponse": { "description": "Response message for VertexRagService.RetrieveContexts.", "id": "GoogleCloudAiplatformV1beta1RetrieveContextsResponse", @@ -37581,12 +37782,23 @@ "enum": [ "STRATEGY_UNSPECIFIED", "ON_DEMAND", - "LOW_COST" + "LOW_COST", + "STANDARD", + "SPOT" + ], + "enumDeprecated": [ + false, + true, + true, + false, + false ], "enumDescriptions": [ - "Strategy will default to ON_DEMAND.", + "Strategy will default to STANDARD.", "Regular on-demand provisioning strategy.", - "Low cost by making potential use of spot resources." + "Low cost by making potential use of spot resources.", + "Standard provisioning strategy uses regular on-demand resources.", + "Spot provisioning strategy uses spot resources." ], "type": "string" }, diff --git a/aiplatform/v1beta1/aiplatform-gen.go b/aiplatform/v1beta1/aiplatform-gen.go index 2bce3335410..8c972b68413 100644 --- a/aiplatform/v1beta1/aiplatform-gen.go +++ b/aiplatform/v1beta1/aiplatform-gen.go @@ -5906,6 +5906,10 @@ type GoogleCloudAiplatformV1beta1CustomJob struct { Labels map[string]string `json:"labels,omitempty"` // Name: Output only. Resource name of a CustomJob. Name string `json:"name,omitempty"` + // SatisfiesPzi: Output only. Reserved for future use. + SatisfiesPzi bool `json:"satisfiesPzi,omitempty"` + // SatisfiesPzs: Output only. Reserved for future use. + SatisfiesPzs bool `json:"satisfiesPzs,omitempty"` // StartTime: Output only. Time when the CustomJob for the first time entered // the `JOB_STATE_RUNNING` state. StartTime string `json:"startTime,omitempty"` @@ -6595,6 +6599,9 @@ type GoogleCloudAiplatformV1beta1DedicatedResources struct { // dynamically be deployed onto more replicas, and as traffic decreases, some // of these extra replicas may be freed. MinReplicaCount int64 `json:"minReplicaCount,omitempty"` + // Spot: Optional. If true, schedule the deployment workload on spot VMs + // (https://cloud.google.com/kubernetes-engine/docs/concepts/spot-vms). + Spot bool `json:"spot,omitempty"` // ForceSendFields is a list of field names (e.g. "AutoscalingMetricSpecs") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -12719,8 +12726,8 @@ type GoogleCloudAiplatformV1beta1GenerationConfig struct { // response_mime_type must also be set. Compatible mimetypes: // `application/json`: Schema for JSON response. ResponseSchema *GoogleCloudAiplatformV1beta1Schema `json:"responseSchema,omitempty"` - // Seed: Optional. Seed. - Seed int64 `json:"seed,omitempty"` + // RoutingConfig: Optional. Routing configuration. + RoutingConfig *GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfig `json:"routingConfig,omitempty"` // StopSequences: Optional. Stop sequences. StopSequences []string `json:"stopSequences,omitempty"` // Temperature: Optional. Controls the randomness of predictions. @@ -12769,6 +12776,84 @@ func (s *GoogleCloudAiplatformV1beta1GenerationConfig) UnmarshalJSON(data []byte return nil } +// GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfig: Routing config. +type GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfig struct { + // AutoMode: Automated routing. + AutoMode *GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfigAutoRoutingMode `json:"autoMode,omitempty"` + // ManualMode: Manual routing. + ManualMode *GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfigManualRoutingMode `json:"manualMode,omitempty"` + // ForceSendFields is a list of field names (e.g. "AutoMode") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AutoMode") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfigAutoRoutingMode: +// When automated routing is specified, the routing will be determined by the +// pretrained routing model and customer provided model routing preference. +type GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfigAutoRoutingMode struct { + // ModelRoutingPreference: The model routing preference. + // + // Possible values: + // "UNKNOWN" - Unspecified model routing preference. + // "PRIORITIZE_QUALITY" - Prefer higher quality over low cost. + // "BALANCED" - Balanced model routing preference. + // "PRIORITIZE_COST" - Prefer lower cost over higher quality. + ModelRoutingPreference string `json:"modelRoutingPreference,omitempty"` + // ForceSendFields is a list of field names (e.g. "ModelRoutingPreference") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ModelRoutingPreference") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfigAutoRoutingMode) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfigAutoRoutingMode + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfigManualRoutingMode: +// When manual routing is set, the specified model will be used directly. +type GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfigManualRoutingMode struct { + // ModelName: The model name to use. Only the public LLM models are accepted. + // e.g. gemini-1.5-pro-001. + ModelName string `json:"modelName,omitempty"` + // ForceSendFields is a list of field names (e.g. "ModelName") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ModelName") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfigManualRoutingMode) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfigManualRoutingMode + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAiplatformV1beta1GenericOperationMetadata: Generic Metadata // shared by all operations. type GoogleCloudAiplatformV1beta1GenericOperationMetadata struct { @@ -13191,6 +13276,10 @@ type GoogleCloudAiplatformV1beta1HyperparameterTuningJob struct { // ParallelTrialCount: Required. The desired number of Trials to run in // parallel. ParallelTrialCount int64 `json:"parallelTrialCount,omitempty"` + // SatisfiesPzi: Output only. Reserved for future use. + SatisfiesPzi bool `json:"satisfiesPzi,omitempty"` + // SatisfiesPzs: Output only. Reserved for future use. + SatisfiesPzs bool `json:"satisfiesPzs,omitempty"` // StartTime: Output only. Time when the HyperparameterTuningJob for the first // time entered the `JOB_STATE_RUNNING` state. StartTime string `json:"startTime,omitempty"` @@ -16080,7 +16169,8 @@ type GoogleCloudAiplatformV1beta1MachineSpec struct { // Possible values: // "ACCELERATOR_TYPE_UNSPECIFIED" - Unspecified accelerator type, which means // no accelerator. - // "NVIDIA_TESLA_K80" - Nvidia Tesla K80 GPU. + // "NVIDIA_TESLA_K80" - Deprecated: Nvidia Tesla K80 GPU has reached end of + // support, see https://cloud.google.com/compute/docs/eol/k80-eol. // "NVIDIA_TESLA_P100" - Nvidia Tesla P100 GPU. // "NVIDIA_TESLA_V100" - Nvidia Tesla V100 GPU. // "NVIDIA_TESLA_P4" - Nvidia Tesla P4 GPU. @@ -16103,6 +16193,9 @@ type GoogleCloudAiplatformV1beta1MachineSpec struct { // `n1-standard-2`. For BatchPredictionJob or as part of WorkerPoolSpec this // field is required. MachineType string `json:"machineType,omitempty"` + // ReservationAffinity: Optional. Immutable. Configuration controlling how this + // resource pool consumes reservation. + ReservationAffinity *GoogleCloudAiplatformV1beta1ReservationAffinity `json:"reservationAffinity,omitempty"` // TpuTopology: Immutable. The topology of the TPUs. Corresponds to the TPU // topologies available from GKE. (Example: tpu_topology: "2x2x1"). TpuTopology string `json:"tpuTopology,omitempty"` @@ -19613,6 +19706,10 @@ type GoogleCloudAiplatformV1beta1NasJob struct { NasJobOutput *GoogleCloudAiplatformV1beta1NasJobOutput `json:"nasJobOutput,omitempty"` // NasJobSpec: Required. The specification of a NasJob. NasJobSpec *GoogleCloudAiplatformV1beta1NasJobSpec `json:"nasJobSpec,omitempty"` + // SatisfiesPzi: Output only. Reserved for future use. + SatisfiesPzi bool `json:"satisfiesPzi,omitempty"` + // SatisfiesPzs: Output only. Reserved for future use. + SatisfiesPzs bool `json:"satisfiesPzs,omitempty"` // StartTime: Output only. Time when the NasJob for the first time entered the // `JOB_STATE_RUNNING` state. StartTime string `json:"startTime,omitempty"` @@ -20512,6 +20609,10 @@ type GoogleCloudAiplatformV1beta1NotebookExecutionJob struct { // DisplayName: The display name of the NotebookExecutionJob. The name can be // up to 128 characters long and can consist of any UTF-8 characters. DisplayName string `json:"displayName,omitempty"` + // EncryptionSpec: Customer-managed encryption key spec for the notebook + // execution job. This field is auto-populated if the NotebookRuntimeTemplate + // has an encryption spec. + EncryptionSpec *GoogleCloudAiplatformV1beta1EncryptionSpec `json:"encryptionSpec,omitempty"` // ExecutionTimeout: Max running time of the execution job in seconds (default // 86400s / 24 hrs). ExecutionTimeout string `json:"executionTimeout,omitempty"` @@ -22197,6 +22298,10 @@ type GoogleCloudAiplatformV1beta1PrivateServiceConnectConfig struct { // ProjectAllowlist: A list of Projects from which the forwarding rule will // target the service attachment. ProjectAllowlist []string `json:"projectAllowlist,omitempty"` + // ServiceAttachment: Output only. The name of the generated service attachment + // resource. This is only populated if the endpoint is deployed with + // PrivateServiceConnect. + ServiceAttachment string `json:"serviceAttachment,omitempty"` // ForceSendFields is a list of field names (e.g. // "EnablePrivateServiceConnect") to unconditionally include in API requests. // By default, fields with empty or default values are omitted from API @@ -23705,12 +23810,16 @@ func (s GoogleCloudAiplatformV1beta1RagContexts) MarshalJSON() ([]byte, error) { // GoogleCloudAiplatformV1beta1RagContextsContext: A context of the query. type GoogleCloudAiplatformV1beta1RagContextsContext struct { - // Distance: The distance between the query vector and the context text vector. + // Distance: The distance between the query dense embedding vector and the + // context text vector. Distance float64 `json:"distance,omitempty"` // SourceUri: For vertex RagStore, if the file is imported from Cloud Storage // or Google Drive, source_uri will be original file URI in Cloud Storage or // Google Drive; if file is uploaded, source_uri will be file display name. SourceUri string `json:"sourceUri,omitempty"` + // SparseDistance: The distance between the query sparse embedding vector and + // the context text vector. + SparseDistance float64 `json:"sparseDistance,omitempty"` // Text: The text chunk. Text string `json:"text,omitempty"` // ForceSendFields is a list of field names (e.g. "Distance") to @@ -23734,7 +23843,8 @@ func (s GoogleCloudAiplatformV1beta1RagContextsContext) MarshalJSON() ([]byte, e func (s *GoogleCloudAiplatformV1beta1RagContextsContext) UnmarshalJSON(data []byte) error { type NoMethod GoogleCloudAiplatformV1beta1RagContextsContext var s1 struct { - Distance gensupport.JSONFloat64 `json:"distance"` + Distance gensupport.JSONFloat64 `json:"distance"` + SparseDistance gensupport.JSONFloat64 `json:"sparseDistance"` *NoMethod } s1.NoMethod = (*NoMethod)(s) @@ -23742,6 +23852,7 @@ func (s *GoogleCloudAiplatformV1beta1RagContextsContext) UnmarshalJSON(data []by return err } s.Distance = float64(s1.Distance) + s.SparseDistance = float64(s1.SparseDistance) return nil } @@ -23786,20 +23897,22 @@ func (s GoogleCloudAiplatformV1beta1RagCorpus) MarshalJSON() ([]byte, error) { // GoogleCloudAiplatformV1beta1RagEmbeddingModelConfig: Config for the // embedding model to use for RAG. type GoogleCloudAiplatformV1beta1RagEmbeddingModelConfig struct { + // HybridSearchConfig: Configuration for hybrid search. + HybridSearchConfig *GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigHybridSearchConfig `json:"hybridSearchConfig,omitempty"` // VertexPredictionEndpoint: The Vertex AI Prediction Endpoint that either // refers to a publisher model or an endpoint that is hosting a 1P fine-tuned // text embedding model. Endpoints hosting non-1P fine-tuned text embedding - // models are currently not supported. + // models are currently not supported. This is used for dense vector search. VertexPredictionEndpoint *GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigVertexPredictionEndpoint `json:"vertexPredictionEndpoint,omitempty"` - // ForceSendFields is a list of field names (e.g. "VertexPredictionEndpoint") - // to unconditionally include in API requests. By default, fields with empty or + // ForceSendFields is a list of field names (e.g. "HybridSearchConfig") to + // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "VertexPredictionEndpoint") to - // include in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. See + // NullFields is a list of field names (e.g. "HybridSearchConfig") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -23809,6 +23922,107 @@ func (s GoogleCloudAiplatformV1beta1RagEmbeddingModelConfig) MarshalJSON() ([]by return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigHybridSearchConfig: +// Config for hybrid search. +type GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigHybridSearchConfig struct { + // DenseEmbeddingModelPredictionEndpoint: Required. The Vertex AI Prediction + // Endpoint that hosts the embedding model for dense embedding generations. + DenseEmbeddingModelPredictionEndpoint *GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigVertexPredictionEndpoint `json:"denseEmbeddingModelPredictionEndpoint,omitempty"` + // SparseEmbeddingConfig: Optional. The configuration for sparse embedding + // generation. This field is optional the default behavior depends on the + // vector database choice on the RagCorpus. + SparseEmbeddingConfig *GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigSparseEmbeddingConfig `json:"sparseEmbeddingConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. + // "DenseEmbeddingModelPredictionEndpoint") to unconditionally include in API + // requests. By default, fields with empty or default values are omitted from + // API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. + // "DenseEmbeddingModelPredictionEndpoint") to include in API requests with the + // JSON null value. By default, fields with empty values are omitted from API + // requests. See https://pkg.go.dev/google.golang.org/api#hdr-NullFields for + // more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigHybridSearchConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigHybridSearchConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigSparseEmbeddingConfig: +// Configuration for sparse emebdding generation. +type GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigSparseEmbeddingConfig struct { + // Bm25: Use BM25 scoring algorithm. + Bm25 *GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigSparseEmbeddingConfigBm25 `json:"bm25,omitempty"` + // ForceSendFields is a list of field names (e.g. "Bm25") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Bm25") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigSparseEmbeddingConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigSparseEmbeddingConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigSparseEmbeddingConfigBm25: +// +// Message for BM25 parameters. +type GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigSparseEmbeddingConfigBm25 struct { + // B: Optional. The parameter to control document length normalization. It + // determines how much the document length affects the final score. b is in the + // range of [0, 1]. The default value is 0.75. + B float64 `json:"b,omitempty"` + // K1: Optional. The parameter to control term frequency saturation. It + // determines the scaling between the matching term frequency and final score. + // k1 is in the range of [1.2, 3]. The default value is 1.2. + K1 float64 `json:"k1,omitempty"` + // Multilingual: Optional. Use multilingual tokenizer if set to true. + Multilingual bool `json:"multilingual,omitempty"` + // ForceSendFields is a list of field names (e.g. "B") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "B") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigSparseEmbeddingConfigBm25) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigSparseEmbeddingConfigBm25 + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigSparseEmbeddingConfigBm25) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigSparseEmbeddingConfigBm25 + var s1 struct { + B gensupport.JSONFloat64 `json:"b"` + K1 gensupport.JSONFloat64 `json:"k1"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.B = float64(s1.B) + s.K1 = float64(s1.K1) + return nil +} + // GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigVertexPredictionEndpoint: // Config representing a model hosted on Vertex Prediction Endpoint. type GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigVertexPredictionEndpoint struct { @@ -24742,6 +24956,48 @@ func (s GoogleCloudAiplatformV1beta1ReportRuntimeEventResponse) MarshalJSON() ([ return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudAiplatformV1beta1ReservationAffinity: A ReservationAffinity can +// be used to configure a Vertex AI resource (e.g., a DeployedModel) to draw +// its Compute Engine resources from a Shared Reservation, or exclusively from +// on-demand capacity. +type GoogleCloudAiplatformV1beta1ReservationAffinity struct { + // Key: Optional. Corresponds to the label key of a reservation resource. To + // target a SPECIFIC_RESERVATION by name, use + // `compute.googleapis.com/reservation-name` as the key and specify the name of + // your reservation as its value. + Key string `json:"key,omitempty"` + // ReservationAffinityType: Required. Specifies the reservation affinity type. + // + // Possible values: + // "TYPE_UNSPECIFIED" - Default value. This should not be used. + // "NO_RESERVATION" - Do not consume from any reserved capacity, only use + // on-demand. + // "ANY_RESERVATION" - Consume any reservation available, falling back to + // on-demand. + // "SPECIFIC_RESERVATION" - Consume from a specific reservation. When chosen, + // the reservation must be identified via the `key` and `values` fields. + ReservationAffinityType string `json:"reservationAffinityType,omitempty"` + // Values: Optional. Corresponds to the label values of a reservation resource. + // This must be the full resource name of the reservation. + Values []string `json:"values,omitempty"` + // ForceSendFields is a list of field names (e.g. "Key") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Key") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAiplatformV1beta1ReservationAffinity) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1ReservationAffinity + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAiplatformV1beta1ResourcePool: Represents the spec of a group of // resources of the same type, for example machine type, disk, and // accelerators, in a PersistentResource. @@ -25032,6 +25288,8 @@ type GoogleCloudAiplatformV1beta1RetrieveContextsRequestVertexRagStore struct { // multiple files from one corpus. In the future we may open up multiple // corpora support. RagResources []*GoogleCloudAiplatformV1beta1RetrieveContextsRequestVertexRagStoreRagResource `json:"ragResources,omitempty"` + // Ranking: Optional. Configurations for hybrid search results ranking. + Ranking *GoogleCloudAiplatformV1beta1RetrieveContextsRequestVertexRagStoreRanking `json:"ranking,omitempty"` // VectorDistanceThreshold: Optional. Only return contexts with vector distance // smaller than the threshold. VectorDistanceThreshold float64 `json:"vectorDistanceThreshold,omitempty"` @@ -25095,6 +25353,46 @@ func (s GoogleCloudAiplatformV1beta1RetrieveContextsRequestVertexRagStoreRagReso return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudAiplatformV1beta1RetrieveContextsRequestVertexRagStoreRanking: +// Configurations for hybrid search results ranking. +type GoogleCloudAiplatformV1beta1RetrieveContextsRequestVertexRagStoreRanking struct { + // Alpha: Optional. Alpha value controls the weight between dense and sparse + // vector search results. The range is [0, 1], while 0 means sparse vector + // search only and 1 means dense vector search only. The default value is 0.5 + // which balances sparse and dense vector search equally. + Alpha float64 `json:"alpha,omitempty"` + // ForceSendFields is a list of field names (e.g. "Alpha") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Alpha") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAiplatformV1beta1RetrieveContextsRequestVertexRagStoreRanking) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1RetrieveContextsRequestVertexRagStoreRanking + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleCloudAiplatformV1beta1RetrieveContextsRequestVertexRagStoreRanking) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudAiplatformV1beta1RetrieveContextsRequestVertexRagStoreRanking + var s1 struct { + Alpha gensupport.JSONFloat64 `json:"alpha"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Alpha = float64(s1.Alpha) + return nil +} + // GoogleCloudAiplatformV1beta1RetrieveContextsResponse: Response message for // VertexRagService.RetrieveContexts. type GoogleCloudAiplatformV1beta1RetrieveContextsResponse struct { @@ -25943,9 +26241,12 @@ type GoogleCloudAiplatformV1beta1Scheduling struct { // use. // // Possible values: - // "STRATEGY_UNSPECIFIED" - Strategy will default to ON_DEMAND. + // "STRATEGY_UNSPECIFIED" - Strategy will default to STANDARD. // "ON_DEMAND" - Regular on-demand provisioning strategy. // "LOW_COST" - Low cost by making potential use of spot resources. + // "STANDARD" - Standard provisioning strategy uses regular on-demand + // resources. + // "SPOT" - Spot provisioning strategy uses spot resources. Strategy string `json:"strategy,omitempty"` // Timeout: The maximum job running time. The default is 7 days. Timeout string `json:"timeout,omitempty"` diff --git a/androidmanagement/v1/androidmanagement-api.json b/androidmanagement/v1/androidmanagement-api.json index 358e80eb936..257a54c46fe 100644 --- a/androidmanagement/v1/androidmanagement-api.json +++ b/androidmanagement/v1/androidmanagement-api.json @@ -1168,7 +1168,7 @@ } } }, - "revision": "20240724", + "revision": "20240805", "rootUrl": "https://androidmanagement.googleapis.com/", "schemas": { "AdbShellCommandEvent": { @@ -1193,7 +1193,7 @@ "id": "AdvancedSecurityOverrides", "properties": { "commonCriteriaMode": { - "description": "Controls Common Criteria Mode—security standards defined in the Common Criteria for Information Technology Security Evaluation (https://www.commoncriteriaportal.org/) (CC). Enabling Common Criteria Mode increases certain security components on a device, including AES-GCM encryption of Bluetooth Long Term Keys, and Wi-Fi configuration stores.Warning: Common Criteria Mode enforces a strict security model typically only required for IT products used in national security systems and other highly sensitive organizations. Standard device use may be affected. Only enabled if required.", + "description": "Controls Common Criteria Mode—security standards defined in the Common Criteria for Information Technology Security Evaluation (https://www.commoncriteriaportal.org/) (CC). Enabling Common Criteria Mode increases certain security components on a device, including AES-GCM encryption of Bluetooth Long Term Keys, and Wi-Fi configuration stores.Common Criteria Mode is only supported on company-owned devices running Android 11 or above.Warning: Common Criteria Mode enforces a strict security model typically only required for IT products used in national security systems and other highly sensitive organizations. Standard device use may be affected. Only enabled if required.", "enum": [ "COMMON_CRITERIA_MODE_UNSPECIFIED", "COMMON_CRITERIA_MODE_DISABLED", @@ -2506,7 +2506,7 @@ }, "commonCriteriaModeInfo": { "$ref": "CommonCriteriaModeInfo", - "description": "Information about Common Criteria Mode—security standards defined in the Common Criteria for Information Technology Security Evaluation (https://www.commoncriteriaportal.org/) (CC).This information is only available if statusReportingSettings.commonCriteriaModeEnabled is true in the device's policy." + "description": "Information about Common Criteria Mode—security standards defined in the Common Criteria for Information Technology Security Evaluation (https://www.commoncriteriaportal.org/) (CC).This information is only available if statusReportingSettings.commonCriteriaModeEnabled is true in the device's policy the device is company-owned." }, "deviceSettings": { "$ref": "DeviceSettings", @@ -5945,7 +5945,7 @@ "type": "boolean" }, "commonCriteriaModeEnabled": { - "description": "Whether Common Criteria Mode reporting is enabled.", + "description": "Whether Common Criteria Mode reporting is enabled. This is supported only on company-owned devices.", "type": "boolean" }, "deviceSettingsEnabled": { diff --git a/androidmanagement/v1/androidmanagement-gen.go b/androidmanagement/v1/androidmanagement-gen.go index d5ea41df96d..2507e5e28df 100644 --- a/androidmanagement/v1/androidmanagement-gen.go +++ b/androidmanagement/v1/androidmanagement-gen.go @@ -319,10 +319,11 @@ type AdvancedSecurityOverrides struct { // Evaluation (https://www.commoncriteriaportal.org/) (CC). Enabling Common // Criteria Mode increases certain security components on a device, including // AES-GCM encryption of Bluetooth Long Term Keys, and Wi-Fi configuration - // stores.Warning: Common Criteria Mode enforces a strict security model - // typically only required for IT products used in national security systems - // and other highly sensitive organizations. Standard device use may be - // affected. Only enabled if required. + // stores.Common Criteria Mode is only supported on company-owned devices + // running Android 11 or above.Warning: Common Criteria Mode enforces a strict + // security model typically only required for IT products used in national + // security systems and other highly sensitive organizations. Standard device + // use may be affected. Only enabled if required. // // Possible values: // "COMMON_CRITERIA_MODE_UNSPECIFIED" - Unspecified. Defaults to @@ -1875,7 +1876,7 @@ type Device struct { // standards defined in the Common Criteria for Information Technology Security // Evaluation (https://www.commoncriteriaportal.org/) (CC).This information is // only available if statusReportingSettings.commonCriteriaModeEnabled is true - // in the device's policy. + // in the device's policy the device is company-owned. CommonCriteriaModeInfo *CommonCriteriaModeInfo `json:"commonCriteriaModeInfo,omitempty"` // DeviceSettings: Device settings information. This information is only // available if deviceSettingsEnabled is true in the device's policy. @@ -5909,7 +5910,7 @@ type StatusReportingSettings struct { // ApplicationReportsEnabled: Whether app reports are enabled. ApplicationReportsEnabled bool `json:"applicationReportsEnabled,omitempty"` // CommonCriteriaModeEnabled: Whether Common Criteria Mode reporting is - // enabled. + // enabled. This is supported only on company-owned devices. CommonCriteriaModeEnabled bool `json:"commonCriteriaModeEnabled,omitempty"` // DeviceSettingsEnabled: Whether device settings reporting is enabled. DeviceSettingsEnabled bool `json:"deviceSettingsEnabled,omitempty"` diff --git a/androidpublisher/v3/androidpublisher-api.json b/androidpublisher/v3/androidpublisher-api.json index 5faee66f55e..cbdb4e79bb9 100644 --- a/androidpublisher/v3/androidpublisher-api.json +++ b/androidpublisher/v3/androidpublisher-api.json @@ -3276,7 +3276,7 @@ ] }, "migratePrices": { - "description": "Migrates subscribers who are receiving an historical subscription price to the currently-offered price for the specified region. Requests will cause price change notifications to be sent to users who are currently receiving an historical price older than the supplied timestamp. Subscribers who do not agree to the new price will have their subscription ended at the next renewal.", + "description": "Migrates subscribers from one or more legacy price cohorts to the current price. Requests result in Google Play notifying affected subscribers. Only up to 250 simultaneous legacy price cohorts are supported.", "flatPath": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}:migratePrices", "httpMethod": "POST", "id": "androidpublisher.monetization.subscriptions.basePlans.migratePrices", @@ -4731,7 +4731,7 @@ } } }, - "revision": "20240709", + "revision": "20240805", "rootUrl": "https://androidpublisher.googleapis.com/", "schemas": { "Abi": { @@ -7941,16 +7941,16 @@ "type": "object" }, "RegionalPriceMigrationConfig": { - "description": "Configuration for a price migration.", + "description": "Configuration for migration of a legacy price cohort.", "id": "RegionalPriceMigrationConfig", "properties": { "oldestAllowedPriceVersionTime": { - "description": "Required. The cutoff time for historical prices that subscribers can remain paying. Subscribers on prices which were available at this cutoff time or later will stay on their existing price. Subscribers on older prices will be migrated to the currently-offered price. The migrated subscribers will receive a notification that they will be paying a different price. Subscribers who do not agree to the new price will have their subscription ended at the next renewal.", + "description": "Required. Subscribers in all legacy price cohorts before this time will be migrated to the current price. Subscribers in any newer price cohorts are unaffected. Affected subscribers will receive one or more notifications from Google Play about the price change. Price decreases occur at the subscriber's next billing date. Price increases occur at the subscriber's next billing date following a notification period that varies by region and price increase type.", "format": "google-datetime", "type": "string" }, "priceIncreaseType": { - "description": "Optional. The behavior the caller wants users to see when there is a price increase during migration. If left unset, the behavior defaults to PRICE_INCREASE_TYPE_OPT_IN. Note that the first opt-out price increase migration for each app must be initiated in Play Console.", + "description": "Optional. The requested type of price increase", "enum": [ "PRICE_INCREASE_TYPE_UNSPECIFIED", "PRICE_INCREASE_TYPE_OPT_IN", @@ -7958,8 +7958,8 @@ ], "enumDescriptions": [ "Unspecified state.", - "Price increase will be presented to users on an opt-in basis.", - "Price increase will be presented to users on an opt-out basis." + "Subscribers must accept the price increase or their subscription is canceled.", + "Subscribers are notified but do not have to accept the price increase. Opt-out price increases not meeting regional, frequency, and amount limits will proceed as opt-in price increase. The first opt-out price increase for each app must be initiated in the Google Play Console." ], "type": "string" }, diff --git a/androidpublisher/v3/androidpublisher-gen.go b/androidpublisher/v3/androidpublisher-gen.go index 2f838c1d41d..e065f2992dd 100644 --- a/androidpublisher/v3/androidpublisher-gen.go +++ b/androidpublisher/v3/androidpublisher-gen.go @@ -4857,27 +4857,28 @@ func (s RegionalBasePlanConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// RegionalPriceMigrationConfig: Configuration for a price migration. +// RegionalPriceMigrationConfig: Configuration for migration of a legacy price +// cohort. type RegionalPriceMigrationConfig struct { - // OldestAllowedPriceVersionTime: Required. The cutoff time for historical - // prices that subscribers can remain paying. Subscribers on prices which were - // available at this cutoff time or later will stay on their existing price. - // Subscribers on older prices will be migrated to the currently-offered price. - // The migrated subscribers will receive a notification that they will be - // paying a different price. Subscribers who do not agree to the new price will - // have their subscription ended at the next renewal. + // OldestAllowedPriceVersionTime: Required. Subscribers in all legacy price + // cohorts before this time will be migrated to the current price. Subscribers + // in any newer price cohorts are unaffected. Affected subscribers will receive + // one or more notifications from Google Play about the price change. Price + // decreases occur at the subscriber's next billing date. Price increases occur + // at the subscriber's next billing date following a notification period that + // varies by region and price increase type. OldestAllowedPriceVersionTime string `json:"oldestAllowedPriceVersionTime,omitempty"` - // PriceIncreaseType: Optional. The behavior the caller wants users to see when - // there is a price increase during migration. If left unset, the behavior - // defaults to PRICE_INCREASE_TYPE_OPT_IN. Note that the first opt-out price - // increase migration for each app must be initiated in Play Console. + // PriceIncreaseType: Optional. The requested type of price increase // // Possible values: // "PRICE_INCREASE_TYPE_UNSPECIFIED" - Unspecified state. - // "PRICE_INCREASE_TYPE_OPT_IN" - Price increase will be presented to users - // on an opt-in basis. - // "PRICE_INCREASE_TYPE_OPT_OUT" - Price increase will be presented to users - // on an opt-out basis. + // "PRICE_INCREASE_TYPE_OPT_IN" - Subscribers must accept the price increase + // or their subscription is canceled. + // "PRICE_INCREASE_TYPE_OPT_OUT" - Subscribers are notified but do not have + // to accept the price increase. Opt-out price increases not meeting regional, + // frequency, and amount limits will proceed as opt-in price increase. The + // first opt-out price increase for each app must be initiated in the Google + // Play Console. PriceIncreaseType string `json:"priceIncreaseType,omitempty"` // RegionCode: Required. Region code this configuration applies to, as defined // by ISO 3166-2, e.g. "US". @@ -16741,12 +16742,9 @@ type MonetizationSubscriptionsBasePlansMigratePricesCall struct { header_ http.Header } -// MigratePrices: Migrates subscribers who are receiving an historical -// subscription price to the currently-offered price for the specified region. -// Requests will cause price change notifications to be sent to users who are -// currently receiving an historical price older than the supplied timestamp. -// Subscribers who do not agree to the new price will have their subscription -// ended at the next renewal. +// MigratePrices: Migrates subscribers from one or more legacy price cohorts to +// the current price. Requests result in Google Play notifying affected +// subscribers. Only up to 250 simultaneous legacy price cohorts are supported. // // - basePlanId: The unique base plan ID of the base plan to update prices on. // - packageName: Package name of the parent app. Must be equal to the diff --git a/backupdr/v1/backupdr-api.json b/backupdr/v1/backupdr-api.json index 85a25aadc39..579db803eed 100644 --- a/backupdr/v1/backupdr-api.json +++ b/backupdr/v1/backupdr-api.json @@ -399,12 +399,12 @@ ], "parameters": { "force": { - "description": "Optional. If set to true, will not check plan duration against backup vault enforcement duration. Non-standard field.", + "description": "Optional. If set to true, will not check plan duration against backup vault enforcement duration.", "location": "query", "type": "boolean" }, "name": { - "description": "Output only. The resource name.", + "description": "Output only. Identifier. The resource name.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/backupVaults/[^/]+$", "required": true, @@ -668,7 +668,7 @@ "type": "boolean" }, "name": { - "description": "Output only. The resource name.", + "description": "Output only. Identifier. The resource name.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/backupVaults/[^/]+/dataSources/[^/]+$", "required": true, @@ -868,7 +868,7 @@ ], "parameters": { "name": { - "description": "Output only. Name of the resource.", + "description": "Output only. Identifier. Name of the resource.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/backupVaults/[^/]+/dataSources/[^/]+/backups/[^/]+$", "required": true, @@ -1261,7 +1261,7 @@ } } }, - "revision": "20240711", + "revision": "20240725", "rootUrl": "https://backupdr.googleapis.com/", "schemas": { "AbandonBackupRequest": { @@ -1366,6 +1366,42 @@ }, "type": "object" }, + "AssetLocation": { + "description": "Provides the mapping of a cloud asset to a direct physical location or to a proxy that defines the location on its behalf.", + "id": "AssetLocation", + "properties": { + "ccfeRmsPath": { + "description": "Spanner path of the CCFE RMS database. It is only applicable for CCFE tenants that use CCFE RMS for storing resource metadata.", + "type": "string" + }, + "expected": { + "$ref": "IsolationExpectations", + "description": "Defines the customer expectation around ZI/ZS for this asset and ZI/ZS state of the region at the time of asset creation." + }, + "extraParameters": { + "description": "Defines extra parameters required for specific asset types.", + "items": { + "$ref": "ExtraParameter" + }, + "type": "array" + }, + "locationData": { + "description": "Contains all kinds of physical location definitions for this asset.", + "items": { + "$ref": "LocationData" + }, + "type": "array" + }, + "parentAsset": { + "description": "Defines parents assets if any in order to allow later generation of child_asset_location data via child assets.", + "items": { + "$ref": "CloudAsset" + }, + "type": "array" + } + }, + "type": "object" + }, "AttachedDisk": { "description": "An instance-attached disk resource.", "id": "AttachedDisk", @@ -1410,7 +1446,13 @@ "type": "string" }, "diskType": { - "description": "Optional. Specifies the type of the disk.", + "description": "Optional. Output only. The URI of the disk type resource. For example: projects/project/zones/zone/diskTypes/pd-standard or pd-ssd", + "readOnly": true, + "type": "string" + }, + "diskTypeDeprecated": { + "deprecated": true, + "description": "Specifies the type of the disk.", "enum": [ "DISK_TYPE_UNSPECIFIED", "SCRATCH", @@ -1423,11 +1465,6 @@ ], "type": "string" }, - "diskTypeUri": { - "description": "Optional. Output only. The URI of the disk type resource. For example: projects/project/zones/zone/diskTypes/pd-standard or pd-ssd", - "readOnly": true, - "type": "string" - }, "guestOsFeature": { "description": "Optional. A list of features to enable on the guest operating system. Applicable only for bootable images.", "items": { @@ -1487,6 +1524,20 @@ "source": { "description": "Optional. Specifies a valid partial or full URL to an existing Persistent Disk resource.", "type": "string" + }, + "type": { + "description": "Optional. Specifies the type of the disk.", + "enum": [ + "DISK_TYPE_UNSPECIFIED", + "SCRATCH", + "PERSISTENT" + ], + "enumDescriptions": [ + "Default value, which is unused.", + "A scratch disk type.", + "A persistent disk type." + ], + "type": "string" } }, "type": "object" @@ -1545,6 +1596,7 @@ "properties": { "backupApplianceBackupProperties": { "$ref": "BackupApplianceBackupProperties", + "description": "Output only. Backup Appliance specific backup properties.", "readOnly": true }, "backupApplianceLocks": { @@ -1555,21 +1607,23 @@ "type": "array" }, "backupType": { + "description": "Output only. Type of the backup, unspecified, scheduled or ondemand.", "enum": [ "BACKUP_TYPE_UNSPECIFIED", "SCHEDULED", "ON_DEMAND" ], "enumDescriptions": [ - "", - "", - "" + "Backup type is unspecified.", + "Scheduled backup.", + "On demand backup." ], "readOnly": true, "type": "string" }, "computeInstanceBackupProperties": { "$ref": "ComputeInstanceBackupProperties", + "description": "Output only. Compute Engine specific backup properties.", "readOnly": true }, "consistencyTime": { @@ -1616,7 +1670,7 @@ "type": "object" }, "name": { - "description": "Output only. Name of the resource.", + "description": "Output only. Identifier. Name of the resource.", "readOnly": true, "type": "string" }, @@ -1886,7 +1940,7 @@ "type": "object" }, "name": { - "description": "Output only. The resource name.", + "description": "Output only. Identifier. The resource name.", "readOnly": true, "type": "string" }, @@ -1956,12 +2010,49 @@ }, "type": "object" }, + "BlobstoreLocation": { + "description": "Policy ID that identified data placement in Blobstore as per go/blobstore-user-guide#data-metadata-placement-and-failure-domains", + "id": "BlobstoreLocation", + "properties": { + "policyId": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "CancelOperationRequest": { "description": "The request message for Operations.CancelOperation.", "id": "CancelOperationRequest", "properties": {}, "type": "object" }, + "CloudAsset": { + "id": "CloudAsset", + "properties": { + "assetName": { + "type": "string" + }, + "assetType": { + "type": "string" + } + }, + "type": "object" + }, + "CloudAssetComposition": { + "id": "CloudAssetComposition", + "properties": { + "childAsset": { + "items": { + "$ref": "CloudAsset" + }, + "type": "array" + } + }, + "type": "object" + }, "ComputeInstanceBackupProperties": { "description": "ComputeInstanceBackupProperties represents Compute Engine instance backup properties.", "id": "ComputeInstanceBackupProperties", @@ -2110,7 +2201,7 @@ "type": "string" }, "configState": { - "description": "The backup configuration state.", + "description": "Output only. The backup configuration state.", "enum": [ "BACKUP_CONFIG_STATE_UNSPECIFIED", "ACTIVE", @@ -2121,6 +2212,7 @@ "The data source is actively protected (i.e. there is a BackupPlanAssociation or Appliance SLA pointing to it)", "The data source is no longer protected (but may have backups under it)" ], + "readOnly": true, "type": "string" }, "createTime": { @@ -2149,7 +2241,7 @@ "type": "object" }, "name": { - "description": "Output only. The resource name.", + "description": "Output only. Identifier. The resource name.", "readOnly": true, "type": "string" }, @@ -2248,6 +2340,18 @@ }, "type": "object" }, + "DirectLocationAssignment": { + "id": "DirectLocationAssignment", + "properties": { + "location": { + "items": { + "$ref": "LocationAssignment" + }, + "type": "array" + } + }, + "type": "object" + }, "Empty": { "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", "id": "Empty", @@ -2292,6 +2396,17 @@ }, "type": "object" }, + "ExtraParameter": { + "description": "Defines parameters that should only be used for specific asset types.", + "id": "ExtraParameter", + "properties": { + "regionalMigDistributionPolicy": { + "$ref": "RegionalMigDistributionPolicy", + "description": "Details about zones used by regional compute.googleapis.com/InstanceGroupManager to create instances." + } + }, + "type": "object" + }, "FetchAccessTokenRequest": { "description": "Request message for FetchAccessToken.", "id": "FetchAccessTokenRequest", @@ -2532,6 +2647,131 @@ }, "type": "object" }, + "IsolationExpectations": { + "id": "IsolationExpectations", + "properties": { + "requirementOverride": { + "$ref": "RequirementOverride", + "description": "Explicit overrides for ZI and ZS requirements to be used for resources that should be excluded from ZI/ZS verification logic." + }, + "ziOrgPolicy": { + "enum": [ + "ZI_UNSPECIFIED", + "ZI_UNKNOWN", + "ZI_NOT_REQUIRED", + "ZI_PREFERRED", + "ZI_REQUIRED" + ], + "enumDescriptions": [ + "", + "To be used if tracking is not available", + "", + "", + "" + ], + "type": "string" + }, + "ziRegionPolicy": { + "enum": [ + "ZI_REGION_POLICY_UNSPECIFIED", + "ZI_REGION_POLICY_UNKNOWN", + "ZI_REGION_POLICY_NOT_SET", + "ZI_REGION_POLICY_FAIL_OPEN", + "ZI_REGION_POLICY_FAIL_CLOSED" + ], + "enumDescriptions": [ + "", + "To be used if tracking is not available", + "", + "", + "" + ], + "type": "string" + }, + "ziRegionState": { + "enum": [ + "ZI_REGION_UNSPECIFIED", + "ZI_REGION_UNKNOWN", + "ZI_REGION_NOT_ENABLED", + "ZI_REGION_ENABLED" + ], + "enumDescriptions": [ + "", + "To be used if tracking is not available", + "", + "" + ], + "type": "string" + }, + "zoneIsolation": { + "deprecated": true, + "description": "Deprecated: use zi_org_policy, zi_region_policy and zi_region_state instead for setting ZI expectations as per go/zicy-publish-physical-location.", + "enum": [ + "ZI_UNSPECIFIED", + "ZI_UNKNOWN", + "ZI_NOT_REQUIRED", + "ZI_PREFERRED", + "ZI_REQUIRED" + ], + "enumDescriptions": [ + "", + "To be used if tracking is not available", + "", + "", + "" + ], + "type": "string" + }, + "zoneSeparation": { + "deprecated": true, + "description": "Deprecated: use zs_org_policy, and zs_region_stateinstead for setting Zs expectations as per go/zicy-publish-physical-location.", + "enum": [ + "ZS_UNSPECIFIED", + "ZS_UNKNOWN", + "ZS_NOT_REQUIRED", + "ZS_REQUIRED" + ], + "enumDescriptions": [ + "", + "To be used if tracking is not available", + "", + "" + ], + "type": "string" + }, + "zsOrgPolicy": { + "enum": [ + "ZS_UNSPECIFIED", + "ZS_UNKNOWN", + "ZS_NOT_REQUIRED", + "ZS_REQUIRED" + ], + "enumDescriptions": [ + "", + "To be used if tracking is not available", + "", + "" + ], + "type": "string" + }, + "zsRegionState": { + "enum": [ + "ZS_REGION_UNSPECIFIED", + "ZS_REGION_UNKNOWN", + "ZS_REGION_NOT_ENABLED", + "ZS_REGION_ENABLED" + ], + "enumDescriptions": [ + "", + "To be used if tracking of the asset ZS-bit is not available", + "", + "" + ], + "type": "string" + } + }, + "type": "object" + }, "ListBackupVaultsResponse": { "description": "Response message for listing BackupVaults.", "id": "ListBackupVaultsResponse", @@ -2702,6 +2942,64 @@ }, "type": "object" }, + "LocationAssignment": { + "id": "LocationAssignment", + "properties": { + "location": { + "type": "string" + }, + "locationType": { + "enum": [ + "UNSPECIFIED", + "CLUSTER", + "POP", + "CLOUD_ZONE", + "CLOUD_REGION", + "MULTI_REGION_GEO", + "MULTI_REGION_JURISDICTION", + "GLOBAL", + "OTHER" + ], + "enumDescriptions": [ + "", + "1-10: Physical failure domains.", + "", + "11-20: Logical failure domains.", + "", + "", + "", + "", + "" + ], + "type": "string" + } + }, + "type": "object" + }, + "LocationData": { + "id": "LocationData", + "properties": { + "blobstoreLocation": { + "$ref": "BlobstoreLocation" + }, + "childAssetLocation": { + "$ref": "CloudAssetComposition" + }, + "directLocation": { + "$ref": "DirectLocationAssignment" + }, + "gcpProjectProxy": { + "$ref": "TenantProjectProxy" + }, + "placerLocation": { + "$ref": "PlacerLocation" + }, + "spannerLocation": { + "$ref": "SpannerLocation" + } + }, + "type": "object" + }, "ManagementServer": { "description": "ManagementServer describes a single BackupDR ManagementServer instance.", "id": "ManagementServer", @@ -3101,6 +3399,17 @@ }, "type": "object" }, + "PlacerLocation": { + "description": "Message describing that the location of the customer resource is tied to placer allocations", + "id": "PlacerLocation", + "properties": { + "placerConfig": { + "description": "Directory with a config related to it in placer (e.g. \"/placer/prod/home/my-root/my-dir\")", + "type": "string" + } + }, + "type": "object" + }, "Policy": { "description": "An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { \"bindings\": [ { \"role\": \"roles/resourcemanager.organizationAdmin\", \"members\": [ \"user:mike@example.com\", \"group:admins@example.com\", \"domain:google.com\", \"serviceAccount:my-project-id@appspot.gserviceaccount.com\" ] }, { \"role\": \"roles/resourcemanager.organizationViewer\", \"members\": [ \"user:eve@example.com\" ], \"condition\": { \"title\": \"expirable access\", \"description\": \"Does not grant access after Sep 2020\", \"expression\": \"request.time \u003c timestamp('2020-10-01T00:00:00.000Z')\", } } ], \"etag\": \"BwWWja0YfJA=\", \"version\": 3 } ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time \u003c timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/).", "id": "Policy", @@ -3132,6 +3441,25 @@ }, "type": "object" }, + "RegionalMigDistributionPolicy": { + "description": "To be used for specifying the intended distribution of regional compute.googleapis.com/InstanceGroupManager instances", + "id": "RegionalMigDistributionPolicy", + "properties": { + "targetShape": { + "description": "The shape in which the group converges around distribution of resources. Instance of proto2 enum", + "format": "int32", + "type": "integer" + }, + "zones": { + "description": "Cloud zones used by regional MIG to create instances.", + "items": { + "$ref": "ZoneConfiguration" + }, + "type": "array" + } + }, + "type": "object" + }, "RemoveDataSourceRequest": { "description": "Message for deleting a DataSource.", "id": "RemoveDataSourceRequest", @@ -3143,6 +3471,44 @@ }, "type": "object" }, + "RequirementOverride": { + "id": "RequirementOverride", + "properties": { + "ziOverride": { + "enum": [ + "ZI_UNSPECIFIED", + "ZI_UNKNOWN", + "ZI_NOT_REQUIRED", + "ZI_PREFERRED", + "ZI_REQUIRED" + ], + "enumDescriptions": [ + "", + "To be used if tracking is not available", + "", + "", + "" + ], + "type": "string" + }, + "zsOverride": { + "enum": [ + "ZS_UNSPECIFIED", + "ZS_UNKNOWN", + "ZS_NOT_REQUIRED", + "ZS_REQUIRED" + ], + "enumDescriptions": [ + "", + "To be used if tracking is not available", + "", + "" + ], + "type": "string" + } + }, + "type": "object" + }, "Scheduling": { "description": "Sets the scheduling options for an Instance.", "id": "Scheduling", @@ -3284,7 +3650,7 @@ "id": "SetInternalStatusRequest", "properties": { "backupConfigState": { - "description": "Required. The new BackupConfigState to set for the DataSource.", + "description": "Required. Output only. The new BackupConfigState to set for the DataSource.", "enum": [ "BACKUP_CONFIG_STATE_UNSPECIFIED", "ACTIVE", @@ -3295,6 +3661,7 @@ "The data source is actively protected (i.e. there is a BackupPlanAssociation or Appliance SLA pointing to it)", "The data source is no longer protected (but may have backups under it)" ], + "readOnly": true, "type": "string" }, "requestId": { @@ -3309,6 +3676,26 @@ }, "type": "object" }, + "SpannerLocation": { + "id": "SpannerLocation", + "properties": { + "backupName": { + "description": "Set of backups used by the resource with name in the same format as what is available at http://table/spanner_automon.backup_metadata", + "items": { + "type": "string" + }, + "type": "array" + }, + "dbName": { + "description": "Set of databases used by the resource in format /span//", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "Status": { "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", "id": "Status", @@ -3350,6 +3737,18 @@ }, "type": "object" }, + "TenantProjectProxy": { + "id": "TenantProjectProxy", + "properties": { + "projectNumbers": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "TestIamPermissionsRequest": { "description": "Request message for `TestIamPermissions` method.", "id": "TestIamPermissionsRequest", @@ -3411,6 +3810,15 @@ } }, "type": "object" + }, + "ZoneConfiguration": { + "id": "ZoneConfiguration", + "properties": { + "zone": { + "type": "string" + } + }, + "type": "object" } }, "servicePath": "", diff --git a/backupdr/v1/backupdr-gen.go b/backupdr/v1/backupdr-gen.go index 16f502bfc44..f316b47492e 100644 --- a/backupdr/v1/backupdr-gen.go +++ b/backupdr/v1/backupdr-gen.go @@ -377,6 +377,41 @@ func (s AliasIpRange) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// AssetLocation: Provides the mapping of a cloud asset to a direct physical +// location or to a proxy that defines the location on its behalf. +type AssetLocation struct { + // CcfeRmsPath: Spanner path of the CCFE RMS database. It is only applicable + // for CCFE tenants that use CCFE RMS for storing resource metadata. + CcfeRmsPath string `json:"ccfeRmsPath,omitempty"` + // Expected: Defines the customer expectation around ZI/ZS for this asset and + // ZI/ZS state of the region at the time of asset creation. + Expected *IsolationExpectations `json:"expected,omitempty"` + // ExtraParameters: Defines extra parameters required for specific asset types. + ExtraParameters []*ExtraParameter `json:"extraParameters,omitempty"` + // LocationData: Contains all kinds of physical location definitions for this + // asset. + LocationData []*LocationData `json:"locationData,omitempty"` + // ParentAsset: Defines parents assets if any in order to allow later + // generation of child_asset_location data via child assets. + ParentAsset []*CloudAsset `json:"parentAsset,omitempty"` + // ForceSendFields is a list of field names (e.g. "CcfeRmsPath") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CcfeRmsPath") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s AssetLocation) MarshalJSON() ([]byte, error) { + type NoMethod AssetLocation + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // AttachedDisk: An instance-attached disk resource. type AttachedDisk struct { // AutoDelete: Optional. Specifies whether the disk will be auto-deleted when @@ -405,16 +440,16 @@ type AttachedDisk struct { DiskInterface string `json:"diskInterface,omitempty"` // DiskSizeGb: Optional. The size of the disk in GB. DiskSizeGb int64 `json:"diskSizeGb,omitempty,string"` - // DiskType: Optional. Specifies the type of the disk. + // DiskType: Optional. Output only. The URI of the disk type resource. For + // example: projects/project/zones/zone/diskTypes/pd-standard or pd-ssd + DiskType string `json:"diskType,omitempty"` + // DiskTypeDeprecated: Specifies the type of the disk. // // Possible values: // "DISK_TYPE_UNSPECIFIED" - Default value, which is unused. // "SCRATCH" - A scratch disk type. // "PERSISTENT" - A persistent disk type. - DiskType string `json:"diskType,omitempty"` - // DiskTypeUri: Optional. Output only. The URI of the disk type resource. For - // example: projects/project/zones/zone/diskTypes/pd-standard or pd-ssd - DiskTypeUri string `json:"diskTypeUri,omitempty"` + DiskTypeDeprecated string `json:"diskTypeDeprecated,omitempty"` // GuestOsFeature: Optional. A list of features to enable on the guest // operating system. Applicable only for bootable images. GuestOsFeature []*GuestOsFeature `json:"guestOsFeature,omitempty"` @@ -450,6 +485,13 @@ type AttachedDisk struct { // Source: Optional. Specifies a valid partial or full URL to an existing // Persistent Disk resource. Source string `json:"source,omitempty"` + // Type: Optional. Specifies the type of the disk. + // + // Possible values: + // "DISK_TYPE_UNSPECIFIED" - Default value, which is unused. + // "SCRATCH" - A scratch disk type. + // "PERSISTENT" - A persistent disk type. + Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "AutoDelete") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -546,15 +588,22 @@ func (s AuditLogConfig) MarshalJSON() ([]byte, error) { // Backup: Message describing a Backup object. type Backup struct { + // BackupApplianceBackupProperties: Output only. Backup Appliance specific + // backup properties. BackupApplianceBackupProperties *BackupApplianceBackupProperties `json:"backupApplianceBackupProperties,omitempty"` // BackupApplianceLocks: Optional. The list of BackupLocks taken by the // accessor Backup Appliance. BackupApplianceLocks []*BackupLock `json:"backupApplianceLocks,omitempty"` + // BackupType: Output only. Type of the backup, unspecified, scheduled or + // ondemand. + // // Possible values: - // "BACKUP_TYPE_UNSPECIFIED" - // "SCHEDULED" - // "ON_DEMAND" - BackupType string `json:"backupType,omitempty"` + // "BACKUP_TYPE_UNSPECIFIED" - Backup type is unspecified. + // "SCHEDULED" - Scheduled backup. + // "ON_DEMAND" - On demand backup. + BackupType string `json:"backupType,omitempty"` + // ComputeInstanceBackupProperties: Output only. Compute Engine specific backup + // properties. ComputeInstanceBackupProperties *ComputeInstanceBackupProperties `json:"computeInstanceBackupProperties,omitempty"` // ConsistencyTime: Output only. The point in time when this backup was // captured from the source. @@ -577,7 +626,7 @@ type Backup struct { // Labels: Optional. Resource labels to represent user provided metadata. No // labels currently defined. Labels map[string]string `json:"labels,omitempty"` - // Name: Output only. Name of the resource. + // Name: Output only. Identifier. Name of the resource. Name string `json:"name,omitempty"` // ResourceSizeBytes: Output only. source resource size in bytes at the time of // the backup. @@ -829,7 +878,7 @@ type BackupVault struct { // Labels: Optional. Resource labels to represent user provided metadata. No // labels currently defined: Labels map[string]string `json:"labels,omitempty"` - // Name: Output only. The resource name. + // Name: Output only. Identifier. The resource name. Name string `json:"name,omitempty"` // ServiceAccount: Output only. Service account used by the BackupVault Service // for this BackupVault. The user should grant this account permissions in @@ -973,10 +1022,73 @@ func (s Binding) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// BlobstoreLocation: Policy ID that identified data placement in Blobstore as +// per go/blobstore-user-guide#data-metadata-placement-and-failure-domains +type BlobstoreLocation struct { + PolicyId []string `json:"policyId,omitempty"` + // ForceSendFields is a list of field names (e.g. "PolicyId") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "PolicyId") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s BlobstoreLocation) MarshalJSON() ([]byte, error) { + type NoMethod BlobstoreLocation + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // CancelOperationRequest: The request message for Operations.CancelOperation. type CancelOperationRequest struct { } +type CloudAsset struct { + AssetName string `json:"assetName,omitempty"` + AssetType string `json:"assetType,omitempty"` + // ForceSendFields is a list of field names (e.g. "AssetName") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AssetName") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s CloudAsset) MarshalJSON() ([]byte, error) { + type NoMethod CloudAsset + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type CloudAssetComposition struct { + ChildAsset []*CloudAsset `json:"childAsset,omitempty"` + // ForceSendFields is a list of field names (e.g. "ChildAsset") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ChildAsset") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s CloudAssetComposition) MarshalJSON() ([]byte, error) { + type NoMethod CloudAssetComposition + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ComputeInstanceBackupProperties: ComputeInstanceBackupProperties represents // Compute Engine instance backup properties. type ComputeInstanceBackupProperties struct { @@ -1133,7 +1245,7 @@ type DataSource struct { BackupConfigInfo *BackupConfigInfo `json:"backupConfigInfo,omitempty"` // BackupCount: Number of backups in the data source. BackupCount int64 `json:"backupCount,omitempty,string"` - // ConfigState: The backup configuration state. + // ConfigState: Output only. The backup configuration state. // // Possible values: // "BACKUP_CONFIG_STATE_UNSPECIFIED" - The possible states of backup @@ -1159,7 +1271,7 @@ type DataSource struct { // Labels: Optional. Resource labels to represent user provided metadata. No // labels currently defined: Labels map[string]string `json:"labels,omitempty"` - // Name: Output only. The resource name. + // Name: Output only. Identifier. The resource name. Name string `json:"name,omitempty"` // State: Output only. The DataSource resource instance state. // @@ -1269,6 +1381,26 @@ func (s DataSourceGcpResource) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type DirectLocationAssignment struct { + Location []*LocationAssignment `json:"location,omitempty"` + // ForceSendFields is a list of field names (e.g. "Location") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Location") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s DirectLocationAssignment) MarshalJSON() ([]byte, error) { + type NoMethod DirectLocationAssignment + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Empty: A generic empty message that you can re-use to avoid defining // duplicated empty messages in your APIs. A typical example is to use it as // the request or the response type of an API method. For instance: service Foo @@ -1353,6 +1485,30 @@ func (s Expr) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ExtraParameter: Defines parameters that should only be used for specific +// asset types. +type ExtraParameter struct { + // RegionalMigDistributionPolicy: Details about zones used by regional + // compute.googleapis.com/InstanceGroupManager to create instances. + RegionalMigDistributionPolicy *RegionalMigDistributionPolicy `json:"regionalMigDistributionPolicy,omitempty"` + // ForceSendFields is a list of field names (e.g. + // "RegionalMigDistributionPolicy") to unconditionally include in API requests. + // By default, fields with empty or default values are omitted from API + // requests. See https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields + // for more details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "RegionalMigDistributionPolicy") + // to include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ExtraParameter) MarshalJSON() ([]byte, error) { + type NoMethod ExtraParameter + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // FetchAccessTokenRequest: Request message for FetchAccessToken. type FetchAccessTokenRequest struct { // GenerationId: Required. The generation of the backup to update. @@ -1683,6 +1839,81 @@ func (s InitiateBackupResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type IsolationExpectations struct { + // RequirementOverride: Explicit overrides for ZI and ZS requirements to be + // used for resources that should be excluded from ZI/ZS verification logic. + RequirementOverride *RequirementOverride `json:"requirementOverride,omitempty"` + // Possible values: + // "ZI_UNSPECIFIED" + // "ZI_UNKNOWN" - To be used if tracking is not available + // "ZI_NOT_REQUIRED" + // "ZI_PREFERRED" + // "ZI_REQUIRED" + ZiOrgPolicy string `json:"ziOrgPolicy,omitempty"` + // Possible values: + // "ZI_REGION_POLICY_UNSPECIFIED" + // "ZI_REGION_POLICY_UNKNOWN" - To be used if tracking is not available + // "ZI_REGION_POLICY_NOT_SET" + // "ZI_REGION_POLICY_FAIL_OPEN" + // "ZI_REGION_POLICY_FAIL_CLOSED" + ZiRegionPolicy string `json:"ziRegionPolicy,omitempty"` + // Possible values: + // "ZI_REGION_UNSPECIFIED" + // "ZI_REGION_UNKNOWN" - To be used if tracking is not available + // "ZI_REGION_NOT_ENABLED" + // "ZI_REGION_ENABLED" + ZiRegionState string `json:"ziRegionState,omitempty"` + // ZoneIsolation: Deprecated: use zi_org_policy, zi_region_policy and + // zi_region_state instead for setting ZI expectations as per + // go/zicy-publish-physical-location. + // + // Possible values: + // "ZI_UNSPECIFIED" + // "ZI_UNKNOWN" - To be used if tracking is not available + // "ZI_NOT_REQUIRED" + // "ZI_PREFERRED" + // "ZI_REQUIRED" + ZoneIsolation string `json:"zoneIsolation,omitempty"` + // ZoneSeparation: Deprecated: use zs_org_policy, and zs_region_stateinstead + // for setting Zs expectations as per go/zicy-publish-physical-location. + // + // Possible values: + // "ZS_UNSPECIFIED" + // "ZS_UNKNOWN" - To be used if tracking is not available + // "ZS_NOT_REQUIRED" + // "ZS_REQUIRED" + ZoneSeparation string `json:"zoneSeparation,omitempty"` + // Possible values: + // "ZS_UNSPECIFIED" + // "ZS_UNKNOWN" - To be used if tracking is not available + // "ZS_NOT_REQUIRED" + // "ZS_REQUIRED" + ZsOrgPolicy string `json:"zsOrgPolicy,omitempty"` + // Possible values: + // "ZS_REGION_UNSPECIFIED" + // "ZS_REGION_UNKNOWN" - To be used if tracking of the asset ZS-bit is not + // available + // "ZS_REGION_NOT_ENABLED" + // "ZS_REGION_ENABLED" + ZsRegionState string `json:"zsRegionState,omitempty"` + // ForceSendFields is a list of field names (e.g. "RequirementOverride") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "RequirementOverride") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s IsolationExpectations) MarshalJSON() ([]byte, error) { + type NoMethod IsolationExpectations + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ListBackupVaultsResponse: Response message for listing BackupVaults. type ListBackupVaultsResponse struct { // BackupVaults: The list of BackupVault instances in the project for the @@ -1918,6 +2149,62 @@ func (s Location) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type LocationAssignment struct { + Location string `json:"location,omitempty"` + // Possible values: + // "UNSPECIFIED" + // "CLUSTER" - 1-10: Physical failure domains. + // "POP" + // "CLOUD_ZONE" - 11-20: Logical failure domains. + // "CLOUD_REGION" + // "MULTI_REGION_GEO" + // "MULTI_REGION_JURISDICTION" + // "GLOBAL" + // "OTHER" + LocationType string `json:"locationType,omitempty"` + // ForceSendFields is a list of field names (e.g. "Location") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Location") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s LocationAssignment) MarshalJSON() ([]byte, error) { + type NoMethod LocationAssignment + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type LocationData struct { + BlobstoreLocation *BlobstoreLocation `json:"blobstoreLocation,omitempty"` + ChildAssetLocation *CloudAssetComposition `json:"childAssetLocation,omitempty"` + DirectLocation *DirectLocationAssignment `json:"directLocation,omitempty"` + GcpProjectProxy *TenantProjectProxy `json:"gcpProjectProxy,omitempty"` + PlacerLocation *PlacerLocation `json:"placerLocation,omitempty"` + SpannerLocation *SpannerLocation `json:"spannerLocation,omitempty"` + // ForceSendFields is a list of field names (e.g. "BlobstoreLocation") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BlobstoreLocation") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s LocationData) MarshalJSON() ([]byte, error) { + type NoMethod LocationData + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ManagementServer: ManagementServer describes a single BackupDR // ManagementServer instance. type ManagementServer struct { @@ -2293,6 +2580,30 @@ func (s OperationMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// PlacerLocation: Message describing that the location of the customer +// resource is tied to placer allocations +type PlacerLocation struct { + // PlacerConfig: Directory with a config related to it in placer (e.g. + // "/placer/prod/home/my-root/my-dir") + PlacerConfig string `json:"placerConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. "PlacerConfig") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "PlacerConfig") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s PlacerLocation) MarshalJSON() ([]byte, error) { + type NoMethod PlacerLocation + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Policy: An Identity and Access Management (IAM) policy, which specifies // access controls for Google Cloud resources. A `Policy` is a collection of // `bindings`. A `binding` binds one or more `members`, or principals, to a @@ -2385,6 +2696,33 @@ func (s Policy) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// RegionalMigDistributionPolicy: To be used for specifying the intended +// distribution of regional compute.googleapis.com/InstanceGroupManager +// instances +type RegionalMigDistributionPolicy struct { + // TargetShape: The shape in which the group converges around distribution of + // resources. Instance of proto2 enum + TargetShape int64 `json:"targetShape,omitempty"` + // Zones: Cloud zones used by regional MIG to create instances. + Zones []*ZoneConfiguration `json:"zones,omitempty"` + // ForceSendFields is a list of field names (e.g. "TargetShape") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "TargetShape") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s RegionalMigDistributionPolicy) MarshalJSON() ([]byte, error) { + type NoMethod RegionalMigDistributionPolicy + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // RemoveDataSourceRequest: Message for deleting a DataSource. type RemoveDataSourceRequest struct { // RequestId: Optional. An optional request ID to identify requests. Specify a @@ -2417,6 +2755,38 @@ func (s RemoveDataSourceRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type RequirementOverride struct { + // Possible values: + // "ZI_UNSPECIFIED" + // "ZI_UNKNOWN" - To be used if tracking is not available + // "ZI_NOT_REQUIRED" + // "ZI_PREFERRED" + // "ZI_REQUIRED" + ZiOverride string `json:"ziOverride,omitempty"` + // Possible values: + // "ZS_UNSPECIFIED" + // "ZS_UNKNOWN" - To be used if tracking is not available + // "ZS_NOT_REQUIRED" + // "ZS_REQUIRED" + ZsOverride string `json:"zsOverride,omitempty"` + // ForceSendFields is a list of field names (e.g. "ZiOverride") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ZiOverride") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s RequirementOverride) MarshalJSON() ([]byte, error) { + type NoMethod RequirementOverride + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Scheduling: Sets the scheduling options for an Instance. type Scheduling struct { // AutomaticRestart: Optional. Specifies whether the instance should be @@ -2590,8 +2960,8 @@ func (s SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // SetInternalStatusRequest: Request message for SetStatusInternal method. type SetInternalStatusRequest struct { - // BackupConfigState: Required. The new BackupConfigState to set for the - // DataSource. + // BackupConfigState: Required. Output only. The new BackupConfigState to set + // for the DataSource. // // Possible values: // "BACKUP_CONFIG_STATE_UNSPECIFIED" - The possible states of backup @@ -2633,6 +3003,30 @@ func (s SetInternalStatusRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type SpannerLocation struct { + // BackupName: Set of backups used by the resource with name in the same format + // as what is available at http://table/spanner_automon.backup_metadata + BackupName []string `json:"backupName,omitempty"` + // DbName: Set of databases used by the resource in format /span// + DbName []string `json:"dbName,omitempty"` + // ForceSendFields is a list of field names (e.g. "BackupName") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BackupName") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s SpannerLocation) MarshalJSON() ([]byte, error) { + type NoMethod SpannerLocation + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Status: The `Status` type defines a logical error model that is suitable for // different programming environments, including REST APIs and RPC APIs. It is // used by gRPC (https://github.com/grpc). Each `Status` message contains three @@ -2690,6 +3084,26 @@ func (s Tags) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type TenantProjectProxy struct { + ProjectNumbers []string `json:"projectNumbers,omitempty"` + // ForceSendFields is a list of field names (e.g. "ProjectNumbers") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ProjectNumbers") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s TenantProjectProxy) MarshalJSON() ([]byte, error) { + type NoMethod TenantProjectProxy + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // TestIamPermissionsRequest: Request message for `TestIamPermissions` method. type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. Permissions @@ -2796,6 +3210,26 @@ func (s WorkforceIdentityBasedOAuth2ClientID) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type ZoneConfiguration struct { + Zone string `json:"zone,omitempty"` + // ForceSendFields is a list of field names (e.g. "Zone") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Zone") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ZoneConfiguration) MarshalJSON() ([]byte, error) { + type NoMethod ZoneConfiguration + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type ProjectsLocationsGetCall struct { s *Service name string @@ -3772,7 +4206,7 @@ type ProjectsLocationsBackupVaultsPatchCall struct { // Patch: Updates the settings of a BackupVault. // -// - name: Output only. The resource name. +// - name: Output only. Identifier. The resource name. func (r *ProjectsLocationsBackupVaultsService) Patch(name string, backupvault *BackupVault) *ProjectsLocationsBackupVaultsPatchCall { c := &ProjectsLocationsBackupVaultsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -3781,7 +4215,7 @@ func (r *ProjectsLocationsBackupVaultsService) Patch(name string, backupvault *B } // Force sets the optional parameter "force": If set to true, will not check -// plan duration against backup vault enforcement duration. Non-standard field. +// plan duration against backup vault enforcement duration. func (c *ProjectsLocationsBackupVaultsPatchCall) Force(force bool) *ProjectsLocationsBackupVaultsPatchCall { c.urlParams_.Set("force", fmt.Sprint(force)) return c @@ -4702,7 +5136,7 @@ type ProjectsLocationsBackupVaultsDataSourcesPatchCall struct { // Patch: Updates the settings of a DataSource. // -// - name: Output only. The resource name. +// - name: Output only. Identifier. The resource name. func (r *ProjectsLocationsBackupVaultsDataSourcesService) Patch(name string, datasource *DataSource) *ProjectsLocationsBackupVaultsDataSourcesPatchCall { c := &ProjectsLocationsBackupVaultsDataSourcesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -5421,7 +5855,7 @@ type ProjectsLocationsBackupVaultsDataSourcesBackupsPatchCall struct { // Patch: Updates the settings of a Backup. // -// - name: Output only. Name of the resource. +// - name: Output only. Identifier. Name of the resource. func (r *ProjectsLocationsBackupVaultsDataSourcesBackupsService) Patch(name string, backup *Backup) *ProjectsLocationsBackupVaultsDataSourcesBackupsPatchCall { c := &ProjectsLocationsBackupVaultsDataSourcesBackupsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name diff --git a/batch/v1/batch-api.json b/batch/v1/batch-api.json index bfb227984db..0feb96855b0 100644 --- a/batch/v1/batch-api.json +++ b/batch/v1/batch-api.json @@ -561,7 +561,7 @@ } } }, - "revision": "20240703", + "revision": "20240729", "rootUrl": "https://batch.googleapis.com/", "schemas": { "Accelerator": { @@ -1031,7 +1031,7 @@ "type": "object" }, "Barrier": { - "description": "Barrier runnable blocks until all tasks in a taskgroup reach it.", + "description": "A barrier runnable automatically blocks the execution of subsequent runnables until all the tasks in the task group reach the barrier.", "id": "Barrier", "properties": { "name": { @@ -1089,7 +1089,7 @@ "type": "boolean" }, "commands": { - "description": "Overrides the `CMD` specified in the container. If there is an ENTRYPOINT (either in the container image or with the entrypoint field below) then commands are appended as arguments to the ENTRYPOINT.", + "description": "Required for some container images. Overrides the `CMD` specified in the container. If there is an `ENTRYPOINT` (either in the container image or with the `entrypoint` field below) then these commands are appended as arguments to the `ENTRYPOINT`.", "items": { "type": "string" }, @@ -1100,15 +1100,15 @@ "type": "boolean" }, "entrypoint": { - "description": "Overrides the `ENTRYPOINT` specified in the container.", + "description": "Required for some container images. Overrides the `ENTRYPOINT` specified in the container.", "type": "string" }, "imageUri": { - "description": "The URI to pull the container image from.", + "description": "Required. The URI to pull the container image from.", "type": "string" }, "options": { - "description": "Arbitrary additional options to include in the \"docker run\" command when running this container, e.g. \"--network host\".", + "description": "Required for some container images. Arbitrary additional options to include in the `docker run` command when running this container—for example, `--network host`. For the `--volume` option, use the `volumes` field for the container.", "type": "string" }, "password": { @@ -1120,7 +1120,7 @@ "type": "string" }, "volumes": { - "description": "Volumes to mount (bind mount) from the host machine files or directories into the container, formatted to match docker run's --volume option, e.g. /foo:/bar, or /foo:/bar:ro If the `TaskSpec.Volumes` field is specified but this field is not, Batch will mount each volume from the host machine to the container with the same mount path by default. In this case, the default mount option for containers will be read-only (ro) for existing persistent disks and read-write (rw) for other volume types, regardless of the original mount options specified in `TaskSpec.Volumes`. If you need different mount settings, you can explicitly configure them in this field.", + "description": "Volumes to mount (bind mount) from the host machine files or directories into the container, formatted to match `--volume` option for the `docker run` command—for example, `/foo:/bar` or `/foo:/bar:ro`. If the `TaskSpec.Volumes` field is specified but this field is not, Batch will mount each volume from the host machine to the container with the same mount path by default. In this case, the default mount option for containers will be read-only (`ro`) for existing persistent disks and read-write (`rw`) for other volume types, regardless of the original mount options specified in `TaskSpec.Volumes`. If you need different mount settings, you can explicitly configure them in this field.", "items": { "type": "string" }, @@ -1138,7 +1138,7 @@ "type": "string" }, "image": { - "description": "URL for a VM image to use as the data source for this disk. For example, the following are all valid URLs: * Specify the image by its family name: projects/{project}/global/images/family/{image_family} * Specify the image version: projects/{project}/global/images/{image_version} You can also use Batch customized image in short names. The following image values are supported for a boot disk: * `batch-debian`: use Batch Debian images. * `batch-centos`: use Batch CentOS images. * `batch-cos`: use Batch Container-Optimized images. * `batch-hpc-centos`: use Batch HPC CentOS images. * `batch-hpc-rocky`: use Batch HPC Rocky Linux images.", + "description": "URL for a VM image to use as the data source for this disk. For example, the following are all valid URLs: * Specify the image by its family name: projects/{project}/global/images/family/{image_family} * Specify the image version: projects/{project}/global/images/{image_version} You can also use Batch customized image in short names. The following image values are supported for a boot disk: * `batch-debian`: use Batch Debian images. * `batch-cos`: use Batch Container-Optimized images. * `batch-hpc-rocky`: use Batch HPC Rocky Linux images.", "type": "string" }, "sizeGb": { @@ -1954,11 +1954,11 @@ "id": "Script", "properties": { "path": { - "description": "Script file path on the host VM. To specify an interpreter, please add a `#!`(also known as [shebang line](https://en.wikipedia.org/wiki/Shebang_(Unix))) as the first line of the file.(For example, to execute the script using bash, `#!/bin/bash` should be the first line of the file. To execute the script using`Python3`, `#!/usr/bin/env python3` should be the first line of the file.) Otherwise, the file will by default be executed by `/bin/sh`.", + "description": "The path to a script file that is accessible from the host VM(s). Unless the script file supports the default `#!/bin/sh` shell interpreter, you must specify an interpreter by including a [shebang line](https://en.wikipedia.org/wiki/Shebang_(Unix) as the first line of the file. For example, to execute the script using bash, include `#!/bin/bash` as the first line of the file. Alternatively, to execute the script using Python3, include `#!/usr/bin/env python3` as the first line of the file.", "type": "string" }, "text": { - "description": "Shell script text. To specify an interpreter, please add a `#!\\n` at the beginning of the text.(For example, to execute the script using bash, `#!/bin/bash\\n` should be added. To execute the script using`Python3`, `#!/usr/bin/env python3\\n` should be added.) Otherwise, the script will by default be executed by `/bin/sh`.", + "description": "The text for a script. Unless the script text supports the default `#!/bin/sh` shell interpreter, you must specify an interpreter by including a [shebang line](https://en.wikipedia.org/wiki/Shebang_(Unix) at the beginning of the text. For example, to execute the script using bash, include `#!/bin/bash\\n` at the beginning of the text. Alternatively, to execute the script using Python3, include `#!/usr/bin/env python3\\n` at the beginning of the text.", "type": "string" } }, @@ -2206,7 +2206,7 @@ "type": "string" }, "runnables": { - "description": "The sequence of scripts or containers to run for this Task. Each Task using this TaskSpec executes its list of runnables in order. The Task succeeds if all of its runnables either exit with a zero status or any that exit with a non-zero status have the ignore_exit_status flag. Background runnables are killed automatically (if they have not already exited) a short time after all foreground runnables have completed. Even though this is likely to result in a non-zero exit status for the background runnable, these automatic kills are not treated as Task failures.", + "description": "Required. The sequence of one or more runnables (executable scripts, executable containers, and/or barriers) for each task in this task group to run. Each task runs this list of runnables in order. For a task to succeed, all of its script and container runnables each must either exit with a zero status or enable the `ignore_exit_status` subfield and exit with any status. Background runnables are killed automatically (if they have not already exited) a short time after all foreground runnables have completed. Even though this is likely to result in a non-zero exit status for the background runnable, these automatic kills are not treated as Task failures.", "items": { "$ref": "Runnable" }, diff --git a/batch/v1/batch-gen.go b/batch/v1/batch-gen.go index 98534abff12..aa43a59b378 100644 --- a/batch/v1/batch-gen.go +++ b/batch/v1/batch-gen.go @@ -804,7 +804,8 @@ func (s AttachedDisk) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Barrier: Barrier runnable blocks until all tasks in a taskgroup reach it. +// Barrier: A barrier runnable automatically blocks the execution of subsequent +// runnables until all the tasks in the task group reach the barrier. type Barrier struct { // Name: Barriers are identified by their index in runnable list. Names are not // required, but if present should be an identifier. @@ -922,9 +923,10 @@ type Container struct { // as true can still communicate with each other, network cannot be specified // in the `container.options` field. BlockExternalNetwork bool `json:"blockExternalNetwork,omitempty"` - // Commands: Overrides the `CMD` specified in the container. If there is an - // ENTRYPOINT (either in the container image or with the entrypoint field - // below) then commands are appended as arguments to the ENTRYPOINT. + // Commands: Required for some container images. Overrides the `CMD` specified + // in the container. If there is an `ENTRYPOINT` (either in the container image + // or with the `entrypoint` field below) then these commands are appended as + // arguments to the `ENTRYPOINT`. Commands []string `json:"commands,omitempty"` // EnableImageStreaming: Optional. If set to true, this container runnable uses // Image streaming. Use Image streaming to allow the runnable to initialize @@ -938,12 +940,15 @@ type Container struct { // using Image streaming with Batch, see the `image-streaming` sample on GitHub // (https://github.com/GoogleCloudPlatform/batch-samples/tree/main/api-samples/image-streaming). EnableImageStreaming bool `json:"enableImageStreaming,omitempty"` - // Entrypoint: Overrides the `ENTRYPOINT` specified in the container. + // Entrypoint: Required for some container images. Overrides the `ENTRYPOINT` + // specified in the container. Entrypoint string `json:"entrypoint,omitempty"` - // ImageUri: The URI to pull the container image from. + // ImageUri: Required. The URI to pull the container image from. ImageUri string `json:"imageUri,omitempty"` - // Options: Arbitrary additional options to include in the "docker run" command - // when running this container, e.g. "--network host". + // Options: Required for some container images. Arbitrary additional options to + // include in the `docker run` command when running this container—for + // example, `--network host`. For the `--volume` option, use the `volumes` + // field for the container. Options string `json:"options,omitempty"` // Password: Required if the container image is from a private Docker registry. // The password to login to the Docker registry that contains the image. For @@ -970,14 +975,15 @@ type Container struct { // (https://cloud.google.com/batch/docs/create-run-job-secret-manager). Username string `json:"username,omitempty"` // Volumes: Volumes to mount (bind mount) from the host machine files or - // directories into the container, formatted to match docker run's --volume - // option, e.g. /foo:/bar, or /foo:/bar:ro If the `TaskSpec.Volumes` field is - // specified but this field is not, Batch will mount each volume from the host - // machine to the container with the same mount path by default. In this case, - // the default mount option for containers will be read-only (ro) for existing - // persistent disks and read-write (rw) for other volume types, regardless of - // the original mount options specified in `TaskSpec.Volumes`. If you need - // different mount settings, you can explicitly configure them in this field. + // directories into the container, formatted to match `--volume` option for the + // `docker run` command—for example, `/foo:/bar` or `/foo:/bar:ro`. If the + // `TaskSpec.Volumes` field is specified but this field is not, Batch will + // mount each volume from the host machine to the container with the same mount + // path by default. In this case, the default mount option for containers will + // be read-only (`ro`) for existing persistent disks and read-write (`rw`) for + // other volume types, regardless of the original mount options specified in + // `TaskSpec.Volumes`. If you need different mount settings, you can explicitly + // configure them in this field. Volumes []string `json:"volumes,omitempty"` // ForceSendFields is a list of field names (e.g. "BlockExternalNetwork") to // unconditionally include in API requests. By default, fields with empty or @@ -1014,9 +1020,8 @@ type Disk struct { // image version: projects/{project}/global/images/{image_version} You can also // use Batch customized image in short names. The following image values are // supported for a boot disk: * `batch-debian`: use Batch Debian images. * - // `batch-centos`: use Batch CentOS images. * `batch-cos`: use Batch - // Container-Optimized images. * `batch-hpc-centos`: use Batch HPC CentOS - // images. * `batch-hpc-rocky`: use Batch HPC Rocky Linux images. + // `batch-cos`: use Batch Container-Optimized images. * `batch-hpc-rocky`: use + // Batch HPC Rocky Linux images. Image string `json:"image,omitempty"` // SizeGb: Disk size in GB. **Non-Boot Disk**: If the `type` specifies a // persistent disk, this field is ignored if `data_source` is set as `image` or @@ -2040,19 +2045,21 @@ func (s Runnable) MarshalJSON() ([]byte, error) { // Script: Script runnable. type Script struct { - // Path: Script file path on the host VM. To specify an interpreter, please add - // a `#!`(also known as shebang line - // (https://en.wikipedia.org/wiki/Shebang_(Unix))) as the first line of the - // file.(For example, to execute the script using bash, `#!/bin/bash` should be - // the first line of the file. To execute the script using`Python3`, - // `#!/usr/bin/env python3` should be the first line of the file.) Otherwise, - // the file will by default be executed by `/bin/sh`. + // Path: The path to a script file that is accessible from the host VM(s). + // Unless the script file supports the default `#!/bin/sh` shell interpreter, + // you must specify an interpreter by including a shebang line + // (https://en.wikipedia.org/wiki/Shebang_(Unix) as the first line of the file. + // For example, to execute the script using bash, include `#!/bin/bash` as the + // first line of the file. Alternatively, to execute the script using Python3, + // include `#!/usr/bin/env python3` as the first line of the file. Path string `json:"path,omitempty"` - // Text: Shell script text. To specify an interpreter, please add a `#!\n` at - // the beginning of the text.(For example, to execute the script using bash, - // `#!/bin/bash\n` should be added. To execute the script using`Python3`, - // `#!/usr/bin/env python3\n` should be added.) Otherwise, the script will by - // default be executed by `/bin/sh`. + // Text: The text for a script. Unless the script text supports the default + // `#!/bin/sh` shell interpreter, you must specify an interpreter by including + // a shebang line (https://en.wikipedia.org/wiki/Shebang_(Unix) at the + // beginning of the text. For example, to execute the script using bash, + // include `#!/bin/bash\n` at the beginning of the text. Alternatively, to + // execute the script using Python3, include `#!/usr/bin/env python3\n` at the + // beginning of the text. Text string `json:"text,omitempty"` // ForceSendFields is a list of field names (e.g. "Path") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -2356,14 +2363,15 @@ type TaskSpec struct { // time for a job listed at // https://cloud.google.com/batch/quotas#max-job-duration. MaxRunDuration string `json:"maxRunDuration,omitempty"` - // Runnables: The sequence of scripts or containers to run for this Task. Each - // Task using this TaskSpec executes its list of runnables in order. The Task - // succeeds if all of its runnables either exit with a zero status or any that - // exit with a non-zero status have the ignore_exit_status flag. Background - // runnables are killed automatically (if they have not already exited) a short - // time after all foreground runnables have completed. Even though this is - // likely to result in a non-zero exit status for the background runnable, - // these automatic kills are not treated as Task failures. + // Runnables: Required. The sequence of one or more runnables (executable + // scripts, executable containers, and/or barriers) for each task in this task + // group to run. Each task runs this list of runnables in order. For a task to + // succeed, all of its script and container runnables each must either exit + // with a zero status or enable the `ignore_exit_status` subfield and exit with + // any status. Background runnables are killed automatically (if they have not + // already exited) a short time after all foreground runnables have completed. + // Even though this is likely to result in a non-zero exit status for the + // background runnable, these automatic kills are not treated as Task failures. Runnables []*Runnable `json:"runnables,omitempty"` // Volumes: Volumes to mount before running Tasks using this TaskSpec. Volumes []*Volume `json:"volumes,omitempty"` diff --git a/beyondcorp/v1alpha/beyondcorp-api.json b/beyondcorp/v1alpha/beyondcorp-api.json index 47ea5a89007..9bf1dbcd678 100644 --- a/beyondcorp/v1alpha/beyondcorp-api.json +++ b/beyondcorp/v1alpha/beyondcorp-api.json @@ -1027,6 +1027,33 @@ "parent" ], "parameters": { + "aggregation": { + "description": "Optional. Aggregation type. The default is 'DAILY'.", + "enum": [ + "AGGREGATION_UNSPECIFIED", + "HOURLY", + "DAILY", + "WEEKLY", + "MONTHLY", + "CUSTOM_DATE_RANGE" + ], + "enumDescriptions": [ + "Unspecified.", + "Insight should be aggregated at hourly level.", + "Insight should be aggregated at daily level.", + "Insight should be aggregated at weekly level.", + "Insight should be aggregated at monthly level.", + "Insight should be aggregated at the custom date range passed in as the start and end time in the request." + ], + "location": "query", + "type": "string" + }, + "endTime": { + "description": "Optional. Ending time for the duration for which insights are to be pulled. The default is the current time.", + "format": "google-datetime", + "location": "query", + "type": "string" + }, "filter": { "description": "Optional. Filter expression to restrict the insights returned. Supported filter fields: * `type` * `category` * `subCategory` Examples: * \"category = application AND type = count\" * \"category = application AND subCategory = iap\" * \"type = status\" Allowed values: * type: [count, latency, status, list] * category: [application, device, request, security] * subCategory: [iap, caa, webprotect] NOTE: Only equality based comparison is allowed. Only `AND` conjunction is allowed. NOTE: The 'AND' in the filter field needs to be in capital letters only. NOTE: Just filtering on `subCategory` is not allowed. It should be passed in with the parent `category` too. (These expressions are based on the filter language described at https://google.aip.dev/160).", "location": "query", @@ -1055,6 +1082,12 @@ "required": true, "type": "string" }, + "startTime": { + "description": "Optional. Starting time for the duration for which insights are to be pulled. The default is 7 days before the current time.", + "format": "google-datetime", + "location": "query", + "type": "string" + }, "view": { "description": "Required. List only metadata or full data.", "enum": [ @@ -3533,6 +3566,33 @@ "parent" ], "parameters": { + "aggregation": { + "description": "Optional. Aggregation type. The default is 'DAILY'.", + "enum": [ + "AGGREGATION_UNSPECIFIED", + "HOURLY", + "DAILY", + "WEEKLY", + "MONTHLY", + "CUSTOM_DATE_RANGE" + ], + "enumDescriptions": [ + "Unspecified.", + "Insight should be aggregated at hourly level.", + "Insight should be aggregated at daily level.", + "Insight should be aggregated at weekly level.", + "Insight should be aggregated at monthly level.", + "Insight should be aggregated at the custom date range passed in as the start and end time in the request." + ], + "location": "query", + "type": "string" + }, + "endTime": { + "description": "Optional. Ending time for the duration for which insights are to be pulled. The default is the current time.", + "format": "google-datetime", + "location": "query", + "type": "string" + }, "filter": { "description": "Optional. Filter expression to restrict the insights returned. Supported filter fields: * `type` * `category` * `subCategory` Examples: * \"category = application AND type = count\" * \"category = application AND subCategory = iap\" * \"type = status\" Allowed values: * type: [count, latency, status, list] * category: [application, device, request, security] * subCategory: [iap, caa, webprotect] NOTE: Only equality based comparison is allowed. Only `AND` conjunction is allowed. NOTE: The 'AND' in the filter field needs to be in capital letters only. NOTE: Just filtering on `subCategory` is not allowed. It should be passed in with the parent `category` too. (These expressions are based on the filter language described at https://google.aip.dev/160).", "location": "query", @@ -3561,6 +3621,12 @@ "required": true, "type": "string" }, + "startTime": { + "description": "Optional. Starting time for the duration for which insights are to be pulled. The default is 7 days before the current time.", + "format": "google-datetime", + "location": "query", + "type": "string" + }, "view": { "description": "Required. List only metadata or full data.", "enum": [ @@ -4080,7 +4146,7 @@ } } }, - "revision": "20240626", + "revision": "20240724", "rootUrl": "https://beyondcorp.googleapis.com/", "schemas": { "AllocatedConnection": { diff --git a/beyondcorp/v1alpha/beyondcorp-gen.go b/beyondcorp/v1alpha/beyondcorp-gen.go index 35aa0503eb1..9462aa5a842 100644 --- a/beyondcorp/v1alpha/beyondcorp-gen.go +++ b/beyondcorp/v1alpha/beyondcorp-gen.go @@ -7189,6 +7189,31 @@ func (r *OrganizationsLocationsInsightsService) List(parent string) *Organizatio return c } +// Aggregation sets the optional parameter "aggregation": Aggregation type. The +// default is 'DAILY'. +// +// Possible values: +// +// "AGGREGATION_UNSPECIFIED" - Unspecified. +// "HOURLY" - Insight should be aggregated at hourly level. +// "DAILY" - Insight should be aggregated at daily level. +// "WEEKLY" - Insight should be aggregated at weekly level. +// "MONTHLY" - Insight should be aggregated at monthly level. +// "CUSTOM_DATE_RANGE" - Insight should be aggregated at the custom date +// +// range passed in as the start and end time in the request. +func (c *OrganizationsLocationsInsightsListCall) Aggregation(aggregation string) *OrganizationsLocationsInsightsListCall { + c.urlParams_.Set("aggregation", aggregation) + return c +} + +// EndTime sets the optional parameter "endTime": Ending time for the duration +// for which insights are to be pulled. The default is the current time. +func (c *OrganizationsLocationsInsightsListCall) EndTime(endTime string) *OrganizationsLocationsInsightsListCall { + c.urlParams_.Set("endTime", endTime) + return c +} + // Filter sets the optional parameter "filter": Filter expression to restrict // the insights returned. Supported filter fields: * `type` * `category` * // `subCategory` Examples: * "category = application AND type = count" * @@ -7227,6 +7252,14 @@ func (c *OrganizationsLocationsInsightsListCall) PageToken(pageToken string) *Or return c } +// StartTime sets the optional parameter "startTime": Starting time for the +// duration for which insights are to be pulled. The default is 7 days before +// the current time. +func (c *OrganizationsLocationsInsightsListCall) StartTime(startTime string) *OrganizationsLocationsInsightsListCall { + c.urlParams_.Set("startTime", startTime) + return c +} + // View sets the optional parameter "view": Required. List only metadata or // full data. // @@ -16251,6 +16284,31 @@ func (r *ProjectsLocationsInsightsService) List(parent string) *ProjectsLocation return c } +// Aggregation sets the optional parameter "aggregation": Aggregation type. The +// default is 'DAILY'. +// +// Possible values: +// +// "AGGREGATION_UNSPECIFIED" - Unspecified. +// "HOURLY" - Insight should be aggregated at hourly level. +// "DAILY" - Insight should be aggregated at daily level. +// "WEEKLY" - Insight should be aggregated at weekly level. +// "MONTHLY" - Insight should be aggregated at monthly level. +// "CUSTOM_DATE_RANGE" - Insight should be aggregated at the custom date +// +// range passed in as the start and end time in the request. +func (c *ProjectsLocationsInsightsListCall) Aggregation(aggregation string) *ProjectsLocationsInsightsListCall { + c.urlParams_.Set("aggregation", aggregation) + return c +} + +// EndTime sets the optional parameter "endTime": Ending time for the duration +// for which insights are to be pulled. The default is the current time. +func (c *ProjectsLocationsInsightsListCall) EndTime(endTime string) *ProjectsLocationsInsightsListCall { + c.urlParams_.Set("endTime", endTime) + return c +} + // Filter sets the optional parameter "filter": Filter expression to restrict // the insights returned. Supported filter fields: * `type` * `category` * // `subCategory` Examples: * "category = application AND type = count" * @@ -16289,6 +16347,14 @@ func (c *ProjectsLocationsInsightsListCall) PageToken(pageToken string) *Project return c } +// StartTime sets the optional parameter "startTime": Starting time for the +// duration for which insights are to be pulled. The default is 7 days before +// the current time. +func (c *ProjectsLocationsInsightsListCall) StartTime(startTime string) *ProjectsLocationsInsightsListCall { + c.urlParams_.Set("startTime", startTime) + return c +} + // View sets the optional parameter "view": Required. List only metadata or // full data. // diff --git a/bigquery/v2/bigquery-api.json b/bigquery/v2/bigquery-api.json index efb1cdd4051..b6a49ff9ee8 100644 --- a/bigquery/v2/bigquery-api.json +++ b/bigquery/v2/bigquery-api.json @@ -1935,7 +1935,7 @@ } } }, - "revision": "20240714", + "revision": "20240727", "rootUrl": "https://bigquery.googleapis.com/", "schemas": { "AggregateClassificationMetrics": { @@ -4574,6 +4574,35 @@ }, "type": "object" }, + "IdentityColumnInfo": { + "description": "Metadata for value generation for an identity column.", + "id": "IdentityColumnInfo", + "properties": { + "generatedMode": { + "description": "Optional. Dictates when system generated values are used to populate the field.", + "enum": [ + "GENERATED_MODE_UNSPECIFIED", + "GENERATED_ALWAYS", + "GENERATED_BY_DEFAULT" + ], + "enumDescriptions": [ + "Unspecified GeneratedMode will default to GENERATED_ALWAYS.", + "Field can only have system generated values. Users cannot manually insert values into the field.", + "Use system generated values only if the user does not explicitly provide a value." + ], + "type": "string" + }, + "increment": { + "description": "Optional. The minimum difference between two successive generated values. Should be INTEGER compatible. Can be negative or positive but not 0. The default value is 1 if the field is not specified.", + "type": "string" + }, + "start": { + "description": "Optional. The first generated value. Should be INTEGER compatible. The default value is 1 if the field is not specified.", + "type": "string" + } + }, + "type": "object" + }, "IndexUnusedReason": { "description": "Reason about why no search index was used in the search query (or sub-query).", "id": "IndexUnusedReason", @@ -8829,6 +8858,10 @@ "description": "Optional. Definition of the foreign data type. Only valid for top-level schema fields (not nested fields). If the type is FOREIGN, this field is required.", "type": "string" }, + "identityColumnInfo": { + "$ref": "IdentityColumnInfo", + "description": "Optional. Definition of how values are generated for the field. Setting this option means that the field is an identity column. Only valid for top-level schema INTEGER fields (not nested fields)." + }, "maxLength": { "description": "Optional. Maximum length of values of this field for STRINGS or BYTES. If max_length is not specified, no maximum length constraint is imposed on this field. If type = \"STRING\", then max_length represents the maximum UTF-8 length of strings in this field. If type = \"BYTES\", then max_length represents the maximum number of bytes in this field. It is invalid to set this field if type ≠ \"STRING\" and ≠ \"BYTES\".", "format": "int64", diff --git a/bigquery/v2/bigquery-gen.go b/bigquery/v2/bigquery-gen.go index 7b1247e21f7..81b1146aadc 100644 --- a/bigquery/v2/bigquery-gen.go +++ b/bigquery/v2/bigquery-gen.go @@ -3873,6 +3873,44 @@ func (s *HparamTuningTrial) UnmarshalJSON(data []byte) error { return nil } +// IdentityColumnInfo: Metadata for value generation for an identity column. +type IdentityColumnInfo struct { + // GeneratedMode: Optional. Dictates when system generated values are used to + // populate the field. + // + // Possible values: + // "GENERATED_MODE_UNSPECIFIED" - Unspecified GeneratedMode will default to + // GENERATED_ALWAYS. + // "GENERATED_ALWAYS" - Field can only have system generated values. Users + // cannot manually insert values into the field. + // "GENERATED_BY_DEFAULT" - Use system generated values only if the user does + // not explicitly provide a value. + GeneratedMode string `json:"generatedMode,omitempty"` + // Increment: Optional. The minimum difference between two successive generated + // values. Should be INTEGER compatible. Can be negative or positive but not 0. + // The default value is 1 if the field is not specified. + Increment string `json:"increment,omitempty"` + // Start: Optional. The first generated value. Should be INTEGER compatible. + // The default value is 1 if the field is not specified. + Start string `json:"start,omitempty"` + // ForceSendFields is a list of field names (e.g. "GeneratedMode") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "GeneratedMode") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s IdentityColumnInfo) MarshalJSON() ([]byte, error) { + type NoMethod IdentityColumnInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // IndexUnusedReason: Reason about why no search index was used in the search // query (or sub-query). type IndexUnusedReason struct { @@ -8969,6 +9007,10 @@ type TableFieldSchema struct { // valid for top-level schema fields (not nested fields). If the type is // FOREIGN, this field is required. ForeignTypeDefinition string `json:"foreignTypeDefinition,omitempty"` + // IdentityColumnInfo: Optional. Definition of how values are generated for the + // field. Setting this option means that the field is an identity column. Only + // valid for top-level schema INTEGER fields (not nested fields). + IdentityColumnInfo *IdentityColumnInfo `json:"identityColumnInfo,omitempty"` // MaxLength: Optional. Maximum length of values of this field for STRINGS or // BYTES. If max_length is not specified, no maximum length constraint is // imposed on this field. If type = "STRING", then max_length represents the diff --git a/bigqueryconnection/v1/bigqueryconnection-api.json b/bigqueryconnection/v1/bigqueryconnection-api.json index d8342c20295..815ca45d9df 100644 --- a/bigqueryconnection/v1/bigqueryconnection-api.json +++ b/bigqueryconnection/v1/bigqueryconnection-api.json @@ -366,7 +366,7 @@ } } }, - "revision": "20240526", + "revision": "20240727", "rootUrl": "https://bigqueryconnection.googleapis.com/", "schemas": { "AuditConfig": { @@ -650,7 +650,7 @@ "type": "boolean" }, "kmsKeyName": { - "description": "Optional. The Cloud KMS key that is used for encryption. Example: `projects/[kms_project_id]/locations/[region]/keyRings/[key_region]/cryptoKeys/[key]`", + "description": "Optional. The Cloud KMS key that is used for credentials encryption. If omitted, internal Google owned encryption keys are used. Example: `projects/[kms_project_id]/locations/[region]/keyRings/[key_region]/cryptoKeys/[key]`", "type": "string" }, "lastModifiedTime": { diff --git a/bigqueryconnection/v1/bigqueryconnection-gen.go b/bigqueryconnection/v1/bigqueryconnection-gen.go index 6f84c45b324..e9246c939c0 100644 --- a/bigqueryconnection/v1/bigqueryconnection-gen.go +++ b/bigqueryconnection/v1/bigqueryconnection-gen.go @@ -625,7 +625,8 @@ type Connection struct { // HasCredential: Output only. True, if credential is configured for this // connection. HasCredential bool `json:"hasCredential,omitempty"` - // KmsKeyName: Optional. The Cloud KMS key that is used for encryption. + // KmsKeyName: Optional. The Cloud KMS key that is used for credentials + // encryption. If omitted, internal Google owned encryption keys are used. // Example: // `projects/[kms_project_id]/locations/[region]/keyRings/[key_region]/cryptoKey // s/[key]` diff --git a/certificatemanager/v1/certificatemanager-api.json b/certificatemanager/v1/certificatemanager-api.json index 6fd46c0b4bf..ead5a53b0dc 100644 --- a/certificatemanager/v1/certificatemanager-api.json +++ b/certificatemanager/v1/certificatemanager-api.json @@ -272,23 +272,23 @@ ], "parameters": { "filter": { - "description": "Filter expression to restrict the Certificates Configs returned.", + "description": "Optional. Filter expression to restrict the Certificates Configs returned.", "location": "query", "type": "string" }, "orderBy": { - "description": "A list of Certificate Config field names used to specify the order of the returned results. The default sorting order is ascending. To specify descending order for a field, add a suffix `\" desc\"`.", + "description": "Optional. A list of Certificate Config field names used to specify the order of the returned results. The default sorting order is ascending. To specify descending order for a field, add a suffix `\" desc\"`.", "location": "query", "type": "string" }, "pageSize": { - "description": "Maximum number of certificate configs to return per call.", + "description": "Optional. Maximum number of certificate configs to return per call.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { - "description": "The value returned by the last `ListCertificateIssuanceConfigsResponse`. Indicates that this is a continuation of a prior `ListCertificateIssuanceConfigs` call, and that the system should return the next page of data.", + "description": "Optional. The value returned by the last `ListCertificateIssuanceConfigsResponse`. Indicates that this is a continuation of a prior `ListCertificateIssuanceConfigs` call, and that the system should return the next page of data.", "location": "query", "type": "string" }, @@ -307,6 +307,40 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "patch": { + "description": "Updates a CertificateIssuanceConfig.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/certificateIssuanceConfigs/{certificateIssuanceConfigsId}", + "httpMethod": "PATCH", + "id": "certificatemanager.projects.locations.certificateIssuanceConfigs.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Identifier. A user-defined name of the certificate issuance config. CertificateIssuanceConfig names must be unique globally and match pattern `projects/*/locations/*/certificateIssuanceConfigs/*`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/certificateIssuanceConfigs/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Required. The update mask applies to the resource. For the `FieldMask` definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "CertificateIssuanceConfig" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } }, @@ -405,23 +439,23 @@ ], "parameters": { "filter": { - "description": "Filter expression to restrict the Certificates Maps returned.", + "description": "Optional. Filter expression to restrict the Certificates Maps returned.", "location": "query", "type": "string" }, "orderBy": { - "description": "A list of Certificate Map field names used to specify the order of the returned results. The default sorting order is ascending. To specify descending order for a field, add a suffix `\" desc\"`.", + "description": "Optional. A list of Certificate Map field names used to specify the order of the returned results. The default sorting order is ascending. To specify descending order for a field, add a suffix `\" desc\"`.", "location": "query", "type": "string" }, "pageSize": { - "description": "Maximum number of certificate maps to return per call.", + "description": "Optional. Maximum number of certificate maps to return per call.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { - "description": "The value returned by the last `ListCertificateMapsResponse`. Indicates that this is a continuation of a prior `ListCertificateMaps` call, and that the system should return the next page of data.", + "description": "Optional. The value returned by the last `ListCertificateMapsResponse`. Indicates that this is a continuation of a prior `ListCertificateMaps` call, and that the system should return the next page of data.", "location": "query", "type": "string" }, @@ -451,7 +485,7 @@ ], "parameters": { "name": { - "description": "A user-defined name of the Certificate Map. Certificate Map names must be unique globally and match pattern `projects/*/locations/*/certificateMaps/*`.", + "description": "Identifier. A user-defined name of the Certificate Map. Certificate Map names must be unique globally and match pattern `projects/*/locations/*/certificateMaps/*`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/certificateMaps/[^/]+$", "required": true, @@ -572,23 +606,23 @@ ], "parameters": { "filter": { - "description": "Filter expression to restrict the returned Certificate Map Entries.", + "description": "Optional. Filter expression to restrict the returned Certificate Map Entries.", "location": "query", "type": "string" }, "orderBy": { - "description": "A list of Certificate Map Entry field names used to specify the order of the returned results. The default sorting order is ascending. To specify descending order for a field, add a suffix `\" desc\"`.", + "description": "Optional. A list of Certificate Map Entry field names used to specify the order of the returned results. The default sorting order is ascending. To specify descending order for a field, add a suffix `\" desc\"`.", "location": "query", "type": "string" }, "pageSize": { - "description": "Maximum number of certificate map entries to return. The service may return fewer than this value. If unspecified, at most 50 certificate map entries will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", + "description": "Optional. Maximum number of certificate map entries to return. The service may return fewer than this value. If unspecified, at most 50 certificate map entries will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { - "description": "The value returned by the last `ListCertificateMapEntriesResponse`. Indicates that this is a continuation of a prior `ListCertificateMapEntries` call, and that the system should return the next page of data.", + "description": "Optional. The value returned by the last `ListCertificateMapEntriesResponse`. Indicates that this is a continuation of a prior `ListCertificateMapEntries` call, and that the system should return the next page of data.", "location": "query", "type": "string" }, @@ -618,7 +652,7 @@ ], "parameters": { "name": { - "description": "A user-defined name of the Certificate Map Entry. Certificate Map Entry names must be unique globally and match pattern `projects/*/locations/*/certificateMaps/*/certificateMapEntries/*`.", + "description": "Identifier. A user-defined name of the Certificate Map Entry. Certificate Map Entry names must be unique globally and match pattern `projects/*/locations/*/certificateMaps/*/certificateMapEntries/*`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/certificateMaps/[^/]+/certificateMapEntries/[^/]+$", "required": true, @@ -741,23 +775,23 @@ ], "parameters": { "filter": { - "description": "Filter expression to restrict the Certificates returned.", + "description": "Optional. Filter expression to restrict the Certificates returned.", "location": "query", "type": "string" }, "orderBy": { - "description": "A list of Certificate field names used to specify the order of the returned results. The default sorting order is ascending. To specify descending order for a field, add a suffix `\" desc\"`.", + "description": "Optional. A list of Certificate field names used to specify the order of the returned results. The default sorting order is ascending. To specify descending order for a field, add a suffix `\" desc\"`.", "location": "query", "type": "string" }, "pageSize": { - "description": "Maximum number of certificates to return per call.", + "description": "Optional. Maximum number of certificates to return per call.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { - "description": "The value returned by the last `ListCertificatesResponse`. Indicates that this is a continuation of a prior `ListCertificates` call, and that the system should return the next page of data.", + "description": "Optional. The value returned by the last `ListCertificatesResponse`. Indicates that this is a continuation of a prior `ListCertificates` call, and that the system should return the next page of data.", "location": "query", "type": "string" }, @@ -787,7 +821,7 @@ ], "parameters": { "name": { - "description": "A user-defined name of the certificate. Certificate names must be unique globally and match pattern `projects/*/locations/*/certificates/*`.", + "description": "Identifier. A user-defined name of the certificate. Certificate names must be unique globally and match pattern `projects/*/locations/*/certificates/*`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/certificates/[^/]+$", "required": true, @@ -908,23 +942,23 @@ ], "parameters": { "filter": { - "description": "Filter expression to restrict the Dns Authorizations returned.", + "description": "Optional. Filter expression to restrict the Dns Authorizations returned.", "location": "query", "type": "string" }, "orderBy": { - "description": "A list of Dns Authorization field names used to specify the order of the returned results. The default sorting order is ascending. To specify descending order for a field, add a suffix `\" desc\"`.", + "description": "Optional. A list of Dns Authorization field names used to specify the order of the returned results. The default sorting order is ascending. To specify descending order for a field, add a suffix `\" desc\"`.", "location": "query", "type": "string" }, "pageSize": { - "description": "Maximum number of dns authorizations to return per call.", + "description": "Optional. Maximum number of dns authorizations to return per call.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { - "description": "The value returned by the last `ListDnsAuthorizationsResponse`. Indicates that this is a continuation of a prior `ListDnsAuthorizations` call, and that the system should return the next page of data.", + "description": "Optional. The value returned by the last `ListDnsAuthorizationsResponse`. Indicates that this is a continuation of a prior `ListDnsAuthorizations` call, and that the system should return the next page of data.", "location": "query", "type": "string" }, @@ -954,7 +988,7 @@ ], "parameters": { "name": { - "description": "A user-defined name of the dns authorization. DnsAuthorization names must be unique globally and match pattern `projects/*/locations/*/dnsAuthorizations/*`.", + "description": "Identifier. A user-defined name of the dns authorization. DnsAuthorization names must be unique globally and match pattern `projects/*/locations/*/dnsAuthorizations/*`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/dnsAuthorizations/[^/]+$", "required": true, @@ -1148,7 +1182,7 @@ ], "parameters": { "etag": { - "description": "The current etag of the TrustConfig. If an etag is provided and does not match the current etag of the resource, deletion will be blocked and an ABORTED error will be returned.", + "description": "Optional. The current etag of the TrustConfig. If an etag is provided and does not match the current etag of the resource, deletion will be blocked and an ABORTED error will be returned.", "location": "query", "type": "string" }, @@ -1203,23 +1237,23 @@ ], "parameters": { "filter": { - "description": "Filter expression to restrict the TrustConfigs returned.", + "description": "Optional. Filter expression to restrict the TrustConfigs returned.", "location": "query", "type": "string" }, "orderBy": { - "description": "A list of TrustConfig field names used to specify the order of the returned results. The default sorting order is ascending. To specify descending order for a field, add a suffix `\" desc\"`.", + "description": "Optional. A list of TrustConfig field names used to specify the order of the returned results. The default sorting order is ascending. To specify descending order for a field, add a suffix `\" desc\"`.", "location": "query", "type": "string" }, "pageSize": { - "description": "Maximum number of TrustConfigs to return per call.", + "description": "Optional. Maximum number of TrustConfigs to return per call.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { - "description": "The value returned by the last `ListTrustConfigsResponse`. Indicates that this is a continuation of a prior `ListTrustConfigs` call, and that the system should return the next page of data.", + "description": "Optional. The value returned by the last `ListTrustConfigsResponse`. Indicates that this is a continuation of a prior `ListTrustConfigs` call, and that the system should return the next page of data.", "location": "query", "type": "string" }, @@ -1249,7 +1283,7 @@ ], "parameters": { "name": { - "description": "A user-defined name of the trust config. TrustConfig names must be unique globally and match pattern `projects/*/locations/*/trustConfigs/*`.", + "description": "Identifier. A user-defined name of the trust config. TrustConfig names must be unique globally and match pattern `projects/*/locations/*/trustConfigs/*`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/trustConfigs/[^/]+$", "required": true, @@ -1280,7 +1314,7 @@ } } }, - "revision": "20240710", + "revision": "20240729", "rootUrl": "https://certificatemanager.googleapis.com/", "schemas": { "AllowlistedCertificate": { @@ -1304,7 +1338,8 @@ "type": "string" }, "domain": { - "description": "Domain name of the authorization attempt.", + "description": "Output only. Domain name of the authorization attempt.", + "readOnly": true, "type": "string" }, "failureReason": { @@ -1361,7 +1396,7 @@ "type": "string" }, "description": { - "description": "One or more paragraphs of text description of a certificate.", + "description": "Optional. One or more paragraphs of text description of a certificate.", "type": "string" }, "expireTime": { @@ -1374,7 +1409,7 @@ "additionalProperties": { "type": "string" }, - "description": "Set of labels associated with a Certificate.", + "description": "Optional. Set of labels associated with a Certificate.", "type": "object" }, "managed": { @@ -1382,7 +1417,7 @@ "description": "If set, contains configuration and state of a managed certificate." }, "name": { - "description": "A user-defined name of the certificate. Certificate names must be unique globally and match pattern `projects/*/locations/*/certificates/*`.", + "description": "Identifier. A user-defined name of the certificate. Certificate names must be unique globally and match pattern `projects/*/locations/*/certificates/*`.", "type": "string" }, "pemCertificate": { @@ -1399,7 +1434,7 @@ "type": "array" }, "scope": { - "description": "Immutable. The scope of the certificate.", + "description": "Optional. Immutable. The scope of the certificate.", "enum": [ "DEFAULT", "EDGE_CACHE", @@ -1462,7 +1497,7 @@ "type": "string" }, "description": { - "description": "One or more paragraphs of text description of a CertificateIssuanceConfig.", + "description": "Optional. One or more paragraphs of text description of a CertificateIssuanceConfig.", "type": "string" }, "keyAlgorithm": { @@ -1483,7 +1518,7 @@ "additionalProperties": { "type": "string" }, - "description": "Set of labels associated with a CertificateIssuanceConfig.", + "description": "Optional. Set of labels associated with a CertificateIssuanceConfig.", "type": "object" }, "lifetime": { @@ -1492,7 +1527,7 @@ "type": "string" }, "name": { - "description": "A user-defined name of the certificate issuance config. CertificateIssuanceConfig names must be unique globally and match pattern `projects/*/locations/*/certificateIssuanceConfigs/*`.", + "description": "Identifier. A user-defined name of the certificate issuance config. CertificateIssuanceConfig names must be unique globally and match pattern `projects/*/locations/*/certificateIssuanceConfigs/*`.", "type": "string" }, "rotationWindowPercentage": { @@ -1520,7 +1555,7 @@ "type": "string" }, "description": { - "description": "One or more paragraphs of text description of a certificate map.", + "description": "Optional. One or more paragraphs of text description of a certificate map.", "type": "string" }, "gclbTargets": { @@ -1535,11 +1570,11 @@ "additionalProperties": { "type": "string" }, - "description": "Set of labels associated with a Certificate Map.", + "description": "Optional. Set of labels associated with a Certificate Map.", "type": "object" }, "name": { - "description": "A user-defined name of the Certificate Map. Certificate Map names must be unique globally and match pattern `projects/*/locations/*/certificateMaps/*`.", + "description": "Identifier. A user-defined name of the Certificate Map. Certificate Map names must be unique globally and match pattern `projects/*/locations/*/certificateMaps/*`.", "type": "string" }, "updateTime": { @@ -1556,7 +1591,7 @@ "id": "CertificateMapEntry", "properties": { "certificates": { - "description": "A set of Certificates defines for the given `hostname`. There can be defined up to four certificates in each Certificate Map Entry. Each certificate must match pattern `projects/*/locations/*/certificates/*`.", + "description": "Optional. A set of Certificates defines for the given `hostname`. There can be defined up to four certificates in each Certificate Map Entry. Each certificate must match pattern `projects/*/locations/*/certificates/*`.", "items": { "type": "string" }, @@ -1569,7 +1604,7 @@ "type": "string" }, "description": { - "description": "One or more paragraphs of text description of a certificate map entry.", + "description": "Optional. One or more paragraphs of text description of a certificate map entry.", "type": "string" }, "hostname": { @@ -1580,7 +1615,7 @@ "additionalProperties": { "type": "string" }, - "description": "Set of labels associated with a Certificate Map Entry.", + "description": "Optional. Set of labels associated with a Certificate Map Entry.", "type": "object" }, "matcher": { @@ -1596,7 +1631,7 @@ "type": "string" }, "name": { - "description": "A user-defined name of the Certificate Map Entry. Certificate Map Entry names must be unique globally and match pattern `projects/*/locations/*/certificateMaps/*/certificateMapEntries/*`.", + "description": "Identifier. A user-defined name of the Certificate Map Entry. Certificate Map Entry names must be unique globally and match pattern `projects/*/locations/*/certificateMaps/*/certificateMapEntries/*`.", "type": "string" }, "state": { @@ -1634,7 +1669,7 @@ "type": "string" }, "description": { - "description": "One or more paragraphs of text description of a DnsAuthorization.", + "description": "Optional. One or more paragraphs of text description of a DnsAuthorization.", "type": "string" }, "dnsResourceRecord": { @@ -1650,15 +1685,15 @@ "additionalProperties": { "type": "string" }, - "description": "Set of labels associated with a DnsAuthorization.", + "description": "Optional. Set of labels associated with a DnsAuthorization.", "type": "object" }, "name": { - "description": "A user-defined name of the dns authorization. DnsAuthorization names must be unique globally and match pattern `projects/*/locations/*/dnsAuthorizations/*`.", + "description": "Identifier. A user-defined name of the dns authorization. DnsAuthorization names must be unique globally and match pattern `projects/*/locations/*/dnsAuthorizations/*`.", "type": "string" }, "type": { - "description": "Immutable. Type of DnsAuthorization. If unset during resource creation the following default will be used: - in location `global`: FIXED_RECORD, - in other locations: PER_PROJECT_RECORD.", + "description": "Optional. Immutable. Type of DnsAuthorization. If unset during resource creation the following default will be used: - in location `global`: FIXED_RECORD, - in other locations: PER_PROJECT_RECORD.", "enum": [ "TYPE_UNSPECIFIED", "FIXED_RECORD", @@ -1998,21 +2033,21 @@ "type": "array" }, "dnsAuthorizations": { - "description": "Immutable. Authorizations that will be used for performing domain authorization.", + "description": "Optional. Immutable. Authorizations that will be used for performing domain authorization.", "items": { "type": "string" }, "type": "array" }, "domains": { - "description": "Immutable. The domains for which a managed SSL certificate will be generated. Wildcard domains are only supported with DNS challenge resolution.", + "description": "Optional. Immutable. The domains for which a managed SSL certificate will be generated. Wildcard domains are only supported with DNS challenge resolution.", "items": { "type": "string" }, "type": "array" }, "issuanceConfig": { - "description": "Immutable. The resource name for a CertificateIssuanceConfig used to configure private PKI certificates in the format `projects/*/locations/*/certificateIssuanceConfigs/*`. If this field is not set, the certificates will instead be publicly signed as documented at https://cloud.google.com/load-balancing/docs/ssl-certificates/google-managed-certs#caa.", + "description": "Optional. Immutable. The resource name for a CertificateIssuanceConfig used to configure private PKI certificates in the format `projects/*/locations/*/certificateIssuanceConfigs/*`. If this field is not set, the certificates will instead be publicly signed as documented at https://cloud.google.com/load-balancing/docs/ssl-certificates/google-managed-certs#caa.", "type": "string" }, "provisioningIssue": { @@ -2144,11 +2179,11 @@ "id": "SelfManagedCertificate", "properties": { "pemCertificate": { - "description": "Input only. The PEM-encoded certificate chain. Leaf certificate comes first, followed by intermediate ones if any.", + "description": "Optional. Input only. The PEM-encoded certificate chain. Leaf certificate comes first, followed by intermediate ones if any.", "type": "string" }, "pemPrivateKey": { - "description": "Input only. The PEM-encoded private key of the leaf certificate.", + "description": "Optional. Input only. The PEM-encoded private key of the leaf certificate.", "type": "string" } }, @@ -2210,7 +2245,7 @@ "type": "string" }, "description": { - "description": "One or more paragraphs of text description of a TrustConfig.", + "description": "Optional. One or more paragraphs of text description of a TrustConfig.", "type": "string" }, "etag": { @@ -2221,15 +2256,15 @@ "additionalProperties": { "type": "string" }, - "description": "Set of labels associated with a TrustConfig.", + "description": "Optional. Set of labels associated with a TrustConfig.", "type": "object" }, "name": { - "description": "A user-defined name of the trust config. TrustConfig names must be unique globally and match pattern `projects/*/locations/*/trustConfigs/*`.", + "description": "Identifier. A user-defined name of the trust config. TrustConfig names must be unique globally and match pattern `projects/*/locations/*/trustConfigs/*`.", "type": "string" }, "trustStores": { - "description": "Set of trust stores to perform validation against. This field is supported when TrustConfig is configured with Load Balancers, currently not supported for SPIFFE certificate validation. Only one TrustStore specified is currently allowed.", + "description": "Optional. Set of trust stores to perform validation against. This field is supported when TrustConfig is configured with Load Balancers, currently not supported for SPIFFE certificate validation. Only one TrustStore specified is currently allowed.", "items": { "$ref": "TrustStore" }, @@ -2249,14 +2284,14 @@ "id": "TrustStore", "properties": { "intermediateCas": { - "description": "Set of intermediate CA certificates used for the path building phase of chain validation. The field is currently not supported if TrustConfig is used for the workload certificate feature.", + "description": "Optional. Set of intermediate CA certificates used for the path building phase of chain validation. The field is currently not supported if TrustConfig is used for the workload certificate feature.", "items": { "$ref": "IntermediateCA" }, "type": "array" }, "trustAnchors": { - "description": "List of Trust Anchors to be used while performing validation against a given TrustStore.", + "description": "Optional. List of Trust Anchors to be used while performing validation against a given TrustStore.", "items": { "$ref": "TrustAnchor" }, diff --git a/certificatemanager/v1/certificatemanager-gen.go b/certificatemanager/v1/certificatemanager-gen.go index 096eb978acc..991f20e2622 100644 --- a/certificatemanager/v1/certificatemanager-gen.go +++ b/certificatemanager/v1/certificatemanager-gen.go @@ -290,7 +290,7 @@ type AuthorizationAttemptInfo struct { // Provided to help address the configuration issues. Not guaranteed to be // stable. For programmatic access use FailureReason enum. Details string `json:"details,omitempty"` - // Domain: Domain name of the authorization attempt. + // Domain: Output only. Domain name of the authorization attempt. Domain string `json:"domain,omitempty"` // FailureReason: Output only. Reason for failure of the authorization attempt // for the domain. @@ -342,16 +342,18 @@ type CancelOperationRequest struct { type Certificate struct { // CreateTime: Output only. The creation timestamp of a Certificate. CreateTime string `json:"createTime,omitempty"` - // Description: One or more paragraphs of text description of a certificate. + // Description: Optional. One or more paragraphs of text description of a + // certificate. Description string `json:"description,omitempty"` // ExpireTime: Output only. The expiry timestamp of a Certificate. ExpireTime string `json:"expireTime,omitempty"` - // Labels: Set of labels associated with a Certificate. + // Labels: Optional. Set of labels associated with a Certificate. Labels map[string]string `json:"labels,omitempty"` // Managed: If set, contains configuration and state of a managed certificate. Managed *ManagedCertificate `json:"managed,omitempty"` - // Name: A user-defined name of the certificate. Certificate names must be - // unique globally and match pattern `projects/*/locations/*/certificates/*`. + // Name: Identifier. A user-defined name of the certificate. Certificate names + // must be unique globally and match pattern + // `projects/*/locations/*/certificates/*`. Name string `json:"name,omitempty"` // PemCertificate: Output only. The PEM-encoded certificate chain. PemCertificate string `json:"pemCertificate,omitempty"` @@ -360,7 +362,7 @@ type Certificate struct { // that haven't been provisioned yet have this field populated with a value of // the managed.domains field. SanDnsnames []string `json:"sanDnsnames,omitempty"` - // Scope: Immutable. The scope of the certificate. + // Scope: Optional. Immutable. The scope of the certificate. // // Possible values: // "DEFAULT" - Certificates with default scope are served from core Google @@ -458,7 +460,7 @@ type CertificateIssuanceConfig struct { // CreateTime: Output only. The creation timestamp of a // CertificateIssuanceConfig. CreateTime string `json:"createTime,omitempty"` - // Description: One or more paragraphs of text description of a + // Description: Optional. One or more paragraphs of text description of a // CertificateIssuanceConfig. Description string `json:"description,omitempty"` // KeyAlgorithm: Required. The key algorithm to use when generating the private @@ -469,11 +471,11 @@ type CertificateIssuanceConfig struct { // "RSA_2048" - Specifies RSA with a 2048-bit modulus. // "ECDSA_P256" - Specifies ECDSA with curve P256. KeyAlgorithm string `json:"keyAlgorithm,omitempty"` - // Labels: Set of labels associated with a CertificateIssuanceConfig. + // Labels: Optional. Set of labels associated with a CertificateIssuanceConfig. Labels map[string]string `json:"labels,omitempty"` // Lifetime: Required. Workload certificate lifetime requested. Lifetime string `json:"lifetime,omitempty"` - // Name: A user-defined name of the certificate issuance config. + // Name: Identifier. A user-defined name of the certificate issuance config. // CertificateIssuanceConfig names must be unique globally and match pattern // `projects/*/locations/*/certificateIssuanceConfigs/*`. Name string `json:"name,omitempty"` @@ -509,17 +511,17 @@ func (s CertificateIssuanceConfig) MarshalJSON() ([]byte, error) { type CertificateMap struct { // CreateTime: Output only. The creation timestamp of a Certificate Map. CreateTime string `json:"createTime,omitempty"` - // Description: One or more paragraphs of text description of a certificate - // map. + // Description: Optional. One or more paragraphs of text description of a + // certificate map. Description string `json:"description,omitempty"` // GclbTargets: Output only. A list of GCLB targets that use this Certificate // Map. A Target Proxy is only present on this list if it's attached to a // Forwarding Rule. GclbTargets []*GclbTarget `json:"gclbTargets,omitempty"` - // Labels: Set of labels associated with a Certificate Map. + // Labels: Optional. Set of labels associated with a Certificate Map. Labels map[string]string `json:"labels,omitempty"` - // Name: A user-defined name of the Certificate Map. Certificate Map names must - // be unique globally and match pattern + // Name: Identifier. A user-defined name of the Certificate Map. Certificate + // Map names must be unique globally and match pattern // `projects/*/locations/*/certificateMaps/*`. Name string `json:"name,omitempty"` // UpdateTime: Output only. The update timestamp of a Certificate Map. @@ -547,20 +549,21 @@ func (s CertificateMap) MarshalJSON() ([]byte, error) { // CertificateMapEntry: Defines a certificate map entry. type CertificateMapEntry struct { - // Certificates: A set of Certificates defines for the given `hostname`. There - // can be defined up to four certificates in each Certificate Map Entry. Each - // certificate must match pattern `projects/*/locations/*/certificates/*`. + // Certificates: Optional. A set of Certificates defines for the given + // `hostname`. There can be defined up to four certificates in each Certificate + // Map Entry. Each certificate must match pattern + // `projects/*/locations/*/certificates/*`. Certificates []string `json:"certificates,omitempty"` // CreateTime: Output only. The creation timestamp of a Certificate Map Entry. CreateTime string `json:"createTime,omitempty"` - // Description: One or more paragraphs of text description of a certificate map - // entry. + // Description: Optional. One or more paragraphs of text description of a + // certificate map entry. Description string `json:"description,omitempty"` // Hostname: A Hostname (FQDN, e.g. `example.com`) or a wildcard hostname // expression (`*.example.com`) for a set of hostnames with common suffix. Used // as Server Name Indication (SNI) for selecting a proper certificate. Hostname string `json:"hostname,omitempty"` - // Labels: Set of labels associated with a Certificate Map Entry. + // Labels: Optional. Set of labels associated with a Certificate Map Entry. Labels map[string]string `json:"labels,omitempty"` // Matcher: A predefined matcher for particular cases, other than SNI // selection. @@ -570,8 +573,8 @@ type CertificateMapEntry struct { // "PRIMARY" - A primary certificate that is served when SNI wasn't specified // in the request or SNI couldn't be found in the map. Matcher string `json:"matcher,omitempty"` - // Name: A user-defined name of the Certificate Map Entry. Certificate Map - // Entry names must be unique globally and match pattern + // Name: Identifier. A user-defined name of the Certificate Map Entry. + // Certificate Map Entry names must be unique globally and match pattern // `projects/*/locations/*/certificateMaps/*/certificateMapEntries/*`. Name string `json:"name,omitempty"` // State: Output only. A serving state of this Certificate Map Entry. @@ -610,7 +613,7 @@ func (s CertificateMapEntry) MarshalJSON() ([]byte, error) { type DnsAuthorization struct { // CreateTime: Output only. The creation timestamp of a DnsAuthorization. CreateTime string `json:"createTime,omitempty"` - // Description: One or more paragraphs of text description of a + // Description: Optional. One or more paragraphs of text description of a // DnsAuthorization. Description string `json:"description,omitempty"` // DnsResourceRecord: Output only. DNS Resource Record that needs to be added @@ -621,15 +624,15 @@ type DnsAuthorization struct { // authorization for `example.com` can be used to issue certificates for // `example.com` and `*.example.com`. Domain string `json:"domain,omitempty"` - // Labels: Set of labels associated with a DnsAuthorization. + // Labels: Optional. Set of labels associated with a DnsAuthorization. Labels map[string]string `json:"labels,omitempty"` - // Name: A user-defined name of the dns authorization. DnsAuthorization names - // must be unique globally and match pattern + // Name: Identifier. A user-defined name of the dns authorization. + // DnsAuthorization names must be unique globally and match pattern // `projects/*/locations/*/dnsAuthorizations/*`. Name string `json:"name,omitempty"` - // Type: Immutable. Type of DnsAuthorization. If unset during resource creation - // the following default will be used: - in location `global`: FIXED_RECORD, - - // in other locations: PER_PROJECT_RECORD. + // Type: Optional. Immutable. Type of DnsAuthorization. If unset during + // resource creation the following default will be used: - in location + // `global`: FIXED_RECORD, - in other locations: PER_PROJECT_RECORD. // // Possible values: // "TYPE_UNSPECIFIED" - Type is unspecified. @@ -1078,17 +1081,18 @@ type ManagedCertificate struct { // authorization attempt for each domain specified for managed certificate // resource. AuthorizationAttemptInfo []*AuthorizationAttemptInfo `json:"authorizationAttemptInfo,omitempty"` - // DnsAuthorizations: Immutable. Authorizations that will be used for + // DnsAuthorizations: Optional. Immutable. Authorizations that will be used for // performing domain authorization. DnsAuthorizations []string `json:"dnsAuthorizations,omitempty"` - // Domains: Immutable. The domains for which a managed SSL certificate will be - // generated. Wildcard domains are only supported with DNS challenge - // resolution. + // Domains: Optional. Immutable. The domains for which a managed SSL + // certificate will be generated. Wildcard domains are only supported with DNS + // challenge resolution. Domains []string `json:"domains,omitempty"` - // IssuanceConfig: Immutable. The resource name for a CertificateIssuanceConfig - // used to configure private PKI certificates in the format - // `projects/*/locations/*/certificateIssuanceConfigs/*`. If this field is not - // set, the certificates will instead be publicly signed as documented at + // IssuanceConfig: Optional. Immutable. The resource name for a + // CertificateIssuanceConfig used to configure private PKI certificates in the + // format `projects/*/locations/*/certificateIssuanceConfigs/*`. If this field + // is not set, the certificates will instead be publicly signed as documented + // at // https://cloud.google.com/load-balancing/docs/ssl-certificates/google-managed-certs#caa. IssuanceConfig string `json:"issuanceConfig,omitempty"` // ProvisioningIssue: Output only. Information about issues with provisioning a @@ -1249,10 +1253,10 @@ func (s ProvisioningIssue) MarshalJSON() ([]byte, error) { // SelfManaged Certificates are uploaded by the user. Updating such // certificates before they expire remains the user's responsibility. type SelfManagedCertificate struct { - // PemCertificate: Input only. The PEM-encoded certificate chain. Leaf - // certificate comes first, followed by intermediate ones if any. + // PemCertificate: Optional. Input only. The PEM-encoded certificate chain. + // Leaf certificate comes first, followed by intermediate ones if any. PemCertificate string `json:"pemCertificate,omitempty"` - // PemPrivateKey: Input only. The PEM-encoded private key of the leaf + // PemPrivateKey: Optional. Input only. The PEM-encoded private key of the leaf // certificate. PemPrivateKey string `json:"pemPrivateKey,omitempty"` // ForceSendFields is a list of field names (e.g. "PemCertificate") to @@ -1339,21 +1343,23 @@ type TrustConfig struct { AllowlistedCertificates []*AllowlistedCertificate `json:"allowlistedCertificates,omitempty"` // CreateTime: Output only. The creation timestamp of a TrustConfig. CreateTime string `json:"createTime,omitempty"` - // Description: One or more paragraphs of text description of a TrustConfig. + // Description: Optional. One or more paragraphs of text description of a + // TrustConfig. Description string `json:"description,omitempty"` // Etag: This checksum is computed by the server based on the value of other // fields, and may be sent on update and delete requests to ensure the client // has an up-to-date value before proceeding. Etag string `json:"etag,omitempty"` - // Labels: Set of labels associated with a TrustConfig. + // Labels: Optional. Set of labels associated with a TrustConfig. Labels map[string]string `json:"labels,omitempty"` - // Name: A user-defined name of the trust config. TrustConfig names must be - // unique globally and match pattern `projects/*/locations/*/trustConfigs/*`. + // Name: Identifier. A user-defined name of the trust config. TrustConfig names + // must be unique globally and match pattern + // `projects/*/locations/*/trustConfigs/*`. Name string `json:"name,omitempty"` - // TrustStores: Set of trust stores to perform validation against. This field - // is supported when TrustConfig is configured with Load Balancers, currently - // not supported for SPIFFE certificate validation. Only one TrustStore - // specified is currently allowed. + // TrustStores: Optional. Set of trust stores to perform validation against. + // This field is supported when TrustConfig is configured with Load Balancers, + // currently not supported for SPIFFE certificate validation. Only one + // TrustStore specified is currently allowed. TrustStores []*TrustStore `json:"trustStores,omitempty"` // UpdateTime: Output only. The last update timestamp of a TrustConfig. UpdateTime string `json:"updateTime,omitempty"` @@ -1380,12 +1386,12 @@ func (s TrustConfig) MarshalJSON() ([]byte, error) { // TrustStore: Defines a trust store. type TrustStore struct { - // IntermediateCas: Set of intermediate CA certificates used for the path - // building phase of chain validation. The field is currently not supported if - // TrustConfig is used for the workload certificate feature. + // IntermediateCas: Optional. Set of intermediate CA certificates used for the + // path building phase of chain validation. The field is currently not + // supported if TrustConfig is used for the workload certificate feature. IntermediateCas []*IntermediateCA `json:"intermediateCas,omitempty"` - // TrustAnchors: List of Trust Anchors to be used while performing validation - // against a given TrustStore. + // TrustAnchors: Optional. List of Trust Anchors to be used while performing + // validation against a given TrustStore. TrustAnchors []*TrustAnchor `json:"trustAnchors,omitempty"` // ForceSendFields is a list of field names (e.g. "IntermediateCas") to // unconditionally include in API requests. By default, fields with empty or @@ -2143,6 +2149,117 @@ func (c *ProjectsLocationsCertificateIssuanceConfigsListCall) Pages(ctx context. } } +type ProjectsLocationsCertificateIssuanceConfigsPatchCall struct { + s *Service + name string + certificateissuanceconfig *CertificateIssuanceConfig + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates a CertificateIssuanceConfig. +// +// - name: Identifier. A user-defined name of the certificate issuance config. +// CertificateIssuanceConfig names must be unique globally and match pattern +// `projects/*/locations/*/certificateIssuanceConfigs/*`. +func (r *ProjectsLocationsCertificateIssuanceConfigsService) Patch(name string, certificateissuanceconfig *CertificateIssuanceConfig) *ProjectsLocationsCertificateIssuanceConfigsPatchCall { + c := &ProjectsLocationsCertificateIssuanceConfigsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.certificateissuanceconfig = certificateissuanceconfig + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. The update +// mask applies to the resource. For the `FieldMask` definition, see +// https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask. +func (c *ProjectsLocationsCertificateIssuanceConfigsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsCertificateIssuanceConfigsPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsCertificateIssuanceConfigsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCertificateIssuanceConfigsPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsCertificateIssuanceConfigsPatchCall) Context(ctx context.Context) *ProjectsLocationsCertificateIssuanceConfigsPatchCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsCertificateIssuanceConfigsPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCertificateIssuanceConfigsPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.certificateissuanceconfig) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "certificatemanager.projects.locations.certificateIssuanceConfigs.patch" call. +// Any non-2xx status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsCertificateIssuanceConfigsPatchCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil +} + type ProjectsLocationsCertificateMapsCreateCall struct { s *Service parent string @@ -2631,8 +2748,8 @@ type ProjectsLocationsCertificateMapsPatchCall struct { // Patch: Updates a CertificateMap. // -// - name: A user-defined name of the Certificate Map. Certificate Map names -// must be unique globally and match pattern +// - name: Identifier. A user-defined name of the Certificate Map. Certificate +// Map names must be unique globally and match pattern // `projects/*/locations/*/certificateMaps/*`. func (r *ProjectsLocationsCertificateMapsService) Patch(name string, certificatemap *CertificateMap) *ProjectsLocationsCertificateMapsPatchCall { c := &ProjectsLocationsCertificateMapsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -3221,8 +3338,8 @@ type ProjectsLocationsCertificateMapsCertificateMapEntriesPatchCall struct { // Patch: Updates a CertificateMapEntry. // -// - name: A user-defined name of the Certificate Map Entry. Certificate Map -// Entry names must be unique globally and match pattern +// - name: Identifier. A user-defined name of the Certificate Map Entry. +// Certificate Map Entry names must be unique globally and match pattern // `projects/*/locations/*/certificateMaps/*/certificateMapEntries/*`. func (r *ProjectsLocationsCertificateMapsCertificateMapEntriesService) Patch(name string, certificatemapentry *CertificateMapEntry) *ProjectsLocationsCertificateMapsCertificateMapEntriesPatchCall { c := &ProjectsLocationsCertificateMapsCertificateMapEntriesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -3807,8 +3924,9 @@ type ProjectsLocationsCertificatesPatchCall struct { // Patch: Updates a Certificate. // -// - name: A user-defined name of the certificate. Certificate names must be -// unique globally and match pattern `projects/*/locations/*/certificates/*`. +// - name: Identifier. A user-defined name of the certificate. Certificate +// names must be unique globally and match pattern +// `projects/*/locations/*/certificates/*`. func (r *ProjectsLocationsCertificatesService) Patch(name string, certificate *Certificate) *ProjectsLocationsCertificatesPatchCall { c := &ProjectsLocationsCertificatesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -4393,8 +4511,8 @@ type ProjectsLocationsDnsAuthorizationsPatchCall struct { // Patch: Updates a DnsAuthorization. // -// - name: A user-defined name of the dns authorization. DnsAuthorization names -// must be unique globally and match pattern +// - name: Identifier. A user-defined name of the dns authorization. +// DnsAuthorization names must be unique globally and match pattern // `projects/*/locations/*/dnsAuthorizations/*`. func (r *ProjectsLocationsDnsAuthorizationsService) Patch(name string, dnsauthorization *DnsAuthorization) *ProjectsLocationsDnsAuthorizationsPatchCall { c := &ProjectsLocationsDnsAuthorizationsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -5455,8 +5573,9 @@ type ProjectsLocationsTrustConfigsPatchCall struct { // Patch: Updates a TrustConfig. // -// - name: A user-defined name of the trust config. TrustConfig names must be -// unique globally and match pattern `projects/*/locations/*/trustConfigs/*`. +// - name: Identifier. A user-defined name of the trust config. TrustConfig +// names must be unique globally and match pattern +// `projects/*/locations/*/trustConfigs/*`. func (r *ProjectsLocationsTrustConfigsService) Patch(name string, trustconfig *TrustConfig) *ProjectsLocationsTrustConfigsPatchCall { c := &ProjectsLocationsTrustConfigsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name diff --git a/chat/v1/chat-api.json b/chat/v1/chat-api.json index c5db695ef3a..ae2aea204eb 100644 --- a/chat/v1/chat-api.json +++ b/chat/v1/chat-api.json @@ -1241,7 +1241,7 @@ } } }, - "revision": "20240728", + "revision": "20240801", "rootUrl": "https://chat.googleapis.com/", "schemas": { "AccessSettings": { @@ -2744,13 +2744,11 @@ "description": "A data source shared by all Google Workspace applications, such as users in a Google Workspace organization.", "enum": [ "UNKNOWN", - "USER", - "DRIVE" + "USER" ], "enumDescriptions": [ "Default value. Don't use.", - "Google Workspace users. The user can only view and select users from their Google Workspace organization.", - "Represents a data source from Google Drive OnePick." + "Google Workspace users. The user can only view and select users from their Google Workspace organization." ], "type": "string" }, diff --git a/chat/v1/chat-gen.go b/chat/v1/chat-gen.go index 59110d20516..ffa4301253d 100644 --- a/chat/v1/chat-gen.go +++ b/chat/v1/chat-gen.go @@ -2652,7 +2652,6 @@ type GoogleAppsCardV1PlatformDataSource struct { // "UNKNOWN" - Default value. Don't use. // "USER" - Google Workspace users. The user can only view and select users // from their Google Workspace organization. - // "DRIVE" - Represents a data source from Google Drive OnePick. CommonDataSource string `json:"commonDataSource,omitempty"` // HostAppDataSource: A data source that's unique to a Google Workspace host // application, such spaces in Google Chat. diff --git a/cloudasset/v1/cloudasset-api.json b/cloudasset/v1/cloudasset-api.json index 6efa34faa3a..48fefcfb342 100644 --- a/cloudasset/v1/cloudasset-api.json +++ b/cloudasset/v1/cloudasset-api.json @@ -1095,7 +1095,7 @@ } } }, - "revision": "20240717", + "revision": "20240803", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AccessSelector": { @@ -2799,7 +2799,7 @@ "id": "GoogleIdentityAccesscontextmanagerV1EgressFrom", "properties": { "identities": { - "description": "A list of identities that are allowed access through [EgressPolicy]. Identities can be an individual user, service account, Google group, or third-party identity. The `v1` identities that have the prefix `user`, `group`, `serviceAccount`, `principal`, and `principalSet` in https://cloud.google.com/iam/docs/principal-identifiers#v1 are supported.", + "description": "A list of identities that are allowed access through [EgressPolicy]. Identities can be an individual user, service account, Google group, or third-party identity. For third-party identity, only single identities are supported and other identity types are not supported. The `v1` identities that have the prefix `user`, `group`, `serviceAccount`, and `principal` in https://cloud.google.com/iam/docs/principal-identifiers#v1 are supported.", "items": { "type": "string" }, @@ -2904,7 +2904,7 @@ "id": "GoogleIdentityAccesscontextmanagerV1IngressFrom", "properties": { "identities": { - "description": "A list of identities that are allowed access through [IngressPolicy]. Identities can be an individual user, service account, Google group, or third-party identity. The `v1` identities that have the prefix `user`, `group`, `serviceAccount`, `principal`, and `principalSet` in https://cloud.google.com/iam/docs/principal-identifiers#v1 are supported.", + "description": "A list of identities that are allowed access through [IngressPolicy]. Identities can be an individual user, service account, Google group, or third-party identity. For third-party identity, only single identities are supported and other identity types are not supported. The `v1` identities that have the prefix `user`, `group`, `serviceAccount`, and `principal` in https://cloud.google.com/iam/docs/principal-identifiers#v1 are supported.", "items": { "type": "string" }, @@ -3874,7 +3874,7 @@ "id": "QueryAssetsResponse", "properties": { "done": { - "description": "The query response, which can be either an `error` or a valid `response`. If `done` == `false` and the query result is being saved in a output, the output_config field will be set. If `done` == `true`, exactly one of `error`, `query_result` or `output_config` will be set.", + "description": "The query response, which can be either an `error` or a valid `response`. If `done` == `false` and the query result is being saved in an output, the output_config field will be set. If `done` == `true`, exactly one of `error`, `query_result` or `output_config` will be set. [done] is unset unless the [QueryAssetsResponse] contains a [QueryAssetsResponse.job_reference].", "type": "boolean" }, "error": { @@ -3887,7 +3887,7 @@ }, "outputConfig": { "$ref": "QueryAssetsOutputConfig", - "description": "Output configuration which indicates instead of being returned in API response on the fly, the query result will be saved in a specific output." + "description": "Output configuration, which indicates that instead of being returned in an API response on the fly, the query result will be saved in a specific output." }, "queryResult": { "$ref": "QueryResult", diff --git a/cloudasset/v1/cloudasset-gen.go b/cloudasset/v1/cloudasset-gen.go index b274fa843ee..2ed3f555ba6 100644 --- a/cloudasset/v1/cloudasset-gen.go +++ b/cloudasset/v1/cloudasset-gen.go @@ -2941,9 +2941,11 @@ func (s GoogleIdentityAccesscontextmanagerV1DevicePolicy) MarshalJSON() ([]byte, type GoogleIdentityAccesscontextmanagerV1EgressFrom struct { // Identities: A list of identities that are allowed access through // [EgressPolicy]. Identities can be an individual user, service account, - // Google group, or third-party identity. The `v1` identities that have the - // prefix `user`, `group`, `serviceAccount`, `principal`, and `principalSet` in - // https://cloud.google.com/iam/docs/principal-identifiers#v1 are supported. + // Google group, or third-party identity. For third-party identity, only single + // identities are supported and other identity types are not supported. The + // `v1` identities that have the prefix `user`, `group`, `serviceAccount`, and + // `principal` in https://cloud.google.com/iam/docs/principal-identifiers#v1 + // are supported. Identities []string `json:"identities,omitempty"` // IdentityType: Specifies the type of identities that are allowed access to // outside the perimeter. If left unspecified, then members of `identities` @@ -3114,9 +3116,11 @@ func (s GoogleIdentityAccesscontextmanagerV1EgressTo) MarshalJSON() ([]byte, err type GoogleIdentityAccesscontextmanagerV1IngressFrom struct { // Identities: A list of identities that are allowed access through // [IngressPolicy]. Identities can be an individual user, service account, - // Google group, or third-party identity. The `v1` identities that have the - // prefix `user`, `group`, `serviceAccount`, `principal`, and `principalSet` in - // https://cloud.google.com/iam/docs/principal-identifiers#v1 are supported. + // Google group, or third-party identity. For third-party identity, only single + // identities are supported and other identity types are not supported. The + // `v1` identities that have the prefix `user`, `group`, `serviceAccount`, and + // `principal` in https://cloud.google.com/iam/docs/principal-identifiers#v1 + // are supported. Identities []string `json:"identities,omitempty"` // IdentityType: Specifies the type of identities that are allowed access from // outside the perimeter. If left unspecified, then members of `identities` @@ -4648,17 +4652,19 @@ func (s QueryAssetsRequest) MarshalJSON() ([]byte, error) { // QueryAssetsResponse: QueryAssets response. type QueryAssetsResponse struct { // Done: The query response, which can be either an `error` or a valid - // `response`. If `done` == `false` and the query result is being saved in a + // `response`. If `done` == `false` and the query result is being saved in an // output, the output_config field will be set. If `done` == `true`, exactly - // one of `error`, `query_result` or `output_config` will be set. + // one of `error`, `query_result` or `output_config` will be set. [done] is + // unset unless the [QueryAssetsResponse] contains a + // [QueryAssetsResponse.job_reference]. Done bool `json:"done,omitempty"` // Error: Error status. Error *Status `json:"error,omitempty"` // JobReference: Reference to a query job. JobReference string `json:"jobReference,omitempty"` - // OutputConfig: Output configuration which indicates instead of being returned - // in API response on the fly, the query result will be saved in a specific - // output. + // OutputConfig: Output configuration, which indicates that instead of being + // returned in an API response on the fly, the query result will be saved in a + // specific output. OutputConfig *QueryAssetsOutputConfig `json:"outputConfig,omitempty"` // QueryResult: Result of the query. QueryResult *QueryResult `json:"queryResult,omitempty"` diff --git a/cloudasset/v1beta1/cloudasset-api.json b/cloudasset/v1beta1/cloudasset-api.json index 770e7aabdce..5943500c733 100644 --- a/cloudasset/v1beta1/cloudasset-api.json +++ b/cloudasset/v1beta1/cloudasset-api.json @@ -411,7 +411,7 @@ } } }, - "revision": "20240717", + "revision": "20240803", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AnalyzeIamPolicyLongrunningMetadata": { @@ -1124,7 +1124,7 @@ "id": "GoogleIdentityAccesscontextmanagerV1EgressFrom", "properties": { "identities": { - "description": "A list of identities that are allowed access through [EgressPolicy]. Identities can be an individual user, service account, Google group, or third-party identity. The `v1` identities that have the prefix `user`, `group`, `serviceAccount`, `principal`, and `principalSet` in https://cloud.google.com/iam/docs/principal-identifiers#v1 are supported.", + "description": "A list of identities that are allowed access through [EgressPolicy]. Identities can be an individual user, service account, Google group, or third-party identity. For third-party identity, only single identities are supported and other identity types are not supported. The `v1` identities that have the prefix `user`, `group`, `serviceAccount`, and `principal` in https://cloud.google.com/iam/docs/principal-identifiers#v1 are supported.", "items": { "type": "string" }, @@ -1229,7 +1229,7 @@ "id": "GoogleIdentityAccesscontextmanagerV1IngressFrom", "properties": { "identities": { - "description": "A list of identities that are allowed access through [IngressPolicy]. Identities can be an individual user, service account, Google group, or third-party identity. The `v1` identities that have the prefix `user`, `group`, `serviceAccount`, `principal`, and `principalSet` in https://cloud.google.com/iam/docs/principal-identifiers#v1 are supported.", + "description": "A list of identities that are allowed access through [IngressPolicy]. Identities can be an individual user, service account, Google group, or third-party identity. For third-party identity, only single identities are supported and other identity types are not supported. The `v1` identities that have the prefix `user`, `group`, `serviceAccount`, and `principal` in https://cloud.google.com/iam/docs/principal-identifiers#v1 are supported.", "items": { "type": "string" }, diff --git a/cloudasset/v1beta1/cloudasset-gen.go b/cloudasset/v1beta1/cloudasset-gen.go index c375356204b..d58ad8ce9d5 100644 --- a/cloudasset/v1beta1/cloudasset-gen.go +++ b/cloudasset/v1beta1/cloudasset-gen.go @@ -1413,9 +1413,11 @@ func (s GoogleIdentityAccesscontextmanagerV1DevicePolicy) MarshalJSON() ([]byte, type GoogleIdentityAccesscontextmanagerV1EgressFrom struct { // Identities: A list of identities that are allowed access through // [EgressPolicy]. Identities can be an individual user, service account, - // Google group, or third-party identity. The `v1` identities that have the - // prefix `user`, `group`, `serviceAccount`, `principal`, and `principalSet` in - // https://cloud.google.com/iam/docs/principal-identifiers#v1 are supported. + // Google group, or third-party identity. For third-party identity, only single + // identities are supported and other identity types are not supported. The + // `v1` identities that have the prefix `user`, `group`, `serviceAccount`, and + // `principal` in https://cloud.google.com/iam/docs/principal-identifiers#v1 + // are supported. Identities []string `json:"identities,omitempty"` // IdentityType: Specifies the type of identities that are allowed access to // outside the perimeter. If left unspecified, then members of `identities` @@ -1586,9 +1588,11 @@ func (s GoogleIdentityAccesscontextmanagerV1EgressTo) MarshalJSON() ([]byte, err type GoogleIdentityAccesscontextmanagerV1IngressFrom struct { // Identities: A list of identities that are allowed access through // [IngressPolicy]. Identities can be an individual user, service account, - // Google group, or third-party identity. The `v1` identities that have the - // prefix `user`, `group`, `serviceAccount`, `principal`, and `principalSet` in - // https://cloud.google.com/iam/docs/principal-identifiers#v1 are supported. + // Google group, or third-party identity. For third-party identity, only single + // identities are supported and other identity types are not supported. The + // `v1` identities that have the prefix `user`, `group`, `serviceAccount`, and + // `principal` in https://cloud.google.com/iam/docs/principal-identifiers#v1 + // are supported. Identities []string `json:"identities,omitempty"` // IdentityType: Specifies the type of identities that are allowed access from // outside the perimeter. If left unspecified, then members of `identities` diff --git a/cloudasset/v1p1beta1/cloudasset-api.json b/cloudasset/v1p1beta1/cloudasset-api.json index b99373ddfb9..4af631873ab 100644 --- a/cloudasset/v1p1beta1/cloudasset-api.json +++ b/cloudasset/v1p1beta1/cloudasset-api.json @@ -207,7 +207,7 @@ } } }, - "revision": "20240717", + "revision": "20240803", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AnalyzeIamPolicyLongrunningMetadata": { @@ -826,7 +826,7 @@ "id": "GoogleIdentityAccesscontextmanagerV1EgressFrom", "properties": { "identities": { - "description": "A list of identities that are allowed access through [EgressPolicy]. Identities can be an individual user, service account, Google group, or third-party identity. The `v1` identities that have the prefix `user`, `group`, `serviceAccount`, `principal`, and `principalSet` in https://cloud.google.com/iam/docs/principal-identifiers#v1 are supported.", + "description": "A list of identities that are allowed access through [EgressPolicy]. Identities can be an individual user, service account, Google group, or third-party identity. For third-party identity, only single identities are supported and other identity types are not supported. The `v1` identities that have the prefix `user`, `group`, `serviceAccount`, and `principal` in https://cloud.google.com/iam/docs/principal-identifiers#v1 are supported.", "items": { "type": "string" }, @@ -931,7 +931,7 @@ "id": "GoogleIdentityAccesscontextmanagerV1IngressFrom", "properties": { "identities": { - "description": "A list of identities that are allowed access through [IngressPolicy]. Identities can be an individual user, service account, Google group, or third-party identity. The `v1` identities that have the prefix `user`, `group`, `serviceAccount`, `principal`, and `principalSet` in https://cloud.google.com/iam/docs/principal-identifiers#v1 are supported.", + "description": "A list of identities that are allowed access through [IngressPolicy]. Identities can be an individual user, service account, Google group, or third-party identity. For third-party identity, only single identities are supported and other identity types are not supported. The `v1` identities that have the prefix `user`, `group`, `serviceAccount`, and `principal` in https://cloud.google.com/iam/docs/principal-identifiers#v1 are supported.", "items": { "type": "string" }, diff --git a/cloudasset/v1p1beta1/cloudasset-gen.go b/cloudasset/v1p1beta1/cloudasset-gen.go index 4b390c85569..3b4efc5e242 100644 --- a/cloudasset/v1p1beta1/cloudasset-gen.go +++ b/cloudasset/v1p1beta1/cloudasset-gen.go @@ -1224,9 +1224,11 @@ func (s GoogleIdentityAccesscontextmanagerV1DevicePolicy) MarshalJSON() ([]byte, type GoogleIdentityAccesscontextmanagerV1EgressFrom struct { // Identities: A list of identities that are allowed access through // [EgressPolicy]. Identities can be an individual user, service account, - // Google group, or third-party identity. The `v1` identities that have the - // prefix `user`, `group`, `serviceAccount`, `principal`, and `principalSet` in - // https://cloud.google.com/iam/docs/principal-identifiers#v1 are supported. + // Google group, or third-party identity. For third-party identity, only single + // identities are supported and other identity types are not supported. The + // `v1` identities that have the prefix `user`, `group`, `serviceAccount`, and + // `principal` in https://cloud.google.com/iam/docs/principal-identifiers#v1 + // are supported. Identities []string `json:"identities,omitempty"` // IdentityType: Specifies the type of identities that are allowed access to // outside the perimeter. If left unspecified, then members of `identities` @@ -1397,9 +1399,11 @@ func (s GoogleIdentityAccesscontextmanagerV1EgressTo) MarshalJSON() ([]byte, err type GoogleIdentityAccesscontextmanagerV1IngressFrom struct { // Identities: A list of identities that are allowed access through // [IngressPolicy]. Identities can be an individual user, service account, - // Google group, or third-party identity. The `v1` identities that have the - // prefix `user`, `group`, `serviceAccount`, `principal`, and `principalSet` in - // https://cloud.google.com/iam/docs/principal-identifiers#v1 are supported. + // Google group, or third-party identity. For third-party identity, only single + // identities are supported and other identity types are not supported. The + // `v1` identities that have the prefix `user`, `group`, `serviceAccount`, and + // `principal` in https://cloud.google.com/iam/docs/principal-identifiers#v1 + // are supported. Identities []string `json:"identities,omitempty"` // IdentityType: Specifies the type of identities that are allowed access from // outside the perimeter. If left unspecified, then members of `identities` diff --git a/cloudasset/v1p5beta1/cloudasset-api.json b/cloudasset/v1p5beta1/cloudasset-api.json index 70aac1af8e7..a2e89fa7195 100644 --- a/cloudasset/v1p5beta1/cloudasset-api.json +++ b/cloudasset/v1p5beta1/cloudasset-api.json @@ -177,7 +177,7 @@ } } }, - "revision": "20240717", + "revision": "20240803", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AnalyzeIamPolicyLongrunningMetadata": { @@ -831,7 +831,7 @@ "id": "GoogleIdentityAccesscontextmanagerV1EgressFrom", "properties": { "identities": { - "description": "A list of identities that are allowed access through [EgressPolicy]. Identities can be an individual user, service account, Google group, or third-party identity. The `v1` identities that have the prefix `user`, `group`, `serviceAccount`, `principal`, and `principalSet` in https://cloud.google.com/iam/docs/principal-identifiers#v1 are supported.", + "description": "A list of identities that are allowed access through [EgressPolicy]. Identities can be an individual user, service account, Google group, or third-party identity. For third-party identity, only single identities are supported and other identity types are not supported. The `v1` identities that have the prefix `user`, `group`, `serviceAccount`, and `principal` in https://cloud.google.com/iam/docs/principal-identifiers#v1 are supported.", "items": { "type": "string" }, @@ -936,7 +936,7 @@ "id": "GoogleIdentityAccesscontextmanagerV1IngressFrom", "properties": { "identities": { - "description": "A list of identities that are allowed access through [IngressPolicy]. Identities can be an individual user, service account, Google group, or third-party identity. The `v1` identities that have the prefix `user`, `group`, `serviceAccount`, `principal`, and `principalSet` in https://cloud.google.com/iam/docs/principal-identifiers#v1 are supported.", + "description": "A list of identities that are allowed access through [IngressPolicy]. Identities can be an individual user, service account, Google group, or third-party identity. For third-party identity, only single identities are supported and other identity types are not supported. The `v1` identities that have the prefix `user`, `group`, `serviceAccount`, and `principal` in https://cloud.google.com/iam/docs/principal-identifiers#v1 are supported.", "items": { "type": "string" }, diff --git a/cloudasset/v1p5beta1/cloudasset-gen.go b/cloudasset/v1p5beta1/cloudasset-gen.go index dceb3160b28..6a09f748c21 100644 --- a/cloudasset/v1p5beta1/cloudasset-gen.go +++ b/cloudasset/v1p5beta1/cloudasset-gen.go @@ -1258,9 +1258,11 @@ func (s GoogleIdentityAccesscontextmanagerV1DevicePolicy) MarshalJSON() ([]byte, type GoogleIdentityAccesscontextmanagerV1EgressFrom struct { // Identities: A list of identities that are allowed access through // [EgressPolicy]. Identities can be an individual user, service account, - // Google group, or third-party identity. The `v1` identities that have the - // prefix `user`, `group`, `serviceAccount`, `principal`, and `principalSet` in - // https://cloud.google.com/iam/docs/principal-identifiers#v1 are supported. + // Google group, or third-party identity. For third-party identity, only single + // identities are supported and other identity types are not supported. The + // `v1` identities that have the prefix `user`, `group`, `serviceAccount`, and + // `principal` in https://cloud.google.com/iam/docs/principal-identifiers#v1 + // are supported. Identities []string `json:"identities,omitempty"` // IdentityType: Specifies the type of identities that are allowed access to // outside the perimeter. If left unspecified, then members of `identities` @@ -1431,9 +1433,11 @@ func (s GoogleIdentityAccesscontextmanagerV1EgressTo) MarshalJSON() ([]byte, err type GoogleIdentityAccesscontextmanagerV1IngressFrom struct { // Identities: A list of identities that are allowed access through // [IngressPolicy]. Identities can be an individual user, service account, - // Google group, or third-party identity. The `v1` identities that have the - // prefix `user`, `group`, `serviceAccount`, `principal`, and `principalSet` in - // https://cloud.google.com/iam/docs/principal-identifiers#v1 are supported. + // Google group, or third-party identity. For third-party identity, only single + // identities are supported and other identity types are not supported. The + // `v1` identities that have the prefix `user`, `group`, `serviceAccount`, and + // `principal` in https://cloud.google.com/iam/docs/principal-identifiers#v1 + // are supported. Identities []string `json:"identities,omitempty"` // IdentityType: Specifies the type of identities that are allowed access from // outside the perimeter. If left unspecified, then members of `identities` diff --git a/cloudasset/v1p7beta1/cloudasset-api.json b/cloudasset/v1p7beta1/cloudasset-api.json index c9c31927c8c..02e245d73db 100644 --- a/cloudasset/v1p7beta1/cloudasset-api.json +++ b/cloudasset/v1p7beta1/cloudasset-api.json @@ -167,7 +167,7 @@ } } }, - "revision": "20240717", + "revision": "20240803", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AnalyzeIamPolicyLongrunningMetadata": { @@ -900,7 +900,7 @@ "id": "GoogleIdentityAccesscontextmanagerV1EgressFrom", "properties": { "identities": { - "description": "A list of identities that are allowed access through [EgressPolicy]. Identities can be an individual user, service account, Google group, or third-party identity. The `v1` identities that have the prefix `user`, `group`, `serviceAccount`, `principal`, and `principalSet` in https://cloud.google.com/iam/docs/principal-identifiers#v1 are supported.", + "description": "A list of identities that are allowed access through [EgressPolicy]. Identities can be an individual user, service account, Google group, or third-party identity. For third-party identity, only single identities are supported and other identity types are not supported. The `v1` identities that have the prefix `user`, `group`, `serviceAccount`, and `principal` in https://cloud.google.com/iam/docs/principal-identifiers#v1 are supported.", "items": { "type": "string" }, @@ -1005,7 +1005,7 @@ "id": "GoogleIdentityAccesscontextmanagerV1IngressFrom", "properties": { "identities": { - "description": "A list of identities that are allowed access through [IngressPolicy]. Identities can be an individual user, service account, Google group, or third-party identity. The `v1` identities that have the prefix `user`, `group`, `serviceAccount`, `principal`, and `principalSet` in https://cloud.google.com/iam/docs/principal-identifiers#v1 are supported.", + "description": "A list of identities that are allowed access through [IngressPolicy]. Identities can be an individual user, service account, Google group, or third-party identity. For third-party identity, only single identities are supported and other identity types are not supported. The `v1` identities that have the prefix `user`, `group`, `serviceAccount`, and `principal` in https://cloud.google.com/iam/docs/principal-identifiers#v1 are supported.", "items": { "type": "string" }, diff --git a/cloudasset/v1p7beta1/cloudasset-gen.go b/cloudasset/v1p7beta1/cloudasset-gen.go index ea3ba5c14fd..dd2c98dfe5d 100644 --- a/cloudasset/v1p7beta1/cloudasset-gen.go +++ b/cloudasset/v1p7beta1/cloudasset-gen.go @@ -1434,9 +1434,11 @@ func (s GoogleIdentityAccesscontextmanagerV1DevicePolicy) MarshalJSON() ([]byte, type GoogleIdentityAccesscontextmanagerV1EgressFrom struct { // Identities: A list of identities that are allowed access through // [EgressPolicy]. Identities can be an individual user, service account, - // Google group, or third-party identity. The `v1` identities that have the - // prefix `user`, `group`, `serviceAccount`, `principal`, and `principalSet` in - // https://cloud.google.com/iam/docs/principal-identifiers#v1 are supported. + // Google group, or third-party identity. For third-party identity, only single + // identities are supported and other identity types are not supported. The + // `v1` identities that have the prefix `user`, `group`, `serviceAccount`, and + // `principal` in https://cloud.google.com/iam/docs/principal-identifiers#v1 + // are supported. Identities []string `json:"identities,omitempty"` // IdentityType: Specifies the type of identities that are allowed access to // outside the perimeter. If left unspecified, then members of `identities` @@ -1607,9 +1609,11 @@ func (s GoogleIdentityAccesscontextmanagerV1EgressTo) MarshalJSON() ([]byte, err type GoogleIdentityAccesscontextmanagerV1IngressFrom struct { // Identities: A list of identities that are allowed access through // [IngressPolicy]. Identities can be an individual user, service account, - // Google group, or third-party identity. The `v1` identities that have the - // prefix `user`, `group`, `serviceAccount`, `principal`, and `principalSet` in - // https://cloud.google.com/iam/docs/principal-identifiers#v1 are supported. + // Google group, or third-party identity. For third-party identity, only single + // identities are supported and other identity types are not supported. The + // `v1` identities that have the prefix `user`, `group`, `serviceAccount`, and + // `principal` in https://cloud.google.com/iam/docs/principal-identifiers#v1 + // are supported. Identities []string `json:"identities,omitempty"` // IdentityType: Specifies the type of identities that are allowed access from // outside the perimeter. If left unspecified, then members of `identities` diff --git a/cloudbuild/v2/cloudbuild-api.json b/cloudbuild/v2/cloudbuild-api.json index 965af1e02c8..5ca32730228 100644 --- a/cloudbuild/v2/cloudbuild-api.json +++ b/cloudbuild/v2/cloudbuild-api.json @@ -844,7 +844,7 @@ } } }, - "revision": "20240720", + "revision": "20240731", "rootUrl": "https://cloudbuild.googleapis.com/", "schemas": { "AuditConfig": { @@ -1866,8 +1866,7 @@ "id": "PipelineRef", "properties": { "name": { - "deprecated": true, - "description": "Name of the Pipeline.", + "description": "Optional. Name of the Pipeline.", "type": "string" }, "params": { @@ -2852,8 +2851,7 @@ "id": "TaskRef", "properties": { "name": { - "deprecated": true, - "description": "Name of the task.", + "description": "Optional. Name of the task.", "type": "string" }, "params": { diff --git a/cloudbuild/v2/cloudbuild-gen.go b/cloudbuild/v2/cloudbuild-gen.go index 41e7081c499..43eea4a9177 100644 --- a/cloudbuild/v2/cloudbuild-gen.go +++ b/cloudbuild/v2/cloudbuild-gen.go @@ -1577,7 +1577,7 @@ func (s ParamValue) MarshalJSON() ([]byte, error) { // PipelineRef: PipelineRef can be used to refer to a specific instance of a // Pipeline. type PipelineRef struct { - // Name: Name of the Pipeline. + // Name: Optional. Name of the Pipeline. Name string `json:"name,omitempty"` // Params: Params contains the parameters used to identify the referenced // Tekton resource. Example entries might include "repo" or "path" but the set @@ -2558,7 +2558,7 @@ func (s StepTemplate) MarshalJSON() ([]byte, error) { // TaskRef: TaskRef can be used to refer to a specific instance of a task. // PipelineRef can be used to refer to a specific instance of a Pipeline. type TaskRef struct { - // Name: Name of the task. + // Name: Optional. Name of the task. Name string `json:"name,omitempty"` // Params: Params contains the parameters used to identify the referenced // Tekton resource. Example entries might include "repo" or "path" but the set diff --git a/clouddeploy/v1/clouddeploy-api.json b/clouddeploy/v1/clouddeploy-api.json index 3dc00c94fb1..bc82f14532a 100644 --- a/clouddeploy/v1/clouddeploy-api.json +++ b/clouddeploy/v1/clouddeploy-api.json @@ -219,7 +219,7 @@ "type": "string" }, "parent": { - "description": "Required. The parent collection in which the `CustomTargetType` should be created. Format should be `projects/{project_id}/locations/{location_name}`.", + "description": "Required. The parent collection in which the `CustomTargetType` must be created. The format is `projects/{project_id}/locations/{location_name}`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -421,7 +421,7 @@ "type": "string" }, "updateMask": { - "description": "Required. Field mask is used to specify the fields to be overwritten in the `CustomTargetType` resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it's in the mask. If the user doesn't provide a mask then all fields are overwritten.", + "description": "Required. Field mask is used to specify the fields to be overwritten by the update in the `CustomTargetType` resource. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it's in the mask. If the user doesn't provide a mask then all fields are overwritten.", "format": "google-fieldmask", "location": "query", "type": "string" @@ -490,7 +490,7 @@ "type": "string" }, "parent": { - "description": "Required. The parent collection in which the `DeliveryPipeline` should be created. Format should be `projects/{project_id}/locations/{location_name}`.", + "description": "Required. The parent collection in which the `DeliveryPipeline` must be created. The format is `projects/{project_id}/locations/{location_name}`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -543,7 +543,7 @@ "type": "boolean" }, "name": { - "description": "Required. The name of the `DeliveryPipeline` to delete. Format should be `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipeline_name}`.", + "description": "Required. The name of the `DeliveryPipeline` to delete. The format is `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipeline_name}`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+$", "required": true, @@ -697,7 +697,7 @@ "type": "string" }, "updateMask": { - "description": "Required. Field mask is used to specify the fields to be overwritten in the `DeliveryPipeline` resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it's in the mask. If the user doesn't provide a mask then all fields are overwritten.", + "description": "Required. Field mask is used to specify the fields to be overwritten by the update in the `DeliveryPipeline` resource. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it's in the mask. If the user doesn't provide a mask then all fields are overwritten.", "format": "google-fieldmask", "location": "query", "type": "string" @@ -729,7 +729,7 @@ ], "parameters": { "name": { - "description": "Required. The `DeliveryPipeline` for which the rollback `Rollout` should be created. Format should be `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipeline_name}`.", + "description": "Required. The `DeliveryPipeline` for which the rollback `Rollout` must be created. The format is `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipeline_name}`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+$", "required": true, @@ -925,7 +925,7 @@ "type": "string" }, "parent": { - "description": "Required. The parent collection in which the `Automation` should be created. Format should be `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipeline_name}`.", + "description": "Required. The parent collection in which the `Automation` must be created. The format is `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipeline_name}`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+$", "required": true, @@ -973,7 +973,7 @@ "type": "string" }, "name": { - "description": "Required. The name of the `Automation` to delete. Format should be `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipeline_name}/automations/{automation_name}`.", + "description": "Required. The name of the `Automation` to delete. The format is `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipeline_name}/automations/{automation_name}`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+/automations/[^/]+$", "required": true, @@ -1096,7 +1096,7 @@ "type": "string" }, "updateMask": { - "description": "Required. Field mask is used to specify the fields to be overwritten in the `Automation` resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it's in the mask. If the user doesn't provide a mask then all fields are overwritten.", + "description": "Required. Field mask is used to specify the fields to be overwritten by the update in the `Automation` resource. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it's in the mask. If the user doesn't provide a mask then all fields are overwritten.", "format": "google-fieldmask", "location": "query", "type": "string" @@ -1160,7 +1160,7 @@ ], "parameters": { "parent": { - "description": "Required. The parent collection in which the `Release` should be created. Format should be `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipeline_name}`.", + "description": "Required. The parent collection in which the `Release` is created. The format is `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipeline_name}`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+$", "required": true, @@ -1362,7 +1362,7 @@ ], "parameters": { "parent": { - "description": "Required. The parent collection in which the `Rollout` should be created. Format should be `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipeline_name}/releases/{release_name}`.", + "description": "Required. The parent collection in which the `Rollout` must be created. The format is `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipeline_name}/releases/{release_name}`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/deliveryPipelines/[^/]+/releases/[^/]+$", "required": true, @@ -1773,7 +1773,7 @@ ], "parameters": { "parent": { - "description": "Required. The parent collection in which the `Target` should be created. Format should be `projects/{project_id}/locations/{location_name}`.", + "description": "Required. The parent collection in which the `Target` must be created. The format is `projects/{project_id}/locations/{location_name}`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -1826,7 +1826,7 @@ "type": "string" }, "name": { - "description": "Required. The name of the `Target` to delete. Format should be `projects/{project_id}/locations/{location_name}/targets/{target_name}`.", + "description": "Required. The name of the `Target` to delete. The format is `projects/{project_id}/locations/{location_name}/targets/{target_name}`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/targets/[^/]+$", "required": true, @@ -1980,7 +1980,7 @@ "type": "string" }, "updateMask": { - "description": "Required. Field mask is used to specify the fields to be overwritten in the Target resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it's in the mask. If the user doesn't provide a mask then all fields are overwritten.", + "description": "Required. Field mask is used to specify the fields to be overwritten by the update in the `Target` resource. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it's in the mask. If the user doesn't provide a mask then all fields are overwritten.", "format": "google-fieldmask", "location": "query", "type": "string" @@ -2065,7 +2065,7 @@ } } }, - "revision": "20240614", + "revision": "20240728", "rootUrl": "https://clouddeploy.googleapis.com/", "schemas": { "AbandonReleaseRequest": { @@ -3020,6 +3020,59 @@ }, "type": "object" }, + "CustomTargetTypeNotificationEvent": { + "description": "Payload proto for \"clouddeploy.googleapis.com/customtargettype_notification\" Platform Log event that describes the failure to send a custom target type status change Pub/Sub notification.", + "id": "CustomTargetTypeNotificationEvent", + "properties": { + "customTargetType": { + "description": "The name of the `CustomTargetType`.", + "type": "string" + }, + "customTargetTypeUid": { + "description": "Unique identifier of the `CustomTargetType`.", + "type": "string" + }, + "message": { + "description": "Debug message for when a notification fails to send.", + "type": "string" + }, + "type": { + "description": "Type of this notification, e.g. for a Pub/Sub failure.", + "enum": [ + "TYPE_UNSPECIFIED", + "TYPE_PUBSUB_NOTIFICATION_FAILURE", + "TYPE_RESOURCE_STATE_CHANGE", + "TYPE_PROCESS_ABORTED", + "TYPE_RESTRICTION_VIOLATED", + "TYPE_RESOURCE_DELETED", + "TYPE_ROLLOUT_UPDATE", + "TYPE_RENDER_STATUES_CHANGE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + false, + true + ], + "enumDescriptions": [ + "Type is unspecified.", + "A Pub/Sub notification failed to be sent.", + "Resource state changed.", + "A process aborted.", + "Restriction check failed.", + "Resource deleted.", + "Rollout updated.", + "Deprecated: This field is never used. Use release_render log type instead." + ], + "type": "string" + } + }, + "type": "object" + }, "Date": { "description": "Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp", "id": "Date", @@ -3292,6 +3345,59 @@ }, "type": "object" }, + "DeployPolicyNotificationEvent": { + "description": "Payload proto for \"clouddeploy.googleapis.com/deploypolicy_notification\". Platform Log event that describes the failure to send a pub/sub notification when there is a DeployPolicy status change.", + "id": "DeployPolicyNotificationEvent", + "properties": { + "deployPolicy": { + "description": "The name of the `DeployPolicy`.", + "type": "string" + }, + "deployPolicyUid": { + "description": "Unique identifier of the deploy policy.", + "type": "string" + }, + "message": { + "description": "Debug message for when a deploy policy fails to send a pub/sub notification.", + "type": "string" + }, + "type": { + "description": "Type of this notification, e.g. for a Pub/Sub failure.", + "enum": [ + "TYPE_UNSPECIFIED", + "TYPE_PUBSUB_NOTIFICATION_FAILURE", + "TYPE_RESOURCE_STATE_CHANGE", + "TYPE_PROCESS_ABORTED", + "TYPE_RESTRICTION_VIOLATED", + "TYPE_RESOURCE_DELETED", + "TYPE_ROLLOUT_UPDATE", + "TYPE_RENDER_STATUES_CHANGE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + false, + true + ], + "enumDescriptions": [ + "Type is unspecified.", + "A Pub/Sub notification failed to be sent.", + "Resource state changed.", + "A process aborted.", + "Restriction check failed.", + "Resource deleted.", + "Rollout updated.", + "Deprecated: This field is never used. Use release_render log type instead." + ], + "type": "string" + } + }, + "type": "object" + }, "DeploymentJobs": { "description": "Deployment job composition.", "id": "DeploymentJobs", @@ -3419,6 +3525,10 @@ "description": "Required. Name of the Gateway API HTTPRoute.", "type": "string" }, + "podSelectorLabel": { + "description": "Optional. The label to use when selecting Pods for the Deployment and Service resources. This label must already be present in both resources.", + "type": "string" + }, "routeUpdateWaitTime": { "description": "Optional. The time to wait for route updates to propagate. The maximum configurable time is 3 hours, in seconds format. If unspecified, there is no wait time.", "format": "google-duration", @@ -4479,7 +4589,7 @@ "type": "object" }, "PromoteReleaseRule": { - "description": "`PromoteRelease` rule will automatically promote a release from the current target to a specified target.", + "description": "The `PromoteRelease` rule will automatically promote a release from the current target to a specified target.", "id": "PromoteReleaseRule", "properties": { "condition": { @@ -5499,6 +5609,10 @@ "description": "Optional. Whether to disable Pod overprovisioning. If Pod overprovisioning is disabled then Cloud Deploy will limit the number of total Pods used for the deployment strategy to the number of Pods the Deployment has on the cluster.", "type": "boolean" }, + "podSelectorLabel": { + "description": "Optional. The label to use when selecting Pods for the Deployment resource. This label must already be present in the Deployment.", + "type": "string" + }, "service": { "description": "Required. Name of the Kubernetes Service.", "type": "string" diff --git a/clouddeploy/v1/clouddeploy-gen.go b/clouddeploy/v1/clouddeploy-gen.go index 62dded80112..e57bcfdac94 100644 --- a/clouddeploy/v1/clouddeploy-gen.go +++ b/clouddeploy/v1/clouddeploy-gen.go @@ -1516,6 +1516,49 @@ func (s CustomTargetType) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// CustomTargetTypeNotificationEvent: Payload proto for +// "clouddeploy.googleapis.com/customtargettype_notification" Platform Log +// event that describes the failure to send a custom target type status change +// Pub/Sub notification. +type CustomTargetTypeNotificationEvent struct { + // CustomTargetType: The name of the `CustomTargetType`. + CustomTargetType string `json:"customTargetType,omitempty"` + // CustomTargetTypeUid: Unique identifier of the `CustomTargetType`. + CustomTargetTypeUid string `json:"customTargetTypeUid,omitempty"` + // Message: Debug message for when a notification fails to send. + Message string `json:"message,omitempty"` + // Type: Type of this notification, e.g. for a Pub/Sub failure. + // + // Possible values: + // "TYPE_UNSPECIFIED" - Type is unspecified. + // "TYPE_PUBSUB_NOTIFICATION_FAILURE" - A Pub/Sub notification failed to be + // sent. + // "TYPE_RESOURCE_STATE_CHANGE" - Resource state changed. + // "TYPE_PROCESS_ABORTED" - A process aborted. + // "TYPE_RESTRICTION_VIOLATED" - Restriction check failed. + // "TYPE_RESOURCE_DELETED" - Resource deleted. + // "TYPE_ROLLOUT_UPDATE" - Rollout updated. + // "TYPE_RENDER_STATUES_CHANGE" - Deprecated: This field is never used. Use + // release_render log type instead. + Type string `json:"type,omitempty"` + // ForceSendFields is a list of field names (e.g. "CustomTargetType") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CustomTargetType") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s CustomTargetTypeNotificationEvent) MarshalJSON() ([]byte, error) { + type NoMethod CustomTargetTypeNotificationEvent + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Date: Represents a whole or partial calendar date, such as a birthday. The // time of day and time zone are either specified elsewhere or are // insignificant. The date is relative to the Gregorian Calendar. This can @@ -1831,6 +1874,50 @@ func (s DeployParameters) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// DeployPolicyNotificationEvent: Payload proto for +// "clouddeploy.googleapis.com/deploypolicy_notification". Platform Log event +// that describes the failure to send a pub/sub notification when there is a +// DeployPolicy status change. +type DeployPolicyNotificationEvent struct { + // DeployPolicy: The name of the `DeployPolicy`. + DeployPolicy string `json:"deployPolicy,omitempty"` + // DeployPolicyUid: Unique identifier of the deploy policy. + DeployPolicyUid string `json:"deployPolicyUid,omitempty"` + // Message: Debug message for when a deploy policy fails to send a pub/sub + // notification. + Message string `json:"message,omitempty"` + // Type: Type of this notification, e.g. for a Pub/Sub failure. + // + // Possible values: + // "TYPE_UNSPECIFIED" - Type is unspecified. + // "TYPE_PUBSUB_NOTIFICATION_FAILURE" - A Pub/Sub notification failed to be + // sent. + // "TYPE_RESOURCE_STATE_CHANGE" - Resource state changed. + // "TYPE_PROCESS_ABORTED" - A process aborted. + // "TYPE_RESTRICTION_VIOLATED" - Restriction check failed. + // "TYPE_RESOURCE_DELETED" - Resource deleted. + // "TYPE_ROLLOUT_UPDATE" - Rollout updated. + // "TYPE_RENDER_STATUES_CHANGE" - Deprecated: This field is never used. Use + // release_render log type instead. + Type string `json:"type,omitempty"` + // ForceSendFields is a list of field names (e.g. "DeployPolicy") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "DeployPolicy") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s DeployPolicyNotificationEvent) MarshalJSON() ([]byte, error) { + type NoMethod DeployPolicyNotificationEvent + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // DeploymentJobs: Deployment job composition. type DeploymentJobs struct { // DeployJob: Output only. The deploy Job. This is the deploy job in the phase. @@ -1983,6 +2070,10 @@ type GatewayServiceMesh struct { Deployment string `json:"deployment,omitempty"` // HttpRoute: Required. Name of the Gateway API HTTPRoute. HttpRoute string `json:"httpRoute,omitempty"` + // PodSelectorLabel: Optional. The label to use when selecting Pods for the + // Deployment and Service resources. This label must already be present in both + // resources. + PodSelectorLabel string `json:"podSelectorLabel,omitempty"` // RouteUpdateWaitTime: Optional. The time to wait for route updates to // propagate. The maximum configurable time is 3 hours, in seconds format. If // unspecified, there is no wait time. @@ -3258,7 +3349,7 @@ func (s PromoteReleaseOperation) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// PromoteReleaseRule: `PromoteRelease` rule will automatically promote a +// PromoteReleaseRule: The `PromoteRelease` rule will automatically promote a // release from the current target to a specified target. type PromoteReleaseRule struct { // Condition: Output only. Information around the state of the Automation rule. @@ -4210,6 +4301,9 @@ type ServiceNetworking struct { // limit the number of total Pods used for the deployment strategy to the // number of Pods the Deployment has on the cluster. DisablePodOverprovisioning bool `json:"disablePodOverprovisioning,omitempty"` + // PodSelectorLabel: Optional. The label to use when selecting Pods for the + // Deployment resource. This label must already be present in the Deployment. + PodSelectorLabel string `json:"podSelectorLabel,omitempty"` // Service: Required. Name of the Kubernetes Service. Service string `json:"service,omitempty"` // ForceSendFields is a list of field names (e.g. "Deployment") to @@ -5366,9 +5460,8 @@ type ProjectsLocationsCustomTargetTypesCreateCall struct { // Create: Creates a new CustomTargetType in a given project and location. // -// - parent: The parent collection in which the `CustomTargetType` should be -// created. Format should be -// `projects/{project_id}/locations/{location_name}`. +// - parent: The parent collection in which the `CustomTargetType` must be +// created. The format is `projects/{project_id}/locations/{location_name}`. func (r *ProjectsLocationsCustomTargetTypesService) Create(parent string, customtargettype *CustomTargetType) *ProjectsLocationsCustomTargetTypesCreateCall { c := &ProjectsLocationsCustomTargetTypesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -6072,10 +6165,10 @@ func (c *ProjectsLocationsCustomTargetTypesPatchCall) RequestId(requestId string } // UpdateMask sets the optional parameter "updateMask": Required. Field mask is -// used to specify the fields to be overwritten in the `CustomTargetType` -// resource by the update. The fields specified in the update_mask are relative -// to the resource, not the full request. A field will be overwritten if it's -// in the mask. If the user doesn't provide a mask then all fields are +// used to specify the fields to be overwritten by the update in the +// `CustomTargetType` resource. The fields specified in the update_mask are +// relative to the resource, not the full request. A field will be overwritten +// if it's in the mask. If the user doesn't provide a mask then all fields are // overwritten. func (c *ProjectsLocationsCustomTargetTypesPatchCall) UpdateMask(updateMask string) *ProjectsLocationsCustomTargetTypesPatchCall { c.urlParams_.Set("updateMask", updateMask) @@ -6288,9 +6381,8 @@ type ProjectsLocationsDeliveryPipelinesCreateCall struct { // Create: Creates a new DeliveryPipeline in a given project and location. // -// - parent: The parent collection in which the `DeliveryPipeline` should be -// created. Format should be -// `projects/{project_id}/locations/{location_name}`. +// - parent: The parent collection in which the `DeliveryPipeline` must be +// created. The format is `projects/{project_id}/locations/{location_name}`. func (r *ProjectsLocationsDeliveryPipelinesService) Create(parent string, deliverypipeline *DeliveryPipeline) *ProjectsLocationsDeliveryPipelinesCreateCall { c := &ProjectsLocationsDeliveryPipelinesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -6421,7 +6513,7 @@ type ProjectsLocationsDeliveryPipelinesDeleteCall struct { // Delete: Deletes a single DeliveryPipeline. // -// - name: The name of the `DeliveryPipeline` to delete. Format should be +// - name: The name of the `DeliveryPipeline` to delete. The format is // `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipelin // e_name}`. func (r *ProjectsLocationsDeliveryPipelinesService) Delete(name string) *ProjectsLocationsDeliveryPipelinesDeleteCall { @@ -7002,10 +7094,10 @@ func (c *ProjectsLocationsDeliveryPipelinesPatchCall) RequestId(requestId string } // UpdateMask sets the optional parameter "updateMask": Required. Field mask is -// used to specify the fields to be overwritten in the `DeliveryPipeline` -// resource by the update. The fields specified in the update_mask are relative -// to the resource, not the full request. A field will be overwritten if it's -// in the mask. If the user doesn't provide a mask then all fields are +// used to specify the fields to be overwritten by the update in the +// `DeliveryPipeline` resource. The fields specified in the update_mask are +// relative to the resource, not the full request. A field will be overwritten +// if it's in the mask. If the user doesn't provide a mask then all fields are // overwritten. func (c *ProjectsLocationsDeliveryPipelinesPatchCall) UpdateMask(updateMask string) *ProjectsLocationsDeliveryPipelinesPatchCall { c.urlParams_.Set("updateMask", updateMask) @@ -7113,8 +7205,8 @@ type ProjectsLocationsDeliveryPipelinesRollbackTargetCall struct { // RollbackTarget: Creates a `Rollout` to roll back the specified target. // -// - name: The `DeliveryPipeline` for which the rollback `Rollout` should be -// created. Format should be +// - name: The `DeliveryPipeline` for which the rollback `Rollout` must be +// created. The format is // `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipelin // e_name}`. func (r *ProjectsLocationsDeliveryPipelinesService) RollbackTarget(name string, rollbacktargetrequest *RollbackTargetRequest) *ProjectsLocationsDeliveryPipelinesRollbackTargetCall { @@ -7811,8 +7903,8 @@ type ProjectsLocationsDeliveryPipelinesAutomationsCreateCall struct { // Create: Creates a new Automation in a given project and location. // -// - parent: The parent collection in which the `Automation` should be created. -// Format should be +// - parent: The parent collection in which the `Automation` must be created. +// The format is // `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipelin // e_name}`. func (r *ProjectsLocationsDeliveryPipelinesAutomationsService) Create(parent string, automation *Automation) *ProjectsLocationsDeliveryPipelinesAutomationsCreateCall { @@ -7945,7 +8037,7 @@ type ProjectsLocationsDeliveryPipelinesAutomationsDeleteCall struct { // Delete: Deletes a single Automation resource. // -// - name: The name of the `Automation` to delete. Format should be +// - name: The name of the `Automation` to delete. The format is // `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipelin // e_name}/automations/{automation_name}`. func (r *ProjectsLocationsDeliveryPipelinesAutomationsService) Delete(name string) *ProjectsLocationsDeliveryPipelinesAutomationsDeleteCall { @@ -8390,10 +8482,11 @@ func (c *ProjectsLocationsDeliveryPipelinesAutomationsPatchCall) RequestId(reque } // UpdateMask sets the optional parameter "updateMask": Required. Field mask is -// used to specify the fields to be overwritten in the `Automation` resource by -// the update. The fields specified in the update_mask are relative to the -// resource, not the full request. A field will be overwritten if it's in the -// mask. If the user doesn't provide a mask then all fields are overwritten. +// used to specify the fields to be overwritten by the update in the +// `Automation` resource. The fields specified in the update_mask are relative +// to the resource, not the full request. A field will be overwritten if it's +// in the mask. If the user doesn't provide a mask then all fields are +// overwritten. func (c *ProjectsLocationsDeliveryPipelinesAutomationsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsDeliveryPipelinesAutomationsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -8604,8 +8697,8 @@ type ProjectsLocationsDeliveryPipelinesReleasesCreateCall struct { // Create: Creates a new Release in a given project and location. // -// - parent: The parent collection in which the `Release` should be created. -// Format should be +// - parent: The parent collection in which the `Release` is created. The +// format is // `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipelin // e_name}`. func (r *ProjectsLocationsDeliveryPipelinesReleasesService) Create(parent string, release *Release) *ProjectsLocationsDeliveryPipelinesReleasesCreateCall { @@ -9322,8 +9415,8 @@ type ProjectsLocationsDeliveryPipelinesReleasesRolloutsCreateCall struct { // Create: Creates a new Rollout in a given project and location. // -// - parent: The parent collection in which the `Rollout` should be created. -// Format should be +// - parent: The parent collection in which the `Rollout` must be created. The +// format is // `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipelin // e_name}/releases/{release_name}`. func (r *ProjectsLocationsDeliveryPipelinesReleasesRolloutsService) Create(parent string, rollout *Rollout) *ProjectsLocationsDeliveryPipelinesReleasesRolloutsCreateCall { @@ -10784,8 +10877,8 @@ type ProjectsLocationsTargetsCreateCall struct { // Create: Creates a new Target in a given project and location. // -// - parent: The parent collection in which the `Target` should be created. -// Format should be `projects/{project_id}/locations/{location_name}`. +// - parent: The parent collection in which the `Target` must be created. The +// format is `projects/{project_id}/locations/{location_name}`. func (r *ProjectsLocationsTargetsService) Create(parent string, target *Target) *ProjectsLocationsTargetsCreateCall { c := &ProjectsLocationsTargetsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -10916,7 +11009,7 @@ type ProjectsLocationsTargetsDeleteCall struct { // Delete: Deletes a single Target. // -// - name: The name of the `Target` to delete. Format should be +// - name: The name of the `Target` to delete. The format is // `projects/{project_id}/locations/{location_name}/targets/{target_name}`. func (r *ProjectsLocationsTargetsService) Delete(name string) *ProjectsLocationsTargetsDeleteCall { c := &ProjectsLocationsTargetsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -11484,8 +11577,8 @@ func (c *ProjectsLocationsTargetsPatchCall) RequestId(requestId string) *Project } // UpdateMask sets the optional parameter "updateMask": Required. Field mask is -// used to specify the fields to be overwritten in the Target resource by the -// update. The fields specified in the update_mask are relative to the +// used to specify the fields to be overwritten by the update in the `Target` +// resource. The fields specified in the update_mask are relative to the // resource, not the full request. A field will be overwritten if it's in the // mask. If the user doesn't provide a mask then all fields are overwritten. func (c *ProjectsLocationsTargetsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsTargetsPatchCall { diff --git a/connectors/v1/connectors-api.json b/connectors/v1/connectors-api.json index 6567fa406af..547b75bf1f0 100644 --- a/connectors/v1/connectors-api.json +++ b/connectors/v1/connectors-api.json @@ -2427,7 +2427,7 @@ } } }, - "revision": "20240715", + "revision": "20240729", "rootUrl": "https://connectors.googleapis.com/", "schemas": { "AuditConfig": { @@ -3256,6 +3256,11 @@ "format": "int64", "type": "string" }, + "maxInstanceRequestConcurrency": { + "description": "Max Instance Request Conncurrency for Cloud Run service.", + "format": "int32", + "type": "integer" + }, "migrateDeploymentModel": { "description": "Indicate whether connector is being migrated to cloud run deployment model.", "type": "boolean" @@ -3339,6 +3344,16 @@ "description": "Output only. Eventing configuration supported by the Connector.", "readOnly": true }, + "isCustomActionsSupported": { + "description": "Output only. Is custom actions supported.", + "readOnly": true, + "type": "boolean" + }, + "isCustomEntitiesSupported": { + "description": "Output only. Is custom entities supported.", + "readOnly": true, + "type": "boolean" + }, "labels": { "additionalProperties": { "type": "string" @@ -3403,6 +3418,22 @@ "description": "Output only. Information about the runtime features supported by the Connector.", "readOnly": true }, + "supportedStandardActions": { + "description": "Output only. Supported standard actions.", + "items": { + "$ref": "StandardAction" + }, + "readOnly": true, + "type": "array" + }, + "supportedStandardEntities": { + "description": "Output only. Supported standard entities.", + "items": { + "$ref": "StandardEntity" + }, + "readOnly": true, + "type": "array" + }, "unsupportedConnectionTypes": { "description": "Output only. Unsupported connection types.", "items": { @@ -3462,13 +3493,15 @@ "DEPLOYMENT_MODEL_MIGRATION_STATE_UNSPECIFIED", "IN_PROGRESS", "COMPLETED", - "ROLLEDBACK" + "ROLLEDBACK", + "ROLLBACK_IN_PROGRESS" ], "enumDescriptions": [ "Deployment model migration state is not specified.", "Deployment model migration is in progress.", "Deployment model migration is completed.", - "Deployment model migration rolledback." + "Deployment model migration rolledback.", + "Deployment model migration rollback in progress." ], "readOnly": true, "type": "string" @@ -3484,6 +3517,12 @@ "readOnly": true, "type": "string" }, + "maxInstanceRequestConcurrency": { + "description": "Output only. Max instance request concurrency.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, "ratelimitThreshold": { "description": "Output only. Max QPS supported by the connector version before throttling of requests.", "format": "int64", @@ -7190,6 +7229,28 @@ }, "type": "object" }, + "StandardAction": { + "description": "Standard action", + "id": "StandardAction", + "properties": { + "name": { + "description": "Name of the standard action.", + "type": "string" + } + }, + "type": "object" + }, + "StandardEntity": { + "description": "Standard entity", + "id": "StandardEntity", + "properties": { + "name": { + "description": "Name of the standard entity.", + "type": "string" + } + }, + "type": "object" + }, "Status": { "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", "id": "Status", diff --git a/connectors/v1/connectors-gen.go b/connectors/v1/connectors-gen.go index f74bc4714f0..3ff31197752 100644 --- a/connectors/v1/connectors-gen.go +++ b/connectors/v1/connectors-gen.go @@ -1132,6 +1132,9 @@ type ConnectorInfraConfig struct { // InternalclientRatelimitThreshold: Max QPS supported for internal requests // originating from Connd. InternalclientRatelimitThreshold int64 `json:"internalclientRatelimitThreshold,omitempty,string"` + // MaxInstanceRequestConcurrency: Max Instance Request Conncurrency for Cloud + // Run service. + MaxInstanceRequestConcurrency int64 `json:"maxInstanceRequestConcurrency,omitempty"` // MigrateDeploymentModel: Indicate whether connector is being migrated to // cloud run deployment model. MigrateDeploymentModel bool `json:"migrateDeploymentModel,omitempty"` @@ -1189,6 +1192,10 @@ type ConnectorVersion struct { // EventingConfigTemplate: Output only. Eventing configuration supported by the // Connector. EventingConfigTemplate *EventingConfigTemplate `json:"eventingConfigTemplate,omitempty"` + // IsCustomActionsSupported: Output only. Is custom actions supported. + IsCustomActionsSupported bool `json:"isCustomActionsSupported,omitempty"` + // IsCustomEntitiesSupported: Output only. Is custom entities supported. + IsCustomEntitiesSupported bool `json:"isCustomEntitiesSupported,omitempty"` // Labels: Output only. Resource labels to represent user-provided metadata. // Refer to cloud documentation on labels for more details. // https://cloud.google.com/compute/docs/labeling-resources @@ -1225,6 +1232,10 @@ type ConnectorVersion struct { // SupportedRuntimeFeatures: Output only. Information about the runtime // features supported by the Connector. SupportedRuntimeFeatures *SupportedRuntimeFeatures `json:"supportedRuntimeFeatures,omitempty"` + // SupportedStandardActions: Output only. Supported standard actions. + SupportedStandardActions []*StandardAction `json:"supportedStandardActions,omitempty"` + // SupportedStandardEntities: Output only. Supported standard entities. + SupportedStandardEntities []*StandardEntity `json:"supportedStandardEntities,omitempty"` // UnsupportedConnectionTypes: Output only. Unsupported connection types. // // Possible values: @@ -1280,12 +1291,16 @@ type ConnectorVersionInfraConfig struct { // "IN_PROGRESS" - Deployment model migration is in progress. // "COMPLETED" - Deployment model migration is completed. // "ROLLEDBACK" - Deployment model migration rolledback. + // "ROLLBACK_IN_PROGRESS" - Deployment model migration rollback in progress. DeploymentModelMigrationState string `json:"deploymentModelMigrationState,omitempty"` // HpaConfig: Output only. HPA autoscaling config. HpaConfig *HPAConfig `json:"hpaConfig,omitempty"` // InternalclientRatelimitThreshold: Output only. Max QPS supported for // internal requests originating from Connd. InternalclientRatelimitThreshold int64 `json:"internalclientRatelimitThreshold,omitempty,string"` + // MaxInstanceRequestConcurrency: Output only. Max instance request + // concurrency. + MaxInstanceRequestConcurrency int64 `json:"maxInstanceRequestConcurrency,omitempty"` // RatelimitThreshold: Output only. Max QPS supported by the connector version // before throttling of requests. RatelimitThreshold int64 `json:"ratelimitThreshold,omitempty,string"` @@ -5012,6 +5027,50 @@ func (s SslConfigTemplate) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// StandardAction: Standard action +type StandardAction struct { + // Name: Name of the standard action. + Name string `json:"name,omitempty"` + // ForceSendFields is a list of field names (e.g. "Name") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Name") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s StandardAction) MarshalJSON() ([]byte, error) { + type NoMethod StandardAction + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// StandardEntity: Standard entity +type StandardEntity struct { + // Name: Name of the standard entity. + Name string `json:"name,omitempty"` + // ForceSendFields is a list of field names (e.g. "Name") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Name") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s StandardEntity) MarshalJSON() ([]byte, error) { + type NoMethod StandardEntity + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Status: The `Status` type defines a logical error model that is suitable for // different programming environments, including REST APIs and RPC APIs. It is // used by gRPC (https://github.com/grpc). Each `Status` message contains three diff --git a/connectors/v2/connectors-api.json b/connectors/v2/connectors-api.json index 298e7636f8e..080f2b678a2 100644 --- a/connectors/v2/connectors-api.json +++ b/connectors/v2/connectors-api.json @@ -660,7 +660,7 @@ } } }, - "revision": "20240708", + "revision": "20240729", "rootUrl": "https://connectors.googleapis.com/", "schemas": { "AccessCredentials": { @@ -724,6 +724,25 @@ }, "type": "object" }, + "AuthCodeData": { + "description": "AuthCodeData contains the data the runtime plane will give the connector backend in exchange for access and refresh tokens.", + "id": "AuthCodeData", + "properties": { + "authCode": { + "description": "OAuth authorization code.", + "type": "string" + }, + "pkceVerifier": { + "description": "OAuth PKCE verifier, needed if PKCE is enabled for this particular connection.", + "type": "string" + }, + "redirectUri": { + "description": "OAuth redirect URI passed in during the auth code flow, required by some OAuth backends.", + "type": "string" + } + }, + "type": "object" + }, "CheckReadinessResponse": { "description": "Response containing status of the connector for readiness prober.", "id": "CheckReadinessResponse", @@ -888,9 +907,14 @@ "type": "object" }, "ExchangeAuthCodeRequest": { - "description": "ExchangeAuthCodeRequest currently includes no fields.", + "description": "ExchangeAuthCodeRequest currently includes the auth code data.", "id": "ExchangeAuthCodeRequest", - "properties": {}, + "properties": { + "authCodeData": { + "$ref": "AuthCodeData", + "description": "Optional. AuthCodeData contains the data the runtime requires to exchange for access and refresh tokens. If the data is not provided, the runtime will read the data from the secret manager." + } + }, "type": "object" }, "ExchangeAuthCodeResponse": { @@ -2105,9 +2129,14 @@ "type": "object" }, "RefreshAccessTokenRequest": { - "description": "RefreshAccessTokenRequest currently includes no fields.", + "description": "RefreshAccessTokenRequest includes the refresh token.", "id": "RefreshAccessTokenRequest", - "properties": {}, + "properties": { + "refreshToken": { + "description": "Optional. Refresh Token String. If the Refresh Token is not provided, the runtime will read the data from the secret manager.", + "type": "string" + } + }, "type": "object" }, "RefreshAccessTokenResponse": { diff --git a/connectors/v2/connectors-gen.go b/connectors/v2/connectors-gen.go index 6a3f6d8db25..550eaa66093 100644 --- a/connectors/v2/connectors-gen.go +++ b/connectors/v2/connectors-gen.go @@ -288,6 +288,35 @@ func (s Action) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// AuthCodeData: AuthCodeData contains the data the runtime plane will give the +// connector backend in exchange for access and refresh tokens. +type AuthCodeData struct { + // AuthCode: OAuth authorization code. + AuthCode string `json:"authCode,omitempty"` + // PkceVerifier: OAuth PKCE verifier, needed if PKCE is enabled for this + // particular connection. + PkceVerifier string `json:"pkceVerifier,omitempty"` + // RedirectUri: OAuth redirect URI passed in during the auth code flow, + // required by some OAuth backends. + RedirectUri string `json:"redirectUri,omitempty"` + // ForceSendFields is a list of field names (e.g. "AuthCode") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AuthCode") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s AuthCodeData) MarshalJSON() ([]byte, error) { + type NoMethod AuthCodeData + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // CheckReadinessResponse: Response containing status of the connector for // readiness prober. type CheckReadinessResponse struct { @@ -529,9 +558,29 @@ func (s EntityType) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// ExchangeAuthCodeRequest: ExchangeAuthCodeRequest currently includes no -// fields. +// ExchangeAuthCodeRequest: ExchangeAuthCodeRequest currently includes the auth +// code data. type ExchangeAuthCodeRequest struct { + // AuthCodeData: Optional. AuthCodeData contains the data the runtime requires + // to exchange for access and refresh tokens. If the data is not provided, the + // runtime will read the data from the secret manager. + AuthCodeData *AuthCodeData `json:"authCodeData,omitempty"` + // ForceSendFields is a list of field names (e.g. "AuthCodeData") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AuthCodeData") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ExchangeAuthCodeRequest) MarshalJSON() ([]byte, error) { + type NoMethod ExchangeAuthCodeRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } // ExchangeAuthCodeResponse: ExchangeAuthCodeResponse includes the returned @@ -1533,9 +1582,28 @@ func (s Reference) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// RefreshAccessTokenRequest: RefreshAccessTokenRequest currently includes no -// fields. +// RefreshAccessTokenRequest: RefreshAccessTokenRequest includes the refresh +// token. type RefreshAccessTokenRequest struct { + // RefreshToken: Optional. Refresh Token String. If the Refresh Token is not + // provided, the runtime will read the data from the secret manager. + RefreshToken string `json:"refreshToken,omitempty"` + // ForceSendFields is a list of field names (e.g. "RefreshToken") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "RefreshToken") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s RefreshAccessTokenRequest) MarshalJSON() ([]byte, error) { + type NoMethod RefreshAccessTokenRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } // RefreshAccessTokenResponse: RefreshAccessTokenResponse includes the returned diff --git a/dataplex/v1/dataplex-api.json b/dataplex/v1/dataplex-api.json index 1cf7e4bef2a..e9bef2854f9 100644 --- a/dataplex/v1/dataplex-api.json +++ b/dataplex/v1/dataplex-api.json @@ -5599,7 +5599,7 @@ } } }, - "revision": "20240722", + "revision": "20240725", "rootUrl": "https://dataplex.googleapis.com/", "schemas": { "Empty": { @@ -8523,7 +8523,7 @@ "type": "string" }, "fullyQualifiedName": { - "description": "Optional. A name for the entry that can be referenced by an external system. The maximum size of the field is 4000 characters.", + "description": "Optional. A name for the entry that can be referenced by an external system. For more information, see Fully qualified names (https://cloud.google.com/data-catalog/docs/fully-qualified-names). The maximum size of the field is 4000 characters.", "type": "string" }, "name": { diff --git a/dataplex/v1/dataplex-gen.go b/dataplex/v1/dataplex-gen.go index d87a4dec42f..15f4ac713b2 100644 --- a/dataplex/v1/dataplex-gen.go +++ b/dataplex/v1/dataplex-gen.go @@ -4093,7 +4093,9 @@ type GoogleCloudDataplexV1Entry struct { // e_id}. EntryType string `json:"entryType,omitempty"` // FullyQualifiedName: Optional. A name for the entry that can be referenced by - // an external system. The maximum size of the field is 4000 characters. + // an external system. For more information, see Fully qualified names + // (https://cloud.google.com/data-catalog/docs/fully-qualified-names). The + // maximum size of the field is 4000 characters. FullyQualifiedName string `json:"fullyQualifiedName,omitempty"` // Name: Identifier. The relative resource name of the entry, in the format // projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_gr diff --git a/dialogflow/v3beta1/dialogflow-api.json b/dialogflow/v3beta1/dialogflow-api.json index 8cd49ff2119..0dd82ee73b3 100644 --- a/dialogflow/v3beta1/dialogflow-api.json +++ b/dialogflow/v3beta1/dialogflow-api.json @@ -1000,7 +1000,7 @@ ], "parameters": { "environment": { - "description": "Required. The environment to deploy the flow to. Format: `projects//locations//agents// environments/`.", + "description": "Required. The environment to deploy the flow to. Format: `projects//locations//agents//environments/`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agents/[^/]+/environments/[^/]+$", "required": true, @@ -1208,7 +1208,7 @@ "type": "string" }, "parent": { - "description": "Required. The environment to list results for. Format: `projects//locations//agents// environments/`.", + "description": "Required. The environment to list results for. Format: `projects//locations//agents//environments/`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agents/[^/]+/environments/[^/]+$", "required": true, @@ -1423,7 +1423,7 @@ ], "parameters": { "name": { - "description": "The name of the experiment. Format: projects//locations//agents//environments//experiments/..", + "description": "The name of the experiment. Format: projects//locations//agents//environments//experiments/.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agents/[^/]+/environments/[^/]+/experiments/[^/]+$", "required": true, @@ -2494,7 +2494,7 @@ ], "parameters": { "baseVersion": { - "description": "Required. Name of the base flow version to compare with the target version. Use version ID `0` to indicate the draft version of the specified flow. Format: `projects//locations//agents/ /flows//versions/`.", + "description": "Required. Name of the base flow version to compare with the target version. Use version ID `0` to indicate the draft version of the specified flow. Format: `projects//locations//agents//flows//versions/`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agents/[^/]+/flows/[^/]+/versions/[^/]+$", "required": true, @@ -3923,7 +3923,7 @@ ], "parameters": { "parent": { - "description": "Required. Agent name. Format: `projects//locations//agents/ `.", + "description": "Required. Agent name. Format: `projects//locations//agents/`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agents/[^/]+$", "required": true, @@ -4160,7 +4160,7 @@ ], "parameters": { "name": { - "description": "The unique identifier of the test case. TestCases.CreateTestCase will populate the name automatically. Otherwise use format: `projects//locations//agents/ /testCases/`.", + "description": "The unique identifier of the test case. TestCases.CreateTestCase will populate the name automatically. Otherwise use format: `projects//locations//agents//testCases/`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agents/[^/]+/testCases/[^/]+$", "required": true, @@ -4195,7 +4195,7 @@ ], "parameters": { "name": { - "description": "Required. Format of test case name to run: `projects//locations/ /agents//testCases/`.", + "description": "Required. Format of test case name to run: `projects//locations//agents//testCases/`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agents/[^/]+/testCases/[^/]+$", "required": true, @@ -4270,7 +4270,7 @@ "type": "string" }, "parent": { - "description": "Required. The test case to list results for. Format: `projects//locations//agents// testCases/`. Specify a `-` as a wildcard for TestCase ID to list results across multiple test cases.", + "description": "Required. The test case to list results for. Format: `projects//locations//agents//testCases/`. Specify a `-` as a wildcard for TestCase ID to list results across multiple test cases.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/agents/[^/]+/testCases/[^/]+$", "required": true, @@ -5185,7 +5185,7 @@ } } }, - "revision": "20240721", + "revision": "20240731", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AdvancedSettings": { @@ -5254,7 +5254,7 @@ "type": "boolean" }, "enableStackdriverLogging": { - "description": "Enables StackDriver logging.", + "description": "Enables Google Cloud Logging.", "type": "boolean" } }, @@ -5568,7 +5568,7 @@ "id": "GoogleCloudDialogflowCxV3DeployFlowResponse", "properties": { "deployment": { - "description": "The name of the flow version Deployment. Format: `projects//locations//agents// environments//deployments/`.", + "description": "The name of the flow version Deployment. Format: `projects//locations//agents//environments//deployments/`.", "type": "string" }, "environment": { @@ -5646,7 +5646,7 @@ "type": "boolean" }, "testCases": { - "description": "A list of test case names to run. They should be under the same agent. Format of each test case name: `projects//locations/ /agents//testCases/`", + "description": "A list of test case names to run. They should be under the same agent. Format of each test case name: `projects//locations//agents//testCases/`", "items": { "type": "string" }, @@ -6921,7 +6921,7 @@ "description": "The latest test result." }, "name": { - "description": "The unique identifier of the test case. TestCases.CreateTestCase will populate the name automatically. Otherwise use format: `projects//locations//agents/ /testCases/`.", + "description": "The unique identifier of the test case. TestCases.CreateTestCase will populate the name automatically. Otherwise use format: `projects//locations//agents//testCases/`.", "type": "string" }, "notes": { @@ -6980,7 +6980,7 @@ "type": "string" }, "name": { - "description": "The resource name for the test case result. Format: `projects//locations//agents//testCases/ /results/`.", + "description": "The resource name for the test case result. Format: `projects//locations//agents//testCases//results/`.", "type": "string" }, "testResult": { @@ -7679,7 +7679,7 @@ "type": "boolean" }, "enableStackdriverLogging": { - "description": "Enables StackDriver logging.", + "description": "Enables Google Cloud Logging.", "type": "boolean" } }, @@ -8000,7 +8000,7 @@ "id": "GoogleCloudDialogflowCxV3beta1BatchDeleteTestCasesRequest", "properties": { "names": { - "description": "Required. Format of test case names: `projects//locations/ /agents//testCases/`.", + "description": "Required. Format of test case names: `projects//locations//agents//testCases/`.", "items": { "type": "string" }, @@ -8911,7 +8911,7 @@ "id": "GoogleCloudDialogflowCxV3beta1DeployFlowRequest", "properties": { "flowVersion": { - "description": "Required. The flow version to deploy. Format: `projects//locations//agents// flows//versions/`.", + "description": "Required. The flow version to deploy. Format: `projects//locations//agents//flows//versions/`.", "type": "string" } }, @@ -8922,7 +8922,7 @@ "id": "GoogleCloudDialogflowCxV3beta1DeployFlowResponse", "properties": { "deployment": { - "description": "The name of the flow version deployment. Format: `projects//locations//agents// environments//deployments/`.", + "description": "The name of the flow version deployment. Format: `projects//locations//agents//environments//deployments/`.", "type": "string" }, "environment": { @@ -9222,7 +9222,7 @@ "type": "boolean" }, "testCases": { - "description": "A list of test case names to run. They should be under the same agent. Format of each test case name: `projects//locations/ /agents//testCases/`", + "description": "A list of test case names to run. They should be under the same agent. Format of each test case name: `projects//locations//agents//testCases/`", "items": { "type": "string" }, @@ -9412,7 +9412,7 @@ "type": "string" }, "name": { - "description": "The name of the experiment. Format: projects//locations//agents//environments//experiments/..", + "description": "The name of the experiment. Format: projects//locations//agents//environments//experiments/.", "type": "string" }, "result": { @@ -9960,6 +9960,10 @@ "$ref": "GoogleCloudDialogflowCxV3beta1KnowledgeConnectorSettings", "description": "Optional. Knowledge connector configuration." }, + "locked": { + "description": "Indicates whether the flow is locked for changes. If the flow is locked, modifications to the flow will be rejected.", + "type": "boolean" + }, "multiLanguageSettings": { "$ref": "GoogleCloudDialogflowCxV3beta1FlowMultiLanguageSettings", "description": "Optional. Multi-lingual agent settings for this flow." @@ -10021,7 +10025,7 @@ "id": "GoogleCloudDialogflowCxV3beta1FlowInvocation", "properties": { "flow": { - "description": "Required. The unique identifier of the flow. Format: `projects//locations//agents/`.", + "description": "Required. The unique identifier of the flow. Format: `projects//locations//agents//flows/`.", "type": "string" }, "flowState": { @@ -10827,6 +10831,35 @@ }, "type": "object" }, + "GoogleCloudDialogflowCxV3beta1InlineSchema": { + "description": "A type schema object that's specified inline.", + "id": "GoogleCloudDialogflowCxV3beta1InlineSchema", + "properties": { + "items": { + "$ref": "GoogleCloudDialogflowCxV3beta1TypeSchema", + "description": "Schema of the elements if this is an ARRAY type." + }, + "type": { + "description": "Data type of the schema.", + "enum": [ + "DATA_TYPE_UNSPECIFIED", + "STRING", + "NUMBER", + "BOOLEAN", + "ARRAY" + ], + "enumDescriptions": [ + "Not specified.", + "Represents any string value.", + "Represents any number value.", + "Represents a boolean value.", + "Represents a repeated value." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDialogflowCxV3beta1InlineSource": { "description": "Inline source for a Dialogflow operation that reads or imports objects (e.g. intents) into Dialogflow.", "id": "GoogleCloudDialogflowCxV3beta1InlineSource", @@ -11909,7 +11942,8 @@ "type": "string" }, "type": { - "description": "Required. Type of parameter.", + "deprecated": true, + "description": "Type of parameter.", "enum": [ "PARAMETER_TYPE_UNSPECIFIED", "STRING", @@ -11929,6 +11963,10 @@ "Represents a repeated value." ], "type": "string" + }, + "typeSchema": { + "$ref": "GoogleCloudDialogflowCxV3beta1TypeSchema", + "description": "Optional. Type schema of parameter." } }, "type": "object" @@ -13192,7 +13230,7 @@ "description": "The latest test result." }, "name": { - "description": "The unique identifier of the test case. TestCases.CreateTestCase will populate the name automatically. Otherwise use format: `projects//locations//agents/ /testCases/`.", + "description": "The unique identifier of the test case. TestCases.CreateTestCase will populate the name automatically. Otherwise use format: `projects//locations//agents//testCases/`.", "type": "string" }, "notes": { @@ -13251,7 +13289,7 @@ "type": "string" }, "name": { - "description": "The resource name for the test case result. Format: `projects//locations//agents//testCases/ /results/`.", + "description": "The resource name for the test case result. Format: `projects//locations//agents//testCases//results/`.", "type": "string" }, "testResult": { @@ -13656,7 +13694,7 @@ "id": "GoogleCloudDialogflowCxV3beta1ToolServiceDirectoryConfig", "properties": { "service": { - "description": "Required. The name of [Service Directory](https://cloud.google.com/service-directory) service. Format: `projects//locations//namespaces//services/`. `Location ID` of the service directory must be the same as the location of the agent.", + "description": "Required. The name of [Service Directory](https://cloud.google.com/service-directory) service. Format: `projects//locations//namespaces//services/`. `LocationID` of the service directory must be the same as the location of the agent.", "type": "string" } }, @@ -13975,6 +14013,36 @@ }, "type": "object" }, + "GoogleCloudDialogflowCxV3beta1TypeSchema": { + "description": "Encapsulates different type schema variations: either a reference to an a schema that's already defined by a tool, or an inline definition.", + "id": "GoogleCloudDialogflowCxV3beta1TypeSchema", + "properties": { + "inlineSchema": { + "$ref": "GoogleCloudDialogflowCxV3beta1InlineSchema", + "description": "Set if this is an inline schema definition." + }, + "schemaReference": { + "$ref": "GoogleCloudDialogflowCxV3beta1TypeSchemaSchemaReference", + "description": "Set if this is a schema reference." + } + }, + "type": "object" + }, + "GoogleCloudDialogflowCxV3beta1TypeSchemaSchemaReference": { + "description": "A reference to the schema of an existing tool.", + "id": "GoogleCloudDialogflowCxV3beta1TypeSchemaSchemaReference", + "properties": { + "schema": { + "description": "The name of the schema.", + "type": "string" + }, + "tool": { + "description": "The tool that contains this schema definition. Format: `projects//locations//agents//tools/`.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDialogflowCxV3beta1UpdateDocumentOperationMetadata": { "description": "Metadata for UpdateDocument operation.", "id": "GoogleCloudDialogflowCxV3beta1UpdateDocumentOperationMetadata", diff --git a/dialogflow/v3beta1/dialogflow-gen.go b/dialogflow/v3beta1/dialogflow-gen.go index c9f9d477b73..13e9e2d8838 100644 --- a/dialogflow/v3beta1/dialogflow-gen.go +++ b/dialogflow/v3beta1/dialogflow-gen.go @@ -624,7 +624,7 @@ type GoogleCloudDialogflowCxV3AdvancedSettingsLoggingSettings struct { EnableConsentBasedRedaction bool `json:"enableConsentBasedRedaction,omitempty"` // EnableInteractionLogging: Enables DF Interaction logging. EnableInteractionLogging bool `json:"enableInteractionLogging,omitempty"` - // EnableStackdriverLogging: Enables StackDriver logging. + // EnableStackdriverLogging: Enables Google Cloud Logging. EnableStackdriverLogging bool `json:"enableStackdriverLogging,omitempty"` // ForceSendFields is a list of field names (e.g. // "EnableConsentBasedRedaction") to unconditionally include in API requests. @@ -1093,7 +1093,7 @@ func (s GoogleCloudDialogflowCxV3DeployFlowMetadata) MarshalJSON() ([]byte, erro // Environments.DeployFlow. type GoogleCloudDialogflowCxV3DeployFlowResponse struct { // Deployment: The name of the flow version Deployment. Format: - // `projects//locations//agents// environments//deployments/`. + // `projects//locations//agents//environments//deployments/`. Deployment string `json:"deployment,omitempty"` // Environment: The updated environment where the flow is deployed. Environment *GoogleCloudDialogflowCxV3Environment `json:"environment,omitempty"` @@ -1197,8 +1197,8 @@ type GoogleCloudDialogflowCxV3EnvironmentTestCasesConfig struct { // environment. Default false. EnablePredeploymentRun bool `json:"enablePredeploymentRun,omitempty"` // TestCases: A list of test case names to run. They should be under the same - // agent. Format of each test case name: `projects//locations/ - // /agents//testCases/` + // agent. Format of each test case name: + // `projects//locations//agents//testCases/` TestCases []string `json:"testCases,omitempty"` // ForceSendFields is a list of field names (e.g. "EnableContinuousRun") to // unconditionally include in API requests. By default, fields with empty or @@ -3146,7 +3146,7 @@ type GoogleCloudDialogflowCxV3TestCase struct { LastTestResult *GoogleCloudDialogflowCxV3TestCaseResult `json:"lastTestResult,omitempty"` // Name: The unique identifier of the test case. TestCases.CreateTestCase will // populate the name automatically. Otherwise use format: - // `projects//locations//agents/ /testCases/`. + // `projects//locations//agents//testCases/`. Name string `json:"name,omitempty"` // Notes: Additional freeform notes about the test case. Limit of 400 // characters. @@ -3213,7 +3213,7 @@ type GoogleCloudDialogflowCxV3TestCaseResult struct { // the draft environment. Environment string `json:"environment,omitempty"` // Name: The resource name for the test case result. Format: - // `projects//locations//agents//testCases/ /results/`. + // `projects//locations//agents//testCases//results/`. Name string `json:"name,omitempty"` // TestResult: Whether the test case passed in the agent environment. // @@ -4101,7 +4101,7 @@ type GoogleCloudDialogflowCxV3beta1AdvancedSettingsLoggingSettings struct { EnableConsentBasedRedaction bool `json:"enableConsentBasedRedaction,omitempty"` // EnableInteractionLogging: Enables DF Interaction logging. EnableInteractionLogging bool `json:"enableInteractionLogging,omitempty"` - // EnableStackdriverLogging: Enables StackDriver logging. + // EnableStackdriverLogging: Enables Google Cloud Logging. EnableStackdriverLogging bool `json:"enableStackdriverLogging,omitempty"` // ForceSendFields is a list of field names (e.g. // "EnableConsentBasedRedaction") to unconditionally include in API requests. @@ -4580,8 +4580,8 @@ func (s GoogleCloudDialogflowCxV3beta1BargeInConfig) MarshalJSON() ([]byte, erro // GoogleCloudDialogflowCxV3beta1BatchDeleteTestCasesRequest: The request // message for TestCases.BatchDeleteTestCases. type GoogleCloudDialogflowCxV3beta1BatchDeleteTestCasesRequest struct { - // Names: Required. Format of test case names: `projects//locations/ - // /agents//testCases/`. + // Names: Required. Format of test case names: + // `projects//locations//agents//testCases/`. Names []string `json:"names,omitempty"` // ForceSendFields is a list of field names (e.g. "Names") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -5755,7 +5755,7 @@ func (s GoogleCloudDialogflowCxV3beta1DeployFlowMetadata) MarshalJSON() ([]byte, // Environments.DeployFlow. type GoogleCloudDialogflowCxV3beta1DeployFlowRequest struct { // FlowVersion: Required. The flow version to deploy. Format: - // `projects//locations//agents// flows//versions/`. + // `projects//locations//agents//flows//versions/`. FlowVersion string `json:"flowVersion,omitempty"` // ForceSendFields is a list of field names (e.g. "FlowVersion") to // unconditionally include in API requests. By default, fields with empty or @@ -5779,7 +5779,7 @@ func (s GoogleCloudDialogflowCxV3beta1DeployFlowRequest) MarshalJSON() ([]byte, // Environments.DeployFlow. type GoogleCloudDialogflowCxV3beta1DeployFlowResponse struct { // Deployment: The name of the flow version deployment. Format: - // `projects//locations//agents// environments//deployments/`. + // `projects//locations//agents//environments//deployments/`. Deployment string `json:"deployment,omitempty"` // Environment: The updated environment where the flow is deployed. Environment *GoogleCloudDialogflowCxV3beta1Environment `json:"environment,omitempty"` @@ -6194,8 +6194,8 @@ type GoogleCloudDialogflowCxV3beta1EnvironmentTestCasesConfig struct { // environment. Default false. EnablePredeploymentRun bool `json:"enablePredeploymentRun,omitempty"` // TestCases: A list of test case names to run. They should be under the same - // agent. Format of each test case name: `projects//locations/ - // /agents//testCases/` + // agent. Format of each test case name: + // `projects//locations//agents//testCases/` TestCases []string `json:"testCases,omitempty"` // ForceSendFields is a list of field names (e.g. "EnableContinuousRun") to // unconditionally include in API requests. By default, fields with empty or @@ -6412,7 +6412,7 @@ type GoogleCloudDialogflowCxV3beta1Experiment struct { // LastUpdateTime: Last update time of this experiment. LastUpdateTime string `json:"lastUpdateTime,omitempty"` // Name: The name of the experiment. Format: - // projects//locations//agents//environments//experiments/.. + // projects//locations//agents//environments//experiments/. Name string `json:"name,omitempty"` // Result: Inference result of the experiment. Result *GoogleCloudDialogflowCxV3beta1ExperimentResult `json:"result,omitempty"` @@ -7168,6 +7168,9 @@ type GoogleCloudDialogflowCxV3beta1Flow struct { EventHandlers []*GoogleCloudDialogflowCxV3beta1EventHandler `json:"eventHandlers,omitempty"` // KnowledgeConnectorSettings: Optional. Knowledge connector configuration. KnowledgeConnectorSettings *GoogleCloudDialogflowCxV3beta1KnowledgeConnectorSettings `json:"knowledgeConnectorSettings,omitempty"` + // Locked: Indicates whether the flow is locked for changes. If the flow is + // locked, modifications to the flow will be rejected. + Locked bool `json:"locked,omitempty"` // MultiLanguageSettings: Optional. Multi-lingual agent settings for this flow. MultiLanguageSettings *GoogleCloudDialogflowCxV3beta1FlowMultiLanguageSettings `json:"multiLanguageSettings,omitempty"` // Name: The unique identifier of the flow. Format: @@ -7257,7 +7260,7 @@ func (s GoogleCloudDialogflowCxV3beta1FlowImportStrategy) MarshalJSON() ([]byte, // invocation of a CX flow. Next Id: 7 type GoogleCloudDialogflowCxV3beta1FlowInvocation struct { // Flow: Required. The unique identifier of the flow. Format: - // `projects//locations//agents/`. + // `projects//locations//agents//flows/`. Flow string `json:"flow,omitempty"` // FlowState: Required. Flow invocation's output state. // @@ -8426,6 +8429,38 @@ func (s GoogleCloudDialogflowCxV3beta1InlineDestination) MarshalJSON() ([]byte, return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDialogflowCxV3beta1InlineSchema: A type schema object that's +// specified inline. +type GoogleCloudDialogflowCxV3beta1InlineSchema struct { + // Items: Schema of the elements if this is an ARRAY type. + Items *GoogleCloudDialogflowCxV3beta1TypeSchema `json:"items,omitempty"` + // Type: Data type of the schema. + // + // Possible values: + // "DATA_TYPE_UNSPECIFIED" - Not specified. + // "STRING" - Represents any string value. + // "NUMBER" - Represents any number value. + // "BOOLEAN" - Represents a boolean value. + // "ARRAY" - Represents a repeated value. + Type string `json:"type,omitempty"` + // ForceSendFields is a list of field names (e.g. "Items") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Items") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDialogflowCxV3beta1InlineSchema) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3beta1InlineSchema + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDialogflowCxV3beta1InlineSource: Inline source for a Dialogflow // operation that reads or imports objects (e.g. intents) into Dialogflow. type GoogleCloudDialogflowCxV3beta1InlineSource struct { @@ -10124,7 +10159,7 @@ type GoogleCloudDialogflowCxV3beta1ParameterDefinition struct { Description string `json:"description,omitempty"` // Name: Required. Name of parameter. Name string `json:"name,omitempty"` - // Type: Required. Type of parameter. + // Type: Type of parameter. // // Possible values: // "PARAMETER_TYPE_UNSPECIFIED" - Not specified. No validation will be @@ -10136,6 +10171,8 @@ type GoogleCloudDialogflowCxV3beta1ParameterDefinition struct { // "OBJECT" - Represents any object value. // "LIST" - Represents a repeated value. Type string `json:"type,omitempty"` + // TypeSchema: Optional. Type schema of parameter. + TypeSchema *GoogleCloudDialogflowCxV3beta1TypeSchema `json:"typeSchema,omitempty"` // ForceSendFields is a list of field names (e.g. "Description") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -11866,7 +11903,7 @@ type GoogleCloudDialogflowCxV3beta1TestCase struct { LastTestResult *GoogleCloudDialogflowCxV3beta1TestCaseResult `json:"lastTestResult,omitempty"` // Name: The unique identifier of the test case. TestCases.CreateTestCase will // populate the name automatically. Otherwise use format: - // `projects//locations//agents/ /testCases/`. + // `projects//locations//agents//testCases/`. Name string `json:"name,omitempty"` // Notes: Additional freeform notes about the test case. Limit of 400 // characters. @@ -11937,7 +11974,7 @@ type GoogleCloudDialogflowCxV3beta1TestCaseResult struct { // the draft environment. Environment string `json:"environment,omitempty"` // Name: The resource name for the test case result. Format: - // `projects//locations//agents//testCases/ /results/`. + // `projects//locations//agents//testCases//results/`. Name string `json:"name,omitempty"` // TestResult: Whether the test case passed in the agent environment. // @@ -12471,7 +12508,7 @@ func (s GoogleCloudDialogflowCxV3beta1ToolOpenApiTool) MarshalJSON() ([]byte, er type GoogleCloudDialogflowCxV3beta1ToolServiceDirectoryConfig struct { // Service: Required. The name of Service Directory // (https://cloud.google.com/service-directory) service. Format: - // `projects//locations//namespaces//services/`. `Location ID` of the service + // `projects//locations//namespaces//services/`. `LocationID` of the service // directory must be the same as the location of the agent. Service string `json:"service,omitempty"` // ForceSendFields is a list of field names (e.g. "Service") to unconditionally @@ -12956,6 +12993,58 @@ func (s *GoogleCloudDialogflowCxV3beta1TurnSignals) UnmarshalJSON(data []byte) e return nil } +// GoogleCloudDialogflowCxV3beta1TypeSchema: Encapsulates different type schema +// variations: either a reference to an a schema that's already defined by a +// tool, or an inline definition. +type GoogleCloudDialogflowCxV3beta1TypeSchema struct { + // InlineSchema: Set if this is an inline schema definition. + InlineSchema *GoogleCloudDialogflowCxV3beta1InlineSchema `json:"inlineSchema,omitempty"` + // SchemaReference: Set if this is a schema reference. + SchemaReference *GoogleCloudDialogflowCxV3beta1TypeSchemaSchemaReference `json:"schemaReference,omitempty"` + // ForceSendFields is a list of field names (e.g. "InlineSchema") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "InlineSchema") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDialogflowCxV3beta1TypeSchema) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3beta1TypeSchema + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowCxV3beta1TypeSchemaSchemaReference: A reference to the +// schema of an existing tool. +type GoogleCloudDialogflowCxV3beta1TypeSchemaSchemaReference struct { + // Schema: The name of the schema. + Schema string `json:"schema,omitempty"` + // Tool: The tool that contains this schema definition. Format: + // `projects//locations//agents//tools/`. + Tool string `json:"tool,omitempty"` + // ForceSendFields is a list of field names (e.g. "Schema") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Schema") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDialogflowCxV3beta1TypeSchemaSchemaReference) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3beta1TypeSchemaSchemaReference + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDialogflowCxV3beta1UpdateDocumentOperationMetadata: Metadata for // UpdateDocument operation. type GoogleCloudDialogflowCxV3beta1UpdateDocumentOperationMetadata struct { @@ -24067,7 +24156,7 @@ type ProjectsLocationsAgentsEnvironmentsDeployFlowCall struct { // `metadata`: DeployFlowMetadata - `response`: DeployFlowResponse // // - environment: The environment to deploy the flow to. Format: -// `projects//locations//agents// environments/`. +// `projects//locations//agents//environments/`. func (r *ProjectsLocationsAgentsEnvironmentsService) DeployFlow(environment string, googleclouddialogflowcxv3beta1deployflowrequest *GoogleCloudDialogflowCxV3beta1DeployFlowRequest) *ProjectsLocationsAgentsEnvironmentsDeployFlowCall { c := &ProjectsLocationsAgentsEnvironmentsDeployFlowCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.environment = environment @@ -24792,7 +24881,7 @@ type ProjectsLocationsAgentsEnvironmentsContinuousTestResultsListCall struct { // List: Fetches a list of continuous test results for a given environment. // // - parent: The environment to list results for. Format: -// `projects//locations//agents// environments/`. +// `projects//locations//agents//environments/`. func (r *ProjectsLocationsAgentsEnvironmentsContinuousTestResultsService) List(parent string) *ProjectsLocationsAgentsEnvironmentsContinuousTestResultsListCall { c := &ProjectsLocationsAgentsEnvironmentsContinuousTestResultsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -25642,7 +25731,7 @@ type ProjectsLocationsAgentsEnvironmentsExperimentsPatchCall struct { // Patch: Updates the specified Experiment. // // - name: The name of the experiment. Format: -// projects//locations//agents//environments//experiments/.. +// projects//locations//agents//environments//experiments/. func (r *ProjectsLocationsAgentsEnvironmentsExperimentsService) Patch(name string, googleclouddialogflowcxv3beta1experiment *GoogleCloudDialogflowCxV3beta1Experiment) *ProjectsLocationsAgentsEnvironmentsExperimentsPatchCall { c := &ProjectsLocationsAgentsEnvironmentsExperimentsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -29491,7 +29580,7 @@ type ProjectsLocationsAgentsFlowsVersionsCompareVersionsCall struct { // // - baseVersion: Name of the base flow version to compare with the target // version. Use version ID `0` to indicate the draft version of the specified -// flow. Format: `projects//locations//agents/ /flows//versions/`. +// flow. Format: `projects//locations//agents//flows//versions/`. func (r *ProjectsLocationsAgentsFlowsVersionsService) CompareVersions(baseVersion string, googleclouddialogflowcxv3beta1compareversionsrequest *GoogleCloudDialogflowCxV3beta1CompareVersionsRequest) *ProjectsLocationsAgentsFlowsVersionsCompareVersionsCall { c := &ProjectsLocationsAgentsFlowsVersionsCompareVersionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.baseVersion = baseVersion @@ -34554,7 +34643,7 @@ type ProjectsLocationsAgentsTestCasesBatchRunCall struct { // `metadata`: BatchRunTestCasesMetadata - `response`: // BatchRunTestCasesResponse // -// - parent: Agent name. Format: `projects//locations//agents/ `. +// - parent: Agent name. Format: `projects//locations//agents/`. func (r *ProjectsLocationsAgentsTestCasesService) BatchRun(parent string, googleclouddialogflowcxv3beta1batchruntestcasesrequest *GoogleCloudDialogflowCxV3beta1BatchRunTestCasesRequest) *ProjectsLocationsAgentsTestCasesBatchRunCall { c := &ProjectsLocationsAgentsTestCasesBatchRunCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -35375,7 +35464,7 @@ type ProjectsLocationsAgentsTestCasesPatchCall struct { // // - name: The unique identifier of the test case. TestCases.CreateTestCase // will populate the name automatically. Otherwise use format: -// `projects//locations//agents/ /testCases/`. +// `projects//locations//agents//testCases/`. func (r *ProjectsLocationsAgentsTestCasesService) Patch(nameid string, googleclouddialogflowcxv3beta1testcase *GoogleCloudDialogflowCxV3beta1TestCase) *ProjectsLocationsAgentsTestCasesPatchCall { c := &ProjectsLocationsAgentsTestCasesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.nameid = nameid @@ -35488,8 +35577,8 @@ type ProjectsLocationsAgentsTestCasesRunCall struct { // The returned `Operation` type has the following method-specific fields: - // `metadata`: RunTestCaseMetadata - `response`: RunTestCaseResponse // -// - name: Format of test case name to run: `projects//locations/ -// /agents//testCases/`. +// - name: Format of test case name to run: +// `projects//locations//agents//testCases/`. func (r *ProjectsLocationsAgentsTestCasesService) Run(name string, googleclouddialogflowcxv3beta1runtestcaserequest *GoogleCloudDialogflowCxV3beta1RunTestCaseRequest) *ProjectsLocationsAgentsTestCasesRunCall { c := &ProjectsLocationsAgentsTestCasesRunCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -35702,8 +35791,8 @@ type ProjectsLocationsAgentsTestCasesResultsListCall struct { // 100 results are kept for each test case. // // - parent: The test case to list results for. Format: -// `projects//locations//agents// testCases/`. Specify a `-` as a wildcard -// for TestCase ID to list results across multiple test cases. +// `projects//locations//agents//testCases/`. Specify a `-` as a wildcard for +// TestCase ID to list results across multiple test cases. func (r *ProjectsLocationsAgentsTestCasesResultsService) List(parent string) *ProjectsLocationsAgentsTestCasesResultsListCall { c := &ProjectsLocationsAgentsTestCasesResultsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent diff --git a/dlp/v2/dlp-api.json b/dlp/v2/dlp-api.json index 036af5d8803..38994d2ccbe 100644 --- a/dlp/v2/dlp-api.json +++ b/dlp/v2/dlp-api.json @@ -907,7 +907,7 @@ "type": "string" }, "parent": { - "description": "Required. Resource name of the organization or project, for example `organizations/433245324/locations/europe` or `projects/project-id/locations/asia`.", + "description": "Required. Resource name of the organization or project, for example, `organizations/433245324/locations/europe` or `projects/project-id/locations/asia`.", "location": "path", "pattern": "^organizations/[^/]+/locations/[^/]+$", "required": true, @@ -976,7 +976,7 @@ "type": "string" }, "parent": { - "description": "Required. Resource name of the organization or project with a wildcard location, for example `organizations/433245324/locations/-` or `projects/project-id/locations/-`.", + "description": "Required. Resource name of the organization or project with a wildcard location, for example, `organizations/433245324/locations/-` or `projects/project-id/locations/-`.", "location": "path", "pattern": "^organizations/[^/]+/locations/[^/]+$", "required": true, @@ -3290,7 +3290,7 @@ "type": "string" }, "parent": { - "description": "Required. Resource name of the organization or project, for example `organizations/433245324/locations/europe` or `projects/project-id/locations/asia`.", + "description": "Required. Resource name of the organization or project, for example, `organizations/433245324/locations/europe` or `projects/project-id/locations/asia`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -3359,7 +3359,7 @@ "type": "string" }, "parent": { - "description": "Required. Resource name of the organization or project with a wildcard location, for example `organizations/433245324/locations/-` or `projects/project-id/locations/-`.", + "description": "Required. Resource name of the organization or project with a wildcard location, for example, `organizations/433245324/locations/-` or `projects/project-id/locations/-`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -5015,7 +5015,7 @@ } } }, - "revision": "20240721", + "revision": "20240805", "rootUrl": "https://dlp.googleapis.com/", "schemas": { "GooglePrivacyDlpV2Action": { @@ -7539,7 +7539,7 @@ "description": "Governs when to update data profiles when the inspection rules defined by the `InspectTemplate` change. If not set, changing the template will not cause a data profile to update." }, "refreshFrequency": { - "description": "Frequency to update profiles regardless of whether the underlying resource has changed. Defaults to never.", + "description": "Frequency at which profiles should be updated, regardless of whether the underlying resource has changed. Defaults to never.", "enum": [ "UPDATE_FREQUENCY_UNSPECIFIED", "UPDATE_FREQUENCY_NEVER", @@ -7633,7 +7633,7 @@ "id": "GooglePrivacyDlpV2DiscoveryStartingLocation", "properties": { "folderId": { - "description": "The ID of the folder within an organization to scan.", + "description": "The ID of the folder within an organization to be scanned.", "format": "int64", "type": "string" }, diff --git a/dlp/v2/dlp-gen.go b/dlp/v2/dlp-gen.go index a3410f7efe4..09341ec9e22 100644 --- a/dlp/v2/dlp-gen.go +++ b/dlp/v2/dlp-gen.go @@ -4179,8 +4179,8 @@ type GooglePrivacyDlpV2DiscoveryGenerationCadence struct { // the inspection rules defined by the `InspectTemplate` change. If not set, // changing the template will not cause a data profile to update. InspectTemplateModifiedCadence *GooglePrivacyDlpV2DiscoveryInspectTemplateModifiedCadence `json:"inspectTemplateModifiedCadence,omitempty"` - // RefreshFrequency: Frequency to update profiles regardless of whether the - // underlying resource has changed. Defaults to never. + // RefreshFrequency: Frequency at which profiles should be updated, regardless + // of whether the underlying resource has changed. Defaults to never. // // Possible values: // "UPDATE_FREQUENCY_UNSPECIFIED" - Unspecified. @@ -4298,7 +4298,7 @@ func (s GooglePrivacyDlpV2DiscoverySchemaModifiedCadence) MarshalJSON() ([]byte, // discovery scan. Denotes an organization ID or folder ID within an // organization. type GooglePrivacyDlpV2DiscoveryStartingLocation struct { - // FolderId: The ID of the folder within an organization to scan. + // FolderId: The ID of the folder within an organization to be scanned. FolderId int64 `json:"folderId,omitempty,string"` // OrganizationId: The ID of an organization to scan. OrganizationId int64 `json:"organizationId,omitempty,string"` @@ -12482,7 +12482,7 @@ type OrganizationsLocationsConnectionsListCall struct { // List: Lists Connections in a parent. Use SearchConnections to see all // connections within an organization. // -// - parent: Resource name of the organization or project, for example +// - parent: Resource name of the organization or project, for example, // `organizations/433245324/locations/europe` or // `projects/project-id/locations/asia`. func (r *OrganizationsLocationsConnectionsService) List(parent string) *OrganizationsLocationsConnectionsListCall { @@ -12739,7 +12739,7 @@ type OrganizationsLocationsConnectionsSearchCall struct { // Search: Searches for Connections in a parent. // // - parent: Resource name of the organization or project with a wildcard -// location, for example `organizations/433245324/locations/-` or +// location, for example, `organizations/433245324/locations/-` or // `projects/project-id/locations/-`. func (r *OrganizationsLocationsConnectionsService) Search(parent string) *OrganizationsLocationsConnectionsSearchCall { c := &OrganizationsLocationsConnectionsSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -21506,7 +21506,7 @@ type ProjectsLocationsConnectionsListCall struct { // List: Lists Connections in a parent. Use SearchConnections to see all // connections within an organization. // -// - parent: Resource name of the organization or project, for example +// - parent: Resource name of the organization or project, for example, // `organizations/433245324/locations/europe` or // `projects/project-id/locations/asia`. func (r *ProjectsLocationsConnectionsService) List(parent string) *ProjectsLocationsConnectionsListCall { @@ -21763,7 +21763,7 @@ type ProjectsLocationsConnectionsSearchCall struct { // Search: Searches for Connections in a parent. // // - parent: Resource name of the organization or project with a wildcard -// location, for example `organizations/433245324/locations/-` or +// location, for example, `organizations/433245324/locations/-` or // `projects/project-id/locations/-`. func (r *ProjectsLocationsConnectionsService) Search(parent string) *ProjectsLocationsConnectionsSearchCall { c := &ProjectsLocationsConnectionsSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} diff --git a/docs/v1/docs-api.json b/docs/v1/docs-api.json index 55a86a4f913..3035a2b40e8 100644 --- a/docs/v1/docs-api.json +++ b/docs/v1/docs-api.json @@ -221,7 +221,7 @@ } } }, - "revision": "20240726", + "revision": "20240730", "rootUrl": "https://docs.googleapis.com/", "schemas": { "AutoText": { @@ -811,7 +811,7 @@ "properties": { "body": { "$ref": "Body", - "description": "Output only. The main body of the document." + "description": "Output only. The main body of the document. Legacy field: Instead, use Document.tabs.documentTab.body, which exposes the actual document content from all tabs when the includeTabsContent parameter is set to `true`. If `false` or unset, this field contains information about the first tab in the document." }, "documentId": { "description": "Output only. The ID of the document.", @@ -819,59 +819,59 @@ }, "documentStyle": { "$ref": "DocumentStyle", - "description": "Output only. The style of the document." + "description": "Output only. The style of the document. Legacy field: Instead, use Document.tabs.documentTab.documentStyle, which exposes the actual document content from all tabs when the includeTabsContent parameter is set to `true`. If `false` or unset, this field contains information about the first tab in the document." }, "footers": { "additionalProperties": { "$ref": "Footer" }, - "description": "Output only. The footers in the document, keyed by footer ID.", + "description": "Output only. The footers in the document, keyed by footer ID. Legacy field: Instead, use Document.tabs.documentTab.footers, which exposes the actual document content from all tabs when the includeTabsContent parameter is set to `true`. If `false` or unset, this field contains information about the first tab in the document.", "type": "object" }, "footnotes": { "additionalProperties": { "$ref": "Footnote" }, - "description": "Output only. The footnotes in the document, keyed by footnote ID.", + "description": "Output only. The footnotes in the document, keyed by footnote ID. Legacy field: Instead, use Document.tabs.documentTab.footnotes, which exposes the actual document content from all tabs when the includeTabsContent parameter is set to `true`. If `false` or unset, this field contains information about the first tab in the document.", "type": "object" }, "headers": { "additionalProperties": { "$ref": "Header" }, - "description": "Output only. The headers in the document, keyed by header ID.", + "description": "Output only. The headers in the document, keyed by header ID. Legacy field: Instead, use Document.tabs.documentTab.headers, which exposes the actual document content from all tabs when the includeTabsContent parameter is set to `true`. If `false` or unset, this field contains information about the first tab in the document.", "type": "object" }, "inlineObjects": { "additionalProperties": { "$ref": "InlineObject" }, - "description": "Output only. The inline objects in the document, keyed by object ID.", + "description": "Output only. The inline objects in the document, keyed by object ID. Legacy field: Instead, use Document.tabs.documentTab.inlineObjects, which exposes the actual document content from all tabs when the includeTabsContent parameter is set to `true`. If `false` or unset, this field contains information about the first tab in the document.", "type": "object" }, "lists": { "additionalProperties": { "$ref": "List" }, - "description": "Output only. The lists in the document, keyed by list ID.", + "description": "Output only. The lists in the document, keyed by list ID. Legacy field: Instead, use Document.tabs.documentTab.lists, which exposes the actual document content from all tabs when the includeTabsContent parameter is set to `true`. If `false` or unset, this field contains information about the first tab in the document.", "type": "object" }, "namedRanges": { "additionalProperties": { "$ref": "NamedRanges" }, - "description": "Output only. The named ranges in the document, keyed by name.", + "description": "Output only. The named ranges in the document, keyed by name. Legacy field: Instead, use Document.tabs.documentTab.namedRanges, which exposes the actual document content from all tabs when the includeTabsContent parameter is set to `true`. If `false` or unset, this field contains information about the first tab in the document.", "type": "object" }, "namedStyles": { "$ref": "NamedStyles", - "description": "Output only. The named styles of the document." + "description": "Output only. The named styles of the document. Legacy field: Instead, use Document.tabs.documentTab.namedStyles, which exposes the actual document content from all tabs when the includeTabsContent parameter is set to `true`. If `false` or unset, this field contains information about the first tab in the document." }, "positionedObjects": { "additionalProperties": { "$ref": "PositionedObject" }, - "description": "Output only. The positioned objects in the document, keyed by object ID.", + "description": "Output only. The positioned objects in the document, keyed by object ID. Legacy field: Instead, use Document.tabs.documentTab.positionedObjects, which exposes the actual document content from all tabs when the includeTabsContent parameter is set to `true`. If `false` or unset, this field contains information about the first tab in the document.", "type": "object" }, "revisionId": { @@ -882,14 +882,14 @@ "additionalProperties": { "$ref": "SuggestedDocumentStyle" }, - "description": "Output only. The suggested changes to the style of the document, keyed by suggestion ID.", + "description": "Output only. The suggested changes to the style of the document, keyed by suggestion ID. Legacy field: Instead, use Document.tabs.documentTab.suggestedDocumentStyleChanges, which exposes the actual document content from all tabs when the includeTabsContent parameter is set to `true`. If `false` or unset, this field contains information about the first tab in the document.", "type": "object" }, "suggestedNamedStylesChanges": { "additionalProperties": { "$ref": "SuggestedNamedStyles" }, - "description": "Output only. The suggested changes to the named styles of the document, keyed by suggestion ID.", + "description": "Output only. The suggested changes to the named styles of the document, keyed by suggestion ID. Legacy field: Instead, use Document.tabs.documentTab.suggestedNamedStylesChanges, which exposes the actual document content from all tabs when the includeTabsContent parameter is set to `true`. If `false` or unset, this field contains information about the first tab in the document.", "type": "object" }, "suggestionsViewMode": { @@ -909,7 +909,7 @@ "type": "string" }, "tabs": { - "description": "Tabs that are part of a document. Tabs can contain child tabs, a tab nested within another tab. Child tabs are represented by the Tab.child_tabs field.", + "description": "Tabs that are part of a document. Tabs can contain child tabs, a tab nested within another tab. Child tabs are represented by the Tab.childTabs field.", "items": { "$ref": "Tab" }, @@ -1862,18 +1862,18 @@ "properties": { "bookmark": { "$ref": "BookmarkLink", - "description": "A bookmark in this document. In documents containing a single tab, links to bookmarks within the singular tab continue to return Link.bookmark_id when the includeTabsContent parameter is set to `false` or unset. Otherwise, this field is returned." + "description": "A bookmark in this document. In documents containing a single tab, links to bookmarks within the singular tab continue to return Link.bookmarkId when the includeTabsContent parameter is set to `false` or unset. Otherwise, this field is returned." }, "bookmarkId": { - "description": "The ID of a bookmark in this document.", + "description": "The ID of a bookmark in this document. Legacy field: Instead, set includeTabsContent to `true` and use Link.bookmark for read and write operations. This field is only returned when includeTabsContent is set to `false` in documents containing a single tab and links to a bookmark within the singular tab. Otherwise, Link.bookmark is returned. If this field is used in a write request, the bookmark is considered to be from the tab ID specified in the request. If a tab ID is not specified in the request, it is considered to be from the first tab in the document.", "type": "string" }, "heading": { "$ref": "HeadingLink", - "description": "A heading in this document. In documents containing a single tab, links to headings within the singular tab continue to return Link.heading_id when the includeTabsContent parameter is set to `false` or unset. Otherwise, this field is returned." + "description": "A heading in this document. In documents containing a single tab, links to headings within the singular tab continue to return Link.headingId when the includeTabsContent parameter is set to `false` or unset. Otherwise, this field is returned." }, "headingId": { - "description": "The ID of a heading in this document.", + "description": "The ID of a heading in this document. Legacy field: Instead, set includeTabsContent to `true` and use Link.heading for read and write operations. This field is only returned when includeTabsContent is set to `false` in documents containing a single tab and links to a heading within the singular tab. Otherwise, Link.heading is returned. If this field is used in a write request, the heading is considered to be from the tab ID specified in the request. If a tab ID is not specified in the request, it is considered to be from the first tab in the document.", "type": "string" }, "tabId": { @@ -3738,7 +3738,7 @@ "id": "TabProperties", "properties": { "index": { - "description": "The index of the tab within the parent.", + "description": "The zero-based index of the tab within the parent.", "format": "int32", "type": "integer" }, diff --git a/docs/v1/docs-gen.go b/docs/v1/docs-gen.go index fde6e26b721..8759d86ceb7 100644 --- a/docs/v1/docs-gen.go +++ b/docs/v1/docs-gen.go @@ -1164,29 +1164,69 @@ func (s *Dimension) UnmarshalJSON(data []byte) error { // Document: A Google Docs document. type Document struct { - // Body: Output only. The main body of the document. + // Body: Output only. The main body of the document. Legacy field: Instead, use + // Document.tabs.documentTab.body, which exposes the actual document content + // from all tabs when the includeTabsContent parameter is set to `true`. If + // `false` or unset, this field contains information about the first tab in the + // document. Body *Body `json:"body,omitempty"` // DocumentId: Output only. The ID of the document. DocumentId string `json:"documentId,omitempty"` - // DocumentStyle: Output only. The style of the document. + // DocumentStyle: Output only. The style of the document. Legacy field: + // Instead, use Document.tabs.documentTab.documentStyle, which exposes the + // actual document content from all tabs when the includeTabsContent parameter + // is set to `true`. If `false` or unset, this field contains information about + // the first tab in the document. DocumentStyle *DocumentStyle `json:"documentStyle,omitempty"` // Footers: Output only. The footers in the document, keyed by footer ID. + // Legacy field: Instead, use Document.tabs.documentTab.footers, which exposes + // the actual document content from all tabs when the includeTabsContent + // parameter is set to `true`. If `false` or unset, this field contains + // information about the first tab in the document. Footers map[string]Footer `json:"footers,omitempty"` // Footnotes: Output only. The footnotes in the document, keyed by footnote ID. + // Legacy field: Instead, use Document.tabs.documentTab.footnotes, which + // exposes the actual document content from all tabs when the + // includeTabsContent parameter is set to `true`. If `false` or unset, this + // field contains information about the first tab in the document. Footnotes map[string]Footnote `json:"footnotes,omitempty"` // Headers: Output only. The headers in the document, keyed by header ID. + // Legacy field: Instead, use Document.tabs.documentTab.headers, which exposes + // the actual document content from all tabs when the includeTabsContent + // parameter is set to `true`. If `false` or unset, this field contains + // information about the first tab in the document. Headers map[string]Header `json:"headers,omitempty"` // InlineObjects: Output only. The inline objects in the document, keyed by - // object ID. + // object ID. Legacy field: Instead, use + // Document.tabs.documentTab.inlineObjects, which exposes the actual document + // content from all tabs when the includeTabsContent parameter is set to + // `true`. If `false` or unset, this field contains information about the first + // tab in the document. InlineObjects map[string]InlineObject `json:"inlineObjects,omitempty"` - // Lists: Output only. The lists in the document, keyed by list ID. + // Lists: Output only. The lists in the document, keyed by list ID. Legacy + // field: Instead, use Document.tabs.documentTab.lists, which exposes the + // actual document content from all tabs when the includeTabsContent parameter + // is set to `true`. If `false` or unset, this field contains information about + // the first tab in the document. Lists map[string]List `json:"lists,omitempty"` // NamedRanges: Output only. The named ranges in the document, keyed by name. + // Legacy field: Instead, use Document.tabs.documentTab.namedRanges, which + // exposes the actual document content from all tabs when the + // includeTabsContent parameter is set to `true`. If `false` or unset, this + // field contains information about the first tab in the document. NamedRanges map[string]NamedRanges `json:"namedRanges,omitempty"` - // NamedStyles: Output only. The named styles of the document. + // NamedStyles: Output only. The named styles of the document. Legacy field: + // Instead, use Document.tabs.documentTab.namedStyles, which exposes the actual + // document content from all tabs when the includeTabsContent parameter is set + // to `true`. If `false` or unset, this field contains information about the + // first tab in the document. NamedStyles *NamedStyles `json:"namedStyles,omitempty"` // PositionedObjects: Output only. The positioned objects in the document, - // keyed by object ID. + // keyed by object ID. Legacy field: Instead, use + // Document.tabs.documentTab.positionedObjects, which exposes the actual + // document content from all tabs when the includeTabsContent parameter is set + // to `true`. If `false` or unset, this field contains information about the + // first tab in the document. PositionedObjects map[string]PositionedObject `json:"positionedObjects,omitempty"` // RevisionId: Output only. The revision ID of the document. Can be used in // update requests to specify which revision of a document to apply updates to @@ -1201,10 +1241,18 @@ type Document struct { // can also be due to internal factors such as ID format changes. RevisionId string `json:"revisionId,omitempty"` // SuggestedDocumentStyleChanges: Output only. The suggested changes to the - // style of the document, keyed by suggestion ID. + // style of the document, keyed by suggestion ID. Legacy field: Instead, use + // Document.tabs.documentTab.suggestedDocumentStyleChanges, which exposes the + // actual document content from all tabs when the includeTabsContent parameter + // is set to `true`. If `false` or unset, this field contains information about + // the first tab in the document. SuggestedDocumentStyleChanges map[string]SuggestedDocumentStyle `json:"suggestedDocumentStyleChanges,omitempty"` // SuggestedNamedStylesChanges: Output only. The suggested changes to the named - // styles of the document, keyed by suggestion ID. + // styles of the document, keyed by suggestion ID. Legacy field: Instead, use + // Document.tabs.documentTab.suggestedNamedStylesChanges, which exposes the + // actual document content from all tabs when the includeTabsContent parameter + // is set to `true`. If `false` or unset, this field contains information about + // the first tab in the document. SuggestedNamedStylesChanges map[string]SuggestedNamedStyles `json:"suggestedNamedStylesChanges,omitempty"` // SuggestionsViewMode: Output only. The suggestions view mode applied to the // document. Note: When editing a document, changes must be based on a document @@ -1227,7 +1275,7 @@ type Document struct { // all suggested changes rejected if there are any suggestions in the document. SuggestionsViewMode string `json:"suggestionsViewMode,omitempty"` // Tabs: Tabs that are part of a document. Tabs can contain child tabs, a tab - // nested within another tab. Child tabs are represented by the Tab.child_tabs + // nested within another tab. Child tabs are represented by the Tab.childTabs // field. Tabs []*Tab `json:"tabs,omitempty"` // Title: The title of the document. @@ -2411,17 +2459,31 @@ func (s InsertTextRequest) MarshalJSON() ([]byte, error) { type Link struct { // Bookmark: A bookmark in this document. In documents containing a single tab, // links to bookmarks within the singular tab continue to return - // Link.bookmark_id when the includeTabsContent parameter is set to `false` or + // Link.bookmarkId when the includeTabsContent parameter is set to `false` or // unset. Otherwise, this field is returned. Bookmark *BookmarkLink `json:"bookmark,omitempty"` - // BookmarkId: The ID of a bookmark in this document. + // BookmarkId: The ID of a bookmark in this document. Legacy field: Instead, + // set includeTabsContent to `true` and use Link.bookmark for read and write + // operations. This field is only returned when includeTabsContent is set to + // `false` in documents containing a single tab and links to a bookmark within + // the singular tab. Otherwise, Link.bookmark is returned. If this field is + // used in a write request, the bookmark is considered to be from the tab ID + // specified in the request. If a tab ID is not specified in the request, it is + // considered to be from the first tab in the document. BookmarkId string `json:"bookmarkId,omitempty"` // Heading: A heading in this document. In documents containing a single tab, - // links to headings within the singular tab continue to return Link.heading_id + // links to headings within the singular tab continue to return Link.headingId // when the includeTabsContent parameter is set to `false` or unset. Otherwise, // this field is returned. Heading *HeadingLink `json:"heading,omitempty"` - // HeadingId: The ID of a heading in this document. + // HeadingId: The ID of a heading in this document. Legacy field: Instead, set + // includeTabsContent to `true` and use Link.heading for read and write + // operations. This field is only returned when includeTabsContent is set to + // `false` in documents containing a single tab and links to a heading within + // the singular tab. Otherwise, Link.heading is returned. If this field is used + // in a write request, the heading is considered to be from the tab ID + // specified in the request. If a tab ID is not specified in the request, it is + // considered to be from the first tab in the document. HeadingId string `json:"headingId,omitempty"` // TabId: The ID of a tab in this document. TabId string `json:"tabId,omitempty"` @@ -4830,7 +4892,7 @@ func (s Tab) MarshalJSON() ([]byte, error) { // TabProperties: Properties of a tab. type TabProperties struct { - // Index: The index of the tab within the parent. + // Index: The zero-based index of the tab within the parent. Index int64 `json:"index,omitempty"` // NestingLevel: Output only. The depth of the tab within the document. // Root-level tabs start at 0. diff --git a/domains/v1/domains-api.json b/domains/v1/domains-api.json index aab00b42f26..2963e762e40 100644 --- a/domains/v1/domains-api.json +++ b/domains/v1/domains-api.json @@ -965,7 +965,7 @@ } } }, - "revision": "20240610", + "revision": "20240724", "rootUrl": "https://domains.googleapis.com/", "schemas": { "AuditConfig": { @@ -1545,6 +1545,13 @@ "description": "HealthCheckTargets describes endpoints to health-check when responding to Routing Policy queries. Only the healthy endpoints will be included in the response.", "id": "HealthCheckTargets", "properties": { + "externalEndpoints": { + "description": "The Internet IP addresses to be health checked. The format matches the format of ResourceRecordSet.rrdata as defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1)", + "items": { + "type": "string" + }, + "type": "array" + }, "internalLoadBalancer": { "description": "Configuration for internal load balancers to be health checked.", "items": { @@ -2020,6 +2027,10 @@ "$ref": "GeoPolicy", "deprecated": true }, + "healthCheck": { + "description": "The selfLink attribute of the HealthCheck resource to use for this RRSetRoutingPolicy. https://cloud.google.com/compute/docs/reference/rest/v1/healthChecks", + "type": "string" + }, "primaryBackup": { "$ref": "PrimaryBackupPolicy" }, diff --git a/domains/v1/domains-gen.go b/domains/v1/domains-gen.go index 8efe969e366..9c529cbe23f 100644 --- a/domains/v1/domains-gen.go +++ b/domains/v1/domains-gen.go @@ -1037,18 +1037,22 @@ func (s GoogleDomainsDns) MarshalJSON() ([]byte, error) { // when responding to Routing Policy queries. Only the healthy endpoints will // be included in the response. type HealthCheckTargets struct { + // ExternalEndpoints: The Internet IP addresses to be health checked. The + // format matches the format of ResourceRecordSet.rrdata as defined in RFC 1035 + // (section 5) and RFC 1034 (section 3.6.1) + ExternalEndpoints []string `json:"externalEndpoints,omitempty"` // InternalLoadBalancer: Configuration for internal load balancers to be health // checked. InternalLoadBalancer []*LoadBalancerTarget `json:"internalLoadBalancer,omitempty"` - // ForceSendFields is a list of field names (e.g. "InternalLoadBalancer") to + // ForceSendFields is a list of field names (e.g. "ExternalEndpoints") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "InternalLoadBalancer") to include - // in API requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. See + // NullFields is a list of field names (e.g. "ExternalEndpoints") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -1730,8 +1734,12 @@ func (s *PrimaryBackupPolicy) UnmarshalJSON(data []byte) error { // that is returned dynamically with the response varying based on configured // properties such as geolocation or by weighted random selection. type RRSetRoutingPolicy struct { - Geo *GeoPolicy `json:"geo,omitempty"` - GeoPolicy *GeoPolicy `json:"geoPolicy,omitempty"` + Geo *GeoPolicy `json:"geo,omitempty"` + GeoPolicy *GeoPolicy `json:"geoPolicy,omitempty"` + // HealthCheck: The selfLink attribute of the HealthCheck resource to use for + // this RRSetRoutingPolicy. + // https://cloud.google.com/compute/docs/reference/rest/v1/healthChecks + HealthCheck string `json:"healthCheck,omitempty"` PrimaryBackup *PrimaryBackupPolicy `json:"primaryBackup,omitempty"` Wrr *WrrPolicy `json:"wrr,omitempty"` WrrPolicy *WrrPolicy `json:"wrrPolicy,omitempty"` diff --git a/domains/v1alpha2/domains-api.json b/domains/v1alpha2/domains-api.json index 47d28a368f0..58c87055b98 100644 --- a/domains/v1alpha2/domains-api.json +++ b/domains/v1alpha2/domains-api.json @@ -965,7 +965,7 @@ } } }, - "revision": "20240610", + "revision": "20240724", "rootUrl": "https://domains.googleapis.com/", "schemas": { "AuditConfig": { @@ -1545,6 +1545,13 @@ "description": "HealthCheckTargets describes endpoints to health-check when responding to Routing Policy queries. Only the healthy endpoints will be included in the response.", "id": "HealthCheckTargets", "properties": { + "externalEndpoints": { + "description": "The Internet IP addresses to be health checked. The format matches the format of ResourceRecordSet.rrdata as defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1)", + "items": { + "type": "string" + }, + "type": "array" + }, "internalLoadBalancer": { "description": "Configuration for internal load balancers to be health checked.", "items": { @@ -2020,6 +2027,10 @@ "$ref": "GeoPolicy", "deprecated": true }, + "healthCheck": { + "description": "The selfLink attribute of the HealthCheck resource to use for this RRSetRoutingPolicy. https://cloud.google.com/compute/docs/reference/rest/v1/healthChecks", + "type": "string" + }, "primaryBackup": { "$ref": "PrimaryBackupPolicy" }, diff --git a/domains/v1alpha2/domains-gen.go b/domains/v1alpha2/domains-gen.go index 1a4eae9dd9b..88e4228ba20 100644 --- a/domains/v1alpha2/domains-gen.go +++ b/domains/v1alpha2/domains-gen.go @@ -1037,18 +1037,22 @@ func (s GoogleDomainsDns) MarshalJSON() ([]byte, error) { // when responding to Routing Policy queries. Only the healthy endpoints will // be included in the response. type HealthCheckTargets struct { + // ExternalEndpoints: The Internet IP addresses to be health checked. The + // format matches the format of ResourceRecordSet.rrdata as defined in RFC 1035 + // (section 5) and RFC 1034 (section 3.6.1) + ExternalEndpoints []string `json:"externalEndpoints,omitempty"` // InternalLoadBalancer: Configuration for internal load balancers to be health // checked. InternalLoadBalancer []*LoadBalancerTarget `json:"internalLoadBalancer,omitempty"` - // ForceSendFields is a list of field names (e.g. "InternalLoadBalancer") to + // ForceSendFields is a list of field names (e.g. "ExternalEndpoints") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "InternalLoadBalancer") to include - // in API requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. See + // NullFields is a list of field names (e.g. "ExternalEndpoints") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -1730,8 +1734,12 @@ func (s *PrimaryBackupPolicy) UnmarshalJSON(data []byte) error { // that is returned dynamically with the response varying based on configured // properties such as geolocation or by weighted random selection. type RRSetRoutingPolicy struct { - Geo *GeoPolicy `json:"geo,omitempty"` - GeoPolicy *GeoPolicy `json:"geoPolicy,omitempty"` + Geo *GeoPolicy `json:"geo,omitempty"` + GeoPolicy *GeoPolicy `json:"geoPolicy,omitempty"` + // HealthCheck: The selfLink attribute of the HealthCheck resource to use for + // this RRSetRoutingPolicy. + // https://cloud.google.com/compute/docs/reference/rest/v1/healthChecks + HealthCheck string `json:"healthCheck,omitempty"` PrimaryBackup *PrimaryBackupPolicy `json:"primaryBackup,omitempty"` Wrr *WrrPolicy `json:"wrr,omitempty"` WrrPolicy *WrrPolicy `json:"wrrPolicy,omitempty"` diff --git a/domains/v1beta1/domains-api.json b/domains/v1beta1/domains-api.json index 4b23d8b5ad7..583f4100062 100644 --- a/domains/v1beta1/domains-api.json +++ b/domains/v1beta1/domains-api.json @@ -965,7 +965,7 @@ } } }, - "revision": "20240610", + "revision": "20240724", "rootUrl": "https://domains.googleapis.com/", "schemas": { "AuditConfig": { @@ -1545,6 +1545,13 @@ "description": "HealthCheckTargets describes endpoints to health-check when responding to Routing Policy queries. Only the healthy endpoints will be included in the response.", "id": "HealthCheckTargets", "properties": { + "externalEndpoints": { + "description": "The Internet IP addresses to be health checked. The format matches the format of ResourceRecordSet.rrdata as defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1)", + "items": { + "type": "string" + }, + "type": "array" + }, "internalLoadBalancer": { "description": "Configuration for internal load balancers to be health checked.", "items": { @@ -2020,6 +2027,10 @@ "$ref": "GeoPolicy", "deprecated": true }, + "healthCheck": { + "description": "The selfLink attribute of the HealthCheck resource to use for this RRSetRoutingPolicy. https://cloud.google.com/compute/docs/reference/rest/v1/healthChecks", + "type": "string" + }, "primaryBackup": { "$ref": "PrimaryBackupPolicy" }, diff --git a/domains/v1beta1/domains-gen.go b/domains/v1beta1/domains-gen.go index eeb36c06916..d09085e69a0 100644 --- a/domains/v1beta1/domains-gen.go +++ b/domains/v1beta1/domains-gen.go @@ -1037,18 +1037,22 @@ func (s GoogleDomainsDns) MarshalJSON() ([]byte, error) { // when responding to Routing Policy queries. Only the healthy endpoints will // be included in the response. type HealthCheckTargets struct { + // ExternalEndpoints: The Internet IP addresses to be health checked. The + // format matches the format of ResourceRecordSet.rrdata as defined in RFC 1035 + // (section 5) and RFC 1034 (section 3.6.1) + ExternalEndpoints []string `json:"externalEndpoints,omitempty"` // InternalLoadBalancer: Configuration for internal load balancers to be health // checked. InternalLoadBalancer []*LoadBalancerTarget `json:"internalLoadBalancer,omitempty"` - // ForceSendFields is a list of field names (e.g. "InternalLoadBalancer") to + // ForceSendFields is a list of field names (e.g. "ExternalEndpoints") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "InternalLoadBalancer") to include - // in API requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. See + // NullFields is a list of field names (e.g. "ExternalEndpoints") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -1730,8 +1734,12 @@ func (s *PrimaryBackupPolicy) UnmarshalJSON(data []byte) error { // that is returned dynamically with the response varying based on configured // properties such as geolocation or by weighted random selection. type RRSetRoutingPolicy struct { - Geo *GeoPolicy `json:"geo,omitempty"` - GeoPolicy *GeoPolicy `json:"geoPolicy,omitempty"` + Geo *GeoPolicy `json:"geo,omitempty"` + GeoPolicy *GeoPolicy `json:"geoPolicy,omitempty"` + // HealthCheck: The selfLink attribute of the HealthCheck resource to use for + // this RRSetRoutingPolicy. + // https://cloud.google.com/compute/docs/reference/rest/v1/healthChecks + HealthCheck string `json:"healthCheck,omitempty"` PrimaryBackup *PrimaryBackupPolicy `json:"primaryBackup,omitempty"` Wrr *WrrPolicy `json:"wrr,omitempty"` WrrPolicy *WrrPolicy `json:"wrrPolicy,omitempty"` diff --git a/drive/v2/drive-api.json b/drive/v2/drive-api.json index ebade29affb..d4542a7873e 100644 --- a/drive/v2/drive-api.json +++ b/drive/v2/drive-api.json @@ -3869,7 +3869,7 @@ } } }, - "revision": "20240722", + "revision": "20240730", "rootUrl": "https://www.googleapis.com/", "schemas": { "About": { @@ -5659,7 +5659,7 @@ "type": "object" }, "thumbnailLink": { - "description": "Output only. A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content. If the file isn't shared publicly, the URL returned in `Files.thumbnailLink` must be fetched using a credentialed request.", + "description": "Output only. A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Not intended for direct usage on web applications due to [Cross-Origin Resource Sharing (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS), consider using a proxy server. Only populated when the requesting app can access the file's content. If the file isn't shared publicly, the URL returned in `Files.thumbnailLink` must be fetched using a credentialed request.", "type": "string" }, "thumbnailVersion": { diff --git a/drive/v2/drive-gen.go b/drive/v2/drive-gen.go index 6bb8eafad40..8ed6e50e3fb 100644 --- a/drive/v2/drive-gen.go +++ b/drive/v2/drive-gen.go @@ -1797,10 +1797,12 @@ type File struct { // thumbnail cannot be generated. Thumbnail *FileThumbnail `json:"thumbnail,omitempty"` // ThumbnailLink: Output only. A short-lived link to the file's thumbnail, if - // available. Typically lasts on the order of hours. Only populated when the - // requesting app can access the file's content. If the file isn't shared - // publicly, the URL returned in `Files.thumbnailLink` must be fetched using a - // credentialed request. + // available. Typically lasts on the order of hours. Not intended for direct + // usage on web applications due to Cross-Origin Resource Sharing (CORS) + // (https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS), consider using a + // proxy server. Only populated when the requesting app can access the file's + // content. If the file isn't shared publicly, the URL returned in + // `Files.thumbnailLink` must be fetched using a credentialed request. ThumbnailLink string `json:"thumbnailLink,omitempty"` // ThumbnailVersion: Output only. The thumbnail version for use in thumbnail // cache invalidation. diff --git a/drive/v3/drive-api.json b/drive/v3/drive-api.json index 91a2518e34c..609829fe586 100644 --- a/drive/v3/drive-api.json +++ b/drive/v3/drive-api.json @@ -2523,7 +2523,7 @@ } } }, - "revision": "20240722", + "revision": "20240730", "rootUrl": "https://www.googleapis.com/", "schemas": { "About": { @@ -3890,7 +3890,7 @@ "type": "string" }, "thumbnailLink": { - "description": "Output only. A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content. If the file isn't shared publicly, the URL returned in `Files.thumbnailLink` must be fetched using a credentialed request.", + "description": "Output only. A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Not intended for direct usage on web applications due to [Cross-Origin Resource Sharing (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) policies, consider using a proxy server. Only populated when the requesting app can access the file's content. If the file isn't shared publicly, the URL returned in `Files.thumbnailLink` must be fetched using a credentialed request.", "type": "string" }, "thumbnailVersion": { diff --git a/drive/v3/drive-gen.go b/drive/v3/drive-gen.go index c3c0b48de37..3f4042bf8a1 100644 --- a/drive/v3/drive-gen.go +++ b/drive/v3/drive-gen.go @@ -1381,10 +1381,12 @@ type File struct { // TeamDriveId: Deprecated: Output only. Use `driveId` instead. TeamDriveId string `json:"teamDriveId,omitempty"` // ThumbnailLink: Output only. A short-lived link to the file's thumbnail, if - // available. Typically lasts on the order of hours. Only populated when the - // requesting app can access the file's content. If the file isn't shared - // publicly, the URL returned in `Files.thumbnailLink` must be fetched using a - // credentialed request. + // available. Typically lasts on the order of hours. Not intended for direct + // usage on web applications due to Cross-Origin Resource Sharing (CORS) + // (https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) policies, consider + // using a proxy server. Only populated when the requesting app can access the + // file's content. If the file isn't shared publicly, the URL returned in + // `Files.thumbnailLink` must be fetched using a credentialed request. ThumbnailLink string `json:"thumbnailLink,omitempty"` // ThumbnailVersion: Output only. The thumbnail version for use in thumbnail // cache invalidation. diff --git a/firebaseml/v2beta/firebaseml-api.json b/firebaseml/v2beta/firebaseml-api.json index 8d64dce2743..20a4890141d 100644 --- a/firebaseml/v2beta/firebaseml-api.json +++ b/firebaseml/v2beta/firebaseml-api.json @@ -206,7 +206,7 @@ } } }, - "revision": "20240730", + "revision": "20240802", "rootUrl": "https://firebaseml.googleapis.com/", "schemas": { "Date": { @@ -503,7 +503,7 @@ ], "enumDescriptions": [ "Unspecified function calling mode. This value should not be used.", - "Default model behavior, model decides to predict either a function call or a natural language repspose.", + "Default model behavior, model decides to predict either a function call or a natural language response.", "Model is constrained to always predicting a function call only. If \"allowed_function_names\" are set, the predicted function call will be limited to any one of \"allowed_function_names\", else the predicted function call will be any one of the provided \"function_declarations\".", "Model will not predict any function call. Model behavior is same as when not passing any function declarations." ], @@ -671,7 +671,7 @@ "type": "integer" }, "promptTokenCount": { - "description": "Number of tokens in the request.", + "description": "Number of tokens in the request. When `cached_content` is set, this is still the total effective prompt size meaning this includes the number of tokens in the cached content.", "format": "int32", "type": "integer" }, diff --git a/firebaseml/v2beta/firebaseml-gen.go b/firebaseml/v2beta/firebaseml-gen.go index 46ddce5dc60..6503768c7ad 100644 --- a/firebaseml/v2beta/firebaseml-gen.go +++ b/firebaseml/v2beta/firebaseml-gen.go @@ -558,7 +558,7 @@ type GoogleCloudAiplatformV1beta1FunctionCallingConfig struct { // "MODE_UNSPECIFIED" - Unspecified function calling mode. This value should // not be used. // "AUTO" - Default model behavior, model decides to predict either a - // function call or a natural language repspose. + // function call or a natural language response. // "ANY" - Model is constrained to always predicting a function call only. If // "allowed_function_names" are set, the predicted function call will be // limited to any one of "allowed_function_names", else the predicted function @@ -780,7 +780,9 @@ func (s GoogleCloudAiplatformV1beta1GenerateContentResponsePromptFeedback) Marsh type GoogleCloudAiplatformV1beta1GenerateContentResponseUsageMetadata struct { // CandidatesTokenCount: Number of tokens in the response(s). CandidatesTokenCount int64 `json:"candidatesTokenCount,omitempty"` - // PromptTokenCount: Number of tokens in the request. + // PromptTokenCount: Number of tokens in the request. When `cached_content` is + // set, this is still the total effective prompt size meaning this includes the + // number of tokens in the cached content. PromptTokenCount int64 `json:"promptTokenCount,omitempty"` TotalTokenCount int64 `json:"totalTokenCount,omitempty"` // ForceSendFields is a list of field names (e.g. "CandidatesTokenCount") to diff --git a/gkehub/v1/gkehub-api.json b/gkehub/v1/gkehub-api.json index 8b0d7b88b57..95f38398cf2 100644 --- a/gkehub/v1/gkehub-api.json +++ b/gkehub/v1/gkehub-api.json @@ -315,6 +315,11 @@ "pattern": "^projects/[^/]+/locations/[^/]+/features/[^/]+$", "required": true, "type": "string" + }, + "returnPartialSuccess": { + "description": "Optional. If set to true, the response will return partial results when some regions are unreachable and the unreachable field in Feature proto will be populated. If set to false, the request will fail when some regions are unreachable.", + "location": "query", + "type": "boolean" } }, "path": "v1/{+name}", @@ -392,6 +397,11 @@ "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "type": "string" + }, + "returnPartialSuccess": { + "description": "Optional. If set to true, the response will return partial results when some regions are unreachable and the unreachable field in Feature proto will be populated. If set to false, the request will fail when some regions are unreachable.", + "location": "query", + "type": "boolean" } }, "path": "v1/{+parent}/features", @@ -2101,7 +2111,7 @@ } } }, - "revision": "20240706", + "revision": "20240727", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AppDevExperienceFeatureSpec": { @@ -3200,7 +3210,7 @@ }, "policyController": { "$ref": "ConfigManagementPolicyController", - "description": "Policy Controller configuration for the cluster." + "description": "Policy Controller configuration for the cluster. Deprecated: Configuring Policy Controller through the configmanagement feature is no longer recommended. Use the policycontroller feature instead." }, "version": { "description": "Version of ACM installed.", @@ -3672,6 +3682,14 @@ "description": "Output only. The Hub-wide Feature state.", "readOnly": true }, + "unreachable": { + "description": "Output only. List of locations that could not be reached while fetching this feature.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, "updateTime": { "description": "Output only. When the Feature resource was last updated.", "format": "google-datetime", diff --git a/gkehub/v1/gkehub-gen.go b/gkehub/v1/gkehub-gen.go index 47f8e33cbe7..50024af0dc1 100644 --- a/gkehub/v1/gkehub-gen.go +++ b/gkehub/v1/gkehub-gen.go @@ -1644,6 +1644,8 @@ type ConfigManagementMembershipSpec struct { // cluster. Management string `json:"management,omitempty"` // PolicyController: Policy Controller configuration for the cluster. + // Deprecated: Configuring Policy Controller through the configmanagement + // feature is no longer recommended. Use the policycontroller feature instead. PolicyController *ConfigManagementPolicyController `json:"policyController,omitempty"` // Version: Version of ACM installed. Version string `json:"version,omitempty"` @@ -2220,6 +2222,9 @@ type Feature struct { Spec *CommonFeatureSpec `json:"spec,omitempty"` // State: Output only. The Hub-wide Feature state. State *CommonFeatureState `json:"state,omitempty"` + // Unreachable: Output only. List of locations that could not be reached while + // fetching this feature. + Unreachable []string `json:"unreachable,omitempty"` // UpdateTime: Output only. When the Feature resource was last updated. UpdateTime string `json:"updateTime,omitempty"` @@ -6324,6 +6329,15 @@ func (r *ProjectsLocationsFeaturesService) Get(name string) *ProjectsLocationsFe return c } +// ReturnPartialSuccess sets the optional parameter "returnPartialSuccess": If +// set to true, the response will return partial results when some regions are +// unreachable and the unreachable field in Feature proto will be populated. If +// set to false, the request will fail when some regions are unreachable. +func (c *ProjectsLocationsFeaturesGetCall) ReturnPartialSuccess(returnPartialSuccess bool) *ProjectsLocationsFeaturesGetCall { + c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -6594,6 +6608,15 @@ func (c *ProjectsLocationsFeaturesListCall) PageToken(pageToken string) *Project return c } +// ReturnPartialSuccess sets the optional parameter "returnPartialSuccess": If +// set to true, the response will return partial results when some regions are +// unreachable and the unreachable field in Feature proto will be populated. If +// set to false, the request will fail when some regions are unreachable. +func (c *ProjectsLocationsFeaturesListCall) ReturnPartialSuccess(returnPartialSuccess bool) *ProjectsLocationsFeaturesListCall { + c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. diff --git a/gkehub/v1alpha/gkehub-api.json b/gkehub/v1alpha/gkehub-api.json index d208d6e972b..e0663e2dbc7 100644 --- a/gkehub/v1alpha/gkehub-api.json +++ b/gkehub/v1alpha/gkehub-api.json @@ -315,6 +315,11 @@ "pattern": "^projects/[^/]+/locations/[^/]+/features/[^/]+$", "required": true, "type": "string" + }, + "returnPartialSuccess": { + "description": "Optional. If set to true, the response will return partial results when some regions are unreachable and the unreachable field in Feature proto will be populated. If set to false, the request will fail when some regions are unreachable.", + "location": "query", + "type": "boolean" } }, "path": "v1alpha/{+name}", @@ -392,6 +397,11 @@ "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "type": "string" + }, + "returnPartialSuccess": { + "description": "Optional. If set to true, the response will return partial results when some regions are unreachable and the unreachable field in Feature proto will be populated. If set to false, the request will fail when some regions are unreachable.", + "location": "query", + "type": "boolean" } }, "path": "v1alpha/{+parent}/features", @@ -2175,7 +2185,7 @@ } } }, - "revision": "20240706", + "revision": "20240727", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AnthosObservabilityFeatureSpec": { @@ -3480,7 +3490,7 @@ }, "policyController": { "$ref": "ConfigManagementPolicyController", - "description": "Policy Controller configuration for the cluster." + "description": "Policy Controller configuration for the cluster. Deprecated: Configuring Policy Controller through the configmanagement feature is no longer recommended. Use the policycontroller feature instead." }, "version": { "description": "Version of ACM installed.", @@ -3956,6 +3966,14 @@ "description": "Output only. The Hub-wide Feature state.", "readOnly": true }, + "unreachable": { + "description": "Output only. List of locations that could not be reached while fetching this feature.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, "updateTime": { "description": "Output only. When the Feature resource was last updated.", "format": "google-datetime", diff --git a/gkehub/v1alpha/gkehub-gen.go b/gkehub/v1alpha/gkehub-gen.go index ad86ac7ff30..312db926445 100644 --- a/gkehub/v1alpha/gkehub-gen.go +++ b/gkehub/v1alpha/gkehub-gen.go @@ -1914,6 +1914,8 @@ type ConfigManagementMembershipSpec struct { // cluster. Management string `json:"management,omitempty"` // PolicyController: Policy Controller configuration for the cluster. + // Deprecated: Configuring Policy Controller through the configmanagement + // feature is no longer recommended. Use the policycontroller feature instead. PolicyController *ConfigManagementPolicyController `json:"policyController,omitempty"` // Version: Version of ACM installed. Version string `json:"version,omitempty"` @@ -2492,6 +2494,9 @@ type Feature struct { Spec *CommonFeatureSpec `json:"spec,omitempty"` // State: Output only. The Hub-wide Feature state. State *CommonFeatureState `json:"state,omitempty"` + // Unreachable: Output only. List of locations that could not be reached while + // fetching this feature. + Unreachable []string `json:"unreachable,omitempty"` // UpdateTime: Output only. When the Feature resource was last updated. UpdateTime string `json:"updateTime,omitempty"` @@ -7063,6 +7068,15 @@ func (r *ProjectsLocationsFeaturesService) Get(name string) *ProjectsLocationsFe return c } +// ReturnPartialSuccess sets the optional parameter "returnPartialSuccess": If +// set to true, the response will return partial results when some regions are +// unreachable and the unreachable field in Feature proto will be populated. If +// set to false, the request will fail when some regions are unreachable. +func (c *ProjectsLocationsFeaturesGetCall) ReturnPartialSuccess(returnPartialSuccess bool) *ProjectsLocationsFeaturesGetCall { + c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -7333,6 +7347,15 @@ func (c *ProjectsLocationsFeaturesListCall) PageToken(pageToken string) *Project return c } +// ReturnPartialSuccess sets the optional parameter "returnPartialSuccess": If +// set to true, the response will return partial results when some regions are +// unreachable and the unreachable field in Feature proto will be populated. If +// set to false, the request will fail when some regions are unreachable. +func (c *ProjectsLocationsFeaturesListCall) ReturnPartialSuccess(returnPartialSuccess bool) *ProjectsLocationsFeaturesListCall { + c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. diff --git a/gkehub/v1beta/gkehub-api.json b/gkehub/v1beta/gkehub-api.json index bb72401480a..28959f8014d 100644 --- a/gkehub/v1beta/gkehub-api.json +++ b/gkehub/v1beta/gkehub-api.json @@ -315,6 +315,11 @@ "pattern": "^projects/[^/]+/locations/[^/]+/features/[^/]+$", "required": true, "type": "string" + }, + "returnPartialSuccess": { + "description": "Optional. If set to true, the response will return partial results when some regions are unreachable and the unreachable field in Feature proto will be populated. If set to false, the request will fail when some regions are unreachable.", + "location": "query", + "type": "boolean" } }, "path": "v1beta/{+name}", @@ -392,6 +397,11 @@ "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "type": "string" + }, + "returnPartialSuccess": { + "description": "Optional. If set to true, the response will return partial results when some regions are unreachable and the unreachable field in Feature proto will be populated. If set to false, the request will fail when some regions are unreachable.", + "location": "query", + "type": "boolean" } }, "path": "v1beta/{+parent}/features", @@ -2101,7 +2111,7 @@ } } }, - "revision": "20240706", + "revision": "20240727", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AnthosObservabilityFeatureSpec": { @@ -3290,7 +3300,7 @@ }, "policyController": { "$ref": "ConfigManagementPolicyController", - "description": "Policy Controller configuration for the cluster." + "description": "Policy Controller configuration for the cluster. Deprecated: Configuring Policy Controller through the configmanagement feature is no longer recommended. Use the policycontroller feature instead." }, "version": { "description": "Version of ACM installed.", @@ -3766,6 +3776,14 @@ "description": "Output only. The Hub-wide Feature state.", "readOnly": true }, + "unreachable": { + "description": "Output only. List of locations that could not be reached while fetching this feature.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, "updateTime": { "description": "Output only. When the Feature resource was last updated.", "format": "google-datetime", diff --git a/gkehub/v1beta/gkehub-gen.go b/gkehub/v1beta/gkehub-gen.go index 5eb9b5e7aee..b534ff73d64 100644 --- a/gkehub/v1beta/gkehub-gen.go +++ b/gkehub/v1beta/gkehub-gen.go @@ -1775,6 +1775,8 @@ type ConfigManagementMembershipSpec struct { // cluster. Management string `json:"management,omitempty"` // PolicyController: Policy Controller configuration for the cluster. + // Deprecated: Configuring Policy Controller through the configmanagement + // feature is no longer recommended. Use the policycontroller feature instead. PolicyController *ConfigManagementPolicyController `json:"policyController,omitempty"` // Version: Version of ACM installed. Version string `json:"version,omitempty"` @@ -2353,6 +2355,9 @@ type Feature struct { Spec *CommonFeatureSpec `json:"spec,omitempty"` // State: Output only. The Hub-wide Feature state. State *CommonFeatureState `json:"state,omitempty"` + // Unreachable: Output only. List of locations that could not be reached while + // fetching this feature. + Unreachable []string `json:"unreachable,omitempty"` // UpdateTime: Output only. When the Feature resource was last updated. UpdateTime string `json:"updateTime,omitempty"` @@ -6542,6 +6547,15 @@ func (r *ProjectsLocationsFeaturesService) Get(name string) *ProjectsLocationsFe return c } +// ReturnPartialSuccess sets the optional parameter "returnPartialSuccess": If +// set to true, the response will return partial results when some regions are +// unreachable and the unreachable field in Feature proto will be populated. If +// set to false, the request will fail when some regions are unreachable. +func (c *ProjectsLocationsFeaturesGetCall) ReturnPartialSuccess(returnPartialSuccess bool) *ProjectsLocationsFeaturesGetCall { + c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -6812,6 +6826,15 @@ func (c *ProjectsLocationsFeaturesListCall) PageToken(pageToken string) *Project return c } +// ReturnPartialSuccess sets the optional parameter "returnPartialSuccess": If +// set to true, the response will return partial results when some regions are +// unreachable and the unreachable field in Feature proto will be populated. If +// set to false, the request will fail when some regions are unreachable. +func (c *ProjectsLocationsFeaturesListCall) ReturnPartialSuccess(returnPartialSuccess bool) *ProjectsLocationsFeaturesListCall { + c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. diff --git a/monitoring/v3/monitoring-api.json b/monitoring/v3/monitoring-api.json index 784764f4cd0..617cbbd320b 100644 --- a/monitoring/v3/monitoring-api.json +++ b/monitoring/v3/monitoring-api.json @@ -756,7 +756,7 @@ ], "parameters": { "filter": { - "description": "If provided, this field specifies the criteria that must be met by alert policies to be included in the response.For more details, see sorting and filtering (https://cloud.google.com/monitoring/api/v3/sorting-and-filtering).", + "description": "Optional. If provided, this field specifies the criteria that must be met by alert policies to be included in the response.For more details, see sorting and filtering (https://cloud.google.com/monitoring/api/v3/sorting-and-filtering).", "location": "query", "type": "string" }, @@ -768,18 +768,18 @@ "type": "string" }, "orderBy": { - "description": "A comma-separated list of fields by which to sort the result. Supports the same set of field references as the filter field. Entries can be prefixed with a minus sign to sort by the field in descending order.For more details, see sorting and filtering (https://cloud.google.com/monitoring/api/v3/sorting-and-filtering).", + "description": "Optional. A comma-separated list of fields by which to sort the result. Supports the same set of field references as the filter field. Entries can be prefixed with a minus sign to sort by the field in descending order.For more details, see sorting and filtering (https://cloud.google.com/monitoring/api/v3/sorting-and-filtering).", "location": "query", "type": "string" }, "pageSize": { - "description": "The maximum number of results to return in a single response.", + "description": "Optional. The maximum number of results to return in a single response.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { - "description": "If this field is not empty then it must contain the nextPageToken value returned by a previous call to this method. Using this field causes the method to return more results from the previous method call.", + "description": "Optional. If this field is not empty then it must contain the nextPageToken value returned by a previous call to this method. Using this field causes the method to return more results from the previous method call.", "location": "query", "type": "string" } @@ -804,7 +804,7 @@ ], "parameters": { "name": { - "description": "Required if the policy exists. The resource name for this policy. The format is: projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[ALERT_POLICY_ID] [ALERT_POLICY_ID] is assigned by Cloud Monitoring when the policy is created. When calling the alertPolicies.create method, do not include the name field in the alerting policy passed as part of the request.", + "description": "Identifier. Required if the policy exists. The resource name for this policy. The format is: projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[ALERT_POLICY_ID] [ALERT_POLICY_ID] is assigned by Cloud Monitoring when the policy is created. When calling the alertPolicies.create method, do not include the name field in the alerting policy passed as part of the request.", "location": "path", "pattern": "^projects/[^/]+/alertPolicies/[^/]+$", "required": true, @@ -2714,7 +2714,7 @@ } } }, - "revision": "20240721", + "revision": "20240728", "rootUrl": "https://monitoring.googleapis.com/", "schemas": { "Aggregation": { @@ -2870,7 +2870,7 @@ "description": "A read-only record of the most recent change to the alerting policy. If provided in a call to create or update, this field will be ignored." }, "name": { - "description": "Required if the policy exists. The resource name for this policy. The format is: projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[ALERT_POLICY_ID] [ALERT_POLICY_ID] is assigned by Cloud Monitoring when the policy is created. When calling the alertPolicies.create method, do not include the name field in the alerting policy passed as part of the request.", + "description": "Identifier. Required if the policy exists. The resource name for this policy. The format is: projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[ALERT_POLICY_ID] [ALERT_POLICY_ID] is assigned by Cloud Monitoring when the policy is created. When calling the alertPolicies.create method, do not include the name field in the alerting policy passed as part of the request.", "type": "string" }, "notificationChannels": { diff --git a/monitoring/v3/monitoring-gen.go b/monitoring/v3/monitoring-gen.go index b74f095294c..73f4052ebe0 100644 --- a/monitoring/v3/monitoring-gen.go +++ b/monitoring/v3/monitoring-gen.go @@ -697,8 +697,9 @@ type AlertPolicy struct { // policy. If provided in a call to create or update, this field will be // ignored. MutationRecord *MutationRecord `json:"mutationRecord,omitempty"` - // Name: Required if the policy exists. The resource name for this policy. The - // format is: projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[ALERT_POLICY_ID] + // Name: Identifier. Required if the policy exists. The resource name for this + // policy. The format is: + // projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[ALERT_POLICY_ID] // [ALERT_POLICY_ID] is assigned by Cloud Monitoring when the policy is // created. When calling the alertPolicies.create method, do not include the // name field in the alerting policy passed as part of the request. @@ -7656,8 +7657,8 @@ type ProjectsAlertPoliciesPatchCall struct { // modify the state of alerting policies in a single project. This includes // calls to CreateAlertPolicy, DeleteAlertPolicy and UpdateAlertPolicy. // -// - name: Required if the policy exists. The resource name for this policy. -// The format is: +// - name: Identifier. Required if the policy exists. The resource name for +// this policy. The format is: // projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[ALERT_POLICY_ID] // [ALERT_POLICY_ID] is assigned by Cloud Monitoring when the policy is // created. When calling the alertPolicies.create method, do not include the diff --git a/networkmanagement/v1/networkmanagement-api.json b/networkmanagement/v1/networkmanagement-api.json index bf41c1984d1..a8991c0c9ab 100644 --- a/networkmanagement/v1/networkmanagement-api.json +++ b/networkmanagement/v1/networkmanagement-api.json @@ -591,7 +591,7 @@ } } }, - "revision": "20240718", + "revision": "20240725", "rootUrl": "https://networkmanagement.googleapis.com/", "schemas": { "AbortInfo": { @@ -1141,7 +1141,8 @@ "LOAD_BALANCER_HAS_NO_PROXY_SUBNET", "CLOUD_NAT_NO_ADDRESSES", "ROUTING_LOOP", - "DROPPED_INSIDE_GOOGLE_MANAGED_SERVICE" + "DROPPED_INSIDE_GOOGLE_MANAGED_SERVICE", + "LOAD_BALANCER_BACKEND_INVALID_NETWORK" ], "enumDescriptions": [ "Cause is unspecified.", @@ -1208,7 +1209,8 @@ "Packet sent to a load balancer, which requires a proxy-only subnet and the subnet is not found.", "Packet sent to Cloud Nat without active NAT IPs.", "Packet is stuck in a routing loop.", - "Packet is dropped due to an unspecified reason inside a Google-managed service. Used only for return traces." + "Packet is dropped due to an unspecified reason inside a Google-managed service. Used only for return traces.", + "Packet is dropped due to a load balancer backend instance not having a network interface in the network expected by the load balancer." ], "type": "string" }, @@ -1434,7 +1436,7 @@ "type": "object" }, "FirewallInfo": { - "description": "For display only. Metadata associated with a VPC firewall rule, an implied VPC firewall rule, or a hierarchical firewall policy rule.", + "description": "For display only. Metadata associated with a VPC firewall rule, an implied VPC firewall rule, or a firewall policy rule.", "id": "FirewallInfo", "properties": { "action": { @@ -1446,7 +1448,7 @@ "type": "string" }, "displayName": { - "description": "The display name of the VPC firewall rule. This field is not applicable to hierarchical firewall policy rules.", + "description": "The display name of the firewall rule. This field might be empty for firewall policy rules.", "type": "string" }, "firewallRuleType": { @@ -1480,7 +1482,11 @@ "type": "string" }, "policy": { - "description": "The hierarchical firewall policy that this rule is associated with. This field is not applicable to VPC firewall rules.", + "description": "The name of the firewall policy that this rule is associated with. This field is not applicable to VPC firewall rules and implied VPC firewall rules.", + "type": "string" + }, + "policyUri": { + "description": "The URI of the firewall policy that this rule is associated with. This field is not applicable to VPC firewall rules and implied VPC firewall rules.", "type": "string" }, "priority": { @@ -1496,14 +1502,14 @@ "type": "array" }, "targetTags": { - "description": "The target tags defined by the VPC firewall rule. This field is not applicable to hierarchical firewall policy rules.", + "description": "The target tags defined by the VPC firewall rule. This field is not applicable to firewall policy rules.", "items": { "type": "string" }, "type": "array" }, "uri": { - "description": "The URI of the VPC firewall rule. This field is not applicable to implied firewall rules or hierarchical firewall policy rules.", + "description": "The URI of the firewall rule. This field is not applicable to implied VPC firewall rules.", "type": "string" } }, diff --git a/networkmanagement/v1/networkmanagement-gen.go b/networkmanagement/v1/networkmanagement-gen.go index ccb36a75c97..d32cac15b75 100644 --- a/networkmanagement/v1/networkmanagement-gen.go +++ b/networkmanagement/v1/networkmanagement-gen.go @@ -999,6 +999,9 @@ type DropInfo struct { // "DROPPED_INSIDE_GOOGLE_MANAGED_SERVICE" - Packet is dropped due to an // unspecified reason inside a Google-managed service. Used only for return // traces. + // "LOAD_BALANCER_BACKEND_INVALID_NETWORK" - Packet is dropped due to a load + // balancer backend instance not having a network interface in the network + // expected by the load balancer. Cause string `json:"cause,omitempty"` // DestinationIp: Destination IP address of the dropped packet (if relevant). DestinationIp string `json:"destinationIp,omitempty"` @@ -1251,14 +1254,14 @@ func (s Expr) MarshalJSON() ([]byte, error) { } // FirewallInfo: For display only. Metadata associated with a VPC firewall -// rule, an implied VPC firewall rule, or a hierarchical firewall policy rule. +// rule, an implied VPC firewall rule, or a firewall policy rule. type FirewallInfo struct { // Action: Possible values: ALLOW, DENY, APPLY_SECURITY_PROFILE_GROUP Action string `json:"action,omitempty"` // Direction: Possible values: INGRESS, EGRESS Direction string `json:"direction,omitempty"` - // DisplayName: The display name of the VPC firewall rule. This field is not - // applicable to hierarchical firewall policy rules. + // DisplayName: The display name of the firewall rule. This field might be + // empty for firewall policy rules. DisplayName string `json:"displayName,omitempty"` // FirewallRuleType: The firewall rule's type. // @@ -1299,19 +1302,24 @@ type FirewallInfo struct { // NetworkUri: The URI of the VPC network that the firewall rule is associated // with. This field is not applicable to hierarchical firewall policy rules. NetworkUri string `json:"networkUri,omitempty"` - // Policy: The hierarchical firewall policy that this rule is associated with. - // This field is not applicable to VPC firewall rules. + // Policy: The name of the firewall policy that this rule is associated with. + // This field is not applicable to VPC firewall rules and implied VPC firewall + // rules. Policy string `json:"policy,omitempty"` + // PolicyUri: The URI of the firewall policy that this rule is associated with. + // This field is not applicable to VPC firewall rules and implied VPC firewall + // rules. + PolicyUri string `json:"policyUri,omitempty"` // Priority: The priority of the firewall rule. Priority int64 `json:"priority,omitempty"` // TargetServiceAccounts: The target service accounts specified by the firewall // rule. TargetServiceAccounts []string `json:"targetServiceAccounts,omitempty"` // TargetTags: The target tags defined by the VPC firewall rule. This field is - // not applicable to hierarchical firewall policy rules. + // not applicable to firewall policy rules. TargetTags []string `json:"targetTags,omitempty"` - // Uri: The URI of the VPC firewall rule. This field is not applicable to - // implied firewall rules or hierarchical firewall policy rules. + // Uri: The URI of the firewall rule. This field is not applicable to implied + // VPC firewall rules. Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Action") to unconditionally // include in API requests. By default, fields with empty or default values are diff --git a/networkmanagement/v1beta1/networkmanagement-api.json b/networkmanagement/v1beta1/networkmanagement-api.json index c4d2c6a975a..7e80b4ba3c2 100644 --- a/networkmanagement/v1beta1/networkmanagement-api.json +++ b/networkmanagement/v1beta1/networkmanagement-api.json @@ -591,7 +591,7 @@ } } }, - "revision": "20240718", + "revision": "20240725", "rootUrl": "https://networkmanagement.googleapis.com/", "schemas": { "AbortInfo": { @@ -1146,7 +1146,8 @@ "LOAD_BALANCER_HAS_NO_PROXY_SUBNET", "CLOUD_NAT_NO_ADDRESSES", "ROUTING_LOOP", - "DROPPED_INSIDE_GOOGLE_MANAGED_SERVICE" + "DROPPED_INSIDE_GOOGLE_MANAGED_SERVICE", + "LOAD_BALANCER_BACKEND_INVALID_NETWORK" ], "enumDescriptions": [ "Cause is unspecified.", @@ -1213,7 +1214,8 @@ "Packet sent to a load balancer, which requires a proxy-only subnet and the subnet is not found.", "Packet sent to Cloud Nat without active NAT IPs.", "Packet is stuck in a routing loop.", - "Packet is dropped due to an unspecified reason inside a Google-managed service. Used only for return traces." + "Packet is dropped due to an unspecified reason inside a Google-managed service. Used only for return traces.", + "Packet is dropped due to a load balancer backend instance not having a network interface in the network expected by the load balancer." ], "type": "string" }, @@ -1439,7 +1441,7 @@ "type": "object" }, "FirewallInfo": { - "description": "For display only. Metadata associated with a VPC firewall rule, an implied VPC firewall rule, or a hierarchical firewall policy rule.", + "description": "For display only. Metadata associated with a VPC firewall rule, an implied VPC firewall rule, or a firewall policy rule.", "id": "FirewallInfo", "properties": { "action": { @@ -1451,7 +1453,7 @@ "type": "string" }, "displayName": { - "description": "The display name of the VPC firewall rule. This field is not applicable to hierarchical firewall policy rules.", + "description": "The display name of the firewall rule. This field might be empty for firewall policy rules.", "type": "string" }, "firewallRuleType": { @@ -1485,7 +1487,11 @@ "type": "string" }, "policy": { - "description": "The hierarchical firewall policy that this rule is associated with. This field is not applicable to VPC firewall rules.", + "description": "The name of the firewall policy that this rule is associated with. This field is not applicable to VPC firewall rules and implied VPC firewall rules.", + "type": "string" + }, + "policyUri": { + "description": "The URI of the firewall policy that this rule is associated with. This field is not applicable to VPC firewall rules and implied VPC firewall rules.", "type": "string" }, "priority": { @@ -1501,14 +1507,14 @@ "type": "array" }, "targetTags": { - "description": "The target tags defined by the VPC firewall rule. This field is not applicable to hierarchical firewall policy rules.", + "description": "The target tags defined by the VPC firewall rule. This field is not applicable to firewall policy rules.", "items": { "type": "string" }, "type": "array" }, "uri": { - "description": "The URI of the VPC firewall rule. This field is not applicable to implied firewall rules or hierarchical firewall policy rules.", + "description": "The URI of the firewall rule. This field is not applicable to implied VPC firewall rules.", "type": "string" } }, diff --git a/networkmanagement/v1beta1/networkmanagement-gen.go b/networkmanagement/v1beta1/networkmanagement-gen.go index 7c1b4e6048d..36d37599fbf 100644 --- a/networkmanagement/v1beta1/networkmanagement-gen.go +++ b/networkmanagement/v1beta1/networkmanagement-gen.go @@ -1003,6 +1003,9 @@ type DropInfo struct { // "DROPPED_INSIDE_GOOGLE_MANAGED_SERVICE" - Packet is dropped due to an // unspecified reason inside a Google-managed service. Used only for return // traces. + // "LOAD_BALANCER_BACKEND_INVALID_NETWORK" - Packet is dropped due to a load + // balancer backend instance not having a network interface in the network + // expected by the load balancer. Cause string `json:"cause,omitempty"` // DestinationIp: Destination IP address of the dropped packet (if relevant). DestinationIp string `json:"destinationIp,omitempty"` @@ -1255,14 +1258,14 @@ func (s Expr) MarshalJSON() ([]byte, error) { } // FirewallInfo: For display only. Metadata associated with a VPC firewall -// rule, an implied VPC firewall rule, or a hierarchical firewall policy rule. +// rule, an implied VPC firewall rule, or a firewall policy rule. type FirewallInfo struct { // Action: Possible values: ALLOW, DENY, APPLY_SECURITY_PROFILE_GROUP Action string `json:"action,omitempty"` // Direction: Possible values: INGRESS, EGRESS Direction string `json:"direction,omitempty"` - // DisplayName: The display name of the VPC firewall rule. This field is not - // applicable to hierarchical firewall policy rules. + // DisplayName: The display name of the firewall rule. This field might be + // empty for firewall policy rules. DisplayName string `json:"displayName,omitempty"` // FirewallRuleType: The firewall rule's type. // @@ -1303,19 +1306,24 @@ type FirewallInfo struct { // NetworkUri: The URI of the VPC network that the firewall rule is associated // with. This field is not applicable to hierarchical firewall policy rules. NetworkUri string `json:"networkUri,omitempty"` - // Policy: The hierarchical firewall policy that this rule is associated with. - // This field is not applicable to VPC firewall rules. + // Policy: The name of the firewall policy that this rule is associated with. + // This field is not applicable to VPC firewall rules and implied VPC firewall + // rules. Policy string `json:"policy,omitempty"` + // PolicyUri: The URI of the firewall policy that this rule is associated with. + // This field is not applicable to VPC firewall rules and implied VPC firewall + // rules. + PolicyUri string `json:"policyUri,omitempty"` // Priority: The priority of the firewall rule. Priority int64 `json:"priority,omitempty"` // TargetServiceAccounts: The target service accounts specified by the firewall // rule. TargetServiceAccounts []string `json:"targetServiceAccounts,omitempty"` // TargetTags: The target tags defined by the VPC firewall rule. This field is - // not applicable to hierarchical firewall policy rules. + // not applicable to firewall policy rules. TargetTags []string `json:"targetTags,omitempty"` - // Uri: The URI of the VPC firewall rule. This field is not applicable to - // implied firewall rules or hierarchical firewall policy rules. + // Uri: The URI of the firewall rule. This field is not applicable to implied + // VPC firewall rules. Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Action") to unconditionally // include in API requests. By default, fields with empty or default values are diff --git a/retail/v2/retail-api.json b/retail/v2/retail-api.json index af489b5b917..e86502f43e1 100644 --- a/retail/v2/retail-api.json +++ b/retail/v2/retail-api.json @@ -2092,7 +2092,7 @@ } } }, - "revision": "20240702", + "revision": "20240801", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -2702,6 +2702,13 @@ "description": "Response of the autocomplete query.", "id": "GoogleCloudRetailV2CompleteQueryResponse", "properties": { + "attributeResults": { + "additionalProperties": { + "$ref": "GoogleCloudRetailV2CompleteQueryResponseAttributeResult" + }, + "description": "A map of matched attribute suggestions. This field is only available for \"cloud-retail\" dataset. Current supported keys: * `brands` * `categories`", + "type": "object" + }, "attributionToken": { "description": "A unique complete token. This should be included in the UserEvent.completion_detail for search events resulting from this completion, which enables accurate attribution of complete model performance.", "type": "string" @@ -2724,6 +2731,19 @@ }, "type": "object" }, + "GoogleCloudRetailV2CompleteQueryResponseAttributeResult": { + "description": "Resource that represents attribute results.", + "id": "GoogleCloudRetailV2CompleteQueryResponseAttributeResult", + "properties": { + "suggestions": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudRetailV2CompleteQueryResponseCompletionResult": { "description": "Resource that represents completion results.", "id": "GoogleCloudRetailV2CompleteQueryResponseCompletionResult", diff --git a/retail/v2/retail-gen.go b/retail/v2/retail-gen.go index b8cec05f878..1bd94aea2b9 100644 --- a/retail/v2/retail-gen.go +++ b/retail/v2/retail-gen.go @@ -1270,6 +1270,10 @@ func (s GoogleCloudRetailV2ColorInfo) MarshalJSON() ([]byte, error) { // GoogleCloudRetailV2CompleteQueryResponse: Response of the autocomplete // query. type GoogleCloudRetailV2CompleteQueryResponse struct { + // AttributeResults: A map of matched attribute suggestions. This field is only + // available for "cloud-retail" dataset. Current supported keys: * `brands` * + // `categories` + AttributeResults map[string]GoogleCloudRetailV2CompleteQueryResponseAttributeResult `json:"attributeResults,omitempty"` // AttributionToken: A unique complete token. This should be included in the // UserEvent.completion_detail for search events resulting from this // completion, which enables accurate attribution of complete model @@ -1291,13 +1295,13 @@ type GoogleCloudRetailV2CompleteQueryResponse struct { // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "AttributionToken") to + // ForceSendFields is a list of field names (e.g. "AttributeResults") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "AttributionToken") to include in + // NullFields is a list of field names (e.g. "AttributeResults") to include in // API requests with the JSON null value. By default, fields with empty values // are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. @@ -1309,6 +1313,28 @@ func (s GoogleCloudRetailV2CompleteQueryResponse) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudRetailV2CompleteQueryResponseAttributeResult: Resource that +// represents attribute results. +type GoogleCloudRetailV2CompleteQueryResponseAttributeResult struct { + Suggestions []string `json:"suggestions,omitempty"` + // ForceSendFields is a list of field names (e.g. "Suggestions") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Suggestions") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudRetailV2CompleteQueryResponseAttributeResult) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2CompleteQueryResponseAttributeResult + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudRetailV2CompleteQueryResponseCompletionResult: Resource that // represents completion results. type GoogleCloudRetailV2CompleteQueryResponseCompletionResult struct { diff --git a/retail/v2alpha/retail-api.json b/retail/v2alpha/retail-api.json index 17898611537..8572689cf8a 100644 --- a/retail/v2alpha/retail-api.json +++ b/retail/v2alpha/retail-api.json @@ -1030,6 +1030,34 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "export": { + "description": "Exports multiple Products.", + "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products:export", + "httpMethod": "POST", + "id": "retail.projects.locations.catalogs.branches.products.export", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. Resource name of a Branch, and `default_branch` for branch_id component is supported. For example `projects/1234/locations/global/catalogs/default_catalog/branches/default_branch`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/branches/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2alpha/{+parent}/products:export", + "request": { + "$ref": "GoogleCloudRetailV2alphaExportProductsRequest" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "get": { "description": "Gets a Product.", "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}", @@ -2585,7 +2613,7 @@ } } }, - "revision": "20240711", + "revision": "20240801", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -3433,7 +3461,7 @@ "id": "GoogleCloudRetailV2alphaAlertConfigAlertPolicy", "properties": { "alertGroup": { - "description": "The feature that provides alerting capability. Supported value is only `search-data-quality` for now.", + "description": "The feature that provides alerting capability. Supported value: - `search-data-quality` for retail search customers. - `conv-data-quality` for retail conversation customers.", "type": "string" }, "enrollStatus": { @@ -4019,7 +4047,6 @@ "id": "GoogleCloudRetailV2alphaCompleteQueryResponseAttributeResult", "properties": { "suggestions": { - "description": "The list of suggestions for the attribute.", "items": { "type": "string" }, @@ -4489,6 +4516,21 @@ }, "type": "object" }, + "GoogleCloudRetailV2alphaExportProductsRequest": { + "description": "Request message for ExportProducts method.", + "id": "GoogleCloudRetailV2alphaExportProductsRequest", + "properties": { + "filter": { + "description": "A filtering expression to specify restrictions on returned events. The expression is a sequence of terms. Each term applies a restriction to the returned products. Use this expression to restrict results to a specific time range, tag, or stock state or to filter products by product type. For example, `lastModifiedTime \u003e \"2012-04-23T18:25:43.511Z\" lastModifiedTime\u003c\"2012-04-23T18:25:43.511Z\" productType=primary` We expect only four types of fields: * `lastModifiedTime`: This can be specified twice, once with a less than operator and once with a greater than operator. The `lastModifiedTime` restriction should result in one, contiguous, valid, last-modified, time range. * `productType`: Supported values are `primary` and `variant`. The Boolean operators `OR` and `NOT` are supported if the expression is enclosed in parentheses and must be separated from the `productType` values by a space. * `availability`: Supported values are `IN_STOCK`, `OUT_OF_STOCK`, `PREORDER`, and `BACKORDER`. Boolean operators `OR` and `NOT` are supported if the expression is enclosed in parentheses and must be separated from the `availability` values by a space. * `Tag expressions`: Restricts output to products that match all of the specified tags. Boolean operators `OR` and `NOT` are supported if the expression is enclosed in parentheses and the operators are separated from the tag values by a space. Also supported is '`-\"tagA\"`', which is equivalent to '`NOT \"tagA\"`'. Tag values must be double-quoted, UTF-8 encoded strings and have a size limit of 1,000 characters. Some examples of valid filters expressions: * Example 1: `lastModifiedTime \u003e \"2012-04-23T18:25:43.511Z\" lastModifiedTime \u003c \"2012-04-23T18:30:43.511Z\"` * Example 2: `lastModifiedTime \u003e \"2012-04-23T18:25:43.511Z\" productType = \"variant\"` * Example 3: `tag=(\"Red\" OR \"Blue\") tag=\"New-Arrival\" tag=(NOT \"promotional\") productType = \"primary\" lastModifiedTime \u003c \"2018-04-23T18:30:43.511Z\"` * Example 4: `lastModifiedTime \u003e \"2012-04-23T18:25:43.511Z\"` * Example 5: `availability = (IN_STOCK OR BACKORDER)`", + "type": "string" + }, + "outputConfig": { + "$ref": "GoogleCloudRetailV2alphaOutputConfig", + "description": "Required. The output location of the data." + } + }, + "type": "object" + }, "GoogleCloudRetailV2alphaExportProductsResponse": { "description": "Response of the ExportProductsRequest. If the long running operation is done, then this message is returned by the google.longrunning.Operations.response field if the operation was successful.", "id": "GoogleCloudRetailV2alphaExportProductsResponse", diff --git a/retail/v2alpha/retail-gen.go b/retail/v2alpha/retail-gen.go index aba3b7a5556..ff42ee52377 100644 --- a/retail/v2alpha/retail-gen.go +++ b/retail/v2alpha/retail-gen.go @@ -1610,8 +1610,9 @@ func (s GoogleCloudRetailV2alphaAlertConfig) MarshalJSON() ([]byte, error) { // GoogleCloudRetailV2alphaAlertConfigAlertPolicy: Alert policy for a customer. type GoogleCloudRetailV2alphaAlertConfigAlertPolicy struct { - // AlertGroup: The feature that provides alerting capability. Supported value - // is only `search-data-quality` for now. + // AlertGroup: The feature that provides alerting capability. Supported value: + // - `search-data-quality` for retail search customers. - `conv-data-quality` + // for retail conversation customers. AlertGroup string `json:"alertGroup,omitempty"` // EnrollStatus: The enrollment status of a customer. // @@ -2483,7 +2484,6 @@ func (s GoogleCloudRetailV2alphaCompleteQueryResponse) MarshalJSON() ([]byte, er // GoogleCloudRetailV2alphaCompleteQueryResponseAttributeResult: Resource that // represents attribute results. type GoogleCloudRetailV2alphaCompleteQueryResponseAttributeResult struct { - // Suggestions: The list of suggestions for the attribute. Suggestions []string `json:"suggestions,omitempty"` // ForceSendFields is a list of field names (e.g. "Suggestions") to // unconditionally include in API requests. By default, fields with empty or @@ -3202,6 +3202,59 @@ func (s GoogleCloudRetailV2alphaExportMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudRetailV2alphaExportProductsRequest: Request message for +// ExportProducts method. +type GoogleCloudRetailV2alphaExportProductsRequest struct { + // Filter: A filtering expression to specify restrictions on returned events. + // The expression is a sequence of terms. Each term applies a restriction to + // the returned products. Use this expression to restrict results to a specific + // time range, tag, or stock state or to filter products by product type. For + // example, `lastModifiedTime > "2012-04-23T18:25:43.511Z" + // lastModifiedTime<"2012-04-23T18:25:43.511Z" productType=primary` We expect + // only four types of fields: * `lastModifiedTime`: This can be specified + // twice, once with a less than operator and once with a greater than operator. + // The `lastModifiedTime` restriction should result in one, contiguous, valid, + // last-modified, time range. * `productType`: Supported values are `primary` + // and `variant`. The Boolean operators `OR` and `NOT` are supported if the + // expression is enclosed in parentheses and must be separated from the + // `productType` values by a space. * `availability`: Supported values are + // `IN_STOCK`, `OUT_OF_STOCK`, `PREORDER`, and `BACKORDER`. Boolean operators + // `OR` and `NOT` are supported if the expression is enclosed in parentheses + // and must be separated from the `availability` values by a space. * `Tag + // expressions`: Restricts output to products that match all of the specified + // tags. Boolean operators `OR` and `NOT` are supported if the expression is + // enclosed in parentheses and the operators are separated from the tag values + // by a space. Also supported is '`-"tagA"', which is equivalent to '`NOT + // "tagA"'. Tag values must be double-quoted, UTF-8 encoded strings and have a + // size limit of 1,000 characters. Some examples of valid filters expressions: + // * Example 1: `lastModifiedTime > "2012-04-23T18:25:43.511Z" lastModifiedTime + // < "2012-04-23T18:30:43.511Z" * Example 2: `lastModifiedTime > + // "2012-04-23T18:25:43.511Z" productType = "variant" * Example 3: `tag=("Red" + // OR "Blue") tag="New-Arrival" tag=(NOT "promotional") productType = "primary" + // lastModifiedTime < "2018-04-23T18:30:43.511Z" * Example 4: + // `lastModifiedTime > "2012-04-23T18:25:43.511Z" * Example 5: `availability = + // (IN_STOCK OR BACKORDER)` + Filter string `json:"filter,omitempty"` + // OutputConfig: Required. The output location of the data. + OutputConfig *GoogleCloudRetailV2alphaOutputConfig `json:"outputConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. "Filter") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Filter") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudRetailV2alphaExportProductsRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2alphaExportProductsRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudRetailV2alphaExportProductsResponse: Response of the // ExportProductsRequest. If the long running operation is done, then this // message is returned by the google.longrunning.Operations.response field if @@ -12377,6 +12430,111 @@ func (c *ProjectsLocationsCatalogsBranchesProductsDeleteCall) Do(opts ...googlea return ret, nil } +type ProjectsLocationsCatalogsBranchesProductsExportCall struct { + s *Service + parent string + googlecloudretailv2alphaexportproductsrequest *GoogleCloudRetailV2alphaExportProductsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Export: Exports multiple Products. +// +// - parent: Resource name of a Branch, and `default_branch` for branch_id +// component is supported. For example +// `projects/1234/locations/global/catalogs/default_catalog/branches/default_b +// ranch`. +func (r *ProjectsLocationsCatalogsBranchesProductsService) Export(parent string, googlecloudretailv2alphaexportproductsrequest *GoogleCloudRetailV2alphaExportProductsRequest) *ProjectsLocationsCatalogsBranchesProductsExportCall { + c := &ProjectsLocationsCatalogsBranchesProductsExportCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googlecloudretailv2alphaexportproductsrequest = googlecloudretailv2alphaexportproductsrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsCatalogsBranchesProductsExportCall) Fields(s ...googleapi.Field) *ProjectsLocationsCatalogsBranchesProductsExportCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsCatalogsBranchesProductsExportCall) Context(ctx context.Context) *ProjectsLocationsCatalogsBranchesProductsExportCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsCatalogsBranchesProductsExportCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCatalogsBranchesProductsExportCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googlecloudretailv2alphaexportproductsrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2alpha/{+parent}/products:export") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "retail.projects.locations.catalogs.branches.products.export" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsCatalogsBranchesProductsExportCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleLongrunningOperation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil +} + type ProjectsLocationsCatalogsBranchesProductsGetCall struct { s *Service name string diff --git a/retail/v2beta/retail-api.json b/retail/v2beta/retail-api.json index 0770a88e9ef..cb388d27240 100644 --- a/retail/v2beta/retail-api.json +++ b/retail/v2beta/retail-api.json @@ -106,6 +106,67 @@ "protocol": "rest", "resources": { "projects": { + "methods": { + "getAlertConfig": { + "description": "Get the AlertConfig of the requested project.", + "flatPath": "v2beta/projects/{projectsId}/alertConfig", + "httpMethod": "GET", + "id": "retail.projects.getAlertConfig", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Full AlertConfig resource name. Format: projects/{project_number}/alertConfig", + "location": "path", + "pattern": "^projects/[^/]+/alertConfig$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+name}", + "response": { + "$ref": "GoogleCloudRetailV2betaAlertConfig" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "updateAlertConfig": { + "description": "Update the alert config of the requested project.", + "flatPath": "v2beta/projects/{projectsId}/alertConfig", + "httpMethod": "PATCH", + "id": "retail.projects.updateAlertConfig", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Immutable. The name of the AlertConfig singleton resource. Format: projects/*/alertConfig", + "location": "path", + "pattern": "^projects/[^/]+/alertConfig$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Indicates which fields in the provided AlertConfig to update. If not set, all supported fields are updated.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v2beta/{+name}", + "request": { + "$ref": "GoogleCloudRetailV2betaAlertConfig" + }, + "response": { + "$ref": "GoogleCloudRetailV2betaAlertConfig" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, "resources": { "locations": { "resources": { @@ -712,6 +773,34 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "export": { + "description": "Exports multiple Products.", + "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products:export", + "httpMethod": "POST", + "id": "retail.projects.locations.catalogs.branches.products.export", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. Resource name of a Branch, and `default_branch` for branch_id component is supported. For example `projects/1234/locations/global/catalogs/default_catalog/branches/default_branch`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/branches/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+parent}/products:export", + "request": { + "$ref": "GoogleCloudRetailV2betaExportProductsRequest" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "get": { "description": "Gets a Product.", "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}", @@ -2148,7 +2237,7 @@ } } }, - "revision": "20240711", + "revision": "20240801", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -3797,6 +3886,67 @@ "properties": {}, "type": "object" }, + "GoogleCloudRetailV2betaAlertConfig": { + "description": "Project level alert config.", + "id": "GoogleCloudRetailV2betaAlertConfig", + "properties": { + "alertPolicies": { + "description": "Alert policies for a customer. They must be unique by [AlertPolicy.alert_group]", + "items": { + "$ref": "GoogleCloudRetailV2betaAlertConfigAlertPolicy" + }, + "type": "array" + }, + "name": { + "description": "Required. Immutable. The name of the AlertConfig singleton resource. Format: projects/*/alertConfig", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudRetailV2betaAlertConfigAlertPolicy": { + "description": "Alert policy for a customer.", + "id": "GoogleCloudRetailV2betaAlertConfigAlertPolicy", + "properties": { + "alertGroup": { + "description": "The feature that provides alerting capability. Supported value: - `search-data-quality` for retail search customers. - `conv-data-quality` for retail conversation customers.", + "type": "string" + }, + "enrollStatus": { + "description": "The enrollment status of a customer.", + "enum": [ + "ENROLL_STATUS_UNSPECIFIED", + "ENROLLED", + "DECLINED" + ], + "enumDescriptions": [ + "Default value. Used for customers who have not responded to the alert policy.", + "Customer is enrolled in this policy.", + "Customer declined this policy." + ], + "type": "string" + }, + "recipients": { + "description": "Recipients for the alert policy. One alert policy should not exceed 20 recipients.", + "items": { + "$ref": "GoogleCloudRetailV2betaAlertConfigAlertPolicyRecipient" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudRetailV2betaAlertConfigAlertPolicyRecipient": { + "description": "Recipient contact information.", + "id": "GoogleCloudRetailV2betaAlertConfigAlertPolicyRecipient", + "properties": { + "emailAddress": { + "description": "Email address of the recipient.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudRetailV2betaAttributesConfig": { "description": "Catalog level attribute config.", "id": "GoogleCloudRetailV2betaAttributesConfig", @@ -4206,6 +4356,13 @@ "description": "Response of the autocomplete query.", "id": "GoogleCloudRetailV2betaCompleteQueryResponse", "properties": { + "attributeResults": { + "additionalProperties": { + "$ref": "GoogleCloudRetailV2betaCompleteQueryResponseAttributeResult" + }, + "description": "A map of matched attribute suggestions. This field is only available for \"cloud-retail\" dataset. Current supported keys: * `brands` * `categories`", + "type": "object" + }, "attributionToken": { "description": "A unique complete token. This should be included in the UserEvent.completion_detail for search events resulting from this completion, which enables accurate attribution of complete model performance.", "type": "string" @@ -4228,6 +4385,19 @@ }, "type": "object" }, + "GoogleCloudRetailV2betaCompleteQueryResponseAttributeResult": { + "description": "Resource that represents attribute results.", + "id": "GoogleCloudRetailV2betaCompleteQueryResponseAttributeResult", + "properties": { + "suggestions": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudRetailV2betaCompleteQueryResponseCompletionResult": { "description": "Resource that represents completion results.", "id": "GoogleCloudRetailV2betaCompleteQueryResponseCompletionResult", @@ -4612,6 +4782,21 @@ }, "type": "object" }, + "GoogleCloudRetailV2betaExportProductsRequest": { + "description": "Request message for ExportProducts method.", + "id": "GoogleCloudRetailV2betaExportProductsRequest", + "properties": { + "filter": { + "description": "A filtering expression to specify restrictions on returned events. The expression is a sequence of terms. Each term applies a restriction to the returned products. Use this expression to restrict results to a specific time range, tag, or stock state or to filter products by product type. For example, `lastModifiedTime \u003e \"2012-04-23T18:25:43.511Z\" lastModifiedTime\u003c\"2012-04-23T18:25:43.511Z\" productType=primary` We expect only four types of fields: * `lastModifiedTime`: This can be specified twice, once with a less than operator and once with a greater than operator. The `lastModifiedTime` restriction should result in one, contiguous, valid, last-modified, time range. * `productType`: Supported values are `primary` and `variant`. The Boolean operators `OR` and `NOT` are supported if the expression is enclosed in parentheses and must be separated from the `productType` values by a space. * `availability`: Supported values are `IN_STOCK`, `OUT_OF_STOCK`, `PREORDER`, and `BACKORDER`. Boolean operators `OR` and `NOT` are supported if the expression is enclosed in parentheses and must be separated from the `availability` values by a space. * `Tag expressions`: Restricts output to products that match all of the specified tags. Boolean operators `OR` and `NOT` are supported if the expression is enclosed in parentheses and the operators are separated from the tag values by a space. Also supported is '`-\"tagA\"`', which is equivalent to '`NOT \"tagA\"`'. Tag values must be double-quoted, UTF-8 encoded strings and have a size limit of 1,000 characters. Some examples of valid filters expressions: * Example 1: `lastModifiedTime \u003e \"2012-04-23T18:25:43.511Z\" lastModifiedTime \u003c \"2012-04-23T18:30:43.511Z\"` * Example 2: `lastModifiedTime \u003e \"2012-04-23T18:25:43.511Z\" productType = \"variant\"` * Example 3: `tag=(\"Red\" OR \"Blue\") tag=\"New-Arrival\" tag=(NOT \"promotional\") productType = \"primary\" lastModifiedTime \u003c \"2018-04-23T18:30:43.511Z\"` * Example 4: `lastModifiedTime \u003e \"2012-04-23T18:25:43.511Z\"` * Example 5: `availability = (IN_STOCK OR BACKORDER)`", + "type": "string" + }, + "outputConfig": { + "$ref": "GoogleCloudRetailV2betaOutputConfig", + "description": "Required. The output location of the data." + } + }, + "type": "object" + }, "GoogleCloudRetailV2betaExportProductsResponse": { "description": "Response of the ExportProductsRequest. If the long running operation is done, then this message is returned by the google.longrunning.Operations.response field if the operation was successful.", "id": "GoogleCloudRetailV2betaExportProductsResponse", diff --git a/retail/v2beta/retail-gen.go b/retail/v2beta/retail-gen.go index 868e20f8c1e..0a01ea1c9ab 100644 --- a/retail/v2beta/retail-gen.go +++ b/retail/v2beta/retail-gen.go @@ -2712,6 +2712,93 @@ func (s GoogleCloudRetailV2betaAddLocalInventoriesRequest) MarshalJSON() ([]byte type GoogleCloudRetailV2betaAddLocalInventoriesResponse struct { } +// GoogleCloudRetailV2betaAlertConfig: Project level alert config. +type GoogleCloudRetailV2betaAlertConfig struct { + // AlertPolicies: Alert policies for a customer. They must be unique by + // [AlertPolicy.alert_group] + AlertPolicies []*GoogleCloudRetailV2betaAlertConfigAlertPolicy `json:"alertPolicies,omitempty"` + // Name: Required. Immutable. The name of the AlertConfig singleton resource. + // Format: projects/*/alertConfig + Name string `json:"name,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "AlertPolicies") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AlertPolicies") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudRetailV2betaAlertConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2betaAlertConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2betaAlertConfigAlertPolicy: Alert policy for a customer. +type GoogleCloudRetailV2betaAlertConfigAlertPolicy struct { + // AlertGroup: The feature that provides alerting capability. Supported value: + // - `search-data-quality` for retail search customers. - `conv-data-quality` + // for retail conversation customers. + AlertGroup string `json:"alertGroup,omitempty"` + // EnrollStatus: The enrollment status of a customer. + // + // Possible values: + // "ENROLL_STATUS_UNSPECIFIED" - Default value. Used for customers who have + // not responded to the alert policy. + // "ENROLLED" - Customer is enrolled in this policy. + // "DECLINED" - Customer declined this policy. + EnrollStatus string `json:"enrollStatus,omitempty"` + // Recipients: Recipients for the alert policy. One alert policy should not + // exceed 20 recipients. + Recipients []*GoogleCloudRetailV2betaAlertConfigAlertPolicyRecipient `json:"recipients,omitempty"` + // ForceSendFields is a list of field names (e.g. "AlertGroup") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AlertGroup") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudRetailV2betaAlertConfigAlertPolicy) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2betaAlertConfigAlertPolicy + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2betaAlertConfigAlertPolicyRecipient: Recipient contact +// information. +type GoogleCloudRetailV2betaAlertConfigAlertPolicyRecipient struct { + // EmailAddress: Email address of the recipient. + EmailAddress string `json:"emailAddress,omitempty"` + // ForceSendFields is a list of field names (e.g. "EmailAddress") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "EmailAddress") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudRetailV2betaAlertConfigAlertPolicyRecipient) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2betaAlertConfigAlertPolicyRecipient + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudRetailV2betaAttributesConfig: Catalog level attribute config. type GoogleCloudRetailV2betaAttributesConfig struct { // AttributeConfigLevel: Output only. The AttributeConfigLevel used for this @@ -3320,6 +3407,10 @@ func (s GoogleCloudRetailV2betaColorInfo) MarshalJSON() ([]byte, error) { // GoogleCloudRetailV2betaCompleteQueryResponse: Response of the autocomplete // query. type GoogleCloudRetailV2betaCompleteQueryResponse struct { + // AttributeResults: A map of matched attribute suggestions. This field is only + // available for "cloud-retail" dataset. Current supported keys: * `brands` * + // `categories` + AttributeResults map[string]GoogleCloudRetailV2betaCompleteQueryResponseAttributeResult `json:"attributeResults,omitempty"` // AttributionToken: A unique complete token. This should be included in the // UserEvent.completion_detail for search events resulting from this // completion, which enables accurate attribution of complete model @@ -3341,13 +3432,13 @@ type GoogleCloudRetailV2betaCompleteQueryResponse struct { // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "AttributionToken") to + // ForceSendFields is a list of field names (e.g. "AttributeResults") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "AttributionToken") to include in + // NullFields is a list of field names (e.g. "AttributeResults") to include in // API requests with the JSON null value. By default, fields with empty values // are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. @@ -3359,6 +3450,28 @@ func (s GoogleCloudRetailV2betaCompleteQueryResponse) MarshalJSON() ([]byte, err return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudRetailV2betaCompleteQueryResponseAttributeResult: Resource that +// represents attribute results. +type GoogleCloudRetailV2betaCompleteQueryResponseAttributeResult struct { + Suggestions []string `json:"suggestions,omitempty"` + // ForceSendFields is a list of field names (e.g. "Suggestions") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Suggestions") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudRetailV2betaCompleteQueryResponseAttributeResult) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2betaCompleteQueryResponseAttributeResult + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudRetailV2betaCompleteQueryResponseCompletionResult: Resource that // represents completion results. type GoogleCloudRetailV2betaCompleteQueryResponseCompletionResult struct { @@ -3960,6 +4073,59 @@ func (s GoogleCloudRetailV2betaExportMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudRetailV2betaExportProductsRequest: Request message for +// ExportProducts method. +type GoogleCloudRetailV2betaExportProductsRequest struct { + // Filter: A filtering expression to specify restrictions on returned events. + // The expression is a sequence of terms. Each term applies a restriction to + // the returned products. Use this expression to restrict results to a specific + // time range, tag, or stock state or to filter products by product type. For + // example, `lastModifiedTime > "2012-04-23T18:25:43.511Z" + // lastModifiedTime<"2012-04-23T18:25:43.511Z" productType=primary` We expect + // only four types of fields: * `lastModifiedTime`: This can be specified + // twice, once with a less than operator and once with a greater than operator. + // The `lastModifiedTime` restriction should result in one, contiguous, valid, + // last-modified, time range. * `productType`: Supported values are `primary` + // and `variant`. The Boolean operators `OR` and `NOT` are supported if the + // expression is enclosed in parentheses and must be separated from the + // `productType` values by a space. * `availability`: Supported values are + // `IN_STOCK`, `OUT_OF_STOCK`, `PREORDER`, and `BACKORDER`. Boolean operators + // `OR` and `NOT` are supported if the expression is enclosed in parentheses + // and must be separated from the `availability` values by a space. * `Tag + // expressions`: Restricts output to products that match all of the specified + // tags. Boolean operators `OR` and `NOT` are supported if the expression is + // enclosed in parentheses and the operators are separated from the tag values + // by a space. Also supported is '`-"tagA"', which is equivalent to '`NOT + // "tagA"'. Tag values must be double-quoted, UTF-8 encoded strings and have a + // size limit of 1,000 characters. Some examples of valid filters expressions: + // * Example 1: `lastModifiedTime > "2012-04-23T18:25:43.511Z" lastModifiedTime + // < "2012-04-23T18:30:43.511Z" * Example 2: `lastModifiedTime > + // "2012-04-23T18:25:43.511Z" productType = "variant" * Example 3: `tag=("Red" + // OR "Blue") tag="New-Arrival" tag=(NOT "promotional") productType = "primary" + // lastModifiedTime < "2018-04-23T18:30:43.511Z" * Example 4: + // `lastModifiedTime > "2012-04-23T18:25:43.511Z" * Example 5: `availability = + // (IN_STOCK OR BACKORDER)` + Filter string `json:"filter,omitempty"` + // OutputConfig: Required. The output location of the data. + OutputConfig *GoogleCloudRetailV2betaOutputConfig `json:"outputConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. "Filter") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Filter") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudRetailV2betaExportProductsRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2betaExportProductsRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudRetailV2betaExportProductsResponse: Response of the // ExportProductsRequest. If the long running operation is done, then this // message is returned by the google.longrunning.Operations.response field if @@ -8350,6 +8516,226 @@ func (s GoogleTypeDate) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type ProjectsGetAlertConfigCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetAlertConfig: Get the AlertConfig of the requested project. +// +// - name: Full AlertConfig resource name. Format: +// projects/{project_number}/alertConfig. +func (r *ProjectsService) GetAlertConfig(name string) *ProjectsGetAlertConfigCall { + c := &ProjectsGetAlertConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsGetAlertConfigCall) Fields(s ...googleapi.Field) *ProjectsGetAlertConfigCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsGetAlertConfigCall) IfNoneMatch(entityTag string) *ProjectsGetAlertConfigCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsGetAlertConfigCall) Context(ctx context.Context) *ProjectsGetAlertConfigCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsGetAlertConfigCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsGetAlertConfigCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2beta/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "retail.projects.getAlertConfig" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudRetailV2betaAlertConfig.ServerResponse.Header or (if a response +// was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsGetAlertConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRetailV2betaAlertConfig, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleCloudRetailV2betaAlertConfig{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil +} + +type ProjectsUpdateAlertConfigCall struct { + s *Service + name string + googlecloudretailv2betaalertconfig *GoogleCloudRetailV2betaAlertConfig + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// UpdateAlertConfig: Update the alert config of the requested project. +// +// - name: Immutable. The name of the AlertConfig singleton resource. Format: +// projects/*/alertConfig. +func (r *ProjectsService) UpdateAlertConfig(name string, googlecloudretailv2betaalertconfig *GoogleCloudRetailV2betaAlertConfig) *ProjectsUpdateAlertConfigCall { + c := &ProjectsUpdateAlertConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googlecloudretailv2betaalertconfig = googlecloudretailv2betaalertconfig + return c +} + +// UpdateMask sets the optional parameter "updateMask": Indicates which fields +// in the provided AlertConfig to update. If not set, all supported fields are +// updated. +func (c *ProjectsUpdateAlertConfigCall) UpdateMask(updateMask string) *ProjectsUpdateAlertConfigCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsUpdateAlertConfigCall) Fields(s ...googleapi.Field) *ProjectsUpdateAlertConfigCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsUpdateAlertConfigCall) Context(ctx context.Context) *ProjectsUpdateAlertConfigCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsUpdateAlertConfigCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsUpdateAlertConfigCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googlecloudretailv2betaalertconfig) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2beta/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "retail.projects.updateAlertConfig" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudRetailV2betaAlertConfig.ServerResponse.Header or (if a response +// was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsUpdateAlertConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRetailV2betaAlertConfig, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleCloudRetailV2betaAlertConfig{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil +} + type ProjectsLocationsCatalogsCompleteQueryCall struct { s *Service catalog string @@ -10594,6 +10980,111 @@ func (c *ProjectsLocationsCatalogsBranchesProductsDeleteCall) Do(opts ...googlea return ret, nil } +type ProjectsLocationsCatalogsBranchesProductsExportCall struct { + s *Service + parent string + googlecloudretailv2betaexportproductsrequest *GoogleCloudRetailV2betaExportProductsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Export: Exports multiple Products. +// +// - parent: Resource name of a Branch, and `default_branch` for branch_id +// component is supported. For example +// `projects/1234/locations/global/catalogs/default_catalog/branches/default_b +// ranch`. +func (r *ProjectsLocationsCatalogsBranchesProductsService) Export(parent string, googlecloudretailv2betaexportproductsrequest *GoogleCloudRetailV2betaExportProductsRequest) *ProjectsLocationsCatalogsBranchesProductsExportCall { + c := &ProjectsLocationsCatalogsBranchesProductsExportCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googlecloudretailv2betaexportproductsrequest = googlecloudretailv2betaexportproductsrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsCatalogsBranchesProductsExportCall) Fields(s ...googleapi.Field) *ProjectsLocationsCatalogsBranchesProductsExportCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsCatalogsBranchesProductsExportCall) Context(ctx context.Context) *ProjectsLocationsCatalogsBranchesProductsExportCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsCatalogsBranchesProductsExportCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCatalogsBranchesProductsExportCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googlecloudretailv2betaexportproductsrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2beta/{+parent}/products:export") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "retail.projects.locations.catalogs.branches.products.export" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleLongrunningOperation.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsCatalogsBranchesProductsExportCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleLongrunningOperation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil +} + type ProjectsLocationsCatalogsBranchesProductsGetCall struct { s *Service name string diff --git a/run/v1/run-api.json b/run/v1/run-api.json index 885486d5aae..76679911033 100644 --- a/run/v1/run-api.json +++ b/run/v1/run-api.json @@ -2614,7 +2614,7 @@ } } }, - "revision": "20240719", + "revision": "20240731", "rootUrl": "https://run.googleapis.com/", "schemas": { "Addressable": { @@ -5381,7 +5381,7 @@ "additionalProperties": { "type": "string" }, - "description": "Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Revision, Service. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-id`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution. * `run.googleapis.com/container-dependencies`: Revision . * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/function-target`: Service. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/ingress`: Service. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service (ALPHA) * `run.googleapis.com/network-interfaces`: Revision, Execution. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/source-location`: Service. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution.", + "description": "Unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. In Cloud Run, annotations with 'run.googleapis.com/' and 'autoscaling.knative.dev' are restricted, and the accepted annotations will be different depending on the resource type. * `autoscaling.knative.dev/maxScale`: Revision. * `autoscaling.knative.dev/minScale`: Revision. * `run.googleapis.com/base-images`: Revision, Service. * `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * `run.googleapis.com/binary-authorization`: Service, Job, Execution. * `run.googleapis.com/build-environment-variables`: Service. * `run.googleapis.com/build-id`: Service. * `run.googleapis.com/build-name`: Service. * `run.googleapis.com/build-service-account`: Service. * `run.googleapis.com/build-worker-pool`: Service. * `run.googleapis.com/client-name`: All resources. * `run.googleapis.com/cloudsql-instances`: Revision, Execution. * `run.googleapis.com/container-dependencies`: Revision . * `run.googleapis.com/cpu-throttling`: Revision. * `run.googleapis.com/custom-audiences`: Service. * `run.googleapis.com/default-url-disabled`: Service. * `run.googleapis.com/description`: Service. * `run.googleapis.com/encryption-key-shutdown-hours`: Revision * `run.googleapis.com/encryption-key`: Revision, Execution. * `run.googleapis.com/execution-environment`: Revision, Execution. * `run.googleapis.com/function-target`: Service. * `run.googleapis.com/gc-traffic-tags`: Service. * `run.googleapis.com/image-uri`: Service. * `run.googleapis.com/ingress`: Service. * `run.googleapis.com/launch-stage`: Service, Job. * `run.googleapis.com/minScale`: Service (ALPHA) * `run.googleapis.com/network-interfaces`: Revision, Execution. * `run.googleapis.com/post-key-revocation-action-type`: Revision. * `run.googleapis.com/runtime`: Service. * `run.googleapis.com/secrets`: Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. * `run.googleapis.com/sessionAffinity`: Revision. * `run.googleapis.com/source-location`: Service. * `run.googleapis.com/startup-cpu-boost`: Revision. * `run.googleapis.com/vpc-access-connector`: Revision, Execution. * `run.googleapis.com/vpc-access-egress`: Revision, Execution.", "type": "object" }, "clusterName": { diff --git a/run/v1/run-gen.go b/run/v1/run-gen.go index f4fcabbd309..8cdbee9af46 100644 --- a/run/v1/run-gen.go +++ b/run/v1/run-gen.go @@ -3917,8 +3917,8 @@ type ObjectMeta struct { // `run.googleapis.com/binary-authorization-breakglass`: Service, Job, * // `run.googleapis.com/binary-authorization`: Service, Job, Execution. * // `run.googleapis.com/build-environment-variables`: Service. * - // `run.googleapis.com/build-id`: Service. * - // `run.googleapis.com/build-service-account`: Service. * + // `run.googleapis.com/build-id`: Service. * `run.googleapis.com/build-name`: + // Service. * `run.googleapis.com/build-service-account`: Service. * // `run.googleapis.com/build-worker-pool`: Service. * // `run.googleapis.com/client-name`: All resources. * // `run.googleapis.com/cloudsql-instances`: Revision, Execution. * @@ -3932,13 +3932,14 @@ type ObjectMeta struct { // `run.googleapis.com/execution-environment`: Revision, Execution. * // `run.googleapis.com/function-target`: Service. * // `run.googleapis.com/gc-traffic-tags`: Service. * - // `run.googleapis.com/ingress`: Service. * `run.googleapis.com/launch-stage`: - // Service, Job. * `run.googleapis.com/minScale`: Service (ALPHA) * + // `run.googleapis.com/image-uri`: Service. * `run.googleapis.com/ingress`: + // Service. * `run.googleapis.com/launch-stage`: Service, Job. * + // `run.googleapis.com/minScale`: Service (ALPHA) * // `run.googleapis.com/network-interfaces`: Revision, Execution. * // `run.googleapis.com/post-key-revocation-action-type`: Revision. * - // `run.googleapis.com/secrets`: Revision, Execution. * - // `run.googleapis.com/secure-session-agent`: Revision. * - // `run.googleapis.com/sessionAffinity`: Revision. * + // `run.googleapis.com/runtime`: Service. * `run.googleapis.com/secrets`: + // Revision, Execution. * `run.googleapis.com/secure-session-agent`: Revision. + // * `run.googleapis.com/sessionAffinity`: Revision. * // `run.googleapis.com/source-location`: Service. * // `run.googleapis.com/startup-cpu-boost`: Revision. * // `run.googleapis.com/vpc-access-connector`: Revision, Execution. * diff --git a/sasportal/v1alpha1/sasportal-api.json b/sasportal/v1alpha1/sasportal-api.json index 66a73672c79..d00133afdcd 100644 --- a/sasportal/v1alpha1/sasportal-api.json +++ b/sasportal/v1alpha1/sasportal-api.json @@ -2652,7 +2652,7 @@ } } }, - "revision": "20240520", + "revision": "20240801", "rootUrl": "https://sasportal.googleapis.com/", "schemas": { "SasPortalAssignment": { @@ -2861,7 +2861,8 @@ "DOODLE_CBRS", "CW", "REDLINE", - "TARANA_WIRELESS" + "TARANA_WIRELESS", + "FAROS" ], "enumDescriptions": [ "", @@ -2872,6 +2873,7 @@ "", "", "", + "", "" ], "type": "string" diff --git a/sasportal/v1alpha1/sasportal-gen.go b/sasportal/v1alpha1/sasportal-gen.go index 0919d5f1443..baec6676a02 100644 --- a/sasportal/v1alpha1/sasportal-gen.go +++ b/sasportal/v1alpha1/sasportal-gen.go @@ -653,6 +653,7 @@ type SasPortalDeviceAirInterface struct { // "CW" // "REDLINE" // "TARANA_WIRELESS" + // "FAROS" RadioTechnology string `json:"radioTechnology,omitempty"` // SupportedSpec: Optional. This field is related to the `radioTechnology` and // provides the air interface specification that the CBSD is compliant with at diff --git a/secretmanager/v1/secretmanager-api.json b/secretmanager/v1/secretmanager-api.json index 27c0df5184c..55c52f9d8b5 100644 --- a/secretmanager/v1/secretmanager-api.json +++ b/secretmanager/v1/secretmanager-api.json @@ -90,6 +90,11 @@ "description": "Regional Endpoint", "endpointUrl": "https://secretmanager.europe-west9.rep.googleapis.com/", "location": "europe-west9" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://secretmanager.europe-west6.rep.googleapis.com/", + "location": "europe-west6" } ], "fullyEncodeReservedExpansion": true, @@ -1185,7 +1190,7 @@ } } }, - "revision": "20240527", + "revision": "20240726", "rootUrl": "https://secretmanager.googleapis.com/", "schemas": { "AccessSecretVersionResponse": { diff --git a/secretmanager/v1beta1/secretmanager-api.json b/secretmanager/v1beta1/secretmanager-api.json index f9e0ffafe03..2179374cb6a 100644 --- a/secretmanager/v1beta1/secretmanager-api.json +++ b/secretmanager/v1beta1/secretmanager-api.json @@ -90,6 +90,11 @@ "description": "Regional Endpoint", "endpointUrl": "https://secretmanager.europe-west9.rep.googleapis.com/", "location": "europe-west9" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://secretmanager.europe-west6.rep.googleapis.com/", + "location": "europe-west6" } ], "fullyEncodeReservedExpansion": true, @@ -705,7 +710,7 @@ } } }, - "revision": "20240527", + "revision": "20240726", "rootUrl": "https://secretmanager.googleapis.com/", "schemas": { "AccessSecretVersionResponse": { diff --git a/secretmanager/v1beta2/secretmanager-api.json b/secretmanager/v1beta2/secretmanager-api.json index 9d984d8650f..95a184f7bf3 100644 --- a/secretmanager/v1beta2/secretmanager-api.json +++ b/secretmanager/v1beta2/secretmanager-api.json @@ -90,6 +90,11 @@ "description": "Regional Endpoint", "endpointUrl": "https://secretmanager.europe-west9.rep.googleapis.com/", "location": "europe-west9" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://secretmanager.europe-west6.rep.googleapis.com/", + "location": "europe-west6" } ], "fullyEncodeReservedExpansion": true, @@ -1185,7 +1190,7 @@ } } }, - "revision": "20240527", + "revision": "20240726", "rootUrl": "https://secretmanager.googleapis.com/", "schemas": { "AccessSecretVersionResponse": { diff --git a/workstations/v1/workstations-api.json b/workstations/v1/workstations-api.json index 9ea5dbc209c..25c276048de 100644 --- a/workstations/v1/workstations-api.json +++ b/workstations/v1/workstations-api.json @@ -1195,7 +1195,7 @@ } } }, - "revision": "20240716", + "revision": "20240723", "rootUrl": "https://workstations.googleapis.com/", "schemas": { "Accelerator": { @@ -1479,7 +1479,7 @@ "additionalProperties": { "type": "string" }, - "description": "Optional. Resource manager tags to be bound to this instance. Tag keys and values have the same definition as https://cloud.google.com/resource-manager/docs/tags/tags-overview Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`.", + "description": "Optional. Resource manager tags to be bound to this instance. Tag keys and values have the same definition as [resource manager tags](https://cloud.google.com/resource-manager/docs/tags/tags-overview). Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`.", "type": "object" } }, @@ -1945,12 +1945,12 @@ "id": "PortRange", "properties": { "first": { - "description": "Required. Starting port number for the current range of ports.", + "description": "Required. Starting port number for the current range of ports. Valid ports are 22, 80, and ports within the range 1024-65535.", "format": "int32", "type": "integer" }, "last": { - "description": "Required. Ending port number for the current range of ports.", + "description": "Required. Ending port number for the current range of ports. Valid ports are 22, 80, and ports within the range 1024-65535.", "format": "int32", "type": "integer" } @@ -2305,7 +2305,7 @@ "id": "WorkstationConfig", "properties": { "allowedPorts": { - "description": "Optional. A Single or Range of ports externally accessible in the workstation. If not specified defaults to ports 22, 80 and ports 1024-65535.", + "description": "Optional. A list of PortRanges specifying single ports or ranges of ports that are externally accessible in the workstation. Allowed ports must be one of 22, 80, or within range 1024-65535. If not specified defaults to ports 22, 80, and ports 1024-65535.", "items": { "$ref": "PortRange" }, diff --git a/workstations/v1/workstations-gen.go b/workstations/v1/workstations-gen.go index 1d117a4a719..dbec8df6886 100644 --- a/workstations/v1/workstations-gen.go +++ b/workstations/v1/workstations-gen.go @@ -711,9 +711,9 @@ type GceInstance struct { // rules (https://cloud.google.com/workstations/docs/configure-firewall-rules). Tags []string `json:"tags,omitempty"` // VmTags: Optional. Resource manager tags to be bound to this instance. Tag - // keys and values have the same definition as - // https://cloud.google.com/resource-manager/docs/tags/tags-overview Keys must - // be in the format `tagKeys/{tag_key_id}`, and values are in the format + // keys and values have the same definition as resource manager tags + // (https://cloud.google.com/resource-manager/docs/tags/tags-overview). Keys + // must be in the format `tagKeys/{tag_key_id}`, and values are in the format // `tagValues/456`. VmTags map[string]string `json:"vmTags,omitempty"` // ForceSendFields is a list of field names (e.g. "Accelerators") to @@ -1394,9 +1394,11 @@ func (s Policy) MarshalJSON() ([]byte, error) { // PortRange: A PortRange defines a range of ports. Both first and last are // inclusive. To specify a single port, both first and last should be the same. type PortRange struct { - // First: Required. Starting port number for the current range of ports. + // First: Required. Starting port number for the current range of ports. Valid + // ports are 22, 80, and ports within the range 1024-65535. First int64 `json:"first,omitempty"` - // Last: Required. Ending port number for the current range of ports. + // Last: Required. Ending port number for the current range of ports. Valid + // ports are 22, 80, and ports within the range 1024-65535. Last int64 `json:"last,omitempty"` // ForceSendFields is a list of field names (e.g. "First") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -1811,9 +1813,10 @@ func (s WorkstationCluster) MarshalJSON() ([]byte, error) { // Management (IAM) (https://cloud.google.com/iam/docs/overview) rules to grant // access to teams or to individual developers. type WorkstationConfig struct { - // AllowedPorts: Optional. A Single or Range of ports externally accessible in - // the workstation. If not specified defaults to ports 22, 80 and ports - // 1024-65535. + // AllowedPorts: Optional. A list of PortRanges specifying single ports or + // ranges of ports that are externally accessible in the workstation. Allowed + // ports must be one of 22, 80, or within range 1024-65535. If not specified + // defaults to ports 22, 80, and ports 1024-65535. AllowedPorts []*PortRange `json:"allowedPorts,omitempty"` // Annotations: Optional. Client-specified annotations. Annotations map[string]string `json:"annotations,omitempty"` diff --git a/workstations/v1beta/workstations-api.json b/workstations/v1beta/workstations-api.json index eb7f759c358..3125a21953b 100644 --- a/workstations/v1beta/workstations-api.json +++ b/workstations/v1beta/workstations-api.json @@ -1127,7 +1127,7 @@ } } }, - "revision": "20240716", + "revision": "20240723", "rootUrl": "https://workstations.googleapis.com/", "schemas": { "Accelerator": { @@ -1454,7 +1454,7 @@ "additionalProperties": { "type": "string" }, - "description": "Optional. Resource manager tags to be bound to this instance. Tag keys and values have the same definition as https://cloud.google.com/resource-manager/docs/tags/tags-overview Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`.", + "description": "Optional. Resource manager tags to be bound to this instance. Tag keys and values have the same definition as [resource manager tags](https://cloud.google.com/resource-manager/docs/tags/tags-overview). Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`.", "type": "object" } }, @@ -1596,7 +1596,7 @@ "type": "object" }, "HttpOptions": { - "description": "Http options for the running workstations.", + "description": "HTTP options for the running workstations.", "id": "HttpOptions", "properties": { "allowedUnauthenticatedCorsPreflightRequests": { @@ -1879,12 +1879,12 @@ "id": "PortRange", "properties": { "first": { - "description": "Required. Starting port number for the current range of ports.", + "description": "Required. Starting port number for the current range of ports. Valid ports are 22, 80, and ports within the range 1024-65535.", "format": "int32", "type": "integer" }, "last": { - "description": "Required. Ending port number for the current range of ports.", + "description": "Required. Ending port number for the current range of ports. Valid ports are 22, 80, and ports within the range 1024-65535.", "format": "int32", "type": "integer" } @@ -2123,7 +2123,7 @@ "type": "boolean" }, "sourceWorkstation": { - "description": "Optional. The source workstation from which this workstations persistent directories were cloned on creation.", + "description": "Optional. The source workstation from which this workstation's persistent directories were cloned on creation.", "type": "string" }, "startTime": { @@ -2287,7 +2287,7 @@ "id": "WorkstationConfig", "properties": { "allowedPorts": { - "description": "Optional. A Single or Range of ports externally accessible in the workstation. If not specified defaults to ports 22, 80 and ports 1024-65535.", + "description": "Optional. A list of PortRanges specifying single ports or ranges of ports that are externally accessible in the workstation. Allowed ports must be one of 22, 80, or within range 1024-65535. If not specified defaults to ports 22, 80, and ports 1024-65535.", "items": { "$ref": "PortRange" }, @@ -2362,7 +2362,7 @@ }, "httpOptions": { "$ref": "HttpOptions", - "description": "Optional. Http options that customize the behavior of the workstation service's http proxy." + "description": "Optional. HTTP options that customize the behavior of the workstation service's HTTP proxy." }, "idleTimeout": { "description": "Optional. Number of seconds to wait before automatically stopping a workstation after it last received user traffic. A value of `\"0s\"` indicates that Cloud Workstations VMs created with this configuration should never time out due to idleness. Provide [duration](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#duration) terminated by `s` for seconds—for example, `\"7200s\"` (2 hours). The default is `\"1200s\"` (20 minutes).", diff --git a/workstations/v1beta/workstations-gen.go b/workstations/v1beta/workstations-gen.go index 4e5aa8f0d3b..ffdaf692586 100644 --- a/workstations/v1beta/workstations-gen.go +++ b/workstations/v1beta/workstations-gen.go @@ -771,9 +771,9 @@ type GceInstance struct { // rules (https://cloud.google.com/workstations/docs/configure-firewall-rules). Tags []string `json:"tags,omitempty"` // VmTags: Optional. Resource manager tags to be bound to this instance. Tag - // keys and values have the same definition as - // https://cloud.google.com/resource-manager/docs/tags/tags-overview Keys must - // be in the format `tagKeys/{tag_key_id}`, and values are in the format + // keys and values have the same definition as resource manager tags + // (https://cloud.google.com/resource-manager/docs/tags/tags-overview). Keys + // must be in the format `tagKeys/{tag_key_id}`, and values are in the format // `tagValues/456`. VmTags map[string]string `json:"vmTags,omitempty"` // ForceSendFields is a list of field names (e.g. "Accelerators") to @@ -1006,7 +1006,7 @@ func (s Host) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// HttpOptions: Http options for the running workstations. +// HttpOptions: HTTP options for the running workstations. type HttpOptions struct { // AllowedUnauthenticatedCorsPreflightRequests: Optional. By default, the // workstations service makes sure that all requests to the workstation are @@ -1419,9 +1419,11 @@ func (s Policy) MarshalJSON() ([]byte, error) { // PortRange: A PortRange defines a range of ports. Both first and last are // inclusive. To specify a single port, both first and last should be the same. type PortRange struct { - // First: Required. Starting port number for the current range of ports. + // First: Required. Starting port number for the current range of ports. Valid + // ports are 22, 80, and ports within the range 1024-65535. First int64 `json:"first,omitempty"` - // Last: Required. Ending port number for the current range of ports. + // Last: Required. Ending port number for the current range of ports. Valid + // ports are 22, 80, and ports within the range 1024-65535. Last int64 `json:"last,omitempty"` // ForceSendFields is a list of field names (e.g. "First") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -1720,7 +1722,7 @@ type Workstation struct { // SatisfiesPzs: Output only. Reserved for future use. SatisfiesPzs bool `json:"satisfiesPzs,omitempty"` // SourceWorkstation: Optional. The source workstation from which this - // workstations persistent directories were cloned on creation. + // workstation's persistent directories were cloned on creation. SourceWorkstation string `json:"sourceWorkstation,omitempty"` // StartTime: Output only. Time when this workstation was most recently // successfully started, regardless of the workstation's initial state. @@ -1876,9 +1878,10 @@ func (s WorkstationCluster) MarshalJSON() ([]byte, error) { // Management (IAM) (https://cloud.google.com/iam/docs/overview) rules to grant // access to teams or to individual developers. type WorkstationConfig struct { - // AllowedPorts: Optional. A Single or Range of ports externally accessible in - // the workstation. If not specified defaults to ports 22, 80 and ports - // 1024-65535. + // AllowedPorts: Optional. A list of PortRanges specifying single ports or + // ranges of ports that are externally accessible in the workstation. Allowed + // ports must be one of 22, 80, or within range 1024-65535. If not specified + // defaults to ports 22, 80, and ports 1024-65535. AllowedPorts []*PortRange `json:"allowedPorts,omitempty"` // Annotations: Optional. Client-specified annotations. Annotations map[string]string `json:"annotations,omitempty"` @@ -1940,8 +1943,8 @@ type WorkstationConfig struct { Etag string `json:"etag,omitempty"` // Host: Optional. Runtime host for the workstation. Host *Host `json:"host,omitempty"` - // HttpOptions: Optional. Http options that customize the behavior of the - // workstation service's http proxy. + // HttpOptions: Optional. HTTP options that customize the behavior of the + // workstation service's HTTP proxy. HttpOptions *HttpOptions `json:"httpOptions,omitempty"` // IdleTimeout: Optional. Number of seconds to wait before automatically // stopping a workstation after it last received user traffic. A value of