diff --git a/.github/renovate.json b/.github/renovate.json index 21e94b4a890..4a2ee83be34 100644 --- a/.github/renovate.json +++ b/.github/renovate.json @@ -12,8 +12,7 @@ "commitMessageAction": "update", "groupName": "all", "ignoreDeps": [ - "google.golang.org/appengine", - "google.golang.org/grpc" + "google.golang.org/appengine" ], "packageRules": [ { @@ -26,7 +25,7 @@ ], "force": { "constraints": { - "go": "1.20" + "go": "1.21" } } } diff --git a/CHANGES.md b/CHANGES.md index 402ad338014..a9d72f970c8 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -1,5 +1,17 @@ # Changes +## [0.193.0](https://github.com/googleapis/google-api-go-client/compare/v0.192.0...v0.193.0) (2024-08-20) + + +### Features + +* **all:** Auto-regenerate discovery clients ([#2733](https://github.com/googleapis/google-api-go-client/issues/2733)) ([4118ec2](https://github.com/googleapis/google-api-go-client/commit/4118ec2221db4788e545eb530f2ae777b18228d3)) +* **all:** Auto-regenerate discovery clients ([#2736](https://github.com/googleapis/google-api-go-client/issues/2736)) ([6b81f1a](https://github.com/googleapis/google-api-go-client/commit/6b81f1a4b92de2d536ff7a7d8ef95e15c52baf3f)) +* **all:** Auto-regenerate discovery clients ([#2737](https://github.com/googleapis/google-api-go-client/issues/2737)) ([a2308c1](https://github.com/googleapis/google-api-go-client/commit/a2308c1bd2489b55de42a9373a8277739d0a46b1)) +* **all:** Auto-regenerate discovery clients ([#2738](https://github.com/googleapis/google-api-go-client/issues/2738)) ([7296c72](https://github.com/googleapis/google-api-go-client/commit/7296c7296923910d9d34afd20674e8798883b8d2)) +* **all:** Auto-regenerate discovery clients ([#2739](https://github.com/googleapis/google-api-go-client/issues/2739)) ([9d915ff](https://github.com/googleapis/google-api-go-client/commit/9d915ffa9833eeedd85aba44aa6a60b40c823ffc)) +* **all:** Auto-regenerate discovery clients ([#2742](https://github.com/googleapis/google-api-go-client/issues/2742)) ([cb825c8](https://github.com/googleapis/google-api-go-client/commit/cb825c892c853d8731c2e1103fba6c9c7bcd0dc4)) + ## [0.192.0](https://github.com/googleapis/google-api-go-client/compare/v0.191.0...v0.192.0) (2024-08-13) diff --git a/accesscontextmanager/v1/accesscontextmanager-api.json b/accesscontextmanager/v1/accesscontextmanager-api.json index cebc85a349e..c2feac876e6 100644 --- a/accesscontextmanager/v1/accesscontextmanager-api.json +++ b/accesscontextmanager/v1/accesscontextmanager-api.json @@ -1290,7 +1290,7 @@ } } }, - "revision": "20240716", + "revision": "20240811", "rootUrl": "https://accesscontextmanager.googleapis.com/", "schemas": { "AccessContextManagerOperationMetadata": { @@ -1705,7 +1705,7 @@ "id": "EgressFrom", "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" }, @@ -1904,7 +1904,7 @@ "id": "IngressFrom", "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/accesscontextmanager/v1/accesscontextmanager-gen.go b/accesscontextmanager/v1/accesscontextmanager-gen.go index c656bcdada7..8485702a802 100644 --- a/accesscontextmanager/v1/accesscontextmanager-gen.go +++ b/accesscontextmanager/v1/accesscontextmanager-gen.go @@ -889,9 +889,11 @@ func (s DevicePolicy) MarshalJSON() ([]byte, error) { type EgressFrom 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` @@ -1229,9 +1231,11 @@ func (s GetPolicyOptions) MarshalJSON() ([]byte, error) { type IngressFrom 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/aiplatform/v1/aiplatform-api.json b/aiplatform/v1/aiplatform-api.json index 9842240bbdc..be8c217dc61 100644 --- a/aiplatform/v1/aiplatform-api.json +++ b/aiplatform/v1/aiplatform-api.json @@ -16928,6 +16928,11 @@ "name" ], "parameters": { + "huggingFaceToken": { + "description": "Optional. Token used to access Hugging Face gated models.", + "location": "query", + "type": "string" + }, "isHuggingFaceModel": { "description": "Optional. Boolean indicates whether the requested model is a Hugging Face model.", "location": "query", @@ -16976,7 +16981,7 @@ } } }, - "revision": "20240727", + "revision": "20240809", "rootUrl": "https://aiplatform.googleapis.com/", "schemas": { "CloudAiLargeModelsVisionGenerateVideoResponse": { @@ -18559,6 +18564,12 @@ "description": "A response candidate generated from the model.", "id": "GoogleCloudAiplatformV1Candidate", "properties": { + "avgLogprobs": { + "description": "Output only. Average log probability score of the candidate.", + "format": "double", + "readOnly": true, + "type": "number" + }, "citationMetadata": { "$ref": "GoogleCloudAiplatformV1CitationMetadata", "description": "Output only. Source attribution of the generated content.", @@ -20717,6 +20728,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" + }, "updateTime": { "description": "Output only. Timestamp when this EntityType was most recently updated.", "format": "google-datetime", @@ -20825,6 +20846,10 @@ "$ref": "GoogleCloudAiplatformV1GroundednessInput", "description": "Input for groundedness metric." }, + "pairwiseMetricInput": { + "$ref": "GoogleCloudAiplatformV1PairwiseMetricInput", + "description": "Input for pairwise metric." + }, "pairwiseQuestionAnsweringQualityInput": { "$ref": "GoogleCloudAiplatformV1PairwiseQuestionAnsweringQualityInput", "description": "Input for pairwise question answering quality metric." @@ -20833,6 +20858,10 @@ "$ref": "GoogleCloudAiplatformV1PairwiseSummarizationQualityInput", "description": "Input for pairwise summarization quality metric." }, + "pointwiseMetricInput": { + "$ref": "GoogleCloudAiplatformV1PointwiseMetricInput", + "description": "Input for pointwise metric." + }, "questionAnsweringCorrectnessInput": { "$ref": "GoogleCloudAiplatformV1QuestionAnsweringCorrectnessInput", "description": "Input for question answering correctness metric." @@ -20916,6 +20945,10 @@ "$ref": "GoogleCloudAiplatformV1GroundednessResult", "description": "Result for groundedness metric." }, + "pairwiseMetricResult": { + "$ref": "GoogleCloudAiplatformV1PairwiseMetricResult", + "description": "Result for pairwise metric." + }, "pairwiseQuestionAnsweringQualityResult": { "$ref": "GoogleCloudAiplatformV1PairwiseQuestionAnsweringQualityResult", "description": "Result for pairwise question answering quality metric." @@ -20924,6 +20957,10 @@ "$ref": "GoogleCloudAiplatformV1PairwiseSummarizationQualityResult", "description": "Result for pairwise summarization quality metric." }, + "pointwiseMetricResult": { + "$ref": "GoogleCloudAiplatformV1PointwiseMetricResult", + "description": "Generic metrics. Result for pointwise metric." + }, "questionAnsweringCorrectnessResult": { "$ref": "GoogleCloudAiplatformV1QuestionAnsweringCorrectnessResult", "description": "Result for question answering correctness metric." @@ -22242,6 +22279,20 @@ "type": "string" }, "type": "array" + }, + "timeSeries": { + "$ref": "GoogleCloudAiplatformV1FeatureGroupBigQueryTimeSeries", + "description": "Optional. If the source is a time-series source, this can be set to control how downstream sources (ex: FeatureOnlineStore.FeatureView) will treat time series sources. If not set, will treat the source as a time-series source with feature_timestamp as timestamp column and no scan boundary." + } + }, + "type": "object" + }, + "GoogleCloudAiplatformV1FeatureGroupBigQueryTimeSeries": { + "id": "GoogleCloudAiplatformV1FeatureGroupBigQueryTimeSeries", + "properties": { + "timestampColumn": { + "description": "Optional. Column hosting timestamp values for a time-series source. Will be used to determine the latest featureValues for each entity. Optional. If not provided, a feature_timestamp column of type TIMESTAMP will be used.", + "type": "string" } }, "type": "object" @@ -22344,6 +22395,16 @@ "$ref": "GoogleCloudAiplatformV1FeatureOnlineStoreOptimized", "description": "Contains settings for the Optimized store that will be created to serve featureValues for all FeatureViews under this FeatureOnlineStore. When choose Optimized storage type, need to set PrivateServiceConnectConfig.enable_private_service_connect to use private endpoint. Otherwise will use public endpoint by default." }, + "satisfiesPzi": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "satisfiesPzs": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, "state": { "description": "Output only. State of the featureOnlineStore.", "enum": [ @@ -22613,6 +22674,16 @@ "description": "Identifier. Name of the FeatureView. Format: `projects/{project}/locations/{location}/featureOnlineStores/{feature_online_store}/featureViews/{feature_view}`", "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" + }, "syncConfig": { "$ref": "GoogleCloudAiplatformV1FeatureViewSyncConfig", "description": "Configures when data is to be synced/updated for this FeatureView. At the end of the sync the latest featureValues for each entityId of this FeatureView are made ready for online serving." @@ -22802,6 +22873,16 @@ "description": "Output only. Time when this FeatureViewSync is finished.", "readOnly": true }, + "satisfiesPzi": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "satisfiesPzs": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, "syncSummary": { "$ref": "GoogleCloudAiplatformV1FeatureViewSyncSyncSummary", "description": "Output only. Summary of the sync job.", @@ -22879,6 +22960,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" + }, "state": { "description": "Output only. State of the featurestore.", "enum": [ @@ -23459,7 +23550,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." ], @@ -23644,7 +23735,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" }, @@ -23691,6 +23782,11 @@ "$ref": "GoogleCloudAiplatformV1GenerationConfigRoutingConfig", "description": "Optional. Routing configuration." }, + "seed": { + "description": "Optional. Seed.", + "format": "int32", + "type": "integer" + }, "stopSequences": { "description": "Optional. Stop sequences.", "items": { @@ -24404,6 +24500,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" + }, "updateTime": { "description": "Output only. Timestamp when this Index was most recently updated. This also includes any update to the contents of the Index. Note that Operations working on this Index may have their Operations.metadata.generic_metadata.update_time a little after the value of this timestamp, yet that does not mean their results are not already reflected in the Index. Result of any successfully completed Operation on the Index is reflected in it.", "format": "google-datetime", @@ -24629,6 +24735,16 @@ "description": "Optional. If true, the deployed index will be accessible through public endpoint.", "type": "boolean" }, + "satisfiesPzi": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "satisfiesPzs": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, "updateTime": { "description": "Output only. Timestamp when this IndexEndpoint was last updated. This timestamp is not updated when the endpoint's DeployedIndexes are updated, e.g. due to updates of the original Indexes they are the deployments of.", "format": "google-datetime", @@ -26653,6 +26769,16 @@ "description": "Sample Predict instance, same format as PredictRequest.instances, this can be set as a replacement of ModelDeploymentMonitoringJob.predict_instance_schema_uri. If not set, we will generate predict schema from collected predict requests.", "type": "any" }, + "satisfiesPzi": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "satisfiesPzs": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, "scheduleState": { "description": "Output only. Schedule state when the monitoring job is in Running state.", "enum": [ @@ -28544,6 +28670,72 @@ }, "type": "object" }, + "GoogleCloudAiplatformV1PairwiseMetricInput": { + "description": "Input for pairwise metric.", + "id": "GoogleCloudAiplatformV1PairwiseMetricInput", + "properties": { + "instance": { + "$ref": "GoogleCloudAiplatformV1PairwiseMetricInstance", + "description": "Required. Pairwise metric instance." + }, + "metricSpec": { + "$ref": "GoogleCloudAiplatformV1PairwiseMetricSpec", + "description": "Required. Spec for pairwise metric." + } + }, + "type": "object" + }, + "GoogleCloudAiplatformV1PairwiseMetricInstance": { + "description": "Pairwise metric instance. Usually one instance corresponds to one row in an evaluation dataset.", + "id": "GoogleCloudAiplatformV1PairwiseMetricInstance", + "properties": { + "jsonInstance": { + "description": "Instance specified as a json string. String key-value pairs are expected in the json_instance to render PairwiseMetricSpec.instance_prompt_template.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudAiplatformV1PairwiseMetricResult": { + "description": "Spec for pairwise metric result.", + "id": "GoogleCloudAiplatformV1PairwiseMetricResult", + "properties": { + "explanation": { + "description": "Output only. Explanation for pairwise metric score.", + "readOnly": true, + "type": "string" + }, + "pairwiseChoice": { + "description": "Output only. Pairwise metric choice.", + "enum": [ + "PAIRWISE_CHOICE_UNSPECIFIED", + "BASELINE", + "CANDIDATE", + "TIE" + ], + "enumDescriptions": [ + "Unspecified prediction choice.", + "Baseline prediction wins", + "Candidate prediction wins", + "Winner cannot be determined" + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudAiplatformV1PairwiseMetricSpec": { + "description": "Spec for pairwise metric.", + "id": "GoogleCloudAiplatformV1PairwiseMetricSpec", + "properties": { + "metricPromptTemplate": { + "description": "Required. Metric prompt template for pairwise metric.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudAiplatformV1PairwiseQuestionAnsweringQualityInput": { "description": "Input for pairwise question answering quality metric.", "id": "GoogleCloudAiplatformV1PairwiseQuestionAnsweringQualityInput", @@ -29357,6 +29549,61 @@ }, "type": "object" }, + "GoogleCloudAiplatformV1PointwiseMetricInput": { + "description": "Input for pointwise metric.", + "id": "GoogleCloudAiplatformV1PointwiseMetricInput", + "properties": { + "instance": { + "$ref": "GoogleCloudAiplatformV1PointwiseMetricInstance", + "description": "Required. Pointwise metric instance." + }, + "metricSpec": { + "$ref": "GoogleCloudAiplatformV1PointwiseMetricSpec", + "description": "Required. Spec for pointwise metric." + } + }, + "type": "object" + }, + "GoogleCloudAiplatformV1PointwiseMetricInstance": { + "description": "Pointwise metric instance. Usually one instance corresponds to one row in an evaluation dataset.", + "id": "GoogleCloudAiplatformV1PointwiseMetricInstance", + "properties": { + "jsonInstance": { + "description": "Instance specified as a json string. String key-value pairs are expected in the json_instance to render PointwiseMetricSpec.instance_prompt_template.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudAiplatformV1PointwiseMetricResult": { + "description": "Spec for pointwise metric result.", + "id": "GoogleCloudAiplatformV1PointwiseMetricResult", + "properties": { + "explanation": { + "description": "Output only. Explanation for pointwise metric score.", + "readOnly": true, + "type": "string" + }, + "score": { + "description": "Output only. Pointwise metric score.", + "format": "float", + "readOnly": true, + "type": "number" + } + }, + "type": "object" + }, + "GoogleCloudAiplatformV1PointwiseMetricSpec": { + "description": "Spec for pointwise metric.", + "id": "GoogleCloudAiplatformV1PointwiseMetricSpec", + "properties": { + "metricPromptTemplate": { + "description": "Required. Metric prompt template for pointwise metric.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudAiplatformV1Port": { "description": "Represents a network port in a container.", "id": "GoogleCloudAiplatformV1Port", diff --git a/aiplatform/v1/aiplatform-gen.go b/aiplatform/v1/aiplatform-gen.go index e775748bca7..dae57bb4796 100644 --- a/aiplatform/v1/aiplatform-gen.go +++ b/aiplatform/v1/aiplatform-gen.go @@ -3683,6 +3683,8 @@ type GoogleCloudAiplatformV1CancelTuningJobRequest struct { // GoogleCloudAiplatformV1Candidate: A response candidate generated from the // model. type GoogleCloudAiplatformV1Candidate struct { + // AvgLogprobs: Output only. Average log probability score of the candidate. + AvgLogprobs float64 `json:"avgLogprobs,omitempty"` // CitationMetadata: Output only. Source attribution of the generated content. CitationMetadata *GoogleCloudAiplatformV1CitationMetadata `json:"citationMetadata,omitempty"` // Content: Output only. Content parts of the candidate. @@ -3722,15 +3724,15 @@ type GoogleCloudAiplatformV1Candidate struct { // SafetyRatings: Output only. List of ratings for the safety of a response // candidate. There is at most one rating per category. SafetyRatings []*GoogleCloudAiplatformV1SafetyRating `json:"safetyRatings,omitempty"` - // ForceSendFields is a list of field names (e.g. "CitationMetadata") to + // ForceSendFields is a list of field names (e.g. "AvgLogprobs") 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. "CitationMetadata") 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. "AvgLogprobs") 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:"-"` } @@ -3740,6 +3742,20 @@ func (s GoogleCloudAiplatformV1Candidate) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +func (s *GoogleCloudAiplatformV1Candidate) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudAiplatformV1Candidate + var s1 struct { + AvgLogprobs gensupport.JSONFloat64 `json:"avgLogprobs"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.AvgLogprobs = float64(s1.AvgLogprobs) + return nil +} + // GoogleCloudAiplatformV1CheckTrialEarlyStoppingStateMetatdata: This message // will be placed in the metadata field of a google.longrunning.Operation // associated with a CheckTrialEarlyStoppingState request. @@ -6777,6 +6793,10 @@ type GoogleCloudAiplatformV1EntityType struct { // generation time. If unset (or explicitly set to 0), default to 4000 days // TTL. OfflineStorageTtlDays int64 `json:"offlineStorageTtlDays,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"` // UpdateTime: Output only. Timestamp when this EntityType was most recently // updated. UpdateTime string `json:"updateTime,omitempty"` @@ -6947,12 +6967,16 @@ type GoogleCloudAiplatformV1EvaluateInstancesRequest struct { FulfillmentInput *GoogleCloudAiplatformV1FulfillmentInput `json:"fulfillmentInput,omitempty"` // GroundednessInput: Input for groundedness metric. GroundednessInput *GoogleCloudAiplatformV1GroundednessInput `json:"groundednessInput,omitempty"` + // PairwiseMetricInput: Input for pairwise metric. + PairwiseMetricInput *GoogleCloudAiplatformV1PairwiseMetricInput `json:"pairwiseMetricInput,omitempty"` // PairwiseQuestionAnsweringQualityInput: Input for pairwise question answering // quality metric. PairwiseQuestionAnsweringQualityInput *GoogleCloudAiplatformV1PairwiseQuestionAnsweringQualityInput `json:"pairwiseQuestionAnsweringQualityInput,omitempty"` // PairwiseSummarizationQualityInput: Input for pairwise summarization quality // metric. PairwiseSummarizationQualityInput *GoogleCloudAiplatformV1PairwiseSummarizationQualityInput `json:"pairwiseSummarizationQualityInput,omitempty"` + // PointwiseMetricInput: Input for pointwise metric. + PointwiseMetricInput *GoogleCloudAiplatformV1PointwiseMetricInput `json:"pointwiseMetricInput,omitempty"` // QuestionAnsweringCorrectnessInput: Input for question answering correctness // metric. QuestionAnsweringCorrectnessInput *GoogleCloudAiplatformV1QuestionAnsweringCorrectnessInput `json:"questionAnsweringCorrectnessInput,omitempty"` @@ -7018,12 +7042,16 @@ type GoogleCloudAiplatformV1EvaluateInstancesResponse struct { FulfillmentResult *GoogleCloudAiplatformV1FulfillmentResult `json:"fulfillmentResult,omitempty"` // GroundednessResult: Result for groundedness metric. GroundednessResult *GoogleCloudAiplatformV1GroundednessResult `json:"groundednessResult,omitempty"` + // PairwiseMetricResult: Result for pairwise metric. + PairwiseMetricResult *GoogleCloudAiplatformV1PairwiseMetricResult `json:"pairwiseMetricResult,omitempty"` // PairwiseQuestionAnsweringQualityResult: Result for pairwise question // answering quality metric. PairwiseQuestionAnsweringQualityResult *GoogleCloudAiplatformV1PairwiseQuestionAnsweringQualityResult `json:"pairwiseQuestionAnsweringQualityResult,omitempty"` // PairwiseSummarizationQualityResult: Result for pairwise summarization // quality metric. PairwiseSummarizationQualityResult *GoogleCloudAiplatformV1PairwiseSummarizationQualityResult `json:"pairwiseSummarizationQualityResult,omitempty"` + // PointwiseMetricResult: Generic metrics. Result for pointwise metric. + PointwiseMetricResult *GoogleCloudAiplatformV1PointwiseMetricResult `json:"pointwiseMetricResult,omitempty"` // QuestionAnsweringCorrectnessResult: Result for question answering // correctness metric. QuestionAnsweringCorrectnessResult *GoogleCloudAiplatformV1QuestionAnsweringCorrectnessResult `json:"questionAnsweringCorrectnessResult,omitempty"` @@ -8865,6 +8893,12 @@ type GoogleCloudAiplatformV1FeatureGroupBigQuery struct { // EntityIdColumns: Optional. Columns to construct entity_id / row keys. If not // provided defaults to `entity_id`. EntityIdColumns []string `json:"entityIdColumns,omitempty"` + // TimeSeries: Optional. If the source is a time-series source, this can be set + // to control how downstream sources (ex: FeatureOnlineStore.FeatureView) will + // treat time series sources. If not set, will treat the source as a + // time-series source with feature_timestamp as timestamp column and no scan + // boundary. + TimeSeries *GoogleCloudAiplatformV1FeatureGroupBigQueryTimeSeries `json:"timeSeries,omitempty"` // ForceSendFields is a list of field names (e.g. "BigQuerySource") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -8883,6 +8917,30 @@ func (s GoogleCloudAiplatformV1FeatureGroupBigQuery) MarshalJSON() ([]byte, erro return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type GoogleCloudAiplatformV1FeatureGroupBigQueryTimeSeries struct { + // TimestampColumn: Optional. Column hosting timestamp values for a time-series + // source. Will be used to determine the latest featureValues for each entity. + // Optional. If not provided, a feature_timestamp column of type TIMESTAMP will + // be used. + TimestampColumn string `json:"timestampColumn,omitempty"` + // ForceSendFields is a list of field names (e.g. "TimestampColumn") 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. "TimestampColumn") 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 GoogleCloudAiplatformV1FeatureGroupBigQueryTimeSeries) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1FeatureGroupBigQueryTimeSeries + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAiplatformV1FeatureMonitoringStatsAnomaly: A list of historical // SnapshotAnalysis or ImportFeaturesAnalysis stats requested by user, sorted // by FeatureStatsAnomaly.start_time descending. @@ -9023,6 +9081,10 @@ type GoogleCloudAiplatformV1FeatureOnlineStore struct { // PrivateServiceConnectConfig.enable_private_service_connect to use private // endpoint. Otherwise will use public endpoint by default. Optimized *GoogleCloudAiplatformV1FeatureOnlineStoreOptimized `json:"optimized,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"` // State: Output only. State of the featureOnlineStore. // // Possible values: @@ -9431,6 +9493,10 @@ type GoogleCloudAiplatformV1FeatureView struct { // `projects/{project}/locations/{location}/featureOnlineStores/{feature_online_ // store}/featureViews/{feature_view}` 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"` // SyncConfig: Configures when data is to be synced/updated for this // FeatureView. At the end of the sync the latest featureValues for each // entityId of this FeatureView are made ready for online serving. @@ -9690,6 +9756,10 @@ type GoogleCloudAiplatformV1FeatureViewSync struct { Name string `json:"name,omitempty"` // RunTime: Output only. Time when this FeatureViewSync is finished. RunTime *GoogleTypeInterval `json:"runTime,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"` // SyncSummary: Output only. Summary of the sync job. SyncSummary *GoogleCloudAiplatformV1FeatureViewSyncSyncSummary `json:"syncSummary,omitempty"` @@ -9806,6 +9876,10 @@ type GoogleCloudAiplatformV1Featurestore struct { // `offline_storage_ttl_days` for each EntityType under a featurestore. If not // set, default to 4000 days OnlineStorageTtlDays int64 `json:"onlineStorageTtlDays,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"` // State: Output only. State of the featurestore. // // Possible values: @@ -10818,7 +10892,7 @@ type GoogleCloudAiplatformV1FunctionCallingConfig 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 @@ -11080,7 +11154,9 @@ func (s GoogleCloudAiplatformV1GenerateContentResponsePromptFeedback) MarshalJSO type GoogleCloudAiplatformV1GenerateContentResponseUsageMetadata 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 @@ -11127,6 +11203,8 @@ type GoogleCloudAiplatformV1GenerationConfig struct { ResponseSchema *GoogleCloudAiplatformV1Schema `json:"responseSchema,omitempty"` // RoutingConfig: Optional. Routing configuration. RoutingConfig *GoogleCloudAiplatformV1GenerationConfigRoutingConfig `json:"routingConfig,omitempty"` + // Seed: Optional. Seed. + Seed int64 `json:"seed,omitempty"` // StopSequences: Optional. Stop sequences. StopSequences []string `json:"stopSequences,omitempty"` // Temperature: Optional. Controls the randomness of predictions. @@ -12034,6 +12112,10 @@ type GoogleCloudAiplatformV1Index struct { MetadataSchemaUri string `json:"metadataSchemaUri,omitempty"` // Name: Output only. The resource name of the Index. 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"` // UpdateTime: Output only. Timestamp when this Index was most recently // updated. This also includes any update to the contents of the Index. Note // that Operations working on this Index may have their @@ -12329,6 +12411,10 @@ type GoogleCloudAiplatformV1IndexEndpoint struct { // PublicEndpointEnabled: Optional. If true, the deployed index will be // accessible through public endpoint. PublicEndpointEnabled bool `json:"publicEndpointEnabled,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"` // UpdateTime: Output only. Timestamp when this IndexEndpoint was last updated. // This timestamp is not updated when the endpoint's DeployedIndexes are // updated, e.g. due to updates of the original Indexes they are the @@ -15354,6 +15440,10 @@ type GoogleCloudAiplatformV1ModelDeploymentMonitoringJob struct { // ModelDeploymentMonitoringJob.predict_instance_schema_uri. If not set, we // will generate predict schema from collected predict requests. SamplePredictInstance interface{} `json:"samplePredictInstance,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"` // ScheduleState: Output only. Schedule state when the monitoring job is in // Running state. // @@ -17810,6 +17900,108 @@ func (s GoogleCloudAiplatformV1NotebookRuntimeTemplateRef) MarshalJSON() ([]byte return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudAiplatformV1PairwiseMetricInput: Input for pairwise metric. +type GoogleCloudAiplatformV1PairwiseMetricInput struct { + // Instance: Required. Pairwise metric instance. + Instance *GoogleCloudAiplatformV1PairwiseMetricInstance `json:"instance,omitempty"` + // MetricSpec: Required. Spec for pairwise metric. + MetricSpec *GoogleCloudAiplatformV1PairwiseMetricSpec `json:"metricSpec,omitempty"` + // ForceSendFields is a list of field names (e.g. "Instance") 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. "Instance") 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 GoogleCloudAiplatformV1PairwiseMetricInput) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1PairwiseMetricInput + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudAiplatformV1PairwiseMetricInstance: Pairwise metric instance. +// Usually one instance corresponds to one row in an evaluation dataset. +type GoogleCloudAiplatformV1PairwiseMetricInstance struct { + // JsonInstance: Instance specified as a json string. String key-value pairs + // are expected in the json_instance to render + // PairwiseMetricSpec.instance_prompt_template. + JsonInstance string `json:"jsonInstance,omitempty"` + // ForceSendFields is a list of field names (e.g. "JsonInstance") 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. "JsonInstance") 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 GoogleCloudAiplatformV1PairwiseMetricInstance) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1PairwiseMetricInstance + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudAiplatformV1PairwiseMetricResult: Spec for pairwise metric +// result. +type GoogleCloudAiplatformV1PairwiseMetricResult struct { + // Explanation: Output only. Explanation for pairwise metric score. + Explanation string `json:"explanation,omitempty"` + // PairwiseChoice: Output only. Pairwise metric choice. + // + // Possible values: + // "PAIRWISE_CHOICE_UNSPECIFIED" - Unspecified prediction choice. + // "BASELINE" - Baseline prediction wins + // "CANDIDATE" - Candidate prediction wins + // "TIE" - Winner cannot be determined + PairwiseChoice string `json:"pairwiseChoice,omitempty"` + // ForceSendFields is a list of field names (e.g. "Explanation") 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. "Explanation") 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 GoogleCloudAiplatformV1PairwiseMetricResult) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1PairwiseMetricResult + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudAiplatformV1PairwiseMetricSpec: Spec for pairwise metric. +type GoogleCloudAiplatformV1PairwiseMetricSpec struct { + // MetricPromptTemplate: Required. Metric prompt template for pairwise metric. + MetricPromptTemplate string `json:"metricPromptTemplate,omitempty"` + // ForceSendFields is a list of field names (e.g. "MetricPromptTemplate") 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. "MetricPromptTemplate") 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 GoogleCloudAiplatformV1PairwiseMetricSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1PairwiseMetricSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAiplatformV1PairwiseQuestionAnsweringQualityInput: Input for // pairwise question answering quality metric. type GoogleCloudAiplatformV1PairwiseQuestionAnsweringQualityInput struct { @@ -18725,6 +18917,116 @@ func (s GoogleCloudAiplatformV1PipelineTemplateMetadata) MarshalJSON() ([]byte, return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudAiplatformV1PointwiseMetricInput: Input for pointwise metric. +type GoogleCloudAiplatformV1PointwiseMetricInput struct { + // Instance: Required. Pointwise metric instance. + Instance *GoogleCloudAiplatformV1PointwiseMetricInstance `json:"instance,omitempty"` + // MetricSpec: Required. Spec for pointwise metric. + MetricSpec *GoogleCloudAiplatformV1PointwiseMetricSpec `json:"metricSpec,omitempty"` + // ForceSendFields is a list of field names (e.g. "Instance") 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. "Instance") 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 GoogleCloudAiplatformV1PointwiseMetricInput) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1PointwiseMetricInput + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudAiplatformV1PointwiseMetricInstance: Pointwise metric instance. +// Usually one instance corresponds to one row in an evaluation dataset. +type GoogleCloudAiplatformV1PointwiseMetricInstance struct { + // JsonInstance: Instance specified as a json string. String key-value pairs + // are expected in the json_instance to render + // PointwiseMetricSpec.instance_prompt_template. + JsonInstance string `json:"jsonInstance,omitempty"` + // ForceSendFields is a list of field names (e.g. "JsonInstance") 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. "JsonInstance") 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 GoogleCloudAiplatformV1PointwiseMetricInstance) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1PointwiseMetricInstance + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudAiplatformV1PointwiseMetricResult: Spec for pointwise metric +// result. +type GoogleCloudAiplatformV1PointwiseMetricResult struct { + // Explanation: Output only. Explanation for pointwise metric score. + Explanation string `json:"explanation,omitempty"` + // Score: Output only. Pointwise metric score. + Score float64 `json:"score,omitempty"` + // ForceSendFields is a list of field names (e.g. "Explanation") 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. "Explanation") 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 GoogleCloudAiplatformV1PointwiseMetricResult) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1PointwiseMetricResult + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleCloudAiplatformV1PointwiseMetricResult) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudAiplatformV1PointwiseMetricResult + var s1 struct { + Score gensupport.JSONFloat64 `json:"score"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Score = float64(s1.Score) + return nil +} + +// GoogleCloudAiplatformV1PointwiseMetricSpec: Spec for pointwise metric. +type GoogleCloudAiplatformV1PointwiseMetricSpec struct { + // MetricPromptTemplate: Required. Metric prompt template for pointwise metric. + MetricPromptTemplate string `json:"metricPromptTemplate,omitempty"` + // ForceSendFields is a list of field names (e.g. "MetricPromptTemplate") 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. "MetricPromptTemplate") 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 GoogleCloudAiplatformV1PointwiseMetricSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1PointwiseMetricSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAiplatformV1Port: Represents a network port in a container. type GoogleCloudAiplatformV1Port struct { // ContainerPort: The number of the port to expose on the pod's IP address. @@ -95131,6 +95433,13 @@ func (r *PublishersModelsService) Get(name string) *PublishersModelsGetCall { return c } +// HuggingFaceToken sets the optional parameter "huggingFaceToken": Token used +// to access Hugging Face gated models. +func (c *PublishersModelsGetCall) HuggingFaceToken(huggingFaceToken string) *PublishersModelsGetCall { + c.urlParams_.Set("huggingFaceToken", huggingFaceToken) + return c +} + // IsHuggingFaceModel sets the optional parameter "isHuggingFaceModel": Boolean // indicates whether the requested model is a Hugging Face model. func (c *PublishersModelsGetCall) IsHuggingFaceModel(isHuggingFaceModel bool) *PublishersModelsGetCall { diff --git a/aiplatform/v1beta1/aiplatform-api.json b/aiplatform/v1beta1/aiplatform-api.json index 429f83057ce..e4d53a0c0b7 100644 --- a/aiplatform/v1beta1/aiplatform-api.json +++ b/aiplatform/v1beta1/aiplatform-api.json @@ -20336,6 +20336,11 @@ "name" ], "parameters": { + "huggingFaceToken": { + "description": "Optional. Token used to access Hugging Face gated models.", + "location": "query", + "type": "string" + }, "isHuggingFaceModel": { "description": "Optional. Boolean indicates whether the requested model is a Hugging Face model.", "location": "query", @@ -20452,7 +20457,7 @@ } } }, - "revision": "20240727", + "revision": "20240809", "rootUrl": "https://aiplatform.googleapis.com/", "schemas": { "CloudAiLargeModelsVisionGenerateVideoResponse": { @@ -22304,6 +22309,12 @@ "description": "A response candidate generated from the model.", "id": "GoogleCloudAiplatformV1beta1Candidate", "properties": { + "avgLogprobs": { + "description": "Output only. Average log probability score of the candidate.", + "format": "double", + "readOnly": true, + "type": "number" + }, "citationMetadata": { "$ref": "GoogleCloudAiplatformV1beta1CitationMetadata", "description": "Output only. Source attribution of the generated content.", @@ -24770,6 +24781,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" + }, "updateTime": { "description": "Output only. Timestamp when this EntityType was most recently updated.", "format": "google-datetime", @@ -24878,6 +24899,10 @@ "$ref": "GoogleCloudAiplatformV1beta1GroundednessInput", "description": "Input for groundedness metric." }, + "pairwiseMetricInput": { + "$ref": "GoogleCloudAiplatformV1beta1PairwiseMetricInput", + "description": "Input for pairwise metric." + }, "pairwiseQuestionAnsweringQualityInput": { "$ref": "GoogleCloudAiplatformV1beta1PairwiseQuestionAnsweringQualityInput", "description": "Input for pairwise question answering quality metric." @@ -24886,6 +24911,10 @@ "$ref": "GoogleCloudAiplatformV1beta1PairwiseSummarizationQualityInput", "description": "Input for pairwise summarization quality metric." }, + "pointwiseMetricInput": { + "$ref": "GoogleCloudAiplatformV1beta1PointwiseMetricInput", + "description": "Input for pointwise metric." + }, "questionAnsweringCorrectnessInput": { "$ref": "GoogleCloudAiplatformV1beta1QuestionAnsweringCorrectnessInput", "description": "Input for question answering correctness metric." @@ -24969,6 +24998,10 @@ "$ref": "GoogleCloudAiplatformV1beta1GroundednessResult", "description": "Result for groundedness metric." }, + "pairwiseMetricResult": { + "$ref": "GoogleCloudAiplatformV1beta1PairwiseMetricResult", + "description": "Result for pairwise metric." + }, "pairwiseQuestionAnsweringQualityResult": { "$ref": "GoogleCloudAiplatformV1beta1PairwiseQuestionAnsweringQualityResult", "description": "Result for pairwise question answering quality metric." @@ -24977,6 +25010,10 @@ "$ref": "GoogleCloudAiplatformV1beta1PairwiseSummarizationQualityResult", "description": "Result for pairwise summarization quality metric." }, + "pointwiseMetricResult": { + "$ref": "GoogleCloudAiplatformV1beta1PointwiseMetricResult", + "description": "Generic metrics. Result for pointwise metric." + }, "questionAnsweringCorrectnessResult": { "$ref": "GoogleCloudAiplatformV1beta1QuestionAnsweringCorrectnessResult", "description": "Result for question answering correctness metric." @@ -26454,6 +26491,20 @@ "type": "string" }, "type": "array" + }, + "timeSeries": { + "$ref": "GoogleCloudAiplatformV1beta1FeatureGroupBigQueryTimeSeries", + "description": "Optional. If the source is a time-series source, this can be set to control how downstream sources (ex: FeatureOnlineStore.FeatureView) will treat time series sources. If not set, will treat the source as a time-series source with feature_timestamp as timestamp column and no scan boundary." + } + }, + "type": "object" + }, + "GoogleCloudAiplatformV1beta1FeatureGroupBigQueryTimeSeries": { + "id": "GoogleCloudAiplatformV1beta1FeatureGroupBigQueryTimeSeries", + "properties": { + "timestampColumn": { + "description": "Optional. Column hosting timestamp values for a time-series source. Will be used to determine the latest featureValues for each entity. Optional. If not provided, a feature_timestamp column of type TIMESTAMP will be used.", + "type": "string" } }, "type": "object" @@ -26561,6 +26612,16 @@ "$ref": "GoogleCloudAiplatformV1beta1FeatureOnlineStoreOptimized", "description": "Contains settings for the Optimized store that will be created to serve featureValues for all FeatureViews under this FeatureOnlineStore. When choose Optimized storage type, need to set PrivateServiceConnectConfig.enable_private_service_connect to use private endpoint. Otherwise will use public endpoint by default." }, + "satisfiesPzi": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "satisfiesPzs": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, "state": { "description": "Output only. State of the featureOnlineStore.", "enum": [ @@ -26842,6 +26903,16 @@ "description": "Identifier. Name of the FeatureView. Format: `projects/{project}/locations/{location}/featureOnlineStores/{feature_online_store}/featureViews/{feature_view}`", "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" + }, "serviceAccountEmail": { "description": "Output only. A Service Account unique to this FeatureView. The role bigquery.dataViewer should be granted to this service account to allow Vertex AI Feature Store to sync data to the online store.", "readOnly": true, @@ -27055,6 +27126,16 @@ "description": "Output only. Time when this FeatureViewSync is finished.", "readOnly": true }, + "satisfiesPzi": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "satisfiesPzs": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, "syncSummary": { "$ref": "GoogleCloudAiplatformV1beta1FeatureViewSyncSyncSummary", "description": "Output only. Summary of the sync job.", @@ -27200,6 +27281,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" + }, "state": { "description": "Output only. State of the featurestore.", "enum": [ @@ -27806,7 +27897,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." ], @@ -28034,7 +28125,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" }, @@ -28107,6 +28198,11 @@ "$ref": "GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfig", "description": "Optional. Routing configuration." }, + "seed": { + "description": "Optional. Seed.", + "format": "int32", + "type": "integer" + }, "stopSequences": { "description": "Optional. Stop sequences.", "items": { @@ -28829,6 +28925,10 @@ "$ref": "GoogleCloudAiplatformV1beta1RagFileChunkingConfig", "description": "Specifies the size and overlap of chunks after importing RagFiles." }, + "ragFileParsingConfig": { + "$ref": "GoogleCloudAiplatformV1beta1RagFileParsingConfig", + "description": "Specifies the parsing config for RagFiles." + }, "slackSource": { "$ref": "GoogleCloudAiplatformV1beta1SlackSource", "description": "Slack channels with their corresponding access tokens." @@ -28920,6 +29020,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" + }, "updateTime": { "description": "Output only. Timestamp when this Index was most recently updated. This also includes any update to the contents of the Index. Note that Operations working on this Index may have their Operations.metadata.generic_metadata.update_time a little after the value of this timestamp, yet that does not mean their results are not already reflected in the Index. Result of any successfully completed Operation on the Index is reflected in it.", "format": "google-datetime", @@ -29145,6 +29255,16 @@ "description": "Optional. If true, the deployed index will be accessible through public endpoint.", "type": "boolean" }, + "satisfiesPzi": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "satisfiesPzs": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, "updateTime": { "description": "Output only. Timestamp when this IndexEndpoint was last updated. This timestamp is not updated when the endpoint's DeployedIndexes are updated, e.g. due to updates of the original Indexes they are the deployments of.", "format": "google-datetime", @@ -31366,6 +31486,16 @@ "description": "Sample Predict instance, same format as PredictRequest.instances, this can be set as a replacement of ModelDeploymentMonitoringJob.predict_instance_schema_uri. If not set, we will generate predict schema from collected predict requests.", "type": "any" }, + "satisfiesPzi": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "satisfiesPzs": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, "scheduleState": { "description": "Output only. Schedule state when the monitoring job is in Running state.", "enum": [ @@ -34069,6 +34199,72 @@ }, "type": "object" }, + "GoogleCloudAiplatformV1beta1PairwiseMetricInput": { + "description": "Input for pairwise metric.", + "id": "GoogleCloudAiplatformV1beta1PairwiseMetricInput", + "properties": { + "instance": { + "$ref": "GoogleCloudAiplatformV1beta1PairwiseMetricInstance", + "description": "Required. Pairwise metric instance." + }, + "metricSpec": { + "$ref": "GoogleCloudAiplatformV1beta1PairwiseMetricSpec", + "description": "Required. Spec for pairwise metric." + } + }, + "type": "object" + }, + "GoogleCloudAiplatformV1beta1PairwiseMetricInstance": { + "description": "Pairwise metric instance. Usually one instance corresponds to one row in an evaluation dataset.", + "id": "GoogleCloudAiplatformV1beta1PairwiseMetricInstance", + "properties": { + "jsonInstance": { + "description": "Instance specified as a json string. String key-value pairs are expected in the json_instance to render PairwiseMetricSpec.instance_prompt_template.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudAiplatformV1beta1PairwiseMetricResult": { + "description": "Spec for pairwise metric result.", + "id": "GoogleCloudAiplatformV1beta1PairwiseMetricResult", + "properties": { + "explanation": { + "description": "Output only. Explanation for pairwise metric score.", + "readOnly": true, + "type": "string" + }, + "pairwiseChoice": { + "description": "Output only. Pairwise metric choice.", + "enum": [ + "PAIRWISE_CHOICE_UNSPECIFIED", + "BASELINE", + "CANDIDATE", + "TIE" + ], + "enumDescriptions": [ + "Unspecified prediction choice.", + "Baseline prediction wins", + "Candidate prediction wins", + "Winner cannot be determined" + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudAiplatformV1beta1PairwiseMetricSpec": { + "description": "Spec for pairwise metric.", + "id": "GoogleCloudAiplatformV1beta1PairwiseMetricSpec", + "properties": { + "metricPromptTemplate": { + "description": "Required. Metric prompt template for pairwise metric.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudAiplatformV1beta1PairwiseQuestionAnsweringQualityInput": { "description": "Input for pairwise question answering quality metric.", "id": "GoogleCloudAiplatformV1beta1PairwiseQuestionAnsweringQualityInput", @@ -34896,6 +35092,61 @@ }, "type": "object" }, + "GoogleCloudAiplatformV1beta1PointwiseMetricInput": { + "description": "Input for pointwise metric.", + "id": "GoogleCloudAiplatformV1beta1PointwiseMetricInput", + "properties": { + "instance": { + "$ref": "GoogleCloudAiplatformV1beta1PointwiseMetricInstance", + "description": "Required. Pointwise metric instance." + }, + "metricSpec": { + "$ref": "GoogleCloudAiplatformV1beta1PointwiseMetricSpec", + "description": "Required. Spec for pointwise metric." + } + }, + "type": "object" + }, + "GoogleCloudAiplatformV1beta1PointwiseMetricInstance": { + "description": "Pointwise metric instance. Usually one instance corresponds to one row in an evaluation dataset.", + "id": "GoogleCloudAiplatformV1beta1PointwiseMetricInstance", + "properties": { + "jsonInstance": { + "description": "Instance specified as a json string. String key-value pairs are expected in the json_instance to render PointwiseMetricSpec.instance_prompt_template.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudAiplatformV1beta1PointwiseMetricResult": { + "description": "Spec for pointwise metric result.", + "id": "GoogleCloudAiplatformV1beta1PointwiseMetricResult", + "properties": { + "explanation": { + "description": "Output only. Explanation for pointwise metric score.", + "readOnly": true, + "type": "string" + }, + "score": { + "description": "Output only. Pointwise metric score.", + "format": "float", + "readOnly": true, + "type": "number" + } + }, + "type": "object" + }, + "GoogleCloudAiplatformV1beta1PointwiseMetricSpec": { + "description": "Spec for pointwise metric.", + "id": "GoogleCloudAiplatformV1beta1PointwiseMetricSpec", + "properties": { + "metricPromptTemplate": { + "description": "Required. Metric prompt template for pointwise metric.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudAiplatformV1beta1Port": { "description": "Represents a network port in a container.", "id": "GoogleCloudAiplatformV1beta1Port", @@ -36375,6 +36626,21 @@ }, "type": "object" }, + "GoogleCloudAiplatformV1beta1RagFileParsingConfig": { + "description": "Specifies the parsing config for RagFiles.", + "id": "GoogleCloudAiplatformV1beta1RagFileParsingConfig", + "properties": { + "parsePdfsUsingOcr": { + "description": "Whether to use OCR for PDFs.", + "type": "boolean" + }, + "useAdvancedPdfParsing": { + "description": "Whether to use advanced PDF parsing.", + "type": "boolean" + } + }, + "type": "object" + }, "GoogleCloudAiplatformV1beta1RagQuery": { "description": "A query to retrieve relevant contexts.", "id": "GoogleCloudAiplatformV1beta1RagQuery", diff --git a/aiplatform/v1beta1/aiplatform-gen.go b/aiplatform/v1beta1/aiplatform-gen.go index 8c972b68413..d63a29924a3 100644 --- a/aiplatform/v1beta1/aiplatform-gen.go +++ b/aiplatform/v1beta1/aiplatform-gen.go @@ -4383,6 +4383,8 @@ type GoogleCloudAiplatformV1beta1CancelTuningJobRequest struct { // GoogleCloudAiplatformV1beta1Candidate: A response candidate generated from // the model. type GoogleCloudAiplatformV1beta1Candidate struct { + // AvgLogprobs: Output only. Average log probability score of the candidate. + AvgLogprobs float64 `json:"avgLogprobs,omitempty"` // CitationMetadata: Output only. Source attribution of the generated content. CitationMetadata *GoogleCloudAiplatformV1beta1CitationMetadata `json:"citationMetadata,omitempty"` // Content: Output only. Content parts of the candidate. @@ -4422,15 +4424,15 @@ type GoogleCloudAiplatformV1beta1Candidate struct { // SafetyRatings: Output only. List of ratings for the safety of a response // candidate. There is at most one rating per category. SafetyRatings []*GoogleCloudAiplatformV1beta1SafetyRating `json:"safetyRatings,omitempty"` - // ForceSendFields is a list of field names (e.g. "CitationMetadata") to + // ForceSendFields is a list of field names (e.g. "AvgLogprobs") 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. "CitationMetadata") 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. "AvgLogprobs") 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:"-"` } @@ -4440,6 +4442,20 @@ func (s GoogleCloudAiplatformV1beta1Candidate) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +func (s *GoogleCloudAiplatformV1beta1Candidate) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudAiplatformV1beta1Candidate + var s1 struct { + AvgLogprobs gensupport.JSONFloat64 `json:"avgLogprobs"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.AvgLogprobs = float64(s1.AvgLogprobs) + return nil +} + // GoogleCloudAiplatformV1beta1CheckTrialEarlyStoppingStateMetatdata: This // message will be placed in the metadata field of a // google.longrunning.Operation associated with a CheckTrialEarlyStoppingState @@ -7904,6 +7920,10 @@ type GoogleCloudAiplatformV1beta1EntityType struct { // generation time. If unset (or explicitly set to 0), default to 4000 days // TTL. OfflineStorageTtlDays int64 `json:"offlineStorageTtlDays,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"` // UpdateTime: Output only. Timestamp when this EntityType was most recently // updated. UpdateTime string `json:"updateTime,omitempty"` @@ -8074,12 +8094,16 @@ type GoogleCloudAiplatformV1beta1EvaluateInstancesRequest struct { FulfillmentInput *GoogleCloudAiplatformV1beta1FulfillmentInput `json:"fulfillmentInput,omitempty"` // GroundednessInput: Input for groundedness metric. GroundednessInput *GoogleCloudAiplatformV1beta1GroundednessInput `json:"groundednessInput,omitempty"` + // PairwiseMetricInput: Input for pairwise metric. + PairwiseMetricInput *GoogleCloudAiplatformV1beta1PairwiseMetricInput `json:"pairwiseMetricInput,omitempty"` // PairwiseQuestionAnsweringQualityInput: Input for pairwise question answering // quality metric. PairwiseQuestionAnsweringQualityInput *GoogleCloudAiplatformV1beta1PairwiseQuestionAnsweringQualityInput `json:"pairwiseQuestionAnsweringQualityInput,omitempty"` // PairwiseSummarizationQualityInput: Input for pairwise summarization quality // metric. PairwiseSummarizationQualityInput *GoogleCloudAiplatformV1beta1PairwiseSummarizationQualityInput `json:"pairwiseSummarizationQualityInput,omitempty"` + // PointwiseMetricInput: Input for pointwise metric. + PointwiseMetricInput *GoogleCloudAiplatformV1beta1PointwiseMetricInput `json:"pointwiseMetricInput,omitempty"` // QuestionAnsweringCorrectnessInput: Input for question answering correctness // metric. QuestionAnsweringCorrectnessInput *GoogleCloudAiplatformV1beta1QuestionAnsweringCorrectnessInput `json:"questionAnsweringCorrectnessInput,omitempty"` @@ -8145,12 +8169,16 @@ type GoogleCloudAiplatformV1beta1EvaluateInstancesResponse struct { FulfillmentResult *GoogleCloudAiplatformV1beta1FulfillmentResult `json:"fulfillmentResult,omitempty"` // GroundednessResult: Result for groundedness metric. GroundednessResult *GoogleCloudAiplatformV1beta1GroundednessResult `json:"groundednessResult,omitempty"` + // PairwiseMetricResult: Result for pairwise metric. + PairwiseMetricResult *GoogleCloudAiplatformV1beta1PairwiseMetricResult `json:"pairwiseMetricResult,omitempty"` // PairwiseQuestionAnsweringQualityResult: Result for pairwise question // answering quality metric. PairwiseQuestionAnsweringQualityResult *GoogleCloudAiplatformV1beta1PairwiseQuestionAnsweringQualityResult `json:"pairwiseQuestionAnsweringQualityResult,omitempty"` // PairwiseSummarizationQualityResult: Result for pairwise summarization // quality metric. PairwiseSummarizationQualityResult *GoogleCloudAiplatformV1beta1PairwiseSummarizationQualityResult `json:"pairwiseSummarizationQualityResult,omitempty"` + // PointwiseMetricResult: Generic metrics. Result for pointwise metric. + PointwiseMetricResult *GoogleCloudAiplatformV1beta1PointwiseMetricResult `json:"pointwiseMetricResult,omitempty"` // QuestionAnsweringCorrectnessResult: Result for question answering // correctness metric. QuestionAnsweringCorrectnessResult *GoogleCloudAiplatformV1beta1QuestionAnsweringCorrectnessResult `json:"questionAnsweringCorrectnessResult,omitempty"` @@ -10202,6 +10230,12 @@ type GoogleCloudAiplatformV1beta1FeatureGroupBigQuery struct { // EntityIdColumns: Optional. Columns to construct entity_id / row keys. If not // provided defaults to `entity_id`. EntityIdColumns []string `json:"entityIdColumns,omitempty"` + // TimeSeries: Optional. If the source is a time-series source, this can be set + // to control how downstream sources (ex: FeatureOnlineStore.FeatureView) will + // treat time series sources. If not set, will treat the source as a + // time-series source with feature_timestamp as timestamp column and no scan + // boundary. + TimeSeries *GoogleCloudAiplatformV1beta1FeatureGroupBigQueryTimeSeries `json:"timeSeries,omitempty"` // ForceSendFields is a list of field names (e.g. "BigQuerySource") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -10220,6 +10254,30 @@ func (s GoogleCloudAiplatformV1beta1FeatureGroupBigQuery) MarshalJSON() ([]byte, return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type GoogleCloudAiplatformV1beta1FeatureGroupBigQueryTimeSeries struct { + // TimestampColumn: Optional. Column hosting timestamp values for a time-series + // source. Will be used to determine the latest featureValues for each entity. + // Optional. If not provided, a feature_timestamp column of type TIMESTAMP will + // be used. + TimestampColumn string `json:"timestampColumn,omitempty"` + // ForceSendFields is a list of field names (e.g. "TimestampColumn") 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. "TimestampColumn") 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 GoogleCloudAiplatformV1beta1FeatureGroupBigQueryTimeSeries) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1FeatureGroupBigQueryTimeSeries + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAiplatformV1beta1FeatureMonitoringStatsAnomaly: A list of // historical SnapshotAnalysis or ImportFeaturesAnalysis stats requested by // user, sorted by FeatureStatsAnomaly.start_time descending. @@ -10366,6 +10424,10 @@ type GoogleCloudAiplatformV1beta1FeatureOnlineStore struct { // PrivateServiceConnectConfig.enable_private_service_connect to use private // endpoint. Otherwise will use public endpoint by default. Optimized *GoogleCloudAiplatformV1beta1FeatureOnlineStoreOptimized `json:"optimized,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"` // State: Output only. State of the featureOnlineStore. // // Possible values: @@ -10802,6 +10864,10 @@ type GoogleCloudAiplatformV1beta1FeatureView struct { // `projects/{project}/locations/{location}/featureOnlineStores/{feature_online_ // store}/featureViews/{feature_view}` 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"` // ServiceAccountEmail: Output only. A Service Account unique to this // FeatureView. The role bigquery.dataViewer should be granted to this service // account to allow Vertex AI Feature Store to sync data to the online store. @@ -11088,6 +11154,10 @@ type GoogleCloudAiplatformV1beta1FeatureViewSync struct { Name string `json:"name,omitempty"` // RunTime: Output only. Time when this FeatureViewSync is finished. RunTime *GoogleTypeInterval `json:"runTime,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"` // SyncSummary: Output only. Summary of the sync job. SyncSummary *GoogleCloudAiplatformV1beta1FeatureViewSyncSyncSummary `json:"syncSummary,omitempty"` @@ -11290,6 +11360,10 @@ type GoogleCloudAiplatformV1beta1Featurestore struct { // `offline_storage_ttl_days` for each EntityType under a featurestore. If not // set, default to 4000 days OnlineStorageTtlDays int64 `json:"onlineStorageTtlDays,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"` // State: Output only. State of the featurestore. // // Possible values: @@ -12321,7 +12395,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 @@ -12654,7 +12728,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 @@ -12728,6 +12804,8 @@ type GoogleCloudAiplatformV1beta1GenerationConfig struct { ResponseSchema *GoogleCloudAiplatformV1beta1Schema `json:"responseSchema,omitempty"` // RoutingConfig: Optional. Routing configuration. RoutingConfig *GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfig `json:"routingConfig,omitempty"` + // Seed: Optional. Seed. + Seed int64 `json:"seed,omitempty"` // StopSequences: Optional. Stop sequences. StopSequences []string `json:"stopSequences,omitempty"` // Temperature: Optional. Controls the randomness of predictions. @@ -13683,6 +13761,8 @@ type GoogleCloudAiplatformV1beta1ImportRagFilesConfig struct { // RagFileChunkingConfig: Specifies the size and overlap of chunks after // importing RagFiles. RagFileChunkingConfig *GoogleCloudAiplatformV1beta1RagFileChunkingConfig `json:"ragFileChunkingConfig,omitempty"` + // RagFileParsingConfig: Specifies the parsing config for RagFiles. + RagFileParsingConfig *GoogleCloudAiplatformV1beta1RagFileParsingConfig `json:"ragFileParsingConfig,omitempty"` // SlackSource: Slack channels with their corresponding access tokens. SlackSource *GoogleCloudAiplatformV1beta1SlackSource `json:"slackSource,omitempty"` // ForceSendFields is a list of field names (e.g. "GcsSource") to @@ -13782,6 +13862,10 @@ type GoogleCloudAiplatformV1beta1Index struct { MetadataSchemaUri string `json:"metadataSchemaUri,omitempty"` // Name: Output only. The resource name of the Index. 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"` // UpdateTime: Output only. Timestamp when this Index was most recently // updated. This also includes any update to the contents of the Index. Note // that Operations working on this Index may have their @@ -14078,6 +14162,10 @@ type GoogleCloudAiplatformV1beta1IndexEndpoint struct { // PublicEndpointEnabled: Optional. If true, the deployed index will be // accessible through public endpoint. PublicEndpointEnabled bool `json:"publicEndpointEnabled,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"` // UpdateTime: Output only. Timestamp when this IndexEndpoint was last updated. // This timestamp is not updated when the endpoint's DeployedIndexes are // updated, e.g. due to updates of the original Indexes they are the @@ -17397,6 +17485,10 @@ type GoogleCloudAiplatformV1beta1ModelDeploymentMonitoringJob struct { // ModelDeploymentMonitoringJob.predict_instance_schema_uri. If not set, we // will generate predict schema from collected predict requests. SamplePredictInstance interface{} `json:"samplePredictInstance,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"` // ScheduleState: Output only. Schedule state when the monitoring job is in // Running state. // @@ -21036,6 +21128,109 @@ func (s GoogleCloudAiplatformV1beta1NotebookRuntimeTemplateRef) MarshalJSON() ([ return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudAiplatformV1beta1PairwiseMetricInput: Input for pairwise metric. +type GoogleCloudAiplatformV1beta1PairwiseMetricInput struct { + // Instance: Required. Pairwise metric instance. + Instance *GoogleCloudAiplatformV1beta1PairwiseMetricInstance `json:"instance,omitempty"` + // MetricSpec: Required. Spec for pairwise metric. + MetricSpec *GoogleCloudAiplatformV1beta1PairwiseMetricSpec `json:"metricSpec,omitempty"` + // ForceSendFields is a list of field names (e.g. "Instance") 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. "Instance") 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 GoogleCloudAiplatformV1beta1PairwiseMetricInput) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1PairwiseMetricInput + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudAiplatformV1beta1PairwiseMetricInstance: Pairwise metric +// instance. Usually one instance corresponds to one row in an evaluation +// dataset. +type GoogleCloudAiplatformV1beta1PairwiseMetricInstance struct { + // JsonInstance: Instance specified as a json string. String key-value pairs + // are expected in the json_instance to render + // PairwiseMetricSpec.instance_prompt_template. + JsonInstance string `json:"jsonInstance,omitempty"` + // ForceSendFields is a list of field names (e.g. "JsonInstance") 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. "JsonInstance") 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 GoogleCloudAiplatformV1beta1PairwiseMetricInstance) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1PairwiseMetricInstance + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudAiplatformV1beta1PairwiseMetricResult: Spec for pairwise metric +// result. +type GoogleCloudAiplatformV1beta1PairwiseMetricResult struct { + // Explanation: Output only. Explanation for pairwise metric score. + Explanation string `json:"explanation,omitempty"` + // PairwiseChoice: Output only. Pairwise metric choice. + // + // Possible values: + // "PAIRWISE_CHOICE_UNSPECIFIED" - Unspecified prediction choice. + // "BASELINE" - Baseline prediction wins + // "CANDIDATE" - Candidate prediction wins + // "TIE" - Winner cannot be determined + PairwiseChoice string `json:"pairwiseChoice,omitempty"` + // ForceSendFields is a list of field names (e.g. "Explanation") 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. "Explanation") 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 GoogleCloudAiplatformV1beta1PairwiseMetricResult) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1PairwiseMetricResult + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudAiplatformV1beta1PairwiseMetricSpec: Spec for pairwise metric. +type GoogleCloudAiplatformV1beta1PairwiseMetricSpec struct { + // MetricPromptTemplate: Required. Metric prompt template for pairwise metric. + MetricPromptTemplate string `json:"metricPromptTemplate,omitempty"` + // ForceSendFields is a list of field names (e.g. "MetricPromptTemplate") 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. "MetricPromptTemplate") 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 GoogleCloudAiplatformV1beta1PairwiseMetricSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1PairwiseMetricSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAiplatformV1beta1PairwiseQuestionAnsweringQualityInput: Input for // pairwise question answering quality metric. type GoogleCloudAiplatformV1beta1PairwiseQuestionAnsweringQualityInput struct { @@ -21959,6 +22154,118 @@ func (s GoogleCloudAiplatformV1beta1PipelineTemplateMetadata) MarshalJSON() ([]b return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudAiplatformV1beta1PointwiseMetricInput: Input for pointwise +// metric. +type GoogleCloudAiplatformV1beta1PointwiseMetricInput struct { + // Instance: Required. Pointwise metric instance. + Instance *GoogleCloudAiplatformV1beta1PointwiseMetricInstance `json:"instance,omitempty"` + // MetricSpec: Required. Spec for pointwise metric. + MetricSpec *GoogleCloudAiplatformV1beta1PointwiseMetricSpec `json:"metricSpec,omitempty"` + // ForceSendFields is a list of field names (e.g. "Instance") 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. "Instance") 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 GoogleCloudAiplatformV1beta1PointwiseMetricInput) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1PointwiseMetricInput + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudAiplatformV1beta1PointwiseMetricInstance: Pointwise metric +// instance. Usually one instance corresponds to one row in an evaluation +// dataset. +type GoogleCloudAiplatformV1beta1PointwiseMetricInstance struct { + // JsonInstance: Instance specified as a json string. String key-value pairs + // are expected in the json_instance to render + // PointwiseMetricSpec.instance_prompt_template. + JsonInstance string `json:"jsonInstance,omitempty"` + // ForceSendFields is a list of field names (e.g. "JsonInstance") 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. "JsonInstance") 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 GoogleCloudAiplatformV1beta1PointwiseMetricInstance) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1PointwiseMetricInstance + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudAiplatformV1beta1PointwiseMetricResult: Spec for pointwise metric +// result. +type GoogleCloudAiplatformV1beta1PointwiseMetricResult struct { + // Explanation: Output only. Explanation for pointwise metric score. + Explanation string `json:"explanation,omitempty"` + // Score: Output only. Pointwise metric score. + Score float64 `json:"score,omitempty"` + // ForceSendFields is a list of field names (e.g. "Explanation") 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. "Explanation") 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 GoogleCloudAiplatformV1beta1PointwiseMetricResult) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1PointwiseMetricResult + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleCloudAiplatformV1beta1PointwiseMetricResult) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudAiplatformV1beta1PointwiseMetricResult + var s1 struct { + Score gensupport.JSONFloat64 `json:"score"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Score = float64(s1.Score) + return nil +} + +// GoogleCloudAiplatformV1beta1PointwiseMetricSpec: Spec for pointwise metric. +type GoogleCloudAiplatformV1beta1PointwiseMetricSpec struct { + // MetricPromptTemplate: Required. Metric prompt template for pointwise metric. + MetricPromptTemplate string `json:"metricPromptTemplate,omitempty"` + // ForceSendFields is a list of field names (e.g. "MetricPromptTemplate") 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. "MetricPromptTemplate") 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 GoogleCloudAiplatformV1beta1PointwiseMetricSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1PointwiseMetricSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAiplatformV1beta1Port: Represents a network port in a container. type GoogleCloudAiplatformV1beta1Port struct { // ContainerPort: The number of the port to expose on the pod's IP address. @@ -24137,6 +24444,31 @@ func (s GoogleCloudAiplatformV1beta1RagFileChunkingConfig) MarshalJSON() ([]byte return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudAiplatformV1beta1RagFileParsingConfig: Specifies the parsing +// config for RagFiles. +type GoogleCloudAiplatformV1beta1RagFileParsingConfig struct { + // ParsePdfsUsingOcr: Whether to use OCR for PDFs. + ParsePdfsUsingOcr bool `json:"parsePdfsUsingOcr,omitempty"` + // UseAdvancedPdfParsing: Whether to use advanced PDF parsing. + UseAdvancedPdfParsing bool `json:"useAdvancedPdfParsing,omitempty"` + // ForceSendFields is a list of field names (e.g. "ParsePdfsUsingOcr") 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. "ParsePdfsUsingOcr") 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 GoogleCloudAiplatformV1beta1RagFileParsingConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1RagFileParsingConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAiplatformV1beta1RagQuery: A query to retrieve relevant contexts. type GoogleCloudAiplatformV1beta1RagQuery struct { // SimilarityTopK: Optional. The number of contexts to retrieve. @@ -112772,6 +113104,13 @@ func (r *PublishersModelsService) Get(name string) *PublishersModelsGetCall { return c } +// HuggingFaceToken sets the optional parameter "huggingFaceToken": Token used +// to access Hugging Face gated models. +func (c *PublishersModelsGetCall) HuggingFaceToken(huggingFaceToken string) *PublishersModelsGetCall { + c.urlParams_.Set("huggingFaceToken", huggingFaceToken) + return c +} + // IsHuggingFaceModel sets the optional parameter "isHuggingFaceModel": Boolean // indicates whether the requested model is a Hugging Face model. func (c *PublishersModelsGetCall) IsHuggingFaceModel(isHuggingFaceModel bool) *PublishersModelsGetCall { diff --git a/alloydb/v1/alloydb-api.json b/alloydb/v1/alloydb-api.json index b793566b0e6..50c5b1b9eff 100644 --- a/alloydb/v1/alloydb-api.json +++ b/alloydb/v1/alloydb-api.json @@ -1489,7 +1489,7 @@ } } }, - "revision": "20240627", + "revision": "20240806", "rootUrl": "https://alloydb.googleapis.com/", "schemas": { "AuthorizedNetwork": { @@ -2001,6 +2001,83 @@ }, "type": "object" }, + "ClusterUpgradeDetails": { + "description": "Upgrade details of a cluster. This cluster can be primary or secondary.", + "id": "ClusterUpgradeDetails", + "properties": { + "clusterType": { + "description": "Cluster type which can either be primary or secondary.", + "enum": [ + "CLUSTER_TYPE_UNSPECIFIED", + "PRIMARY", + "SECONDARY" + ], + "enumDescriptions": [ + "The type of the cluster is unknown.", + "Primary cluster that support read and write operations.", + "Secondary cluster that is replicating from another region. This only supports read." + ], + "type": "string" + }, + "databaseVersion": { + "description": "Database version of the cluster after the upgrade operation. This will be the target version if the upgrade was successful otherwise it remains the same as that before the upgrade operation.", + "enum": [ + "DATABASE_VERSION_UNSPECIFIED", + "POSTGRES_13", + "POSTGRES_14", + "POSTGRES_15" + ], + "enumDeprecated": [ + false, + true, + false, + false + ], + "enumDescriptions": [ + "This is an unknown database version.", + "DEPRECATED - The database version is Postgres 13.", + "The database version is Postgres 14.", + "The database version is Postgres 15." + ], + "type": "string" + }, + "instanceUpgradeDetails": { + "description": "Upgrade details of the instances directly associated with this cluster.", + "items": { + "$ref": "InstanceUpgradeDetails" + }, + "type": "array" + }, + "name": { + "description": "Normalized name of the cluster", + "type": "string" + }, + "stageInfo": { + "description": "Array containing stage info associated with this cluster.", + "items": { + "$ref": "StageInfo" + }, + "type": "array" + }, + "upgradeStatus": { + "description": "Upgrade status of the cluster.", + "enum": [ + "STATUS_UNSPECIFIED", + "SUCCESS", + "FAILED", + "PARTIAL_SUCCESS" + ], + "enumDescriptions": [ + "Unspecified status.", + "Operation succeeded.", + "Operation failed.", + "Operation partially succeeded." + ], + "type": "string" + } + }, + "type": "object" + }, "ConnectionInfo": { "description": "ConnectionInfo singleton resource. https://google.aip.dev/156", "id": "ConnectionInfo", @@ -2483,6 +2560,49 @@ }, "type": "object" }, + "InstanceUpgradeDetails": { + "description": "Details regarding the upgrade of instaces associated with a cluster.", + "id": "InstanceUpgradeDetails", + "properties": { + "instanceType": { + "description": "Instance type.", + "enum": [ + "INSTANCE_TYPE_UNSPECIFIED", + "PRIMARY", + "READ_POOL", + "SECONDARY" + ], + "enumDescriptions": [ + "The type of the instance is unknown.", + "PRIMARY instances support read and write operations.", + "READ POOL instances support read operations only. Each read pool instance consists of one or more homogeneous nodes. * Read pool of size 1 can only have zonal availability. * Read pools with node count of 2 or more can have regional availability (nodes are present in 2 or more zones in a region).", + "SECONDARY instances support read operations only. SECONDARY instance is a cross-region read replica" + ], + "type": "string" + }, + "name": { + "description": "Normalized name of the instance.", + "type": "string" + }, + "upgradeStatus": { + "description": "Upgrade status of the instance.", + "enum": [ + "STATUS_UNSPECIFIED", + "SUCCESS", + "FAILED", + "PARTIAL_SUCCESS" + ], + "enumDescriptions": [ + "Unspecified status.", + "Operation succeeded.", + "Operation failed.", + "Operation partially succeeded." + ], + "type": "string" + } + }, + "type": "object" + }, "IntegerRestrictions": { "description": "Restrictions on INTEGER type values.", "id": "IntegerRestrictions", @@ -2997,6 +3117,13 @@ "RestartInstanceRequest": { "id": "RestartInstanceRequest", "properties": { + "nodeIds": { + "description": "Optional. Full name of the nodes as obtained from INSTANCE_VIEW_FULL to restart upon. Only applicable for read instances.", + "items": { + "type": "string" + }, + "type": "array" + }, "requestId": { "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "type": "string" @@ -3097,6 +3224,51 @@ }, "type": "object" }, + "StageInfo": { + "description": "Stage information for different stages in the upgrade process.", + "id": "StageInfo", + "properties": { + "logsUrl": { + "description": "logs_url is the URL for the logs associated with a stage if that stage has logs. Right now, only three stages have logs: ALLOYDB_PRECHECK, PG_UPGRADE_CHECK, PRIMARY_INSTANCE_UPGRADE.", + "type": "string" + }, + "stage": { + "description": "The stage.", + "enum": [ + "STAGE_UNSPECIFIED", + "ALLOYDB_PRECHECK", + "PG_UPGRADE_CHECK", + "PRIMARY_INSTANCE_UPGRADE", + "READ_POOL_UPGRADE" + ], + "enumDescriptions": [ + "Unspecified stage.", + "This stage is for the custom checks done before upgrade.", + "This stage is for `pg_upgrade --check` run before upgrade.", + "This stage is primary upgrade.", + "This stage is read pool upgrade." + ], + "type": "string" + }, + "status": { + "description": "Status of the stage.", + "enum": [ + "STATUS_UNSPECIFIED", + "SUCCESS", + "FAILED", + "PARTIAL_SUCCESS" + ], + "enumDescriptions": [ + "Unspecified status.", + "Operation succeeded.", + "Operation failed.", + "Operation partially succeeded." + ], + "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", @@ -3229,43 +3401,19 @@ "type": "object" }, "StorageDatabasecenterPartnerapiV1mainCustomMetadataData": { - "description": "Any custom metadata associated with the resource. i.e. A spanner instance can have multiple databases with its own unique metadata. Information for these individual databases can be captured in custom metadata data", + "description": "Any custom metadata associated with the resource. e.g. A spanner instance can have multiple databases with its own unique metadata. Information for these individual databases can be captured in custom metadata data", "id": "StorageDatabasecenterPartnerapiV1mainCustomMetadataData", "properties": { - "databaseMetadata": { + "internalResourceMetadata": { + "description": "Metadata for individual internal resources in an instance. e.g. spanner instance can have multiple databases with unique configuration.", "items": { - "$ref": "StorageDatabasecenterPartnerapiV1mainDatabaseMetadata" + "$ref": "StorageDatabasecenterPartnerapiV1mainInternalResourceMetadata" }, "type": "array" } }, "type": "object" }, - "StorageDatabasecenterPartnerapiV1mainDatabaseMetadata": { - "description": "Metadata for individual databases created in an instance. i.e. spanner instance can have multiple databases with unique configuration settings.", - "id": "StorageDatabasecenterPartnerapiV1mainDatabaseMetadata", - "properties": { - "backupConfiguration": { - "$ref": "StorageDatabasecenterPartnerapiV1mainBackupConfiguration", - "description": "Backup configuration for this database" - }, - "backupRun": { - "$ref": "StorageDatabasecenterPartnerapiV1mainBackupRun", - "description": "Information about the last backup attempt for this database" - }, - "product": { - "$ref": "StorageDatabasecenterProtoCommonProduct" - }, - "resourceId": { - "$ref": "StorageDatabasecenterPartnerapiV1mainDatabaseResourceId" - }, - "resourceName": { - "description": "Required. Database name. Resource name to follow CAIS resource_name format as noted here go/condor-common-datamodel", - "type": "string" - } - }, - "type": "object" - }, "StorageDatabasecenterPartnerapiV1mainDatabaseResourceFeed": { "description": "DatabaseResourceFeed is the top level proto to be used to ingest different database resource level events into Condor platform.", "id": "StorageDatabasecenterPartnerapiV1mainDatabaseResourceFeed", @@ -3294,8 +3442,7 @@ "type": "string" }, "observabilityMetricData": { - "$ref": "StorageDatabasecenterPartnerapiV1mainObservabilityMetricData", - "description": "More feed data would be added in subsequent CLs" + "$ref": "StorageDatabasecenterPartnerapiV1mainObservabilityMetricData" }, "recommendationSignalData": { "$ref": "StorageDatabasecenterPartnerapiV1mainDatabaseResourceRecommendationSignalData" @@ -3404,6 +3551,24 @@ "description": "Required. Unique identifier for the signal. This is an unique id which would be mainatined by partner to identify a signal.", "type": "string" }, + "signalSeverity": { + "description": "The severity of the signal, such as if it's a HIGH or LOW severity.", + "enum": [ + "SIGNAL_SEVERITY_UNSPECIFIED", + "CRITICAL", + "HIGH", + "MEDIUM", + "LOW" + ], + "enumDescriptions": [ + "This value is used for findings when a source doesn't write a severity value.", + "A critical vulnerability is easily discoverable by an external actor, exploitable.", + "A high risk vulnerability can be easily discovered and exploited in combination with other vulnerabilities.", + "A medium risk vulnerability could be used by an actor to gain access to resources or privileges that enable them to eventually gain access and the ability to execute arbitrary code or exfiltrate data.", + "A low risk vulnerability hampers a security organization's ability to detect vulnerabilities or active threats in their deployment." + ], + "type": "string" + }, "signalType": { "description": "Required. Type of signal, for example, `AVAILABLE_IN_MULTIPLE_ZONES`, `LOGGING_MOST_ERRORS`, etc.", "enum": [ @@ -3700,7 +3865,7 @@ "type": "string" }, "resourceType": { - "description": "Required. The type of resource this ID is identifying. Ex redis.googleapis.com/Instance, redis.googleapis.com/Cluster, alloydb.googleapis.com/Cluster, alloydb.googleapis.com/Instance, spanner.googleapis.com/Instance REQUIRED Please refer go/condor-common-datamodel", + "description": "Required. The type of resource this ID is identifying. Ex redis.googleapis.com/Instance, redis.googleapis.com/Cluster, alloydb.googleapis.com/Cluster, alloydb.googleapis.com/Instance, spanner.googleapis.com/Instance, spanner.googleapis.com/Database, firestore.googleapis.com/Database, sqladmin.googleapis.com/Instance, bigtableadmin.googleapis.com/Cluster, bigtableadmin.googleapis.com/Instance REQUIRED Please refer go/condor-common-datamodel", "type": "string" }, "uniqueId": { @@ -4198,6 +4363,31 @@ }, "type": "object" }, + "StorageDatabasecenterPartnerapiV1mainInternalResourceMetadata": { + "description": "Metadata for individual internal resources in an instance. e.g. spanner instance can have multiple databases with unique configuration settings. Similarly bigtable can have multiple clusters within same bigtable instance.", + "id": "StorageDatabasecenterPartnerapiV1mainInternalResourceMetadata", + "properties": { + "backupConfiguration": { + "$ref": "StorageDatabasecenterPartnerapiV1mainBackupConfiguration", + "description": "Backup configuration for this database" + }, + "backupRun": { + "$ref": "StorageDatabasecenterPartnerapiV1mainBackupRun", + "description": "Information about the last backup attempt for this database" + }, + "product": { + "$ref": "StorageDatabasecenterProtoCommonProduct" + }, + "resourceId": { + "$ref": "StorageDatabasecenterPartnerapiV1mainDatabaseResourceId" + }, + "resourceName": { + "description": "Required. internal resource name for spanner this will be database name e.g.\"spanner.googleapis.com/projects/123/abc/instances/inst1/databases/db1\"", + "type": "string" + } + }, + "type": "object" + }, "StorageDatabasecenterPartnerapiV1mainMachineConfiguration": { "description": "MachineConfiguration describes the configuration of a machine specific to Database Resource.", "id": "StorageDatabasecenterPartnerapiV1mainMachineConfiguration", @@ -4371,7 +4561,9 @@ "ENGINE_CLOUD_SPANNER_WITH_GOOGLESQL_DIALECT", "ENGINE_MEMORYSTORE_FOR_REDIS", "ENGINE_MEMORYSTORE_FOR_REDIS_CLUSTER", - "ENGINE_OTHER" + "ENGINE_OTHER", + "ENGINE_FIRESTORE_WITH_NATIVE_MODE", + "ENGINE_FIRESTORE_WITH_DATASTORE_MODE" ], "enumDeprecated": [ false, @@ -4387,6 +4579,8 @@ false, false, false, + false, + false, false ], "enumDescriptions": [ @@ -4403,7 +4597,9 @@ "Cloud Spanner with Google SQL dialect.", "Memorystore with Redis dialect.", "Memorystore with Redis cluster dialect.", - "Other refers to rest of other database engine. This is to be when engine is known, but it is not present in this enum." + "Other refers to rest of other database engine. This is to be when engine is known, but it is not present in this enum.", + "Firestore with native mode.", + "Firestore with datastore mode." ], "type": "string" }, @@ -4420,7 +4616,8 @@ "ON_PREM", "PRODUCT_TYPE_MEMORYSTORE", "PRODUCT_TYPE_BIGTABLE", - "PRODUCT_TYPE_OTHER" + "PRODUCT_TYPE_OTHER", + "PRODUCT_TYPE_FIRESTORE" ], "enumDeprecated": [ false, @@ -4433,6 +4630,7 @@ true, false, false, + false, false ], "enumDescriptions": [ @@ -4446,7 +4644,8 @@ "On premises database product.", "Memorystore product area in GCP", "Bigtable product area in GCP", - "Other refers to rest of other product type. This is to be when product type is known, but it is not present in this enum." + "Other refers to rest of other product type. This is to be when product type is known, but it is not present in this enum.", + "Firestore product area in GCP." ], "type": "string" }, @@ -4605,6 +4804,11 @@ "format": "google-datetime", "type": "string" }, + "graceEndTime": { + "description": "grace end time of the cluster.", + "format": "google-datetime", + "type": "string" + }, "startTime": { "description": "start time of the trial cluster.", "format": "google-datetime", @@ -4618,6 +4822,40 @@ }, "type": "object" }, + "UpgradeClusterResponse": { + "description": "UpgradeClusterResponse contains the response for upgrade cluster operation.", + "id": "UpgradeClusterResponse", + "properties": { + "clusterUpgradeDetails": { + "description": "Array of upgrade details for the current cluster and all the secondary clusters associated with this cluster.", + "items": { + "$ref": "ClusterUpgradeDetails" + }, + "type": "array" + }, + "message": { + "description": "A user friendly message summarising the upgrade operation details and the next steps for the user if there is any.", + "type": "string" + }, + "status": { + "description": "Status of upgrade operation.", + "enum": [ + "STATUS_UNSPECIFIED", + "SUCCESS", + "FAILED", + "PARTIAL_SUCCESS" + ], + "enumDescriptions": [ + "Unspecified status.", + "Operation succeeded.", + "Operation failed.", + "Operation partially succeeded." + ], + "type": "string" + } + }, + "type": "object" + }, "User": { "description": "Message describing User object.", "id": "User", diff --git a/alloydb/v1/alloydb-gen.go b/alloydb/v1/alloydb-gen.go index 3be98a7da1a..ba1c07d6bd3 100644 --- a/alloydb/v1/alloydb-gen.go +++ b/alloydb/v1/alloydb-gen.go @@ -689,6 +689,60 @@ func (s Cluster) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ClusterUpgradeDetails: Upgrade details of a cluster. This cluster can be +// primary or secondary. +type ClusterUpgradeDetails struct { + // ClusterType: Cluster type which can either be primary or secondary. + // + // Possible values: + // "CLUSTER_TYPE_UNSPECIFIED" - The type of the cluster is unknown. + // "PRIMARY" - Primary cluster that support read and write operations. + // "SECONDARY" - Secondary cluster that is replicating from another region. + // This only supports read. + ClusterType string `json:"clusterType,omitempty"` + // DatabaseVersion: Database version of the cluster after the upgrade + // operation. This will be the target version if the upgrade was successful + // otherwise it remains the same as that before the upgrade operation. + // + // Possible values: + // "DATABASE_VERSION_UNSPECIFIED" - This is an unknown database version. + // "POSTGRES_13" - DEPRECATED - The database version is Postgres 13. + // "POSTGRES_14" - The database version is Postgres 14. + // "POSTGRES_15" - The database version is Postgres 15. + DatabaseVersion string `json:"databaseVersion,omitempty"` + // InstanceUpgradeDetails: Upgrade details of the instances directly associated + // with this cluster. + InstanceUpgradeDetails []*InstanceUpgradeDetails `json:"instanceUpgradeDetails,omitempty"` + // Name: Normalized name of the cluster + Name string `json:"name,omitempty"` + // StageInfo: Array containing stage info associated with this cluster. + StageInfo []*StageInfo `json:"stageInfo,omitempty"` + // UpgradeStatus: Upgrade status of the cluster. + // + // Possible values: + // "STATUS_UNSPECIFIED" - Unspecified status. + // "SUCCESS" - Operation succeeded. + // "FAILED" - Operation failed. + // "PARTIAL_SUCCESS" - Operation partially succeeded. + UpgradeStatus string `json:"upgradeStatus,omitempty"` + // ForceSendFields is a list of field names (e.g. "ClusterType") 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. "ClusterType") 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 ClusterUpgradeDetails) MarshalJSON() ([]byte, error) { + type NoMethod ClusterUpgradeDetails + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ConnectionInfo: ConnectionInfo singleton resource. // https://google.aip.dev/156 type ConnectionInfo struct { @@ -1256,6 +1310,50 @@ func (s InstanceNetworkConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// InstanceUpgradeDetails: Details regarding the upgrade of instaces associated +// with a cluster. +type InstanceUpgradeDetails struct { + // InstanceType: Instance type. + // + // Possible values: + // "INSTANCE_TYPE_UNSPECIFIED" - The type of the instance is unknown. + // "PRIMARY" - PRIMARY instances support read and write operations. + // "READ_POOL" - READ POOL instances support read operations only. Each read + // pool instance consists of one or more homogeneous nodes. * Read pool of size + // 1 can only have zonal availability. * Read pools with node count of 2 or + // more can have regional availability (nodes are present in 2 or more zones in + // a region). + // "SECONDARY" - SECONDARY instances support read operations only. SECONDARY + // instance is a cross-region read replica + InstanceType string `json:"instanceType,omitempty"` + // Name: Normalized name of the instance. + Name string `json:"name,omitempty"` + // UpgradeStatus: Upgrade status of the instance. + // + // Possible values: + // "STATUS_UNSPECIFIED" - Unspecified status. + // "SUCCESS" - Operation succeeded. + // "FAILED" - Operation failed. + // "PARTIAL_SUCCESS" - Operation partially succeeded. + UpgradeStatus string `json:"upgradeStatus,omitempty"` + // ForceSendFields is a list of field names (e.g. "InstanceType") 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. "InstanceType") 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 InstanceUpgradeDetails) MarshalJSON() ([]byte, error) { + type NoMethod InstanceUpgradeDetails + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // IntegerRestrictions: Restrictions on INTEGER type values. type IntegerRestrictions struct { // MaxValue: The maximum value that can be specified, if applicable. @@ -1982,6 +2080,9 @@ func (s ReadPoolConfig) MarshalJSON() ([]byte, error) { } type RestartInstanceRequest struct { + // NodeIds: Optional. Full name of the nodes as obtained from + // INSTANCE_VIEW_FULL to restart upon. Only applicable for read instances. + NodeIds []string `json:"nodeIds,omitempty"` // RequestId: Optional. An optional request ID to identify requests. Specify a // unique request ID so that if you must retry your request, the server will // know to ignore the request if it has already been completed. The server will @@ -1998,13 +2099,13 @@ type RestartInstanceRequest struct { // checks and any other type of validation), but do not actually execute the // restart. ValidateOnly bool `json:"validateOnly,omitempty"` - // ForceSendFields is a list of field names (e.g. "RequestId") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See + // ForceSendFields is a list of field names (e.g. "NodeIds") 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. "RequestId") to include in API + // NullFields is a list of field names (e.g. "NodeIds") 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. @@ -2134,6 +2235,49 @@ func (s SslConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// StageInfo: Stage information for different stages in the upgrade process. +type StageInfo struct { + // LogsUrl: logs_url is the URL for the logs associated with a stage if that + // stage has logs. Right now, only three stages have logs: ALLOYDB_PRECHECK, + // PG_UPGRADE_CHECK, PRIMARY_INSTANCE_UPGRADE. + LogsUrl string `json:"logsUrl,omitempty"` + // Stage: The stage. + // + // Possible values: + // "STAGE_UNSPECIFIED" - Unspecified stage. + // "ALLOYDB_PRECHECK" - This stage is for the custom checks done before + // upgrade. + // "PG_UPGRADE_CHECK" - This stage is for `pg_upgrade --check` run before + // upgrade. + // "PRIMARY_INSTANCE_UPGRADE" - This stage is primary upgrade. + // "READ_POOL_UPGRADE" - This stage is read pool upgrade. + Stage string `json:"stage,omitempty"` + // Status: Status of the stage. + // + // Possible values: + // "STATUS_UNSPECIFIED" - Unspecified status. + // "SUCCESS" - Operation succeeded. + // "FAILED" - Operation failed. + // "PARTIAL_SUCCESS" - Operation partially succeeded. + Status string `json:"status,omitempty"` + // ForceSendFields is a list of field names (e.g. "LogsUrl") 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. "LogsUrl") 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 StageInfo) MarshalJSON() ([]byte, error) { + type NoMethod StageInfo + 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 @@ -2297,20 +2441,23 @@ func (s StorageDatabasecenterPartnerapiV1mainCompliance) MarshalJSON() ([]byte, } // StorageDatabasecenterPartnerapiV1mainCustomMetadataData: Any custom metadata -// associated with the resource. i.e. A spanner instance can have multiple +// associated with the resource. e.g. A spanner instance can have multiple // databases with its own unique metadata. Information for these individual // databases can be captured in custom metadata data type StorageDatabasecenterPartnerapiV1mainCustomMetadataData struct { - DatabaseMetadata []*StorageDatabasecenterPartnerapiV1mainDatabaseMetadata `json:"databaseMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "DatabaseMetadata") to - // unconditionally include in API requests. By default, fields with empty or + // InternalResourceMetadata: Metadata for individual internal resources in an + // instance. e.g. spanner instance can have multiple databases with unique + // configuration. + InternalResourceMetadata []*StorageDatabasecenterPartnerapiV1mainInternalResourceMetadata `json:"internalResourceMetadata,omitempty"` + // ForceSendFields is a list of field names (e.g. "InternalResourceMetadata") + // 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. "DatabaseMetadata") 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. "InternalResourceMetadata") 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:"-"` } @@ -2320,37 +2467,6 @@ func (s StorageDatabasecenterPartnerapiV1mainCustomMetadataData) MarshalJSON() ( return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// StorageDatabasecenterPartnerapiV1mainDatabaseMetadata: Metadata for -// individual databases created in an instance. i.e. spanner instance can have -// multiple databases with unique configuration settings. -type StorageDatabasecenterPartnerapiV1mainDatabaseMetadata struct { - // BackupConfiguration: Backup configuration for this database - BackupConfiguration *StorageDatabasecenterPartnerapiV1mainBackupConfiguration `json:"backupConfiguration,omitempty"` - // BackupRun: Information about the last backup attempt for this database - BackupRun *StorageDatabasecenterPartnerapiV1mainBackupRun `json:"backupRun,omitempty"` - Product *StorageDatabasecenterProtoCommonProduct `json:"product,omitempty"` - ResourceId *StorageDatabasecenterPartnerapiV1mainDatabaseResourceId `json:"resourceId,omitempty"` - // ResourceName: Required. Database name. Resource name to follow CAIS - // resource_name format as noted here go/condor-common-datamodel - ResourceName string `json:"resourceName,omitempty"` - // ForceSendFields is a list of field names (e.g. "BackupConfiguration") 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. "BackupConfiguration") 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 StorageDatabasecenterPartnerapiV1mainDatabaseMetadata) MarshalJSON() ([]byte, error) { - type NoMethod StorageDatabasecenterPartnerapiV1mainDatabaseMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // StorageDatabasecenterPartnerapiV1mainDatabaseResourceFeed: // DatabaseResourceFeed is the top level proto to be used to ingest different // database resource level events into Condor platform. @@ -2366,8 +2482,7 @@ type StorageDatabasecenterPartnerapiV1mainDatabaseResourceFeed struct { // "SECURITY_FINDING_DATA" - Database resource security health signal data // "RECOMMENDATION_SIGNAL_DATA" - Database resource recommendation signal // data - FeedType string `json:"feedType,omitempty"` - // ObservabilityMetricData: More feed data would be added in subsequent CLs + FeedType string `json:"feedType,omitempty"` ObservabilityMetricData *StorageDatabasecenterPartnerapiV1mainObservabilityMetricData `json:"observabilityMetricData,omitempty"` RecommendationSignalData *StorageDatabasecenterPartnerapiV1mainDatabaseResourceRecommendationSignalData `json:"recommendationSignalData,omitempty"` ResourceHealthSignalData *StorageDatabasecenterPartnerapiV1mainDatabaseResourceHealthSignalData `json:"resourceHealthSignalData,omitempty"` @@ -2460,6 +2575,22 @@ type StorageDatabasecenterPartnerapiV1mainDatabaseResourceHealthSignalData struc // SignalId: Required. Unique identifier for the signal. This is an unique id // which would be mainatined by partner to identify a signal. SignalId string `json:"signalId,omitempty"` + // SignalSeverity: The severity of the signal, such as if it's a HIGH or LOW + // severity. + // + // Possible values: + // "SIGNAL_SEVERITY_UNSPECIFIED" - This value is used for findings when a + // source doesn't write a severity value. + // "CRITICAL" - A critical vulnerability is easily discoverable by an + // external actor, exploitable. + // "HIGH" - A high risk vulnerability can be easily discovered and exploited + // in combination with other vulnerabilities. + // "MEDIUM" - A medium risk vulnerability could be used by an actor to gain + // access to resources or privileges that enable them to eventually gain access + // and the ability to execute arbitrary code or exfiltrate data. + // "LOW" - A low risk vulnerability hampers a security organization's ability + // to detect vulnerabilities or active threats in their deployment. + SignalSeverity string `json:"signalSeverity,omitempty"` // SignalType: Required. Type of signal, for example, // `AVAILABLE_IN_MULTIPLE_ZONES`, `LOGGING_MOST_ERRORS`, etc. // @@ -2697,8 +2828,10 @@ type StorageDatabasecenterPartnerapiV1mainDatabaseResourceId struct { // ResourceType: Required. The type of resource this ID is identifying. Ex // redis.googleapis.com/Instance, redis.googleapis.com/Cluster, // alloydb.googleapis.com/Cluster, alloydb.googleapis.com/Instance, - // spanner.googleapis.com/Instance REQUIRED Please refer - // go/condor-common-datamodel + // spanner.googleapis.com/Instance, spanner.googleapis.com/Database, + // firestore.googleapis.com/Database, sqladmin.googleapis.com/Instance, + // bigtableadmin.googleapis.com/Cluster, bigtableadmin.googleapis.com/Instance + // REQUIRED Please refer go/condor-common-datamodel ResourceType string `json:"resourceType,omitempty"` // UniqueId: Required. A service-local token that distinguishes this resource // from other resources within the same service. @@ -3113,6 +3246,39 @@ func (s StorageDatabasecenterPartnerapiV1mainEntitlement) MarshalJSON() ([]byte, return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// StorageDatabasecenterPartnerapiV1mainInternalResourceMetadata: Metadata for +// individual internal resources in an instance. e.g. spanner instance can have +// multiple databases with unique configuration settings. Similarly bigtable +// can have multiple clusters within same bigtable instance. +type StorageDatabasecenterPartnerapiV1mainInternalResourceMetadata struct { + // BackupConfiguration: Backup configuration for this database + BackupConfiguration *StorageDatabasecenterPartnerapiV1mainBackupConfiguration `json:"backupConfiguration,omitempty"` + // BackupRun: Information about the last backup attempt for this database + BackupRun *StorageDatabasecenterPartnerapiV1mainBackupRun `json:"backupRun,omitempty"` + Product *StorageDatabasecenterProtoCommonProduct `json:"product,omitempty"` + ResourceId *StorageDatabasecenterPartnerapiV1mainDatabaseResourceId `json:"resourceId,omitempty"` + // ResourceName: Required. internal resource name for spanner this will be + // database name + // e.g."spanner.googleapis.com/projects/123/abc/instances/inst1/databases/db1" + ResourceName string `json:"resourceName,omitempty"` + // ForceSendFields is a list of field names (e.g. "BackupConfiguration") 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. "BackupConfiguration") 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 StorageDatabasecenterPartnerapiV1mainInternalResourceMetadata) MarshalJSON() ([]byte, error) { + type NoMethod StorageDatabasecenterPartnerapiV1mainInternalResourceMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // StorageDatabasecenterPartnerapiV1mainMachineConfiguration: // MachineConfiguration describes the configuration of a machine specific to // Database Resource. @@ -3310,6 +3476,8 @@ type StorageDatabasecenterProtoCommonProduct struct { // dialect. // "ENGINE_OTHER" - Other refers to rest of other database engine. This is to // be when engine is known, but it is not present in this enum. + // "ENGINE_FIRESTORE_WITH_NATIVE_MODE" - Firestore with native mode. + // "ENGINE_FIRESTORE_WITH_DATASTORE_MODE" - Firestore with datastore mode. Engine string `json:"engine,omitempty"` // Type: Type of specific database product. It could be CloudSQL, AlloyDB etc.. // @@ -3327,6 +3495,7 @@ type StorageDatabasecenterProtoCommonProduct struct { // "PRODUCT_TYPE_BIGTABLE" - Bigtable product area in GCP // "PRODUCT_TYPE_OTHER" - Other refers to rest of other product type. This is // to be when product type is known, but it is not present in this enum. + // "PRODUCT_TYPE_FIRESTORE" - Firestore product area in GCP. Type string `json:"type,omitempty"` // Version: Version of the underlying database engine. Example values: For // MySQL, it could be "8.0", "5.7" etc.. For Postgres, it could be "14", "15" @@ -3539,6 +3708,8 @@ func (s TimeBasedRetention) MarshalJSON() ([]byte, error) { type TrialMetadata struct { // EndTime: End time of the trial cluster. EndTime string `json:"endTime,omitempty"` + // GraceEndTime: grace end time of the cluster. + GraceEndTime string `json:"graceEndTime,omitempty"` // StartTime: start time of the trial cluster. StartTime string `json:"startTime,omitempty"` // UpgradeTime: Upgrade time of trial cluster to Standard cluster. @@ -3561,6 +3732,41 @@ func (s TrialMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// UpgradeClusterResponse: UpgradeClusterResponse contains the response for +// upgrade cluster operation. +type UpgradeClusterResponse struct { + // ClusterUpgradeDetails: Array of upgrade details for the current cluster and + // all the secondary clusters associated with this cluster. + ClusterUpgradeDetails []*ClusterUpgradeDetails `json:"clusterUpgradeDetails,omitempty"` + // Message: A user friendly message summarising the upgrade operation details + // and the next steps for the user if there is any. + Message string `json:"message,omitempty"` + // Status: Status of upgrade operation. + // + // Possible values: + // "STATUS_UNSPECIFIED" - Unspecified status. + // "SUCCESS" - Operation succeeded. + // "FAILED" - Operation failed. + // "PARTIAL_SUCCESS" - Operation partially succeeded. + Status string `json:"status,omitempty"` + // ForceSendFields is a list of field names (e.g. "ClusterUpgradeDetails") 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. "ClusterUpgradeDetails") 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 UpgradeClusterResponse) MarshalJSON() ([]byte, error) { + type NoMethod UpgradeClusterResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // User: Message describing User object. type User struct { // DatabaseRoles: Optional. List of database roles this user has. The database diff --git a/alloydb/v1alpha/alloydb-api.json b/alloydb/v1alpha/alloydb-api.json index bc946fdc407..d7366f0b98b 100644 --- a/alloydb/v1alpha/alloydb-api.json +++ b/alloydb/v1alpha/alloydb-api.json @@ -735,6 +735,34 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "upgrade": { + "description": "Upgrades a single Cluster. Imperative only.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}:upgrade", + "httpMethod": "PATCH", + "id": "alloydb.projects.locations.clusters.upgrade", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource name of the cluster.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/clusters/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}:upgrade", + "request": { + "$ref": "UpgradeClusterRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } }, "resources": { @@ -1489,7 +1517,7 @@ } } }, - "revision": "20240703", + "revision": "20240806", "rootUrl": "https://alloydb.googleapis.com/", "schemas": { "AuthorizedNetwork": { @@ -1786,6 +1814,26 @@ }, "type": "object" }, + "CloudSQLBackupRunSource": { + "description": "The source CloudSQL backup resource.", + "id": "CloudSQLBackupRunSource", + "properties": { + "backupRunId": { + "description": "Required. The CloudSQL backup run ID.", + "format": "int64", + "type": "string" + }, + "instanceId": { + "description": "Required. The CloudSQL instance ID.", + "type": "string" + }, + "project": { + "description": "The project ID of the source CloudSQL instance. This should be the same as the AlloyDB cluster's project.", + "type": "string" + } + }, + "type": "object" + }, "Cluster": { "description": "A cluster is a collection of regional AlloyDB resources. It can include a primary instance and one or more read pool instances. All cluster resources share a storage layer, which scales as needed.", "id": "Cluster", @@ -1806,6 +1854,11 @@ "description": "Output only. Cluster created from backup.", "readOnly": true }, + "cloudsqlBackupRunSource": { + "$ref": "CloudSQLBackupRunSource", + "description": "Output only. Cluster created from CloudSQL snapshot.", + "readOnly": true + }, "clusterType": { "description": "Output only. The type of the cluster. This is an output-only field and it's populated at the Cluster creation time or the Cluster promotion time. The cluster type is determined by which RPC was used to create the cluster (i.e. `CreateCluster` vs. `CreateSecondaryCluster`", "enum": [ @@ -2021,6 +2074,86 @@ }, "type": "object" }, + "ClusterUpgradeDetails": { + "description": "Upgrade details of a cluster. This cluster can be primary or secondary.", + "id": "ClusterUpgradeDetails", + "properties": { + "clusterType": { + "description": "Cluster type which can either be primary or secondary.", + "enum": [ + "CLUSTER_TYPE_UNSPECIFIED", + "PRIMARY", + "SECONDARY" + ], + "enumDescriptions": [ + "The type of the cluster is unknown.", + "Primary cluster that support read and write operations.", + "Secondary cluster that is replicating from another region. This only supports read." + ], + "type": "string" + }, + "databaseVersion": { + "description": "Database version of the cluster after the upgrade operation. This will be the target version if the upgrade was successful otherwise it remains the same as that before the upgrade operation.", + "enum": [ + "DATABASE_VERSION_UNSPECIFIED", + "POSTGRES_13", + "POSTGRES_14", + "POSTGRES_15", + "POSTGRES_16" + ], + "enumDeprecated": [ + false, + true, + false, + false, + false + ], + "enumDescriptions": [ + "This is an unknown database version.", + "DEPRECATED - The database version is Postgres 13.", + "The database version is Postgres 14.", + "The database version is Postgres 15.", + "The database version is Postgres 16." + ], + "type": "string" + }, + "instanceUpgradeDetails": { + "description": "Upgrade details of the instances directly associated with this cluster.", + "items": { + "$ref": "InstanceUpgradeDetails" + }, + "type": "array" + }, + "name": { + "description": "Normalized name of the cluster", + "type": "string" + }, + "stageInfo": { + "description": "Array containing stage info associated with this cluster.", + "items": { + "$ref": "StageInfo" + }, + "type": "array" + }, + "upgradeStatus": { + "description": "Upgrade status of the cluster.", + "enum": [ + "STATUS_UNSPECIFIED", + "SUCCESS", + "FAILED", + "PARTIAL_SUCCESS" + ], + "enumDescriptions": [ + "Unspecified status.", + "Operation succeeded.", + "Operation failed.", + "Operation partially succeeded." + ], + "type": "string" + } + }, + "type": "object" + }, "ConnectionInfo": { "description": "ConnectionInfo singleton resource. https://google.aip.dev/156", "id": "ConnectionInfo", @@ -2570,6 +2703,49 @@ }, "type": "object" }, + "InstanceUpgradeDetails": { + "description": "Details regarding the upgrade of instaces associated with a cluster.", + "id": "InstanceUpgradeDetails", + "properties": { + "instanceType": { + "description": "Instance type.", + "enum": [ + "INSTANCE_TYPE_UNSPECIFIED", + "PRIMARY", + "READ_POOL", + "SECONDARY" + ], + "enumDescriptions": [ + "The type of the instance is unknown.", + "PRIMARY instances support read and write operations.", + "READ POOL instances support read operations only. Each read pool instance consists of one or more homogeneous nodes. * Read pool of size 1 can only have zonal availability. * Read pools with node count of 2 or more can have regional availability (nodes are present in 2 or more zones in a region).", + "SECONDARY instances support read operations only. SECONDARY instance is a cross-region read replica" + ], + "type": "string" + }, + "name": { + "description": "Normalized name of the instance.", + "type": "string" + }, + "upgradeStatus": { + "description": "Upgrade status of the instance.", + "enum": [ + "STATUS_UNSPECIFIED", + "SUCCESS", + "FAILED", + "PARTIAL_SUCCESS" + ], + "enumDescriptions": [ + "Unspecified status.", + "Operation succeeded.", + "Operation failed.", + "Operation partially succeeded." + ], + "type": "string" + } + }, + "type": "object" + }, "IntegerRestrictions": { "description": "Restrictions on INTEGER type values.", "id": "IntegerRestrictions", @@ -2895,6 +3071,10 @@ "description": "Track actively running queries on the instance. If not set, this flag is \"off\" by default.", "type": "boolean" }, + "trackClientAddress": { + "description": "Track client address for an instance. If not set, default value is \"off\".", + "type": "boolean" + }, "trackWaitEventTypes": { "description": "Output only. Track wait event types during query execution for an instance. This flag is turned \"on\" by default but tracking is enabled only after observability enabled flag is also turned on. This is read-only flag and only modifiable by producer API.", "readOnly": true, @@ -3126,6 +3306,13 @@ "RestartInstanceRequest": { "id": "RestartInstanceRequest", "properties": { + "nodeIds": { + "description": "Optional. Full name of the nodes as obtained from INSTANCE_VIEW_FULL to restart upon. Only applicable for read instances.", + "items": { + "type": "string" + }, + "type": "array" + }, "requestId": { "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "type": "string" @@ -3226,6 +3413,51 @@ }, "type": "object" }, + "StageInfo": { + "description": "Stage information for different stages in the upgrade process.", + "id": "StageInfo", + "properties": { + "logsUrl": { + "description": "logs_url is the URL for the logs associated with a stage if that stage has logs. Right now, only three stages have logs: ALLOYDB_PRECHECK, PG_UPGRADE_CHECK, PRIMARY_INSTANCE_UPGRADE.", + "type": "string" + }, + "stage": { + "description": "The stage.", + "enum": [ + "STAGE_UNSPECIFIED", + "ALLOYDB_PRECHECK", + "PG_UPGRADE_CHECK", + "PRIMARY_INSTANCE_UPGRADE", + "READ_POOL_UPGRADE" + ], + "enumDescriptions": [ + "Unspecified stage.", + "This stage is for the custom checks done before upgrade.", + "This stage is for `pg_upgrade --check` run before upgrade.", + "This stage is primary upgrade.", + "This stage is read pool upgrade." + ], + "type": "string" + }, + "status": { + "description": "Status of the stage.", + "enum": [ + "STATUS_UNSPECIFIED", + "SUCCESS", + "FAILED", + "PARTIAL_SUCCESS" + ], + "enumDescriptions": [ + "Unspecified status.", + "Operation succeeded.", + "Operation failed.", + "Operation partially succeeded." + ], + "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", @@ -3358,43 +3590,19 @@ "type": "object" }, "StorageDatabasecenterPartnerapiV1mainCustomMetadataData": { - "description": "Any custom metadata associated with the resource. i.e. A spanner instance can have multiple databases with its own unique metadata. Information for these individual databases can be captured in custom metadata data", + "description": "Any custom metadata associated with the resource. e.g. A spanner instance can have multiple databases with its own unique metadata. Information for these individual databases can be captured in custom metadata data", "id": "StorageDatabasecenterPartnerapiV1mainCustomMetadataData", "properties": { - "databaseMetadata": { + "internalResourceMetadata": { + "description": "Metadata for individual internal resources in an instance. e.g. spanner instance can have multiple databases with unique configuration.", "items": { - "$ref": "StorageDatabasecenterPartnerapiV1mainDatabaseMetadata" + "$ref": "StorageDatabasecenterPartnerapiV1mainInternalResourceMetadata" }, "type": "array" } }, "type": "object" }, - "StorageDatabasecenterPartnerapiV1mainDatabaseMetadata": { - "description": "Metadata for individual databases created in an instance. i.e. spanner instance can have multiple databases with unique configuration settings.", - "id": "StorageDatabasecenterPartnerapiV1mainDatabaseMetadata", - "properties": { - "backupConfiguration": { - "$ref": "StorageDatabasecenterPartnerapiV1mainBackupConfiguration", - "description": "Backup configuration for this database" - }, - "backupRun": { - "$ref": "StorageDatabasecenterPartnerapiV1mainBackupRun", - "description": "Information about the last backup attempt for this database" - }, - "product": { - "$ref": "StorageDatabasecenterProtoCommonProduct" - }, - "resourceId": { - "$ref": "StorageDatabasecenterPartnerapiV1mainDatabaseResourceId" - }, - "resourceName": { - "description": "Required. Database name. Resource name to follow CAIS resource_name format as noted here go/condor-common-datamodel", - "type": "string" - } - }, - "type": "object" - }, "StorageDatabasecenterPartnerapiV1mainDatabaseResourceFeed": { "description": "DatabaseResourceFeed is the top level proto to be used to ingest different database resource level events into Condor platform.", "id": "StorageDatabasecenterPartnerapiV1mainDatabaseResourceFeed", @@ -3423,8 +3631,7 @@ "type": "string" }, "observabilityMetricData": { - "$ref": "StorageDatabasecenterPartnerapiV1mainObservabilityMetricData", - "description": "More feed data would be added in subsequent CLs" + "$ref": "StorageDatabasecenterPartnerapiV1mainObservabilityMetricData" }, "recommendationSignalData": { "$ref": "StorageDatabasecenterPartnerapiV1mainDatabaseResourceRecommendationSignalData" @@ -3533,6 +3740,24 @@ "description": "Required. Unique identifier for the signal. This is an unique id which would be mainatined by partner to identify a signal.", "type": "string" }, + "signalSeverity": { + "description": "The severity of the signal, such as if it's a HIGH or LOW severity.", + "enum": [ + "SIGNAL_SEVERITY_UNSPECIFIED", + "CRITICAL", + "HIGH", + "MEDIUM", + "LOW" + ], + "enumDescriptions": [ + "This value is used for findings when a source doesn't write a severity value.", + "A critical vulnerability is easily discoverable by an external actor, exploitable.", + "A high risk vulnerability can be easily discovered and exploited in combination with other vulnerabilities.", + "A medium risk vulnerability could be used by an actor to gain access to resources or privileges that enable them to eventually gain access and the ability to execute arbitrary code or exfiltrate data.", + "A low risk vulnerability hampers a security organization's ability to detect vulnerabilities or active threats in their deployment." + ], + "type": "string" + }, "signalType": { "description": "Required. Type of signal, for example, `AVAILABLE_IN_MULTIPLE_ZONES`, `LOGGING_MOST_ERRORS`, etc.", "enum": [ @@ -3829,7 +4054,7 @@ "type": "string" }, "resourceType": { - "description": "Required. The type of resource this ID is identifying. Ex redis.googleapis.com/Instance, redis.googleapis.com/Cluster, alloydb.googleapis.com/Cluster, alloydb.googleapis.com/Instance, spanner.googleapis.com/Instance REQUIRED Please refer go/condor-common-datamodel", + "description": "Required. The type of resource this ID is identifying. Ex redis.googleapis.com/Instance, redis.googleapis.com/Cluster, alloydb.googleapis.com/Cluster, alloydb.googleapis.com/Instance, spanner.googleapis.com/Instance, spanner.googleapis.com/Database, firestore.googleapis.com/Database, sqladmin.googleapis.com/Instance, bigtableadmin.googleapis.com/Cluster, bigtableadmin.googleapis.com/Instance REQUIRED Please refer go/condor-common-datamodel", "type": "string" }, "uniqueId": { @@ -4327,6 +4552,31 @@ }, "type": "object" }, + "StorageDatabasecenterPartnerapiV1mainInternalResourceMetadata": { + "description": "Metadata for individual internal resources in an instance. e.g. spanner instance can have multiple databases with unique configuration settings. Similarly bigtable can have multiple clusters within same bigtable instance.", + "id": "StorageDatabasecenterPartnerapiV1mainInternalResourceMetadata", + "properties": { + "backupConfiguration": { + "$ref": "StorageDatabasecenterPartnerapiV1mainBackupConfiguration", + "description": "Backup configuration for this database" + }, + "backupRun": { + "$ref": "StorageDatabasecenterPartnerapiV1mainBackupRun", + "description": "Information about the last backup attempt for this database" + }, + "product": { + "$ref": "StorageDatabasecenterProtoCommonProduct" + }, + "resourceId": { + "$ref": "StorageDatabasecenterPartnerapiV1mainDatabaseResourceId" + }, + "resourceName": { + "description": "Required. internal resource name for spanner this will be database name e.g.\"spanner.googleapis.com/projects/123/abc/instances/inst1/databases/db1\"", + "type": "string" + } + }, + "type": "object" + }, "StorageDatabasecenterPartnerapiV1mainMachineConfiguration": { "description": "MachineConfiguration describes the configuration of a machine specific to Database Resource.", "id": "StorageDatabasecenterPartnerapiV1mainMachineConfiguration", @@ -4500,7 +4750,9 @@ "ENGINE_CLOUD_SPANNER_WITH_GOOGLESQL_DIALECT", "ENGINE_MEMORYSTORE_FOR_REDIS", "ENGINE_MEMORYSTORE_FOR_REDIS_CLUSTER", - "ENGINE_OTHER" + "ENGINE_OTHER", + "ENGINE_FIRESTORE_WITH_NATIVE_MODE", + "ENGINE_FIRESTORE_WITH_DATASTORE_MODE" ], "enumDeprecated": [ false, @@ -4516,6 +4768,8 @@ false, false, false, + false, + false, false ], "enumDescriptions": [ @@ -4532,7 +4786,9 @@ "Cloud Spanner with Google SQL dialect.", "Memorystore with Redis dialect.", "Memorystore with Redis cluster dialect.", - "Other refers to rest of other database engine. This is to be when engine is known, but it is not present in this enum." + "Other refers to rest of other database engine. This is to be when engine is known, but it is not present in this enum.", + "Firestore with native mode.", + "Firestore with datastore mode." ], "type": "string" }, @@ -4549,7 +4805,8 @@ "ON_PREM", "PRODUCT_TYPE_MEMORYSTORE", "PRODUCT_TYPE_BIGTABLE", - "PRODUCT_TYPE_OTHER" + "PRODUCT_TYPE_OTHER", + "PRODUCT_TYPE_FIRESTORE" ], "enumDeprecated": [ false, @@ -4562,6 +4819,7 @@ true, false, false, + false, false ], "enumDescriptions": [ @@ -4575,7 +4833,8 @@ "On premises database product.", "Memorystore product area in GCP", "Bigtable product area in GCP", - "Other refers to rest of other product type. This is to be when product type is known, but it is not present in this enum." + "Other refers to rest of other product type. This is to be when product type is known, but it is not present in this enum.", + "Firestore product area in GCP." ], "type": "string" }, @@ -4737,6 +4996,11 @@ "format": "google-datetime", "type": "string" }, + "graceEndTime": { + "description": "grace end time of the cluster.", + "format": "google-datetime", + "type": "string" + }, "startTime": { "description": "start time of the trial cluster.", "format": "google-datetime", @@ -4771,6 +5035,84 @@ }, "type": "object" }, + "UpgradeClusterRequest": { + "description": "Upgrades a cluster.", + "id": "UpgradeClusterRequest", + "properties": { + "etag": { + "description": "Optional. The current etag of the Cluster. If an etag is provided and does not match the current etag of the Cluster, upgrade will be blocked and an ABORTED error will be returned.", + "type": "string" + }, + "requestId": { + "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "type": "string" + }, + "validateOnly": { + "description": "Optional. If set, performs request validation (e.g. permission checks and any other type of validation), but does not actually execute the upgrade.", + "type": "boolean" + }, + "version": { + "description": "Required. The version the cluster is going to be upgraded to.", + "enum": [ + "DATABASE_VERSION_UNSPECIFIED", + "POSTGRES_13", + "POSTGRES_14", + "POSTGRES_15", + "POSTGRES_16" + ], + "enumDeprecated": [ + false, + true, + false, + false, + false + ], + "enumDescriptions": [ + "This is an unknown database version.", + "DEPRECATED - The database version is Postgres 13.", + "The database version is Postgres 14.", + "The database version is Postgres 15.", + "The database version is Postgres 16." + ], + "type": "string" + } + }, + "type": "object" + }, + "UpgradeClusterResponse": { + "description": "UpgradeClusterResponse contains the response for upgrade cluster operation.", + "id": "UpgradeClusterResponse", + "properties": { + "clusterUpgradeDetails": { + "description": "Array of upgrade details for the current cluster and all the secondary clusters associated with this cluster.", + "items": { + "$ref": "ClusterUpgradeDetails" + }, + "type": "array" + }, + "message": { + "description": "A user friendly message summarising the upgrade operation details and the next steps for the user if there is any.", + "type": "string" + }, + "status": { + "description": "Status of upgrade operation.", + "enum": [ + "STATUS_UNSPECIFIED", + "SUCCESS", + "FAILED", + "PARTIAL_SUCCESS" + ], + "enumDescriptions": [ + "Unspecified status.", + "Operation succeeded.", + "Operation failed.", + "Operation partially succeeded." + ], + "type": "string" + } + }, + "type": "object" + }, "User": { "description": "Message describing User object.", "id": "User", diff --git a/alloydb/v1alpha/alloydb-gen.go b/alloydb/v1alpha/alloydb-gen.go index 1b9ef48663c..7a4b36514a6 100644 --- a/alloydb/v1alpha/alloydb-gen.go +++ b/alloydb/v1alpha/alloydb-gen.go @@ -526,6 +526,33 @@ func (s CloudControl2SharedOperationsReconciliationOperationMetadata) MarshalJSO return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// CloudSQLBackupRunSource: The source CloudSQL backup resource. +type CloudSQLBackupRunSource struct { + // BackupRunId: Required. The CloudSQL backup run ID. + BackupRunId int64 `json:"backupRunId,omitempty,string"` + // InstanceId: Required. The CloudSQL instance ID. + InstanceId string `json:"instanceId,omitempty"` + // Project: The project ID of the source CloudSQL instance. This should be the + // same as the AlloyDB cluster's project. + Project string `json:"project,omitempty"` + // ForceSendFields is a list of field names (e.g. "BackupRunId") 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. "BackupRunId") 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 CloudSQLBackupRunSource) MarshalJSON() ([]byte, error) { + type NoMethod CloudSQLBackupRunSource + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Cluster: A cluster is a collection of regional AlloyDB resources. It can // include a primary instance and one or more read pool instances. All cluster // resources share a storage layer, which scales as needed. @@ -541,6 +568,9 @@ type Cluster struct { AutomatedBackupPolicy *AutomatedBackupPolicy `json:"automatedBackupPolicy,omitempty"` // BackupSource: Output only. Cluster created from backup. BackupSource *BackupSource `json:"backupSource,omitempty"` + // CloudsqlBackupRunSource: Output only. Cluster created from CloudSQL + // snapshot. + CloudsqlBackupRunSource *CloudSQLBackupRunSource `json:"cloudsqlBackupRunSource,omitempty"` // ClusterType: Output only. The type of the cluster. This is an output-only // field and it's populated at the Cluster creation time or the Cluster // promotion time. The cluster type is determined by which RPC was used to @@ -698,6 +728,61 @@ func (s Cluster) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ClusterUpgradeDetails: Upgrade details of a cluster. This cluster can be +// primary or secondary. +type ClusterUpgradeDetails struct { + // ClusterType: Cluster type which can either be primary or secondary. + // + // Possible values: + // "CLUSTER_TYPE_UNSPECIFIED" - The type of the cluster is unknown. + // "PRIMARY" - Primary cluster that support read and write operations. + // "SECONDARY" - Secondary cluster that is replicating from another region. + // This only supports read. + ClusterType string `json:"clusterType,omitempty"` + // DatabaseVersion: Database version of the cluster after the upgrade + // operation. This will be the target version if the upgrade was successful + // otherwise it remains the same as that before the upgrade operation. + // + // Possible values: + // "DATABASE_VERSION_UNSPECIFIED" - This is an unknown database version. + // "POSTGRES_13" - DEPRECATED - The database version is Postgres 13. + // "POSTGRES_14" - The database version is Postgres 14. + // "POSTGRES_15" - The database version is Postgres 15. + // "POSTGRES_16" - The database version is Postgres 16. + DatabaseVersion string `json:"databaseVersion,omitempty"` + // InstanceUpgradeDetails: Upgrade details of the instances directly associated + // with this cluster. + InstanceUpgradeDetails []*InstanceUpgradeDetails `json:"instanceUpgradeDetails,omitempty"` + // Name: Normalized name of the cluster + Name string `json:"name,omitempty"` + // StageInfo: Array containing stage info associated with this cluster. + StageInfo []*StageInfo `json:"stageInfo,omitempty"` + // UpgradeStatus: Upgrade status of the cluster. + // + // Possible values: + // "STATUS_UNSPECIFIED" - Unspecified status. + // "SUCCESS" - Operation succeeded. + // "FAILED" - Operation failed. + // "PARTIAL_SUCCESS" - Operation partially succeeded. + UpgradeStatus string `json:"upgradeStatus,omitempty"` + // ForceSendFields is a list of field names (e.g. "ClusterType") 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. "ClusterType") 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 ClusterUpgradeDetails) MarshalJSON() ([]byte, error) { + type NoMethod ClusterUpgradeDetails + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ConnectionInfo: ConnectionInfo singleton resource. // https://google.aip.dev/156 type ConnectionInfo struct { @@ -1341,6 +1426,50 @@ func (s InstanceNetworkConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// InstanceUpgradeDetails: Details regarding the upgrade of instaces associated +// with a cluster. +type InstanceUpgradeDetails struct { + // InstanceType: Instance type. + // + // Possible values: + // "INSTANCE_TYPE_UNSPECIFIED" - The type of the instance is unknown. + // "PRIMARY" - PRIMARY instances support read and write operations. + // "READ_POOL" - READ POOL instances support read operations only. Each read + // pool instance consists of one or more homogeneous nodes. * Read pool of size + // 1 can only have zonal availability. * Read pools with node count of 2 or + // more can have regional availability (nodes are present in 2 or more zones in + // a region). + // "SECONDARY" - SECONDARY instances support read operations only. SECONDARY + // instance is a cross-region read replica + InstanceType string `json:"instanceType,omitempty"` + // Name: Normalized name of the instance. + Name string `json:"name,omitempty"` + // UpgradeStatus: Upgrade status of the instance. + // + // Possible values: + // "STATUS_UNSPECIFIED" - Unspecified status. + // "SUCCESS" - Operation succeeded. + // "FAILED" - Operation failed. + // "PARTIAL_SUCCESS" - Operation partially succeeded. + UpgradeStatus string `json:"upgradeStatus,omitempty"` + // ForceSendFields is a list of field names (e.g. "InstanceType") 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. "InstanceType") 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 InstanceUpgradeDetails) MarshalJSON() ([]byte, error) { + type NoMethod InstanceUpgradeDetails + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // IntegerRestrictions: Restrictions on INTEGER type values. type IntegerRestrictions struct { // MaxValue: The maximum value that can be specified, if applicable. @@ -1770,6 +1899,9 @@ type ObservabilityInstanceConfig struct { // TrackActiveQueries: Track actively running queries on the instance. If not // set, this flag is "off" by default. TrackActiveQueries bool `json:"trackActiveQueries,omitempty"` + // TrackClientAddress: Track client address for an instance. If not set, + // default value is "off". + TrackClientAddress bool `json:"trackClientAddress,omitempty"` // TrackWaitEventTypes: Output only. Track wait event types during query // execution for an instance. This flag is turned "on" by default but tracking // is enabled only after observability enabled flag is also turned on. This is @@ -2114,6 +2246,9 @@ func (s ReadPoolConfig) MarshalJSON() ([]byte, error) { } type RestartInstanceRequest struct { + // NodeIds: Optional. Full name of the nodes as obtained from + // INSTANCE_VIEW_FULL to restart upon. Only applicable for read instances. + NodeIds []string `json:"nodeIds,omitempty"` // RequestId: Optional. An optional request ID to identify requests. Specify a // unique request ID so that if you must retry your request, the server will // know to ignore the request if it has already been completed. The server will @@ -2130,13 +2265,13 @@ type RestartInstanceRequest struct { // checks and any other type of validation), but do not actually execute the // restart. ValidateOnly bool `json:"validateOnly,omitempty"` - // ForceSendFields is a list of field names (e.g. "RequestId") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See + // ForceSendFields is a list of field names (e.g. "NodeIds") 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. "RequestId") to include in API + // NullFields is a list of field names (e.g. "NodeIds") 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. @@ -2266,6 +2401,49 @@ func (s SslConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// StageInfo: Stage information for different stages in the upgrade process. +type StageInfo struct { + // LogsUrl: logs_url is the URL for the logs associated with a stage if that + // stage has logs. Right now, only three stages have logs: ALLOYDB_PRECHECK, + // PG_UPGRADE_CHECK, PRIMARY_INSTANCE_UPGRADE. + LogsUrl string `json:"logsUrl,omitempty"` + // Stage: The stage. + // + // Possible values: + // "STAGE_UNSPECIFIED" - Unspecified stage. + // "ALLOYDB_PRECHECK" - This stage is for the custom checks done before + // upgrade. + // "PG_UPGRADE_CHECK" - This stage is for `pg_upgrade --check` run before + // upgrade. + // "PRIMARY_INSTANCE_UPGRADE" - This stage is primary upgrade. + // "READ_POOL_UPGRADE" - This stage is read pool upgrade. + Stage string `json:"stage,omitempty"` + // Status: Status of the stage. + // + // Possible values: + // "STATUS_UNSPECIFIED" - Unspecified status. + // "SUCCESS" - Operation succeeded. + // "FAILED" - Operation failed. + // "PARTIAL_SUCCESS" - Operation partially succeeded. + Status string `json:"status,omitempty"` + // ForceSendFields is a list of field names (e.g. "LogsUrl") 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. "LogsUrl") 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 StageInfo) MarshalJSON() ([]byte, error) { + type NoMethod StageInfo + 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 @@ -2429,20 +2607,23 @@ func (s StorageDatabasecenterPartnerapiV1mainCompliance) MarshalJSON() ([]byte, } // StorageDatabasecenterPartnerapiV1mainCustomMetadataData: Any custom metadata -// associated with the resource. i.e. A spanner instance can have multiple +// associated with the resource. e.g. A spanner instance can have multiple // databases with its own unique metadata. Information for these individual // databases can be captured in custom metadata data type StorageDatabasecenterPartnerapiV1mainCustomMetadataData struct { - DatabaseMetadata []*StorageDatabasecenterPartnerapiV1mainDatabaseMetadata `json:"databaseMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "DatabaseMetadata") to - // unconditionally include in API requests. By default, fields with empty or + // InternalResourceMetadata: Metadata for individual internal resources in an + // instance. e.g. spanner instance can have multiple databases with unique + // configuration. + InternalResourceMetadata []*StorageDatabasecenterPartnerapiV1mainInternalResourceMetadata `json:"internalResourceMetadata,omitempty"` + // ForceSendFields is a list of field names (e.g. "InternalResourceMetadata") + // 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. "DatabaseMetadata") 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. "InternalResourceMetadata") 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:"-"` } @@ -2452,37 +2633,6 @@ func (s StorageDatabasecenterPartnerapiV1mainCustomMetadataData) MarshalJSON() ( return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// StorageDatabasecenterPartnerapiV1mainDatabaseMetadata: Metadata for -// individual databases created in an instance. i.e. spanner instance can have -// multiple databases with unique configuration settings. -type StorageDatabasecenterPartnerapiV1mainDatabaseMetadata struct { - // BackupConfiguration: Backup configuration for this database - BackupConfiguration *StorageDatabasecenterPartnerapiV1mainBackupConfiguration `json:"backupConfiguration,omitempty"` - // BackupRun: Information about the last backup attempt for this database - BackupRun *StorageDatabasecenterPartnerapiV1mainBackupRun `json:"backupRun,omitempty"` - Product *StorageDatabasecenterProtoCommonProduct `json:"product,omitempty"` - ResourceId *StorageDatabasecenterPartnerapiV1mainDatabaseResourceId `json:"resourceId,omitempty"` - // ResourceName: Required. Database name. Resource name to follow CAIS - // resource_name format as noted here go/condor-common-datamodel - ResourceName string `json:"resourceName,omitempty"` - // ForceSendFields is a list of field names (e.g. "BackupConfiguration") 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. "BackupConfiguration") 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 StorageDatabasecenterPartnerapiV1mainDatabaseMetadata) MarshalJSON() ([]byte, error) { - type NoMethod StorageDatabasecenterPartnerapiV1mainDatabaseMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // StorageDatabasecenterPartnerapiV1mainDatabaseResourceFeed: // DatabaseResourceFeed is the top level proto to be used to ingest different // database resource level events into Condor platform. @@ -2498,8 +2648,7 @@ type StorageDatabasecenterPartnerapiV1mainDatabaseResourceFeed struct { // "SECURITY_FINDING_DATA" - Database resource security health signal data // "RECOMMENDATION_SIGNAL_DATA" - Database resource recommendation signal // data - FeedType string `json:"feedType,omitempty"` - // ObservabilityMetricData: More feed data would be added in subsequent CLs + FeedType string `json:"feedType,omitempty"` ObservabilityMetricData *StorageDatabasecenterPartnerapiV1mainObservabilityMetricData `json:"observabilityMetricData,omitempty"` RecommendationSignalData *StorageDatabasecenterPartnerapiV1mainDatabaseResourceRecommendationSignalData `json:"recommendationSignalData,omitempty"` ResourceHealthSignalData *StorageDatabasecenterPartnerapiV1mainDatabaseResourceHealthSignalData `json:"resourceHealthSignalData,omitempty"` @@ -2592,6 +2741,22 @@ type StorageDatabasecenterPartnerapiV1mainDatabaseResourceHealthSignalData struc // SignalId: Required. Unique identifier for the signal. This is an unique id // which would be mainatined by partner to identify a signal. SignalId string `json:"signalId,omitempty"` + // SignalSeverity: The severity of the signal, such as if it's a HIGH or LOW + // severity. + // + // Possible values: + // "SIGNAL_SEVERITY_UNSPECIFIED" - This value is used for findings when a + // source doesn't write a severity value. + // "CRITICAL" - A critical vulnerability is easily discoverable by an + // external actor, exploitable. + // "HIGH" - A high risk vulnerability can be easily discovered and exploited + // in combination with other vulnerabilities. + // "MEDIUM" - A medium risk vulnerability could be used by an actor to gain + // access to resources or privileges that enable them to eventually gain access + // and the ability to execute arbitrary code or exfiltrate data. + // "LOW" - A low risk vulnerability hampers a security organization's ability + // to detect vulnerabilities or active threats in their deployment. + SignalSeverity string `json:"signalSeverity,omitempty"` // SignalType: Required. Type of signal, for example, // `AVAILABLE_IN_MULTIPLE_ZONES`, `LOGGING_MOST_ERRORS`, etc. // @@ -2829,8 +2994,10 @@ type StorageDatabasecenterPartnerapiV1mainDatabaseResourceId struct { // ResourceType: Required. The type of resource this ID is identifying. Ex // redis.googleapis.com/Instance, redis.googleapis.com/Cluster, // alloydb.googleapis.com/Cluster, alloydb.googleapis.com/Instance, - // spanner.googleapis.com/Instance REQUIRED Please refer - // go/condor-common-datamodel + // spanner.googleapis.com/Instance, spanner.googleapis.com/Database, + // firestore.googleapis.com/Database, sqladmin.googleapis.com/Instance, + // bigtableadmin.googleapis.com/Cluster, bigtableadmin.googleapis.com/Instance + // REQUIRED Please refer go/condor-common-datamodel ResourceType string `json:"resourceType,omitempty"` // UniqueId: Required. A service-local token that distinguishes this resource // from other resources within the same service. @@ -3245,6 +3412,39 @@ func (s StorageDatabasecenterPartnerapiV1mainEntitlement) MarshalJSON() ([]byte, return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// StorageDatabasecenterPartnerapiV1mainInternalResourceMetadata: Metadata for +// individual internal resources in an instance. e.g. spanner instance can have +// multiple databases with unique configuration settings. Similarly bigtable +// can have multiple clusters within same bigtable instance. +type StorageDatabasecenterPartnerapiV1mainInternalResourceMetadata struct { + // BackupConfiguration: Backup configuration for this database + BackupConfiguration *StorageDatabasecenterPartnerapiV1mainBackupConfiguration `json:"backupConfiguration,omitempty"` + // BackupRun: Information about the last backup attempt for this database + BackupRun *StorageDatabasecenterPartnerapiV1mainBackupRun `json:"backupRun,omitempty"` + Product *StorageDatabasecenterProtoCommonProduct `json:"product,omitempty"` + ResourceId *StorageDatabasecenterPartnerapiV1mainDatabaseResourceId `json:"resourceId,omitempty"` + // ResourceName: Required. internal resource name for spanner this will be + // database name + // e.g."spanner.googleapis.com/projects/123/abc/instances/inst1/databases/db1" + ResourceName string `json:"resourceName,omitempty"` + // ForceSendFields is a list of field names (e.g. "BackupConfiguration") 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. "BackupConfiguration") 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 StorageDatabasecenterPartnerapiV1mainInternalResourceMetadata) MarshalJSON() ([]byte, error) { + type NoMethod StorageDatabasecenterPartnerapiV1mainInternalResourceMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // StorageDatabasecenterPartnerapiV1mainMachineConfiguration: // MachineConfiguration describes the configuration of a machine specific to // Database Resource. @@ -3442,6 +3642,8 @@ type StorageDatabasecenterProtoCommonProduct struct { // dialect. // "ENGINE_OTHER" - Other refers to rest of other database engine. This is to // be when engine is known, but it is not present in this enum. + // "ENGINE_FIRESTORE_WITH_NATIVE_MODE" - Firestore with native mode. + // "ENGINE_FIRESTORE_WITH_DATASTORE_MODE" - Firestore with datastore mode. Engine string `json:"engine,omitempty"` // Type: Type of specific database product. It could be CloudSQL, AlloyDB etc.. // @@ -3459,6 +3661,7 @@ type StorageDatabasecenterProtoCommonProduct struct { // "PRODUCT_TYPE_BIGTABLE" - Bigtable product area in GCP // "PRODUCT_TYPE_OTHER" - Other refers to rest of other product type. This is // to be when product type is known, but it is not present in this enum. + // "PRODUCT_TYPE_FIRESTORE" - Firestore product area in GCP. Type string `json:"type,omitempty"` // Version: Version of the underlying database engine. Example values: For // MySQL, it could be "8.0", "5.7" etc.. For Postgres, it could be "14", "15" @@ -3672,6 +3875,8 @@ func (s TimeBasedRetention) MarshalJSON() ([]byte, error) { type TrialMetadata struct { // EndTime: End time of the trial cluster. EndTime string `json:"endTime,omitempty"` + // GraceEndTime: grace end time of the cluster. + GraceEndTime string `json:"graceEndTime,omitempty"` // StartTime: start time of the trial cluster. StartTime string `json:"startTime,omitempty"` // UpgradeTime: Upgrade time of trial cluster to Standard cluster. @@ -3722,6 +3927,90 @@ func (s UpdatePolicy) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// UpgradeClusterRequest: Upgrades a cluster. +type UpgradeClusterRequest struct { + // Etag: Optional. The current etag of the Cluster. If an etag is provided and + // does not match the current etag of the Cluster, upgrade will be blocked and + // an ABORTED error will be returned. + Etag string `json:"etag,omitempty"` + // RequestId: Optional. An optional request ID to identify requests. Specify a + // unique request ID so that if you must retry your request, the server will + // know to ignore the request if it has already been completed. The server will + // guarantee that for at least 60 minutes after the first request. For example, + // consider a situation where you make an initial request and the request times + // out. If you make the request again with the same request ID, the server can + // check if original operation with the same request ID was received, and if + // so, will ignore the second request. This prevents clients from accidentally + // creating duplicate commitments. The request ID must be a valid UUID with the + // exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + RequestId string `json:"requestId,omitempty"` + // ValidateOnly: Optional. If set, performs request validation (e.g. permission + // checks and any other type of validation), but does not actually execute the + // upgrade. + ValidateOnly bool `json:"validateOnly,omitempty"` + // Version: Required. The version the cluster is going to be upgraded to. + // + // Possible values: + // "DATABASE_VERSION_UNSPECIFIED" - This is an unknown database version. + // "POSTGRES_13" - DEPRECATED - The database version is Postgres 13. + // "POSTGRES_14" - The database version is Postgres 14. + // "POSTGRES_15" - The database version is Postgres 15. + // "POSTGRES_16" - The database version is Postgres 16. + Version string `json:"version,omitempty"` + // ForceSendFields is a list of field names (e.g. "Etag") 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. "Etag") 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 UpgradeClusterRequest) MarshalJSON() ([]byte, error) { + type NoMethod UpgradeClusterRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// UpgradeClusterResponse: UpgradeClusterResponse contains the response for +// upgrade cluster operation. +type UpgradeClusterResponse struct { + // ClusterUpgradeDetails: Array of upgrade details for the current cluster and + // all the secondary clusters associated with this cluster. + ClusterUpgradeDetails []*ClusterUpgradeDetails `json:"clusterUpgradeDetails,omitempty"` + // Message: A user friendly message summarising the upgrade operation details + // and the next steps for the user if there is any. + Message string `json:"message,omitempty"` + // Status: Status of upgrade operation. + // + // Possible values: + // "STATUS_UNSPECIFIED" - Unspecified status. + // "SUCCESS" - Operation succeeded. + // "FAILED" - Operation failed. + // "PARTIAL_SUCCESS" - Operation partially succeeded. + Status string `json:"status,omitempty"` + // ForceSendFields is a list of field names (e.g. "ClusterUpgradeDetails") 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. "ClusterUpgradeDetails") 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 UpgradeClusterResponse) MarshalJSON() ([]byte, error) { + type NoMethod UpgradeClusterResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // User: Message describing User object. type User struct { // DatabaseRoles: Optional. List of database roles this user has. The database @@ -5915,6 +6204,107 @@ func (c *ProjectsLocationsClustersSwitchoverCall) Do(opts ...googleapi.CallOptio return ret, nil } +type ProjectsLocationsClustersUpgradeCall struct { + s *Service + name string + upgradeclusterrequest *UpgradeClusterRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Upgrade: Upgrades a single Cluster. Imperative only. +// +// - name: The resource name of the cluster. +func (r *ProjectsLocationsClustersService) Upgrade(name string, upgradeclusterrequest *UpgradeClusterRequest) *ProjectsLocationsClustersUpgradeCall { + c := &ProjectsLocationsClustersUpgradeCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.upgradeclusterrequest = upgradeclusterrequest + 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 *ProjectsLocationsClustersUpgradeCall) Fields(s ...googleapi.Field) *ProjectsLocationsClustersUpgradeCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsClustersUpgradeCall) Context(ctx context.Context) *ProjectsLocationsClustersUpgradeCall { + 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 *ProjectsLocationsClustersUpgradeCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsClustersUpgradeCall) 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.upgradeclusterrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}:upgrade") + 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 "alloydb.projects.locations.clusters.upgrade" 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 *ProjectsLocationsClustersUpgradeCall) 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 ProjectsLocationsClustersInstancesCreateCall struct { s *Service parent string diff --git a/alloydb/v1beta/alloydb-api.json b/alloydb/v1beta/alloydb-api.json index 67be97a0eab..94061ecd229 100644 --- a/alloydb/v1beta/alloydb-api.json +++ b/alloydb/v1beta/alloydb-api.json @@ -1486,7 +1486,7 @@ } } }, - "revision": "20240703", + "revision": "20240806", "rootUrl": "https://alloydb.googleapis.com/", "schemas": { "AuthorizedNetwork": { @@ -1772,6 +1772,26 @@ }, "type": "object" }, + "CloudSQLBackupRunSource": { + "description": "The source CloudSQL backup resource.", + "id": "CloudSQLBackupRunSource", + "properties": { + "backupRunId": { + "description": "Required. The CloudSQL backup run ID.", + "format": "int64", + "type": "string" + }, + "instanceId": { + "description": "Required. The CloudSQL instance ID.", + "type": "string" + }, + "project": { + "description": "The project ID of the source CloudSQL instance. This should be the same as the AlloyDB cluster's project.", + "type": "string" + } + }, + "type": "object" + }, "Cluster": { "description": "A cluster is a collection of regional AlloyDB resources. It can include a primary instance and one or more read pool instances. All cluster resources share a storage layer, which scales as needed.", "id": "Cluster", @@ -1792,6 +1812,11 @@ "description": "Output only. Cluster created from backup.", "readOnly": true }, + "cloudsqlBackupRunSource": { + "$ref": "CloudSQLBackupRunSource", + "description": "Output only. Cluster created from CloudSQL snapshot.", + "readOnly": true + }, "clusterType": { "description": "Output only. The type of the cluster. This is an output-only field and it's populated at the Cluster creation time or the Cluster promotion time. The cluster type is determined by which RPC was used to create the cluster (i.e. `CreateCluster` vs. `CreateSecondaryCluster`", "enum": [ @@ -2002,6 +2027,86 @@ }, "type": "object" }, + "ClusterUpgradeDetails": { + "description": "Upgrade details of a cluster. This cluster can be primary or secondary.", + "id": "ClusterUpgradeDetails", + "properties": { + "clusterType": { + "description": "Cluster type which can either be primary or secondary.", + "enum": [ + "CLUSTER_TYPE_UNSPECIFIED", + "PRIMARY", + "SECONDARY" + ], + "enumDescriptions": [ + "The type of the cluster is unknown.", + "Primary cluster that support read and write operations.", + "Secondary cluster that is replicating from another region. This only supports read." + ], + "type": "string" + }, + "databaseVersion": { + "description": "Database version of the cluster after the upgrade operation. This will be the target version if the upgrade was successful otherwise it remains the same as that before the upgrade operation.", + "enum": [ + "DATABASE_VERSION_UNSPECIFIED", + "POSTGRES_13", + "POSTGRES_14", + "POSTGRES_15", + "POSTGRES_16" + ], + "enumDeprecated": [ + false, + true, + false, + false, + false + ], + "enumDescriptions": [ + "This is an unknown database version.", + "DEPRECATED - The database version is Postgres 13.", + "The database version is Postgres 14.", + "The database version is Postgres 15.", + "The database version is Postgres 16." + ], + "type": "string" + }, + "instanceUpgradeDetails": { + "description": "Upgrade details of the instances directly associated with this cluster.", + "items": { + "$ref": "InstanceUpgradeDetails" + }, + "type": "array" + }, + "name": { + "description": "Normalized name of the cluster", + "type": "string" + }, + "stageInfo": { + "description": "Array containing stage info associated with this cluster.", + "items": { + "$ref": "StageInfo" + }, + "type": "array" + }, + "upgradeStatus": { + "description": "Upgrade status of the cluster.", + "enum": [ + "STATUS_UNSPECIFIED", + "SUCCESS", + "FAILED", + "PARTIAL_SUCCESS" + ], + "enumDescriptions": [ + "Unspecified status.", + "Operation succeeded.", + "Operation failed.", + "Operation partially succeeded." + ], + "type": "string" + } + }, + "type": "object" + }, "ConnectionInfo": { "description": "ConnectionInfo singleton resource. https://google.aip.dev/156", "id": "ConnectionInfo", @@ -2546,6 +2651,49 @@ }, "type": "object" }, + "InstanceUpgradeDetails": { + "description": "Details regarding the upgrade of instaces associated with a cluster.", + "id": "InstanceUpgradeDetails", + "properties": { + "instanceType": { + "description": "Instance type.", + "enum": [ + "INSTANCE_TYPE_UNSPECIFIED", + "PRIMARY", + "READ_POOL", + "SECONDARY" + ], + "enumDescriptions": [ + "The type of the instance is unknown.", + "PRIMARY instances support read and write operations.", + "READ POOL instances support read operations only. Each read pool instance consists of one or more homogeneous nodes. * Read pool of size 1 can only have zonal availability. * Read pools with node count of 2 or more can have regional availability (nodes are present in 2 or more zones in a region).", + "SECONDARY instances support read operations only. SECONDARY instance is a cross-region read replica" + ], + "type": "string" + }, + "name": { + "description": "Normalized name of the instance.", + "type": "string" + }, + "upgradeStatus": { + "description": "Upgrade status of the instance.", + "enum": [ + "STATUS_UNSPECIFIED", + "SUCCESS", + "FAILED", + "PARTIAL_SUCCESS" + ], + "enumDescriptions": [ + "Unspecified status.", + "Operation succeeded.", + "Operation failed.", + "Operation partially succeeded." + ], + "type": "string" + } + }, + "type": "object" + }, "IntegerRestrictions": { "description": "Restrictions on INTEGER type values.", "id": "IntegerRestrictions", @@ -2871,6 +3019,10 @@ "description": "Track actively running queries on the instance. If not set, this flag is \"off\" by default.", "type": "boolean" }, + "trackClientAddress": { + "description": "Track client address for an instance. If not set, default value is \"off\".", + "type": "boolean" + }, "trackWaitEventTypes": { "description": "Output only. Track wait event types during query execution for an instance. This flag is turned \"on\" by default but tracking is enabled only after observability enabled flag is also turned on. This is read-only flag and only modifiable by producer API.", "readOnly": true, @@ -3102,6 +3254,13 @@ "RestartInstanceRequest": { "id": "RestartInstanceRequest", "properties": { + "nodeIds": { + "description": "Optional. Full name of the nodes as obtained from INSTANCE_VIEW_FULL to restart upon. Only applicable for read instances.", + "items": { + "type": "string" + }, + "type": "array" + }, "requestId": { "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "type": "string" @@ -3202,6 +3361,51 @@ }, "type": "object" }, + "StageInfo": { + "description": "Stage information for different stages in the upgrade process.", + "id": "StageInfo", + "properties": { + "logsUrl": { + "description": "logs_url is the URL for the logs associated with a stage if that stage has logs. Right now, only three stages have logs: ALLOYDB_PRECHECK, PG_UPGRADE_CHECK, PRIMARY_INSTANCE_UPGRADE.", + "type": "string" + }, + "stage": { + "description": "The stage.", + "enum": [ + "STAGE_UNSPECIFIED", + "ALLOYDB_PRECHECK", + "PG_UPGRADE_CHECK", + "PRIMARY_INSTANCE_UPGRADE", + "READ_POOL_UPGRADE" + ], + "enumDescriptions": [ + "Unspecified stage.", + "This stage is for the custom checks done before upgrade.", + "This stage is for `pg_upgrade --check` run before upgrade.", + "This stage is primary upgrade.", + "This stage is read pool upgrade." + ], + "type": "string" + }, + "status": { + "description": "Status of the stage.", + "enum": [ + "STATUS_UNSPECIFIED", + "SUCCESS", + "FAILED", + "PARTIAL_SUCCESS" + ], + "enumDescriptions": [ + "Unspecified status.", + "Operation succeeded.", + "Operation failed.", + "Operation partially succeeded." + ], + "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", @@ -3334,43 +3538,19 @@ "type": "object" }, "StorageDatabasecenterPartnerapiV1mainCustomMetadataData": { - "description": "Any custom metadata associated with the resource. i.e. A spanner instance can have multiple databases with its own unique metadata. Information for these individual databases can be captured in custom metadata data", + "description": "Any custom metadata associated with the resource. e.g. A spanner instance can have multiple databases with its own unique metadata. Information for these individual databases can be captured in custom metadata data", "id": "StorageDatabasecenterPartnerapiV1mainCustomMetadataData", "properties": { - "databaseMetadata": { + "internalResourceMetadata": { + "description": "Metadata for individual internal resources in an instance. e.g. spanner instance can have multiple databases with unique configuration.", "items": { - "$ref": "StorageDatabasecenterPartnerapiV1mainDatabaseMetadata" + "$ref": "StorageDatabasecenterPartnerapiV1mainInternalResourceMetadata" }, "type": "array" } }, "type": "object" }, - "StorageDatabasecenterPartnerapiV1mainDatabaseMetadata": { - "description": "Metadata for individual databases created in an instance. i.e. spanner instance can have multiple databases with unique configuration settings.", - "id": "StorageDatabasecenterPartnerapiV1mainDatabaseMetadata", - "properties": { - "backupConfiguration": { - "$ref": "StorageDatabasecenterPartnerapiV1mainBackupConfiguration", - "description": "Backup configuration for this database" - }, - "backupRun": { - "$ref": "StorageDatabasecenterPartnerapiV1mainBackupRun", - "description": "Information about the last backup attempt for this database" - }, - "product": { - "$ref": "StorageDatabasecenterProtoCommonProduct" - }, - "resourceId": { - "$ref": "StorageDatabasecenterPartnerapiV1mainDatabaseResourceId" - }, - "resourceName": { - "description": "Required. Database name. Resource name to follow CAIS resource_name format as noted here go/condor-common-datamodel", - "type": "string" - } - }, - "type": "object" - }, "StorageDatabasecenterPartnerapiV1mainDatabaseResourceFeed": { "description": "DatabaseResourceFeed is the top level proto to be used to ingest different database resource level events into Condor platform.", "id": "StorageDatabasecenterPartnerapiV1mainDatabaseResourceFeed", @@ -3399,8 +3579,7 @@ "type": "string" }, "observabilityMetricData": { - "$ref": "StorageDatabasecenterPartnerapiV1mainObservabilityMetricData", - "description": "More feed data would be added in subsequent CLs" + "$ref": "StorageDatabasecenterPartnerapiV1mainObservabilityMetricData" }, "recommendationSignalData": { "$ref": "StorageDatabasecenterPartnerapiV1mainDatabaseResourceRecommendationSignalData" @@ -3509,6 +3688,24 @@ "description": "Required. Unique identifier for the signal. This is an unique id which would be mainatined by partner to identify a signal.", "type": "string" }, + "signalSeverity": { + "description": "The severity of the signal, such as if it's a HIGH or LOW severity.", + "enum": [ + "SIGNAL_SEVERITY_UNSPECIFIED", + "CRITICAL", + "HIGH", + "MEDIUM", + "LOW" + ], + "enumDescriptions": [ + "This value is used for findings when a source doesn't write a severity value.", + "A critical vulnerability is easily discoverable by an external actor, exploitable.", + "A high risk vulnerability can be easily discovered and exploited in combination with other vulnerabilities.", + "A medium risk vulnerability could be used by an actor to gain access to resources or privileges that enable them to eventually gain access and the ability to execute arbitrary code or exfiltrate data.", + "A low risk vulnerability hampers a security organization's ability to detect vulnerabilities or active threats in their deployment." + ], + "type": "string" + }, "signalType": { "description": "Required. Type of signal, for example, `AVAILABLE_IN_MULTIPLE_ZONES`, `LOGGING_MOST_ERRORS`, etc.", "enum": [ @@ -3805,7 +4002,7 @@ "type": "string" }, "resourceType": { - "description": "Required. The type of resource this ID is identifying. Ex redis.googleapis.com/Instance, redis.googleapis.com/Cluster, alloydb.googleapis.com/Cluster, alloydb.googleapis.com/Instance, spanner.googleapis.com/Instance REQUIRED Please refer go/condor-common-datamodel", + "description": "Required. The type of resource this ID is identifying. Ex redis.googleapis.com/Instance, redis.googleapis.com/Cluster, alloydb.googleapis.com/Cluster, alloydb.googleapis.com/Instance, spanner.googleapis.com/Instance, spanner.googleapis.com/Database, firestore.googleapis.com/Database, sqladmin.googleapis.com/Instance, bigtableadmin.googleapis.com/Cluster, bigtableadmin.googleapis.com/Instance REQUIRED Please refer go/condor-common-datamodel", "type": "string" }, "uniqueId": { @@ -4303,6 +4500,31 @@ }, "type": "object" }, + "StorageDatabasecenterPartnerapiV1mainInternalResourceMetadata": { + "description": "Metadata for individual internal resources in an instance. e.g. spanner instance can have multiple databases with unique configuration settings. Similarly bigtable can have multiple clusters within same bigtable instance.", + "id": "StorageDatabasecenterPartnerapiV1mainInternalResourceMetadata", + "properties": { + "backupConfiguration": { + "$ref": "StorageDatabasecenterPartnerapiV1mainBackupConfiguration", + "description": "Backup configuration for this database" + }, + "backupRun": { + "$ref": "StorageDatabasecenterPartnerapiV1mainBackupRun", + "description": "Information about the last backup attempt for this database" + }, + "product": { + "$ref": "StorageDatabasecenterProtoCommonProduct" + }, + "resourceId": { + "$ref": "StorageDatabasecenterPartnerapiV1mainDatabaseResourceId" + }, + "resourceName": { + "description": "Required. internal resource name for spanner this will be database name e.g.\"spanner.googleapis.com/projects/123/abc/instances/inst1/databases/db1\"", + "type": "string" + } + }, + "type": "object" + }, "StorageDatabasecenterPartnerapiV1mainMachineConfiguration": { "description": "MachineConfiguration describes the configuration of a machine specific to Database Resource.", "id": "StorageDatabasecenterPartnerapiV1mainMachineConfiguration", @@ -4476,7 +4698,9 @@ "ENGINE_CLOUD_SPANNER_WITH_GOOGLESQL_DIALECT", "ENGINE_MEMORYSTORE_FOR_REDIS", "ENGINE_MEMORYSTORE_FOR_REDIS_CLUSTER", - "ENGINE_OTHER" + "ENGINE_OTHER", + "ENGINE_FIRESTORE_WITH_NATIVE_MODE", + "ENGINE_FIRESTORE_WITH_DATASTORE_MODE" ], "enumDeprecated": [ false, @@ -4492,6 +4716,8 @@ false, false, false, + false, + false, false ], "enumDescriptions": [ @@ -4508,7 +4734,9 @@ "Cloud Spanner with Google SQL dialect.", "Memorystore with Redis dialect.", "Memorystore with Redis cluster dialect.", - "Other refers to rest of other database engine. This is to be when engine is known, but it is not present in this enum." + "Other refers to rest of other database engine. This is to be when engine is known, but it is not present in this enum.", + "Firestore with native mode.", + "Firestore with datastore mode." ], "type": "string" }, @@ -4525,7 +4753,8 @@ "ON_PREM", "PRODUCT_TYPE_MEMORYSTORE", "PRODUCT_TYPE_BIGTABLE", - "PRODUCT_TYPE_OTHER" + "PRODUCT_TYPE_OTHER", + "PRODUCT_TYPE_FIRESTORE" ], "enumDeprecated": [ false, @@ -4538,6 +4767,7 @@ true, false, false, + false, false ], "enumDescriptions": [ @@ -4551,7 +4781,8 @@ "On premises database product.", "Memorystore product area in GCP", "Bigtable product area in GCP", - "Other refers to rest of other product type. This is to be when product type is known, but it is not present in this enum." + "Other refers to rest of other product type. This is to be when product type is known, but it is not present in this enum.", + "Firestore product area in GCP." ], "type": "string" }, @@ -4713,6 +4944,11 @@ "format": "google-datetime", "type": "string" }, + "graceEndTime": { + "description": "grace end time of the cluster.", + "format": "google-datetime", + "type": "string" + }, "startTime": { "description": "start time of the trial cluster.", "format": "google-datetime", @@ -4747,6 +4983,40 @@ }, "type": "object" }, + "UpgradeClusterResponse": { + "description": "UpgradeClusterResponse contains the response for upgrade cluster operation.", + "id": "UpgradeClusterResponse", + "properties": { + "clusterUpgradeDetails": { + "description": "Array of upgrade details for the current cluster and all the secondary clusters associated with this cluster.", + "items": { + "$ref": "ClusterUpgradeDetails" + }, + "type": "array" + }, + "message": { + "description": "A user friendly message summarising the upgrade operation details and the next steps for the user if there is any.", + "type": "string" + }, + "status": { + "description": "Status of upgrade operation.", + "enum": [ + "STATUS_UNSPECIFIED", + "SUCCESS", + "FAILED", + "PARTIAL_SUCCESS" + ], + "enumDescriptions": [ + "Unspecified status.", + "Operation succeeded.", + "Operation failed.", + "Operation partially succeeded." + ], + "type": "string" + } + }, + "type": "object" + }, "User": { "description": "Message describing User object.", "id": "User", diff --git a/alloydb/v1beta/alloydb-gen.go b/alloydb/v1beta/alloydb-gen.go index 01b50b3bcb5..5a3e3d5d6d3 100644 --- a/alloydb/v1beta/alloydb-gen.go +++ b/alloydb/v1beta/alloydb-gen.go @@ -520,6 +520,33 @@ func (s CloudControl2SharedOperationsReconciliationOperationMetadata) MarshalJSO return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// CloudSQLBackupRunSource: The source CloudSQL backup resource. +type CloudSQLBackupRunSource struct { + // BackupRunId: Required. The CloudSQL backup run ID. + BackupRunId int64 `json:"backupRunId,omitempty,string"` + // InstanceId: Required. The CloudSQL instance ID. + InstanceId string `json:"instanceId,omitempty"` + // Project: The project ID of the source CloudSQL instance. This should be the + // same as the AlloyDB cluster's project. + Project string `json:"project,omitempty"` + // ForceSendFields is a list of field names (e.g. "BackupRunId") 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. "BackupRunId") 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 CloudSQLBackupRunSource) MarshalJSON() ([]byte, error) { + type NoMethod CloudSQLBackupRunSource + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Cluster: A cluster is a collection of regional AlloyDB resources. It can // include a primary instance and one or more read pool instances. All cluster // resources share a storage layer, which scales as needed. @@ -535,6 +562,9 @@ type Cluster struct { AutomatedBackupPolicy *AutomatedBackupPolicy `json:"automatedBackupPolicy,omitempty"` // BackupSource: Output only. Cluster created from backup. BackupSource *BackupSource `json:"backupSource,omitempty"` + // CloudsqlBackupRunSource: Output only. Cluster created from CloudSQL + // snapshot. + CloudsqlBackupRunSource *CloudSQLBackupRunSource `json:"cloudsqlBackupRunSource,omitempty"` // ClusterType: Output only. The type of the cluster. This is an output-only // field and it's populated at the Cluster creation time or the Cluster // promotion time. The cluster type is determined by which RPC was used to @@ -690,6 +720,61 @@ func (s Cluster) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ClusterUpgradeDetails: Upgrade details of a cluster. This cluster can be +// primary or secondary. +type ClusterUpgradeDetails struct { + // ClusterType: Cluster type which can either be primary or secondary. + // + // Possible values: + // "CLUSTER_TYPE_UNSPECIFIED" - The type of the cluster is unknown. + // "PRIMARY" - Primary cluster that support read and write operations. + // "SECONDARY" - Secondary cluster that is replicating from another region. + // This only supports read. + ClusterType string `json:"clusterType,omitempty"` + // DatabaseVersion: Database version of the cluster after the upgrade + // operation. This will be the target version if the upgrade was successful + // otherwise it remains the same as that before the upgrade operation. + // + // Possible values: + // "DATABASE_VERSION_UNSPECIFIED" - This is an unknown database version. + // "POSTGRES_13" - DEPRECATED - The database version is Postgres 13. + // "POSTGRES_14" - The database version is Postgres 14. + // "POSTGRES_15" - The database version is Postgres 15. + // "POSTGRES_16" - The database version is Postgres 16. + DatabaseVersion string `json:"databaseVersion,omitempty"` + // InstanceUpgradeDetails: Upgrade details of the instances directly associated + // with this cluster. + InstanceUpgradeDetails []*InstanceUpgradeDetails `json:"instanceUpgradeDetails,omitempty"` + // Name: Normalized name of the cluster + Name string `json:"name,omitempty"` + // StageInfo: Array containing stage info associated with this cluster. + StageInfo []*StageInfo `json:"stageInfo,omitempty"` + // UpgradeStatus: Upgrade status of the cluster. + // + // Possible values: + // "STATUS_UNSPECIFIED" - Unspecified status. + // "SUCCESS" - Operation succeeded. + // "FAILED" - Operation failed. + // "PARTIAL_SUCCESS" - Operation partially succeeded. + UpgradeStatus string `json:"upgradeStatus,omitempty"` + // ForceSendFields is a list of field names (e.g. "ClusterType") 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. "ClusterType") 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 ClusterUpgradeDetails) MarshalJSON() ([]byte, error) { + type NoMethod ClusterUpgradeDetails + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ConnectionInfo: ConnectionInfo singleton resource. // https://google.aip.dev/156 type ConnectionInfo struct { @@ -1331,6 +1416,50 @@ func (s InstanceNetworkConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// InstanceUpgradeDetails: Details regarding the upgrade of instaces associated +// with a cluster. +type InstanceUpgradeDetails struct { + // InstanceType: Instance type. + // + // Possible values: + // "INSTANCE_TYPE_UNSPECIFIED" - The type of the instance is unknown. + // "PRIMARY" - PRIMARY instances support read and write operations. + // "READ_POOL" - READ POOL instances support read operations only. Each read + // pool instance consists of one or more homogeneous nodes. * Read pool of size + // 1 can only have zonal availability. * Read pools with node count of 2 or + // more can have regional availability (nodes are present in 2 or more zones in + // a region). + // "SECONDARY" - SECONDARY instances support read operations only. SECONDARY + // instance is a cross-region read replica + InstanceType string `json:"instanceType,omitempty"` + // Name: Normalized name of the instance. + Name string `json:"name,omitempty"` + // UpgradeStatus: Upgrade status of the instance. + // + // Possible values: + // "STATUS_UNSPECIFIED" - Unspecified status. + // "SUCCESS" - Operation succeeded. + // "FAILED" - Operation failed. + // "PARTIAL_SUCCESS" - Operation partially succeeded. + UpgradeStatus string `json:"upgradeStatus,omitempty"` + // ForceSendFields is a list of field names (e.g. "InstanceType") 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. "InstanceType") 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 InstanceUpgradeDetails) MarshalJSON() ([]byte, error) { + type NoMethod InstanceUpgradeDetails + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // IntegerRestrictions: Restrictions on INTEGER type values. type IntegerRestrictions struct { // MaxValue: The maximum value that can be specified, if applicable. @@ -1760,6 +1889,9 @@ type ObservabilityInstanceConfig struct { // TrackActiveQueries: Track actively running queries on the instance. If not // set, this flag is "off" by default. TrackActiveQueries bool `json:"trackActiveQueries,omitempty"` + // TrackClientAddress: Track client address for an instance. If not set, + // default value is "off". + TrackClientAddress bool `json:"trackClientAddress,omitempty"` // TrackWaitEventTypes: Output only. Track wait event types during query // execution for an instance. This flag is turned "on" by default but tracking // is enabled only after observability enabled flag is also turned on. This is @@ -2104,6 +2236,9 @@ func (s ReadPoolConfig) MarshalJSON() ([]byte, error) { } type RestartInstanceRequest struct { + // NodeIds: Optional. Full name of the nodes as obtained from + // INSTANCE_VIEW_FULL to restart upon. Only applicable for read instances. + NodeIds []string `json:"nodeIds,omitempty"` // RequestId: Optional. An optional request ID to identify requests. Specify a // unique request ID so that if you must retry your request, the server will // know to ignore the request if it has already been completed. The server will @@ -2120,13 +2255,13 @@ type RestartInstanceRequest struct { // checks and any other type of validation), but do not actually execute the // restart. ValidateOnly bool `json:"validateOnly,omitempty"` - // ForceSendFields is a list of field names (e.g. "RequestId") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See + // ForceSendFields is a list of field names (e.g. "NodeIds") 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. "RequestId") to include in API + // NullFields is a list of field names (e.g. "NodeIds") 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. @@ -2256,6 +2391,49 @@ func (s SslConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// StageInfo: Stage information for different stages in the upgrade process. +type StageInfo struct { + // LogsUrl: logs_url is the URL for the logs associated with a stage if that + // stage has logs. Right now, only three stages have logs: ALLOYDB_PRECHECK, + // PG_UPGRADE_CHECK, PRIMARY_INSTANCE_UPGRADE. + LogsUrl string `json:"logsUrl,omitempty"` + // Stage: The stage. + // + // Possible values: + // "STAGE_UNSPECIFIED" - Unspecified stage. + // "ALLOYDB_PRECHECK" - This stage is for the custom checks done before + // upgrade. + // "PG_UPGRADE_CHECK" - This stage is for `pg_upgrade --check` run before + // upgrade. + // "PRIMARY_INSTANCE_UPGRADE" - This stage is primary upgrade. + // "READ_POOL_UPGRADE" - This stage is read pool upgrade. + Stage string `json:"stage,omitempty"` + // Status: Status of the stage. + // + // Possible values: + // "STATUS_UNSPECIFIED" - Unspecified status. + // "SUCCESS" - Operation succeeded. + // "FAILED" - Operation failed. + // "PARTIAL_SUCCESS" - Operation partially succeeded. + Status string `json:"status,omitempty"` + // ForceSendFields is a list of field names (e.g. "LogsUrl") 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. "LogsUrl") 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 StageInfo) MarshalJSON() ([]byte, error) { + type NoMethod StageInfo + 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 @@ -2419,20 +2597,23 @@ func (s StorageDatabasecenterPartnerapiV1mainCompliance) MarshalJSON() ([]byte, } // StorageDatabasecenterPartnerapiV1mainCustomMetadataData: Any custom metadata -// associated with the resource. i.e. A spanner instance can have multiple +// associated with the resource. e.g. A spanner instance can have multiple // databases with its own unique metadata. Information for these individual // databases can be captured in custom metadata data type StorageDatabasecenterPartnerapiV1mainCustomMetadataData struct { - DatabaseMetadata []*StorageDatabasecenterPartnerapiV1mainDatabaseMetadata `json:"databaseMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "DatabaseMetadata") to - // unconditionally include in API requests. By default, fields with empty or + // InternalResourceMetadata: Metadata for individual internal resources in an + // instance. e.g. spanner instance can have multiple databases with unique + // configuration. + InternalResourceMetadata []*StorageDatabasecenterPartnerapiV1mainInternalResourceMetadata `json:"internalResourceMetadata,omitempty"` + // ForceSendFields is a list of field names (e.g. "InternalResourceMetadata") + // 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. "DatabaseMetadata") 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. "InternalResourceMetadata") 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:"-"` } @@ -2442,37 +2623,6 @@ func (s StorageDatabasecenterPartnerapiV1mainCustomMetadataData) MarshalJSON() ( return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// StorageDatabasecenterPartnerapiV1mainDatabaseMetadata: Metadata for -// individual databases created in an instance. i.e. spanner instance can have -// multiple databases with unique configuration settings. -type StorageDatabasecenterPartnerapiV1mainDatabaseMetadata struct { - // BackupConfiguration: Backup configuration for this database - BackupConfiguration *StorageDatabasecenterPartnerapiV1mainBackupConfiguration `json:"backupConfiguration,omitempty"` - // BackupRun: Information about the last backup attempt for this database - BackupRun *StorageDatabasecenterPartnerapiV1mainBackupRun `json:"backupRun,omitempty"` - Product *StorageDatabasecenterProtoCommonProduct `json:"product,omitempty"` - ResourceId *StorageDatabasecenterPartnerapiV1mainDatabaseResourceId `json:"resourceId,omitempty"` - // ResourceName: Required. Database name. Resource name to follow CAIS - // resource_name format as noted here go/condor-common-datamodel - ResourceName string `json:"resourceName,omitempty"` - // ForceSendFields is a list of field names (e.g. "BackupConfiguration") 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. "BackupConfiguration") 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 StorageDatabasecenterPartnerapiV1mainDatabaseMetadata) MarshalJSON() ([]byte, error) { - type NoMethod StorageDatabasecenterPartnerapiV1mainDatabaseMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // StorageDatabasecenterPartnerapiV1mainDatabaseResourceFeed: // DatabaseResourceFeed is the top level proto to be used to ingest different // database resource level events into Condor platform. @@ -2488,8 +2638,7 @@ type StorageDatabasecenterPartnerapiV1mainDatabaseResourceFeed struct { // "SECURITY_FINDING_DATA" - Database resource security health signal data // "RECOMMENDATION_SIGNAL_DATA" - Database resource recommendation signal // data - FeedType string `json:"feedType,omitempty"` - // ObservabilityMetricData: More feed data would be added in subsequent CLs + FeedType string `json:"feedType,omitempty"` ObservabilityMetricData *StorageDatabasecenterPartnerapiV1mainObservabilityMetricData `json:"observabilityMetricData,omitempty"` RecommendationSignalData *StorageDatabasecenterPartnerapiV1mainDatabaseResourceRecommendationSignalData `json:"recommendationSignalData,omitempty"` ResourceHealthSignalData *StorageDatabasecenterPartnerapiV1mainDatabaseResourceHealthSignalData `json:"resourceHealthSignalData,omitempty"` @@ -2582,6 +2731,22 @@ type StorageDatabasecenterPartnerapiV1mainDatabaseResourceHealthSignalData struc // SignalId: Required. Unique identifier for the signal. This is an unique id // which would be mainatined by partner to identify a signal. SignalId string `json:"signalId,omitempty"` + // SignalSeverity: The severity of the signal, such as if it's a HIGH or LOW + // severity. + // + // Possible values: + // "SIGNAL_SEVERITY_UNSPECIFIED" - This value is used for findings when a + // source doesn't write a severity value. + // "CRITICAL" - A critical vulnerability is easily discoverable by an + // external actor, exploitable. + // "HIGH" - A high risk vulnerability can be easily discovered and exploited + // in combination with other vulnerabilities. + // "MEDIUM" - A medium risk vulnerability could be used by an actor to gain + // access to resources or privileges that enable them to eventually gain access + // and the ability to execute arbitrary code or exfiltrate data. + // "LOW" - A low risk vulnerability hampers a security organization's ability + // to detect vulnerabilities or active threats in their deployment. + SignalSeverity string `json:"signalSeverity,omitempty"` // SignalType: Required. Type of signal, for example, // `AVAILABLE_IN_MULTIPLE_ZONES`, `LOGGING_MOST_ERRORS`, etc. // @@ -2819,8 +2984,10 @@ type StorageDatabasecenterPartnerapiV1mainDatabaseResourceId struct { // ResourceType: Required. The type of resource this ID is identifying. Ex // redis.googleapis.com/Instance, redis.googleapis.com/Cluster, // alloydb.googleapis.com/Cluster, alloydb.googleapis.com/Instance, - // spanner.googleapis.com/Instance REQUIRED Please refer - // go/condor-common-datamodel + // spanner.googleapis.com/Instance, spanner.googleapis.com/Database, + // firestore.googleapis.com/Database, sqladmin.googleapis.com/Instance, + // bigtableadmin.googleapis.com/Cluster, bigtableadmin.googleapis.com/Instance + // REQUIRED Please refer go/condor-common-datamodel ResourceType string `json:"resourceType,omitempty"` // UniqueId: Required. A service-local token that distinguishes this resource // from other resources within the same service. @@ -3235,6 +3402,39 @@ func (s StorageDatabasecenterPartnerapiV1mainEntitlement) MarshalJSON() ([]byte, return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// StorageDatabasecenterPartnerapiV1mainInternalResourceMetadata: Metadata for +// individual internal resources in an instance. e.g. spanner instance can have +// multiple databases with unique configuration settings. Similarly bigtable +// can have multiple clusters within same bigtable instance. +type StorageDatabasecenterPartnerapiV1mainInternalResourceMetadata struct { + // BackupConfiguration: Backup configuration for this database + BackupConfiguration *StorageDatabasecenterPartnerapiV1mainBackupConfiguration `json:"backupConfiguration,omitempty"` + // BackupRun: Information about the last backup attempt for this database + BackupRun *StorageDatabasecenterPartnerapiV1mainBackupRun `json:"backupRun,omitempty"` + Product *StorageDatabasecenterProtoCommonProduct `json:"product,omitempty"` + ResourceId *StorageDatabasecenterPartnerapiV1mainDatabaseResourceId `json:"resourceId,omitempty"` + // ResourceName: Required. internal resource name for spanner this will be + // database name + // e.g."spanner.googleapis.com/projects/123/abc/instances/inst1/databases/db1" + ResourceName string `json:"resourceName,omitempty"` + // ForceSendFields is a list of field names (e.g. "BackupConfiguration") 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. "BackupConfiguration") 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 StorageDatabasecenterPartnerapiV1mainInternalResourceMetadata) MarshalJSON() ([]byte, error) { + type NoMethod StorageDatabasecenterPartnerapiV1mainInternalResourceMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // StorageDatabasecenterPartnerapiV1mainMachineConfiguration: // MachineConfiguration describes the configuration of a machine specific to // Database Resource. @@ -3432,6 +3632,8 @@ type StorageDatabasecenterProtoCommonProduct struct { // dialect. // "ENGINE_OTHER" - Other refers to rest of other database engine. This is to // be when engine is known, but it is not present in this enum. + // "ENGINE_FIRESTORE_WITH_NATIVE_MODE" - Firestore with native mode. + // "ENGINE_FIRESTORE_WITH_DATASTORE_MODE" - Firestore with datastore mode. Engine string `json:"engine,omitempty"` // Type: Type of specific database product. It could be CloudSQL, AlloyDB etc.. // @@ -3449,6 +3651,7 @@ type StorageDatabasecenterProtoCommonProduct struct { // "PRODUCT_TYPE_BIGTABLE" - Bigtable product area in GCP // "PRODUCT_TYPE_OTHER" - Other refers to rest of other product type. This is // to be when product type is known, but it is not present in this enum. + // "PRODUCT_TYPE_FIRESTORE" - Firestore product area in GCP. Type string `json:"type,omitempty"` // Version: Version of the underlying database engine. Example values: For // MySQL, it could be "8.0", "5.7" etc.. For Postgres, it could be "14", "15" @@ -3662,6 +3865,8 @@ func (s TimeBasedRetention) MarshalJSON() ([]byte, error) { type TrialMetadata struct { // EndTime: End time of the trial cluster. EndTime string `json:"endTime,omitempty"` + // GraceEndTime: grace end time of the cluster. + GraceEndTime string `json:"graceEndTime,omitempty"` // StartTime: start time of the trial cluster. StartTime string `json:"startTime,omitempty"` // UpgradeTime: Upgrade time of trial cluster to Standard cluster. @@ -3712,6 +3917,41 @@ func (s UpdatePolicy) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// UpgradeClusterResponse: UpgradeClusterResponse contains the response for +// upgrade cluster operation. +type UpgradeClusterResponse struct { + // ClusterUpgradeDetails: Array of upgrade details for the current cluster and + // all the secondary clusters associated with this cluster. + ClusterUpgradeDetails []*ClusterUpgradeDetails `json:"clusterUpgradeDetails,omitempty"` + // Message: A user friendly message summarising the upgrade operation details + // and the next steps for the user if there is any. + Message string `json:"message,omitempty"` + // Status: Status of upgrade operation. + // + // Possible values: + // "STATUS_UNSPECIFIED" - Unspecified status. + // "SUCCESS" - Operation succeeded. + // "FAILED" - Operation failed. + // "PARTIAL_SUCCESS" - Operation partially succeeded. + Status string `json:"status,omitempty"` + // ForceSendFields is a list of field names (e.g. "ClusterUpgradeDetails") 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. "ClusterUpgradeDetails") 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 UpgradeClusterResponse) MarshalJSON() ([]byte, error) { + type NoMethod UpgradeClusterResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // User: Message describing User object. type User struct { // DatabaseRoles: Optional. List of database roles this user has. The database diff --git a/androidpublisher/v3/androidpublisher-api.json b/androidpublisher/v3/androidpublisher-api.json index 84125b463e4..5aedd98ba62 100644 --- a/androidpublisher/v3/androidpublisher-api.json +++ b/androidpublisher/v3/androidpublisher-api.json @@ -4731,7 +4731,7 @@ } } }, - "revision": "20240806", + "revision": "20240814", "rootUrl": "https://androidpublisher.googleapis.com/", "schemas": { "Abi": { @@ -8249,6 +8249,10 @@ "description": "Revocation context of the purchases.subscriptionsv2.revoke API.", "id": "RevocationContext", "properties": { + "fullRefund": { + "$ref": "RevocationContextFullRefund", + "description": "Optional. Used when users should be refunded the full amount of the latest order of the subscription." + }, "proratedRefund": { "$ref": "RevocationContextProratedRefund", "description": "Optional. Used when users should be refunded a prorated amount they paid for their subscription based on the amount of time remaining in a subscription." @@ -8256,6 +8260,12 @@ }, "type": "object" }, + "RevocationContextFullRefund": { + "description": "Used to determine if the refund type in the RevocationContext is a full refund.", + "id": "RevocationContextFullRefund", + "properties": {}, + "type": "object" + }, "RevocationContextProratedRefund": { "description": "Used to determine if the refund type in the RevocationContext is a prorated refund.", "id": "RevocationContextProratedRefund", diff --git a/androidpublisher/v3/androidpublisher-gen.go b/androidpublisher/v3/androidpublisher-gen.go index 4fce2fefc03..1cd7d46787f 100644 --- a/androidpublisher/v3/androidpublisher-gen.go +++ b/androidpublisher/v3/androidpublisher-gen.go @@ -5351,19 +5351,22 @@ func (s ReviewsReplyResponse) MarshalJSON() ([]byte, error) { // RevocationContext: Revocation context of the // purchases.subscriptionsv2.revoke API. type RevocationContext struct { + // FullRefund: Optional. Used when users should be refunded the full amount of + // the latest order of the subscription. + FullRefund *RevocationContextFullRefund `json:"fullRefund,omitempty"` // ProratedRefund: Optional. Used when users should be refunded a prorated // amount they paid for their subscription based on the amount of time // remaining in a subscription. ProratedRefund *RevocationContextProratedRefund `json:"proratedRefund,omitempty"` - // ForceSendFields is a list of field names (e.g. "ProratedRefund") to + // ForceSendFields is a list of field names (e.g. "FullRefund") 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. "ProratedRefund") 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. "FullRefund") 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:"-"` } @@ -5373,6 +5376,11 @@ func (s RevocationContext) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// RevocationContextFullRefund: Used to determine if the refund type in the +// RevocationContext is a full refund. +type RevocationContextFullRefund struct { +} + // RevocationContextProratedRefund: Used to determine if the refund type in the // RevocationContext is a prorated refund. type RevocationContextProratedRefund struct { diff --git a/apikeys/v2/apikeys-api.json b/apikeys/v2/apikeys-api.json index 15b2ec052dd..5de86b47d30 100644 --- a/apikeys/v2/apikeys-api.json +++ b/apikeys/v2/apikeys-api.json @@ -396,7 +396,7 @@ } } }, - "revision": "20230806", + "revision": "20240811", "rootUrl": "https://apikeys.googleapis.com/", "schemas": { "Operation": { @@ -502,7 +502,7 @@ "type": "array" }, "service": { - "description": "The service for this restriction. It should be the canonical service name, for example: `translate.googleapis.com`. You can use [`gcloud services list`](/sdk/gcloud/reference/services/list) to get a list of services that are enabled in the project.", + "description": "The service for this restriction. It should be the canonical service name, for example: `translate.googleapis.com`. You can use [`gcloud services list`](https://cloud.google.com/sdk/gcloud/reference/services/list) to get a list of services that are enabled in the project.", "type": "string" } }, diff --git a/apikeys/v2/apikeys-gen.go b/apikeys/v2/apikeys-gen.go index a81df1dc0e4..3ce249ebc2f 100644 --- a/apikeys/v2/apikeys-gen.go +++ b/apikeys/v2/apikeys-gen.go @@ -363,8 +363,8 @@ type V2ApiTarget struct { Methods []string `json:"methods,omitempty"` // Service: The service for this restriction. It should be the canonical // service name, for example: `translate.googleapis.com`. You can use `gcloud - // services list` (/sdk/gcloud/reference/services/list) to get a list of - // services that are enabled in the project. + // services list` (https://cloud.google.com/sdk/gcloud/reference/services/list) + // to get a list of services that are enabled in the project. Service string `json:"service,omitempty"` // ForceSendFields is a list of field names (e.g. "Methods") to unconditionally // include in API requests. By default, fields with empty or default values are diff --git a/artifactregistry/v1/artifactregistry-api.json b/artifactregistry/v1/artifactregistry-api.json index 360e8598038..e70205d487e 100644 --- a/artifactregistry/v1/artifactregistry-api.json +++ b/artifactregistry/v1/artifactregistry-api.json @@ -1034,7 +1034,7 @@ ], "parameters": { "filter": { - "description": "An expression for filtering the results of the request. Filter rules are case insensitive. The fields eligible for filtering are: * `name` * `owner` An example of using a filter: * `name=\"projects/p1/locations/us-central1/repositories/repo1/files/a/b/*\"` --\u003e Files with an ID starting with \"a/b/\". * `owner=\"projects/p1/locations/us-central1/repositories/repo1/packages/pkg1/versions/1.0\"` --\u003e Files owned by the version `1.0` in package `pkg1`.", + "description": "An expression for filtering the results of the request. Filter rules are case insensitive. The fields eligible for filtering are: * `name` * `owner` * `annotations` Examples of using a filter: To filter the results of your request to files with the name \"my_file.txt\" in project my-project in the us-central region, in repository my-repo, append the following filter expression to your request: * `name=\"projects/my-project/locations/us-central1/repositories/my-repo/files/my-file.txt\"` You can also use wildcards to match any number of characters before or after the value: * `name=\"projects/my-project/locations/us-central1/repositories/my-repo/files/my-*\"` * `name=\"projects/my-project/locations/us-central1/repositories/my-repo/files/*file.txt\"` * `name=\"projects/my-project/locations/us-central1/repositories/my-repo/files/*file*\"` To filter the results of your request to files owned by the version `1.0` in package `pkg1`, append the following filter expression to your request: * `owner=\"projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/versions/1.0\"` To filter the results of your request to files with the annotation key-value pair [`external_link`:`external_link_value`], append the following filter expression to your request: * \"annotations.external_link:external_link_value\" To filter just for a specific annotation key `external_link`, append the following filter expression to your request: * \"annotations.external_link\" If the annotation key or value contains special characters, you can escape them by surrounding the value with backticks. For example, to filter the results of your request to files with the annotation key-value pair [`external.link`:`https://example.com/my-file`], append the following filter expression to your request: * \"annotations.`external.link`:`https://example.com/my-file`\" You can also filter with annotations with a wildcard to match any number of characters before or after the value: * \"annotations.*_link:`*example.com*`\"", "location": "query", "type": "string" }, @@ -1637,7 +1637,7 @@ ], "parameters": { "filter": { - "description": "An expression for filtering the results of the request. Filter rules are case insensitive. The fields eligible for filtering are: * `version` An example of using a filter: * `version=\"projects/p1/locations/us-central1/repositories/repo1/packages/pkg1/versions/1.0\"` --\u003e Tags that are applied to the version `1.0` in package `pkg1`.", + "description": "An expression for filtering the results of the request. Filter rules are case insensitive. The fields eligible for filtering are: * `name` * `version` Examples of using a filter: To filter the results of your request to tags with the name \"my-tag\" in package \"my-package\" in repository \"my-repo\" in project \"my-project\" in the us-central region, append the following filter expression to your request: * `name=\"projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/tags/my-tag\"` You can also use wildcards to match any number of characters before or after the value: * `name=\"projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/tags/my*\"` * `name=\"projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/tags/*tag\"` * `name=\"projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/tags/*tag*\"` To filter the results of your request to tags applied to the version `1.0` in package `my-package`, append the following filter expression to your request: * `version=\"projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/versions/1.0\"`", "location": "query", "type": "string" }, @@ -2013,7 +2013,7 @@ } } }, - "revision": "20240724", + "revision": "20240809", "rootUrl": "https://artifactregistry.googleapis.com/", "schemas": { "AptArtifact": { diff --git a/artifactregistry/v1/artifactregistry-gen.go b/artifactregistry/v1/artifactregistry-gen.go index aa257792729..9ec8ffd9bfd 100644 --- a/artifactregistry/v1/artifactregistry-gen.go +++ b/artifactregistry/v1/artifactregistry-gen.go @@ -5824,11 +5824,36 @@ func (r *ProjectsLocationsRepositoriesFilesService) List(parent string) *Project // Filter sets the optional parameter "filter": An expression for filtering the // results of the request. Filter rules are case insensitive. The fields -// eligible for filtering are: * `name` * `owner` An example of using a filter: -// * `name="projects/p1/locations/us-central1/repositories/repo1/files/a/b/*" -// --> Files with an ID starting with "a/b/". * -// `owner="projects/p1/locations/us-central1/repositories/repo1/packages/pkg1/ve -// rsions/1.0" --> Files owned by the version `1.0` in package `pkg1`. +// eligible for filtering are: * `name` * `owner` * `annotations` Examples of +// using a filter: To filter the results of your request to files with the name +// "my_file.txt" in project my-project in the us-central region, in repository +// my-repo, append the following filter expression to your request: * +// `name="projects/my-project/locations/us-central1/repositories/my-repo/files/m +// y-file.txt" You can also use wildcards to match any number of characters +// before or after the value: * +// `name="projects/my-project/locations/us-central1/repositories/my-repo/files/m +// y-*" * +// `name="projects/my-project/locations/us-central1/repositories/my-repo/files/* +// file.txt" * +// `name="projects/my-project/locations/us-central1/repositories/my-repo/files/* +// file*" To filter the results of your request to files owned by the version +// `1.0` in package `pkg1`, append the following filter expression to your +// request: * +// `owner="projects/my-project/locations/us-central1/repositories/my-repo/packag +// es/my-package/versions/1.0" To filter the results of your request to files +// with the annotation key-value pair [`external_link`:`external_link_value`], +// append the following filter expression to your request: * +// "annotations.external_link:external_link_value" To filter just for a +// specific annotation key `external_link`, append the following filter +// expression to your request: * "annotations.external_link" If the annotation +// key or value contains special characters, you can escape them by surrounding +// the value with backticks. For example, to filter the results of your request +// to files with the annotation key-value pair +// [`external.link`:`https://example.com/my-file`], append the following filter +// expression to your request: * +// "annotations.`external.link`:`https://example.com/my-file" You can also +// filter with annotations with a wildcard to match any number of characters +// before or after the value: * "annotations.*_link:`*example.com*" func (c *ProjectsLocationsRepositoriesFilesListCall) Filter(filter string) *ProjectsLocationsRepositoriesFilesListCall { c.urlParams_.Set("filter", filter) return c @@ -8052,10 +8077,23 @@ func (r *ProjectsLocationsRepositoriesPackagesTagsService) List(parent string) * // Filter sets the optional parameter "filter": An expression for filtering the // results of the request. Filter rules are case insensitive. The fields -// eligible for filtering are: * `version` An example of using a filter: * -// `version="projects/p1/locations/us-central1/repositories/repo1/packages/pkg1/ -// versions/1.0" --> Tags that are applied to the version `1.0` in package -// `pkg1`. +// eligible for filtering are: * `name` * `version` Examples of using a filter: +// To filter the results of your request to tags with the name "my-tag" in +// package "my-package" in repository "my-repo" in project "my-project" in the +// us-central region, append the following filter expression to your request: * +// `name="projects/my-project/locations/us-central1/repositories/my-repo/package +// s/my-package/tags/my-tag" You can also use wildcards to match any number of +// characters before or after the value: * +// `name="projects/my-project/locations/us-central1/repositories/my-repo/package +// s/my-package/tags/my*" * +// `name="projects/my-project/locations/us-central1/repositories/my-repo/package +// s/my-package/tags/*tag" * +// `name="projects/my-project/locations/us-central1/repositories/my-repo/package +// s/my-package/tags/*tag*" To filter the results of your request to tags +// applied to the version `1.0` in package `my-package`, append the following +// filter expression to your request: * +// `version="projects/my-project/locations/us-central1/repositories/my-repo/pack +// ages/my-package/versions/1.0" func (c *ProjectsLocationsRepositoriesPackagesTagsListCall) Filter(filter string) *ProjectsLocationsRepositoriesPackagesTagsListCall { c.urlParams_.Set("filter", filter) return c diff --git a/artifactregistry/v1beta1/artifactregistry-api.json b/artifactregistry/v1beta1/artifactregistry-api.json index 0045ba8eee0..40a97ff4078 100644 --- a/artifactregistry/v1beta1/artifactregistry-api.json +++ b/artifactregistry/v1beta1/artifactregistry-api.json @@ -715,7 +715,7 @@ ], "parameters": { "filter": { - "description": "An expression for filtering the results of the request. Filter rules are case insensitive. The fields eligible for filtering are: * `name` * `owner` An example of using a filter: * `name=\"projects/p1/locations/us-central1/repositories/repo1/files/a/b/*\"` --\u003e Files with an ID starting with \"a/b/\". * `owner=\"projects/p1/locations/us-central1/repositories/repo1/packages/pkg1/versions/1.0\"` --\u003e Files owned by the version `1.0` in package `pkg1`.", + "description": "An expression for filtering the results of the request. Filter rules are case insensitive. The fields eligible for filtering are: * `name` * `owner` * `annotations` Examples of using a filter: To filter the results of your request to files with the name \"my_file.txt\" in project my-project in the us-central region, in repository my-repo, append the following filter expression to your request: * `name=\"projects/my-project/locations/us-central1/repositories/my-repo/files/my-file.txt\"` You can also use wildcards to match any number of characters before or after the value: * `name=\"projects/my-project/locations/us-central1/repositories/my-repo/files/my-*\"` * `name=\"projects/my-project/locations/us-central1/repositories/my-repo/files/*file.txt\"` * `name=\"projects/my-project/locations/us-central1/repositories/my-repo/files/*file*\"` To filter the results of your request to files owned by the version `1.0` in package `pkg1`, append the following filter expression to your request: * `owner=\"projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/versions/1.0\"` To filter the results of your request to files with the annotation key-value pair [`external_link`:`external_link_value`], append the following filter expression to your request: * \"annotations.external_link:external_link_value\" To filter just for a specific annotation key `external_link`, append the following filter expression to your request: * \"annotations.external_link\" If the annotation key or value contains special characters, you can escape them by surrounding the value with backticks. For example, to filter the results of your request to files with the annotation key-value pair [`external.link`:`https://example.com/my-file`], append the following filter expression to your request: * \"annotations.`external.link`:`https://example.com/my-file`\" You can also filter with annotations with a wildcard to match any number of characters before or after the value: * \"annotations.*_link:`*example.com*`\"", "location": "query", "type": "string" }, @@ -937,7 +937,7 @@ ], "parameters": { "filter": { - "description": "An expression for filtering the results of the request. Filter rules are case insensitive. The fields eligible for filtering are: * `version` An example of using a filter: * `version=\"projects/p1/locations/us-central1/repositories/repo1/packages/pkg1/versions/1.0\"` --\u003e Tags that are applied to the version `1.0` in package `pkg1`.", + "description": "An expression for filtering the results of the request. Filter rules are case insensitive. The fields eligible for filtering are: * `name` * `version` Examples of using a filter: To filter the results of your request to tags with the name \"my-tag\" in package \"my-package\" in repository \"my-repo\" in project \"my-project\" in the us-central region, append the following filter expression to your request: * `name=\"projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/tags/my-tag\"` You can also use wildcards to match any number of characters before or after the value: * `name=\"projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/tags/my*\"` * `name=\"projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/tags/*tag\"` * `name=\"projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/tags/*tag*\"` To filter the results of your request to tags applied to the version `1.0` in package `my-package`, append the following filter expression to your request: * `version=\"projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/versions/1.0\"`", "location": "query", "type": "string" }, @@ -1146,7 +1146,7 @@ } } }, - "revision": "20240724", + "revision": "20240809", "rootUrl": "https://artifactregistry.googleapis.com/", "schemas": { "Binding": { diff --git a/artifactregistry/v1beta1/artifactregistry-gen.go b/artifactregistry/v1beta1/artifactregistry-gen.go index 1c92fcf4974..b9bc37d1242 100644 --- a/artifactregistry/v1beta1/artifactregistry-gen.go +++ b/artifactregistry/v1beta1/artifactregistry-gen.go @@ -2508,11 +2508,36 @@ func (r *ProjectsLocationsRepositoriesFilesService) List(parent string) *Project // Filter sets the optional parameter "filter": An expression for filtering the // results of the request. Filter rules are case insensitive. The fields -// eligible for filtering are: * `name` * `owner` An example of using a filter: -// * `name="projects/p1/locations/us-central1/repositories/repo1/files/a/b/*" -// --> Files with an ID starting with "a/b/". * -// `owner="projects/p1/locations/us-central1/repositories/repo1/packages/pkg1/ve -// rsions/1.0" --> Files owned by the version `1.0` in package `pkg1`. +// eligible for filtering are: * `name` * `owner` * `annotations` Examples of +// using a filter: To filter the results of your request to files with the name +// "my_file.txt" in project my-project in the us-central region, in repository +// my-repo, append the following filter expression to your request: * +// `name="projects/my-project/locations/us-central1/repositories/my-repo/files/m +// y-file.txt" You can also use wildcards to match any number of characters +// before or after the value: * +// `name="projects/my-project/locations/us-central1/repositories/my-repo/files/m +// y-*" * +// `name="projects/my-project/locations/us-central1/repositories/my-repo/files/* +// file.txt" * +// `name="projects/my-project/locations/us-central1/repositories/my-repo/files/* +// file*" To filter the results of your request to files owned by the version +// `1.0` in package `pkg1`, append the following filter expression to your +// request: * +// `owner="projects/my-project/locations/us-central1/repositories/my-repo/packag +// es/my-package/versions/1.0" To filter the results of your request to files +// with the annotation key-value pair [`external_link`:`external_link_value`], +// append the following filter expression to your request: * +// "annotations.external_link:external_link_value" To filter just for a +// specific annotation key `external_link`, append the following filter +// expression to your request: * "annotations.external_link" If the annotation +// key or value contains special characters, you can escape them by surrounding +// the value with backticks. For example, to filter the results of your request +// to files with the annotation key-value pair +// [`external.link`:`https://example.com/my-file`], append the following filter +// expression to your request: * +// "annotations.`external.link`:`https://example.com/my-file" You can also +// filter with annotations with a wildcard to match any number of characters +// before or after the value: * "annotations.*_link:`*example.com*" func (c *ProjectsLocationsRepositoriesFilesListCall) Filter(filter string) *ProjectsLocationsRepositoriesFilesListCall { c.urlParams_.Set("filter", filter) return c @@ -3321,10 +3346,23 @@ func (r *ProjectsLocationsRepositoriesPackagesTagsService) List(parent string) * // Filter sets the optional parameter "filter": An expression for filtering the // results of the request. Filter rules are case insensitive. The fields -// eligible for filtering are: * `version` An example of using a filter: * -// `version="projects/p1/locations/us-central1/repositories/repo1/packages/pkg1/ -// versions/1.0" --> Tags that are applied to the version `1.0` in package -// `pkg1`. +// eligible for filtering are: * `name` * `version` Examples of using a filter: +// To filter the results of your request to tags with the name "my-tag" in +// package "my-package" in repository "my-repo" in project "my-project" in the +// us-central region, append the following filter expression to your request: * +// `name="projects/my-project/locations/us-central1/repositories/my-repo/package +// s/my-package/tags/my-tag" You can also use wildcards to match any number of +// characters before or after the value: * +// `name="projects/my-project/locations/us-central1/repositories/my-repo/package +// s/my-package/tags/my*" * +// `name="projects/my-project/locations/us-central1/repositories/my-repo/package +// s/my-package/tags/*tag" * +// `name="projects/my-project/locations/us-central1/repositories/my-repo/package +// s/my-package/tags/*tag*" To filter the results of your request to tags +// applied to the version `1.0` in package `my-package`, append the following +// filter expression to your request: * +// `version="projects/my-project/locations/us-central1/repositories/my-repo/pack +// ages/my-package/versions/1.0" func (c *ProjectsLocationsRepositoriesPackagesTagsListCall) Filter(filter string) *ProjectsLocationsRepositoriesPackagesTagsListCall { c.urlParams_.Set("filter", filter) return c diff --git a/artifactregistry/v1beta2/artifactregistry-api.json b/artifactregistry/v1beta2/artifactregistry-api.json index 504abc748cd..90aa199ab9b 100644 --- a/artifactregistry/v1beta2/artifactregistry-api.json +++ b/artifactregistry/v1beta2/artifactregistry-api.json @@ -877,7 +877,7 @@ ], "parameters": { "filter": { - "description": "An expression for filtering the results of the request. Filter rules are case insensitive. The fields eligible for filtering are: * `name` * `owner` An example of using a filter: * `name=\"projects/p1/locations/us-central1/repositories/repo1/files/a/b/*\"` --\u003e Files with an ID starting with \"a/b/\". * `owner=\"projects/p1/locations/us-central1/repositories/repo1/packages/pkg1/versions/1.0\"` --\u003e Files owned by the version `1.0` in package `pkg1`.", + "description": "An expression for filtering the results of the request. Filter rules are case insensitive. The fields eligible for filtering are: * `name` * `owner` * `annotations` Examples of using a filter: To filter the results of your request to files with the name \"my_file.txt\" in project my-project in the us-central region, in repository my-repo, append the following filter expression to your request: * `name=\"projects/my-project/locations/us-central1/repositories/my-repo/files/my-file.txt\"` You can also use wildcards to match any number of characters before or after the value: * `name=\"projects/my-project/locations/us-central1/repositories/my-repo/files/my-*\"` * `name=\"projects/my-project/locations/us-central1/repositories/my-repo/files/*file.txt\"` * `name=\"projects/my-project/locations/us-central1/repositories/my-repo/files/*file*\"` To filter the results of your request to files owned by the version `1.0` in package `pkg1`, append the following filter expression to your request: * `owner=\"projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/versions/1.0\"` To filter the results of your request to files with the annotation key-value pair [`external_link`:`external_link_value`], append the following filter expression to your request: * \"annotations.external_link:external_link_value\" To filter just for a specific annotation key `external_link`, append the following filter expression to your request: * \"annotations.external_link\" If the annotation key or value contains special characters, you can escape them by surrounding the value with backticks. For example, to filter the results of your request to files with the annotation key-value pair [`external.link`:`https://example.com/my-file`], append the following filter expression to your request: * \"annotations.`external.link`:`https://example.com/my-file`\" You can also filter with annotations with a wildcard to match any number of characters before or after the value: * \"annotations.*_link:`*example.com*`\"", "location": "query", "type": "string" }, @@ -1133,7 +1133,7 @@ ], "parameters": { "filter": { - "description": "An expression for filtering the results of the request. Filter rules are case insensitive. The fields eligible for filtering are: * `version` An example of using a filter: * `version=\"projects/p1/locations/us-central1/repositories/repo1/packages/pkg1/versions/1.0\"` --\u003e Tags that are applied to the version `1.0` in package `pkg1`.", + "description": "An expression for filtering the results of the request. Filter rules are case insensitive. The fields eligible for filtering are: * `name` * `version` Examples of using a filter: To filter the results of your request to tags with the name \"my-tag\" in package \"my-package\" in repository \"my-repo\" in project \"my-project\" in the us-central region, append the following filter expression to your request: * `name=\"projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/tags/my-tag\"` You can also use wildcards to match any number of characters before or after the value: * `name=\"projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/tags/my*\"` * `name=\"projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/tags/*tag\"` * `name=\"projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/tags/*tag*\"` To filter the results of your request to tags applied to the version `1.0` in package `my-package`, append the following filter expression to your request: * `version=\"projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/versions/1.0\"`", "location": "query", "type": "string" }, @@ -1414,7 +1414,7 @@ } } }, - "revision": "20240724", + "revision": "20240809", "rootUrl": "https://artifactregistry.googleapis.com/", "schemas": { "AptArtifact": { diff --git a/artifactregistry/v1beta2/artifactregistry-gen.go b/artifactregistry/v1beta2/artifactregistry-gen.go index e1081339043..5505020b7ad 100644 --- a/artifactregistry/v1beta2/artifactregistry-gen.go +++ b/artifactregistry/v1beta2/artifactregistry-gen.go @@ -3644,11 +3644,36 @@ func (r *ProjectsLocationsRepositoriesFilesService) List(parent string) *Project // Filter sets the optional parameter "filter": An expression for filtering the // results of the request. Filter rules are case insensitive. The fields -// eligible for filtering are: * `name` * `owner` An example of using a filter: -// * `name="projects/p1/locations/us-central1/repositories/repo1/files/a/b/*" -// --> Files with an ID starting with "a/b/". * -// `owner="projects/p1/locations/us-central1/repositories/repo1/packages/pkg1/ve -// rsions/1.0" --> Files owned by the version `1.0` in package `pkg1`. +// eligible for filtering are: * `name` * `owner` * `annotations` Examples of +// using a filter: To filter the results of your request to files with the name +// "my_file.txt" in project my-project in the us-central region, in repository +// my-repo, append the following filter expression to your request: * +// `name="projects/my-project/locations/us-central1/repositories/my-repo/files/m +// y-file.txt" You can also use wildcards to match any number of characters +// before or after the value: * +// `name="projects/my-project/locations/us-central1/repositories/my-repo/files/m +// y-*" * +// `name="projects/my-project/locations/us-central1/repositories/my-repo/files/* +// file.txt" * +// `name="projects/my-project/locations/us-central1/repositories/my-repo/files/* +// file*" To filter the results of your request to files owned by the version +// `1.0` in package `pkg1`, append the following filter expression to your +// request: * +// `owner="projects/my-project/locations/us-central1/repositories/my-repo/packag +// es/my-package/versions/1.0" To filter the results of your request to files +// with the annotation key-value pair [`external_link`:`external_link_value`], +// append the following filter expression to your request: * +// "annotations.external_link:external_link_value" To filter just for a +// specific annotation key `external_link`, append the following filter +// expression to your request: * "annotations.external_link" If the annotation +// key or value contains special characters, you can escape them by surrounding +// the value with backticks. For example, to filter the results of your request +// to files with the annotation key-value pair +// [`external.link`:`https://example.com/my-file`], append the following filter +// expression to your request: * +// "annotations.`external.link`:`https://example.com/my-file" You can also +// filter with annotations with a wildcard to match any number of characters +// before or after the value: * "annotations.*_link:`*example.com*" func (c *ProjectsLocationsRepositoriesFilesListCall) Filter(filter string) *ProjectsLocationsRepositoriesFilesListCall { c.urlParams_.Set("filter", filter) return c @@ -4568,10 +4593,23 @@ func (r *ProjectsLocationsRepositoriesPackagesTagsService) List(parent string) * // Filter sets the optional parameter "filter": An expression for filtering the // results of the request. Filter rules are case insensitive. The fields -// eligible for filtering are: * `version` An example of using a filter: * -// `version="projects/p1/locations/us-central1/repositories/repo1/packages/pkg1/ -// versions/1.0" --> Tags that are applied to the version `1.0` in package -// `pkg1`. +// eligible for filtering are: * `name` * `version` Examples of using a filter: +// To filter the results of your request to tags with the name "my-tag" in +// package "my-package" in repository "my-repo" in project "my-project" in the +// us-central region, append the following filter expression to your request: * +// `name="projects/my-project/locations/us-central1/repositories/my-repo/package +// s/my-package/tags/my-tag" You can also use wildcards to match any number of +// characters before or after the value: * +// `name="projects/my-project/locations/us-central1/repositories/my-repo/package +// s/my-package/tags/my*" * +// `name="projects/my-project/locations/us-central1/repositories/my-repo/package +// s/my-package/tags/*tag" * +// `name="projects/my-project/locations/us-central1/repositories/my-repo/package +// s/my-package/tags/*tag*" To filter the results of your request to tags +// applied to the version `1.0` in package `my-package`, append the following +// filter expression to your request: * +// `version="projects/my-project/locations/us-central1/repositories/my-repo/pack +// ages/my-package/versions/1.0" func (c *ProjectsLocationsRepositoriesPackagesTagsListCall) Filter(filter string) *ProjectsLocationsRepositoriesPackagesTagsListCall { c.urlParams_.Set("filter", filter) return c diff --git a/backupdr/v1/backupdr-api.json b/backupdr/v1/backupdr-api.json index fc1f9421ed2..5a36e98b61f 100644 --- a/backupdr/v1/backupdr-api.json +++ b/backupdr/v1/backupdr-api.json @@ -1598,7 +1598,7 @@ } } }, - "revision": "20240731", + "revision": "20240808", "rootUrl": "https://backupdr.googleapis.com/", "schemas": { "AbandonBackupRequest": { @@ -2433,17 +2433,6 @@ "format": "int32", "type": "integer" }, - "backupVault": { - "deprecated": true, - "description": "Optional. TODO b/341576760: Remove deprecated BV and Datasource field form BP and BPA once UI removed all dependencies on them Required. Resource name of backup vault which will be used as storage location for backups. Format: projects/{project}/locations/{location}/backupVaults/{backupvault}", - "type": "string" - }, - "backupVaultServiceAccount": { - "deprecated": true, - "description": "Output only. TODO b/341576760: Remove deprecated BV and Datasource field form BP and BPA once UI removed all dependencies on them Output only. The Google Cloud Platform Service Account to be used by the BackupVault for taking backups. Specify the email address of the Backup Vault Service Account.", - "readOnly": true, - "type": "string" - }, "ruleId": { "description": "Required. Immutable. The unique id of this `BackupRule`. The `rule_id` is unique per `BackupPlan`.The `rule_id` must start with a lowercase letter followed by up to 62 lowercase letters, numbers, or hyphens. Pattern, /a-z{,62}/.", "type": "string" @@ -4392,12 +4381,6 @@ "description": "Message for rules config info.", "id": "RuleConfigInfo", "properties": { - "dataSource": { - "deprecated": true, - "description": "Output only. TODO b/341576760: Remove deprecated BV and Datasource field form BP and BPA once UI removed all dependencies on them Output Only. Resource name of data source which will be used as storage location for backups taken by specified rule. Format : projects/{project}/locations/{location}/backupVaults/{backupvault}/dataSources/{datasource}", - "readOnly": true, - "type": "string" - }, "lastBackupError": { "$ref": "Status", "description": "Output only. Output Only. google.rpc.Status object to store the last backup error.", diff --git a/backupdr/v1/backupdr-gen.go b/backupdr/v1/backupdr-gen.go index 98b367901fc..3a1d57c3c80 100644 --- a/backupdr/v1/backupdr-gen.go +++ b/backupdr/v1/backupdr-gen.go @@ -1078,18 +1078,6 @@ type BackupRule struct { // will be kept. It is defined in “days”. The value should be greater than // or equal to minimum enforced retention of the backup vault. BackupRetentionDays int64 `json:"backupRetentionDays,omitempty"` - // BackupVault: Optional. TODO b/341576760: Remove deprecated BV and Datasource - // field form BP and BPA once UI removed all dependencies on them Required. - // Resource name of backup vault which will be used as storage location for - // backups. Format: - // projects/{project}/locations/{location}/backupVaults/{backupvault} - BackupVault string `json:"backupVault,omitempty"` - // BackupVaultServiceAccount: Output only. TODO b/341576760: Remove deprecated - // BV and Datasource field form BP and BPA once UI removed all dependencies on - // them Output only. The Google Cloud Platform Service Account to be used by - // the BackupVault for taking backups. Specify the email address of the Backup - // Vault Service Account. - BackupVaultServiceAccount string `json:"backupVaultServiceAccount,omitempty"` // RuleId: Required. Immutable. The unique id of this `BackupRule`. The // `rule_id` is unique per `BackupPlan`.The `rule_id` must start with a // lowercase letter followed by up to 62 lowercase letters, numbers, or @@ -3440,13 +3428,6 @@ func (s RestoreBackupRequest) MarshalJSON() ([]byte, error) { // RuleConfigInfo: Message for rules config info. type RuleConfigInfo struct { - // DataSource: Output only. TODO b/341576760: Remove deprecated BV and - // Datasource field form BP and BPA once UI removed all dependencies on them - // Output Only. Resource name of data source which will be used as storage - // location for backups taken by specified rule. Format : - // projects/{project}/locations/{location}/backupVaults/{backupvault}/dataSource - // s/{datasource} - DataSource string `json:"dataSource,omitempty"` // LastBackupError: Output only. Output Only. google.rpc.Status object to store // the last backup error. LastBackupError *Status `json:"lastBackupError,omitempty"` @@ -3465,15 +3446,15 @@ type RuleConfigInfo struct { LastSuccessfulBackupConsistencyTime string `json:"lastSuccessfulBackupConsistencyTime,omitempty"` // RuleId: Output only. Output Only. Backup Rule id fetched from backup plan. RuleId string `json:"ruleId,omitempty"` - // ForceSendFields is a list of field names (e.g. "DataSource") to + // ForceSendFields is a list of field names (e.g. "LastBackupError") 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. "DataSource") 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. "LastBackupError") 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:"-"` } diff --git a/beyondcorp/v1alpha/beyondcorp-api.json b/beyondcorp/v1alpha/beyondcorp-api.json index 29939fb380c..ff5c4dfc69e 100644 --- a/beyondcorp/v1alpha/beyondcorp-api.json +++ b/beyondcorp/v1alpha/beyondcorp-api.json @@ -1264,7 +1264,10 @@ "path": "v1alpha/{+name}:cancel", "response": { "$ref": "GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaCancelSubscriptionResponse" - } + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] }, "create": { "description": "Creates a new BeyondCorp Enterprise Subscription in a given organization. Location will always be global as BeyondCorp subscriptions are per organization.", @@ -1289,7 +1292,10 @@ }, "response": { "$ref": "GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaSubscription" - } + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] }, "get": { "description": "Gets details of a single Subscription.", @@ -1311,7 +1317,10 @@ "path": "v1alpha/{+name}", "response": { "$ref": "GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaSubscription" - } + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] }, "list": { "description": "Lists Subscriptions in a given organization and location.", @@ -1344,7 +1353,10 @@ "path": "v1alpha/{+parent}/subscriptions", "response": { "$ref": "GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaListSubscriptionsResponse" - } + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] }, "patch": { "description": "Updates an existing BeyondCorp Enterprise Subscription in a given organization. Location will always be global as BeyondCorp subscriptions are per organization.", @@ -1380,7 +1392,10 @@ }, "response": { "$ref": "GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaSubscription" - } + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] }, "restart": { "description": "Restarts an existing BeyondCorp Enterprise Subscription in a given organization, that is scheduled for cancellation. Location will always be global as BeyondCorp subscriptions are per organization. Returns the timestamp for when the cancellation will become effective", @@ -1407,7 +1422,10 @@ "path": "v1alpha/{+name}:restart", "response": { "$ref": "GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaRestartSubscriptionResponse" - } + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } } @@ -3462,6 +3480,232 @@ } } }, + "global": { + "resources": { + "securityGateways": { + "resources": { + "applications": { + "methods": { + "create": { + "description": "Creates a new Application in a given project and location.", + "flatPath": "v1alpha/projects/{projectsId}/locations/global/securityGateways/{securityGatewaysId}/applications", + "httpMethod": "POST", + "id": "beyondcorp.projects.locations.global.securityGateways.applications.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "applicationId": { + "description": "Optional. User-settable Hub resource ID. * Must start with a letter. * Must contain between 4-63 characters from `/a-z-/`. * Must end with a number or letter.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The resource name of the parent SecurityGateway using the form: `projects/{project_id}/locations/global/securityGateways/{security_gateway_id}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/global/securityGateways/[^/]+$", + "required": true, + "type": "string" + }, + "requestId": { + "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request.", + "location": "query", + "type": "string" + } + }, + "path": "v1alpha/{+parent}/applications", + "request": { + "$ref": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplication" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Updates the parameters of a single Application.", + "flatPath": "v1alpha/projects/{projectsId}/locations/global/securityGateways/{securityGatewaysId}/applications/{applicationsId}", + "httpMethod": "PATCH", + "id": "beyondcorp.projects.locations.global.securityGateways.applications.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Identifier. Name of the resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/global/securityGateways/[^/]+/applications/[^/]+$", + "required": true, + "type": "string" + }, + "requestId": { + "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request timed out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "updateMask": { + "description": "Required. Mutable fields include: display_name.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "request": { + "$ref": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplication" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + "flatPath": "v1alpha/projects/{projectsId}/locations/global/securityGateways/{securityGatewaysId}/applications/{applicationsId}:testIamPermissions", + "httpMethod": "POST", + "id": "beyondcorp.projects.locations.global.securityGateways.applications.testIamPermissions", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/global/securityGateways/[^/]+/applications/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+resource}:testIamPermissions", + "request": { + "$ref": "GoogleIamV1TestIamPermissionsRequest" + }, + "response": { + "$ref": "GoogleIamV1TestIamPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, + "hubs": { + "methods": { + "create": { + "description": "Creates a new Hub in a given project and location.", + "flatPath": "v1alpha/projects/{projectsId}/locations/global/securityGateways/{securityGatewaysId}/hubs", + "httpMethod": "POST", + "id": "beyondcorp.projects.locations.global.securityGateways.hubs.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "hubId": { + "description": "Optional. User-settable Hub resource ID. * Must start with a letter. * Must contain between 4-63 characters from `/a-z-/`. * Must end with a number or letter.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The resource name of the parent SecurityGateway using the form: `projects/{project_id}/locations/global/securityGateways/{security_gateway_id}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/global/securityGateways/[^/]+$", + "required": true, + "type": "string" + }, + "requestId": { + "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request.", + "location": "query", + "type": "string" + } + }, + "path": "v1alpha/{+parent}/hubs", + "request": { + "$ref": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaHub" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Updates the parameters of a single Hub.", + "flatPath": "v1alpha/projects/{projectsId}/locations/global/securityGateways/{securityGatewaysId}/hubs/{hubsId}", + "httpMethod": "PATCH", + "id": "beyondcorp.projects.locations.global.securityGateways.hubs.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Identifier. Name of the resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/global/securityGateways/[^/]+/hubs/[^/]+$", + "required": true, + "type": "string" + }, + "requestId": { + "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request timed out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "updateMask": { + "description": "Required. Mutable fields include: display_name.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "request": { + "$ref": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaHub" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + "flatPath": "v1alpha/projects/{projectsId}/locations/global/securityGateways/{securityGatewaysId}/hubs/{hubsId}:testIamPermissions", + "httpMethod": "POST", + "id": "beyondcorp.projects.locations.global.securityGateways.hubs.testIamPermissions", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/global/securityGateways/[^/]+/hubs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+resource}:testIamPermissions", + "request": { + "$ref": "GoogleIamV1TestIamPermissionsRequest" + }, + "response": { + "$ref": "GoogleIamV1TestIamPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + } + } + }, "insights": { "methods": { "configuredInsight": { @@ -4176,52 +4420,274 @@ "https://www.googleapis.com/auth/cloud-platform" ] } - } - } - } - } - } - } - }, - "revision": "20240802", - "rootUrl": "https://beyondcorp.googleapis.com/", - "schemas": { - "AllocatedConnection": { - "description": "Allocated connection of the AppGateway.", - "id": "AllocatedConnection", - "properties": { - "ingressPort": { - "description": "Required. The ingress port of an allocated connection", - "format": "int32", - "type": "integer" - }, - "pscUri": { - "description": "Required. The PSC uri of an allocated connection", - "type": "string" - } - }, - "type": "object" - }, - "AppGateway": { - "description": "A BeyondCorp AppGateway resource represents a BeyondCorp protected AppGateway to a remote application. It creates all the necessary GCP components needed for creating a BeyondCorp protected AppGateway. Multiple connectors can be authorised for a single AppGateway.", - "id": "AppGateway", - "properties": { - "allocatedConnections": { - "description": "Output only. A list of connections allocated for the Gateway", - "items": { - "$ref": "AllocatedConnection" - }, - "readOnly": true, - "type": "array" - }, - "createTime": { - "description": "Output only. Timestamp when the resource was created.", - "format": "google-datetime", - "readOnly": true, - "type": "string" - }, - "displayName": { - "description": "Optional. An arbitrary user-provided name for the AppGateway. Cannot exceed 64 characters.", + }, + "resources": { + "applications": { + "methods": { + "delete": { + "description": "Deletes a single Application.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/securityGateways/{securityGatewaysId}/applications/{applicationsId}", + "httpMethod": "DELETE", + "id": "beyondcorp.projects.locations.securityGateways.applications.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Name of the resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/securityGateways/[^/]+/applications/[^/]+$", + "required": true, + "type": "string" + }, + "requestId": { + "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "validateOnly": { + "description": "Optional. If set, validates request by executing a dry-run which would not alter the resource in any way.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets details of a single Application.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/securityGateways/{securityGatewaysId}/applications/{applicationsId}", + "httpMethod": "GET", + "id": "beyondcorp.projects.locations.securityGateways.applications.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource name of the Application using the form: `projects/{project_id}/locations/global/securityGateway/{security_gateway_id}/applications/{application_id}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/securityGateways/[^/]+/applications/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplication" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists Applications in a given project and location.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/securityGateways/{securityGatewaysId}/applications", + "httpMethod": "GET", + "id": "beyondcorp.projects.locations.securityGateways.applications.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "Optional. A filter specifying constraints of a list operation. All fields in the Hub message are supported. For example, the following query will return the Hub with displayName \"test-application\" For more information, please refer to https://google.aip.dev/160.", + "location": "query", + "type": "string" + }, + "orderBy": { + "description": "Optional. Specifies the ordering of results. See [Sorting order](https://cloud.google.com/apis/design/design_patterns#sorting_order) for more information.", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Optional. The maximum number of items to return. If not specified, a default value of 50 will be used by the service. Regardless of the page_size value, the response may include a partial list and a caller should only rely on response's next_page_token to determine if there are more instances left to be queried.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. The next_page_token value returned from a previous ListHubsRequest, if any.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent location to which the resources belong. `projects/{project_id}/locations/global/securityGateways/{security_gateway_id}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/securityGateways/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+parent}/applications", + "response": { + "$ref": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaListApplicationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, + "hubs": { + "methods": { + "delete": { + "description": "Deletes a single Hub.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/securityGateways/{securityGatewaysId}/hubs/{hubsId}", + "httpMethod": "DELETE", + "id": "beyondcorp.projects.locations.securityGateways.hubs.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Name of the resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/securityGateways/[^/]+/hubs/[^/]+$", + "required": true, + "type": "string" + }, + "requestId": { + "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "validateOnly": { + "description": "Optional. If set, validates request by executing a dry-run which would not alter the resource in any way.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets details of a single Hub.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/securityGateways/{securityGatewaysId}/hubs/{hubsId}", + "httpMethod": "GET", + "id": "beyondcorp.projects.locations.securityGateways.hubs.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource name of the Hub using the form: `projects/{project_id}/locations/global/securityGateway/{security_gateway_id}/hubs/{hub_id}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/securityGateways/[^/]+/hubs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaHub" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists Hubs in a given project and location.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/securityGateways/{securityGatewaysId}/hubs", + "httpMethod": "GET", + "id": "beyondcorp.projects.locations.securityGateways.hubs.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "Optional. A filter specifying constraints of a list operation. All fields in the Hub message are supported. For example, the following query will return the Hub with displayName \"test-hub\" For more information, please refer to https://google.aip.dev/160.", + "location": "query", + "type": "string" + }, + "orderBy": { + "description": "Optional. Specifies the ordering of results. See [Sorting order](https://cloud.google.com/apis/design/design_patterns#sorting_order) for more information.", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Optional. The maximum number of items to return. If not specified, a default value of 50 will be used by the service. Regardless of the page_size value, the response may include a partial list and a caller should only rely on response's next_page_token to determine if there are more instances left to be queried.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. The next_page_token value returned from a previous ListHubsRequest, if any.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent location to which the resources belong. `projects/{project_id}/locations/global/securityGateways/{security_gateway_id}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/securityGateways/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+parent}/hubs", + "response": { + "$ref": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaListHubsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + } + } + } + } + } + }, + "revision": "20240807", + "rootUrl": "https://beyondcorp.googleapis.com/", + "schemas": { + "AllocatedConnection": { + "description": "Allocated connection of the AppGateway.", + "id": "AllocatedConnection", + "properties": { + "ingressPort": { + "description": "Required. The ingress port of an allocated connection", + "format": "int32", + "type": "integer" + }, + "pscUri": { + "description": "Required. The PSC uri of an allocated connection", + "type": "string" + } + }, + "type": "object" + }, + "AppGateway": { + "description": "A BeyondCorp AppGateway resource represents a BeyondCorp protected AppGateway to a remote application. It creates all the necessary GCP components needed for creating a BeyondCorp protected AppGateway. Multiple connectors can be authorised for a single AppGateway.", + "id": "AppGateway", + "properties": { + "allocatedConnections": { + "description": "Output only. A list of connections allocated for the Gateway", + "items": { + "$ref": "AllocatedConnection" + }, + "readOnly": true, + "type": "array" + }, + "createTime": { + "description": "Output only. Timestamp when the resource was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "displayName": { + "description": "Optional. An arbitrary user-provided name for the AppGateway. Cannot exceed 64 characters.", "type": "string" }, "hostType": { @@ -6357,6 +6823,197 @@ }, "type": "object" }, + "GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplication": { + "description": "A Beyondcorp Application resource information.", + "id": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplication", + "properties": { + "applicationMatchFilter": { + "$ref": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplicationMatchFilter", + "description": "Required. Application filter conditions associated with an application." + }, + "createTime": { + "description": "Output only. Timestamp when the resource was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "displayName": { + "description": "Optional. An arbitrary user-provided name for the Route resource. Cannot exceed 64 characters.", + "type": "string" + }, + "name": { + "description": "Identifier. Name of the resource.", + "type": "string" + }, + "updateTime": { + "description": "Output only. Timestamp when the resource was last modified.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplicationMatchFilter": { + "description": "Match Criteria for Application Filtering.", + "id": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplicationMatchFilter", + "properties": { + "matchConditions": { + "description": "Required. Match conditions for AND logic. An array of match conditions to allow for multiple matching criteria. The rule is considered a match if all the conditions are met. The conditions can be one of the following combination (FQDN), (FQDN \u0026 PORTS), (IP_ADDRESS), (IP_ADDRESS \u0026 PORTS) EXAMPLES: FQDN - (\"*.abc.com\"), (\"xyz.abc.com\") FQDN and PORTS - (\"abc.com\" and \"22\"), (\"abc.com\" and \"22,33)\" etc IP_ADDRESS - (\"10.20.30.40\"), (\"100.20.30.40\") IP_ADDRESS and PORTS - (\"10.20.30.40\" and \"4\"), (\"10.20.30.40\" and \"4,5\")", + "items": { + "$ref": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplicationMatchFilterMatchCondition" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplicationMatchFilterMatchCondition": { + "description": "Match condition for idenfying the application.", + "id": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplicationMatchFilterMatchCondition", + "properties": { + "fqdn": { + "description": "Optional. FQDN of the application.", + "type": "string" + }, + "ipAddress": { + "description": "Optional. IP Address of the application.", + "type": "string" + }, + "ports": { + "description": "Optional. Ports of the application.", + "items": { + "format": "int32", + "type": "integer" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudBeyondcorpSecuritygatewaysV1alphaHub": { + "description": "A Beyondcorp Hub resource information.", + "id": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaHub", + "properties": { + "createTime": { + "description": "Output only. Timestamp when the resource was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "displayName": { + "description": "Optional. An arbitrary user-provided name for the Hub. Cannot exceed 64 characters.", + "type": "string" + }, + "name": { + "description": "Identifier. Name of the resource.", + "type": "string" + }, + "natGatewayConfig": { + "$ref": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaHubNatGatewayConfig", + "description": "Required. NAT gateway setup to ensure enough NAT IP addresses are available to handle the traffic needed to access the applications. Allows to explicitly enable or disable the NAT in the Hub along with the total IPs allocated to handle the capacity limits." + }, + "state": { + "description": "Output only. The operational state of the Hub.", + "enum": [ + "STATE_UNSPECIFIED", + "CREATING", + "UPDATING", + "DELETING", + "RUNNING", + "DOWN", + "ERROR" + ], + "enumDescriptions": [ + "Default value. This value is unused.", + "Hub is being created.", + "Hub is being updated.", + "Hub is being deleted.", + "Hub is running.", + "Hub is down and may be restored in the future. This happens when CCFE sends ProjectState = OFF.", + "Hub encountered an error and is in an indeterministic state." + ], + "readOnly": true, + "type": "string" + }, + "updateTime": { + "description": "Output only. Timestamp when the resource was last modified.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudBeyondcorpSecuritygatewaysV1alphaHubNatGatewayConfig": { + "description": "Represents the NAT Gateway configuration.", + "id": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaHubNatGatewayConfig", + "properties": { + "enableNatGateway": { + "description": "Optional. Explicitly enable or disable the NAT Gateway. This is defaulted to false until NAT Gateway configuration is fully supported and any request with a disable option will be rejected.", + "type": "boolean" + }, + "natIps": { + "description": "Output only. List of NAT IPs that will be used for establishing connection to the endpoints.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudBeyondcorpSecuritygatewaysV1alphaListApplicationsResponse": { + "description": "Message for response to listing Applications.", + "id": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaListApplicationsResponse", + "properties": { + "applications": { + "description": "A list of BeyondCorp Application in the project.", + "items": { + "$ref": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplication" + }, + "type": "array" + }, + "nextPageToken": { + "description": "A token to retrieve the next page of results, or empty if there are no more results in the list.", + "type": "string" + }, + "unreachable": { + "description": "A list of locations that could not be reached.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudBeyondcorpSecuritygatewaysV1alphaListHubsResponse": { + "description": "Message for response to listing Hubs.", + "id": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaListHubsResponse", + "properties": { + "hubs": { + "description": "A list of BeyondCorp Hub in the project.", + "items": { + "$ref": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaHub" + }, + "type": "array" + }, + "nextPageToken": { + "description": "A token to retrieve the next page of results, or empty if there are no more results in the list.", + "type": "string" + }, + "unreachable": { + "description": "A list of locations that could not be reached.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudBeyondcorpSecuritygatewaysV1alphaListSecurityGatewaysResponse": { "description": "Message for response to listing SecurityGateways.", "id": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaListSecurityGatewaysResponse", diff --git a/beyondcorp/v1alpha/beyondcorp-gen.go b/beyondcorp/v1alpha/beyondcorp-gen.go index 2e0e2bb95e1..7645358032e 100644 --- a/beyondcorp/v1alpha/beyondcorp-gen.go +++ b/beyondcorp/v1alpha/beyondcorp-gen.go @@ -285,6 +285,7 @@ func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { rs.ClientGateways = NewProjectsLocationsClientGatewaysService(s) rs.Connections = NewProjectsLocationsConnectionsService(s) rs.Connectors = NewProjectsLocationsConnectorsService(s) + rs.Global = NewProjectsLocationsGlobalService(s) rs.Insights = NewProjectsLocationsInsightsService(s) rs.NetConnections = NewProjectsLocationsNetConnectionsService(s) rs.Operations = NewProjectsLocationsOperationsService(s) @@ -313,6 +314,8 @@ type ProjectsLocationsService struct { Connectors *ProjectsLocationsConnectorsService + Global *ProjectsLocationsGlobalService + Insights *ProjectsLocationsInsightsService NetConnections *ProjectsLocationsNetConnectionsService @@ -403,6 +406,51 @@ type ProjectsLocationsConnectorsService struct { s *Service } +func NewProjectsLocationsGlobalService(s *Service) *ProjectsLocationsGlobalService { + rs := &ProjectsLocationsGlobalService{s: s} + rs.SecurityGateways = NewProjectsLocationsGlobalSecurityGatewaysService(s) + return rs +} + +type ProjectsLocationsGlobalService struct { + s *Service + + SecurityGateways *ProjectsLocationsGlobalSecurityGatewaysService +} + +func NewProjectsLocationsGlobalSecurityGatewaysService(s *Service) *ProjectsLocationsGlobalSecurityGatewaysService { + rs := &ProjectsLocationsGlobalSecurityGatewaysService{s: s} + rs.Applications = NewProjectsLocationsGlobalSecurityGatewaysApplicationsService(s) + rs.Hubs = NewProjectsLocationsGlobalSecurityGatewaysHubsService(s) + return rs +} + +type ProjectsLocationsGlobalSecurityGatewaysService struct { + s *Service + + Applications *ProjectsLocationsGlobalSecurityGatewaysApplicationsService + + Hubs *ProjectsLocationsGlobalSecurityGatewaysHubsService +} + +func NewProjectsLocationsGlobalSecurityGatewaysApplicationsService(s *Service) *ProjectsLocationsGlobalSecurityGatewaysApplicationsService { + rs := &ProjectsLocationsGlobalSecurityGatewaysApplicationsService{s: s} + return rs +} + +type ProjectsLocationsGlobalSecurityGatewaysApplicationsService struct { + s *Service +} + +func NewProjectsLocationsGlobalSecurityGatewaysHubsService(s *Service) *ProjectsLocationsGlobalSecurityGatewaysHubsService { + rs := &ProjectsLocationsGlobalSecurityGatewaysHubsService{s: s} + return rs +} + +type ProjectsLocationsGlobalSecurityGatewaysHubsService struct { + s *Service +} + func NewProjectsLocationsInsightsService(s *Service) *ProjectsLocationsInsightsService { rs := &ProjectsLocationsInsightsService{s: s} return rs @@ -432,11 +480,35 @@ type ProjectsLocationsOperationsService struct { func NewProjectsLocationsSecurityGatewaysService(s *Service) *ProjectsLocationsSecurityGatewaysService { rs := &ProjectsLocationsSecurityGatewaysService{s: s} + rs.Applications = NewProjectsLocationsSecurityGatewaysApplicationsService(s) + rs.Hubs = NewProjectsLocationsSecurityGatewaysHubsService(s) return rs } type ProjectsLocationsSecurityGatewaysService struct { s *Service + + Applications *ProjectsLocationsSecurityGatewaysApplicationsService + + Hubs *ProjectsLocationsSecurityGatewaysHubsService +} + +func NewProjectsLocationsSecurityGatewaysApplicationsService(s *Service) *ProjectsLocationsSecurityGatewaysApplicationsService { + rs := &ProjectsLocationsSecurityGatewaysApplicationsService{s: s} + return rs +} + +type ProjectsLocationsSecurityGatewaysApplicationsService struct { + s *Service +} + +func NewProjectsLocationsSecurityGatewaysHubsService(s *Service) *ProjectsLocationsSecurityGatewaysHubsService { + rs := &ProjectsLocationsSecurityGatewaysHubsService{s: s} + return rs +} + +type ProjectsLocationsSecurityGatewaysHubsService struct { + s *Service } // AllocatedConnection: Allocated connection of the AppGateway. @@ -2812,6 +2884,239 @@ func (s GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaSubscription) Marsh return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplication: A Beyondcorp +// Application resource information. +type GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplication struct { + // ApplicationMatchFilter: Required. Application filter conditions associated + // with an application. + ApplicationMatchFilter *GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplicationMatchFilter `json:"applicationMatchFilter,omitempty"` + // CreateTime: Output only. Timestamp when the resource was created. + CreateTime string `json:"createTime,omitempty"` + // DisplayName: Optional. An arbitrary user-provided name for the Route + // resource. Cannot exceed 64 characters. + DisplayName string `json:"displayName,omitempty"` + // Name: Identifier. Name of the resource. + Name string `json:"name,omitempty"` + // UpdateTime: Output only. Timestamp when the resource was last modified. + UpdateTime string `json:"updateTime,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "ApplicationMatchFilter") 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. "ApplicationMatchFilter") 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 GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplication) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplication + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplicationMatchFilter: Match +// Criteria for Application Filtering. +type GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplicationMatchFilter struct { + // MatchConditions: Required. Match conditions for AND logic. An array of match + // conditions to allow for multiple matching criteria. The rule is considered a + // match if all the conditions are met. The conditions can be one of the + // following combination (FQDN), (FQDN & PORTS), (IP_ADDRESS), (IP_ADDRESS & + // PORTS) EXAMPLES: FQDN - ("*.abc.com"), ("xyz.abc.com") FQDN and PORTS - + // ("abc.com" and "22"), ("abc.com" and "22,33)" etc IP_ADDRESS - + // ("10.20.30.40"), ("100.20.30.40") IP_ADDRESS and PORTS - ("10.20.30.40" and + // "4"), ("10.20.30.40" and "4,5") + MatchConditions []*GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplicationMatchFilterMatchCondition `json:"matchConditions,omitempty"` + // ForceSendFields is a list of field names (e.g. "MatchConditions") 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. "MatchConditions") 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 GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplicationMatchFilter) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplicationMatchFilter + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplicationMatchFilterMatchCondit +// ion: Match condition for idenfying the application. +type GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplicationMatchFilterMatchCondition struct { + // Fqdn: Optional. FQDN of the application. + Fqdn string `json:"fqdn,omitempty"` + // IpAddress: Optional. IP Address of the application. + IpAddress string `json:"ipAddress,omitempty"` + // Ports: Optional. Ports of the application. + Ports []int64 `json:"ports,omitempty"` + // ForceSendFields is a list of field names (e.g. "Fqdn") 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. "Fqdn") 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 GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplicationMatchFilterMatchCondition) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplicationMatchFilterMatchCondition + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudBeyondcorpSecuritygatewaysV1alphaHub: A Beyondcorp Hub resource +// information. +type GoogleCloudBeyondcorpSecuritygatewaysV1alphaHub struct { + // CreateTime: Output only. Timestamp when the resource was created. + CreateTime string `json:"createTime,omitempty"` + // DisplayName: Optional. An arbitrary user-provided name for the Hub. Cannot + // exceed 64 characters. + DisplayName string `json:"displayName,omitempty"` + // Name: Identifier. Name of the resource. + Name string `json:"name,omitempty"` + // NatGatewayConfig: Required. NAT gateway setup to ensure enough NAT IP + // addresses are available to handle the traffic needed to access the + // applications. Allows to explicitly enable or disable the NAT in the Hub + // along with the total IPs allocated to handle the capacity limits. + NatGatewayConfig *GoogleCloudBeyondcorpSecuritygatewaysV1alphaHubNatGatewayConfig `json:"natGatewayConfig,omitempty"` + // State: Output only. The operational state of the Hub. + // + // Possible values: + // "STATE_UNSPECIFIED" - Default value. This value is unused. + // "CREATING" - Hub is being created. + // "UPDATING" - Hub is being updated. + // "DELETING" - Hub is being deleted. + // "RUNNING" - Hub is running. + // "DOWN" - Hub is down and may be restored in the future. This happens when + // CCFE sends ProjectState = OFF. + // "ERROR" - Hub encountered an error and is in an indeterministic state. + State string `json:"state,omitempty"` + // UpdateTime: Output only. Timestamp when the resource was last modified. + UpdateTime string `json:"updateTime,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "CreateTime") 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. "CreateTime") 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 GoogleCloudBeyondcorpSecuritygatewaysV1alphaHub) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudBeyondcorpSecuritygatewaysV1alphaHub + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudBeyondcorpSecuritygatewaysV1alphaHubNatGatewayConfig: Represents +// the NAT Gateway configuration. +type GoogleCloudBeyondcorpSecuritygatewaysV1alphaHubNatGatewayConfig struct { + // EnableNatGateway: Optional. Explicitly enable or disable the NAT Gateway. + // This is defaulted to false until NAT Gateway configuration is fully + // supported and any request with a disable option will be rejected. + EnableNatGateway bool `json:"enableNatGateway,omitempty"` + // NatIps: Output only. List of NAT IPs that will be used for establishing + // connection to the endpoints. + NatIps []string `json:"natIps,omitempty"` + // ForceSendFields is a list of field names (e.g. "EnableNatGateway") 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. "EnableNatGateway") 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 GoogleCloudBeyondcorpSecuritygatewaysV1alphaHubNatGatewayConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudBeyondcorpSecuritygatewaysV1alphaHubNatGatewayConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudBeyondcorpSecuritygatewaysV1alphaListApplicationsResponse: +// Message for response to listing Applications. +type GoogleCloudBeyondcorpSecuritygatewaysV1alphaListApplicationsResponse struct { + // Applications: A list of BeyondCorp Application in the project. + Applications []*GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplication `json:"applications,omitempty"` + // NextPageToken: A token to retrieve the next page of results, or empty if + // there are no more results in the list. + NextPageToken string `json:"nextPageToken,omitempty"` + // Unreachable: A list of locations that could not be reached. + Unreachable []string `json:"unreachable,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Applications") 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. "Applications") 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 GoogleCloudBeyondcorpSecuritygatewaysV1alphaListApplicationsResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudBeyondcorpSecuritygatewaysV1alphaListApplicationsResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudBeyondcorpSecuritygatewaysV1alphaListHubsResponse: Message for +// response to listing Hubs. +type GoogleCloudBeyondcorpSecuritygatewaysV1alphaListHubsResponse struct { + // Hubs: A list of BeyondCorp Hub in the project. + Hubs []*GoogleCloudBeyondcorpSecuritygatewaysV1alphaHub `json:"hubs,omitempty"` + // NextPageToken: A token to retrieve the next page of results, or empty if + // there are no more results in the list. + NextPageToken string `json:"nextPageToken,omitempty"` + // Unreachable: A list of locations that could not be reached. + Unreachable []string `json:"unreachable,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Hubs") 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. "Hubs") 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 GoogleCloudBeyondcorpSecuritygatewaysV1alphaListHubsResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudBeyondcorpSecuritygatewaysV1alphaListHubsResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudBeyondcorpSecuritygatewaysV1alphaListSecurityGatewaysResponse: // Message for response to listing SecurityGateways. type GoogleCloudBeyondcorpSecuritygatewaysV1alphaListSecurityGatewaysResponse struct { @@ -16044,183 +16349,97 @@ func (c *ProjectsLocationsConnectorsTestIamPermissionsCall) Do(opts ...googleapi return ret, nil } -type ProjectsLocationsInsightsConfiguredInsightCall struct { - s *Service - insight string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsGlobalSecurityGatewaysApplicationsCreateCall struct { + s *Service + parent string + googlecloudbeyondcorpsecuritygatewaysv1alphaapplication *GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplication + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// ConfiguredInsight: Gets the value for a selected particular insight based on -// the provided filters. Use the organization level path for fetching at org -// level and project level path for fetching the insight value specific to a -// particular project. +// Create: Creates a new Application in a given project and location. // -// - insight: The resource name of the insight using the form: -// `organizations/{organization_id}/locations/{location_id}/insights/{insight_ -// id}` -// `projects/{project_id}/locations/{location_id}/insights/{insight_id}`. -func (r *ProjectsLocationsInsightsService) ConfiguredInsight(insight string) *ProjectsLocationsInsightsConfiguredInsightCall { - c := &ProjectsLocationsInsightsConfiguredInsightCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.insight = insight +// - parent: The resource name of the parent SecurityGateway using the form: +// `projects/{project_id}/locations/global/securityGateways/{security_gateway_ +// id}`. +func (r *ProjectsLocationsGlobalSecurityGatewaysApplicationsService) Create(parent string, googlecloudbeyondcorpsecuritygatewaysv1alphaapplication *GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplication) *ProjectsLocationsGlobalSecurityGatewaysApplicationsCreateCall { + c := &ProjectsLocationsGlobalSecurityGatewaysApplicationsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googlecloudbeyondcorpsecuritygatewaysv1alphaapplication = googlecloudbeyondcorpsecuritygatewaysv1alphaapplication return c } -// Aggregation sets the optional parameter "aggregation": Required. Aggregation -// type. Available aggregation could be fetched by calling insight list and get -// APIs in `BASIC` view. -// -// 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 *ProjectsLocationsInsightsConfiguredInsightCall) Aggregation(aggregation string) *ProjectsLocationsInsightsConfiguredInsightCall { - c.urlParams_.Set("aggregation", aggregation) +// ApplicationId sets the optional parameter "applicationId": User-settable Hub +// resource ID. * Must start with a letter. * Must contain between 4-63 +// characters from `/a-z-/`. * Must end with a number or letter. +func (c *ProjectsLocationsGlobalSecurityGatewaysApplicationsCreateCall) ApplicationId(applicationId string) *ProjectsLocationsGlobalSecurityGatewaysApplicationsCreateCall { + c.urlParams_.Set("applicationId", applicationId) return c } -// CustomGroupingFieldFilter sets the optional parameter -// "customGrouping.fieldFilter": Filterable parameters to be added to the -// grouping clause. Available fields could be fetched by calling insight list -// and get APIs in `BASIC` view. `=` is the only comparison operator supported. -// `AND` is the only logical operator supported. Usage: -// field_filter="fieldName1=fieldVal1 AND fieldName2=fieldVal2". NOTE: Only -// `AND` conditions are allowed. NOTE: Use the `filter_alias` from -// `Insight.Metadata.Field` message for the filtering the corresponding fields -// in this filter field. (These expressions are based on the filter language -// described at https://google.aip.dev/160). -func (c *ProjectsLocationsInsightsConfiguredInsightCall) CustomGroupingFieldFilter(customGroupingFieldFilter string) *ProjectsLocationsInsightsConfiguredInsightCall { - c.urlParams_.Set("customGrouping.fieldFilter", customGroupingFieldFilter) +// RequestId sets the optional parameter "requestId": An optional request ID to +// identify requests. Specify a unique request ID so that if you must retry +// your request, the server will know to ignore request if it has already been +// completed. The server will guarantee that for at least 60 minutes since the +// first request. +func (c *ProjectsLocationsGlobalSecurityGatewaysApplicationsCreateCall) RequestId(requestId string) *ProjectsLocationsGlobalSecurityGatewaysApplicationsCreateCall { + c.urlParams_.Set("requestId", requestId) return c } -// CustomGroupingGroupFields sets the optional parameter -// "customGrouping.groupFields": Required. Fields to be used for grouping. -// NOTE: Use the `filter_alias` from `Insight.Metadata.Field` message for -// declaring the fields to be grouped-by here. -func (c *ProjectsLocationsInsightsConfiguredInsightCall) CustomGroupingGroupFields(customGroupingGroupFields ...string) *ProjectsLocationsInsightsConfiguredInsightCall { - c.urlParams_.SetMulti("customGrouping.groupFields", append([]string{}, customGroupingGroupFields...)) - return c -} - -// EndTime sets the optional parameter "endTime": Required. Ending time for the -// duration for which insight is to be pulled. -func (c *ProjectsLocationsInsightsConfiguredInsightCall) EndTime(endTime string) *ProjectsLocationsInsightsConfiguredInsightCall { - c.urlParams_.Set("endTime", endTime) - return c -} - -// FieldFilter sets the optional parameter "fieldFilter": Other -// filterable/configurable parameters as applicable to the selected insight. -// Available fields could be fetched by calling insight list and get APIs in -// `BASIC` view. `=` is the only comparison operator supported. `AND` is the -// only logical operator supported. Usage: field_filter="fieldName1=fieldVal1 -// AND fieldName2=fieldVal2". NOTE: Only `AND` conditions are allowed. NOTE: -// Use the `filter_alias` from `Insight.Metadata.Field` message for the -// filtering the corresponding fields in this filter field. (These expressions -// are based on the filter language described at https://google.aip.dev/160). -func (c *ProjectsLocationsInsightsConfiguredInsightCall) FieldFilter(fieldFilter string) *ProjectsLocationsInsightsConfiguredInsightCall { - c.urlParams_.Set("fieldFilter", fieldFilter) - return c -} - -// Group sets the optional parameter "group": Group id of the available -// groupings for the insight. Available groupings could be fetched by calling -// insight list and get APIs in `BASIC` view. -func (c *ProjectsLocationsInsightsConfiguredInsightCall) Group(group string) *ProjectsLocationsInsightsConfiguredInsightCall { - c.urlParams_.Set("group", group) - return c -} - -// PageSize sets the optional parameter "pageSize": Requested page size. Server -// may return fewer items than requested. If unspecified, server will pick an -// appropriate default. -func (c *ProjectsLocationsInsightsConfiguredInsightCall) PageSize(pageSize int64) *ProjectsLocationsInsightsConfiguredInsightCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) - return c -} - -// PageToken sets the optional parameter "pageToken": Used to fetch the page -// represented by the token. Fetches the first page when not set. -func (c *ProjectsLocationsInsightsConfiguredInsightCall) PageToken(pageToken string) *ProjectsLocationsInsightsConfiguredInsightCall { - c.urlParams_.Set("pageToken", pageToken) - return c -} - -// StartTime sets the optional parameter "startTime": Required. Starting time -// for the duration for which insight is to be pulled. -func (c *ProjectsLocationsInsightsConfiguredInsightCall) StartTime(startTime string) *ProjectsLocationsInsightsConfiguredInsightCall { - c.urlParams_.Set("startTime", startTime) - 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 *ProjectsLocationsInsightsConfiguredInsightCall) Fields(s ...googleapi.Field) *ProjectsLocationsInsightsConfiguredInsightCall { - 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 *ProjectsLocationsInsightsConfiguredInsightCall) IfNoneMatch(entityTag string) *ProjectsLocationsInsightsConfiguredInsightCall { - c.ifNoneMatch_ = entityTag +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsGlobalSecurityGatewaysApplicationsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsGlobalSecurityGatewaysApplicationsCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsInsightsConfiguredInsightCall) Context(ctx context.Context) *ProjectsLocationsInsightsConfiguredInsightCall { +func (c *ProjectsLocationsGlobalSecurityGatewaysApplicationsCreateCall) Context(ctx context.Context) *ProjectsLocationsGlobalSecurityGatewaysApplicationsCreateCall { 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 *ProjectsLocationsInsightsConfiguredInsightCall) Header() http.Header { +func (c *ProjectsLocationsGlobalSecurityGatewaysApplicationsCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsInsightsConfiguredInsightCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } +func (c *ProjectsLocationsGlobalSecurityGatewaysApplicationsCreateCall) 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.googlecloudbeyondcorpsecuritygatewaysv1alphaapplication) + if err != nil { + return nil, err + } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+insight}:configuredInsight") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+parent}/applications") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, body) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "insight": c.insight, + "parent": c.parent, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "beyondcorp.projects.locations.insights.configuredInsight" call. +// Do executes the "beyondcorp.projects.locations.global.securityGateways.applications.create" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudBeyondcorpSaasplatformInsightsV1alphaConfiguredInsightResponse.Se -// rverResponse.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 *ProjectsLocationsInsightsConfiguredInsightCall) Do(opts ...googleapi.CallOption) (*GoogleCloudBeyondcorpSaasplatformInsightsV1alphaConfiguredInsightResponse, error) { +// *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 *ProjectsLocationsGlobalSecurityGatewaysApplicationsCreateCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -16239,7 +16458,7 @@ func (c *ProjectsLocationsInsightsConfiguredInsightCall) Do(opts ...googleapi.Ca if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudBeyondcorpSaasplatformInsightsV1alphaConfiguredInsightResponse{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -16252,115 +16471,83 @@ func (c *ProjectsLocationsInsightsConfiguredInsightCall) Do(opts ...googleapi.Ca return ret, nil } -// Pages invokes f for each page of results. -// A non-nil error returned from f will halt the iteration. -// The provided context supersedes any context provided to the Context method. -func (c *ProjectsLocationsInsightsConfiguredInsightCall) Pages(ctx context.Context, f func(*GoogleCloudBeyondcorpSaasplatformInsightsV1alphaConfiguredInsightResponse) error) error { - c.ctx_ = ctx - defer c.PageToken(c.urlParams_.Get("pageToken")) - for { - x, err := c.Do() - if err != nil { - return err - } - if err := f(x); err != nil { - return err - } - if x.NextPageToken == "" { - return nil - } - c.PageToken(x.NextPageToken) - } -} - -type ProjectsLocationsInsightsGetCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsGlobalSecurityGatewaysApplicationsPatchCall struct { + s *Service + name string + googlecloudbeyondcorpsecuritygatewaysv1alphaapplication *GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplication + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Get: Gets the value for a selected particular insight with default -// configuration. The default aggregation level is 'DAILY' and no grouping will -// be applied or default grouping if applicable. The data will be returned for -// recent 7 days starting the day before. The insight data size will be limited -// to 50 rows. Use the organization level path for fetching at org level and -// project level path for fetching the insight value specific to a particular -// project. Setting the `view` to `BASIC` will only return the metadata for the -// insight. +// Patch: Updates the parameters of a single Application. // -// - name: The resource name of the insight using the form: -// `organizations/{organization_id}/locations/{location_id}/insights/{insight_ -// id}` `projects/{project_id}/locations/{location_id}/insights/{insight_id}`. -func (r *ProjectsLocationsInsightsService) Get(name string) *ProjectsLocationsInsightsGetCall { - c := &ProjectsLocationsInsightsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: Identifier. Name of the resource. +func (r *ProjectsLocationsGlobalSecurityGatewaysApplicationsService) Patch(name string, googlecloudbeyondcorpsecuritygatewaysv1alphaapplication *GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplication) *ProjectsLocationsGlobalSecurityGatewaysApplicationsPatchCall { + c := &ProjectsLocationsGlobalSecurityGatewaysApplicationsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name + c.googlecloudbeyondcorpsecuritygatewaysv1alphaapplication = googlecloudbeyondcorpsecuritygatewaysv1alphaapplication return c } -// View sets the optional parameter "view": Required. Metadata only or full -// data view. -// -// Possible values: -// -// "INSIGHT_VIEW_UNSPECIFIED" - The default / unset value. The API will -// -// default to the BASIC view. -// -// "BASIC" - Include basic metadata about the insight, but not the insight -// -// data. This is the default value (for both ListInsights and GetInsight). -// -// "FULL" - Include everything. -func (c *ProjectsLocationsInsightsGetCall) View(view string) *ProjectsLocationsInsightsGetCall { - c.urlParams_.Set("view", view) +// RequestId sets the optional parameter "requestId": An optional request ID to +// identify requests. Specify a unique request ID so that if you must retry +// your request, the server will know to ignore the request if it has already +// been completed. The server will guarantee that for at least 60 minutes after +// the first request. For example, consider a situation where you make an +// initial request and the request timed out. If you make the request again +// with the same request ID, the server can check if original operation with +// the same request ID was received, and if so, will ignore the second request. +// This prevents clients from accidentally creating duplicate commitments. The +// request ID must be a valid UUID with the exception that zero UUID is not +// supported (00000000-0000-0000-0000-000000000000). +func (c *ProjectsLocationsGlobalSecurityGatewaysApplicationsPatchCall) RequestId(requestId string) *ProjectsLocationsGlobalSecurityGatewaysApplicationsPatchCall { + c.urlParams_.Set("requestId", requestId) + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. Mutable +// fields include: display_name. +func (c *ProjectsLocationsGlobalSecurityGatewaysApplicationsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsGlobalSecurityGatewaysApplicationsPatchCall { + 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 *ProjectsLocationsInsightsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsInsightsGetCall { +func (c *ProjectsLocationsGlobalSecurityGatewaysApplicationsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsGlobalSecurityGatewaysApplicationsPatchCall { 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 *ProjectsLocationsInsightsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsInsightsGetCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsInsightsGetCall) Context(ctx context.Context) *ProjectsLocationsInsightsGetCall { +func (c *ProjectsLocationsGlobalSecurityGatewaysApplicationsPatchCall) Context(ctx context.Context) *ProjectsLocationsGlobalSecurityGatewaysApplicationsPatchCall { 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 *ProjectsLocationsInsightsGetCall) Header() http.Header { +func (c *ProjectsLocationsGlobalSecurityGatewaysApplicationsPatchCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsInsightsGetCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - if c.ifNoneMatch_ != "" { - reqHeaders.Set("If-None-Match", c.ifNoneMatch_) - } +func (c *ProjectsLocationsGlobalSecurityGatewaysApplicationsPatchCall) 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.googlecloudbeyondcorpsecuritygatewaysv1alphaapplication) + if err != nil { + return nil, err + } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, body) + req, err := http.NewRequest("PATCH", urls, body) if err != nil { return nil, err } @@ -16371,13 +16558,13 @@ func (c *ProjectsLocationsInsightsGetCall) doRequest(alt string) (*http.Response return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "beyondcorp.projects.locations.insights.get" call. +// Do executes the "beyondcorp.projects.locations.global.securityGateways.applications.patch" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsight.ServerResponse.Heade -// r or (if a response was returned at all) in error.(*googleapi.Error).Header. -// Use googleapi.IsNotModified to check whether the returned error was because +// *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 *ProjectsLocationsInsightsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsight, error) { +func (c *ProjectsLocationsGlobalSecurityGatewaysApplicationsPatchCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -16396,7 +16583,7 @@ func (c *ProjectsLocationsInsightsGetCall) Do(opts ...googleapi.CallOption) (*Go if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsight{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -16409,177 +16596,1578 @@ func (c *ProjectsLocationsInsightsGetCall) Do(opts ...googleapi.CallOption) (*Go return ret, nil } -type ProjectsLocationsInsightsListCall struct { - s *Service - parent string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsGlobalSecurityGatewaysApplicationsTestIamPermissionsCall struct { + s *Service + resource string + googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// List: Lists for all the available insights that could be fetched from the -// system. Allows to filter using category. Setting the `view` to `BASIC` will -// let you iterate over the list of insight metadatas. +// TestIamPermissions: Returns permissions that a caller has on the specified +// resource. If the resource does not exist, this will return an empty set of +// permissions, not a `NOT_FOUND` error. Note: This operation is designed to be +// used for building permission-aware UIs and command-line tools, not for +// authorization checking. This operation may "fail open" without warning. // -// - parent: The resource name of InsightMetadata using the form: -// `organizations/{organization_id}/locations/{location}` -// `projects/{project_id}/locations/{location_id}`. -func (r *ProjectsLocationsInsightsService) List(parent string) *ProjectsLocationsInsightsListCall { - c := &ProjectsLocationsInsightsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent +// - resource: REQUIRED: The resource for which the policy detail is being +// requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the appropriate +// value for this field. +func (r *ProjectsLocationsGlobalSecurityGatewaysApplicationsService) TestIamPermissions(resource string, googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest) *ProjectsLocationsGlobalSecurityGatewaysApplicationsTestIamPermissionsCall { + c := &ProjectsLocationsGlobalSecurityGatewaysApplicationsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.googleiamv1testiampermissionsrequest = googleiamv1testiampermissionsrequest 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) +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsGlobalSecurityGatewaysApplicationsTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsGlobalSecurityGatewaysApplicationsTestIamPermissionsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// EndTime sets the optional parameter "endTime": Ending time for the duration +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGlobalSecurityGatewaysApplicationsTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsGlobalSecurityGatewaysApplicationsTestIamPermissionsCall { + 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 *ProjectsLocationsGlobalSecurityGatewaysApplicationsTestIamPermissionsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGlobalSecurityGatewaysApplicationsTestIamPermissionsCall) 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.googleiamv1testiampermissionsrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+resource}:testIamPermissions") + 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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "beyondcorp.projects.locations.global.securityGateways.applications.testIamPermissions" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleIamV1TestIamPermissionsResponse.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 *ProjectsLocationsGlobalSecurityGatewaysApplicationsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1TestIamPermissionsResponse, 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 := &GoogleIamV1TestIamPermissionsResponse{ + 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 ProjectsLocationsGlobalSecurityGatewaysHubsCreateCall struct { + s *Service + parent string + googlecloudbeyondcorpsecuritygatewaysv1alphahub *GoogleCloudBeyondcorpSecuritygatewaysV1alphaHub + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a new Hub in a given project and location. +// +// - parent: The resource name of the parent SecurityGateway using the form: +// `projects/{project_id}/locations/global/securityGateways/{security_gateway_ +// id}`. +func (r *ProjectsLocationsGlobalSecurityGatewaysHubsService) Create(parent string, googlecloudbeyondcorpsecuritygatewaysv1alphahub *GoogleCloudBeyondcorpSecuritygatewaysV1alphaHub) *ProjectsLocationsGlobalSecurityGatewaysHubsCreateCall { + c := &ProjectsLocationsGlobalSecurityGatewaysHubsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googlecloudbeyondcorpsecuritygatewaysv1alphahub = googlecloudbeyondcorpsecuritygatewaysv1alphahub + return c +} + +// HubId sets the optional parameter "hubId": User-settable Hub resource ID. * +// Must start with a letter. * Must contain between 4-63 characters from +// `/a-z-/`. * Must end with a number or letter. +func (c *ProjectsLocationsGlobalSecurityGatewaysHubsCreateCall) HubId(hubId string) *ProjectsLocationsGlobalSecurityGatewaysHubsCreateCall { + c.urlParams_.Set("hubId", hubId) + return c +} + +// RequestId sets the optional parameter "requestId": An optional request ID to +// identify requests. Specify a unique request ID so that if you must retry +// your request, the server will know to ignore request if it has already been +// completed. The server will guarantee that for at least 60 minutes since the +// first request. +func (c *ProjectsLocationsGlobalSecurityGatewaysHubsCreateCall) RequestId(requestId string) *ProjectsLocationsGlobalSecurityGatewaysHubsCreateCall { + c.urlParams_.Set("requestId", requestId) + 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 *ProjectsLocationsGlobalSecurityGatewaysHubsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsGlobalSecurityGatewaysHubsCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGlobalSecurityGatewaysHubsCreateCall) Context(ctx context.Context) *ProjectsLocationsGlobalSecurityGatewaysHubsCreateCall { + 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 *ProjectsLocationsGlobalSecurityGatewaysHubsCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGlobalSecurityGatewaysHubsCreateCall) 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.googlecloudbeyondcorpsecuritygatewaysv1alphahub) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+parent}/hubs") + 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 "beyondcorp.projects.locations.global.securityGateways.hubs.create" 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 *ProjectsLocationsGlobalSecurityGatewaysHubsCreateCall) 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 ProjectsLocationsGlobalSecurityGatewaysHubsPatchCall struct { + s *Service + name string + googlecloudbeyondcorpsecuritygatewaysv1alphahub *GoogleCloudBeyondcorpSecuritygatewaysV1alphaHub + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates the parameters of a single Hub. +// +// - name: Identifier. Name of the resource. +func (r *ProjectsLocationsGlobalSecurityGatewaysHubsService) Patch(name string, googlecloudbeyondcorpsecuritygatewaysv1alphahub *GoogleCloudBeyondcorpSecuritygatewaysV1alphaHub) *ProjectsLocationsGlobalSecurityGatewaysHubsPatchCall { + c := &ProjectsLocationsGlobalSecurityGatewaysHubsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googlecloudbeyondcorpsecuritygatewaysv1alphahub = googlecloudbeyondcorpsecuritygatewaysv1alphahub + return c +} + +// RequestId sets the optional parameter "requestId": An optional request ID to +// identify requests. Specify a unique request ID so that if you must retry +// your request, the server will know to ignore the request if it has already +// been completed. The server will guarantee that for at least 60 minutes after +// the first request. For example, consider a situation where you make an +// initial request and the request timed out. If you make the request again +// with the same request ID, the server can check if original operation with +// the same request ID was received, and if so, will ignore the second request. +// This prevents clients from accidentally creating duplicate commitments. The +// request ID must be a valid UUID with the exception that zero UUID is not +// supported (00000000-0000-0000-0000-000000000000). +func (c *ProjectsLocationsGlobalSecurityGatewaysHubsPatchCall) RequestId(requestId string) *ProjectsLocationsGlobalSecurityGatewaysHubsPatchCall { + c.urlParams_.Set("requestId", requestId) + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. Mutable +// fields include: display_name. +func (c *ProjectsLocationsGlobalSecurityGatewaysHubsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsGlobalSecurityGatewaysHubsPatchCall { + 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 *ProjectsLocationsGlobalSecurityGatewaysHubsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsGlobalSecurityGatewaysHubsPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGlobalSecurityGatewaysHubsPatchCall) Context(ctx context.Context) *ProjectsLocationsGlobalSecurityGatewaysHubsPatchCall { + 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 *ProjectsLocationsGlobalSecurityGatewaysHubsPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGlobalSecurityGatewaysHubsPatchCall) 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.googlecloudbeyondcorpsecuritygatewaysv1alphahub) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+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 "beyondcorp.projects.locations.global.securityGateways.hubs.patch" 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 *ProjectsLocationsGlobalSecurityGatewaysHubsPatchCall) 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 ProjectsLocationsGlobalSecurityGatewaysHubsTestIamPermissionsCall struct { + s *Service + resource string + googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// TestIamPermissions: Returns permissions that a caller has on the specified +// resource. If the resource does not exist, this will return an empty set of +// permissions, not a `NOT_FOUND` error. Note: This operation is designed to be +// used for building permission-aware UIs and command-line tools, not for +// authorization checking. This operation may "fail open" without warning. +// +// - resource: REQUIRED: The resource for which the policy detail is being +// requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the appropriate +// value for this field. +func (r *ProjectsLocationsGlobalSecurityGatewaysHubsService) TestIamPermissions(resource string, googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest) *ProjectsLocationsGlobalSecurityGatewaysHubsTestIamPermissionsCall { + c := &ProjectsLocationsGlobalSecurityGatewaysHubsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.googleiamv1testiampermissionsrequest = googleiamv1testiampermissionsrequest + 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 *ProjectsLocationsGlobalSecurityGatewaysHubsTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsGlobalSecurityGatewaysHubsTestIamPermissionsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGlobalSecurityGatewaysHubsTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsGlobalSecurityGatewaysHubsTestIamPermissionsCall { + 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 *ProjectsLocationsGlobalSecurityGatewaysHubsTestIamPermissionsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGlobalSecurityGatewaysHubsTestIamPermissionsCall) 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.googleiamv1testiampermissionsrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+resource}:testIamPermissions") + 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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "beyondcorp.projects.locations.global.securityGateways.hubs.testIamPermissions" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleIamV1TestIamPermissionsResponse.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 *ProjectsLocationsGlobalSecurityGatewaysHubsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1TestIamPermissionsResponse, 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 := &GoogleIamV1TestIamPermissionsResponse{ + 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 ProjectsLocationsInsightsConfiguredInsightCall struct { + s *Service + insight string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// ConfiguredInsight: Gets the value for a selected particular insight based on +// the provided filters. Use the organization level path for fetching at org +// level and project level path for fetching the insight value specific to a +// particular project. +// +// - insight: The resource name of the insight using the form: +// `organizations/{organization_id}/locations/{location_id}/insights/{insight_ +// id}` +// `projects/{project_id}/locations/{location_id}/insights/{insight_id}`. +func (r *ProjectsLocationsInsightsService) ConfiguredInsight(insight string) *ProjectsLocationsInsightsConfiguredInsightCall { + c := &ProjectsLocationsInsightsConfiguredInsightCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.insight = insight + return c +} + +// Aggregation sets the optional parameter "aggregation": Required. Aggregation +// type. Available aggregation could be fetched by calling insight list and get +// APIs in `BASIC` view. +// +// 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 *ProjectsLocationsInsightsConfiguredInsightCall) Aggregation(aggregation string) *ProjectsLocationsInsightsConfiguredInsightCall { + c.urlParams_.Set("aggregation", aggregation) + return c +} + +// CustomGroupingFieldFilter sets the optional parameter +// "customGrouping.fieldFilter": Filterable parameters to be added to the +// grouping clause. Available fields could be fetched by calling insight list +// and get APIs in `BASIC` view. `=` is the only comparison operator supported. +// `AND` is the only logical operator supported. Usage: +// field_filter="fieldName1=fieldVal1 AND fieldName2=fieldVal2". NOTE: Only +// `AND` conditions are allowed. NOTE: Use the `filter_alias` from +// `Insight.Metadata.Field` message for the filtering the corresponding fields +// in this filter field. (These expressions are based on the filter language +// described at https://google.aip.dev/160). +func (c *ProjectsLocationsInsightsConfiguredInsightCall) CustomGroupingFieldFilter(customGroupingFieldFilter string) *ProjectsLocationsInsightsConfiguredInsightCall { + c.urlParams_.Set("customGrouping.fieldFilter", customGroupingFieldFilter) + return c +} + +// CustomGroupingGroupFields sets the optional parameter +// "customGrouping.groupFields": Required. Fields to be used for grouping. +// NOTE: Use the `filter_alias` from `Insight.Metadata.Field` message for +// declaring the fields to be grouped-by here. +func (c *ProjectsLocationsInsightsConfiguredInsightCall) CustomGroupingGroupFields(customGroupingGroupFields ...string) *ProjectsLocationsInsightsConfiguredInsightCall { + c.urlParams_.SetMulti("customGrouping.groupFields", append([]string{}, customGroupingGroupFields...)) + return c +} + +// EndTime sets the optional parameter "endTime": Required. Ending time for the +// duration for which insight is to be pulled. +func (c *ProjectsLocationsInsightsConfiguredInsightCall) EndTime(endTime string) *ProjectsLocationsInsightsConfiguredInsightCall { + c.urlParams_.Set("endTime", endTime) + return c +} + +// FieldFilter sets the optional parameter "fieldFilter": Other +// filterable/configurable parameters as applicable to the selected insight. +// Available fields could be fetched by calling insight list and get APIs in +// `BASIC` view. `=` is the only comparison operator supported. `AND` is the +// only logical operator supported. Usage: field_filter="fieldName1=fieldVal1 +// AND fieldName2=fieldVal2". NOTE: Only `AND` conditions are allowed. NOTE: +// Use the `filter_alias` from `Insight.Metadata.Field` message for the +// filtering the corresponding fields in this filter field. (These expressions +// are based on the filter language described at https://google.aip.dev/160). +func (c *ProjectsLocationsInsightsConfiguredInsightCall) FieldFilter(fieldFilter string) *ProjectsLocationsInsightsConfiguredInsightCall { + c.urlParams_.Set("fieldFilter", fieldFilter) + return c +} + +// Group sets the optional parameter "group": Group id of the available +// groupings for the insight. Available groupings could be fetched by calling +// insight list and get APIs in `BASIC` view. +func (c *ProjectsLocationsInsightsConfiguredInsightCall) Group(group string) *ProjectsLocationsInsightsConfiguredInsightCall { + c.urlParams_.Set("group", group) + return c +} + +// PageSize sets the optional parameter "pageSize": Requested page size. Server +// may return fewer items than requested. If unspecified, server will pick an +// appropriate default. +func (c *ProjectsLocationsInsightsConfiguredInsightCall) PageSize(pageSize int64) *ProjectsLocationsInsightsConfiguredInsightCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": Used to fetch the page +// represented by the token. Fetches the first page when not set. +func (c *ProjectsLocationsInsightsConfiguredInsightCall) PageToken(pageToken string) *ProjectsLocationsInsightsConfiguredInsightCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// StartTime sets the optional parameter "startTime": Required. Starting time +// for the duration for which insight is to be pulled. +func (c *ProjectsLocationsInsightsConfiguredInsightCall) StartTime(startTime string) *ProjectsLocationsInsightsConfiguredInsightCall { + c.urlParams_.Set("startTime", startTime) + 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 *ProjectsLocationsInsightsConfiguredInsightCall) Fields(s ...googleapi.Field) *ProjectsLocationsInsightsConfiguredInsightCall { + 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 *ProjectsLocationsInsightsConfiguredInsightCall) IfNoneMatch(entityTag string) *ProjectsLocationsInsightsConfiguredInsightCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsInsightsConfiguredInsightCall) Context(ctx context.Context) *ProjectsLocationsInsightsConfiguredInsightCall { + 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 *ProjectsLocationsInsightsConfiguredInsightCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsInsightsConfiguredInsightCall) 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, "v1alpha/{+insight}:configuredInsight") + 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{ + "insight": c.insight, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "beyondcorp.projects.locations.insights.configuredInsight" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudBeyondcorpSaasplatformInsightsV1alphaConfiguredInsightResponse.Se +// rverResponse.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 *ProjectsLocationsInsightsConfiguredInsightCall) Do(opts ...googleapi.CallOption) (*GoogleCloudBeyondcorpSaasplatformInsightsV1alphaConfiguredInsightResponse, 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 := &GoogleCloudBeyondcorpSaasplatformInsightsV1alphaConfiguredInsightResponse{ + 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 +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsLocationsInsightsConfiguredInsightCall) Pages(ctx context.Context, f func(*GoogleCloudBeyondcorpSaasplatformInsightsV1alphaConfiguredInsightResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + +type ProjectsLocationsInsightsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets the value for a selected particular insight with default +// configuration. The default aggregation level is 'DAILY' and no grouping will +// be applied or default grouping if applicable. The data will be returned for +// recent 7 days starting the day before. The insight data size will be limited +// to 50 rows. Use the organization level path for fetching at org level and +// project level path for fetching the insight value specific to a particular +// project. Setting the `view` to `BASIC` will only return the metadata for the +// insight. +// +// - name: The resource name of the insight using the form: +// `organizations/{organization_id}/locations/{location_id}/insights/{insight_ +// id}` `projects/{project_id}/locations/{location_id}/insights/{insight_id}`. +func (r *ProjectsLocationsInsightsService) Get(name string) *ProjectsLocationsInsightsGetCall { + c := &ProjectsLocationsInsightsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// View sets the optional parameter "view": Required. Metadata only or full +// data view. +// +// Possible values: +// +// "INSIGHT_VIEW_UNSPECIFIED" - The default / unset value. The API will +// +// default to the BASIC view. +// +// "BASIC" - Include basic metadata about the insight, but not the insight +// +// data. This is the default value (for both ListInsights and GetInsight). +// +// "FULL" - Include everything. +func (c *ProjectsLocationsInsightsGetCall) View(view string) *ProjectsLocationsInsightsGetCall { + c.urlParams_.Set("view", view) + 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 *ProjectsLocationsInsightsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsInsightsGetCall { + 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 *ProjectsLocationsInsightsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsInsightsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsInsightsGetCall) Context(ctx context.Context) *ProjectsLocationsInsightsGetCall { + 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 *ProjectsLocationsInsightsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsInsightsGetCall) 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, "v1alpha/{+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 "beyondcorp.projects.locations.insights.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsight.ServerResponse.Heade +// r 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 *ProjectsLocationsInsightsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsight, 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 := &GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsight{ + 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 ProjectsLocationsInsightsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists for all the available insights that could be fetched from the +// system. Allows to filter using category. Setting the `view` to `BASIC` will +// let you iterate over the list of insight metadatas. +// +// - parent: The resource name of InsightMetadata using the form: +// `organizations/{organization_id}/locations/{location}` +// `projects/{project_id}/locations/{location_id}`. +func (r *ProjectsLocationsInsightsService) List(parent string) *ProjectsLocationsInsightsListCall { + c := &ProjectsLocationsInsightsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + 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" * -// "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). -func (c *ProjectsLocationsInsightsListCall) Filter(filter string) *ProjectsLocationsInsightsListCall { - c.urlParams_.Set("filter", filter) +// 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" * +// "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). +func (c *ProjectsLocationsInsightsListCall) Filter(filter string) *ProjectsLocationsInsightsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// OrderBy sets the optional parameter "orderBy": Hint for how to order the +// results. This is currently ignored. +func (c *ProjectsLocationsInsightsListCall) OrderBy(orderBy string) *ProjectsLocationsInsightsListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + +// PageSize sets the optional parameter "pageSize": Requested page size. Server +// may return fewer items than requested. If unspecified, server will pick an +// appropriate default. NOTE: Default page size is 50. +func (c *ProjectsLocationsInsightsListCall) PageSize(pageSize int64) *ProjectsLocationsInsightsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A token identifying a +// page of results the server should return. +func (c *ProjectsLocationsInsightsListCall) PageToken(pageToken string) *ProjectsLocationsInsightsListCall { + c.urlParams_.Set("pageToken", pageToken) + 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. +// +// Possible values: +// +// "INSIGHT_VIEW_UNSPECIFIED" - The default / unset value. The API will +// +// default to the BASIC view. +// +// "BASIC" - Include basic metadata about the insight, but not the insight +// +// data. This is the default value (for both ListInsights and GetInsight). +// +// "FULL" - Include everything. +func (c *ProjectsLocationsInsightsListCall) View(view string) *ProjectsLocationsInsightsListCall { + c.urlParams_.Set("view", view) + 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 *ProjectsLocationsInsightsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsInsightsListCall { + 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 *ProjectsLocationsInsightsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsInsightsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsInsightsListCall) Context(ctx context.Context) *ProjectsLocationsInsightsListCall { + 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 *ProjectsLocationsInsightsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsInsightsListCall) 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, "v1alpha/{+parent}/insights") + 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{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "beyondcorp.projects.locations.insights.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudBeyondcorpSaasplatformInsightsV1alphaListInsightsResponse.ServerR +// esponse.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 *ProjectsLocationsInsightsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudBeyondcorpSaasplatformInsightsV1alphaListInsightsResponse, 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 := &GoogleCloudBeyondcorpSaasplatformInsightsV1alphaListInsightsResponse{ + 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 +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsLocationsInsightsListCall) Pages(ctx context.Context, f func(*GoogleCloudBeyondcorpSaasplatformInsightsV1alphaListInsightsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + +type ProjectsLocationsNetConnectionsGetIamPolicyCall struct { + s *Service + resource string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetIamPolicy: Gets the access control policy for a resource. Returns an +// empty policy if the resource exists and does not have a policy set. +// +// - resource: REQUIRED: The resource for which the policy is being requested. +// See Resource names (https://cloud.google.com/apis/design/resource_names) +// for the appropriate value for this field. +func (r *ProjectsLocationsNetConnectionsService) GetIamPolicy(resource string) *ProjectsLocationsNetConnectionsGetIamPolicyCall { + c := &ProjectsLocationsNetConnectionsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + return c +} + +// OptionsRequestedPolicyVersion sets the optional parameter +// "options.requestedPolicyVersion": The maximum policy version that will be +// used to format the policy. Valid values are 0, 1, and 3. Requests specifying +// an invalid value will be rejected. Requests for policies with any +// conditional role bindings must specify version 3. Policies with no +// conditional role bindings may specify any valid value or leave the field +// unset. The policy in the response might use the policy version that you +// specified, or it might use a lower policy version. For example, if you +// specify version 3, but the policy has no conditional role bindings, the +// response uses version 1. To learn which resources support conditions in +// their IAM policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +func (c *ProjectsLocationsNetConnectionsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsNetConnectionsGetIamPolicyCall { + c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) + 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 *ProjectsLocationsNetConnectionsGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsNetConnectionsGetIamPolicyCall { + 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 *ProjectsLocationsNetConnectionsGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsNetConnectionsGetIamPolicyCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsNetConnectionsGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsNetConnectionsGetIamPolicyCall { + 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 *ProjectsLocationsNetConnectionsGetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsNetConnectionsGetIamPolicyCall) 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, "v1alpha/{+resource}:getIamPolicy") + 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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "beyondcorp.projects.locations.netConnections.getIamPolicy" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleIamV1Policy.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 *ProjectsLocationsNetConnectionsGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, 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 := &GoogleIamV1Policy{ + 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 ProjectsLocationsNetConnectionsSetIamPolicyCall struct { + s *Service + resource string + googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetIamPolicy: Sets the access control policy on the specified resource. +// Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, +// and `PERMISSION_DENIED` errors. +// +// - resource: REQUIRED: The resource for which the policy is being specified. +// See Resource names (https://cloud.google.com/apis/design/resource_names) +// for the appropriate value for this field. +func (r *ProjectsLocationsNetConnectionsService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *ProjectsLocationsNetConnectionsSetIamPolicyCall { + c := &ProjectsLocationsNetConnectionsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.googleiamv1setiampolicyrequest = googleiamv1setiampolicyrequest + 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 *ProjectsLocationsNetConnectionsSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsNetConnectionsSetIamPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsNetConnectionsSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsNetConnectionsSetIamPolicyCall { + 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 *ProjectsLocationsNetConnectionsSetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsNetConnectionsSetIamPolicyCall) 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.googleiamv1setiampolicyrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+resource}:setIamPolicy") + 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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "beyondcorp.projects.locations.netConnections.setIamPolicy" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleIamV1Policy.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 *ProjectsLocationsNetConnectionsSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, 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 := &GoogleIamV1Policy{ + 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 ProjectsLocationsNetConnectionsTestIamPermissionsCall struct { + s *Service + resource string + googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// TestIamPermissions: Returns permissions that a caller has on the specified +// resource. If the resource does not exist, this will return an empty set of +// permissions, not a `NOT_FOUND` error. Note: This operation is designed to be +// used for building permission-aware UIs and command-line tools, not for +// authorization checking. This operation may "fail open" without warning. +// +// - resource: REQUIRED: The resource for which the policy detail is being +// requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the appropriate +// value for this field. +func (r *ProjectsLocationsNetConnectionsService) TestIamPermissions(resource string, googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest) *ProjectsLocationsNetConnectionsTestIamPermissionsCall { + c := &ProjectsLocationsNetConnectionsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.googleiamv1testiampermissionsrequest = googleiamv1testiampermissionsrequest + 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 *ProjectsLocationsNetConnectionsTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsNetConnectionsTestIamPermissionsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// OrderBy sets the optional parameter "orderBy": Hint for how to order the -// results. This is currently ignored. -func (c *ProjectsLocationsInsightsListCall) OrderBy(orderBy string) *ProjectsLocationsInsightsListCall { - c.urlParams_.Set("orderBy", orderBy) +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsNetConnectionsTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsNetConnectionsTestIamPermissionsCall { + c.ctx_ = ctx return c } -// PageSize sets the optional parameter "pageSize": Requested page size. Server -// may return fewer items than requested. If unspecified, server will pick an -// appropriate default. NOTE: Default page size is 50. -func (c *ProjectsLocationsInsightsListCall) PageSize(pageSize int64) *ProjectsLocationsInsightsListCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsNetConnectionsTestIamPermissionsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsNetConnectionsTestIamPermissionsCall) 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.googleiamv1testiampermissionsrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+resource}:testIamPermissions") + 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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "beyondcorp.projects.locations.netConnections.testIamPermissions" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleIamV1TestIamPermissionsResponse.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 *ProjectsLocationsNetConnectionsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1TestIamPermissionsResponse, 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 := &GoogleIamV1TestIamPermissionsResponse{ + 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 ProjectsLocationsOperationsCancelCall struct { + s *Service + name string + googlelongrunningcanceloperationrequest *GoogleLongrunningCancelOperationRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Cancel: Starts asynchronous cancellation on a long-running operation. The +// server makes a best effort to cancel the operation, but success is not +// guaranteed. If the server doesn't support this method, it returns +// `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or +// other methods to check whether the cancellation succeeded or whether the +// operation completed despite cancellation. On successful cancellation, the +// operation is not deleted; instead, it becomes an operation with an +// Operation.error value with a google.rpc.Status.code of 1, corresponding to +// `Code.CANCELLED`. +// +// - name: The name of the operation resource to be cancelled. +func (r *ProjectsLocationsOperationsService) Cancel(name string, googlelongrunningcanceloperationrequest *GoogleLongrunningCancelOperationRequest) *ProjectsLocationsOperationsCancelCall { + c := &ProjectsLocationsOperationsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googlelongrunningcanceloperationrequest = googlelongrunningcanceloperationrequest return c } -// PageToken sets the optional parameter "pageToken": A token identifying a -// page of results the server should return. -func (c *ProjectsLocationsInsightsListCall) PageToken(pageToken string) *ProjectsLocationsInsightsListCall { - c.urlParams_.Set("pageToken", pageToken) +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsOperationsCancelCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsCancelCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsOperationsCancelCall) Context(ctx context.Context) *ProjectsLocationsOperationsCancelCall { + c.ctx_ = ctx 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 +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsOperationsCancelCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsOperationsCancelCall) 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.googlelongrunningcanceloperationrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}:cancel") + 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{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "beyondcorp.projects.locations.operations.cancel" call. +// Any non-2xx status code is an error. Response headers are in either +// *Empty.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 *ProjectsLocationsOperationsCancelCall) Do(opts ...googleapi.CallOption) (*Empty, 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 := &Empty{ + 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 ProjectsLocationsOperationsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// View sets the optional parameter "view": Required. List only metadata or -// full data. -// -// Possible values: -// -// "INSIGHT_VIEW_UNSPECIFIED" - The default / unset value. The API will -// -// default to the BASIC view. -// -// "BASIC" - Include basic metadata about the insight, but not the insight -// -// data. This is the default value (for both ListInsights and GetInsight). +// Delete: Deletes a long-running operation. This method indicates that the +// client is no longer interested in the operation result. It does not cancel +// the operation. If the server doesn't support this method, it returns +// `google.rpc.Code.UNIMPLEMENTED`. // -// "FULL" - Include everything. -func (c *ProjectsLocationsInsightsListCall) View(view string) *ProjectsLocationsInsightsListCall { - c.urlParams_.Set("view", view) +// - name: The name of the operation resource to be deleted. +func (r *ProjectsLocationsOperationsService) Delete(name string) *ProjectsLocationsOperationsDeleteCall { + c := &ProjectsLocationsOperationsDeleteCall{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 *ProjectsLocationsInsightsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsInsightsListCall { +func (c *ProjectsLocationsOperationsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsDeleteCall { 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 *ProjectsLocationsInsightsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsInsightsListCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsInsightsListCall) Context(ctx context.Context) *ProjectsLocationsInsightsListCall { +func (c *ProjectsLocationsOperationsDeleteCall) Context(ctx context.Context) *ProjectsLocationsOperationsDeleteCall { 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 *ProjectsLocationsInsightsListCall) Header() http.Header { +func (c *ProjectsLocationsOperationsDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsInsightsListCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsOperationsDeleteCall) 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, "v1alpha/{+parent}/insights") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, body) + req, err := http.NewRequest("DELETE", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, + "name": c.name, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "beyondcorp.projects.locations.insights.list" call. +// Do executes the "beyondcorp.projects.locations.operations.delete" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudBeyondcorpSaasplatformInsightsV1alphaListInsightsResponse.ServerR -// esponse.Header or (if a response was returned at all) in +// *Empty.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 *ProjectsLocationsInsightsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudBeyondcorpSaasplatformInsightsV1alphaListInsightsResponse, error) { +func (c *ProjectsLocationsOperationsDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -16598,7 +18186,7 @@ func (c *ProjectsLocationsInsightsListCall) Do(opts ...googleapi.CallOption) (*G if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudBeyondcorpSaasplatformInsightsV1alphaListInsightsResponse{ + ret := &Empty{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -16611,69 +18199,30 @@ func (c *ProjectsLocationsInsightsListCall) Do(opts ...googleapi.CallOption) (*G return ret, nil } -// Pages invokes f for each page of results. -// A non-nil error returned from f will halt the iteration. -// The provided context supersedes any context provided to the Context method. -func (c *ProjectsLocationsInsightsListCall) Pages(ctx context.Context, f func(*GoogleCloudBeyondcorpSaasplatformInsightsV1alphaListInsightsResponse) error) error { - c.ctx_ = ctx - defer c.PageToken(c.urlParams_.Get("pageToken")) - for { - x, err := c.Do() - if err != nil { - return err - } - if err := f(x); err != nil { - return err - } - if x.NextPageToken == "" { - return nil - } - c.PageToken(x.NextPageToken) - } -} - -type ProjectsLocationsNetConnectionsGetIamPolicyCall struct { +type ProjectsLocationsOperationsGetCall struct { s *Service - resource string + name string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } -// GetIamPolicy: Gets the access control policy for a resource. Returns an -// empty policy if the resource exists and does not have a policy set. +// Get: Gets the latest state of a long-running operation. Clients can use this +// method to poll the operation result at intervals as recommended by the API +// service. // -// - resource: REQUIRED: The resource for which the policy is being requested. -// See Resource names (https://cloud.google.com/apis/design/resource_names) -// for the appropriate value for this field. -func (r *ProjectsLocationsNetConnectionsService) GetIamPolicy(resource string) *ProjectsLocationsNetConnectionsGetIamPolicyCall { - c := &ProjectsLocationsNetConnectionsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - return c -} - -// OptionsRequestedPolicyVersion sets the optional parameter -// "options.requestedPolicyVersion": The maximum policy version that will be -// used to format the policy. Valid values are 0, 1, and 3. Requests specifying -// an invalid value will be rejected. Requests for policies with any -// conditional role bindings must specify version 3. Policies with no -// conditional role bindings may specify any valid value or leave the field -// unset. The policy in the response might use the policy version that you -// specified, or it might use a lower policy version. For example, if you -// specify version 3, but the policy has no conditional role bindings, the -// response uses version 1. To learn which resources support conditions in -// their IAM policies, see the IAM documentation -// (https://cloud.google.com/iam/help/conditions/resource-policies). -func (c *ProjectsLocationsNetConnectionsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsNetConnectionsGetIamPolicyCall { - c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) +// - name: The name of the operation resource. +func (r *ProjectsLocationsOperationsService) Get(name string) *ProjectsLocationsOperationsGetCall { + c := &ProjectsLocationsOperationsGetCall{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 *ProjectsLocationsNetConnectionsGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsNetConnectionsGetIamPolicyCall { +func (c *ProjectsLocationsOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -16681,27 +18230,27 @@ func (c *ProjectsLocationsNetConnectionsGetIamPolicyCall) Fields(s ...googleapi. // 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 *ProjectsLocationsNetConnectionsGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsNetConnectionsGetIamPolicyCall { +func (c *ProjectsLocationsOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsOperationsGetCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsNetConnectionsGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsNetConnectionsGetIamPolicyCall { +func (c *ProjectsLocationsOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsOperationsGetCall { 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 *ProjectsLocationsNetConnectionsGetIamPolicyCall) Header() http.Header { +func (c *ProjectsLocationsOperationsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsNetConnectionsGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsOperationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) @@ -16709,7 +18258,7 @@ func (c *ProjectsLocationsNetConnectionsGetIamPolicyCall) doRequest(alt string) var body io.Reader = nil c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+resource}:getIamPolicy") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, body) if err != nil { @@ -16717,18 +18266,18 @@ func (c *ProjectsLocationsNetConnectionsGetIamPolicyCall) doRequest(alt string) } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, + "name": c.name, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "beyondcorp.projects.locations.netConnections.getIamPolicy" call. +// Do executes the "beyondcorp.projects.locations.operations.get" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleIamV1Policy.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 *ProjectsLocationsNetConnectionsGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { +// *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 *ProjectsLocationsOperationsGetCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -16747,7 +18296,7 @@ func (c *ProjectsLocationsNetConnectionsGetIamPolicyCall) Do(opts ...googleapi.C if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleIamV1Policy{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -16760,81 +18309,104 @@ func (c *ProjectsLocationsNetConnectionsGetIamPolicyCall) Do(opts ...googleapi.C return ret, nil } -type ProjectsLocationsNetConnectionsSetIamPolicyCall struct { - s *Service - resource string - googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsOperationsListCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// SetIamPolicy: Sets the access control policy on the specified resource. -// Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, -// and `PERMISSION_DENIED` errors. +// List: Lists operations that match the specified filter in the request. If +// the server doesn't support this method, it returns `UNIMPLEMENTED`. // -// - resource: REQUIRED: The resource for which the policy is being specified. -// See Resource names (https://cloud.google.com/apis/design/resource_names) -// for the appropriate value for this field. -func (r *ProjectsLocationsNetConnectionsService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *ProjectsLocationsNetConnectionsSetIamPolicyCall { - c := &ProjectsLocationsNetConnectionsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.googleiamv1setiampolicyrequest = googleiamv1setiampolicyrequest +// - name: The name of the operation's parent resource. +func (r *ProjectsLocationsOperationsService) List(name string) *ProjectsLocationsOperationsListCall { + c := &ProjectsLocationsOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Filter sets the optional parameter "filter": The standard list filter. +func (c *ProjectsLocationsOperationsListCall) Filter(filter string) *ProjectsLocationsOperationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The standard list page +// size. +func (c *ProjectsLocationsOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsOperationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The standard list page +// token. +func (c *ProjectsLocationsOperationsListCall) PageToken(pageToken string) *ProjectsLocationsOperationsListCall { + c.urlParams_.Set("pageToken", pageToken) 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 *ProjectsLocationsNetConnectionsSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsNetConnectionsSetIamPolicyCall { +func (c *ProjectsLocationsOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsListCall { 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 *ProjectsLocationsOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsOperationsListCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsNetConnectionsSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsNetConnectionsSetIamPolicyCall { +func (c *ProjectsLocationsOperationsListCall) Context(ctx context.Context) *ProjectsLocationsOperationsListCall { 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 *ProjectsLocationsNetConnectionsSetIamPolicyCall) Header() http.Header { +func (c *ProjectsLocationsOperationsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsNetConnectionsSetIamPolicyCall) 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.googleiamv1setiampolicyrequest) - if err != nil { - return nil, err +func (c *ProjectsLocationsOperationsListCall) 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, "v1alpha/{+resource}:setIamPolicy") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}/operations") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("GET", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, + "name": c.name, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "beyondcorp.projects.locations.netConnections.setIamPolicy" call. +// Do executes the "beyondcorp.projects.locations.operations.list" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleIamV1Policy.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 *ProjectsLocationsNetConnectionsSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { +// *GoogleLongrunningListOperationsResponse.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 *ProjectsLocationsOperationsListCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningListOperationsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -16853,7 +18425,7 @@ func (c *ProjectsLocationsNetConnectionsSetIamPolicyCall) Do(opts ...googleapi.C if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleIamV1Policy{ + ret := &GoogleLongrunningListOperationsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -16866,65 +18438,99 @@ func (c *ProjectsLocationsNetConnectionsSetIamPolicyCall) Do(opts ...googleapi.C return ret, nil } -type ProjectsLocationsNetConnectionsTestIamPermissionsCall struct { - s *Service - resource string - googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsLocationsOperationsListCall) Pages(ctx context.Context, f func(*GoogleLongrunningListOperationsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } } -// TestIamPermissions: Returns permissions that a caller has on the specified -// resource. If the resource does not exist, this will return an empty set of -// permissions, not a `NOT_FOUND` error. Note: This operation is designed to be -// used for building permission-aware UIs and command-line tools, not for -// authorization checking. This operation may "fail open" without warning. +type ProjectsLocationsSecurityGatewaysCreateCall struct { + s *Service + parent string + googlecloudbeyondcorpsecuritygatewaysv1alphasecuritygateway *GoogleCloudBeyondcorpSecuritygatewaysV1alphaSecurityGateway + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a new SecurityGateway in a given project and location. // -// - resource: REQUIRED: The resource for which the policy detail is being -// requested. See Resource names -// (https://cloud.google.com/apis/design/resource_names) for the appropriate -// value for this field. -func (r *ProjectsLocationsNetConnectionsService) TestIamPermissions(resource string, googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest) *ProjectsLocationsNetConnectionsTestIamPermissionsCall { - c := &ProjectsLocationsNetConnectionsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.googleiamv1testiampermissionsrequest = googleiamv1testiampermissionsrequest +// - parent: The resource project name of the SecurityGateway location using +// the form: `projects/{project_id}/locations/{location_id}`. +func (r *ProjectsLocationsSecurityGatewaysService) Create(parent string, googlecloudbeyondcorpsecuritygatewaysv1alphasecuritygateway *GoogleCloudBeyondcorpSecuritygatewaysV1alphaSecurityGateway) *ProjectsLocationsSecurityGatewaysCreateCall { + c := &ProjectsLocationsSecurityGatewaysCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googlecloudbeyondcorpsecuritygatewaysv1alphasecuritygateway = googlecloudbeyondcorpsecuritygatewaysv1alphasecuritygateway + return c +} + +// RequestId sets the optional parameter "requestId": An optional request ID to +// identify requests. Specify a unique request ID so that if you must retry +// your request, the server will know to ignore request if it has already been +// completed. The server will guarantee that for at least 60 minutes since the +// first request. +func (c *ProjectsLocationsSecurityGatewaysCreateCall) RequestId(requestId string) *ProjectsLocationsSecurityGatewaysCreateCall { + c.urlParams_.Set("requestId", requestId) + return c +} + +// SecurityGatewayId sets the optional parameter "securityGatewayId": +// User-settable SecurityGateway resource ID. * Must start with a letter. * +// Must contain between 4-63 characters from `/a-z-/`. * Must end with a number +// or letter. +func (c *ProjectsLocationsSecurityGatewaysCreateCall) SecurityGatewayId(securityGatewayId string) *ProjectsLocationsSecurityGatewaysCreateCall { + c.urlParams_.Set("securityGatewayId", securityGatewayId) 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 *ProjectsLocationsNetConnectionsTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsNetConnectionsTestIamPermissionsCall { +func (c *ProjectsLocationsSecurityGatewaysCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsSecurityGatewaysCreateCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsNetConnectionsTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsNetConnectionsTestIamPermissionsCall { +func (c *ProjectsLocationsSecurityGatewaysCreateCall) Context(ctx context.Context) *ProjectsLocationsSecurityGatewaysCreateCall { 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 *ProjectsLocationsNetConnectionsTestIamPermissionsCall) Header() http.Header { +func (c *ProjectsLocationsSecurityGatewaysCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsNetConnectionsTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsSecurityGatewaysCreateCall) 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.googleiamv1testiampermissionsrequest) + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googlecloudbeyondcorpsecuritygatewaysv1alphasecuritygateway) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+resource}:testIamPermissions") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+parent}/securityGateways") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -16932,18 +18538,18 @@ func (c *ProjectsLocationsNetConnectionsTestIamPermissionsCall) doRequest(alt st } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, + "parent": c.parent, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "beyondcorp.projects.locations.netConnections.testIamPermissions" call. +// Do executes the "beyondcorp.projects.locations.securityGateways.create" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleIamV1TestIamPermissionsResponse.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use +// *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 *ProjectsLocationsNetConnectionsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1TestIamPermissionsResponse, error) { +func (c *ProjectsLocationsSecurityGatewaysCreateCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -16962,7 +18568,7 @@ func (c *ProjectsLocationsNetConnectionsTestIamPermissionsCall) Do(opts ...googl if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleIamV1TestIamPermissionsResponse{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -16975,68 +18581,80 @@ func (c *ProjectsLocationsNetConnectionsTestIamPermissionsCall) Do(opts ...googl return ret, nil } -type ProjectsLocationsOperationsCancelCall struct { - s *Service - name string - googlelongrunningcanceloperationrequest *GoogleLongrunningCancelOperationRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsSecurityGatewaysDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Cancel: Starts asynchronous cancellation on a long-running operation. The -// server makes a best effort to cancel the operation, but success is not -// guaranteed. If the server doesn't support this method, it returns -// `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or -// other methods to check whether the cancellation succeeded or whether the -// operation completed despite cancellation. On successful cancellation, the -// operation is not deleted; instead, it becomes an operation with an -// Operation.error value with a google.rpc.Status.code of 1, corresponding to -// `Code.CANCELLED`. +// Delete: Deletes a single SecurityGateway. // -// - name: The name of the operation resource to be cancelled. -func (r *ProjectsLocationsOperationsService) Cancel(name string, googlelongrunningcanceloperationrequest *GoogleLongrunningCancelOperationRequest) *ProjectsLocationsOperationsCancelCall { - c := &ProjectsLocationsOperationsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: BeyondCorp SecurityGateway name using the form: +// `projects/{project_id}/locations/{location_id}/securityGateways/{security_g +// ateway_id}`. +func (r *ProjectsLocationsSecurityGatewaysService) Delete(name string) *ProjectsLocationsSecurityGatewaysDeleteCall { + c := &ProjectsLocationsSecurityGatewaysDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name - c.googlelongrunningcanceloperationrequest = googlelongrunningcanceloperationrequest + return c +} + +// RequestId sets the optional parameter "requestId": An optional request ID to +// identify requests. Specify a unique request ID so that if you must retry +// your request, the server will know to ignore the request if it has already +// been completed. The server will guarantee that for at least 60 minutes after +// the first request. For example, consider a situation where you make an +// initial request and the request times out. If you make the request again +// with the same request ID, the server can check if original operation with +// the same request ID was received, and if so, will ignore the second request. +// This prevents clients from accidentally creating duplicate commitments. The +// request ID must be a valid UUID with the exception that zero UUID is not +// supported (00000000-0000-0000-0000-000000000000). +func (c *ProjectsLocationsSecurityGatewaysDeleteCall) RequestId(requestId string) *ProjectsLocationsSecurityGatewaysDeleteCall { + c.urlParams_.Set("requestId", requestId) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": If set, validates +// request by executing a dry-run which would not alter the resource in any +// way. +func (c *ProjectsLocationsSecurityGatewaysDeleteCall) ValidateOnly(validateOnly bool) *ProjectsLocationsSecurityGatewaysDeleteCall { + c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) 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 *ProjectsLocationsOperationsCancelCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsCancelCall { +func (c *ProjectsLocationsSecurityGatewaysDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsSecurityGatewaysDeleteCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsOperationsCancelCall) Context(ctx context.Context) *ProjectsLocationsOperationsCancelCall { +func (c *ProjectsLocationsSecurityGatewaysDeleteCall) Context(ctx context.Context) *ProjectsLocationsSecurityGatewaysDeleteCall { 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 *ProjectsLocationsOperationsCancelCall) Header() http.Header { +func (c *ProjectsLocationsSecurityGatewaysDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsOperationsCancelCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) +func (c *ProjectsLocationsSecurityGatewaysDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) var body io.Reader = nil - body, err := googleapi.WithoutDataWrapper.JSONReader(c.googlelongrunningcanceloperationrequest) - if err != nil { - return nil, err - } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}:cancel") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("DELETE", urls, body) if err != nil { return nil, err } @@ -17047,12 +18665,13 @@ func (c *ProjectsLocationsOperationsCancelCall) doRequest(alt string) (*http.Res return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "beyondcorp.projects.locations.operations.cancel" call. +// Do executes the "beyondcorp.projects.locations.securityGateways.delete" call. // Any non-2xx status code is an error. Response headers are in either -// *Empty.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 *ProjectsLocationsOperationsCancelCall) Do(opts ...googleapi.CallOption) (*Empty, error) { +// *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 *ProjectsLocationsSecurityGatewaysDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -17071,7 +18690,7 @@ func (c *ProjectsLocationsOperationsCancelCall) Do(opts ...googleapi.CallOption) if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Empty{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -17084,22 +18703,22 @@ func (c *ProjectsLocationsOperationsCancelCall) Do(opts ...googleapi.CallOption) return ret, nil } -type ProjectsLocationsOperationsDeleteCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsSecurityGatewaysGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Delete: Deletes a long-running operation. This method indicates that the -// client is no longer interested in the operation result. It does not cancel -// the operation. If the server doesn't support this method, it returns -// `google.rpc.Code.UNIMPLEMENTED`. +// Get: Gets details of a single SecurityGateway. // -// - name: The name of the operation resource to be deleted. -func (r *ProjectsLocationsOperationsService) Delete(name string) *ProjectsLocationsOperationsDeleteCall { - c := &ProjectsLocationsOperationsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The resource name of the PartnerTenant using the form: +// `projects/{project_id}/locations/{location_id}/securityGateway/{security_ga +// teway_id}`. +func (r *ProjectsLocationsSecurityGatewaysService) Get(name string) *ProjectsLocationsSecurityGatewaysGetCall { + c := &ProjectsLocationsSecurityGatewaysGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } @@ -17107,34 +18726,45 @@ func (r *ProjectsLocationsOperationsService) Delete(name string) *ProjectsLocati // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsOperationsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsDeleteCall { +func (c *ProjectsLocationsSecurityGatewaysGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsSecurityGatewaysGetCall { 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 *ProjectsLocationsSecurityGatewaysGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsSecurityGatewaysGetCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsOperationsDeleteCall) Context(ctx context.Context) *ProjectsLocationsOperationsDeleteCall { +func (c *ProjectsLocationsSecurityGatewaysGetCall) Context(ctx context.Context) *ProjectsLocationsSecurityGatewaysGetCall { 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 *ProjectsLocationsOperationsDeleteCall) Header() http.Header { +func (c *ProjectsLocationsSecurityGatewaysGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsOperationsDeleteCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsSecurityGatewaysGetCall) 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, "v1alpha/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("DELETE", urls, body) + req, err := http.NewRequest("GET", urls, body) if err != nil { return nil, err } @@ -17145,12 +18775,13 @@ func (c *ProjectsLocationsOperationsDeleteCall) doRequest(alt string) (*http.Res return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "beyondcorp.projects.locations.operations.delete" call. +// Do executes the "beyondcorp.projects.locations.securityGateways.get" call. // Any non-2xx status code is an error. Response headers are in either -// *Empty.ServerResponse.Header or (if a response was returned at all) in +// *GoogleCloudBeyondcorpSecuritygatewaysV1alphaSecurityGateway.ServerResponse.H +// eader 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 *ProjectsLocationsOperationsDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error) { +func (c *ProjectsLocationsSecurityGatewaysGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudBeyondcorpSecuritygatewaysV1alphaSecurityGateway, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -17169,7 +18800,7 @@ func (c *ProjectsLocationsOperationsDeleteCall) Do(opts ...googleapi.CallOption) if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Empty{ + ret := &GoogleCloudBeyondcorpSecuritygatewaysV1alphaSecurityGateway{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -17182,30 +18813,48 @@ func (c *ProjectsLocationsOperationsDeleteCall) Do(opts ...googleapi.CallOption) return ret, nil } -type ProjectsLocationsOperationsGetCall struct { +type ProjectsLocationsSecurityGatewaysGetIamPolicyCall struct { s *Service - name string + resource string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } -// Get: Gets the latest state of a long-running operation. Clients can use this -// method to poll the operation result at intervals as recommended by the API -// service. +// GetIamPolicy: Gets the access control policy for a resource. Returns an +// empty policy if the resource exists and does not have a policy set. // -// - name: The name of the operation resource. -func (r *ProjectsLocationsOperationsService) Get(name string) *ProjectsLocationsOperationsGetCall { - c := &ProjectsLocationsOperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name +// - resource: REQUIRED: The resource for which the policy is being requested. +// See Resource names (https://cloud.google.com/apis/design/resource_names) +// for the appropriate value for this field. +func (r *ProjectsLocationsSecurityGatewaysService) GetIamPolicy(resource string) *ProjectsLocationsSecurityGatewaysGetIamPolicyCall { + c := &ProjectsLocationsSecurityGatewaysGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + return c +} + +// OptionsRequestedPolicyVersion sets the optional parameter +// "options.requestedPolicyVersion": The maximum policy version that will be +// used to format the policy. Valid values are 0, 1, and 3. Requests specifying +// an invalid value will be rejected. Requests for policies with any +// conditional role bindings must specify version 3. Policies with no +// conditional role bindings may specify any valid value or leave the field +// unset. The policy in the response might use the policy version that you +// specified, or it might use a lower policy version. For example, if you +// specify version 3, but the policy has no conditional role bindings, the +// response uses version 1. To learn which resources support conditions in +// their IAM policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +func (c *ProjectsLocationsSecurityGatewaysGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsSecurityGatewaysGetIamPolicyCall { + c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) 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 *ProjectsLocationsOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsGetCall { +func (c *ProjectsLocationsSecurityGatewaysGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsSecurityGatewaysGetIamPolicyCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -17213,27 +18862,27 @@ func (c *ProjectsLocationsOperationsGetCall) Fields(s ...googleapi.Field) *Proje // 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 *ProjectsLocationsOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsOperationsGetCall { +func (c *ProjectsLocationsSecurityGatewaysGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsSecurityGatewaysGetIamPolicyCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsOperationsGetCall { +func (c *ProjectsLocationsSecurityGatewaysGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsSecurityGatewaysGetIamPolicyCall { 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 *ProjectsLocationsOperationsGetCall) Header() http.Header { +func (c *ProjectsLocationsSecurityGatewaysGetIamPolicyCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsOperationsGetCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsSecurityGatewaysGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) @@ -17241,7 +18890,7 @@ func (c *ProjectsLocationsOperationsGetCall) doRequest(alt string) (*http.Respon var body io.Reader = nil c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+resource}:getIamPolicy") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, body) if err != nil { @@ -17249,18 +18898,18 @@ func (c *ProjectsLocationsOperationsGetCall) doRequest(alt string) (*http.Respon } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "resource": c.resource, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "beyondcorp.projects.locations.operations.get" call. +// Do executes the "beyondcorp.projects.locations.securityGateways.getIamPolicy" 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 *ProjectsLocationsOperationsGetCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +// *GoogleIamV1Policy.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 *ProjectsLocationsSecurityGatewaysGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -17279,7 +18928,7 @@ func (c *ProjectsLocationsOperationsGetCall) Do(opts ...googleapi.CallOption) (* if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &GoogleIamV1Policy{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -17292,41 +18941,57 @@ func (c *ProjectsLocationsOperationsGetCall) Do(opts ...googleapi.CallOption) (* return ret, nil } -type ProjectsLocationsOperationsListCall struct { +type ProjectsLocationsSecurityGatewaysListCall struct { s *Service - name string + parent string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } -// List: Lists operations that match the specified filter in the request. If -// the server doesn't support this method, it returns `UNIMPLEMENTED`. +// List: Lists SecurityGateways in a given project and location. // -// - name: The name of the operation's parent resource. -func (r *ProjectsLocationsOperationsService) List(name string) *ProjectsLocationsOperationsListCall { - c := &ProjectsLocationsOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name +// - parent: The parent location to which the resources belong. +// `projects/{project_id}/locations/{location_id}/`. +func (r *ProjectsLocationsSecurityGatewaysService) List(parent string) *ProjectsLocationsSecurityGatewaysListCall { + c := &ProjectsLocationsSecurityGatewaysListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent return c } -// Filter sets the optional parameter "filter": The standard list filter. -func (c *ProjectsLocationsOperationsListCall) Filter(filter string) *ProjectsLocationsOperationsListCall { +// Filter sets the optional parameter "filter": A filter specifying constraints +// of a list operation. All fields in the SecurityGateway message are +// supported. For example, the following query will return the SecurityGateway +// with displayName "test-security-gateway" For more information, please refer +// to https://google.aip.dev/160. +func (c *ProjectsLocationsSecurityGatewaysListCall) Filter(filter string) *ProjectsLocationsSecurityGatewaysListCall { c.urlParams_.Set("filter", filter) return c } -// PageSize sets the optional parameter "pageSize": The standard list page -// size. -func (c *ProjectsLocationsOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsOperationsListCall { +// OrderBy sets the optional parameter "orderBy": Specifies the ordering of +// results. See Sorting order +// (https://cloud.google.com/apis/design/design_patterns#sorting_order) for +// more information. +func (c *ProjectsLocationsSecurityGatewaysListCall) OrderBy(orderBy string) *ProjectsLocationsSecurityGatewaysListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number of items +// to return. If not specified, a default value of 50 will be used by the +// service. Regardless of the page_size value, the response may include a +// partial list and a caller should only rely on response's next_page_token to +// determine if there are more instances left to be queried. +func (c *ProjectsLocationsSecurityGatewaysListCall) PageSize(pageSize int64) *ProjectsLocationsSecurityGatewaysListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c } -// PageToken sets the optional parameter "pageToken": The standard list page -// token. -func (c *ProjectsLocationsOperationsListCall) PageToken(pageToken string) *ProjectsLocationsOperationsListCall { +// PageToken sets the optional parameter "pageToken": The next_page_token value +// returned from a previous ListSecurityGatewayRequest, if any. +func (c *ProjectsLocationsSecurityGatewaysListCall) PageToken(pageToken string) *ProjectsLocationsSecurityGatewaysListCall { c.urlParams_.Set("pageToken", pageToken) return c } @@ -17334,7 +18999,7 @@ func (c *ProjectsLocationsOperationsListCall) PageToken(pageToken string) *Proje // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsListCall { +func (c *ProjectsLocationsSecurityGatewaysListCall) Fields(s ...googleapi.Field) *ProjectsLocationsSecurityGatewaysListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -17342,27 +19007,27 @@ func (c *ProjectsLocationsOperationsListCall) Fields(s ...googleapi.Field) *Proj // 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 *ProjectsLocationsOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsOperationsListCall { +func (c *ProjectsLocationsSecurityGatewaysListCall) IfNoneMatch(entityTag string) *ProjectsLocationsSecurityGatewaysListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsOperationsListCall) Context(ctx context.Context) *ProjectsLocationsOperationsListCall { +func (c *ProjectsLocationsSecurityGatewaysListCall) Context(ctx context.Context) *ProjectsLocationsSecurityGatewaysListCall { 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 *ProjectsLocationsOperationsListCall) Header() http.Header { +func (c *ProjectsLocationsSecurityGatewaysListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsOperationsListCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsSecurityGatewaysListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) @@ -17370,7 +19035,7 @@ func (c *ProjectsLocationsOperationsListCall) doRequest(alt string) (*http.Respo var body io.Reader = nil c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}/operations") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+parent}/securityGateways") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, body) if err != nil { @@ -17378,18 +19043,18 @@ func (c *ProjectsLocationsOperationsListCall) doRequest(alt string) (*http.Respo } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "parent": c.parent, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "beyondcorp.projects.locations.operations.list" call. +// Do executes the "beyondcorp.projects.locations.securityGateways.list" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleLongrunningListOperationsResponse.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 *ProjectsLocationsOperationsListCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningListOperationsResponse, error) { +// *GoogleCloudBeyondcorpSecuritygatewaysV1alphaListSecurityGatewaysResponse.Ser +// verResponse.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 *ProjectsLocationsSecurityGatewaysListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudBeyondcorpSecuritygatewaysV1alphaListSecurityGatewaysResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -17408,7 +19073,7 @@ func (c *ProjectsLocationsOperationsListCall) Do(opts ...googleapi.CallOption) ( if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningListOperationsResponse{ + ret := &GoogleCloudBeyondcorpSecuritygatewaysV1alphaListSecurityGatewaysResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -17424,7 +19089,7 @@ func (c *ProjectsLocationsOperationsListCall) Do(opts ...googleapi.CallOption) ( // Pages invokes f for each page of results. // A non-nil error returned from f will halt the iteration. // The provided context supersedes any context provided to the Context method. -func (c *ProjectsLocationsOperationsListCall) Pages(ctx context.Context, f func(*GoogleLongrunningListOperationsResponse) error) error { +func (c *ProjectsLocationsSecurityGatewaysListCall) Pages(ctx context.Context, f func(*GoogleCloudBeyondcorpSecuritygatewaysV1alphaListSecurityGatewaysResponse) error) error { c.ctx_ = ctx defer c.PageToken(c.urlParams_.Get("pageToken")) for { @@ -17442,78 +19107,187 @@ func (c *ProjectsLocationsOperationsListCall) Pages(ctx context.Context, f func( } } -type ProjectsLocationsSecurityGatewaysCreateCall struct { +type ProjectsLocationsSecurityGatewaysPatchCall struct { s *Service - parent string + name string googlecloudbeyondcorpsecuritygatewaysv1alphasecuritygateway *GoogleCloudBeyondcorpSecuritygatewaysV1alphaSecurityGateway urlParams_ gensupport.URLParams ctx_ context.Context header_ http.Header } -// Create: Creates a new SecurityGateway in a given project and location. +// Patch: Updates the parameters of a single SecurityGateway. // -// - parent: The resource project name of the SecurityGateway location using -// the form: `projects/{project_id}/locations/{location_id}`. -func (r *ProjectsLocationsSecurityGatewaysService) Create(parent string, googlecloudbeyondcorpsecuritygatewaysv1alphasecuritygateway *GoogleCloudBeyondcorpSecuritygatewaysV1alphaSecurityGateway) *ProjectsLocationsSecurityGatewaysCreateCall { - c := &ProjectsLocationsSecurityGatewaysCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent +// - name: Identifier. Name of the resource. +func (r *ProjectsLocationsSecurityGatewaysService) Patch(name string, googlecloudbeyondcorpsecuritygatewaysv1alphasecuritygateway *GoogleCloudBeyondcorpSecuritygatewaysV1alphaSecurityGateway) *ProjectsLocationsSecurityGatewaysPatchCall { + c := &ProjectsLocationsSecurityGatewaysPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name c.googlecloudbeyondcorpsecuritygatewaysv1alphasecuritygateway = googlecloudbeyondcorpsecuritygatewaysv1alphasecuritygateway return c } -// RequestId sets the optional parameter "requestId": An optional request ID to -// identify requests. Specify a unique request ID so that if you must retry -// your request, the server will know to ignore request if it has already been -// completed. The server will guarantee that for at least 60 minutes since the -// first request. -func (c *ProjectsLocationsSecurityGatewaysCreateCall) RequestId(requestId string) *ProjectsLocationsSecurityGatewaysCreateCall { - c.urlParams_.Set("requestId", requestId) - return c +// RequestId sets the optional parameter "requestId": An optional request ID to +// identify requests. Specify a unique request ID so that if you must retry +// your request, the server will know to ignore the request if it has already +// been completed. The server will guarantee that for at least 60 minutes after +// the first request. For example, consider a situation where you make an +// initial request and the request timed out. If you make the request again +// with the same request ID, the server can check if original operation with +// the same request ID was received, and if so, will ignore the second request. +// This prevents clients from accidentally creating duplicate commitments. The +// request ID must be a valid UUID with the exception that zero UUID is not +// supported (00000000-0000-0000-0000-000000000000). +func (c *ProjectsLocationsSecurityGatewaysPatchCall) RequestId(requestId string) *ProjectsLocationsSecurityGatewaysPatchCall { + c.urlParams_.Set("requestId", requestId) + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. Mutable +// fields include: display_name, gateway_regions. +func (c *ProjectsLocationsSecurityGatewaysPatchCall) UpdateMask(updateMask string) *ProjectsLocationsSecurityGatewaysPatchCall { + 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 *ProjectsLocationsSecurityGatewaysPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsSecurityGatewaysPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsSecurityGatewaysPatchCall) Context(ctx context.Context) *ProjectsLocationsSecurityGatewaysPatchCall { + 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 *ProjectsLocationsSecurityGatewaysPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsSecurityGatewaysPatchCall) 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.googlecloudbeyondcorpsecuritygatewaysv1alphasecuritygateway) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+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 "beyondcorp.projects.locations.securityGateways.patch" 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 *ProjectsLocationsSecurityGatewaysPatchCall) 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 ProjectsLocationsSecurityGatewaysSetIamPolicyCall struct { + s *Service + resource string + googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// SecurityGatewayId sets the optional parameter "securityGatewayId": -// User-settable SecurityGateway resource ID. * Must start with a letter. * -// Must contain between 4-63 characters from `/a-z-/`. * Must end with a number -// or letter. -func (c *ProjectsLocationsSecurityGatewaysCreateCall) SecurityGatewayId(securityGatewayId string) *ProjectsLocationsSecurityGatewaysCreateCall { - c.urlParams_.Set("securityGatewayId", securityGatewayId) +// SetIamPolicy: Sets the access control policy on the specified resource. +// Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, +// and `PERMISSION_DENIED` errors. +// +// - resource: REQUIRED: The resource for which the policy is being specified. +// See Resource names (https://cloud.google.com/apis/design/resource_names) +// for the appropriate value for this field. +func (r *ProjectsLocationsSecurityGatewaysService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *ProjectsLocationsSecurityGatewaysSetIamPolicyCall { + c := &ProjectsLocationsSecurityGatewaysSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.googleiamv1setiampolicyrequest = googleiamv1setiampolicyrequest 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 *ProjectsLocationsSecurityGatewaysCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsSecurityGatewaysCreateCall { +func (c *ProjectsLocationsSecurityGatewaysSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsSecurityGatewaysSetIamPolicyCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsSecurityGatewaysCreateCall) Context(ctx context.Context) *ProjectsLocationsSecurityGatewaysCreateCall { +func (c *ProjectsLocationsSecurityGatewaysSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsSecurityGatewaysSetIamPolicyCall { 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 *ProjectsLocationsSecurityGatewaysCreateCall) Header() http.Header { +func (c *ProjectsLocationsSecurityGatewaysSetIamPolicyCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsSecurityGatewaysCreateCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsSecurityGatewaysSetIamPolicyCall) 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.googlecloudbeyondcorpsecuritygatewaysv1alphasecuritygateway) + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleiamv1setiampolicyrequest) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+parent}/securityGateways") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+resource}:setIamPolicy") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -17521,18 +19295,18 @@ func (c *ProjectsLocationsSecurityGatewaysCreateCall) doRequest(alt string) (*ht } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, + "resource": c.resource, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "beyondcorp.projects.locations.securityGateways.create" call. +// Do executes the "beyondcorp.projects.locations.securityGateways.setIamPolicy" 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 *ProjectsLocationsSecurityGatewaysCreateCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +// *GoogleIamV1Policy.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 *ProjectsLocationsSecurityGatewaysSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -17551,7 +19325,7 @@ func (c *ProjectsLocationsSecurityGatewaysCreateCall) Do(opts ...googleapi.CallO if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &GoogleIamV1Policy{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -17564,97 +19338,84 @@ func (c *ProjectsLocationsSecurityGatewaysCreateCall) Do(opts ...googleapi.CallO return ret, nil } -type ProjectsLocationsSecurityGatewaysDeleteCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsSecurityGatewaysTestIamPermissionsCall struct { + s *Service + resource string + googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Delete: Deletes a single SecurityGateway. +// TestIamPermissions: Returns permissions that a caller has on the specified +// resource. If the resource does not exist, this will return an empty set of +// permissions, not a `NOT_FOUND` error. Note: This operation is designed to be +// used for building permission-aware UIs and command-line tools, not for +// authorization checking. This operation may "fail open" without warning. // -// - name: BeyondCorp SecurityGateway name using the form: -// `projects/{project_id}/locations/{location_id}/securityGateways/{security_g -// ateway_id}`. -func (r *ProjectsLocationsSecurityGatewaysService) Delete(name string) *ProjectsLocationsSecurityGatewaysDeleteCall { - c := &ProjectsLocationsSecurityGatewaysDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - return c -} - -// RequestId sets the optional parameter "requestId": An optional request ID to -// identify requests. Specify a unique request ID so that if you must retry -// your request, the server will know to ignore the request if it has already -// been completed. The server will guarantee that for at least 60 minutes after -// the first request. For example, consider a situation where you make an -// initial request and the request times out. If you make the request again -// with the same request ID, the server can check if original operation with -// the same request ID was received, and if so, will ignore the second request. -// This prevents clients from accidentally creating duplicate commitments. The -// request ID must be a valid UUID with the exception that zero UUID is not -// supported (00000000-0000-0000-0000-000000000000). -func (c *ProjectsLocationsSecurityGatewaysDeleteCall) RequestId(requestId string) *ProjectsLocationsSecurityGatewaysDeleteCall { - c.urlParams_.Set("requestId", requestId) - return c -} - -// ValidateOnly sets the optional parameter "validateOnly": If set, validates -// request by executing a dry-run which would not alter the resource in any -// way. -func (c *ProjectsLocationsSecurityGatewaysDeleteCall) ValidateOnly(validateOnly bool) *ProjectsLocationsSecurityGatewaysDeleteCall { - c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) +// - resource: REQUIRED: The resource for which the policy detail is being +// requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the appropriate +// value for this field. +func (r *ProjectsLocationsSecurityGatewaysService) TestIamPermissions(resource string, googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest) *ProjectsLocationsSecurityGatewaysTestIamPermissionsCall { + c := &ProjectsLocationsSecurityGatewaysTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.googleiamv1testiampermissionsrequest = googleiamv1testiampermissionsrequest 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 *ProjectsLocationsSecurityGatewaysDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsSecurityGatewaysDeleteCall { +func (c *ProjectsLocationsSecurityGatewaysTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsSecurityGatewaysTestIamPermissionsCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsSecurityGatewaysDeleteCall) Context(ctx context.Context) *ProjectsLocationsSecurityGatewaysDeleteCall { +func (c *ProjectsLocationsSecurityGatewaysTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsSecurityGatewaysTestIamPermissionsCall { 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 *ProjectsLocationsSecurityGatewaysDeleteCall) Header() http.Header { +func (c *ProjectsLocationsSecurityGatewaysTestIamPermissionsCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsSecurityGatewaysDeleteCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) +func (c *ProjectsLocationsSecurityGatewaysTestIamPermissionsCall) 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.googleiamv1testiampermissionsrequest) + if err != nil { + return nil, err + } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+resource}:testIamPermissions") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("DELETE", urls, body) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "resource": c.resource, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "beyondcorp.projects.locations.securityGateways.delete" call. +// Do executes the "beyondcorp.projects.locations.securityGateways.testIamPermissions" 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 +// *GoogleIamV1TestIamPermissionsResponse.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 *ProjectsLocationsSecurityGatewaysDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsSecurityGatewaysTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1TestIamPermissionsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -17673,7 +19434,7 @@ func (c *ProjectsLocationsSecurityGatewaysDeleteCall) Do(opts ...googleapi.CallO if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &GoogleIamV1TestIamPermissionsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -17686,68 +19447,78 @@ func (c *ProjectsLocationsSecurityGatewaysDeleteCall) Do(opts ...googleapi.CallO return ret, nil } -type ProjectsLocationsSecurityGatewaysGetCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsSecurityGatewaysApplicationsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Get: Gets details of a single SecurityGateway. +// Delete: Deletes a single Application. // -// - name: The resource name of the PartnerTenant using the form: -// `projects/{project_id}/locations/{location_id}/securityGateway/{security_ga -// teway_id}`. -func (r *ProjectsLocationsSecurityGatewaysService) Get(name string) *ProjectsLocationsSecurityGatewaysGetCall { - c := &ProjectsLocationsSecurityGatewaysGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: Name of the resource. +func (r *ProjectsLocationsSecurityGatewaysApplicationsService) Delete(name string) *ProjectsLocationsSecurityGatewaysApplicationsDeleteCall { + c := &ProjectsLocationsSecurityGatewaysApplicationsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } +// RequestId sets the optional parameter "requestId": An optional request ID to +// identify requests. Specify a unique request ID so that if you must retry +// your request, the server will know to ignore the request if it has already +// been completed. The server will guarantee that for at least 60 minutes after +// the first request. For example, consider a situation where you make an +// initial request and the request times out. If you make the request again +// with the same request ID, the server can check if original operation with +// the same request ID was received, and if so, will ignore the second request. +// This prevents clients from accidentally creating duplicate commitments. The +// request ID must be a valid UUID with the exception that zero UUID is not +// supported (00000000-0000-0000-0000-000000000000). +func (c *ProjectsLocationsSecurityGatewaysApplicationsDeleteCall) RequestId(requestId string) *ProjectsLocationsSecurityGatewaysApplicationsDeleteCall { + c.urlParams_.Set("requestId", requestId) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": If set, validates +// request by executing a dry-run which would not alter the resource in any +// way. +func (c *ProjectsLocationsSecurityGatewaysApplicationsDeleteCall) ValidateOnly(validateOnly bool) *ProjectsLocationsSecurityGatewaysApplicationsDeleteCall { + c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) + 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 *ProjectsLocationsSecurityGatewaysGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsSecurityGatewaysGetCall { +func (c *ProjectsLocationsSecurityGatewaysApplicationsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsSecurityGatewaysApplicationsDeleteCall { 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 *ProjectsLocationsSecurityGatewaysGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsSecurityGatewaysGetCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsSecurityGatewaysGetCall) Context(ctx context.Context) *ProjectsLocationsSecurityGatewaysGetCall { +func (c *ProjectsLocationsSecurityGatewaysApplicationsDeleteCall) Context(ctx context.Context) *ProjectsLocationsSecurityGatewaysApplicationsDeleteCall { 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 *ProjectsLocationsSecurityGatewaysGetCall) Header() http.Header { +func (c *ProjectsLocationsSecurityGatewaysApplicationsDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsSecurityGatewaysGetCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsSecurityGatewaysApplicationsDeleteCall) 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, "v1alpha/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, body) + req, err := http.NewRequest("DELETE", urls, body) if err != nil { return nil, err } @@ -17758,13 +19529,13 @@ func (c *ProjectsLocationsSecurityGatewaysGetCall) doRequest(alt string) (*http. return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "beyondcorp.projects.locations.securityGateways.get" call. +// Do executes the "beyondcorp.projects.locations.securityGateways.applications.delete" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudBeyondcorpSecuritygatewaysV1alphaSecurityGateway.ServerResponse.H -// eader 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 *ProjectsLocationsSecurityGatewaysGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudBeyondcorpSecuritygatewaysV1alphaSecurityGateway, error) { +// *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 *ProjectsLocationsSecurityGatewaysApplicationsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -17783,7 +19554,7 @@ func (c *ProjectsLocationsSecurityGatewaysGetCall) Do(opts ...googleapi.CallOpti if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudBeyondcorpSecuritygatewaysV1alphaSecurityGateway{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -17796,48 +19567,30 @@ func (c *ProjectsLocationsSecurityGatewaysGetCall) Do(opts ...googleapi.CallOpti return ret, nil } -type ProjectsLocationsSecurityGatewaysGetIamPolicyCall struct { +type ProjectsLocationsSecurityGatewaysApplicationsGetCall struct { s *Service - resource string + name string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } -// GetIamPolicy: Gets the access control policy for a resource. Returns an -// empty policy if the resource exists and does not have a policy set. +// Get: Gets details of a single Application. // -// - resource: REQUIRED: The resource for which the policy is being requested. -// See Resource names (https://cloud.google.com/apis/design/resource_names) -// for the appropriate value for this field. -func (r *ProjectsLocationsSecurityGatewaysService) GetIamPolicy(resource string) *ProjectsLocationsSecurityGatewaysGetIamPolicyCall { - c := &ProjectsLocationsSecurityGatewaysGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - return c -} - -// OptionsRequestedPolicyVersion sets the optional parameter -// "options.requestedPolicyVersion": The maximum policy version that will be -// used to format the policy. Valid values are 0, 1, and 3. Requests specifying -// an invalid value will be rejected. Requests for policies with any -// conditional role bindings must specify version 3. Policies with no -// conditional role bindings may specify any valid value or leave the field -// unset. The policy in the response might use the policy version that you -// specified, or it might use a lower policy version. For example, if you -// specify version 3, but the policy has no conditional role bindings, the -// response uses version 1. To learn which resources support conditions in -// their IAM policies, see the IAM documentation -// (https://cloud.google.com/iam/help/conditions/resource-policies). -func (c *ProjectsLocationsSecurityGatewaysGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsSecurityGatewaysGetIamPolicyCall { - c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) +// - name: The resource name of the Application using the form: +// `projects/{project_id}/locations/global/securityGateway/{security_gateway_i +// d}/applications/{application_id}`. +func (r *ProjectsLocationsSecurityGatewaysApplicationsService) Get(name string) *ProjectsLocationsSecurityGatewaysApplicationsGetCall { + c := &ProjectsLocationsSecurityGatewaysApplicationsGetCall{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 *ProjectsLocationsSecurityGatewaysGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsSecurityGatewaysGetIamPolicyCall { +func (c *ProjectsLocationsSecurityGatewaysApplicationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsSecurityGatewaysApplicationsGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -17845,27 +19598,27 @@ func (c *ProjectsLocationsSecurityGatewaysGetIamPolicyCall) Fields(s ...googleap // 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 *ProjectsLocationsSecurityGatewaysGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsSecurityGatewaysGetIamPolicyCall { +func (c *ProjectsLocationsSecurityGatewaysApplicationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsSecurityGatewaysApplicationsGetCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsSecurityGatewaysGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsSecurityGatewaysGetIamPolicyCall { +func (c *ProjectsLocationsSecurityGatewaysApplicationsGetCall) Context(ctx context.Context) *ProjectsLocationsSecurityGatewaysApplicationsGetCall { 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 *ProjectsLocationsSecurityGatewaysGetIamPolicyCall) Header() http.Header { +func (c *ProjectsLocationsSecurityGatewaysApplicationsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsSecurityGatewaysGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsSecurityGatewaysApplicationsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) @@ -17873,7 +19626,7 @@ func (c *ProjectsLocationsSecurityGatewaysGetIamPolicyCall) doRequest(alt string var body io.Reader = nil c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+resource}:getIamPolicy") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, body) if err != nil { @@ -17881,18 +19634,18 @@ func (c *ProjectsLocationsSecurityGatewaysGetIamPolicyCall) doRequest(alt string } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, + "name": c.name, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "beyondcorp.projects.locations.securityGateways.getIamPolicy" call. +// Do executes the "beyondcorp.projects.locations.securityGateways.applications.get" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleIamV1Policy.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 *ProjectsLocationsSecurityGatewaysGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { +// *GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplication.ServerResponse.Heade +// r 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 *ProjectsLocationsSecurityGatewaysApplicationsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplication, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -17911,7 +19664,7 @@ func (c *ProjectsLocationsSecurityGatewaysGetIamPolicyCall) Do(opts ...googleapi if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleIamV1Policy{ + ret := &GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplication{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -17924,7 +19677,7 @@ func (c *ProjectsLocationsSecurityGatewaysGetIamPolicyCall) Do(opts ...googleapi return ret, nil } -type ProjectsLocationsSecurityGatewaysListCall struct { +type ProjectsLocationsSecurityGatewaysApplicationsListCall struct { s *Service parent string urlParams_ gensupport.URLParams @@ -17933,22 +19686,23 @@ type ProjectsLocationsSecurityGatewaysListCall struct { header_ http.Header } -// List: Lists SecurityGateways in a given project and location. +// List: Lists Applications in a given project and location. // // - parent: The parent location to which the resources belong. -// `projects/{project_id}/locations/{location_id}/`. -func (r *ProjectsLocationsSecurityGatewaysService) List(parent string) *ProjectsLocationsSecurityGatewaysListCall { - c := &ProjectsLocationsSecurityGatewaysListCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// `projects/{project_id}/locations/global/securityGateways/{security_gateway_ +// id}`. +func (r *ProjectsLocationsSecurityGatewaysApplicationsService) List(parent string) *ProjectsLocationsSecurityGatewaysApplicationsListCall { + c := &ProjectsLocationsSecurityGatewaysApplicationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent return c } // Filter sets the optional parameter "filter": A filter specifying constraints -// of a list operation. All fields in the SecurityGateway message are -// supported. For example, the following query will return the SecurityGateway -// with displayName "test-security-gateway" For more information, please refer -// to https://google.aip.dev/160. -func (c *ProjectsLocationsSecurityGatewaysListCall) Filter(filter string) *ProjectsLocationsSecurityGatewaysListCall { +// of a list operation. All fields in the Hub message are supported. For +// example, the following query will return the Hub with displayName +// "test-application" For more information, please refer to +// https://google.aip.dev/160. +func (c *ProjectsLocationsSecurityGatewaysApplicationsListCall) Filter(filter string) *ProjectsLocationsSecurityGatewaysApplicationsListCall { c.urlParams_.Set("filter", filter) return c } @@ -17957,7 +19711,7 @@ func (c *ProjectsLocationsSecurityGatewaysListCall) Filter(filter string) *Proje // results. See Sorting order // (https://cloud.google.com/apis/design/design_patterns#sorting_order) for // more information. -func (c *ProjectsLocationsSecurityGatewaysListCall) OrderBy(orderBy string) *ProjectsLocationsSecurityGatewaysListCall { +func (c *ProjectsLocationsSecurityGatewaysApplicationsListCall) OrderBy(orderBy string) *ProjectsLocationsSecurityGatewaysApplicationsListCall { c.urlParams_.Set("orderBy", orderBy) return c } @@ -17967,14 +19721,14 @@ func (c *ProjectsLocationsSecurityGatewaysListCall) OrderBy(orderBy string) *Pro // service. Regardless of the page_size value, the response may include a // partial list and a caller should only rely on response's next_page_token to // determine if there are more instances left to be queried. -func (c *ProjectsLocationsSecurityGatewaysListCall) PageSize(pageSize int64) *ProjectsLocationsSecurityGatewaysListCall { +func (c *ProjectsLocationsSecurityGatewaysApplicationsListCall) PageSize(pageSize int64) *ProjectsLocationsSecurityGatewaysApplicationsListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c } // PageToken sets the optional parameter "pageToken": The next_page_token value -// returned from a previous ListSecurityGatewayRequest, if any. -func (c *ProjectsLocationsSecurityGatewaysListCall) PageToken(pageToken string) *ProjectsLocationsSecurityGatewaysListCall { +// returned from a previous ListHubsRequest, if any. +func (c *ProjectsLocationsSecurityGatewaysApplicationsListCall) PageToken(pageToken string) *ProjectsLocationsSecurityGatewaysApplicationsListCall { c.urlParams_.Set("pageToken", pageToken) return c } @@ -17982,7 +19736,7 @@ func (c *ProjectsLocationsSecurityGatewaysListCall) PageToken(pageToken string) // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsSecurityGatewaysListCall) Fields(s ...googleapi.Field) *ProjectsLocationsSecurityGatewaysListCall { +func (c *ProjectsLocationsSecurityGatewaysApplicationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsSecurityGatewaysApplicationsListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -17990,27 +19744,27 @@ func (c *ProjectsLocationsSecurityGatewaysListCall) Fields(s ...googleapi.Field) // 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 *ProjectsLocationsSecurityGatewaysListCall) IfNoneMatch(entityTag string) *ProjectsLocationsSecurityGatewaysListCall { +func (c *ProjectsLocationsSecurityGatewaysApplicationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsSecurityGatewaysApplicationsListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsSecurityGatewaysListCall) Context(ctx context.Context) *ProjectsLocationsSecurityGatewaysListCall { +func (c *ProjectsLocationsSecurityGatewaysApplicationsListCall) Context(ctx context.Context) *ProjectsLocationsSecurityGatewaysApplicationsListCall { 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 *ProjectsLocationsSecurityGatewaysListCall) Header() http.Header { +func (c *ProjectsLocationsSecurityGatewaysApplicationsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsSecurityGatewaysListCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsSecurityGatewaysApplicationsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) @@ -18018,7 +19772,7 @@ func (c *ProjectsLocationsSecurityGatewaysListCall) doRequest(alt string) (*http var body io.Reader = nil c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+parent}/securityGateways") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+parent}/applications") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, body) if err != nil { @@ -18031,13 +19785,13 @@ func (c *ProjectsLocationsSecurityGatewaysListCall) doRequest(alt string) (*http return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "beyondcorp.projects.locations.securityGateways.list" call. +// Do executes the "beyondcorp.projects.locations.securityGateways.applications.list" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudBeyondcorpSecuritygatewaysV1alphaListSecurityGatewaysResponse.Ser -// verResponse.Header or (if a response was returned at all) in +// *GoogleCloudBeyondcorpSecuritygatewaysV1alphaListApplicationsResponse.ServerR +// esponse.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 *ProjectsLocationsSecurityGatewaysListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudBeyondcorpSecuritygatewaysV1alphaListSecurityGatewaysResponse, error) { +func (c *ProjectsLocationsSecurityGatewaysApplicationsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudBeyondcorpSecuritygatewaysV1alphaListApplicationsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -18056,7 +19810,7 @@ func (c *ProjectsLocationsSecurityGatewaysListCall) Do(opts ...googleapi.CallOpt if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudBeyondcorpSecuritygatewaysV1alphaListSecurityGatewaysResponse{ + ret := &GoogleCloudBeyondcorpSecuritygatewaysV1alphaListApplicationsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -18072,7 +19826,7 @@ func (c *ProjectsLocationsSecurityGatewaysListCall) Do(opts ...googleapi.CallOpt // Pages invokes f for each page of results. // A non-nil error returned from f will halt the iteration. // The provided context supersedes any context provided to the Context method. -func (c *ProjectsLocationsSecurityGatewaysListCall) Pages(ctx context.Context, f func(*GoogleCloudBeyondcorpSecuritygatewaysV1alphaListSecurityGatewaysResponse) error) error { +func (c *ProjectsLocationsSecurityGatewaysApplicationsListCall) Pages(ctx context.Context, f func(*GoogleCloudBeyondcorpSecuritygatewaysV1alphaListApplicationsResponse) error) error { c.ctx_ = ctx defer c.PageToken(c.urlParams_.Get("pageToken")) for { @@ -18090,22 +19844,20 @@ func (c *ProjectsLocationsSecurityGatewaysListCall) Pages(ctx context.Context, f } } -type ProjectsLocationsSecurityGatewaysPatchCall struct { - s *Service - name string - googlecloudbeyondcorpsecuritygatewaysv1alphasecuritygateway *GoogleCloudBeyondcorpSecuritygatewaysV1alphaSecurityGateway - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsSecurityGatewaysHubsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Patch: Updates the parameters of a single SecurityGateway. +// Delete: Deletes a single Hub. // -// - name: Identifier. Name of the resource. -func (r *ProjectsLocationsSecurityGatewaysService) Patch(name string, googlecloudbeyondcorpsecuritygatewaysv1alphasecuritygateway *GoogleCloudBeyondcorpSecuritygatewaysV1alphaSecurityGateway) *ProjectsLocationsSecurityGatewaysPatchCall { - c := &ProjectsLocationsSecurityGatewaysPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: Name of the resource. +func (r *ProjectsLocationsSecurityGatewaysHubsService) Delete(name string) *ProjectsLocationsSecurityGatewaysHubsDeleteCall { + c := &ProjectsLocationsSecurityGatewaysHubsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name - c.googlecloudbeyondcorpsecuritygatewaysv1alphasecuritygateway = googlecloudbeyondcorpsecuritygatewaysv1alphasecuritygateway return c } @@ -18114,59 +19866,56 @@ func (r *ProjectsLocationsSecurityGatewaysService) Patch(name string, googleclou // your request, the server will know to ignore the request if it has already // been completed. The server will guarantee that for at least 60 minutes after // the first request. For example, consider a situation where you make an -// initial request and the request timed out. If you make the request again +// initial request and the request times out. If you make the request again // with the same request ID, the server can check if original operation with // the same request ID was received, and if so, will ignore the second request. // This prevents clients from accidentally creating duplicate commitments. The // request ID must be a valid UUID with the exception that zero UUID is not // supported (00000000-0000-0000-0000-000000000000). -func (c *ProjectsLocationsSecurityGatewaysPatchCall) RequestId(requestId string) *ProjectsLocationsSecurityGatewaysPatchCall { +func (c *ProjectsLocationsSecurityGatewaysHubsDeleteCall) RequestId(requestId string) *ProjectsLocationsSecurityGatewaysHubsDeleteCall { c.urlParams_.Set("requestId", requestId) return c } -// UpdateMask sets the optional parameter "updateMask": Required. Mutable -// fields include: display_name, gateway_regions. -func (c *ProjectsLocationsSecurityGatewaysPatchCall) UpdateMask(updateMask string) *ProjectsLocationsSecurityGatewaysPatchCall { - c.urlParams_.Set("updateMask", updateMask) +// ValidateOnly sets the optional parameter "validateOnly": If set, validates +// request by executing a dry-run which would not alter the resource in any +// way. +func (c *ProjectsLocationsSecurityGatewaysHubsDeleteCall) ValidateOnly(validateOnly bool) *ProjectsLocationsSecurityGatewaysHubsDeleteCall { + c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) 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 *ProjectsLocationsSecurityGatewaysPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsSecurityGatewaysPatchCall { +func (c *ProjectsLocationsSecurityGatewaysHubsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsSecurityGatewaysHubsDeleteCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsSecurityGatewaysPatchCall) Context(ctx context.Context) *ProjectsLocationsSecurityGatewaysPatchCall { +func (c *ProjectsLocationsSecurityGatewaysHubsDeleteCall) Context(ctx context.Context) *ProjectsLocationsSecurityGatewaysHubsDeleteCall { 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 *ProjectsLocationsSecurityGatewaysPatchCall) Header() http.Header { +func (c *ProjectsLocationsSecurityGatewaysHubsDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsSecurityGatewaysPatchCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) +func (c *ProjectsLocationsSecurityGatewaysHubsDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) var body io.Reader = nil - body, err := googleapi.WithoutDataWrapper.JSONReader(c.googlecloudbeyondcorpsecuritygatewaysv1alphasecuritygateway) - if err != nil { - return nil, err - } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("PATCH", urls, body) + req, err := http.NewRequest("DELETE", urls, body) if err != nil { return nil, err } @@ -18177,13 +19926,13 @@ func (c *ProjectsLocationsSecurityGatewaysPatchCall) doRequest(alt string) (*htt return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "beyondcorp.projects.locations.securityGateways.patch" call. +// Do executes the "beyondcorp.projects.locations.securityGateways.hubs.delete" 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 *ProjectsLocationsSecurityGatewaysPatchCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsSecurityGatewaysHubsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -18215,81 +19964,85 @@ func (c *ProjectsLocationsSecurityGatewaysPatchCall) Do(opts ...googleapi.CallOp return ret, nil } -type ProjectsLocationsSecurityGatewaysSetIamPolicyCall struct { - s *Service - resource string - googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsSecurityGatewaysHubsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// SetIamPolicy: Sets the access control policy on the specified resource. -// Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, -// and `PERMISSION_DENIED` errors. +// Get: Gets details of a single Hub. // -// - resource: REQUIRED: The resource for which the policy is being specified. -// See Resource names (https://cloud.google.com/apis/design/resource_names) -// for the appropriate value for this field. -func (r *ProjectsLocationsSecurityGatewaysService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *ProjectsLocationsSecurityGatewaysSetIamPolicyCall { - c := &ProjectsLocationsSecurityGatewaysSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.googleiamv1setiampolicyrequest = googleiamv1setiampolicyrequest +// - name: The resource name of the Hub using the form: +// `projects/{project_id}/locations/global/securityGateway/{security_gateway_i +// d}/hubs/{hub_id}`. +func (r *ProjectsLocationsSecurityGatewaysHubsService) Get(name string) *ProjectsLocationsSecurityGatewaysHubsGetCall { + c := &ProjectsLocationsSecurityGatewaysHubsGetCall{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 *ProjectsLocationsSecurityGatewaysSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsSecurityGatewaysSetIamPolicyCall { +func (c *ProjectsLocationsSecurityGatewaysHubsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsSecurityGatewaysHubsGetCall { 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 *ProjectsLocationsSecurityGatewaysHubsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsSecurityGatewaysHubsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsSecurityGatewaysSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsSecurityGatewaysSetIamPolicyCall { +func (c *ProjectsLocationsSecurityGatewaysHubsGetCall) Context(ctx context.Context) *ProjectsLocationsSecurityGatewaysHubsGetCall { 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 *ProjectsLocationsSecurityGatewaysSetIamPolicyCall) Header() http.Header { +func (c *ProjectsLocationsSecurityGatewaysHubsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsSecurityGatewaysSetIamPolicyCall) 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.googleiamv1setiampolicyrequest) - if err != nil { - return nil, err +func (c *ProjectsLocationsSecurityGatewaysHubsGetCall) 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, "v1alpha/{+resource}:setIamPolicy") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("GET", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, + "name": c.name, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "beyondcorp.projects.locations.securityGateways.setIamPolicy" call. +// Do executes the "beyondcorp.projects.locations.securityGateways.hubs.get" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleIamV1Policy.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 *ProjectsLocationsSecurityGatewaysSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { +// *GoogleCloudBeyondcorpSecuritygatewaysV1alphaHub.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 *ProjectsLocationsSecurityGatewaysHubsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudBeyondcorpSecuritygatewaysV1alphaHub, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -18308,7 +20061,7 @@ func (c *ProjectsLocationsSecurityGatewaysSetIamPolicyCall) Do(opts ...googleapi if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleIamV1Policy{ + ret := &GoogleCloudBeyondcorpSecuritygatewaysV1alphaHub{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -18321,84 +20074,120 @@ func (c *ProjectsLocationsSecurityGatewaysSetIamPolicyCall) Do(opts ...googleapi return ret, nil } -type ProjectsLocationsSecurityGatewaysTestIamPermissionsCall struct { - s *Service - resource string - googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsSecurityGatewaysHubsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// TestIamPermissions: Returns permissions that a caller has on the specified -// resource. If the resource does not exist, this will return an empty set of -// permissions, not a `NOT_FOUND` error. Note: This operation is designed to be -// used for building permission-aware UIs and command-line tools, not for -// authorization checking. This operation may "fail open" without warning. +// List: Lists Hubs in a given project and location. // -// - resource: REQUIRED: The resource for which the policy detail is being -// requested. See Resource names -// (https://cloud.google.com/apis/design/resource_names) for the appropriate -// value for this field. -func (r *ProjectsLocationsSecurityGatewaysService) TestIamPermissions(resource string, googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest) *ProjectsLocationsSecurityGatewaysTestIamPermissionsCall { - c := &ProjectsLocationsSecurityGatewaysTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.googleiamv1testiampermissionsrequest = googleiamv1testiampermissionsrequest +// - parent: The parent location to which the resources belong. +// `projects/{project_id}/locations/global/securityGateways/{security_gateway_ +// id}`. +func (r *ProjectsLocationsSecurityGatewaysHubsService) List(parent string) *ProjectsLocationsSecurityGatewaysHubsListCall { + c := &ProjectsLocationsSecurityGatewaysHubsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Filter sets the optional parameter "filter": A filter specifying constraints +// of a list operation. All fields in the Hub message are supported. For +// example, the following query will return the Hub with displayName "test-hub" +// For more information, please refer to https://google.aip.dev/160. +func (c *ProjectsLocationsSecurityGatewaysHubsListCall) Filter(filter string) *ProjectsLocationsSecurityGatewaysHubsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// OrderBy sets the optional parameter "orderBy": Specifies the ordering of +// results. See Sorting order +// (https://cloud.google.com/apis/design/design_patterns#sorting_order) for +// more information. +func (c *ProjectsLocationsSecurityGatewaysHubsListCall) OrderBy(orderBy string) *ProjectsLocationsSecurityGatewaysHubsListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number of items +// to return. If not specified, a default value of 50 will be used by the +// service. Regardless of the page_size value, the response may include a +// partial list and a caller should only rely on response's next_page_token to +// determine if there are more instances left to be queried. +func (c *ProjectsLocationsSecurityGatewaysHubsListCall) PageSize(pageSize int64) *ProjectsLocationsSecurityGatewaysHubsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The next_page_token value +// returned from a previous ListHubsRequest, if any. +func (c *ProjectsLocationsSecurityGatewaysHubsListCall) PageToken(pageToken string) *ProjectsLocationsSecurityGatewaysHubsListCall { + c.urlParams_.Set("pageToken", pageToken) 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 *ProjectsLocationsSecurityGatewaysTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsSecurityGatewaysTestIamPermissionsCall { +func (c *ProjectsLocationsSecurityGatewaysHubsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsSecurityGatewaysHubsListCall { 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 *ProjectsLocationsSecurityGatewaysHubsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsSecurityGatewaysHubsListCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsSecurityGatewaysTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsSecurityGatewaysTestIamPermissionsCall { +func (c *ProjectsLocationsSecurityGatewaysHubsListCall) Context(ctx context.Context) *ProjectsLocationsSecurityGatewaysHubsListCall { 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 *ProjectsLocationsSecurityGatewaysTestIamPermissionsCall) Header() http.Header { +func (c *ProjectsLocationsSecurityGatewaysHubsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsSecurityGatewaysTestIamPermissionsCall) 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.googleiamv1testiampermissionsrequest) - if err != nil { - return nil, err +func (c *ProjectsLocationsSecurityGatewaysHubsListCall) 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, "v1alpha/{+resource}:testIamPermissions") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+parent}/hubs") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("GET", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, + "parent": c.parent, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "beyondcorp.projects.locations.securityGateways.testIamPermissions" call. +// Do executes the "beyondcorp.projects.locations.securityGateways.hubs.list" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleIamV1TestIamPermissionsResponse.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 *ProjectsLocationsSecurityGatewaysTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1TestIamPermissionsResponse, error) { +// *GoogleCloudBeyondcorpSecuritygatewaysV1alphaListHubsResponse.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 *ProjectsLocationsSecurityGatewaysHubsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudBeyondcorpSecuritygatewaysV1alphaListHubsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -18417,7 +20206,7 @@ func (c *ProjectsLocationsSecurityGatewaysTestIamPermissionsCall) Do(opts ...goo if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleIamV1TestIamPermissionsResponse{ + ret := &GoogleCloudBeyondcorpSecuritygatewaysV1alphaListHubsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -18429,3 +20218,24 @@ func (c *ProjectsLocationsSecurityGatewaysTestIamPermissionsCall) Do(opts ...goo } return ret, nil } + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsLocationsSecurityGatewaysHubsListCall) Pages(ctx context.Context, f func(*GoogleCloudBeyondcorpSecuritygatewaysV1alphaListHubsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} diff --git a/bigquery/v2/bigquery-api.json b/bigquery/v2/bigquery-api.json index b6a49ff9ee8..e605d36ea5c 100644 --- a/bigquery/v2/bigquery-api.json +++ b/bigquery/v2/bigquery-api.json @@ -1935,7 +1935,7 @@ } } }, - "revision": "20240727", + "revision": "20240803", "rootUrl": "https://bigquery.googleapis.com/", "schemas": { "AggregateClassificationMetrics": { @@ -3076,6 +3076,17 @@ }, "type": "object" }, + "DataPolicyOption": { + "description": "Data policy option proto, it currently supports name only, will support precedence later.", + "id": "DataPolicyOption", + "properties": { + "name": { + "description": "Data policy resource name in the form of projects/project_id/locations/location_id/dataPolicies/data_policy_id.", + "type": "string" + } + }, + "type": "object" + }, "DataSplitResult": { "description": "Data split result. This contains references to the training and evaluation data tables that were used to train the model.", "id": "DataSplitResult", @@ -4574,35 +4585,6 @@ }, "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", @@ -8839,6 +8821,13 @@ "description": "Optional. Field collation can be set only when the type of field is STRING. The following values are supported: * 'und:ci': undetermined locale, case insensitive. * '': empty string. Default to case-sensitive behavior.", "type": "string" }, + "dataPolicies": { + "description": "Optional. Data policy options, will replace the data_policies.", + "items": { + "$ref": "DataPolicyOption" + }, + "type": "array" + }, "defaultValueExpression": { "description": "Optional. A SQL expression to specify the [default value] (https://cloud.google.com/bigquery/docs/default-values) for this field.", "type": "string" @@ -8858,10 +8847,6 @@ "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 a62207a9c8f..d536d84b4a7 100644 --- a/bigquery/v2/bigquery-gen.go +++ b/bigquery/v2/bigquery-gen.go @@ -1900,6 +1900,30 @@ func (s DataMaskingStatistics) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// DataPolicyOption: Data policy option proto, it currently supports name only, +// will support precedence later. +type DataPolicyOption struct { + // Name: Data policy resource name in the form of + // projects/project_id/locations/location_id/dataPolicies/data_policy_id. + 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 DataPolicyOption) MarshalJSON() ([]byte, error) { + type NoMethod DataPolicyOption + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // DataSplitResult: Data split result. This contains references to the training // and evaluation data tables that were used to train the model. type DataSplitResult struct { @@ -3874,44 +3898,6 @@ 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 { @@ -8994,6 +8980,8 @@ type TableFieldSchema struct { // locale, case insensitive. * '': empty string. Default to case-sensitive // behavior. Collation string `json:"collation,omitempty"` + // DataPolicies: Optional. Data policy options, will replace the data_policies. + DataPolicies []*DataPolicyOption `json:"dataPolicies,omitempty"` // DefaultValueExpression: Optional. A SQL expression to specify the [default // value] (https://cloud.google.com/bigquery/docs/default-values) for this // field. @@ -9008,10 +8996,6 @@ 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/bigtableadmin/v2/bigtableadmin-api.json b/bigtableadmin/v2/bigtableadmin-api.json index e2107c9aa05..2b0bed11f4a 100644 --- a/bigtableadmin/v2/bigtableadmin-api.json +++ b/bigtableadmin/v2/bigtableadmin-api.json @@ -2194,7 +2194,7 @@ } } }, - "revision": "20240720", + "revision": "20240806", "rootUrl": "https://bigtableadmin.googleapis.com/", "schemas": { "AppProfile": { @@ -2375,6 +2375,20 @@ "description": "A backup of a Cloud Bigtable table.", "id": "Backup", "properties": { + "backupType": { + "description": "Indicates the backup type of the backup.", + "enum": [ + "BACKUP_TYPE_UNSPECIFIED", + "STANDARD", + "HOT" + ], + "enumDescriptions": [ + "Not specified.", + "The default type for Cloud Bigtable managed backups. Supported for backups created in both HDD and SSD instances. Requires optimization when restored to a table in an SSD instance.", + "A backup type with faster restore to SSD performance. Only supported for backups created in SSD instances. A new SSD table restored from a hot backup reaches production performance more quickly than a standard backup." + ], + "type": "string" + }, "encryptionInfo": { "$ref": "EncryptionInfo", "description": "Output only. The encryption information for the backup.", @@ -2387,7 +2401,12 @@ "type": "string" }, "expireTime": { - "description": "Required. The expiration time of the backup. When creating a backup or updating its `expire_time`, the new value must: - Be at most 90 days in the future - Be at least 6 hours in the future Once the `expire_time` has passed, Cloud Bigtable will delete the backup.", + "description": "Required. The expiration time of the backup. When creating a backup or updating its `expire_time`, the value must be greater than the backup creation time by: - At least 6 hours - At most 90 days Once the `expire_time` has passed, Cloud Bigtable will delete the backup.", + "format": "google-datetime", + "type": "string" + }, + "hotToStandardTime": { + "description": "The time at which the hot backup will be converted to a standard backup. Once the `hot_to_standard_time` has passed, Cloud Bigtable will convert the hot backup to a standard backup. This value must be greater than the backup creation time by: - At least 24 hours This field only applies for hot backups. When creating or updating a standard backup, attempting to set this field will fail the request.", "format": "google-datetime", "type": "string" }, diff --git a/bigtableadmin/v2/bigtableadmin-gen.go b/bigtableadmin/v2/bigtableadmin-gen.go index ef60a791e61..b38db5571cd 100644 --- a/bigtableadmin/v2/bigtableadmin-gen.go +++ b/bigtableadmin/v2/bigtableadmin-gen.go @@ -591,16 +591,35 @@ func (s AutoscalingTargets) MarshalJSON() ([]byte, error) { // Backup: A backup of a Cloud Bigtable table. type Backup struct { + // BackupType: Indicates the backup type of the backup. + // + // Possible values: + // "BACKUP_TYPE_UNSPECIFIED" - Not specified. + // "STANDARD" - The default type for Cloud Bigtable managed backups. + // Supported for backups created in both HDD and SSD instances. Requires + // optimization when restored to a table in an SSD instance. + // "HOT" - A backup type with faster restore to SSD performance. Only + // supported for backups created in SSD instances. A new SSD table restored + // from a hot backup reaches production performance more quickly than a + // standard backup. + BackupType string `json:"backupType,omitempty"` // EncryptionInfo: Output only. The encryption information for the backup. EncryptionInfo *EncryptionInfo `json:"encryptionInfo,omitempty"` // EndTime: Output only. `end_time` is the time that the backup was finished. // The row data in the backup will be no newer than this timestamp. EndTime string `json:"endTime,omitempty"` // ExpireTime: Required. The expiration time of the backup. When creating a - // backup or updating its `expire_time`, the new value must: - Be at most 90 - // days in the future - Be at least 6 hours in the future Once the + // backup or updating its `expire_time`, the value must be greater than the + // backup creation time by: - At least 6 hours - At most 90 days Once the // `expire_time` has passed, Cloud Bigtable will delete the backup. ExpireTime string `json:"expireTime,omitempty"` + // HotToStandardTime: The time at which the hot backup will be converted to a + // standard backup. Once the `hot_to_standard_time` has passed, Cloud Bigtable + // will convert the hot backup to a standard backup. This value must be greater + // than the backup creation time by: - At least 24 hours This field only + // applies for hot backups. When creating or updating a standard backup, + // attempting to set this field will fail the request. + HotToStandardTime string `json:"hotToStandardTime,omitempty"` // Name: A globally unique identifier for the backup which cannot be changed. // Values are of the form // `projects/{project}/instances/{instance}/clusters/{cluster}/ @@ -634,15 +653,15 @@ type Backup struct { // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "EncryptionInfo") to + // ForceSendFields is a list of field names (e.g. "BackupType") 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. "EncryptionInfo") 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. "BackupType") 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:"-"` } diff --git a/chat/v1/chat-api.json b/chat/v1/chat-api.json index d566681f254..7262fc426f3 100644 --- a/chat/v1/chat-api.json +++ b/chat/v1/chat-api.json @@ -1241,7 +1241,7 @@ } } }, - "revision": "20240804", + "revision": "20240813", "rootUrl": "https://chat.googleapis.com/", "schemas": { "AccessSettings": { @@ -1862,7 +1862,7 @@ "description": "Represents information about the user's client, such as locale, host app, and platform. For Chat apps, `CommonEventObject` includes information submitted by users interacting with [dialogs](https://developers.google.com/workspace/chat/dialogs), like data entered on a card." }, "configCompleteRedirectUrl": { - "description": "The URL the Chat app should redirect the user to after they have completed an authorization or configuration flow outside of Google Chat. For more information, see [Connect a Chat app with other services \u0026 tools](https://developers.google.com/workspace/chat/connect-web-services-tools).", + "description": "For `MESSAGE` interaction events, the URL that users must be redirected to after they complete an authorization or configuration flow outside of Google Chat. For more information, see [Connect a Chat app with other services and tools](https://developers.google.com/workspace/chat/connect-web-services-tools).", "type": "string" }, "dialogEventType": { @@ -2227,8 +2227,8 @@ ], "enumDescriptions": [ "Don't use. Unspecified.", - "Default option. Render a solid divider between sections.", - "If set, no divider is rendered between sections." + "Default option. Render a solid divider.", + "If set, no divider is rendered. This style completely removes the divider from the layout. The result is equivalent to not adding a divider at all." ], "type": "string" }, @@ -4422,7 +4422,7 @@ "id": "Thread", "properties": { "name": { - "description": "Output only. Resource name of the thread. Example: `spaces/{space}/threads/{thread}`", + "description": "Resource name of the thread. Example: `spaces/{space}/threads/{thread}`", "type": "string" }, "threadKey": { diff --git a/chat/v1/chat-gen.go b/chat/v1/chat-gen.go index 0f9c0590608..48099c92680 100644 --- a/chat/v1/chat-gen.go +++ b/chat/v1/chat-gen.go @@ -1296,10 +1296,10 @@ type DeprecatedEvent struct { // (https://developers.google.com/workspace/chat/dialogs), like data entered on // a card. Common *CommonEventObject `json:"common,omitempty"` - // ConfigCompleteRedirectUrl: The URL the Chat app should redirect the user to - // after they have completed an authorization or configuration flow outside of - // Google Chat. For more information, see Connect a Chat app with other - // services & tools + // ConfigCompleteRedirectUrl: For `MESSAGE` interaction events, the URL that + // users must be redirected to after they complete an authorization or + // configuration flow outside of Google Chat. For more information, see Connect + // a Chat app with other services and tools // (https://developers.google.com/workspace/chat/connect-web-services-tools). ConfigCompleteRedirectUrl string `json:"configCompleteRedirectUrl,omitempty"` // DialogEventType: The type of dialog @@ -1888,8 +1888,10 @@ type GoogleAppsCardV1Card struct { // // Possible values: // "DIVIDER_STYLE_UNSPECIFIED" - Don't use. Unspecified. - // "SOLID_DIVIDER" - Default option. Render a solid divider between sections. - // "NO_DIVIDER" - If set, no divider is rendered between sections. + // "SOLID_DIVIDER" - Default option. Render a solid divider. + // "NO_DIVIDER" - If set, no divider is rendered. This style completely + // removes the divider from the layout. The result is equivalent to not adding + // a divider at all. SectionDividerStyle string `json:"sectionDividerStyle,omitempty"` // Sections: Contains a collection of widgets. Each section has its own, // optional header. Sections are visually separated by a line divider. For an @@ -5084,7 +5086,7 @@ func (s TextParagraph) MarshalJSON() ([]byte, error) { // (https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages/create#messagereplyoption) // field to determine what happens if no matching thread is found. type Thread struct { - // Name: Output only. Resource name of the thread. Example: + // Name: Resource name of the thread. Example: // `spaces/{space}/threads/{thread}` Name string `json:"name,omitempty"` // ThreadKey: Optional. Input for creating or updating a thread. Otherwise, diff --git a/chromemanagement/v1/chromemanagement-api.json b/chromemanagement/v1/chromemanagement-api.json index cc0f1d1c886..7668432689c 100644 --- a/chromemanagement/v1/chromemanagement-api.json +++ b/chromemanagement/v1/chromemanagement-api.json @@ -1104,7 +1104,7 @@ "type": "string" }, "readMask": { - "description": "Read mask to specify which fields to return. Supported read_mask paths are: - name - org_unit_id - user_id - user_email - user_device.device_id - user_device.audio_status_report - user_device.device_activity_report - user_device.network_bandwidth_report - user_device.peripherals_report ", + "description": "Read mask to specify which fields to return. Supported read_mask paths are: - name - org_unit_id - user_id - user_email - user_device.device_id - user_device.audio_status_report - user_device.device_activity_report - user_device.network_bandwidth_report - user_device.peripherals_report - user_device.app_report ", "format": "google-fieldmask", "location": "query", "type": "string" @@ -1151,7 +1151,7 @@ "type": "string" }, "readMask": { - "description": "Read mask to specify which fields to return. Supported read_mask paths are: - name - org_unit_id - user_id - user_email - user_device.device_id - user_device.audio_status_report - user_device.device_activity_report - user_device.network_bandwidth_report - user_device.peripherals_report ", + "description": "Read mask to specify which fields to return. Supported read_mask paths are: - name - org_unit_id - user_id - user_email - user_device.device_id - user_device.audio_status_report - user_device.device_activity_report - user_device.network_bandwidth_report - user_device.peripherals_report - user_device.app_report ", "format": "google-fieldmask", "location": "query", "type": "string" @@ -1172,7 +1172,7 @@ } } }, - "revision": "20240709", + "revision": "20240815", "rootUrl": "https://chromemanagement.googleapis.com/", "schemas": { "GoogleChromeManagementV1AndroidAppInfo": { diff --git a/chromemanagement/v1/chromemanagement-gen.go b/chromemanagement/v1/chromemanagement-gen.go index 9dd2e8e5d59..4bb53a28a9b 100644 --- a/chromemanagement/v1/chromemanagement-gen.go +++ b/chromemanagement/v1/chromemanagement-gen.go @@ -7311,7 +7311,8 @@ func (r *CustomersTelemetryUsersService) Get(name string) *CustomersTelemetryUse // fields to return. Supported read_mask paths are: - name - org_unit_id - // user_id - user_email - user_device.device_id - // user_device.audio_status_report - user_device.device_activity_report - -// user_device.network_bandwidth_report - user_device.peripherals_report +// user_device.network_bandwidth_report - user_device.peripherals_report - +// user_device.app_report func (c *CustomersTelemetryUsersGetCall) ReadMask(readMask string) *CustomersTelemetryUsersGetCall { c.urlParams_.Set("readMask", readMask) return c @@ -7451,7 +7452,8 @@ func (c *CustomersTelemetryUsersListCall) PageToken(pageToken string) *Customers // fields to return. Supported read_mask paths are: - name - org_unit_id - // user_id - user_email - user_device.device_id - // user_device.audio_status_report - user_device.device_activity_report - -// user_device.network_bandwidth_report - user_device.peripherals_report +// user_device.network_bandwidth_report - user_device.peripherals_report - +// user_device.app_report func (c *CustomersTelemetryUsersListCall) ReadMask(readMask string) *CustomersTelemetryUsersListCall { c.urlParams_.Set("readMask", readMask) return c diff --git a/clouddeploy/v1/clouddeploy-api.json b/clouddeploy/v1/clouddeploy-api.json index bc82f14532a..384221014d1 100644 --- a/clouddeploy/v1/clouddeploy-api.json +++ b/clouddeploy/v1/clouddeploy-api.json @@ -2065,7 +2065,7 @@ } } }, - "revision": "20240728", + "revision": "20240809", "rootUrl": "https://clouddeploy.googleapis.com/", "schemas": { "AbandonReleaseRequest": { @@ -4602,7 +4602,7 @@ "type": "string" }, "destinationTargetId": { - "description": "Optional. The ID of the stage in the pipeline to which this `Release` is deploying. If unspecified, default it to the next stage in the promotion flow. The value of this field could be one of the following: * The last segment of a target name. It only needs the ID to determine if the target is one of the stages in the promotion sequence defined in the pipeline. * \"@next\", the next target in the promotion sequence.", + "description": "Optional. The ID of the stage in the pipeline to which this `Release` is deploying. If unspecified, default it to the next stage in the promotion flow. The value of this field could be one of the following: * The last segment of a target name * \"@next\", the next target in the promotion sequence", "type": "string" }, "id": { @@ -5995,7 +5995,7 @@ "id": "TargetAttribute", "properties": { "id": { - "description": "ID of the `Target`. The value of this field could be one of the following: * The last segment of a target name. It only needs the ID to determine which target is being referred to * \"*\", all targets in a location.", + "description": "ID of the `Target`. The value of this field could be one of the following: * The last segment of a target name * \"*\", all targets in a location", "type": "string" }, "labels": { diff --git a/clouddeploy/v1/clouddeploy-gen.go b/clouddeploy/v1/clouddeploy-gen.go index e57bcfdac94..6b8d31a8f48 100644 --- a/clouddeploy/v1/clouddeploy-gen.go +++ b/clouddeploy/v1/clouddeploy-gen.go @@ -3360,9 +3360,8 @@ type PromoteReleaseRule struct { // DestinationTargetId: Optional. The ID of the stage in the pipeline to which // this `Release` is deploying. If unspecified, default it to the next stage in // the promotion flow. The value of this field could be one of the following: * - // The last segment of a target name. It only needs the ID to determine if the - // target is one of the stages in the promotion sequence defined in the - // pipeline. * "@next", the next target in the promotion sequence. + // The last segment of a target name * "@next", the next target in the + // promotion sequence DestinationTargetId string `json:"destinationTargetId,omitempty"` // Id: Required. ID of the rule. This id must be unique in the `Automation` // resource to which this rule belongs. The format is @@ -4777,9 +4776,8 @@ func (s TargetArtifact) MarshalJSON() ([]byte, error) { // TargetAttribute: Contains criteria for selecting Targets. type TargetAttribute struct { // Id: ID of the `Target`. The value of this field could be one of the - // following: * The last segment of a target name. It only needs the ID to - // determine which target is being referred to * "*", all targets in a - // location. + // following: * The last segment of a target name * "*", all targets in a + // location Id string `json:"id,omitempty"` // Labels: Target labels. Labels map[string]string `json:"labels,omitempty"` diff --git a/cloudtasks/v2/cloudtasks-api.json b/cloudtasks/v2/cloudtasks-api.json index 7b8394e3dbf..4ae0911fb0b 100644 --- a/cloudtasks/v2/cloudtasks-api.json +++ b/cloudtasks/v2/cloudtasks-api.json @@ -779,7 +779,7 @@ } } }, - "revision": "20240223", + "revision": "20240808", "rootUrl": "https://cloudtasks.googleapis.com/", "schemas": { "AppEngineHttpRequest": { @@ -1164,11 +1164,11 @@ }, "oauthToken": { "$ref": "OAuthToken", - "description": "If specified, an [OAuth token](https://developers.google.com/identity/protocols/OAuth2) will be generated and attached as the `Authorization` header in the HTTP request. This type of authorization should generally only be used when calling Google APIs hosted on *.googleapis.com." + "description": "If specified, an [OAuth token](https://developers.google.com/identity/protocols/OAuth2) is generated and attached as the `Authorization` header in the HTTP request. This type of authorization should generally be used only when calling Google APIs hosted on *.googleapis.com. Note that both the service account email and the scope MUST be specified when using the queue-level authorization override." }, "oidcToken": { "$ref": "OidcToken", - "description": "If specified, an [OIDC](https://developers.google.com/identity/protocols/OpenIDConnect) token will be generated and attached as an `Authorization` header in the HTTP request. This type of authorization can be used for many scenarios, including calling Cloud Run, or endpoints where you intend to validate the token yourself." + "description": "If specified, an [OIDC](https://developers.google.com/identity/protocols/OpenIDConnect) token is generated and attached as an `Authorization` header in the HTTP request. This type of authorization can be used for many scenarios, including calling Cloud Run, or endpoints where you intend to validate the token yourself. Note that both the service account email and the audience MUST be specified when using the queue-level authorization override." }, "uriOverride": { "$ref": "UriOverride", diff --git a/cloudtasks/v2/cloudtasks-gen.go b/cloudtasks/v2/cloudtasks-gen.go index 2df53ac975e..6b2383e761b 100644 --- a/cloudtasks/v2/cloudtasks-gen.go +++ b/cloudtasks/v2/cloudtasks-gen.go @@ -984,16 +984,19 @@ type HttpTarget struct { // "OPTIONS" - HTTP OPTIONS HttpMethod string `json:"httpMethod,omitempty"` // OauthToken: If specified, an OAuth token - // (https://developers.google.com/identity/protocols/OAuth2) will be generated - // and attached as the `Authorization` header in the HTTP request. This type of - // authorization should generally only be used when calling Google APIs hosted - // on *.googleapis.com. + // (https://developers.google.com/identity/protocols/OAuth2) is generated and + // attached as the `Authorization` header in the HTTP request. This type of + // authorization should generally be used only when calling Google APIs hosted + // on *.googleapis.com. Note that both the service account email and the scope + // MUST be specified when using the queue-level authorization override. OauthToken *OAuthToken `json:"oauthToken,omitempty"` // OidcToken: If specified, an OIDC - // (https://developers.google.com/identity/protocols/OpenIDConnect) token will - // be generated and attached as an `Authorization` header in the HTTP request. + // (https://developers.google.com/identity/protocols/OpenIDConnect) token is + // generated and attached as an `Authorization` header in the HTTP request. // This type of authorization can be used for many scenarios, including calling // Cloud Run, or endpoints where you intend to validate the token yourself. + // Note that both the service account email and the audience MUST be specified + // when using the queue-level authorization override. OidcToken *OidcToken `json:"oidcToken,omitempty"` // UriOverride: URI override. When specified, overrides the execution URI for // all the tasks in the queue. diff --git a/cloudtasks/v2beta2/cloudtasks-api.json b/cloudtasks/v2beta2/cloudtasks-api.json index 4131263c9cb..3f86a2421a1 100644 --- a/cloudtasks/v2beta2/cloudtasks-api.json +++ b/cloudtasks/v2beta2/cloudtasks-api.json @@ -935,7 +935,7 @@ } } }, - "revision": "20240223", + "revision": "20240808", "rootUrl": "https://cloudtasks.googleapis.com/", "schemas": { "AcknowledgeTaskRequest": { @@ -1369,11 +1369,11 @@ }, "oauthToken": { "$ref": "OAuthToken", - "description": "If specified, an [OAuth token](https://developers.google.com/identity/protocols/OAuth2) will be generated and attached as an `Authorization` header in the HTTP request. This type of authorization should generally only be used when calling Google APIs hosted on *.googleapis.com." + "description": "If specified, an [OAuth token](https://developers.google.com/identity/protocols/OAuth2) is generated and attached as an `Authorization` header in the HTTP request. This type of authorization should generally be used only when calling Google APIs hosted on *.googleapis.com. Note that both the service account email and the scope MUST be specified when using the queue-level authorization override." }, "oidcToken": { "$ref": "OidcToken", - "description": "If specified, an [OIDC](https://developers.google.com/identity/protocols/OpenIDConnect) token will be generated and attached as an `Authorization` header in the HTTP request. This type of authorization can be used for many scenarios, including calling Cloud Run, or endpoints where you intend to validate the token yourself." + "description": "If specified, an [OIDC](https://developers.google.com/identity/protocols/OpenIDConnect) token is generated and attached as an `Authorization` header in the HTTP request. This type of authorization can be used for many scenarios, including calling Cloud Run, or endpoints where you intend to validate the token yourself. Note that both the service account email and the audience MUST be specified when using the queue-level authorization override." }, "uriOverride": { "$ref": "UriOverride", diff --git a/cloudtasks/v2beta2/cloudtasks-gen.go b/cloudtasks/v2beta2/cloudtasks-gen.go index 8272472ae77..c957b7e6ff0 100644 --- a/cloudtasks/v2beta2/cloudtasks-gen.go +++ b/cloudtasks/v2beta2/cloudtasks-gen.go @@ -1111,16 +1111,19 @@ type HttpTarget struct { // "OPTIONS" - HTTP OPTIONS HttpMethod string `json:"httpMethod,omitempty"` // OauthToken: If specified, an OAuth token - // (https://developers.google.com/identity/protocols/OAuth2) will be generated - // and attached as an `Authorization` header in the HTTP request. This type of - // authorization should generally only be used when calling Google APIs hosted - // on *.googleapis.com. + // (https://developers.google.com/identity/protocols/OAuth2) is generated and + // attached as an `Authorization` header in the HTTP request. This type of + // authorization should generally be used only when calling Google APIs hosted + // on *.googleapis.com. Note that both the service account email and the scope + // MUST be specified when using the queue-level authorization override. OauthToken *OAuthToken `json:"oauthToken,omitempty"` // OidcToken: If specified, an OIDC - // (https://developers.google.com/identity/protocols/OpenIDConnect) token will - // be generated and attached as an `Authorization` header in the HTTP request. + // (https://developers.google.com/identity/protocols/OpenIDConnect) token is + // generated and attached as an `Authorization` header in the HTTP request. // This type of authorization can be used for many scenarios, including calling // Cloud Run, or endpoints where you intend to validate the token yourself. + // Note that both the service account email and the audience MUST be specified + // when using the queue-level authorization override. OidcToken *OidcToken `json:"oidcToken,omitempty"` // UriOverride: Uri override. When specified, overrides the execution Uri for // all the tasks in the queue. diff --git a/cloudtasks/v2beta3/cloudtasks-api.json b/cloudtasks/v2beta3/cloudtasks-api.json index 8c84008e3dc..87f782a26fc 100644 --- a/cloudtasks/v2beta3/cloudtasks-api.json +++ b/cloudtasks/v2beta3/cloudtasks-api.json @@ -791,7 +791,7 @@ } } }, - "revision": "20240223", + "revision": "20240808", "rootUrl": "https://cloudtasks.googleapis.com/", "schemas": { "AppEngineHttpQueue": { @@ -1187,11 +1187,11 @@ }, "oauthToken": { "$ref": "OAuthToken", - "description": "If specified, an [OAuth token](https://developers.google.com/identity/protocols/OAuth2) will be generated and attached as the `Authorization` header in the HTTP request. This type of authorization should generally only be used when calling Google APIs hosted on *.googleapis.com." + "description": "If specified, an [OAuth token](https://developers.google.com/identity/protocols/OAuth2) is generated and attached as the `Authorization` header in the HTTP request. This type of authorization should generally be used only when calling Google APIs hosted on *.googleapis.com. Note that both the service account email and the scope MUST be specified when using the queue-level authorization override." }, "oidcToken": { "$ref": "OidcToken", - "description": "If specified, an [OIDC](https://developers.google.com/identity/protocols/OpenIDConnect) token will be generated and attached as an `Authorization` header in the HTTP request. This type of authorization can be used for many scenarios, including calling Cloud Run, or endpoints where you intend to validate the token yourself." + "description": "If specified, an [OIDC](https://developers.google.com/identity/protocols/OpenIDConnect) token is generated and attached as an `Authorization` header in the HTTP request. This type of authorization can be used for many scenarios, including calling Cloud Run, or endpoints where you intend to validate the token yourself. Note that both the service account email and the audience MUST be specified when using the queue-level authorization override." }, "uriOverride": { "$ref": "UriOverride", diff --git a/cloudtasks/v2beta3/cloudtasks-gen.go b/cloudtasks/v2beta3/cloudtasks-gen.go index 4dd9fde16ce..610f158e8a5 100644 --- a/cloudtasks/v2beta3/cloudtasks-gen.go +++ b/cloudtasks/v2beta3/cloudtasks-gen.go @@ -1012,16 +1012,19 @@ type HttpTarget struct { // "OPTIONS" - HTTP OPTIONS HttpMethod string `json:"httpMethod,omitempty"` // OauthToken: If specified, an OAuth token - // (https://developers.google.com/identity/protocols/OAuth2) will be generated - // and attached as the `Authorization` header in the HTTP request. This type of - // authorization should generally only be used when calling Google APIs hosted - // on *.googleapis.com. + // (https://developers.google.com/identity/protocols/OAuth2) is generated and + // attached as the `Authorization` header in the HTTP request. This type of + // authorization should generally be used only when calling Google APIs hosted + // on *.googleapis.com. Note that both the service account email and the scope + // MUST be specified when using the queue-level authorization override. OauthToken *OAuthToken `json:"oauthToken,omitempty"` // OidcToken: If specified, an OIDC - // (https://developers.google.com/identity/protocols/OpenIDConnect) token will - // be generated and attached as an `Authorization` header in the HTTP request. + // (https://developers.google.com/identity/protocols/OpenIDConnect) token is + // generated and attached as an `Authorization` header in the HTTP request. // This type of authorization can be used for many scenarios, including calling // Cloud Run, or endpoints where you intend to validate the token yourself. + // Note that both the service account email and the audience MUST be specified + // when using the queue-level authorization override. OidcToken *OidcToken `json:"oidcToken,omitempty"` // UriOverride: URI override. When specified, overrides the execution URI for // all the tasks in the queue. diff --git a/compute/v0.alpha/compute-api.json b/compute/v0.alpha/compute-api.json index 11980894ed0..17560ac82d8 100644 --- a/compute/v0.alpha/compute-api.json +++ b/compute/v0.alpha/compute-api.json @@ -29159,204 +29159,6 @@ } } }, - "regionMultiMigs": { - "methods": { - "delete": { - "description": "Deletes a regional multiMIG in the specified project.", - "flatPath": "projects/{project}/regions/{region}/multiMigs/{multiMig}", - "httpMethod": "DELETE", - "id": "compute.regionMultiMigs.delete", - "parameterOrder": [ - "project", - "region", - "multiMig" - ], - "parameters": { - "multiMig": { - "description": "Name of the multiMIG to delete.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "location": "path", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "location": "path", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "path": "projects/{project}/regions/{region}/multiMigs/{multiMig}", - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ] - }, - "get": { - "description": "Returns the specified MultiMIG resource.", - "flatPath": "projects/{project}/regions/{region}/multiMigs/{multiMig}", - "httpMethod": "GET", - "id": "compute.regionMultiMigs.get", - "parameterOrder": [ - "project", - "region", - "multiMig" - ], - "parameters": { - "multiMig": { - "description": "Name of the MultiMig resource to return.", - "location": "path", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "location": "path", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "location": "path", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "required": true, - "type": "string" - } - }, - "path": "projects/{project}/regions/{region}/multiMigs/{multiMig}", - "response": { - "$ref": "MultiMig" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ] - }, - "insert": { - "description": "Creates a regional multiMIG in the specified project.", - "flatPath": "projects/{project}/regions/{region}/multiMigs", - "httpMethod": "POST", - "id": "compute.regionMultiMigs.insert", - "parameterOrder": [ - "project", - "region" - ], - "parameters": { - "project": { - "description": "Project ID for this request.", - "location": "path", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "location": "path", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "path": "projects/{project}/regions/{region}/multiMigs", - "request": { - "$ref": "MultiMig" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ] - }, - "list": { - "description": "Retrieves a list of MultiMIGs in a project and region.", - "flatPath": "projects/{project}/regions/{region}/multiMigs", - "httpMethod": "GET", - "id": "compute.regionMultiMigs.list", - "parameterOrder": [ - "project", - "region" - ], - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "default": "500", - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "format": "uint32", - "location": "query", - "minimum": "0", - "type": "integer" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "location": "path", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "location": "path", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "path": "projects/{project}/regions/{region}/multiMigs", - "response": { - "$ref": "MultiMigsList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ] - } - } - }, "regionNetworkEndpointGroups": { "methods": { "attachNetworkEndpoints": { @@ -45278,7 +45080,7 @@ } } }, - "revision": "20240730", + "revision": "20240805", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -48691,7 +48493,7 @@ "type": "number" }, "name": { - "description": "Name of a custom utilization signal. The name must be 1-24 characters long, and comply with RFC1035. Specifically, the name must be 1-24 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. For usage guidelines, see Custom Metrics balancing mode. This field can only be used for a global or regional backend service with the loadBalancingScheme set to EXTERNAL_MANAGED, INTERNAL_MANAGED INTERNAL_SELF_MANAGED.", + "description": "Name of a custom utilization signal. The name must be 1-64 characters long, and comply with relaxed RFC1035. Specifically, the name must be 1-64 characters long and match the regular expression [a-z]([-_.a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, period, underscore, lowercase letter, or digit, except the last character, which cannot be a dash, period, or underscore. For usage guidelines, see Custom Metrics balancing mode. This field can only be used for a global or regional backend service with the loadBalancingScheme set to EXTERNAL_MANAGED, INTERNAL_MANAGED INTERNAL_SELF_MANAGED.", "type": "string" } }, @@ -55868,7 +55670,6 @@ }, "timestamp": { "description": "Timestamp when the matching usage was calculated", - "format": "google-datetime", "type": "string" } }, @@ -69832,286 +69633,6 @@ }, "type": "object" }, - "MultiMig": { - "description": "MultiMIG represents a group of Managed Instance Groups.", - "id": "MultiMig", - "properties": { - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "format": "uint64", - "type": "string" - }, - "kind": { - "default": "compute#multiMig", - "description": "[Output Only] Type of the resource. Always compute#multiMig for MultiMIGs.", - "type": "string" - }, - "locationPolicy": { - "$ref": "MultiMigLocationPolicy" - }, - "name": { - "description": "Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "type": "string" - }, - "parts": { - "additionalProperties": { - "$ref": "MultiMigPart" - }, - "description": "User-provided names for Parts of MultiMIG and the Parts themselves.", - "type": "object" - }, - "region": { - "description": "[Output Only] URL of the region where the resource resides. Only applicable for regional resources. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", - "type": "string" - }, - "schedulingPolicy": { - "$ref": "MultiMigSchedulingPolicy", - "description": "Policy for handling provisioning and other scheduling-related events." - }, - "selfLink": { - "description": "[Output only] Server-defined URL for the resource.", - "type": "string" - }, - "selfLinkWithId": { - "description": "[Output Only] Server-defined URL for this resource with the resource id.", - "type": "string" - }, - "status": { - "$ref": "MultiMigStatus" - } - }, - "type": "object" - }, - "MultiMigLocationPolicy": { - "description": "Policy regarding where to create MIGs Initially only zonal MIGs in the same zone are supported.", - "id": "MultiMigLocationPolicy", - "properties": { - "provisioningZones": { - "description": "List of zones where MIGs will be provisioned. Should be valid RFC1035 name", - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, - "MultiMigPart": { - "description": "Config for an MMIG part.", - "id": "MultiMigPart", - "properties": { - "instanceGroupManager": { - "description": "Link to an existing InstanceGroupManager that will be adopted by a MultiMIG.", - "type": "string" - }, - "instanceGroupManagerProperties": { - "$ref": "InstanceGroupManager", - "description": "InstanceGroupManager to be created by the multiMig" - } - }, - "type": "object" - }, - "MultiMigSchedulingPolicy": { - "description": "Policy for handling provisioning and other scheduling-related events.", - "id": "MultiMigSchedulingPolicy", - "properties": { - "provisioning": { - "description": "How provisioning of MIGs should be scheduled (coordinated or not)", - "enum": [ - "ANY", - "COOORDINATED" - ], - "enumDescriptions": [ - "Allows idependent lifecycles of parts.", - "Requires all parts at the same time." - ], - "type": "string" - } - }, - "type": "object" - }, - "MultiMigStatus": { - "id": "MultiMigStatus", - "properties": { - "memberInstanceGroupManagers": { - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, - "MultiMigsList": { - "id": "MultiMigsList", - "properties": { - "etag": { - "type": "string" - }, - "id": { - "description": "Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of MultiMig resources.", - "items": { - "$ref": "MultiMig" - }, - "type": "array" - }, - "kind": { - "default": "compute#multiMigList", - "description": "Type of resource.", - "type": "string" - }, - "nextPageToken": { - "description": "This token allows you to get the next page of results for maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output only] Server-defined URL for this resource.", - "type": "string" - }, - "unreachables": { - "description": "[Output only] Unreachable resources.", - "items": { - "type": "string" - }, - "type": "array" - }, - "warning": { - "description": "Informational warning message.", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "items": { - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - }, - "type": "object" - }, - "type": "array" - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - } - }, - "type": "object" - } - }, - "type": "object" - }, "MutualTls": { "description": "[Deprecated] Configuration for the mutual Tls mode for peer authentication. Configuration for the mutual Tls mode for peer authentication.", "id": "MutualTls", @@ -100807,7 +100328,7 @@ "type": "object" }, "localTrafficSelector": { - "description": "Local traffic selector to use when establishing the VPN tunnel with the peer VPN gateway. The value should be a CIDR formatted string, for example: 192.168.0.0/16. The ranges must be disjoint. Only IPv4 is supported.", + "description": "Local traffic selector to use when establishing the VPN tunnel with the peer VPN gateway. The value should be a CIDR formatted string, for example: 192.168.0.0/16. The ranges must be disjoint. Only IPv4 is supported for Classic VPN tunnels. This field is output only for HA VPN tunnels.", "items": { "type": "string" }, @@ -100837,7 +100358,7 @@ "type": "string" }, "peerIp": { - "description": "IP address of the peer VPN gateway. Only IPv4 is supported.", + "description": "IP address of the peer VPN gateway. Only IPv4 is supported. This field can be set only for Classic VPN tunnels.", "type": "string" }, "region": { @@ -100845,7 +100366,7 @@ "type": "string" }, "remoteTrafficSelector": { - "description": "Remote traffic selectors to use when establishing the VPN tunnel with the peer VPN gateway. The value should be a CIDR formatted string, for example: 192.168.0.0/16. The ranges should be disjoint. Only IPv4 is supported.", + "description": "Remote traffic selectors to use when establishing the VPN tunnel with the peer VPN gateway. The value should be a CIDR formatted string, for example: 192.168.0.0/16. The ranges should be disjoint. Only IPv4 is supported for Classic VPN tunnels. This field is output only for HA VPN tunnels.", "items": { "type": "string" }, @@ -100902,7 +100423,7 @@ "type": "string" }, "targetVpnGateway": { - "description": "URL of the Target VPN gateway with which this VPN tunnel is associated. Provided by the client when the VPN tunnel is created.", + "description": "URL of the Target VPN gateway with which this VPN tunnel is associated. Provided by the client when the VPN tunnel is created. This field can be set only for Classic VPN tunnels.", "type": "string" }, "vpnGateway": { diff --git a/compute/v0.alpha/compute-gen.go b/compute/v0.alpha/compute-gen.go index c880afa9b26..88bed026ce1 100644 --- a/compute/v0.alpha/compute-gen.go +++ b/compute/v0.alpha/compute-gen.go @@ -232,7 +232,6 @@ func New(client *http.Client) (*Service, error) { s.RegionInstances = NewRegionInstancesService(s) s.RegionInstantSnapshotGroups = NewRegionInstantSnapshotGroupsService(s) s.RegionInstantSnapshots = NewRegionInstantSnapshotsService(s) - s.RegionMultiMigs = NewRegionMultiMigsService(s) s.RegionNetworkEndpointGroups = NewRegionNetworkEndpointGroupsService(s) s.RegionNetworkFirewallPolicies = NewRegionNetworkFirewallPoliciesService(s) s.RegionNotificationEndpoints = NewRegionNotificationEndpointsService(s) @@ -423,8 +422,6 @@ type Service struct { RegionInstantSnapshots *RegionInstantSnapshotsService - RegionMultiMigs *RegionMultiMigsService - RegionNetworkEndpointGroups *RegionNetworkEndpointGroupsService RegionNetworkFirewallPolicies *RegionNetworkFirewallPoliciesService @@ -1147,15 +1144,6 @@ type RegionInstantSnapshotsService struct { s *Service } -func NewRegionMultiMigsService(s *Service) *RegionMultiMigsService { - rs := &RegionMultiMigsService{s: s} - return rs -} - -type RegionMultiMigsService struct { - s *Service -} - func NewRegionNetworkEndpointGroupsService(s *Service) *RegionNetworkEndpointGroupsService { rs := &RegionNetworkEndpointGroupsService{s: s} return rs @@ -5461,15 +5449,16 @@ type BackendCustomMetric struct { // MaxUtilization: Optional parameter to define a target utilization for the // Custom Metrics balancing mode. The valid range is [0.0, 1.0]. MaxUtilization float64 `json:"maxUtilization,omitempty"` - // Name: Name of a custom utilization signal. The name must be 1-24 characters - // long, and comply with RFC1035. Specifically, the name must be 1-24 - // characters long and match the regular expression a-z ([-a-z0-9]*[a-z0-9])? + // Name: Name of a custom utilization signal. The name must be 1-64 characters + // long, and comply with relaxed RFC1035. Specifically, the name must be 1-64 + // characters long and match the regular expression a-z ([-_.a-z0-9]*[a-z0-9])? // which means the first character must be a lowercase letter, and all - // following characters must be a dash, lowercase letter, or digit, except the - // last character, which cannot be a dash. For usage guidelines, see Custom - // Metrics balancing mode. This field can only be used for a global or regional - // backend service with the loadBalancingScheme set to EXTERNAL_MANAGED, - // INTERNAL_MANAGED INTERNAL_SELF_MANAGED. + // following characters must be a dash, period, underscore, lowercase letter, + // or digit, except the last character, which cannot be a dash, period, or + // underscore. For usage guidelines, see Custom Metrics balancing mode. This + // field can only be used for a global or regional backend service with the + // loadBalancingScheme set to EXTERNAL_MANAGED, INTERNAL_MANAGED + // INTERNAL_SELF_MANAGED. Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "DryRun") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -30013,316 +30002,6 @@ func (s Money) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// MultiMig: MultiMIG represents a group of Managed Instance Groups. -type MultiMig struct { - // CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text format. - CreationTimestamp string `json:"creationTimestamp,omitempty"` - // Description: An optional description of this resource. Provide this property - // when you create the resource. - Description string `json:"description,omitempty"` - // Id: [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - Id uint64 `json:"id,omitempty,string"` - // Kind: [Output Only] Type of the resource. Always compute#multiMig for - // MultiMIGs. - Kind string `json:"kind,omitempty"` - LocationPolicy *MultiMigLocationPolicy `json:"locationPolicy,omitempty"` - // Name: Name of the resource. Provided by the client when the resource is - // created. The name must be 1-63 characters long, and comply with RFC1035. - // Specifically, the name must be 1-63 characters long and match the regular - // expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must - // be a lowercase letter, and all following characters must be a dash, - // lowercase letter, or digit, except the last character, which cannot be a - // dash. - Name string `json:"name,omitempty"` - // Parts: User-provided names for Parts of MultiMIG and the Parts themselves. - Parts map[string]MultiMigPart `json:"parts,omitempty"` - // Region: [Output Only] URL of the region where the resource resides. Only - // applicable for regional resources. You must specify this field as part of - // the HTTP request URL. It is not settable as a field in the request body. - Region string `json:"region,omitempty"` - // SchedulingPolicy: Policy for handling provisioning and other - // scheduling-related events. - SchedulingPolicy *MultiMigSchedulingPolicy `json:"schedulingPolicy,omitempty"` - // SelfLink: [Output only] Server-defined URL for the resource. - SelfLink string `json:"selfLink,omitempty"` - // SelfLinkWithId: [Output Only] Server-defined URL for this resource with the - // resource id. - SelfLinkWithId string `json:"selfLinkWithId,omitempty"` - Status *MultiMigStatus `json:"status,omitempty"` - - // ServerResponse contains the HTTP response code and headers from the server. - googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "CreationTimestamp") 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. "CreationTimestamp") 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 MultiMig) MarshalJSON() ([]byte, error) { - type NoMethod MultiMig - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// MultiMigLocationPolicy: Policy regarding where to create MIGs Initially only -// zonal MIGs in the same zone are supported. -type MultiMigLocationPolicy struct { - // ProvisioningZones: List of zones where MIGs will be provisioned. Should be - // valid RFC1035 name - ProvisioningZones []string `json:"provisioningZones,omitempty"` - // ForceSendFields is a list of field names (e.g. "ProvisioningZones") 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. "ProvisioningZones") 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 MultiMigLocationPolicy) MarshalJSON() ([]byte, error) { - type NoMethod MultiMigLocationPolicy - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// MultiMigPart: Config for an MMIG part. -type MultiMigPart struct { - // InstanceGroupManager: Link to an existing InstanceGroupManager that will be - // adopted by a MultiMIG. - InstanceGroupManager string `json:"instanceGroupManager,omitempty"` - // InstanceGroupManagerProperties: InstanceGroupManager to be created by the - // multiMig - InstanceGroupManagerProperties *InstanceGroupManager `json:"instanceGroupManagerProperties,omitempty"` - // ForceSendFields is a list of field names (e.g. "InstanceGroupManager") 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. "InstanceGroupManager") 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 MultiMigPart) MarshalJSON() ([]byte, error) { - type NoMethod MultiMigPart - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// MultiMigSchedulingPolicy: Policy for handling provisioning and other -// scheduling-related events. -type MultiMigSchedulingPolicy struct { - // Provisioning: How provisioning of MIGs should be scheduled (coordinated or - // not) - // - // Possible values: - // "ANY" - Allows idependent lifecycles of parts. - // "COOORDINATED" - Requires all parts at the same time. - Provisioning string `json:"provisioning,omitempty"` - // ForceSendFields is a list of field names (e.g. "Provisioning") 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. "Provisioning") 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 MultiMigSchedulingPolicy) MarshalJSON() ([]byte, error) { - type NoMethod MultiMigSchedulingPolicy - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -type MultiMigStatus struct { - MemberInstanceGroupManagers []string `json:"memberInstanceGroupManagers,omitempty"` - // ForceSendFields is a list of field names (e.g. - // "MemberInstanceGroupManagers") 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. "MemberInstanceGroupManagers") 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 MultiMigStatus) MarshalJSON() ([]byte, error) { - type NoMethod MultiMigStatus - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -type MultiMigsList struct { - Etag string `json:"etag,omitempty"` - // Id: Unique identifier for the resource; defined by the server. - Id string `json:"id,omitempty"` - // Items: A list of MultiMig resources. - Items []*MultiMig `json:"items,omitempty"` - // Kind: Type of resource. - Kind string `json:"kind,omitempty"` - // NextPageToken: This token allows you to get the next page of results for - // maxResults, use the nextPageToken as a value for the query parameter - // pageToken in the next list request. Subsequent list requests will have their - // own nextPageToken to continue paging through the results. - NextPageToken string `json:"nextPageToken,omitempty"` - // SelfLink: [Output only] Server-defined URL for this resource. - SelfLink string `json:"selfLink,omitempty"` - // Unreachables: [Output only] Unreachable resources. - Unreachables []string `json:"unreachables,omitempty"` - // Warning: Informational warning message. - Warning *MultiMigsListWarning `json:"warning,omitempty"` - - // ServerResponse contains the HTTP response code and headers from the server. - googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "Etag") 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. "Etag") 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 MultiMigsList) MarshalJSON() ([]byte, error) { - type NoMethod MultiMigsList - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// MultiMigsListWarning: Informational warning message. -type MultiMigsListWarning struct { - // Code: [Output Only] A warning code, if applicable. For example, Compute - // Engine returns NO_RESULTS_ON_PAGE if there are no results in the response. - // - // Possible values: - // "CLEANUP_FAILED" - Warning about failed cleanup of transient changes made - // by a failed operation. - // "DEPRECATED_RESOURCE_USED" - A link to a deprecated resource was created. - // "DEPRECATED_TYPE_USED" - When deploying and at least one of the resources - // has a type marked as deprecated - // "DISK_SIZE_LARGER_THAN_IMAGE_SIZE" - The user created a boot disk that is - // larger than image size. - // "EXPERIMENTAL_TYPE_USED" - When deploying and at least one of the - // resources has a type marked as experimental - // "EXTERNAL_API_WARNING" - Warning that is present in an external api call - // "FIELD_VALUE_OVERRIDEN" - Warning that value of a field has been - // overridden. Deprecated unused field. - // "INJECTED_KERNELS_DEPRECATED" - The operation involved use of an injected - // kernel, which is deprecated. - // "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB" - A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // "LARGE_DEPLOYMENT_WARNING" - When deploying a deployment with a - // exceedingly large number of resources - // "LIST_OVERHEAD_QUOTA_EXCEED" - Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out by - // user-defined list filter. - // "MISSING_TYPE_DEPENDENCY" - A resource depends on a missing type - // "NEXT_HOP_ADDRESS_NOT_ASSIGNED" - The route's nextHopIp address is not - // assigned to an instance on the network. - // "NEXT_HOP_CANNOT_IP_FORWARD" - The route's next hop instance cannot ip - // forward. - // "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE" - The route's nextHopInstance - // URL refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // "NEXT_HOP_INSTANCE_NOT_FOUND" - The route's nextHopInstance URL refers to - // an instance that does not exist. - // "NEXT_HOP_INSTANCE_NOT_ON_NETWORK" - The route's nextHopInstance URL - // refers to an instance that is not on the same network as the route. - // "NEXT_HOP_NOT_RUNNING" - The route's next hop instance does not have a - // status of RUNNING. - // "NOT_CRITICAL_ERROR" - Error which is not critical. We decided to continue - // the process despite the mentioned error. - // "NO_RESULTS_ON_PAGE" - No results are present on a particular list page. - // "PARTIAL_SUCCESS" - Success is reported, but some results may be missing - // due to errors - // "REQUIRED_TOS_AGREEMENT" - The user attempted to use a resource that - // requires a TOS they have not accepted. - // "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING" - Warning that a resource is - // in use. - // "RESOURCE_NOT_DELETED" - One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // "SCHEMA_VALIDATION_IGNORED" - When a resource schema validation is - // ignored. - // "SINGLE_INSTANCE_PROPERTY_TEMPLATE" - Instance template used in instance - // group manager is valid as such, but its application does not make a lot of - // sense, because it allows only single instance in instance group. - // "UNDECLARED_PROPERTIES" - When undeclared properties in the schema are - // present - // "UNREACHABLE" - A given scope cannot be reached. - Code string `json:"code,omitempty"` - // Data: [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - Data []*MultiMigsListWarningData `json:"data,omitempty"` - // Message: [Output Only] A human-readable description of the warning code. - Message string `json:"message,omitempty"` - // ForceSendFields is a list of field names (e.g. "Code") 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. "Code") 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 MultiMigsListWarning) MarshalJSON() ([]byte, error) { - type NoMethod MultiMigsListWarning - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -type MultiMigsListWarningData struct { - // Key: [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a list - // request for a particular zone, this key might be scope and the key value - // might be the zone name. Other examples might be a key indicating a - // deprecated resource and a suggested replacement, or a warning about invalid - // network settings (for example, if an instance attempts to perform IP - // forwarding but is not enabled for IP forwarding). - Key string `json:"key,omitempty"` - // Value: [Output Only] A warning data value corresponding to the key. - Value string `json:"value,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 MultiMigsListWarningData) MarshalJSON() ([]byte, error) { - type NoMethod MultiMigsListWarningData - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // MutualTls: [Deprecated] Configuration for the mutual Tls mode for peer // authentication. Configuration for the mutual Tls mode for peer // authentication. @@ -63318,7 +62997,8 @@ type VpnTunnel struct { // LocalTrafficSelector: Local traffic selector to use when establishing the // VPN tunnel with the peer VPN gateway. The value should be a CIDR formatted // string, for example: 192.168.0.0/16. The ranges must be disjoint. Only IPv4 - // is supported. + // is supported for Classic VPN tunnels. This field is output only for HA VPN + // tunnels. LocalTrafficSelector []string `json:"localTrafficSelector,omitempty"` // Name: Name of the resource. Provided by the client when the resource is // created. The name must be 1-63 characters long, and comply with RFC1035. @@ -63344,7 +63024,8 @@ type VpnTunnel struct { // provided, the VPN tunnel will automatically use the same vpnGatewayInterface // ID in the peer Google Cloud VPN gateway. PeerGcpGateway string `json:"peerGcpGateway,omitempty"` - // PeerIp: IP address of the peer VPN gateway. Only IPv4 is supported. + // PeerIp: IP address of the peer VPN gateway. Only IPv4 is supported. This + // field can be set only for Classic VPN tunnels. PeerIp string `json:"peerIp,omitempty"` // Region: [Output Only] URL of the region where the VPN tunnel resides. You // must specify this field as part of the HTTP request URL. It is not settable @@ -63353,7 +63034,8 @@ type VpnTunnel struct { // RemoteTrafficSelector: Remote traffic selectors to use when establishing the // VPN tunnel with the peer VPN gateway. The value should be a CIDR formatted // string, for example: 192.168.0.0/16. The ranges should be disjoint. Only - // IPv4 is supported. + // IPv4 is supported for Classic VPN tunnels. This field is output only for HA + // VPN tunnels. RemoteTrafficSelector []string `json:"remoteTrafficSelector,omitempty"` // Router: URL of the router resource to be used for dynamic routing. Router string `json:"router,omitempty"` @@ -63405,7 +63087,8 @@ type VpnTunnel struct { // resources are needed to setup VPN tunnel. Status string `json:"status,omitempty"` // TargetVpnGateway: URL of the Target VPN gateway with which this VPN tunnel - // is associated. Provided by the client when the VPN tunnel is created. + // is associated. Provided by the client when the VPN tunnel is created. This + // field can be set only for Classic VPN tunnels. TargetVpnGateway string `json:"targetVpnGateway,omitempty"` // VpnGateway: URL of the VPN gateway with which this VPN tunnel is associated. // Provided by the client when the VPN tunnel is created. This must be used diff --git a/compute/v0.alpha/compute3-gen.go b/compute/v0.alpha/compute3-gen.go index c367a0a63bc..bcdbbfc8a57 100644 --- a/compute/v0.alpha/compute3-gen.go +++ b/compute/v0.alpha/compute3-gen.go @@ -14782,569 +14782,6 @@ func (c *RegionInstantSnapshotsTestIamPermissionsCall) Do(opts ...googleapi.Call return ret, nil } -type RegionMultiMigsDeleteCall struct { - s *Service - project string - region string - multiMig string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Delete: Deletes a regional multiMIG in the specified project. -// -// - multiMig: Name of the multiMIG to delete. -// - project: Project ID for this request. -// - region: Name of the region for this request. -func (r *RegionMultiMigsService) Delete(project string, region string, multiMig string) *RegionMultiMigsDeleteCall { - c := &RegionMultiMigsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.project = project - c.region = region - c.multiMig = multiMig - return c -} - -// RequestId sets the optional parameter "requestId": An optional request ID to -// identify requests. Specify a unique request ID so that if you must retry -// your request, the server will know to ignore the request if it has already -// been completed. For example, consider a situation where you make an initial -// request and the request times out. If you make the request again with the -// same request ID, the server can check if original operation with the same -// request ID was received, and if so, will ignore the second request. This -// prevents clients from accidentally creating duplicate commitments. The -// request ID must be a valid UUID with the exception that zero UUID is not -// supported ( 00000000-0000-0000-0000-000000000000). -func (c *RegionMultiMigsDeleteCall) RequestId(requestId string) *RegionMultiMigsDeleteCall { - c.urlParams_.Set("requestId", requestId) - 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 *RegionMultiMigsDeleteCall) Fields(s ...googleapi.Field) *RegionMultiMigsDeleteCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *RegionMultiMigsDeleteCall) Context(ctx context.Context) *RegionMultiMigsDeleteCall { - 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 *RegionMultiMigsDeleteCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *RegionMultiMigsDeleteCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) - var body io.Reader = nil - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/multiMigs/{multiMig}") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("DELETE", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "project": c.project, - "region": c.region, - "multiMig": c.multiMig, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "compute.regionMultiMigs.delete" 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 *RegionMultiMigsDeleteCall) 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 RegionMultiMigsGetCall struct { - s *Service - project string - region string - multiMig string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// Get: Returns the specified MultiMIG resource. -// -// - multiMig: Name of the MultiMig resource to return. -// - project: Project ID for this request. -// - region: Name of the region for this request. -func (r *RegionMultiMigsService) Get(project string, region string, multiMig string) *RegionMultiMigsGetCall { - c := &RegionMultiMigsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.project = project - c.region = region - c.multiMig = multiMig - 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 *RegionMultiMigsGetCall) Fields(s ...googleapi.Field) *RegionMultiMigsGetCall { - 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 *RegionMultiMigsGetCall) IfNoneMatch(entityTag string) *RegionMultiMigsGetCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *RegionMultiMigsGetCall) Context(ctx context.Context) *RegionMultiMigsGetCall { - 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 *RegionMultiMigsGetCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *RegionMultiMigsGetCall) 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, "projects/{project}/regions/{region}/multiMigs/{multiMig}") - 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{ - "project": c.project, - "region": c.region, - "multiMig": c.multiMig, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "compute.regionMultiMigs.get" call. -// Any non-2xx status code is an error. Response headers are in either -// *MultiMig.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 *RegionMultiMigsGetCall) Do(opts ...googleapi.CallOption) (*MultiMig, 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 := &MultiMig{ - 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 RegionMultiMigsInsertCall struct { - s *Service - project string - region string - multimig *MultiMig - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Insert: Creates a regional multiMIG in the specified project. -// -// - project: Project ID for this request. -// - region: Name of the region for this request. -func (r *RegionMultiMigsService) Insert(project string, region string, multimig *MultiMig) *RegionMultiMigsInsertCall { - c := &RegionMultiMigsInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.project = project - c.region = region - c.multimig = multimig - return c -} - -// RequestId sets the optional parameter "requestId": An optional request ID to -// identify requests. Specify a unique request ID so that if you must retry -// your request, the server will know to ignore the request if it has already -// been completed. For example, consider a situation where you make an initial -// request and the request times out. If you make the request again with the -// same request ID, the server can check if original operation with the same -// request ID was received, and if so, will ignore the second request. This -// prevents clients from accidentally creating duplicate commitments. The -// request ID must be a valid UUID with the exception that zero UUID is not -// supported ( 00000000-0000-0000-0000-000000000000). -func (c *RegionMultiMigsInsertCall) RequestId(requestId string) *RegionMultiMigsInsertCall { - c.urlParams_.Set("requestId", requestId) - 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 *RegionMultiMigsInsertCall) Fields(s ...googleapi.Field) *RegionMultiMigsInsertCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *RegionMultiMigsInsertCall) Context(ctx context.Context) *RegionMultiMigsInsertCall { - 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 *RegionMultiMigsInsertCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *RegionMultiMigsInsertCall) 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.multimig) - if err != nil { - return nil, err - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/multiMigs") - 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{ - "project": c.project, - "region": c.region, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "compute.regionMultiMigs.insert" 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 *RegionMultiMigsInsertCall) 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 RegionMultiMigsListCall struct { - s *Service - project string - region string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// List: Retrieves a list of MultiMIGs in a project and region. -// -// - project: Project ID for this request. -// - region: Name of the region for this request. -func (r *RegionMultiMigsService) List(project string, region string) *RegionMultiMigsListCall { - c := &RegionMultiMigsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.project = project - c.region = region - return c -} - -// Filter sets the optional parameter "filter": A filter expression that -// filters resources listed in the response. Most Compute resources support two -// types of filter expressions: expressions that support regular expressions -// and expressions that follow API improvement proposal AIP-160. These two -// types of filter expressions cannot be mixed in one request. If you want to -// use AIP-160, your expression must specify the field name, an operator, and -// the value that you want to use for filtering. The value must be a string, a -// number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, -// `>=` or `:`. For example, if you are filtering Compute Engine instances, you -// can exclude instances named `example-instance` by specifying `name != -// example-instance`. The `:*` comparison can be used to test whether a key has -// been defined. For example, to find all objects with `owner` label use: ``` -// labels.owner:* ``` You can also filter nested fields. For example, you could -// specify `scheduling.automaticRestart = false` to include instances only if -// they are not scheduled for automatic restarts. You can use filtering on -// nested fields to filter based on resource labels. To filter on multiple -// expressions, provide each separate expression within parentheses. For -// example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel -// Skylake") ``` By default, each expression is an `AND` expression. However, -// you can include `AND` and `OR` expressions explicitly. For example: ``` -// (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND -// (scheduling.automaticRestart = true) ``` If you want to use a regular -// expression, use the `eq` (equal) or `ne` (not equal) operator against a -// single un-parenthesized expression with or without quotes or against -// multiple parenthesized expressions. Examples: `fieldname eq unquoted -// literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted -// literal" `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal -// value is interpreted as a regular expression using Google RE2 library -// syntax. The literal value must match the entire field. For example, to -// filter for instances that do not end with name "instance", you would use -// `name ne .*instance`. You cannot combine constraints on multiple fields -// using regular expressions. -func (c *RegionMultiMigsListCall) Filter(filter string) *RegionMultiMigsListCall { - c.urlParams_.Set("filter", filter) - return c -} - -// MaxResults sets the optional parameter "maxResults": The maximum number of -// results per page that should be returned. If the number of available results -// is larger than `maxResults`, Compute Engine returns a `nextPageToken` that -// can be used to get the next page of results in subsequent list requests. -// Acceptable values are `0` to `500`, inclusive. (Default: `500`) -func (c *RegionMultiMigsListCall) MaxResults(maxResults int64) *RegionMultiMigsListCall { - c.urlParams_.Set("maxResults", fmt.Sprint(maxResults)) - return c -} - -// OrderBy sets the optional parameter "orderBy": Sorts list results by a -// certain order. By default, results are returned in alphanumerical order -// based on the resource name. You can also sort results in descending order -// based on the creation timestamp using `orderBy="creationTimestamp desc". -// This sorts results based on the `creationTimestamp` field in reverse -// chronological order (newest result first). Use this to sort resources like -// operations so that the newest operation is returned first. Currently, only -// sorting by `name` or `creationTimestamp desc` is supported. -func (c *RegionMultiMigsListCall) OrderBy(orderBy string) *RegionMultiMigsListCall { - c.urlParams_.Set("orderBy", orderBy) - return c -} - -// PageToken sets the optional parameter "pageToken": Specifies a page token to -// use. Set `pageToken` to the `nextPageToken` returned by a previous list -// request to get the next page of results. -func (c *RegionMultiMigsListCall) PageToken(pageToken string) *RegionMultiMigsListCall { - c.urlParams_.Set("pageToken", pageToken) - return c -} - -// ReturnPartialSuccess sets the optional parameter "returnPartialSuccess": -// Opt-in for partial success behavior which provides partial results in case -// of failure. The default value is false. For example, when partial success -// behavior is enabled, aggregatedList for a single zone scope either returns -// all resources in the zone or no resources, with an error code. -func (c *RegionMultiMigsListCall) ReturnPartialSuccess(returnPartialSuccess bool) *RegionMultiMigsListCall { - 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. -func (c *RegionMultiMigsListCall) Fields(s ...googleapi.Field) *RegionMultiMigsListCall { - 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 *RegionMultiMigsListCall) IfNoneMatch(entityTag string) *RegionMultiMigsListCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *RegionMultiMigsListCall) Context(ctx context.Context) *RegionMultiMigsListCall { - 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 *RegionMultiMigsListCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *RegionMultiMigsListCall) 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, "projects/{project}/regions/{region}/multiMigs") - 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{ - "project": c.project, - "region": c.region, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "compute.regionMultiMigs.list" call. -// Any non-2xx status code is an error. Response headers are in either -// *MultiMigsList.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 *RegionMultiMigsListCall) Do(opts ...googleapi.CallOption) (*MultiMigsList, 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 := &MultiMigsList{ - 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 -} - -// Pages invokes f for each page of results. -// A non-nil error returned from f will halt the iteration. -// The provided context supersedes any context provided to the Context method. -func (c *RegionMultiMigsListCall) Pages(ctx context.Context, f func(*MultiMigsList) error) error { - c.ctx_ = ctx - defer c.PageToken(c.urlParams_.Get("pageToken")) - for { - x, err := c.Do() - if err != nil { - return err - } - if err := f(x); err != nil { - return err - } - if x.NextPageToken == "" { - return nil - } - c.PageToken(x.NextPageToken) - } -} - type RegionNetworkEndpointGroupsAttachNetworkEndpointsCall struct { s *Service project string diff --git a/compute/v0.beta/compute-api.json b/compute/v0.beta/compute-api.json index 8d637ea3da6..f0c1d2b9095 100644 --- a/compute/v0.beta/compute-api.json +++ b/compute/v0.beta/compute-api.json @@ -41911,7 +41911,7 @@ } } }, - "revision": "20240730", + "revision": "20240813", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -45076,6 +45076,25 @@ "description": "If true, enables Cloud CDN for the backend service of a global external Application Load Balancer.", "type": "boolean" }, + "externalManagedMigrationState": { + "description": "Specifies the canary migration state. Possible values are PREPARE, TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC. To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the TEST_BY_PERCENTAGE state can be used to migrate traffic by percentage using externalManagedMigrationTestingPercentage. Rolling back a migration requires the states to be set in reverse order. So changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to be set to TEST_ALL_TRAFFIC at the same time. Optionally, the TEST_BY_PERCENTAGE state can be used to migrate some traffic back to EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL.", + "enum": [ + "PREPARE", + "TEST_ALL_TRAFFIC", + "TEST_BY_PERCENTAGE" + ], + "enumDescriptions": [ + "", + "", + "" + ], + "type": "string" + }, + "externalManagedMigrationTestingPercentage": { + "description": "Determines the fraction of requests that should be processed by the Global external Application Load Balancer. The value of this field must be in the range [0, 100]. Session affinity options will slightly affect this routing behavior, for more details, see: Session Affinity. This value can only be set if the loadBalancingScheme in the BackendService is set to EXTERNAL (when using the classic Application Load Balancer) and the migration state is TEST_BY_PERCENTAGE.", + "format": "float", + "type": "number" + }, "failoverPolicy": { "$ref": "BackendServiceFailoverPolicy", "description": "Requires at least one backend instance group to be defined as a backup (failover) backend. For load balancers that have configurable failover: [Internal passthrough Network Load Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview) and [external passthrough Network Load Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview)." @@ -50764,6 +50783,25 @@ "description": "An optional description of this resource. Provide this property when you create the resource.", "type": "string" }, + "externalManagedBackendBucketMigrationState": { + "description": "Specifies the canary migration state for the backend buckets attached to this forwarding rule. Possible values are PREPARE, TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC. To begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before the loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the TEST_BY_PERCENTAGE state can be used to migrate traffic to backend buckets attached to this forwarding rule by percentage using externalManagedBackendBucketMigrationTestingPercentage. Rolling back a migration requires the states to be set in reverse order. So changing the scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to be set to TEST_ALL_TRAFFIC at the same time. Optionally, the TEST_BY_PERCENTAGE state can be used to migrate some traffic back to EXTERNAL or PREPARE can be used to migrate all traffic back to EXTERNAL.", + "enum": [ + "PREPARE", + "TEST_ALL_TRAFFIC", + "TEST_BY_PERCENTAGE" + ], + "enumDescriptions": [ + "", + "", + "" + ], + "type": "string" + }, + "externalManagedBackendBucketMigrationTestingPercentage": { + "description": "Determines the fraction of requests to backend buckets that should be processed by the global external Application Load Balancer. The value of this field must be in the range [0, 100]. This value can only be set if the loadBalancingScheme in the BackendService is set to EXTERNAL (when using the classic Application Load Balancer) and the migration state is TEST_BY_PERCENTAGE.", + "format": "float", + "type": "number" + }, "fingerprint": { "description": "Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a ForwardingRule. Include the fingerprint in patch request to ensure that you do not overwrite changes that were applied from another concurrent request. To see the latest fingerprint, make a get() request to retrieve a ForwardingRule.", "format": "byte", @@ -51492,10 +51530,6 @@ "$ref": "ShareSettings", "description": "List of Projects/Folders to share with." }, - "specificReservationRequired": { - "description": "Indicates whether the auto-created reservation can be consumed by VMs with affinity for \"any\" reservation. If the field is set, then only VMs that target the reservation by name can consume from the delivered reservation. If set to true,the delivered resevervation will have the same name as the future reservation.", - "type": "boolean" - }, "specificSkuProperties": { "$ref": "FutureReservationSpecificSKUProperties", "description": "Future Reservation configuration to indicate instance properties and total count." @@ -51629,7 +51663,6 @@ }, "timestamp": { "description": "Timestamp when the matching usage was calculated", - "format": "google-datetime", "type": "string" } }, @@ -63080,6 +63113,20 @@ }, "type": "array" }, + "architecture": { + "description": "[Output Only] The architecture of the machine type.", + "enum": [ + "ARCHITECTURE_UNSPECIFIED", + "ARM64", + "X86_64" + ], + "enumDescriptions": [ + "Default value indicating Architecture is not set.", + "Machines with architecture ARM64", + "Machines with architecture X86_64" + ], + "type": "string" + }, "bundledLocalSsds": { "$ref": "BundledLocalSsds", "description": "[Output Only] The configuration of bundled local SSD for the machine type." @@ -90769,7 +90816,7 @@ "type": "object" }, "localTrafficSelector": { - "description": "Local traffic selector to use when establishing the VPN tunnel with the peer VPN gateway. The value should be a CIDR formatted string, for example: 192.168.0.0/16. The ranges must be disjoint. Only IPv4 is supported.", + "description": "Local traffic selector to use when establishing the VPN tunnel with the peer VPN gateway. The value should be a CIDR formatted string, for example: 192.168.0.0/16. The ranges must be disjoint. Only IPv4 is supported for Classic VPN tunnels. This field is output only for HA VPN tunnels.", "items": { "type": "string" }, @@ -90799,7 +90846,7 @@ "type": "string" }, "peerIp": { - "description": "IP address of the peer VPN gateway. Only IPv4 is supported.", + "description": "IP address of the peer VPN gateway. Only IPv4 is supported. This field can be set only for Classic VPN tunnels.", "type": "string" }, "region": { @@ -90807,7 +90854,7 @@ "type": "string" }, "remoteTrafficSelector": { - "description": "Remote traffic selectors to use when establishing the VPN tunnel with the peer VPN gateway. The value should be a CIDR formatted string, for example: 192.168.0.0/16. The ranges should be disjoint. Only IPv4 is supported.", + "description": "Remote traffic selectors to use when establishing the VPN tunnel with the peer VPN gateway. The value should be a CIDR formatted string, for example: 192.168.0.0/16. The ranges should be disjoint. Only IPv4 is supported for Classic VPN tunnels. This field is output only for HA VPN tunnels.", "items": { "type": "string" }, @@ -90864,7 +90911,7 @@ "type": "string" }, "targetVpnGateway": { - "description": "URL of the Target VPN gateway with which this VPN tunnel is associated. Provided by the client when the VPN tunnel is created.", + "description": "URL of the Target VPN gateway with which this VPN tunnel is associated. Provided by the client when the VPN tunnel is created. This field can be set only for Classic VPN tunnels.", "type": "string" }, "vpnGateway": { diff --git a/compute/v0.beta/compute-gen.go b/compute/v0.beta/compute-gen.go index 58e51fc12bc..4c374d9a529 100644 --- a/compute/v0.beta/compute-gen.go +++ b/compute/v0.beta/compute-gen.go @@ -5082,6 +5082,33 @@ type BackendService struct { // EnableCDN: If true, enables Cloud CDN for the backend service of a global // external Application Load Balancer. EnableCDN bool `json:"enableCDN,omitempty"` + // ExternalManagedMigrationState: Specifies the canary migration state. + // Possible values are PREPARE, TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC. To + // begin the migration from EXTERNAL to EXTERNAL_MANAGED, the state must be + // changed to PREPARE. The state must be changed to TEST_ALL_TRAFFIC before the + // loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the + // TEST_BY_PERCENTAGE state can be used to migrate traffic by percentage using + // externalManagedMigrationTestingPercentage. Rolling back a migration requires + // the states to be set in reverse order. So changing the scheme from + // EXTERNAL_MANAGED to EXTERNAL requires the state to be set to + // TEST_ALL_TRAFFIC at the same time. Optionally, the TEST_BY_PERCENTAGE state + // can be used to migrate some traffic back to EXTERNAL or PREPARE can be used + // to migrate all traffic back to EXTERNAL. + // + // Possible values: + // "PREPARE" + // "TEST_ALL_TRAFFIC" + // "TEST_BY_PERCENTAGE" + ExternalManagedMigrationState string `json:"externalManagedMigrationState,omitempty"` + // ExternalManagedMigrationTestingPercentage: Determines the fraction of + // requests that should be processed by the Global external Application Load + // Balancer. The value of this field must be in the range [0, 100]. Session + // affinity options will slightly affect this routing behavior, for more + // details, see: Session Affinity. This value can only be set if the + // loadBalancingScheme in the BackendService is set to EXTERNAL (when using the + // classic Application Load Balancer) and the migration state is + // TEST_BY_PERCENTAGE. + ExternalManagedMigrationTestingPercentage float64 `json:"externalManagedMigrationTestingPercentage,omitempty"` // FailoverPolicy: Requires at least one backend instance group to be defined // as a backup (failover) backend. For load balancers that have configurable // failover: Internal passthrough Network Load Balancers @@ -5412,6 +5439,20 @@ func (s BackendService) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +func (s *BackendService) UnmarshalJSON(data []byte) error { + type NoMethod BackendService + var s1 struct { + ExternalManagedMigrationTestingPercentage gensupport.JSONFloat64 `json:"externalManagedMigrationTestingPercentage"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.ExternalManagedMigrationTestingPercentage = float64(s1.ExternalManagedMigrationTestingPercentage) + return nil +} + // BackendServiceAggregatedList: Contains a list of BackendServicesScopedList. type BackendServiceAggregatedList struct { // Id: [Output Only] Unique identifier for the resource; defined by the server. @@ -11773,6 +11814,33 @@ type ForwardingRule struct { // Description: An optional description of this resource. Provide this property // when you create the resource. Description string `json:"description,omitempty"` + // ExternalManagedBackendBucketMigrationState: Specifies the canary migration + // state for the backend buckets attached to this forwarding rule. Possible + // values are PREPARE, TEST_BY_PERCENTAGE, and TEST_ALL_TRAFFIC. To begin the + // migration from EXTERNAL to EXTERNAL_MANAGED, the state must be changed to + // PREPARE. The state must be changed to TEST_ALL_TRAFFIC before the + // loadBalancingScheme can be changed to EXTERNAL_MANAGED. Optionally, the + // TEST_BY_PERCENTAGE state can be used to migrate traffic to backend buckets + // attached to this forwarding rule by percentage using + // externalManagedBackendBucketMigrationTestingPercentage. Rolling back a + // migration requires the states to be set in reverse order. So changing the + // scheme from EXTERNAL_MANAGED to EXTERNAL requires the state to be set to + // TEST_ALL_TRAFFIC at the same time. Optionally, the TEST_BY_PERCENTAGE state + // can be used to migrate some traffic back to EXTERNAL or PREPARE can be used + // to migrate all traffic back to EXTERNAL. + // + // Possible values: + // "PREPARE" + // "TEST_ALL_TRAFFIC" + // "TEST_BY_PERCENTAGE" + ExternalManagedBackendBucketMigrationState string `json:"externalManagedBackendBucketMigrationState,omitempty"` + // ExternalManagedBackendBucketMigrationTestingPercentage: Determines the + // fraction of requests to backend buckets that should be processed by the + // global external Application Load Balancer. The value of this field must be + // in the range [0, 100]. This value can only be set if the loadBalancingScheme + // in the BackendService is set to EXTERNAL (when using the classic Application + // Load Balancer) and the migration state is TEST_BY_PERCENTAGE. + ExternalManagedBackendBucketMigrationTestingPercentage float64 `json:"externalManagedBackendBucketMigrationTestingPercentage,omitempty"` // Fingerprint: Fingerprint of this resource. A hash of the contents stored in // this object. This field is used in optimistic locking. This field will be // ignored when inserting a ForwardingRule. Include the fingerprint in patch @@ -12002,6 +12070,20 @@ func (s ForwardingRule) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +func (s *ForwardingRule) UnmarshalJSON(data []byte) error { + type NoMethod ForwardingRule + var s1 struct { + ExternalManagedBackendBucketMigrationTestingPercentage gensupport.JSONFloat64 `json:"externalManagedBackendBucketMigrationTestingPercentage"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.ExternalManagedBackendBucketMigrationTestingPercentage = float64(s1.ExternalManagedBackendBucketMigrationTestingPercentage) + return nil +} + type ForwardingRuleAggregatedList struct { // Id: [Output Only] Unique identifier for the resource; defined by the server. Id string `json:"id,omitempty"` @@ -12562,12 +12644,6 @@ type FutureReservation struct { SelfLinkWithId string `json:"selfLinkWithId,omitempty"` // ShareSettings: List of Projects/Folders to share with. ShareSettings *ShareSettings `json:"shareSettings,omitempty"` - // SpecificReservationRequired: Indicates whether the auto-created reservation - // can be consumed by VMs with affinity for "any" reservation. If the field is - // set, then only VMs that target the reservation by name can consume from the - // delivered reservation. If set to true,the delivered resevervation will have - // the same name as the future reservation. - SpecificReservationRequired bool `json:"specificReservationRequired,omitempty"` // SpecificSkuProperties: Future Reservation configuration to indicate instance // properties and total count. SpecificSkuProperties *FutureReservationSpecificSKUProperties `json:"specificSkuProperties,omitempty"` @@ -25899,6 +25975,14 @@ type MachineType struct { // Accelerators: [Output Only] A list of accelerator configurations assigned to // this machine type. Accelerators []*MachineTypeAccelerators `json:"accelerators,omitempty"` + // Architecture: [Output Only] The architecture of the machine type. + // + // Possible values: + // "ARCHITECTURE_UNSPECIFIED" - Default value indicating Architecture is not + // set. + // "ARM64" - Machines with architecture ARM64 + // "X86_64" - Machines with architecture X86_64 + Architecture string `json:"architecture,omitempty"` // BundledLocalSsds: [Output Only] The configuration of bundled local SSD for // the machine type. BundledLocalSsds *BundledLocalSsds `json:"bundledLocalSsds,omitempty"` @@ -56089,7 +56173,8 @@ type VpnTunnel struct { // LocalTrafficSelector: Local traffic selector to use when establishing the // VPN tunnel with the peer VPN gateway. The value should be a CIDR formatted // string, for example: 192.168.0.0/16. The ranges must be disjoint. Only IPv4 - // is supported. + // is supported for Classic VPN tunnels. This field is output only for HA VPN + // tunnels. LocalTrafficSelector []string `json:"localTrafficSelector,omitempty"` // Name: Name of the resource. Provided by the client when the resource is // created. The name must be 1-63 characters long, and comply with RFC1035. @@ -56115,7 +56200,8 @@ type VpnTunnel struct { // provided, the VPN tunnel will automatically use the same vpnGatewayInterface // ID in the peer Google Cloud VPN gateway. PeerGcpGateway string `json:"peerGcpGateway,omitempty"` - // PeerIp: IP address of the peer VPN gateway. Only IPv4 is supported. + // PeerIp: IP address of the peer VPN gateway. Only IPv4 is supported. This + // field can be set only for Classic VPN tunnels. PeerIp string `json:"peerIp,omitempty"` // Region: [Output Only] URL of the region where the VPN tunnel resides. You // must specify this field as part of the HTTP request URL. It is not settable @@ -56124,7 +56210,8 @@ type VpnTunnel struct { // RemoteTrafficSelector: Remote traffic selectors to use when establishing the // VPN tunnel with the peer VPN gateway. The value should be a CIDR formatted // string, for example: 192.168.0.0/16. The ranges should be disjoint. Only - // IPv4 is supported. + // IPv4 is supported for Classic VPN tunnels. This field is output only for HA + // VPN tunnels. RemoteTrafficSelector []string `json:"remoteTrafficSelector,omitempty"` // Router: URL of the router resource to be used for dynamic routing. Router string `json:"router,omitempty"` @@ -56176,7 +56263,8 @@ type VpnTunnel struct { // resources are needed to setup VPN tunnel. Status string `json:"status,omitempty"` // TargetVpnGateway: URL of the Target VPN gateway with which this VPN tunnel - // is associated. Provided by the client when the VPN tunnel is created. + // is associated. Provided by the client when the VPN tunnel is created. This + // field can be set only for Classic VPN tunnels. TargetVpnGateway string `json:"targetVpnGateway,omitempty"` // VpnGateway: URL of the VPN gateway with which this VPN tunnel is associated. // Provided by the client when the VPN tunnel is created. This must be used diff --git a/compute/v1/compute-api.json b/compute/v1/compute-api.json index ea9fac9e3b3..7699dd712d6 100644 --- a/compute/v1/compute-api.json +++ b/compute/v1/compute-api.json @@ -37779,7 +37779,7 @@ } } }, - "revision": "20240730", + "revision": "20240813", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -47048,10 +47048,6 @@ "$ref": "ShareSettings", "description": "List of Projects/Folders to share with." }, - "specificReservationRequired": { - "description": "Indicates whether the auto-created reservation can be consumed by VMs with affinity for \"any\" reservation. If the field is set, then only VMs that target the reservation by name can consume from the delivered reservation. If set to true,the delivered resevervation will have the same name as the future reservation.", - "type": "boolean" - }, "specificSkuProperties": { "$ref": "FutureReservationSpecificSKUProperties", "description": "Future Reservation configuration to indicate instance properties and total count." @@ -47185,7 +47181,6 @@ }, "timestamp": { "description": "Timestamp when the matching usage was calculated", - "format": "google-datetime", "type": "string" } }, @@ -58195,6 +58190,20 @@ }, "type": "array" }, + "architecture": { + "description": "[Output Only] The architecture of the machine type.", + "enum": [ + "ARCHITECTURE_UNSPECIFIED", + "ARM64", + "X86_64" + ], + "enumDescriptions": [ + "Default value indicating Architecture is not set.", + "Machines with architecture ARM64", + "Machines with architecture X86_64" + ], + "type": "string" + }, "creationTimestamp": { "description": "[Output Only] Creation timestamp in RFC3339 text format.", "type": "string" @@ -84498,7 +84507,7 @@ "type": "object" }, "localTrafficSelector": { - "description": "Local traffic selector to use when establishing the VPN tunnel with the peer VPN gateway. The value should be a CIDR formatted string, for example: 192.168.0.0/16. The ranges must be disjoint. Only IPv4 is supported.", + "description": "Local traffic selector to use when establishing the VPN tunnel with the peer VPN gateway. The value should be a CIDR formatted string, for example: 192.168.0.0/16. The ranges must be disjoint. Only IPv4 is supported for Classic VPN tunnels. This field is output only for HA VPN tunnels.", "items": { "type": "string" }, @@ -84528,7 +84537,7 @@ "type": "string" }, "peerIp": { - "description": "IP address of the peer VPN gateway. Only IPv4 is supported.", + "description": "IP address of the peer VPN gateway. Only IPv4 is supported. This field can be set only for Classic VPN tunnels.", "type": "string" }, "region": { @@ -84536,7 +84545,7 @@ "type": "string" }, "remoteTrafficSelector": { - "description": "Remote traffic selectors to use when establishing the VPN tunnel with the peer VPN gateway. The value should be a CIDR formatted string, for example: 192.168.0.0/16. The ranges should be disjoint. Only IPv4 is supported.", + "description": "Remote traffic selectors to use when establishing the VPN tunnel with the peer VPN gateway. The value should be a CIDR formatted string, for example: 192.168.0.0/16. The ranges should be disjoint. Only IPv4 is supported for Classic VPN tunnels. This field is output only for HA VPN tunnels.", "items": { "type": "string" }, @@ -84593,7 +84602,7 @@ "type": "string" }, "targetVpnGateway": { - "description": "URL of the Target VPN gateway with which this VPN tunnel is associated. Provided by the client when the VPN tunnel is created.", + "description": "URL of the Target VPN gateway with which this VPN tunnel is associated. Provided by the client when the VPN tunnel is created. This field can be set only for Classic VPN tunnels.", "type": "string" }, "vpnGateway": { diff --git a/compute/v1/compute-gen.go b/compute/v1/compute-gen.go index d05761b66b9..9ea1149d2bd 100644 --- a/compute/v1/compute-gen.go +++ b/compute/v1/compute-gen.go @@ -12188,12 +12188,6 @@ type FutureReservation struct { SelfLinkWithId string `json:"selfLinkWithId,omitempty"` // ShareSettings: List of Projects/Folders to share with. ShareSettings *ShareSettings `json:"shareSettings,omitempty"` - // SpecificReservationRequired: Indicates whether the auto-created reservation - // can be consumed by VMs with affinity for "any" reservation. If the field is - // set, then only VMs that target the reservation by name can consume from the - // delivered reservation. If set to true,the delivered resevervation will have - // the same name as the future reservation. - SpecificReservationRequired bool `json:"specificReservationRequired,omitempty"` // SpecificSkuProperties: Future Reservation configuration to indicate instance // properties and total count. SpecificSkuProperties *FutureReservationSpecificSKUProperties `json:"specificSkuProperties,omitempty"` @@ -24967,6 +24961,14 @@ type MachineType struct { // Accelerators: [Output Only] A list of accelerator configurations assigned to // this machine type. Accelerators []*MachineTypeAccelerators `json:"accelerators,omitempty"` + // Architecture: [Output Only] The architecture of the machine type. + // + // Possible values: + // "ARCHITECTURE_UNSPECIFIED" - Default value indicating Architecture is not + // set. + // "ARM64" - Machines with architecture ARM64 + // "X86_64" - Machines with architecture X86_64 + Architecture string `json:"architecture,omitempty"` // CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text format. CreationTimestamp string `json:"creationTimestamp,omitempty"` // Deprecated -- [Output Only] The deprecation status associated with this @@ -53582,7 +53584,8 @@ type VpnTunnel struct { // LocalTrafficSelector: Local traffic selector to use when establishing the // VPN tunnel with the peer VPN gateway. The value should be a CIDR formatted // string, for example: 192.168.0.0/16. The ranges must be disjoint. Only IPv4 - // is supported. + // is supported for Classic VPN tunnels. This field is output only for HA VPN + // tunnels. LocalTrafficSelector []string `json:"localTrafficSelector,omitempty"` // Name: Name of the resource. Provided by the client when the resource is // created. The name must be 1-63 characters long, and comply with RFC1035. @@ -53608,7 +53611,8 @@ type VpnTunnel struct { // provided, the VPN tunnel will automatically use the same vpnGatewayInterface // ID in the peer Google Cloud VPN gateway. PeerGcpGateway string `json:"peerGcpGateway,omitempty"` - // PeerIp: IP address of the peer VPN gateway. Only IPv4 is supported. + // PeerIp: IP address of the peer VPN gateway. Only IPv4 is supported. This + // field can be set only for Classic VPN tunnels. PeerIp string `json:"peerIp,omitempty"` // Region: [Output Only] URL of the region where the VPN tunnel resides. You // must specify this field as part of the HTTP request URL. It is not settable @@ -53617,7 +53621,8 @@ type VpnTunnel struct { // RemoteTrafficSelector: Remote traffic selectors to use when establishing the // VPN tunnel with the peer VPN gateway. The value should be a CIDR formatted // string, for example: 192.168.0.0/16. The ranges should be disjoint. Only - // IPv4 is supported. + // IPv4 is supported for Classic VPN tunnels. This field is output only for HA + // VPN tunnels. RemoteTrafficSelector []string `json:"remoteTrafficSelector,omitempty"` // Router: URL of the router resource to be used for dynamic routing. Router string `json:"router,omitempty"` @@ -53669,7 +53674,8 @@ type VpnTunnel struct { // resources are needed to setup VPN tunnel. Status string `json:"status,omitempty"` // TargetVpnGateway: URL of the Target VPN gateway with which this VPN tunnel - // is associated. Provided by the client when the VPN tunnel is created. + // is associated. Provided by the client when the VPN tunnel is created. This + // field can be set only for Classic VPN tunnels. TargetVpnGateway string `json:"targetVpnGateway,omitempty"` // VpnGateway: URL of the VPN gateway with which this VPN tunnel is associated. // Provided by the client when the VPN tunnel is created. This must be used diff --git a/connectors/v1/connectors-api.json b/connectors/v1/connectors-api.json index 547b75bf1f0..ee8b29ff060 100644 --- a/connectors/v1/connectors-api.json +++ b/connectors/v1/connectors-api.json @@ -2427,7 +2427,7 @@ } } }, - "revision": "20240729", + "revision": "20240811", "rootUrl": "https://connectors.googleapis.com/", "schemas": { "AuditConfig": { @@ -2582,6 +2582,10 @@ "displayName": { "description": "Display name for authentication template.", "type": "string" + }, + "isDefault": { + "description": "Whether the auth config is the default one.", + "type": "boolean" } }, "type": "object" @@ -2925,6 +2929,11 @@ "description": "Output only. Eventing Runtime Data.", "readOnly": true }, + "host": { + "description": "Output only. The name of the Hostname of the Service Directory service with TLS.", + "readOnly": true, + "type": "string" + }, "imageLocation": { "description": "Output only. GCR location where the runtime image is stored. formatted like: gcr.io/{bucketName}/{imageName}", "readOnly": true, @@ -2996,6 +3005,11 @@ "description": "Optional. Suspended indicates if a user has suspended a connection or not.", "type": "boolean" }, + "tlsServiceDirectory": { + "description": "Output only. The name of the Service Directory service with TLS.", + "readOnly": true, + "type": "string" + }, "updateTime": { "description": "Output only. Updated time.", "format": "google-datetime", @@ -3344,6 +3358,11 @@ "description": "Output only. Eventing configuration supported by the Connector.", "readOnly": true }, + "isAsyncOperationsSupported": { + "description": "Output only. Is async operations supported.", + "readOnly": true, + "type": "boolean" + }, "isCustomActionsSupported": { "description": "Output only. Is custom actions supported.", "readOnly": true, diff --git a/connectors/v1/connectors-gen.go b/connectors/v1/connectors-gen.go index 3ff31197752..631f6b55666 100644 --- a/connectors/v1/connectors-gen.go +++ b/connectors/v1/connectors-gen.go @@ -527,6 +527,8 @@ type AuthConfigTemplate struct { Description string `json:"description,omitempty"` // DisplayName: Display name for authentication template. DisplayName string `json:"displayName,omitempty"` + // IsDefault: Whether the auth config is the default one. + IsDefault bool `json:"isDefault,omitempty"` // ForceSendFields is a list of field names (e.g. "AuthKey") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See @@ -886,6 +888,9 @@ type Connection struct { EventingEnablementType string `json:"eventingEnablementType,omitempty"` // EventingRuntimeData: Output only. Eventing Runtime Data. EventingRuntimeData *EventingRuntimeData `json:"eventingRuntimeData,omitempty"` + // Host: Output only. The name of the Hostname of the Service Directory service + // with TLS. + Host string `json:"host,omitempty"` // ImageLocation: Output only. GCR location where the runtime image is stored. // formatted like: gcr.io/{bucketName}/{imageName} ImageLocation string `json:"imageLocation,omitempty"` @@ -929,6 +934,9 @@ type Connection struct { // Suspended: Optional. Suspended indicates if a user has suspended a // connection or not. Suspended bool `json:"suspended,omitempty"` + // TlsServiceDirectory: Output only. The name of the Service Directory service + // with TLS. + TlsServiceDirectory string `json:"tlsServiceDirectory,omitempty"` // UpdateTime: Output only. Updated time. UpdateTime string `json:"updateTime,omitempty"` @@ -1192,6 +1200,8 @@ type ConnectorVersion struct { // EventingConfigTemplate: Output only. Eventing configuration supported by the // Connector. EventingConfigTemplate *EventingConfigTemplate `json:"eventingConfigTemplate,omitempty"` + // IsAsyncOperationsSupported: Output only. Is async operations supported. + IsAsyncOperationsSupported bool `json:"isAsyncOperationsSupported,omitempty"` // IsCustomActionsSupported: Output only. Is custom actions supported. IsCustomActionsSupported bool `json:"isCustomActionsSupported,omitempty"` // IsCustomEntitiesSupported: Output only. Is custom entities supported. diff --git a/container/v1/container-api.json b/container/v1/container-api.json index 66819344202..664b137d1f6 100644 --- a/container/v1/container-api.json +++ b/container/v1/container-api.json @@ -2540,7 +2540,7 @@ } } }, - "revision": "20240722", + "revision": "20240730", "rootUrl": "https://container.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -3394,6 +3394,10 @@ "readOnly": true, "type": "boolean" }, + "secretManagerConfig": { + "$ref": "SecretManagerConfig", + "description": "Secret CSI driver configuration." + }, "securityPostureConfig": { "$ref": "SecurityPostureConfig", "description": "Enable/Disable Security Posture API features for the cluster." @@ -3760,6 +3764,10 @@ "$ref": "ResourceUsageExportConfig", "description": "The desired configuration for exporting resource usage." }, + "desiredSecretManagerConfig": { + "$ref": "SecretManagerConfig", + "description": "Enable/Disable Secret Manager Config." + }, "desiredSecurityPostureConfig": { "$ref": "SecurityPostureConfig", "description": "Enable/Disable Security Posture API features for the cluster." @@ -5482,6 +5490,13 @@ "description": "Spot flag for enabling Spot VM, which is a rebrand of the existing preemptible flag.", "type": "boolean" }, + "storagePools": { + "description": "List of Storage Pools where boot disks are provisioned.", + "items": { + "type": "string" + }, + "type": "array" + }, "tags": { "description": "The list of instance tags applied to all nodes. Tags are used to identify valid sources or targets for network firewalls and are specified by the client during cluster or node pool creation. Each tag within the list must comply with RFC1035.", "items": { @@ -6621,6 +6636,17 @@ "properties": {}, "type": "object" }, + "SecretManagerConfig": { + "description": "SecretManagerConfig is config for secret manager enablement.", + "id": "SecretManagerConfig", + "properties": { + "enabled": { + "description": "Enable/Disable Secret Manager Config.", + "type": "boolean" + } + }, + "type": "object" + }, "SecurityBulletinEvent": { "description": "SecurityBulletinEvent is a notification sent to customers when a security bulletin has been posted that they are vulnerable to.", "id": "SecurityBulletinEvent", @@ -7581,6 +7607,13 @@ "$ref": "ResourceManagerTags", "description": "Desired resource manager tag keys and values to be attached to the nodes for managing Compute Engine firewalls using Network Firewall Policies. Existing tags will be replaced with new values." }, + "storagePools": { + "description": "List of Storage Pools where boot disks are provisioned. Existing Storage Pools will be replaced with storage-pools.", + "items": { + "type": "string" + }, + "type": "array" + }, "tags": { "$ref": "NetworkTags", "description": "The desired network tags to be applied to all nodes in the node pool. If this field is not present, the tags will not be changed. Otherwise, the existing network tags will be *replaced* with the provided tags." diff --git a/container/v1/container-gen.go b/container/v1/container-gen.go index 69e91b17e2e..3a801992b96 100644 --- a/container/v1/container-gen.go +++ b/container/v1/container-gen.go @@ -1277,6 +1277,8 @@ type Cluster struct { SatisfiesPzi bool `json:"satisfiesPzi,omitempty"` // SatisfiesPzs: Output only. Reserved for future use. SatisfiesPzs bool `json:"satisfiesPzs,omitempty"` + // SecretManagerConfig: Secret CSI driver configuration. + SecretManagerConfig *SecretManagerConfig `json:"secretManagerConfig,omitempty"` // SecurityPostureConfig: Enable/Disable Security Posture API features for the // cluster. SecurityPostureConfig *SecurityPostureConfig `json:"securityPostureConfig,omitempty"` @@ -1611,6 +1613,8 @@ type ClusterUpdate struct { // DesiredResourceUsageExportConfig: The desired configuration for exporting // resource usage. DesiredResourceUsageExportConfig *ResourceUsageExportConfig `json:"desiredResourceUsageExportConfig,omitempty"` + // DesiredSecretManagerConfig: Enable/Disable Secret Manager Config. + DesiredSecretManagerConfig *SecretManagerConfig `json:"desiredSecretManagerConfig,omitempty"` // DesiredSecurityPostureConfig: Enable/Disable Security Posture API features // for the cluster. DesiredSecurityPostureConfig *SecurityPostureConfig `json:"desiredSecurityPostureConfig,omitempty"` @@ -3966,6 +3970,8 @@ type NodeConfig struct { // Spot: Spot flag for enabling Spot VM, which is a rebrand of the existing // preemptible flag. Spot bool `json:"spot,omitempty"` + // StoragePools: List of Storage Pools where boot disks are provisioned. + StoragePools []string `json:"storagePools,omitempty"` // Tags: The list of instance tags applied to all nodes. Tags are used to // identify valid sources or targets for network firewalls and are specified by // the client during cluster or node pool creation. Each tag within the list @@ -5497,6 +5503,29 @@ func (s SecondaryBootDisk) MarshalJSON() ([]byte, error) { type SecondaryBootDiskUpdateStrategy struct { } +// SecretManagerConfig: SecretManagerConfig is config for secret manager +// enablement. +type SecretManagerConfig struct { + // Enabled: Enable/Disable Secret Manager Config. + Enabled bool `json:"enabled,omitempty"` + // ForceSendFields is a list of field names (e.g. "Enabled") 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. "Enabled") 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 SecretManagerConfig) MarshalJSON() ([]byte, error) { + type NoMethod SecretManagerConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // SecurityBulletinEvent: SecurityBulletinEvent is a notification sent to // customers when a security bulletin has been posted that they are vulnerable // to. @@ -6715,6 +6744,9 @@ type UpdateNodePoolRequest struct { // attached to the nodes for managing Compute Engine firewalls using Network // Firewall Policies. Existing tags will be replaced with new values. ResourceManagerTags *ResourceManagerTags `json:"resourceManagerTags,omitempty"` + // StoragePools: List of Storage Pools where boot disks are provisioned. + // Existing Storage Pools will be replaced with storage-pools. + StoragePools []string `json:"storagePools,omitempty"` // Tags: The desired network tags to be applied to all nodes in the node pool. // If this field is not present, the tags will not be changed. Otherwise, the // existing network tags will be *replaced* with the provided tags. diff --git a/container/v1beta1/container-api.json b/container/v1beta1/container-api.json index 10e0f18574b..d3387a22555 100644 --- a/container/v1beta1/container-api.json +++ b/container/v1beta1/container-api.json @@ -2565,7 +2565,7 @@ } } }, - "revision": "20240722", + "revision": "20240730", "rootUrl": "https://container.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -5930,6 +5930,13 @@ "description": "Spot flag for enabling Spot VM, which is a rebrand of the existing preemptible flag.", "type": "boolean" }, + "storagePools": { + "description": "List of Storage Pools where boot disks are provisioned.", + "items": { + "type": "string" + }, + "type": "array" + }, "tags": { "description": "The list of instance tags applied to all nodes. Tags are used to identify valid sources or targets for network firewalls and are specified by the client during cluster or node pool creation. Each tag within the list must comply with RFC1035.", "items": { @@ -7160,7 +7167,7 @@ "id": "SecretManagerConfig", "properties": { "enabled": { - "description": "Whether the cluster is configured to use secret manager CSI component.", + "description": "Enable/Disable Secret Manager Config.", "type": "boolean" } }, @@ -8152,6 +8159,13 @@ "$ref": "ResourceManagerTags", "description": "Desired resource manager tag keys and values to be attached to the nodes for managing Compute Engine firewalls using Network Firewall Policies. Existing tags will be replaced with new values." }, + "storagePools": { + "description": "List of Storage Pools where boot disks are provisioned. Existing Storage Pools will be replaced with storage-pools.", + "items": { + "type": "string" + }, + "type": "array" + }, "tags": { "$ref": "NetworkTags", "description": "The desired network tags to be applied to all nodes in the node pool. If this field is not present, the tags will not be changed. Otherwise, the existing network tags will be *replaced* with the provided tags." diff --git a/container/v1beta1/container-gen.go b/container/v1beta1/container-gen.go index d9bd4f26d70..1c1781b6481 100644 --- a/container/v1beta1/container-gen.go +++ b/container/v1beta1/container-gen.go @@ -4458,6 +4458,8 @@ type NodeConfig struct { // Spot: Spot flag for enabling Spot VM, which is a rebrand of the existing // preemptible flag. Spot bool `json:"spot,omitempty"` + // StoragePools: List of Storage Pools where boot disks are provisioned. + StoragePools []string `json:"storagePools,omitempty"` // Tags: The list of instance tags applied to all nodes. Tags are used to // identify valid sources or targets for network firewalls and are specified by // the client during cluster or node pool creation. Each tag within the list @@ -6110,8 +6112,7 @@ type SecondaryBootDiskUpdateStrategy struct { // SecretManagerConfig: SecretManagerConfig is config for secret manager // enablement. type SecretManagerConfig struct { - // Enabled: Whether the cluster is configured to use secret manager CSI - // component. + // Enabled: Enable/Disable Secret Manager Config. Enabled bool `json:"enabled,omitempty"` // ForceSendFields is a list of field names (e.g. "Enabled") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -7377,6 +7378,9 @@ type UpdateNodePoolRequest struct { // attached to the nodes for managing Compute Engine firewalls using Network // Firewall Policies. Existing tags will be replaced with new values. ResourceManagerTags *ResourceManagerTags `json:"resourceManagerTags,omitempty"` + // StoragePools: List of Storage Pools where boot disks are provisioned. + // Existing Storage Pools will be replaced with storage-pools. + StoragePools []string `json:"storagePools,omitempty"` // Tags: The desired network tags to be applied to all nodes in the node pool. // If this field is not present, the tags will not be changed. Otherwise, the // existing network tags will be *replaced* with the provided tags. diff --git a/dataflow/v1b3/dataflow-api.json b/dataflow/v1b3/dataflow-api.json index 44dd2943209..9287e04ffd1 100644 --- a/dataflow/v1b3/dataflow-api.json +++ b/dataflow/v1b3/dataflow-api.json @@ -84,6 +84,11 @@ "endpointUrl": "https://dataflow.us-west2.rep.googleapis.com/", "location": "us-west2" }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataflow.us-west3.rep.googleapis.com/", + "location": "us-west3" + }, { "description": "Regional Endpoint", "endpointUrl": "https://dataflow.us-west4.rep.googleapis.com/", @@ -1852,7 +1857,7 @@ "templates": { "methods": { "create": { - "description": "Creates a Cloud Dataflow job from a template. Do not enter confidential information when you supply string values using the API.", + "description": "Creates a Cloud Dataflow job from a template. Do not enter confidential information when you supply string values using the API. To create a job, we recommend using `projects.locations.templates.create` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.templates.create` is not recommended, because your job will always start in `us-central1`.", "flatPath": "v1b3/projects/{projectId}/locations/{location}/templates", "httpMethod": "POST", "id": "dataflow.projects.locations.templates.create", @@ -1887,7 +1892,7 @@ ] }, "get": { - "description": "Get the template associated with a template.", + "description": "Get the template associated with a template. To get the template, we recommend using `projects.locations.templates.get` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.templates.get` is not recommended, because only templates that are running in `us-central1` are retrieved.", "flatPath": "v1b3/projects/{projectId}/locations/{location}/templates:get", "httpMethod": "GET", "id": "dataflow.projects.locations.templates.get", @@ -1935,7 +1940,7 @@ ] }, "launch": { - "description": "Launch a template.", + "description": "Launches a template. To launch a template, we recommend using `projects.locations.templates.launch` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.templates.launch` is not recommended, because jobs launched from the template will always start in `us-central1`.", "flatPath": "v1b3/projects/{projectId}/locations/{location}/templates:launch", "httpMethod": "POST", "id": "dataflow.projects.locations.templates.launch", @@ -2072,7 +2077,7 @@ "templates": { "methods": { "create": { - "description": "Creates a Cloud Dataflow job from a template. Do not enter confidential information when you supply string values using the API.", + "description": "Creates a Cloud Dataflow job from a template. Do not enter confidential information when you supply string values using the API. To create a job, we recommend using `projects.locations.templates.create` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.templates.create` is not recommended, because your job will always start in `us-central1`.", "flatPath": "v1b3/projects/{projectId}/templates", "httpMethod": "POST", "id": "dataflow.projects.templates.create", @@ -2100,7 +2105,7 @@ ] }, "get": { - "description": "Get the template associated with a template.", + "description": "Get the template associated with a template. To get the template, we recommend using `projects.locations.templates.get` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.templates.get` is not recommended, because only templates that are running in `us-central1` are retrieved.", "flatPath": "v1b3/projects/{projectId}/templates:get", "httpMethod": "GET", "id": "dataflow.projects.templates.get", @@ -2146,7 +2151,7 @@ ] }, "launch": { - "description": "Launch a template.", + "description": "Launches a template. To launch a template, we recommend using `projects.locations.templates.launch` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.templates.launch` is not recommended, because jobs launched from the template will always start in `us-central1`.", "flatPath": "v1b3/projects/{projectId}/templates:launch", "httpMethod": "POST", "id": "dataflow.projects.templates.launch", @@ -2203,7 +2208,7 @@ } } }, - "revision": "20240709", + "revision": "20240807", "rootUrl": "https://dataflow.googleapis.com/", "schemas": { "ApproximateProgress": { @@ -4413,6 +4418,11 @@ "description": "The [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that contains the WorkItem's job.", "type": "string" }, + "projectNumber": { + "description": "Optional. The project number of the project this worker belongs to.", + "format": "int64", + "type": "string" + }, "requestedLeaseDuration": { "description": "The initial lease period.", "format": "google-duration", @@ -5375,6 +5385,11 @@ "description": "The [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that contains the WorkItem's job.", "type": "string" }, + "projectNumber": { + "description": "Optional. The project number of the project which owns the WorkItem's job.", + "format": "int64", + "type": "string" + }, "unifiedWorkerRequest": { "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL.", diff --git a/dataflow/v1b3/dataflow-gen.go b/dataflow/v1b3/dataflow-gen.go index bb50268af7d..4ec4c5258bf 100644 --- a/dataflow/v1b3/dataflow-gen.go +++ b/dataflow/v1b3/dataflow-gen.go @@ -3164,6 +3164,9 @@ type LeaseWorkItemRequest struct { // (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that // contains the WorkItem's job. Location string `json:"location,omitempty"` + // ProjectNumber: Optional. The project number of the project this worker + // belongs to. + ProjectNumber int64 `json:"projectNumber,omitempty,string"` // RequestedLeaseDuration: The initial lease period. RequestedLeaseDuration string `json:"requestedLeaseDuration,omitempty"` // UnifiedWorkerRequest: Untranslated bag-of-bytes WorkRequest from @@ -4320,6 +4323,9 @@ type ReportWorkItemStatusRequest struct { // (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that // contains the WorkItem's job. Location string `json:"location,omitempty"` + // ProjectNumber: Optional. The project number of the project which owns the + // WorkItem's job. + ProjectNumber int64 `json:"projectNumber,omitempty,string"` // UnifiedWorkerRequest: Untranslated bag-of-bytes WorkProgressUpdateRequest // from UnifiedWorker. UnifiedWorkerRequest googleapi.RawMessage `json:"unifiedWorkerRequest,omitempty"` @@ -11837,7 +11843,12 @@ type ProjectsLocationsTemplatesCreateCall struct { } // Create: Creates a Cloud Dataflow job from a template. Do not enter -// confidential information when you supply string values using the API. +// confidential information when you supply string values using the API. To +// create a job, we recommend using `projects.locations.templates.create` with +// a [regional endpoint] +// (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using +// `projects.templates.create` is not recommended, because your job will always +// start in `us-central1`. // // - location: The [regional endpoint] // (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) to @@ -11944,7 +11955,12 @@ type ProjectsLocationsTemplatesGetCall struct { header_ http.Header } -// Get: Get the template associated with a template. +// Get: Get the template associated with a template. To get the template, we +// recommend using `projects.locations.templates.get` with a [regional +// endpoint] +// (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using +// `projects.templates.get` is not recommended, because only templates that are +// running in `us-central1` are retrieved. // // - location: The [regional endpoint] // (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) to @@ -12079,7 +12095,11 @@ type ProjectsLocationsTemplatesLaunchCall struct { header_ http.Header } -// Launch: Launch a template. +// Launch: Launches a template. To launch a template, we recommend using +// `projects.locations.templates.launch` with a [regional endpoint] +// (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using +// `projects.templates.launch` is not recommended, because jobs launched from +// the template will always start in `us-central1`. // // - location: The [regional endpoint] // (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) to @@ -12460,7 +12480,12 @@ type ProjectsTemplatesCreateCall struct { } // Create: Creates a Cloud Dataflow job from a template. Do not enter -// confidential information when you supply string values using the API. +// confidential information when you supply string values using the API. To +// create a job, we recommend using `projects.locations.templates.create` with +// a [regional endpoint] +// (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using +// `projects.templates.create` is not recommended, because your job will always +// start in `us-central1`. // // - projectId: The ID of the Cloud Platform project that the job belongs to. func (r *ProjectsTemplatesService) Create(projectId string, createjobfromtemplaterequest *CreateJobFromTemplateRequest) *ProjectsTemplatesCreateCall { @@ -12561,7 +12586,12 @@ type ProjectsTemplatesGetCall struct { header_ http.Header } -// Get: Get the template associated with a template. +// Get: Get the template associated with a template. To get the template, we +// recommend using `projects.locations.templates.get` with a [regional +// endpoint] +// (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using +// `projects.templates.get` is not recommended, because only templates that are +// running in `us-central1` are retrieved. // // - projectId: The ID of the Cloud Platform project that the job belongs to. func (r *ProjectsTemplatesService) Get(projectId string) *ProjectsTemplatesGetCall { @@ -12698,7 +12728,11 @@ type ProjectsTemplatesLaunchCall struct { header_ http.Header } -// Launch: Launch a template. +// Launch: Launches a template. To launch a template, we recommend using +// `projects.locations.templates.launch` with a [regional endpoint] +// (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using +// `projects.templates.launch` is not recommended, because jobs launched from +// the template will always start in `us-central1`. // // - projectId: The ID of the Cloud Platform project that the job belongs to. func (r *ProjectsTemplatesService) Launch(projectId string, launchtemplateparameters *LaunchTemplateParameters) *ProjectsTemplatesLaunchCall { diff --git a/datamigration/v1/datamigration-api.json b/datamigration/v1/datamigration-api.json index 29ebed027b3..017c9097240 100644 --- a/datamigration/v1/datamigration-api.json +++ b/datamigration/v1/datamigration-api.json @@ -1760,6 +1760,99 @@ "https://www.googleapis.com/auth/cloud-platform" ] } + }, + "resources": { + "objects": { + "methods": { + "getIamPolicy": { + "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/migrationJobs/{migrationJobsId}/objects/{objectsId}:getIamPolicy", + "httpMethod": "GET", + "id": "datamigration.projects.locations.migrationJobs.objects.getIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "options.requestedPolicyVersion": { + "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", + "format": "int32", + "location": "query", + "type": "integer" + }, + "resource": { + "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/migrationJobs/[^/]+/objects/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/migrationJobs/{migrationJobsId}/objects/{objectsId}:setIamPolicy", + "httpMethod": "POST", + "id": "datamigration.projects.locations.migrationJobs.objects.setIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/migrationJobs/[^/]+/objects/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:setIamPolicy", + "request": { + "$ref": "SetIamPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/migrationJobs/{migrationJobsId}/objects/{objectsId}:testIamPermissions", + "httpMethod": "POST", + "id": "datamigration.projects.locations.migrationJobs.objects.testIamPermissions", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/migrationJobs/[^/]+/objects/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:testIamPermissions", + "request": { + "$ref": "TestIamPermissionsRequest" + }, + "response": { + "$ref": "TestIamPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } } }, "operations": { @@ -2125,7 +2218,7 @@ } } }, - "revision": "20240721", + "revision": "20240812", "rootUrl": "https://datamigration.googleapis.com/", "schemas": { "AlloyDbConnectionProfile": { @@ -2532,6 +2625,7 @@ "MYSQL_8_0_35", "MYSQL_8_0_36", "MYSQL_8_0_37", + "MYSQL_8_4", "POSTGRES_9_6", "POSTGRES_11", "POSTGRES_10", @@ -2558,6 +2652,7 @@ "The database major version is MySQL 8.0 and the minor version is 35.", "The database major version is MySQL 8.0 and the minor version is 36.", "The database major version is MySQL 8.0 and the minor version is 37.", + "MySQL 8.4.", "PostgreSQL 9.6.", "PostgreSQL 11.", "PostgreSQL 10.", @@ -4820,6 +4915,43 @@ }, "type": "object" }, + "OracleAsmConfig": { + "description": "Configuration for Oracle Automatic Storage Management (ASM) connection.", + "id": "OracleAsmConfig", + "properties": { + "asmService": { + "description": "Required. ASM service name for the Oracle ASM connection.", + "type": "string" + }, + "hostname": { + "description": "Required. Hostname for the Oracle ASM connection.", + "type": "string" + }, + "password": { + "description": "Required. Input only. Password for the Oracle ASM connection.", + "type": "string" + }, + "passwordSet": { + "description": "Output only. Indicates whether a new password is included in the request.", + "readOnly": true, + "type": "boolean" + }, + "port": { + "description": "Required. Port for the Oracle ASM connection.", + "format": "int32", + "type": "integer" + }, + "ssl": { + "$ref": "SslConfig", + "description": "Optional. SSL configuration for the Oracle connection." + }, + "username": { + "description": "Required. Username for the Oracle ASM connection.", + "type": "string" + } + }, + "type": "object" + }, "OracleConnectionProfile": { "description": "Specifies connection parameters required specifically for Oracle databases.", "id": "OracleConnectionProfile", @@ -4836,6 +4968,10 @@ "description": "Required. The IP or hostname of the source Oracle database.", "type": "string" }, + "oracleAsmConfig": { + "$ref": "OracleAsmConfig", + "description": "Optional. Configuration for Oracle ASM connection." + }, "password": { "description": "Required. Input only. The password for the user that Database Migration Service will be using to connect to the database. This field is not returned on request, and the value is encrypted when stored in Database Migration Service.", "type": "string" diff --git a/datamigration/v1/datamigration-gen.go b/datamigration/v1/datamigration-gen.go index e7fc7e27f38..4e711297e3d 100644 --- a/datamigration/v1/datamigration-gen.go +++ b/datamigration/v1/datamigration-gen.go @@ -222,11 +222,23 @@ type ProjectsLocationsConversionWorkspacesMappingRulesService struct { func NewProjectsLocationsMigrationJobsService(s *Service) *ProjectsLocationsMigrationJobsService { rs := &ProjectsLocationsMigrationJobsService{s: s} + rs.Objects = NewProjectsLocationsMigrationJobsObjectsService(s) return rs } type ProjectsLocationsMigrationJobsService struct { s *Service + + Objects *ProjectsLocationsMigrationJobsObjectsService +} + +func NewProjectsLocationsMigrationJobsObjectsService(s *Service) *ProjectsLocationsMigrationJobsObjectsService { + rs := &ProjectsLocationsMigrationJobsObjectsService{s: s} + return rs +} + +type ProjectsLocationsMigrationJobsObjectsService struct { + s *Service } func NewProjectsLocationsOperationsService(s *Service) *ProjectsLocationsOperationsService { @@ -790,6 +802,7 @@ type CloudSqlSettings struct { // version is 36. // "MYSQL_8_0_37" - The database major version is MySQL 8.0 and the minor // version is 37. + // "MYSQL_8_4" - MySQL 8.4. // "POSTGRES_9_6" - PostgreSQL 9.6. // "POSTGRES_11" - PostgreSQL 11. // "POSTGRES_10" - PostgreSQL 10. @@ -3158,6 +3171,42 @@ func (s Operation) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// OracleAsmConfig: Configuration for Oracle Automatic Storage Management (ASM) +// connection. +type OracleAsmConfig struct { + // AsmService: Required. ASM service name for the Oracle ASM connection. + AsmService string `json:"asmService,omitempty"` + // Hostname: Required. Hostname for the Oracle ASM connection. + Hostname string `json:"hostname,omitempty"` + // Password: Required. Input only. Password for the Oracle ASM connection. + Password string `json:"password,omitempty"` + // PasswordSet: Output only. Indicates whether a new password is included in + // the request. + PasswordSet bool `json:"passwordSet,omitempty"` + // Port: Required. Port for the Oracle ASM connection. + Port int64 `json:"port,omitempty"` + // Ssl: Optional. SSL configuration for the Oracle connection. + Ssl *SslConfig `json:"ssl,omitempty"` + // Username: Required. Username for the Oracle ASM connection. + Username string `json:"username,omitempty"` + // ForceSendFields is a list of field names (e.g. "AsmService") 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. "AsmService") 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 OracleAsmConfig) MarshalJSON() ([]byte, error) { + type NoMethod OracleAsmConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // OracleConnectionProfile: Specifies connection parameters required // specifically for Oracle databases. type OracleConnectionProfile struct { @@ -3167,6 +3216,8 @@ type OracleConnectionProfile struct { ForwardSshConnectivity *ForwardSshTunnelConnectivity `json:"forwardSshConnectivity,omitempty"` // Host: Required. The IP or hostname of the source Oracle database. Host string `json:"host,omitempty"` + // OracleAsmConfig: Optional. Configuration for Oracle ASM connection. + OracleAsmConfig *OracleAsmConfig `json:"oracleAsmConfig,omitempty"` // Password: Required. Input only. The password for the user that Database // Migration Service will be using to connect to the database. This field is // not returned on request, and the value is encrypted when stored in Database @@ -10856,6 +10907,347 @@ func (c *ProjectsLocationsMigrationJobsVerifyCall) Do(opts ...googleapi.CallOpti return ret, nil } +type ProjectsLocationsMigrationJobsObjectsGetIamPolicyCall struct { + s *Service + resource string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetIamPolicy: Gets the access control policy for a resource. Returns an +// empty policy if the resource exists and does not have a policy set. +// +// - resource: REQUIRED: The resource for which the policy is being requested. +// See Resource names (https://cloud.google.com/apis/design/resource_names) +// for the appropriate value for this field. +func (r *ProjectsLocationsMigrationJobsObjectsService) GetIamPolicy(resource string) *ProjectsLocationsMigrationJobsObjectsGetIamPolicyCall { + c := &ProjectsLocationsMigrationJobsObjectsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + return c +} + +// OptionsRequestedPolicyVersion sets the optional parameter +// "options.requestedPolicyVersion": The maximum policy version that will be +// used to format the policy. Valid values are 0, 1, and 3. Requests specifying +// an invalid value will be rejected. Requests for policies with any +// conditional role bindings must specify version 3. Policies with no +// conditional role bindings may specify any valid value or leave the field +// unset. The policy in the response might use the policy version that you +// specified, or it might use a lower policy version. For example, if you +// specify version 3, but the policy has no conditional role bindings, the +// response uses version 1. To learn which resources support conditions in +// their IAM policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +func (c *ProjectsLocationsMigrationJobsObjectsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsMigrationJobsObjectsGetIamPolicyCall { + c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) + 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 *ProjectsLocationsMigrationJobsObjectsGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsMigrationJobsObjectsGetIamPolicyCall { + 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 *ProjectsLocationsMigrationJobsObjectsGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsMigrationJobsObjectsGetIamPolicyCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsMigrationJobsObjectsGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsMigrationJobsObjectsGetIamPolicyCall { + 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 *ProjectsLocationsMigrationJobsObjectsGetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsMigrationJobsObjectsGetIamPolicyCall) 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, "v1/{+resource}:getIamPolicy") + 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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "datamigration.projects.locations.migrationJobs.objects.getIamPolicy" call. +// Any non-2xx status code is an error. Response headers are in either +// *Policy.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 *ProjectsLocationsMigrationJobsObjectsGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, 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 := &Policy{ + 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 ProjectsLocationsMigrationJobsObjectsSetIamPolicyCall struct { + s *Service + resource string + setiampolicyrequest *SetIamPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetIamPolicy: Sets the access control policy on the specified resource. +// Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, +// and `PERMISSION_DENIED` errors. +// +// - resource: REQUIRED: The resource for which the policy is being specified. +// See Resource names (https://cloud.google.com/apis/design/resource_names) +// for the appropriate value for this field. +func (r *ProjectsLocationsMigrationJobsObjectsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsMigrationJobsObjectsSetIamPolicyCall { + c := &ProjectsLocationsMigrationJobsObjectsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.setiampolicyrequest = setiampolicyrequest + 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 *ProjectsLocationsMigrationJobsObjectsSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsMigrationJobsObjectsSetIamPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsMigrationJobsObjectsSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsMigrationJobsObjectsSetIamPolicyCall { + 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 *ProjectsLocationsMigrationJobsObjectsSetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsMigrationJobsObjectsSetIamPolicyCall) 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.setiampolicyrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:setIamPolicy") + 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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "datamigration.projects.locations.migrationJobs.objects.setIamPolicy" call. +// Any non-2xx status code is an error. Response headers are in either +// *Policy.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 *ProjectsLocationsMigrationJobsObjectsSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, 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 := &Policy{ + 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 ProjectsLocationsMigrationJobsObjectsTestIamPermissionsCall struct { + s *Service + resource string + testiampermissionsrequest *TestIamPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// TestIamPermissions: Returns permissions that a caller has on the specified +// resource. If the resource does not exist, this will return an empty set of +// permissions, not a `NOT_FOUND` error. Note: This operation is designed to be +// used for building permission-aware UIs and command-line tools, not for +// authorization checking. This operation may "fail open" without warning. +// +// - resource: REQUIRED: The resource for which the policy detail is being +// requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the appropriate +// value for this field. +func (r *ProjectsLocationsMigrationJobsObjectsService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsMigrationJobsObjectsTestIamPermissionsCall { + c := &ProjectsLocationsMigrationJobsObjectsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.testiampermissionsrequest = testiampermissionsrequest + 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 *ProjectsLocationsMigrationJobsObjectsTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsMigrationJobsObjectsTestIamPermissionsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsMigrationJobsObjectsTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsMigrationJobsObjectsTestIamPermissionsCall { + 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 *ProjectsLocationsMigrationJobsObjectsTestIamPermissionsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsMigrationJobsObjectsTestIamPermissionsCall) 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.testiampermissionsrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:testIamPermissions") + 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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "datamigration.projects.locations.migrationJobs.objects.testIamPermissions" call. +// Any non-2xx status code is an error. Response headers are in either +// *TestIamPermissionsResponse.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 *ProjectsLocationsMigrationJobsObjectsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestIamPermissionsResponse, 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 := &TestIamPermissionsResponse{ + 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 ProjectsLocationsOperationsCancelCall struct { s *Service name string diff --git a/dialogflow/v2/dialogflow-api.json b/dialogflow/v2/dialogflow-api.json index 5399e4753f6..d745fe9c882 100644 --- a/dialogflow/v2/dialogflow-api.json +++ b/dialogflow/v2/dialogflow-api.json @@ -8714,7 +8714,7 @@ } } }, - "revision": "20240724", + "revision": "20240812", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AdvancedSettings": { @@ -9018,17 +9018,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3CreateDocumentOperationMetadata": { - "description": "Metadata for CreateDocument operation.", - "id": "GoogleCloudDialogflowCxV3CreateDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3CreateVersionOperationMetadata": { "description": "Metadata associated with the long running operation for Versions.CreateVersion.", "id": "GoogleCloudDialogflowCxV3CreateVersionOperationMetadata", @@ -9067,17 +9056,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3DeleteDocumentOperationMetadata": { - "description": "Metadata for DeleteDocument operation.", - "id": "GoogleCloudDialogflowCxV3DeleteDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3DeployFlowMetadata": { "description": "Metadata returned for the Environments.DeployFlow long running operation.", "id": "GoogleCloudDialogflowCxV3DeployFlowMetadata", @@ -9544,55 +9522,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata": { - "description": "Metadata in google::longrunning::Operation for Knowledge operations.", - "id": "GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata", - "properties": { - "state": { - "description": "Required. Output only. The current state of this operation.", - "enum": [ - "STATE_UNSPECIFIED", - "PENDING", - "RUNNING", - "DONE" - ], - "enumDescriptions": [ - "State unspecified.", - "The operation has been created.", - "The operation is currently running.", - "The operation is done, either cancelled or completed." - ], - "readOnly": true, - "type": "string" - } - }, - "type": "object" - }, - "GoogleCloudDialogflowCxV3ImportDocumentsOperationMetadata": { - "description": "Metadata for ImportDocuments operation.", - "id": "GoogleCloudDialogflowCxV3ImportDocumentsOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, - "GoogleCloudDialogflowCxV3ImportDocumentsResponse": { - "description": "Response message for Documents.ImportDocuments.", - "id": "GoogleCloudDialogflowCxV3ImportDocumentsResponse", - "properties": { - "warnings": { - "description": "Includes details about skipped documents or any other warnings.", - "items": { - "$ref": "GoogleRpcStatus" - }, - "type": "array" - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3ImportEntityTypesMetadata": { "description": "Metadata returned for the EntityTypes.ImportEntityTypes long running operation.", "id": "GoogleCloudDialogflowCxV3ImportEntityTypesMetadata", @@ -10144,17 +10073,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3ReloadDocumentOperationMetadata": { - "description": "Metadata for ReloadDocument operation.", - "id": "GoogleCloudDialogflowCxV3ReloadDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3ResponseMessage": { "description": "Represents a response message that can be returned by a conversational agent. Response messages are also used for output audio synthesis. The approach is as follows: * If at least one OutputAudioText response is present, then all OutputAudioText responses are linearly concatenated, and the result is used for output audio synthesis. * If the OutputAudioText responses are a mixture of text and SSML, then the concatenated result is treated as SSML; otherwise, the result is treated as either text or SSML as appropriate. The agent designer should ideally use either text or SSML consistently throughout the bot design. * Otherwise, all Text responses are linearly concatenated, and the result is used for output audio synthesis. This approach allows for more sophisticated user experience scenarios, where the text displayed to the user may differ from what is heard.", "id": "GoogleCloudDialogflowCxV3ResponseMessage", @@ -10362,7 +10280,7 @@ "type": "boolean" }, "text": { - "description": "Required. A collection of text responses.", + "description": "Required. A collection of text response variants. If multiple variants are defined, only one text response variant is returned at runtime.", "items": { "type": "string" }, @@ -10719,17 +10637,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3UpdateDocumentOperationMetadata": { - "description": "Metadata for UpdateDocument operation.", - "id": "GoogleCloudDialogflowCxV3UpdateDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3Webhook": { "description": "Webhooks host the developer's business logic. During a session, webhooks allow the developer to use the data extracted by Dialogflow's natural language processing to generate dynamic responses, validate collected data, or trigger actions on the backend.", "id": "GoogleCloudDialogflowCxV3Webhook", @@ -11416,17 +11323,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3beta1CreateDocumentOperationMetadata": { - "description": "Metadata for CreateDocument operation.", - "id": "GoogleCloudDialogflowCxV3beta1CreateDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3beta1CreateVersionOperationMetadata": { "description": "Metadata associated with the long running operation for Versions.CreateVersion.", "id": "GoogleCloudDialogflowCxV3beta1CreateVersionOperationMetadata", @@ -11465,17 +11361,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3beta1DeleteDocumentOperationMetadata": { - "description": "Metadata for DeleteDocument operation.", - "id": "GoogleCloudDialogflowCxV3beta1DeleteDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3beta1DeployFlowMetadata": { "description": "Metadata returned for the Environments.DeployFlow long running operation.", "id": "GoogleCloudDialogflowCxV3beta1DeployFlowMetadata", @@ -11942,55 +11827,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata": { - "description": "Metadata in google::longrunning::Operation for Knowledge operations.", - "id": "GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata", - "properties": { - "state": { - "description": "Required. Output only. The current state of this operation.", - "enum": [ - "STATE_UNSPECIFIED", - "PENDING", - "RUNNING", - "DONE" - ], - "enumDescriptions": [ - "State unspecified.", - "The operation has been created.", - "The operation is currently running.", - "The operation is done, either cancelled or completed." - ], - "readOnly": true, - "type": "string" - } - }, - "type": "object" - }, - "GoogleCloudDialogflowCxV3beta1ImportDocumentsOperationMetadata": { - "description": "Metadata for ImportDocuments operation.", - "id": "GoogleCloudDialogflowCxV3beta1ImportDocumentsOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, - "GoogleCloudDialogflowCxV3beta1ImportDocumentsResponse": { - "description": "Response message for Documents.ImportDocuments.", - "id": "GoogleCloudDialogflowCxV3beta1ImportDocumentsResponse", - "properties": { - "warnings": { - "description": "Includes details about skipped documents or any other warnings.", - "items": { - "$ref": "GoogleRpcStatus" - }, - "type": "array" - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3beta1ImportEntityTypesMetadata": { "description": "Metadata returned for the EntityTypes.ImportEntityTypes long running operation.", "id": "GoogleCloudDialogflowCxV3beta1ImportEntityTypesMetadata", @@ -12546,17 +12382,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3beta1ReloadDocumentOperationMetadata": { - "description": "Metadata for ReloadDocument operation.", - "id": "GoogleCloudDialogflowCxV3beta1ReloadDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3beta1ResponseMessage": { "description": "Represents a response message that can be returned by a conversational agent. Response messages are also used for output audio synthesis. The approach is as follows: * If at least one OutputAudioText response is present, then all OutputAudioText responses are linearly concatenated, and the result is used for output audio synthesis. * If the OutputAudioText responses are a mixture of text and SSML, then the concatenated result is treated as SSML; otherwise, the result is treated as either text or SSML as appropriate. The agent designer should ideally use either text or SSML consistently throughout the bot design. * Otherwise, all Text responses are linearly concatenated, and the result is used for output audio synthesis. This approach allows for more sophisticated user experience scenarios, where the text displayed to the user may differ from what is heard.", "id": "GoogleCloudDialogflowCxV3beta1ResponseMessage", @@ -12752,7 +12577,7 @@ "type": "boolean" }, "text": { - "description": "Required. A collection of text responses.", + "description": "Required. A collection of text response variants. If multiple variants are defined, only one text response variant is returned at runtime.", "items": { "type": "string" }, @@ -13170,17 +12995,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3beta1UpdateDocumentOperationMetadata": { - "description": "Metadata for UpdateDocument operation.", - "id": "GoogleCloudDialogflowCxV3beta1UpdateDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3beta1Webhook": { "description": "Webhooks host the developer's business logic. During a session, webhooks allow the developer to use the data extracted by Dialogflow's natural language processing to generate dynamic responses, validate collected data, or trigger actions on the backend.", "id": "GoogleCloudDialogflowCxV3beta1Webhook", @@ -18415,7 +18229,7 @@ "description": "Required. The natural language text query for knowledge search." }, "sessionId": { - "description": "Optional. The ID of the search session. The session_id can be combined with Dialogflow V3 Agent ID retrieved from conversation profile or on its own to identify a search session. The search history of the same session will impact the search result. It's up to the API caller to choose an appropriate `Session ID`. It can be a random number or some type of session identifiers (preferably hashed). The length must not exceed 36 characters.", + "description": "Required. The ID of the search session. The session_id can be combined with Dialogflow V3 Agent ID retrieved from conversation profile or on its own to identify a search session. The search history of the same session will impact the search result. It's up to the API caller to choose an appropriate `Session ID`. It can be a random number or some type of session identifiers (preferably hashed). The length must not exceed 36 characters.", "type": "string" } }, @@ -21668,7 +21482,7 @@ "id": "GoogleCloudDialogflowV2beta1ResponseMessageText", "properties": { "text": { - "description": "A collection of text responses.", + "description": "A collection of text response variants. If multiple variants are defined, only one text response variant is returned at runtime.", "items": { "type": "string" }, @@ -22058,88 +21872,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowV3alpha1CreateDocumentOperationMetadata": { - "description": "Metadata for CreateDocument operation.", - "id": "GoogleCloudDialogflowV3alpha1CreateDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, - "GoogleCloudDialogflowV3alpha1DeleteDocumentOperationMetadata": { - "description": "Metadata for DeleteDocument operation.", - "id": "GoogleCloudDialogflowV3alpha1DeleteDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, - "GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata": { - "description": "Metadata in google::longrunning::Operation for Knowledge operations.", - "id": "GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata", - "properties": { - "state": { - "description": "Required. Output only. The current state of this operation.", - "enum": [ - "STATE_UNSPECIFIED", - "PENDING", - "RUNNING", - "DONE" - ], - "enumDescriptions": [ - "State unspecified.", - "The operation has been created.", - "The operation is currently running.", - "The operation is done, either cancelled or completed." - ], - "readOnly": true, - "type": "string" - } - }, - "type": "object" - }, - "GoogleCloudDialogflowV3alpha1ImportDocumentsOperationMetadata": { - "description": "Metadata for ImportDocuments operation.", - "id": "GoogleCloudDialogflowV3alpha1ImportDocumentsOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, - "GoogleCloudDialogflowV3alpha1ImportDocumentsResponse": { - "description": "Response message for Documents.ImportDocuments.", - "id": "GoogleCloudDialogflowV3alpha1ImportDocumentsResponse", - "properties": { - "warnings": { - "description": "Includes details about skipped documents or any other warnings.", - "items": { - "$ref": "GoogleRpcStatus" - }, - "type": "array" - } - }, - "type": "object" - }, - "GoogleCloudDialogflowV3alpha1ReloadDocumentOperationMetadata": { - "description": "Metadata for ReloadDocument operation.", - "id": "GoogleCloudDialogflowV3alpha1ReloadDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowV3alpha1TurnSignals": { "description": "Collection of all signals that were extracted for a single turn of the conversation.", "id": "GoogleCloudDialogflowV3alpha1TurnSignals", @@ -22209,17 +21941,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowV3alpha1UpdateDocumentOperationMetadata": { - "description": "Metadata for UpdateDocument operation.", - "id": "GoogleCloudDialogflowV3alpha1UpdateDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudLocationListLocationsResponse": { "description": "The response message for Locations.ListLocations.", "id": "GoogleCloudLocationListLocationsResponse", diff --git a/dialogflow/v2/dialogflow-gen.go b/dialogflow/v2/dialogflow-gen.go index c0b1e1cd625..cbe7c2be9a7 100644 --- a/dialogflow/v2/dialogflow-gen.go +++ b/dialogflow/v2/dialogflow-gen.go @@ -1355,29 +1355,6 @@ func (s GoogleCloudDialogflowCxV3ConversationTurnVirtualAgentOutput) MarshalJSON return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowCxV3CreateDocumentOperationMetadata: Metadata for -// CreateDocument operation. -type GoogleCloudDialogflowCxV3CreateDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3CreateDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3CreateDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3CreateVersionOperationMetadata: Metadata associated // with the long running operation for Versions.CreateVersion. type GoogleCloudDialogflowCxV3CreateVersionOperationMetadata struct { @@ -1439,29 +1416,6 @@ func (s GoogleCloudDialogflowCxV3DataStoreConnection) MarshalJSON() ([]byte, err return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowCxV3DeleteDocumentOperationMetadata: Metadata for -// DeleteDocument operation. -type GoogleCloudDialogflowCxV3DeleteDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3DeleteDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3DeleteDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3DeployFlowMetadata: Metadata returned for the // Environments.DeployFlow long running operation. type GoogleCloudDialogflowCxV3DeployFlowMetadata struct { @@ -2193,81 +2147,6 @@ func (s GoogleCloudDialogflowCxV3GcsDestination) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata: Metadata in -// google::longrunning::Operation for Knowledge operations. -type GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata struct { - // State: Required. Output only. The current state of this operation. - // - // Possible values: - // "STATE_UNSPECIFIED" - State unspecified. - // "PENDING" - The operation has been created. - // "RUNNING" - The operation is currently running. - // "DONE" - The operation is done, either cancelled or completed. - State string `json:"state,omitempty"` - // ForceSendFields is a list of field names (e.g. "State") 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. "State") 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 GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowCxV3ImportDocumentsOperationMetadata: Metadata for -// ImportDocuments operation. -type GoogleCloudDialogflowCxV3ImportDocumentsOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3ImportDocumentsOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3ImportDocumentsOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowCxV3ImportDocumentsResponse: Response message for -// Documents.ImportDocuments. -type GoogleCloudDialogflowCxV3ImportDocumentsResponse struct { - // Warnings: Includes details about skipped documents or any other warnings. - Warnings []*GoogleRpcStatus `json:"warnings,omitempty"` - // ForceSendFields is a list of field names (e.g. "Warnings") 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. "Warnings") 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 GoogleCloudDialogflowCxV3ImportDocumentsResponse) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3ImportDocumentsResponse - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3ImportEntityTypesMetadata: Metadata returned for // the EntityTypes.ImportEntityTypes long running operation. type GoogleCloudDialogflowCxV3ImportEntityTypesMetadata struct { @@ -3081,29 +2960,6 @@ func (s GoogleCloudDialogflowCxV3QueryInput) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowCxV3ReloadDocumentOperationMetadata: Metadata for -// ReloadDocument operation. -type GoogleCloudDialogflowCxV3ReloadDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3ReloadDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3ReloadDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3ResponseMessage: Represents a response message that // can be returned by a conversational agent. Response messages are also used // for output audio synthesis. The approach is as follows: * If at least one @@ -3403,7 +3259,8 @@ type GoogleCloudDialogflowCxV3ResponseMessageText struct { // can be interrupted by the end user's speech and the client can then starts // the next Dialogflow request. AllowPlaybackInterruption bool `json:"allowPlaybackInterruption,omitempty"` - // Text: Required. A collection of text responses. + // Text: Required. A collection of text response variants. If multiple variants + // are defined, only one text response variant is returned at runtime. Text []string `json:"text,omitempty"` // ForceSendFields is a list of field names (e.g. "AllowPlaybackInterruption") // to unconditionally include in API requests. By default, fields with empty or @@ -3875,29 +3732,6 @@ func (s *GoogleCloudDialogflowCxV3TurnSignals) UnmarshalJSON(data []byte) error return nil } -// GoogleCloudDialogflowCxV3UpdateDocumentOperationMetadata: Metadata for -// UpdateDocument operation. -type GoogleCloudDialogflowCxV3UpdateDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3UpdateDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3UpdateDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3Webhook: Webhooks host the developer's business // logic. During a session, webhooks allow the developer to use the data // extracted by Dialogflow's natural language processing to generate dynamic @@ -4798,29 +4632,6 @@ func (s GoogleCloudDialogflowCxV3beta1ConversationTurnVirtualAgentOutput) Marsha return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowCxV3beta1CreateDocumentOperationMetadata: Metadata for -// CreateDocument operation. -type GoogleCloudDialogflowCxV3beta1CreateDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3beta1CreateDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3beta1CreateDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3beta1CreateVersionOperationMetadata: Metadata // associated with the long running operation for Versions.CreateVersion. type GoogleCloudDialogflowCxV3beta1CreateVersionOperationMetadata struct { @@ -4882,29 +4693,6 @@ func (s GoogleCloudDialogflowCxV3beta1DataStoreConnection) MarshalJSON() ([]byte return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowCxV3beta1DeleteDocumentOperationMetadata: Metadata for -// DeleteDocument operation. -type GoogleCloudDialogflowCxV3beta1DeleteDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3beta1DeleteDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3beta1DeleteDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3beta1DeployFlowMetadata: Metadata returned for the // Environments.DeployFlow long running operation. type GoogleCloudDialogflowCxV3beta1DeployFlowMetadata struct { @@ -5637,81 +5425,6 @@ func (s GoogleCloudDialogflowCxV3beta1GcsDestination) MarshalJSON() ([]byte, err return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata: Metadata in -// google::longrunning::Operation for Knowledge operations. -type GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata struct { - // State: Required. Output only. The current state of this operation. - // - // Possible values: - // "STATE_UNSPECIFIED" - State unspecified. - // "PENDING" - The operation has been created. - // "RUNNING" - The operation is currently running. - // "DONE" - The operation is done, either cancelled or completed. - State string `json:"state,omitempty"` - // ForceSendFields is a list of field names (e.g. "State") 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. "State") 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 GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowCxV3beta1ImportDocumentsOperationMetadata: Metadata for -// ImportDocuments operation. -type GoogleCloudDialogflowCxV3beta1ImportDocumentsOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3beta1ImportDocumentsOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3beta1ImportDocumentsOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowCxV3beta1ImportDocumentsResponse: Response message for -// Documents.ImportDocuments. -type GoogleCloudDialogflowCxV3beta1ImportDocumentsResponse struct { - // Warnings: Includes details about skipped documents or any other warnings. - Warnings []*GoogleRpcStatus `json:"warnings,omitempty"` - // ForceSendFields is a list of field names (e.g. "Warnings") 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. "Warnings") 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 GoogleCloudDialogflowCxV3beta1ImportDocumentsResponse) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3beta1ImportDocumentsResponse - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3beta1ImportEntityTypesMetadata: Metadata returned // for the EntityTypes.ImportEntityTypes long running operation. type GoogleCloudDialogflowCxV3beta1ImportEntityTypesMetadata struct { @@ -6528,29 +6241,6 @@ func (s GoogleCloudDialogflowCxV3beta1QueryInput) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowCxV3beta1ReloadDocumentOperationMetadata: Metadata for -// ReloadDocument operation. -type GoogleCloudDialogflowCxV3beta1ReloadDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3beta1ReloadDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3beta1ReloadDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3beta1ResponseMessage: Represents a response message // that can be returned by a conversational agent. Response messages are also // used for output audio synthesis. The approach is as follows: * If at least @@ -6845,7 +6535,8 @@ type GoogleCloudDialogflowCxV3beta1ResponseMessageText struct { // can be interrupted by the end user's speech and the client can then starts // the next Dialogflow request. AllowPlaybackInterruption bool `json:"allowPlaybackInterruption,omitempty"` - // Text: Required. A collection of text responses. + // Text: Required. A collection of text response variants. If multiple variants + // are defined, only one text response variant is returned at runtime. Text []string `json:"text,omitempty"` // ForceSendFields is a list of field names (e.g. "AllowPlaybackInterruption") // to unconditionally include in API requests. By default, fields with empty or @@ -7399,29 +7090,6 @@ func (s *GoogleCloudDialogflowCxV3beta1TurnSignals) UnmarshalJSON(data []byte) e return nil } -// GoogleCloudDialogflowCxV3beta1UpdateDocumentOperationMetadata: Metadata for -// UpdateDocument operation. -type GoogleCloudDialogflowCxV3beta1UpdateDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3beta1UpdateDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3beta1UpdateDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3beta1Webhook: Webhooks host the developer's // business logic. During a session, webhooks allow the developer to use the // data extracted by Dialogflow's natural language processing to generate @@ -14663,7 +14331,7 @@ type GoogleCloudDialogflowV2SearchKnowledgeRequest struct { Parent string `json:"parent,omitempty"` // Query: Required. The natural language text query for knowledge search. Query *GoogleCloudDialogflowV2TextInput `json:"query,omitempty"` - // SessionId: Optional. The ID of the search session. The session_id can be + // SessionId: Required. The ID of the search session. The session_id can be // combined with Dialogflow V3 Agent ID retrieved from conversation profile or // on its own to identify a search session. The search history of the same // session will impact the search result. It's up to the API caller to choose @@ -19312,7 +18980,8 @@ func (s GoogleCloudDialogflowV2beta1ResponseMessageTelephonyTransferCall) Marsha // GoogleCloudDialogflowV2beta1ResponseMessageText: The text response message. type GoogleCloudDialogflowV2beta1ResponseMessageText struct { - // Text: A collection of text responses. + // Text: A collection of text response variants. If multiple variants are + // defined, only one text response variant is returned at runtime. Text []string `json:"text,omitempty"` // ForceSendFields is a list of field names (e.g. "Text") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -19904,150 +19573,6 @@ func (s GoogleCloudDialogflowV3alpha1ConversationSignals) MarshalJSON() ([]byte, return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowV3alpha1CreateDocumentOperationMetadata: Metadata for -// CreateDocument operation. -type GoogleCloudDialogflowV3alpha1CreateDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowV3alpha1CreateDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowV3alpha1CreateDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowV3alpha1DeleteDocumentOperationMetadata: Metadata for -// DeleteDocument operation. -type GoogleCloudDialogflowV3alpha1DeleteDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowV3alpha1DeleteDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowV3alpha1DeleteDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata: Metadata in -// google::longrunning::Operation for Knowledge operations. -type GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata struct { - // State: Required. Output only. The current state of this operation. - // - // Possible values: - // "STATE_UNSPECIFIED" - State unspecified. - // "PENDING" - The operation has been created. - // "RUNNING" - The operation is currently running. - // "DONE" - The operation is done, either cancelled or completed. - State string `json:"state,omitempty"` - // ForceSendFields is a list of field names (e.g. "State") 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. "State") 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 GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowV3alpha1ImportDocumentsOperationMetadata: Metadata for -// ImportDocuments operation. -type GoogleCloudDialogflowV3alpha1ImportDocumentsOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowV3alpha1ImportDocumentsOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowV3alpha1ImportDocumentsOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowV3alpha1ImportDocumentsResponse: Response message for -// Documents.ImportDocuments. -type GoogleCloudDialogflowV3alpha1ImportDocumentsResponse struct { - // Warnings: Includes details about skipped documents or any other warnings. - Warnings []*GoogleRpcStatus `json:"warnings,omitempty"` - // ForceSendFields is a list of field names (e.g. "Warnings") 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. "Warnings") 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 GoogleCloudDialogflowV3alpha1ImportDocumentsResponse) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowV3alpha1ImportDocumentsResponse - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowV3alpha1ReloadDocumentOperationMetadata: Metadata for -// ReloadDocument operation. -type GoogleCloudDialogflowV3alpha1ReloadDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowV3alpha1ReloadDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowV3alpha1ReloadDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowV3alpha1TurnSignals: Collection of all signals that // were extracted for a single turn of the conversation. type GoogleCloudDialogflowV3alpha1TurnSignals struct { @@ -20116,29 +19641,6 @@ func (s *GoogleCloudDialogflowV3alpha1TurnSignals) UnmarshalJSON(data []byte) er return nil } -// GoogleCloudDialogflowV3alpha1UpdateDocumentOperationMetadata: Metadata for -// UpdateDocument operation. -type GoogleCloudDialogflowV3alpha1UpdateDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowV3alpha1UpdateDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowV3alpha1UpdateDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudLocationListLocationsResponse: The response message for // Locations.ListLocations. type GoogleCloudLocationListLocationsResponse struct { diff --git a/dialogflow/v2beta1/dialogflow-api.json b/dialogflow/v2beta1/dialogflow-api.json index 1d9da16ff47..0f94a67e7b7 100644 --- a/dialogflow/v2beta1/dialogflow-api.json +++ b/dialogflow/v2beta1/dialogflow-api.json @@ -8082,7 +8082,7 @@ } } }, - "revision": "20240724", + "revision": "20240812", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AdvancedSettings": { @@ -8386,17 +8386,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3CreateDocumentOperationMetadata": { - "description": "Metadata for CreateDocument operation.", - "id": "GoogleCloudDialogflowCxV3CreateDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3CreateVersionOperationMetadata": { "description": "Metadata associated with the long running operation for Versions.CreateVersion.", "id": "GoogleCloudDialogflowCxV3CreateVersionOperationMetadata", @@ -8435,17 +8424,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3DeleteDocumentOperationMetadata": { - "description": "Metadata for DeleteDocument operation.", - "id": "GoogleCloudDialogflowCxV3DeleteDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3DeployFlowMetadata": { "description": "Metadata returned for the Environments.DeployFlow long running operation.", "id": "GoogleCloudDialogflowCxV3DeployFlowMetadata", @@ -8912,55 +8890,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata": { - "description": "Metadata in google::longrunning::Operation for Knowledge operations.", - "id": "GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata", - "properties": { - "state": { - "description": "Required. Output only. The current state of this operation.", - "enum": [ - "STATE_UNSPECIFIED", - "PENDING", - "RUNNING", - "DONE" - ], - "enumDescriptions": [ - "State unspecified.", - "The operation has been created.", - "The operation is currently running.", - "The operation is done, either cancelled or completed." - ], - "readOnly": true, - "type": "string" - } - }, - "type": "object" - }, - "GoogleCloudDialogflowCxV3ImportDocumentsOperationMetadata": { - "description": "Metadata for ImportDocuments operation.", - "id": "GoogleCloudDialogflowCxV3ImportDocumentsOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, - "GoogleCloudDialogflowCxV3ImportDocumentsResponse": { - "description": "Response message for Documents.ImportDocuments.", - "id": "GoogleCloudDialogflowCxV3ImportDocumentsResponse", - "properties": { - "warnings": { - "description": "Includes details about skipped documents or any other warnings.", - "items": { - "$ref": "GoogleRpcStatus" - }, - "type": "array" - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3ImportEntityTypesMetadata": { "description": "Metadata returned for the EntityTypes.ImportEntityTypes long running operation.", "id": "GoogleCloudDialogflowCxV3ImportEntityTypesMetadata", @@ -9512,17 +9441,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3ReloadDocumentOperationMetadata": { - "description": "Metadata for ReloadDocument operation.", - "id": "GoogleCloudDialogflowCxV3ReloadDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3ResponseMessage": { "description": "Represents a response message that can be returned by a conversational agent. Response messages are also used for output audio synthesis. The approach is as follows: * If at least one OutputAudioText response is present, then all OutputAudioText responses are linearly concatenated, and the result is used for output audio synthesis. * If the OutputAudioText responses are a mixture of text and SSML, then the concatenated result is treated as SSML; otherwise, the result is treated as either text or SSML as appropriate. The agent designer should ideally use either text or SSML consistently throughout the bot design. * Otherwise, all Text responses are linearly concatenated, and the result is used for output audio synthesis. This approach allows for more sophisticated user experience scenarios, where the text displayed to the user may differ from what is heard.", "id": "GoogleCloudDialogflowCxV3ResponseMessage", @@ -9730,7 +9648,7 @@ "type": "boolean" }, "text": { - "description": "Required. A collection of text responses.", + "description": "Required. A collection of text response variants. If multiple variants are defined, only one text response variant is returned at runtime.", "items": { "type": "string" }, @@ -10087,17 +10005,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3UpdateDocumentOperationMetadata": { - "description": "Metadata for UpdateDocument operation.", - "id": "GoogleCloudDialogflowCxV3UpdateDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3Webhook": { "description": "Webhooks host the developer's business logic. During a session, webhooks allow the developer to use the data extracted by Dialogflow's natural language processing to generate dynamic responses, validate collected data, or trigger actions on the backend.", "id": "GoogleCloudDialogflowCxV3Webhook", @@ -10784,17 +10691,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3beta1CreateDocumentOperationMetadata": { - "description": "Metadata for CreateDocument operation.", - "id": "GoogleCloudDialogflowCxV3beta1CreateDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3beta1CreateVersionOperationMetadata": { "description": "Metadata associated with the long running operation for Versions.CreateVersion.", "id": "GoogleCloudDialogflowCxV3beta1CreateVersionOperationMetadata", @@ -10833,17 +10729,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3beta1DeleteDocumentOperationMetadata": { - "description": "Metadata for DeleteDocument operation.", - "id": "GoogleCloudDialogflowCxV3beta1DeleteDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3beta1DeployFlowMetadata": { "description": "Metadata returned for the Environments.DeployFlow long running operation.", "id": "GoogleCloudDialogflowCxV3beta1DeployFlowMetadata", @@ -11310,55 +11195,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata": { - "description": "Metadata in google::longrunning::Operation for Knowledge operations.", - "id": "GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata", - "properties": { - "state": { - "description": "Required. Output only. The current state of this operation.", - "enum": [ - "STATE_UNSPECIFIED", - "PENDING", - "RUNNING", - "DONE" - ], - "enumDescriptions": [ - "State unspecified.", - "The operation has been created.", - "The operation is currently running.", - "The operation is done, either cancelled or completed." - ], - "readOnly": true, - "type": "string" - } - }, - "type": "object" - }, - "GoogleCloudDialogflowCxV3beta1ImportDocumentsOperationMetadata": { - "description": "Metadata for ImportDocuments operation.", - "id": "GoogleCloudDialogflowCxV3beta1ImportDocumentsOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, - "GoogleCloudDialogflowCxV3beta1ImportDocumentsResponse": { - "description": "Response message for Documents.ImportDocuments.", - "id": "GoogleCloudDialogflowCxV3beta1ImportDocumentsResponse", - "properties": { - "warnings": { - "description": "Includes details about skipped documents or any other warnings.", - "items": { - "$ref": "GoogleRpcStatus" - }, - "type": "array" - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3beta1ImportEntityTypesMetadata": { "description": "Metadata returned for the EntityTypes.ImportEntityTypes long running operation.", "id": "GoogleCloudDialogflowCxV3beta1ImportEntityTypesMetadata", @@ -11914,17 +11750,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3beta1ReloadDocumentOperationMetadata": { - "description": "Metadata for ReloadDocument operation.", - "id": "GoogleCloudDialogflowCxV3beta1ReloadDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3beta1ResponseMessage": { "description": "Represents a response message that can be returned by a conversational agent. Response messages are also used for output audio synthesis. The approach is as follows: * If at least one OutputAudioText response is present, then all OutputAudioText responses are linearly concatenated, and the result is used for output audio synthesis. * If the OutputAudioText responses are a mixture of text and SSML, then the concatenated result is treated as SSML; otherwise, the result is treated as either text or SSML as appropriate. The agent designer should ideally use either text or SSML consistently throughout the bot design. * Otherwise, all Text responses are linearly concatenated, and the result is used for output audio synthesis. This approach allows for more sophisticated user experience scenarios, where the text displayed to the user may differ from what is heard.", "id": "GoogleCloudDialogflowCxV3beta1ResponseMessage", @@ -12120,7 +11945,7 @@ "type": "boolean" }, "text": { - "description": "Required. A collection of text responses.", + "description": "Required. A collection of text response variants. If multiple variants are defined, only one text response variant is returned at runtime.", "items": { "type": "string" }, @@ -12538,17 +12363,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3beta1UpdateDocumentOperationMetadata": { - "description": "Metadata for UpdateDocument operation.", - "id": "GoogleCloudDialogflowCxV3beta1UpdateDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3beta1Webhook": { "description": "Webhooks host the developer's business logic. During a session, webhooks allow the developer to use the data extracted by Dialogflow's natural language processing to generate dynamic responses, validate collected data, or trigger actions on the backend.", "id": "GoogleCloudDialogflowCxV3beta1Webhook", @@ -20175,7 +19989,7 @@ "id": "GoogleCloudDialogflowV2beta1ResponseMessageText", "properties": { "text": { - "description": "A collection of text responses.", + "description": "A collection of text response variants. If multiple variants are defined, only one text response variant is returned at runtime.", "items": { "type": "string" }, @@ -20300,7 +20114,7 @@ "description": "Required. The natural language text query for knowledge search." }, "sessionId": { - "description": "Optional. The ID of the search session. The session_id can be combined with Dialogflow V3 Agent ID retrieved from conversation profile or on its own to identify a search session. The search history of the same session will impact the search result. It's up to the API caller to choose an appropriate `Session ID`. It can be a random number or some type of session identifiers (preferably hashed). The length must not exceed 36 characters.", + "description": "Required. The ID of the search session. The session_id can be combined with Dialogflow V3 Agent ID retrieved from conversation profile or on its own to identify a search session. The search history of the same session will impact the search result. It's up to the API caller to choose an appropriate `Session ID`. It can be a random number or some type of session identifiers (preferably hashed). The length must not exceed 36 characters.", "type": "string" } }, @@ -21534,88 +21348,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowV3alpha1CreateDocumentOperationMetadata": { - "description": "Metadata for CreateDocument operation.", - "id": "GoogleCloudDialogflowV3alpha1CreateDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, - "GoogleCloudDialogflowV3alpha1DeleteDocumentOperationMetadata": { - "description": "Metadata for DeleteDocument operation.", - "id": "GoogleCloudDialogflowV3alpha1DeleteDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, - "GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata": { - "description": "Metadata in google::longrunning::Operation for Knowledge operations.", - "id": "GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata", - "properties": { - "state": { - "description": "Required. Output only. The current state of this operation.", - "enum": [ - "STATE_UNSPECIFIED", - "PENDING", - "RUNNING", - "DONE" - ], - "enumDescriptions": [ - "State unspecified.", - "The operation has been created.", - "The operation is currently running.", - "The operation is done, either cancelled or completed." - ], - "readOnly": true, - "type": "string" - } - }, - "type": "object" - }, - "GoogleCloudDialogflowV3alpha1ImportDocumentsOperationMetadata": { - "description": "Metadata for ImportDocuments operation.", - "id": "GoogleCloudDialogflowV3alpha1ImportDocumentsOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, - "GoogleCloudDialogflowV3alpha1ImportDocumentsResponse": { - "description": "Response message for Documents.ImportDocuments.", - "id": "GoogleCloudDialogflowV3alpha1ImportDocumentsResponse", - "properties": { - "warnings": { - "description": "Includes details about skipped documents or any other warnings.", - "items": { - "$ref": "GoogleRpcStatus" - }, - "type": "array" - } - }, - "type": "object" - }, - "GoogleCloudDialogflowV3alpha1ReloadDocumentOperationMetadata": { - "description": "Metadata for ReloadDocument operation.", - "id": "GoogleCloudDialogflowV3alpha1ReloadDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowV3alpha1TurnSignals": { "description": "Collection of all signals that were extracted for a single turn of the conversation.", "id": "GoogleCloudDialogflowV3alpha1TurnSignals", @@ -21685,17 +21417,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowV3alpha1UpdateDocumentOperationMetadata": { - "description": "Metadata for UpdateDocument operation.", - "id": "GoogleCloudDialogflowV3alpha1UpdateDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudLocationListLocationsResponse": { "description": "The response message for Locations.ListLocations.", "id": "GoogleCloudLocationListLocationsResponse", diff --git a/dialogflow/v2beta1/dialogflow-gen.go b/dialogflow/v2beta1/dialogflow-gen.go index 18387ea9318..f235aff1efa 100644 --- a/dialogflow/v2beta1/dialogflow-gen.go +++ b/dialogflow/v2beta1/dialogflow-gen.go @@ -1283,29 +1283,6 @@ func (s GoogleCloudDialogflowCxV3ConversationTurnVirtualAgentOutput) MarshalJSON return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowCxV3CreateDocumentOperationMetadata: Metadata for -// CreateDocument operation. -type GoogleCloudDialogflowCxV3CreateDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3CreateDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3CreateDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3CreateVersionOperationMetadata: Metadata associated // with the long running operation for Versions.CreateVersion. type GoogleCloudDialogflowCxV3CreateVersionOperationMetadata struct { @@ -1367,29 +1344,6 @@ func (s GoogleCloudDialogflowCxV3DataStoreConnection) MarshalJSON() ([]byte, err return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowCxV3DeleteDocumentOperationMetadata: Metadata for -// DeleteDocument operation. -type GoogleCloudDialogflowCxV3DeleteDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3DeleteDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3DeleteDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3DeployFlowMetadata: Metadata returned for the // Environments.DeployFlow long running operation. type GoogleCloudDialogflowCxV3DeployFlowMetadata struct { @@ -2121,81 +2075,6 @@ func (s GoogleCloudDialogflowCxV3GcsDestination) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata: Metadata in -// google::longrunning::Operation for Knowledge operations. -type GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata struct { - // State: Required. Output only. The current state of this operation. - // - // Possible values: - // "STATE_UNSPECIFIED" - State unspecified. - // "PENDING" - The operation has been created. - // "RUNNING" - The operation is currently running. - // "DONE" - The operation is done, either cancelled or completed. - State string `json:"state,omitempty"` - // ForceSendFields is a list of field names (e.g. "State") 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. "State") 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 GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowCxV3ImportDocumentsOperationMetadata: Metadata for -// ImportDocuments operation. -type GoogleCloudDialogflowCxV3ImportDocumentsOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3ImportDocumentsOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3ImportDocumentsOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowCxV3ImportDocumentsResponse: Response message for -// Documents.ImportDocuments. -type GoogleCloudDialogflowCxV3ImportDocumentsResponse struct { - // Warnings: Includes details about skipped documents or any other warnings. - Warnings []*GoogleRpcStatus `json:"warnings,omitempty"` - // ForceSendFields is a list of field names (e.g. "Warnings") 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. "Warnings") 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 GoogleCloudDialogflowCxV3ImportDocumentsResponse) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3ImportDocumentsResponse - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3ImportEntityTypesMetadata: Metadata returned for // the EntityTypes.ImportEntityTypes long running operation. type GoogleCloudDialogflowCxV3ImportEntityTypesMetadata struct { @@ -3009,29 +2888,6 @@ func (s GoogleCloudDialogflowCxV3QueryInput) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowCxV3ReloadDocumentOperationMetadata: Metadata for -// ReloadDocument operation. -type GoogleCloudDialogflowCxV3ReloadDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3ReloadDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3ReloadDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3ResponseMessage: Represents a response message that // can be returned by a conversational agent. Response messages are also used // for output audio synthesis. The approach is as follows: * If at least one @@ -3331,7 +3187,8 @@ type GoogleCloudDialogflowCxV3ResponseMessageText struct { // can be interrupted by the end user's speech and the client can then starts // the next Dialogflow request. AllowPlaybackInterruption bool `json:"allowPlaybackInterruption,omitempty"` - // Text: Required. A collection of text responses. + // Text: Required. A collection of text response variants. If multiple variants + // are defined, only one text response variant is returned at runtime. Text []string `json:"text,omitempty"` // ForceSendFields is a list of field names (e.g. "AllowPlaybackInterruption") // to unconditionally include in API requests. By default, fields with empty or @@ -3803,29 +3660,6 @@ func (s *GoogleCloudDialogflowCxV3TurnSignals) UnmarshalJSON(data []byte) error return nil } -// GoogleCloudDialogflowCxV3UpdateDocumentOperationMetadata: Metadata for -// UpdateDocument operation. -type GoogleCloudDialogflowCxV3UpdateDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3UpdateDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3UpdateDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3Webhook: Webhooks host the developer's business // logic. During a session, webhooks allow the developer to use the data // extracted by Dialogflow's natural language processing to generate dynamic @@ -4726,29 +4560,6 @@ func (s GoogleCloudDialogflowCxV3beta1ConversationTurnVirtualAgentOutput) Marsha return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowCxV3beta1CreateDocumentOperationMetadata: Metadata for -// CreateDocument operation. -type GoogleCloudDialogflowCxV3beta1CreateDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3beta1CreateDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3beta1CreateDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3beta1CreateVersionOperationMetadata: Metadata // associated with the long running operation for Versions.CreateVersion. type GoogleCloudDialogflowCxV3beta1CreateVersionOperationMetadata struct { @@ -4810,29 +4621,6 @@ func (s GoogleCloudDialogflowCxV3beta1DataStoreConnection) MarshalJSON() ([]byte return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowCxV3beta1DeleteDocumentOperationMetadata: Metadata for -// DeleteDocument operation. -type GoogleCloudDialogflowCxV3beta1DeleteDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3beta1DeleteDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3beta1DeleteDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3beta1DeployFlowMetadata: Metadata returned for the // Environments.DeployFlow long running operation. type GoogleCloudDialogflowCxV3beta1DeployFlowMetadata struct { @@ -5565,81 +5353,6 @@ func (s GoogleCloudDialogflowCxV3beta1GcsDestination) MarshalJSON() ([]byte, err return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata: Metadata in -// google::longrunning::Operation for Knowledge operations. -type GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata struct { - // State: Required. Output only. The current state of this operation. - // - // Possible values: - // "STATE_UNSPECIFIED" - State unspecified. - // "PENDING" - The operation has been created. - // "RUNNING" - The operation is currently running. - // "DONE" - The operation is done, either cancelled or completed. - State string `json:"state,omitempty"` - // ForceSendFields is a list of field names (e.g. "State") 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. "State") 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 GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowCxV3beta1ImportDocumentsOperationMetadata: Metadata for -// ImportDocuments operation. -type GoogleCloudDialogflowCxV3beta1ImportDocumentsOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3beta1ImportDocumentsOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3beta1ImportDocumentsOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowCxV3beta1ImportDocumentsResponse: Response message for -// Documents.ImportDocuments. -type GoogleCloudDialogflowCxV3beta1ImportDocumentsResponse struct { - // Warnings: Includes details about skipped documents or any other warnings. - Warnings []*GoogleRpcStatus `json:"warnings,omitempty"` - // ForceSendFields is a list of field names (e.g. "Warnings") 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. "Warnings") 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 GoogleCloudDialogflowCxV3beta1ImportDocumentsResponse) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3beta1ImportDocumentsResponse - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3beta1ImportEntityTypesMetadata: Metadata returned // for the EntityTypes.ImportEntityTypes long running operation. type GoogleCloudDialogflowCxV3beta1ImportEntityTypesMetadata struct { @@ -6456,29 +6169,6 @@ func (s GoogleCloudDialogflowCxV3beta1QueryInput) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowCxV3beta1ReloadDocumentOperationMetadata: Metadata for -// ReloadDocument operation. -type GoogleCloudDialogflowCxV3beta1ReloadDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3beta1ReloadDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3beta1ReloadDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3beta1ResponseMessage: Represents a response message // that can be returned by a conversational agent. Response messages are also // used for output audio synthesis. The approach is as follows: * If at least @@ -6773,7 +6463,8 @@ type GoogleCloudDialogflowCxV3beta1ResponseMessageText struct { // can be interrupted by the end user's speech and the client can then starts // the next Dialogflow request. AllowPlaybackInterruption bool `json:"allowPlaybackInterruption,omitempty"` - // Text: Required. A collection of text responses. + // Text: Required. A collection of text response variants. If multiple variants + // are defined, only one text response variant is returned at runtime. Text []string `json:"text,omitempty"` // ForceSendFields is a list of field names (e.g. "AllowPlaybackInterruption") // to unconditionally include in API requests. By default, fields with empty or @@ -7327,29 +7018,6 @@ func (s *GoogleCloudDialogflowCxV3beta1TurnSignals) UnmarshalJSON(data []byte) e return nil } -// GoogleCloudDialogflowCxV3beta1UpdateDocumentOperationMetadata: Metadata for -// UpdateDocument operation. -type GoogleCloudDialogflowCxV3beta1UpdateDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3beta1UpdateDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3beta1UpdateDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3beta1Webhook: Webhooks host the developer's // business logic. During a session, webhooks allow the developer to use the // data extracted by Dialogflow's natural language processing to generate @@ -17898,7 +17566,8 @@ func (s GoogleCloudDialogflowV2beta1ResponseMessageTelephonyTransferCall) Marsha // GoogleCloudDialogflowV2beta1ResponseMessageText: The text response message. type GoogleCloudDialogflowV2beta1ResponseMessageText struct { - // Text: A collection of text responses. + // Text: A collection of text response variants. If multiple variants are + // defined, only one text response variant is returned at runtime. Text []string `json:"text,omitempty"` // ForceSendFields is a list of field names (e.g. "Text") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -18061,7 +17730,7 @@ type GoogleCloudDialogflowV2beta1SearchKnowledgeRequest struct { Parent string `json:"parent,omitempty"` // Query: Required. The natural language text query for knowledge search. Query *GoogleCloudDialogflowV2beta1TextInput `json:"query,omitempty"` - // SessionId: Optional. The ID of the search session. The session_id can be + // SessionId: Required. The ID of the search session. The session_id can be // combined with Dialogflow V3 Agent ID retrieved from conversation profile or // on its own to identify a search session. The search history of the same // session will impact the search result. It's up to the API caller to choose @@ -19896,150 +19565,6 @@ func (s GoogleCloudDialogflowV3alpha1ConversationSignals) MarshalJSON() ([]byte, return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowV3alpha1CreateDocumentOperationMetadata: Metadata for -// CreateDocument operation. -type GoogleCloudDialogflowV3alpha1CreateDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowV3alpha1CreateDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowV3alpha1CreateDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowV3alpha1DeleteDocumentOperationMetadata: Metadata for -// DeleteDocument operation. -type GoogleCloudDialogflowV3alpha1DeleteDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowV3alpha1DeleteDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowV3alpha1DeleteDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata: Metadata in -// google::longrunning::Operation for Knowledge operations. -type GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata struct { - // State: Required. Output only. The current state of this operation. - // - // Possible values: - // "STATE_UNSPECIFIED" - State unspecified. - // "PENDING" - The operation has been created. - // "RUNNING" - The operation is currently running. - // "DONE" - The operation is done, either cancelled or completed. - State string `json:"state,omitempty"` - // ForceSendFields is a list of field names (e.g. "State") 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. "State") 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 GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowV3alpha1ImportDocumentsOperationMetadata: Metadata for -// ImportDocuments operation. -type GoogleCloudDialogflowV3alpha1ImportDocumentsOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowV3alpha1ImportDocumentsOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowV3alpha1ImportDocumentsOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowV3alpha1ImportDocumentsResponse: Response message for -// Documents.ImportDocuments. -type GoogleCloudDialogflowV3alpha1ImportDocumentsResponse struct { - // Warnings: Includes details about skipped documents or any other warnings. - Warnings []*GoogleRpcStatus `json:"warnings,omitempty"` - // ForceSendFields is a list of field names (e.g. "Warnings") 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. "Warnings") 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 GoogleCloudDialogflowV3alpha1ImportDocumentsResponse) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowV3alpha1ImportDocumentsResponse - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowV3alpha1ReloadDocumentOperationMetadata: Metadata for -// ReloadDocument operation. -type GoogleCloudDialogflowV3alpha1ReloadDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowV3alpha1ReloadDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowV3alpha1ReloadDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowV3alpha1TurnSignals: Collection of all signals that // were extracted for a single turn of the conversation. type GoogleCloudDialogflowV3alpha1TurnSignals struct { @@ -20108,29 +19633,6 @@ func (s *GoogleCloudDialogflowV3alpha1TurnSignals) UnmarshalJSON(data []byte) er return nil } -// GoogleCloudDialogflowV3alpha1UpdateDocumentOperationMetadata: Metadata for -// UpdateDocument operation. -type GoogleCloudDialogflowV3alpha1UpdateDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowV3alpha1UpdateDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowV3alpha1UpdateDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudLocationListLocationsResponse: The response message for // Locations.ListLocations. type GoogleCloudLocationListLocationsResponse struct { diff --git a/dialogflow/v3/dialogflow-api.json b/dialogflow/v3/dialogflow-api.json index 8701ddf0ae4..972c0599e1d 100644 --- a/dialogflow/v3/dialogflow-api.json +++ b/dialogflow/v3/dialogflow-api.json @@ -4453,7 +4453,7 @@ } } }, - "revision": "20240724", + "revision": "20240812", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AdvancedSettings": { @@ -4906,6 +4906,10 @@ "format": "float", "type": "number" }, + "boostControlSpec": { + "$ref": "GoogleCloudDialogflowCxV3BoostSpecConditionBoostSpecBoostControlSpec", + "description": "Optional. Complex specification for custom ranking based on customer defined attribute value." + }, "condition": { "description": "Optional. An expression which specifies a boost condition. The syntax and supported fields are the same as a filter expression. Examples: * To boost documents with document ID \"doc_1\" or \"doc_2\", and color \"Red\" or \"Blue\": * (id: ANY(\"doc_1\", \"doc_2\")) AND (color: ANY(\"Red\",\"Blue\"))", "type": "string" @@ -4913,6 +4917,66 @@ }, "type": "object" }, + "GoogleCloudDialogflowCxV3BoostSpecConditionBoostSpecBoostControlSpec": { + "description": "Specification for custom ranking based on customer specified attribute value. It provides more controls for customized ranking than the simple (condition, boost) combination above.", + "id": "GoogleCloudDialogflowCxV3BoostSpecConditionBoostSpecBoostControlSpec", + "properties": { + "attributeType": { + "description": "Optional. The attribute type to be used to determine the boost amount. The attribute value can be derived from the field value of the specified field_name. In the case of numerical it is straightforward i.e. attribute_value = numerical_field_value. In the case of freshness however, attribute_value = (time.now() - datetime_field_value).", + "enum": [ + "ATTRIBUTE_TYPE_UNSPECIFIED", + "NUMERICAL", + "FRESHNESS" + ], + "enumDescriptions": [ + "Unspecified AttributeType.", + "The value of the numerical field will be used to dynamically update the boost amount. In this case, the attribute_value (the x value) of the control point will be the actual value of the numerical field for which the boost_amount is specified.", + "For the freshness use case the attribute value will be the duration between the current time and the date in the datetime field specified. The value must be formatted as an XSD `dayTimeDuration` value (a restricted subset of an ISO 8601 duration value). The pattern for this is: `nDnM]`. E.g. `5D`, `3DT12H30M`, `T24H`." + ], + "type": "string" + }, + "controlPoints": { + "description": "Optional. The control points used to define the curve. The monotonic function (defined through the interpolation_type above) passes through the control points listed here.", + "items": { + "$ref": "GoogleCloudDialogflowCxV3BoostSpecConditionBoostSpecBoostControlSpecControlPoint" + }, + "type": "array" + }, + "fieldName": { + "description": "Optional. The name of the field whose value will be used to determine the boost amount.", + "type": "string" + }, + "interpolationType": { + "description": "Optional. The interpolation type to be applied to connect the control points listed below.", + "enum": [ + "INTERPOLATION_TYPE_UNSPECIFIED", + "LINEAR" + ], + "enumDescriptions": [ + "Interpolation type is unspecified. In this case, it defaults to Linear.", + "Piecewise linear interpolation will be applied." + ], + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowCxV3BoostSpecConditionBoostSpecBoostControlSpecControlPoint": { + "description": "The control points used to define the curve. The curve defined through these control points can only be monotonically increasing or decreasing(constant values are acceptable).", + "id": "GoogleCloudDialogflowCxV3BoostSpecConditionBoostSpecBoostControlSpecControlPoint", + "properties": { + "attributeValue": { + "description": "Optional. Can be one of: 1. The numerical field value. 2. The duration spec for freshness: The value must be formatted as an XSD `dayTimeDuration` value (a restricted subset of an ISO 8601 duration value). The pattern for this is: `nDnM]`.", + "type": "string" + }, + "boostAmount": { + "description": "Optional. The value between -1 to 1 by which to boost the score if the attribute_value evaluates to the value specified above.", + "format": "float", + "type": "number" + } + }, + "type": "object" + }, "GoogleCloudDialogflowCxV3BoostSpecs": { "description": "Boost specifications for data stores.", "id": "GoogleCloudDialogflowCxV3BoostSpecs", @@ -5172,17 +5236,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3CreateDocumentOperationMetadata": { - "description": "Metadata for CreateDocument operation.", - "id": "GoogleCloudDialogflowCxV3CreateDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3CreateVersionOperationMetadata": { "description": "Metadata associated with the long running operation for Versions.CreateVersion.", "id": "GoogleCloudDialogflowCxV3CreateVersionOperationMetadata", @@ -5447,17 +5500,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3DeleteDocumentOperationMetadata": { - "description": "Metadata for DeleteDocument operation.", - "id": "GoogleCloudDialogflowCxV3DeleteDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3DeployFlowMetadata": { "description": "Metadata returned for the Environments.DeployFlow long running operation.", "id": "GoogleCloudDialogflowCxV3DeployFlowMetadata", @@ -6882,55 +6924,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata": { - "description": "Metadata in google::longrunning::Operation for Knowledge operations.", - "id": "GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata", - "properties": { - "state": { - "description": "Required. Output only. The current state of this operation.", - "enum": [ - "STATE_UNSPECIFIED", - "PENDING", - "RUNNING", - "DONE" - ], - "enumDescriptions": [ - "State unspecified.", - "The operation has been created.", - "The operation is currently running.", - "The operation is done, either cancelled or completed." - ], - "readOnly": true, - "type": "string" - } - }, - "type": "object" - }, - "GoogleCloudDialogflowCxV3ImportDocumentsOperationMetadata": { - "description": "Metadata for ImportDocuments operation.", - "id": "GoogleCloudDialogflowCxV3ImportDocumentsOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, - "GoogleCloudDialogflowCxV3ImportDocumentsResponse": { - "description": "Response message for Documents.ImportDocuments.", - "id": "GoogleCloudDialogflowCxV3ImportDocumentsResponse", - "properties": { - "warnings": { - "description": "Includes details about skipped documents or any other warnings.", - "items": { - "$ref": "GoogleRpcStatus" - }, - "type": "array" - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3ImportEntityTypesMetadata": { "description": "Metadata returned for the EntityTypes.ImportEntityTypes long running operation.", "id": "GoogleCloudDialogflowCxV3ImportEntityTypesMetadata", @@ -8410,17 +8403,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3ReloadDocumentOperationMetadata": { - "description": "Metadata for ReloadDocument operation.", - "id": "GoogleCloudDialogflowCxV3ReloadDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3ResourceName": { "description": "Resource name and display name.", "id": "GoogleCloudDialogflowCxV3ResourceName", @@ -8643,7 +8625,7 @@ "type": "boolean" }, "text": { - "description": "Required. A collection of text responses.", + "description": "Required. A collection of text response variants. If multiple variants are defined, only one text response variant is returned at runtime.", "items": { "type": "string" }, @@ -9603,17 +9585,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3UpdateDocumentOperationMetadata": { - "description": "Metadata for UpdateDocument operation.", - "id": "GoogleCloudDialogflowCxV3UpdateDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3ValidateAgentRequest": { "description": "The request message for Agents.ValidateAgent.", "id": "GoogleCloudDialogflowCxV3ValidateAgentRequest", @@ -10526,17 +10497,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3beta1CreateDocumentOperationMetadata": { - "description": "Metadata for CreateDocument operation.", - "id": "GoogleCloudDialogflowCxV3beta1CreateDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3beta1CreateVersionOperationMetadata": { "description": "Metadata associated with the long running operation for Versions.CreateVersion.", "id": "GoogleCloudDialogflowCxV3beta1CreateVersionOperationMetadata", @@ -10575,17 +10535,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3beta1DeleteDocumentOperationMetadata": { - "description": "Metadata for DeleteDocument operation.", - "id": "GoogleCloudDialogflowCxV3beta1DeleteDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3beta1DeployFlowMetadata": { "description": "Metadata returned for the Environments.DeployFlow long running operation.", "id": "GoogleCloudDialogflowCxV3beta1DeployFlowMetadata", @@ -11052,55 +11001,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata": { - "description": "Metadata in google::longrunning::Operation for Knowledge operations.", - "id": "GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata", - "properties": { - "state": { - "description": "Required. Output only. The current state of this operation.", - "enum": [ - "STATE_UNSPECIFIED", - "PENDING", - "RUNNING", - "DONE" - ], - "enumDescriptions": [ - "State unspecified.", - "The operation has been created.", - "The operation is currently running.", - "The operation is done, either cancelled or completed." - ], - "readOnly": true, - "type": "string" - } - }, - "type": "object" - }, - "GoogleCloudDialogflowCxV3beta1ImportDocumentsOperationMetadata": { - "description": "Metadata for ImportDocuments operation.", - "id": "GoogleCloudDialogflowCxV3beta1ImportDocumentsOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, - "GoogleCloudDialogflowCxV3beta1ImportDocumentsResponse": { - "description": "Response message for Documents.ImportDocuments.", - "id": "GoogleCloudDialogflowCxV3beta1ImportDocumentsResponse", - "properties": { - "warnings": { - "description": "Includes details about skipped documents or any other warnings.", - "items": { - "$ref": "GoogleRpcStatus" - }, - "type": "array" - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3beta1ImportEntityTypesMetadata": { "description": "Metadata returned for the EntityTypes.ImportEntityTypes long running operation.", "id": "GoogleCloudDialogflowCxV3beta1ImportEntityTypesMetadata", @@ -11656,17 +11556,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3beta1ReloadDocumentOperationMetadata": { - "description": "Metadata for ReloadDocument operation.", - "id": "GoogleCloudDialogflowCxV3beta1ReloadDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3beta1ResponseMessage": { "description": "Represents a response message that can be returned by a conversational agent. Response messages are also used for output audio synthesis. The approach is as follows: * If at least one OutputAudioText response is present, then all OutputAudioText responses are linearly concatenated, and the result is used for output audio synthesis. * If the OutputAudioText responses are a mixture of text and SSML, then the concatenated result is treated as SSML; otherwise, the result is treated as either text or SSML as appropriate. The agent designer should ideally use either text or SSML consistently throughout the bot design. * Otherwise, all Text responses are linearly concatenated, and the result is used for output audio synthesis. This approach allows for more sophisticated user experience scenarios, where the text displayed to the user may differ from what is heard.", "id": "GoogleCloudDialogflowCxV3beta1ResponseMessage", @@ -11862,7 +11751,7 @@ "type": "boolean" }, "text": { - "description": "Required. A collection of text responses.", + "description": "Required. A collection of text response variants. If multiple variants are defined, only one text response variant is returned at runtime.", "items": { "type": "string" }, @@ -12280,17 +12169,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3beta1UpdateDocumentOperationMetadata": { - "description": "Metadata for UpdateDocument operation.", - "id": "GoogleCloudDialogflowCxV3beta1UpdateDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3beta1Webhook": { "description": "Webhooks host the developer's business logic. During a session, webhooks allow the developer to use the data extracted by Dialogflow's natural language processing to generate dynamic responses, validate collected data, or trigger actions on the backend.", "id": "GoogleCloudDialogflowCxV3beta1Webhook", @@ -17160,7 +17038,7 @@ "id": "GoogleCloudDialogflowV2beta1ResponseMessageText", "properties": { "text": { - "description": "A collection of text responses.", + "description": "A collection of text response variants. If multiple variants are defined, only one text response variant is returned at runtime.", "items": { "type": "string" }, @@ -17550,88 +17428,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowV3alpha1CreateDocumentOperationMetadata": { - "description": "Metadata for CreateDocument operation.", - "id": "GoogleCloudDialogflowV3alpha1CreateDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, - "GoogleCloudDialogflowV3alpha1DeleteDocumentOperationMetadata": { - "description": "Metadata for DeleteDocument operation.", - "id": "GoogleCloudDialogflowV3alpha1DeleteDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, - "GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata": { - "description": "Metadata in google::longrunning::Operation for Knowledge operations.", - "id": "GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata", - "properties": { - "state": { - "description": "Required. Output only. The current state of this operation.", - "enum": [ - "STATE_UNSPECIFIED", - "PENDING", - "RUNNING", - "DONE" - ], - "enumDescriptions": [ - "State unspecified.", - "The operation has been created.", - "The operation is currently running.", - "The operation is done, either cancelled or completed." - ], - "readOnly": true, - "type": "string" - } - }, - "type": "object" - }, - "GoogleCloudDialogflowV3alpha1ImportDocumentsOperationMetadata": { - "description": "Metadata for ImportDocuments operation.", - "id": "GoogleCloudDialogflowV3alpha1ImportDocumentsOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, - "GoogleCloudDialogflowV3alpha1ImportDocumentsResponse": { - "description": "Response message for Documents.ImportDocuments.", - "id": "GoogleCloudDialogflowV3alpha1ImportDocumentsResponse", - "properties": { - "warnings": { - "description": "Includes details about skipped documents or any other warnings.", - "items": { - "$ref": "GoogleRpcStatus" - }, - "type": "array" - } - }, - "type": "object" - }, - "GoogleCloudDialogflowV3alpha1ReloadDocumentOperationMetadata": { - "description": "Metadata for ReloadDocument operation.", - "id": "GoogleCloudDialogflowV3alpha1ReloadDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowV3alpha1TurnSignals": { "description": "Collection of all signals that were extracted for a single turn of the conversation.", "id": "GoogleCloudDialogflowV3alpha1TurnSignals", @@ -17701,17 +17497,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowV3alpha1UpdateDocumentOperationMetadata": { - "description": "Metadata for UpdateDocument operation.", - "id": "GoogleCloudDialogflowV3alpha1UpdateDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudLocationListLocationsResponse": { "description": "The response message for Locations.ListLocations.", "id": "GoogleCloudLocationListLocationsResponse", diff --git a/dialogflow/v3/dialogflow-gen.go b/dialogflow/v3/dialogflow-gen.go index 80254110a15..02845081a9e 100644 --- a/dialogflow/v3/dialogflow-gen.go +++ b/dialogflow/v3/dialogflow-gen.go @@ -1151,6 +1151,9 @@ type GoogleCloudDialogflowCxV3BoostSpecConditionBoostSpec struct { // out completely. Setting to 0.0 means no boost applied. The boosting // condition is ignored. Boost float64 `json:"boost,omitempty"` + // BoostControlSpec: Optional. Complex specification for custom ranking based + // on customer defined attribute value. + BoostControlSpec *GoogleCloudDialogflowCxV3BoostSpecConditionBoostSpecBoostControlSpec `json:"boostControlSpec,omitempty"` // Condition: Optional. An expression which specifies a boost condition. The // syntax and supported fields are the same as a filter expression. Examples: * // To boost documents with document ID "doc_1" or "doc_2", and color "Red" or @@ -1188,6 +1191,107 @@ func (s *GoogleCloudDialogflowCxV3BoostSpecConditionBoostSpec) UnmarshalJSON(dat return nil } +// GoogleCloudDialogflowCxV3BoostSpecConditionBoostSpecBoostControlSpec: +// Specification for custom ranking based on customer specified attribute +// value. It provides more controls for customized ranking than the simple +// (condition, boost) combination above. +type GoogleCloudDialogflowCxV3BoostSpecConditionBoostSpecBoostControlSpec struct { + // AttributeType: Optional. The attribute type to be used to determine the + // boost amount. The attribute value can be derived from the field value of the + // specified field_name. In the case of numerical it is straightforward i.e. + // attribute_value = numerical_field_value. In the case of freshness however, + // attribute_value = (time.now() - datetime_field_value). + // + // Possible values: + // "ATTRIBUTE_TYPE_UNSPECIFIED" - Unspecified AttributeType. + // "NUMERICAL" - The value of the numerical field will be used to dynamically + // update the boost amount. In this case, the attribute_value (the x value) of + // the control point will be the actual value of the numerical field for which + // the boost_amount is specified. + // "FRESHNESS" - For the freshness use case the attribute value will be the + // duration between the current time and the date in the datetime field + // specified. The value must be formatted as an XSD `dayTimeDuration` value (a + // restricted subset of an ISO 8601 duration value). The pattern for this is: + // `nDnM]`. E.g. `5D`, `3DT12H30M`, `T24H`. + AttributeType string `json:"attributeType,omitempty"` + // ControlPoints: Optional. The control points used to define the curve. The + // monotonic function (defined through the interpolation_type above) passes + // through the control points listed here. + ControlPoints []*GoogleCloudDialogflowCxV3BoostSpecConditionBoostSpecBoostControlSpecControlPoint `json:"controlPoints,omitempty"` + // FieldName: Optional. The name of the field whose value will be used to + // determine the boost amount. + FieldName string `json:"fieldName,omitempty"` + // InterpolationType: Optional. The interpolation type to be applied to connect + // the control points listed below. + // + // Possible values: + // "INTERPOLATION_TYPE_UNSPECIFIED" - Interpolation type is unspecified. In + // this case, it defaults to Linear. + // "LINEAR" - Piecewise linear interpolation will be applied. + InterpolationType string `json:"interpolationType,omitempty"` + // ForceSendFields is a list of field names (e.g. "AttributeType") 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. "AttributeType") 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 GoogleCloudDialogflowCxV3BoostSpecConditionBoostSpecBoostControlSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3BoostSpecConditionBoostSpecBoostControlSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowCxV3BoostSpecConditionBoostSpecBoostControlSpecControlPo +// int: The control points used to define the curve. The curve defined through +// these control points can only be monotonically increasing or +// decreasing(constant values are acceptable). +type GoogleCloudDialogflowCxV3BoostSpecConditionBoostSpecBoostControlSpecControlPoint struct { + // AttributeValue: Optional. Can be one of: 1. The numerical field value. 2. + // The duration spec for freshness: The value must be formatted as an XSD + // `dayTimeDuration` value (a restricted subset of an ISO 8601 duration value). + // The pattern for this is: `nDnM]`. + AttributeValue string `json:"attributeValue,omitempty"` + // BoostAmount: Optional. The value between -1 to 1 by which to boost the score + // if the attribute_value evaluates to the value specified above. + BoostAmount float64 `json:"boostAmount,omitempty"` + // ForceSendFields is a list of field names (e.g. "AttributeValue") 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. "AttributeValue") 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 GoogleCloudDialogflowCxV3BoostSpecConditionBoostSpecBoostControlSpecControlPoint) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3BoostSpecConditionBoostSpecBoostControlSpecControlPoint + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleCloudDialogflowCxV3BoostSpecConditionBoostSpecBoostControlSpecControlPoint) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudDialogflowCxV3BoostSpecConditionBoostSpecBoostControlSpecControlPoint + var s1 struct { + BoostAmount gensupport.JSONFloat64 `json:"boostAmount"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.BoostAmount = float64(s1.BoostAmount) + return nil +} + // GoogleCloudDialogflowCxV3BoostSpecs: Boost specifications for data stores. type GoogleCloudDialogflowCxV3BoostSpecs struct { // DataStores: Optional. Data Stores where the boosting configuration is @@ -1512,29 +1616,6 @@ func (s GoogleCloudDialogflowCxV3ConversationTurnVirtualAgentOutput) MarshalJSON return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowCxV3CreateDocumentOperationMetadata: Metadata for -// CreateDocument operation. -type GoogleCloudDialogflowCxV3CreateDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3CreateDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3CreateDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3CreateVersionOperationMetadata: Metadata associated // with the long running operation for Versions.CreateVersion. type GoogleCloudDialogflowCxV3CreateVersionOperationMetadata struct { @@ -1854,29 +1935,6 @@ func (s GoogleCloudDialogflowCxV3DataStoreConnectionSignalsSearchSnippet) Marsha return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowCxV3DeleteDocumentOperationMetadata: Metadata for -// DeleteDocument operation. -type GoogleCloudDialogflowCxV3DeleteDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3DeleteDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3DeleteDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3DeployFlowMetadata: Metadata returned for the // Environments.DeployFlow long running operation. type GoogleCloudDialogflowCxV3DeployFlowMetadata struct { @@ -3919,81 +3977,6 @@ func (s GoogleCloudDialogflowCxV3GeneratorPlaceholder) MarshalJSON() ([]byte, er return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata: Metadata in -// google::longrunning::Operation for Knowledge operations. -type GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata struct { - // State: Required. Output only. The current state of this operation. - // - // Possible values: - // "STATE_UNSPECIFIED" - State unspecified. - // "PENDING" - The operation has been created. - // "RUNNING" - The operation is currently running. - // "DONE" - The operation is done, either cancelled or completed. - State string `json:"state,omitempty"` - // ForceSendFields is a list of field names (e.g. "State") 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. "State") 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 GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowCxV3ImportDocumentsOperationMetadata: Metadata for -// ImportDocuments operation. -type GoogleCloudDialogflowCxV3ImportDocumentsOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3ImportDocumentsOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3ImportDocumentsOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowCxV3ImportDocumentsResponse: Response message for -// Documents.ImportDocuments. -type GoogleCloudDialogflowCxV3ImportDocumentsResponse struct { - // Warnings: Includes details about skipped documents or any other warnings. - Warnings []*GoogleRpcStatus `json:"warnings,omitempty"` - // ForceSendFields is a list of field names (e.g. "Warnings") 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. "Warnings") 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 GoogleCloudDialogflowCxV3ImportDocumentsResponse) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3ImportDocumentsResponse - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3ImportEntityTypesMetadata: Metadata returned for // the EntityTypes.ImportEntityTypes long running operation. type GoogleCloudDialogflowCxV3ImportEntityTypesMetadata struct { @@ -6190,29 +6173,6 @@ func (s *GoogleCloudDialogflowCxV3QueryResult) UnmarshalJSON(data []byte) error return nil } -// GoogleCloudDialogflowCxV3ReloadDocumentOperationMetadata: Metadata for -// ReloadDocument operation. -type GoogleCloudDialogflowCxV3ReloadDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3ReloadDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3ReloadDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3ResourceName: Resource name and display name. type GoogleCloudDialogflowCxV3ResourceName struct { // DisplayName: Display name. @@ -6536,7 +6496,8 @@ type GoogleCloudDialogflowCxV3ResponseMessageText struct { // can be interrupted by the end user's speech and the client can then starts // the next Dialogflow request. AllowPlaybackInterruption bool `json:"allowPlaybackInterruption,omitempty"` - // Text: Required. A collection of text responses. + // Text: Required. A collection of text response variants. If multiple variants + // are defined, only one text response variant is returned at runtime. Text []string `json:"text,omitempty"` // ForceSendFields is a list of field names (e.g. "AllowPlaybackInterruption") // to unconditionally include in API requests. By default, fields with empty or @@ -7967,29 +7928,6 @@ func (s *GoogleCloudDialogflowCxV3TurnSignals) UnmarshalJSON(data []byte) error return nil } -// GoogleCloudDialogflowCxV3UpdateDocumentOperationMetadata: Metadata for -// UpdateDocument operation. -type GoogleCloudDialogflowCxV3UpdateDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3UpdateDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3UpdateDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3ValidateAgentRequest: The request message for // Agents.ValidateAgent. type GoogleCloudDialogflowCxV3ValidateAgentRequest struct { @@ -9167,29 +9105,6 @@ func (s GoogleCloudDialogflowCxV3beta1ConversationTurnVirtualAgentOutput) Marsha return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowCxV3beta1CreateDocumentOperationMetadata: Metadata for -// CreateDocument operation. -type GoogleCloudDialogflowCxV3beta1CreateDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3beta1CreateDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3beta1CreateDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3beta1CreateVersionOperationMetadata: Metadata // associated with the long running operation for Versions.CreateVersion. type GoogleCloudDialogflowCxV3beta1CreateVersionOperationMetadata struct { @@ -9251,29 +9166,6 @@ func (s GoogleCloudDialogflowCxV3beta1DataStoreConnection) MarshalJSON() ([]byte return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowCxV3beta1DeleteDocumentOperationMetadata: Metadata for -// DeleteDocument operation. -type GoogleCloudDialogflowCxV3beta1DeleteDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3beta1DeleteDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3beta1DeleteDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3beta1DeployFlowMetadata: Metadata returned for the // Environments.DeployFlow long running operation. type GoogleCloudDialogflowCxV3beta1DeployFlowMetadata struct { @@ -10006,81 +9898,6 @@ func (s GoogleCloudDialogflowCxV3beta1GcsDestination) MarshalJSON() ([]byte, err return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata: Metadata in -// google::longrunning::Operation for Knowledge operations. -type GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata struct { - // State: Required. Output only. The current state of this operation. - // - // Possible values: - // "STATE_UNSPECIFIED" - State unspecified. - // "PENDING" - The operation has been created. - // "RUNNING" - The operation is currently running. - // "DONE" - The operation is done, either cancelled or completed. - State string `json:"state,omitempty"` - // ForceSendFields is a list of field names (e.g. "State") 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. "State") 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 GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowCxV3beta1ImportDocumentsOperationMetadata: Metadata for -// ImportDocuments operation. -type GoogleCloudDialogflowCxV3beta1ImportDocumentsOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3beta1ImportDocumentsOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3beta1ImportDocumentsOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowCxV3beta1ImportDocumentsResponse: Response message for -// Documents.ImportDocuments. -type GoogleCloudDialogflowCxV3beta1ImportDocumentsResponse struct { - // Warnings: Includes details about skipped documents or any other warnings. - Warnings []*GoogleRpcStatus `json:"warnings,omitempty"` - // ForceSendFields is a list of field names (e.g. "Warnings") 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. "Warnings") 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 GoogleCloudDialogflowCxV3beta1ImportDocumentsResponse) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3beta1ImportDocumentsResponse - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3beta1ImportEntityTypesMetadata: Metadata returned // for the EntityTypes.ImportEntityTypes long running operation. type GoogleCloudDialogflowCxV3beta1ImportEntityTypesMetadata struct { @@ -10897,29 +10714,6 @@ func (s GoogleCloudDialogflowCxV3beta1QueryInput) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowCxV3beta1ReloadDocumentOperationMetadata: Metadata for -// ReloadDocument operation. -type GoogleCloudDialogflowCxV3beta1ReloadDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3beta1ReloadDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3beta1ReloadDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3beta1ResponseMessage: Represents a response message // that can be returned by a conversational agent. Response messages are also // used for output audio synthesis. The approach is as follows: * If at least @@ -11214,7 +11008,8 @@ type GoogleCloudDialogflowCxV3beta1ResponseMessageText struct { // can be interrupted by the end user's speech and the client can then starts // the next Dialogflow request. AllowPlaybackInterruption bool `json:"allowPlaybackInterruption,omitempty"` - // Text: Required. A collection of text responses. + // Text: Required. A collection of text response variants. If multiple variants + // are defined, only one text response variant is returned at runtime. Text []string `json:"text,omitempty"` // ForceSendFields is a list of field names (e.g. "AllowPlaybackInterruption") // to unconditionally include in API requests. By default, fields with empty or @@ -11768,29 +11563,6 @@ func (s *GoogleCloudDialogflowCxV3beta1TurnSignals) UnmarshalJSON(data []byte) e return nil } -// GoogleCloudDialogflowCxV3beta1UpdateDocumentOperationMetadata: Metadata for -// UpdateDocument operation. -type GoogleCloudDialogflowCxV3beta1UpdateDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3beta1UpdateDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3beta1UpdateDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3beta1Webhook: Webhooks host the developer's // business logic. During a session, webhooks allow the developer to use the // data extracted by Dialogflow's natural language processing to generate @@ -18328,7 +18100,8 @@ func (s GoogleCloudDialogflowV2beta1ResponseMessageTelephonyTransferCall) Marsha // GoogleCloudDialogflowV2beta1ResponseMessageText: The text response message. type GoogleCloudDialogflowV2beta1ResponseMessageText struct { - // Text: A collection of text responses. + // Text: A collection of text response variants. If multiple variants are + // defined, only one text response variant is returned at runtime. Text []string `json:"text,omitempty"` // ForceSendFields is a list of field names (e.g. "Text") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -18920,150 +18693,6 @@ func (s GoogleCloudDialogflowV3alpha1ConversationSignals) MarshalJSON() ([]byte, return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowV3alpha1CreateDocumentOperationMetadata: Metadata for -// CreateDocument operation. -type GoogleCloudDialogflowV3alpha1CreateDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowV3alpha1CreateDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowV3alpha1CreateDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowV3alpha1DeleteDocumentOperationMetadata: Metadata for -// DeleteDocument operation. -type GoogleCloudDialogflowV3alpha1DeleteDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowV3alpha1DeleteDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowV3alpha1DeleteDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata: Metadata in -// google::longrunning::Operation for Knowledge operations. -type GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata struct { - // State: Required. Output only. The current state of this operation. - // - // Possible values: - // "STATE_UNSPECIFIED" - State unspecified. - // "PENDING" - The operation has been created. - // "RUNNING" - The operation is currently running. - // "DONE" - The operation is done, either cancelled or completed. - State string `json:"state,omitempty"` - // ForceSendFields is a list of field names (e.g. "State") 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. "State") 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 GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowV3alpha1ImportDocumentsOperationMetadata: Metadata for -// ImportDocuments operation. -type GoogleCloudDialogflowV3alpha1ImportDocumentsOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowV3alpha1ImportDocumentsOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowV3alpha1ImportDocumentsOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowV3alpha1ImportDocumentsResponse: Response message for -// Documents.ImportDocuments. -type GoogleCloudDialogflowV3alpha1ImportDocumentsResponse struct { - // Warnings: Includes details about skipped documents or any other warnings. - Warnings []*GoogleRpcStatus `json:"warnings,omitempty"` - // ForceSendFields is a list of field names (e.g. "Warnings") 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. "Warnings") 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 GoogleCloudDialogflowV3alpha1ImportDocumentsResponse) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowV3alpha1ImportDocumentsResponse - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowV3alpha1ReloadDocumentOperationMetadata: Metadata for -// ReloadDocument operation. -type GoogleCloudDialogflowV3alpha1ReloadDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowV3alpha1ReloadDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowV3alpha1ReloadDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowV3alpha1TurnSignals: Collection of all signals that // were extracted for a single turn of the conversation. type GoogleCloudDialogflowV3alpha1TurnSignals struct { @@ -19132,29 +18761,6 @@ func (s *GoogleCloudDialogflowV3alpha1TurnSignals) UnmarshalJSON(data []byte) er return nil } -// GoogleCloudDialogflowV3alpha1UpdateDocumentOperationMetadata: Metadata for -// UpdateDocument operation. -type GoogleCloudDialogflowV3alpha1UpdateDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowV3alpha1UpdateDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowV3alpha1UpdateDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudLocationListLocationsResponse: The response message for // Locations.ListLocations. type GoogleCloudLocationListLocationsResponse struct { diff --git a/dialogflow/v3beta1/dialogflow-api.json b/dialogflow/v3beta1/dialogflow-api.json index 0dd82ee73b3..6626707c655 100644 --- a/dialogflow/v3beta1/dialogflow-api.json +++ b/dialogflow/v3beta1/dialogflow-api.json @@ -5185,7 +5185,7 @@ } } }, - "revision": "20240731", + "revision": "20240812", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AdvancedSettings": { @@ -5489,17 +5489,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3CreateDocumentOperationMetadata": { - "description": "Metadata for CreateDocument operation.", - "id": "GoogleCloudDialogflowCxV3CreateDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3CreateVersionOperationMetadata": { "description": "Metadata associated with the long running operation for Versions.CreateVersion.", "id": "GoogleCloudDialogflowCxV3CreateVersionOperationMetadata", @@ -5538,17 +5527,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3DeleteDocumentOperationMetadata": { - "description": "Metadata for DeleteDocument operation.", - "id": "GoogleCloudDialogflowCxV3DeleteDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3DeployFlowMetadata": { "description": "Metadata returned for the Environments.DeployFlow long running operation.", "id": "GoogleCloudDialogflowCxV3DeployFlowMetadata", @@ -6015,55 +5993,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata": { - "description": "Metadata in google::longrunning::Operation for Knowledge operations.", - "id": "GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata", - "properties": { - "state": { - "description": "Required. Output only. The current state of this operation.", - "enum": [ - "STATE_UNSPECIFIED", - "PENDING", - "RUNNING", - "DONE" - ], - "enumDescriptions": [ - "State unspecified.", - "The operation has been created.", - "The operation is currently running.", - "The operation is done, either cancelled or completed." - ], - "readOnly": true, - "type": "string" - } - }, - "type": "object" - }, - "GoogleCloudDialogflowCxV3ImportDocumentsOperationMetadata": { - "description": "Metadata for ImportDocuments operation.", - "id": "GoogleCloudDialogflowCxV3ImportDocumentsOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, - "GoogleCloudDialogflowCxV3ImportDocumentsResponse": { - "description": "Response message for Documents.ImportDocuments.", - "id": "GoogleCloudDialogflowCxV3ImportDocumentsResponse", - "properties": { - "warnings": { - "description": "Includes details about skipped documents or any other warnings.", - "items": { - "$ref": "GoogleRpcStatus" - }, - "type": "array" - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3ImportEntityTypesMetadata": { "description": "Metadata returned for the EntityTypes.ImportEntityTypes long running operation.", "id": "GoogleCloudDialogflowCxV3ImportEntityTypesMetadata", @@ -6615,17 +6544,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3ReloadDocumentOperationMetadata": { - "description": "Metadata for ReloadDocument operation.", - "id": "GoogleCloudDialogflowCxV3ReloadDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3ResponseMessage": { "description": "Represents a response message that can be returned by a conversational agent. Response messages are also used for output audio synthesis. The approach is as follows: * If at least one OutputAudioText response is present, then all OutputAudioText responses are linearly concatenated, and the result is used for output audio synthesis. * If the OutputAudioText responses are a mixture of text and SSML, then the concatenated result is treated as SSML; otherwise, the result is treated as either text or SSML as appropriate. The agent designer should ideally use either text or SSML consistently throughout the bot design. * Otherwise, all Text responses are linearly concatenated, and the result is used for output audio synthesis. This approach allows for more sophisticated user experience scenarios, where the text displayed to the user may differ from what is heard.", "id": "GoogleCloudDialogflowCxV3ResponseMessage", @@ -6833,7 +6751,7 @@ "type": "boolean" }, "text": { - "description": "Required. A collection of text responses.", + "description": "Required. A collection of text response variants. If multiple variants are defined, only one text response variant is returned at runtime.", "items": { "type": "string" }, @@ -7190,17 +7108,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3UpdateDocumentOperationMetadata": { - "description": "Metadata for UpdateDocument operation.", - "id": "GoogleCloudDialogflowCxV3UpdateDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3Webhook": { "description": "Webhooks host the developer's business logic. During a session, webhooks allow the developer to use the data extracted by Dialogflow's natural language processing to generate dynamic responses, validate collected data, or trigger actions on the backend.", "id": "GoogleCloudDialogflowCxV3Webhook", @@ -8078,6 +7985,10 @@ "format": "float", "type": "number" }, + "boostControlSpec": { + "$ref": "GoogleCloudDialogflowCxV3beta1BoostSpecConditionBoostSpecBoostControlSpec", + "description": "Optional. Complex specification for custom ranking based on customer defined attribute value." + }, "condition": { "description": "Optional. An expression which specifies a boost condition. The syntax and supported fields are the same as a filter expression. Examples: * To boost documents with document ID \"doc_1\" or \"doc_2\", and color \"Red\" or \"Blue\": * (id: ANY(\"doc_1\", \"doc_2\")) AND (color: ANY(\"Red\",\"Blue\"))", "type": "string" @@ -8085,6 +7996,66 @@ }, "type": "object" }, + "GoogleCloudDialogflowCxV3beta1BoostSpecConditionBoostSpecBoostControlSpec": { + "description": "Specification for custom ranking based on customer specified attribute value. It provides more controls for customized ranking than the simple (condition, boost) combination above.", + "id": "GoogleCloudDialogflowCxV3beta1BoostSpecConditionBoostSpecBoostControlSpec", + "properties": { + "attributeType": { + "description": "Optional. The attribute type to be used to determine the boost amount. The attribute value can be derived from the field value of the specified field_name. In the case of numerical it is straightforward i.e. attribute_value = numerical_field_value. In the case of freshness however, attribute_value = (time.now() - datetime_field_value).", + "enum": [ + "ATTRIBUTE_TYPE_UNSPECIFIED", + "NUMERICAL", + "FRESHNESS" + ], + "enumDescriptions": [ + "Unspecified AttributeType.", + "The value of the numerical field will be used to dynamically update the boost amount. In this case, the attribute_value (the x value) of the control point will be the actual value of the numerical field for which the boost_amount is specified.", + "For the freshness use case the attribute value will be the duration between the current time and the date in the datetime field specified. The value must be formatted as an XSD `dayTimeDuration` value (a restricted subset of an ISO 8601 duration value). The pattern for this is: `nDnM]`. E.g. `5D`, `3DT12H30M`, `T24H`." + ], + "type": "string" + }, + "controlPoints": { + "description": "Optional. The control points used to define the curve. The monotonic function (defined through the interpolation_type above) passes through the control points listed here.", + "items": { + "$ref": "GoogleCloudDialogflowCxV3beta1BoostSpecConditionBoostSpecBoostControlSpecControlPoint" + }, + "type": "array" + }, + "fieldName": { + "description": "Optional. The name of the field whose value will be used to determine the boost amount.", + "type": "string" + }, + "interpolationType": { + "description": "Optional. The interpolation type to be applied to connect the control points listed below.", + "enum": [ + "INTERPOLATION_TYPE_UNSPECIFIED", + "LINEAR" + ], + "enumDescriptions": [ + "Interpolation type is unspecified. In this case, it defaults to Linear.", + "Piecewise linear interpolation will be applied." + ], + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowCxV3beta1BoostSpecConditionBoostSpecBoostControlSpecControlPoint": { + "description": "The control points used to define the curve. The curve defined through these control points can only be monotonically increasing or decreasing(constant values are acceptable).", + "id": "GoogleCloudDialogflowCxV3beta1BoostSpecConditionBoostSpecBoostControlSpecControlPoint", + "properties": { + "attributeValue": { + "description": "Optional. Can be one of: 1. The numerical field value. 2. The duration spec for freshness: The value must be formatted as an XSD `dayTimeDuration` value (a restricted subset of an ISO 8601 duration value). The pattern for this is: `nDnM]`.", + "type": "string" + }, + "boostAmount": { + "description": "Optional. The value between -1 to 1 by which to boost the score if the attribute_value evaluates to the value specified above.", + "format": "float", + "type": "number" + } + }, + "type": "object" + }, "GoogleCloudDialogflowCxV3beta1BoostSpecs": { "description": "Boost specifications for data stores.", "id": "GoogleCloudDialogflowCxV3beta1BoostSpecs", @@ -8606,17 +8577,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3beta1CreateDocumentOperationMetadata": { - "description": "Metadata for CreateDocument operation.", - "id": "GoogleCloudDialogflowCxV3beta1CreateDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3beta1CreateVersionOperationMetadata": { "description": "Metadata associated with the long running operation for Versions.CreateVersion.", "id": "GoogleCloudDialogflowCxV3beta1CreateVersionOperationMetadata", @@ -8881,17 +8841,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3beta1DeleteDocumentOperationMetadata": { - "description": "Metadata for DeleteDocument operation.", - "id": "GoogleCloudDialogflowCxV3beta1DeleteDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3beta1DeployFlowMetadata": { "description": "Metadata returned for the Environments.DeployFlow long running operation.", "id": "GoogleCloudDialogflowCxV3beta1DeployFlowMetadata", @@ -10505,55 +10454,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata": { - "description": "Metadata in google::longrunning::Operation for Knowledge operations.", - "id": "GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata", - "properties": { - "state": { - "description": "Required. Output only. The current state of this operation.", - "enum": [ - "STATE_UNSPECIFIED", - "PENDING", - "RUNNING", - "DONE" - ], - "enumDescriptions": [ - "State unspecified.", - "The operation has been created.", - "The operation is currently running.", - "The operation is done, either cancelled or completed." - ], - "readOnly": true, - "type": "string" - } - }, - "type": "object" - }, - "GoogleCloudDialogflowCxV3beta1ImportDocumentsOperationMetadata": { - "description": "Metadata for ImportDocuments operation.", - "id": "GoogleCloudDialogflowCxV3beta1ImportDocumentsOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, - "GoogleCloudDialogflowCxV3beta1ImportDocumentsResponse": { - "description": "Response message for Documents.ImportDocuments.", - "id": "GoogleCloudDialogflowCxV3beta1ImportDocumentsResponse", - "properties": { - "warnings": { - "description": "Includes details about skipped documents or any other warnings.", - "items": { - "$ref": "GoogleRpcStatus" - }, - "type": "array" - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3beta1ImportEntityTypesMetadata": { "description": "Metadata returned for the EntityTypes.ImportEntityTypes long running operation.", "id": "GoogleCloudDialogflowCxV3beta1ImportEntityTypesMetadata", @@ -12483,17 +12383,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3beta1ReloadDocumentOperationMetadata": { - "description": "Metadata for ReloadDocument operation.", - "id": "GoogleCloudDialogflowCxV3beta1ReloadDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3beta1ResourceName": { "description": "Resource name and display name.", "id": "GoogleCloudDialogflowCxV3beta1ResourceName", @@ -12704,7 +12593,7 @@ "type": "boolean" }, "text": { - "description": "Required. A collection of text responses.", + "description": "Required. A collection of text response variants. If multiple variants are defined, only one text response variant is returned at runtime.", "items": { "type": "string" }, @@ -13470,6 +13359,10 @@ "$ref": "GoogleCloudDialogflowCxV3beta1ToolAuthenticationApiKeyConfig", "description": "Config for API key auth." }, + "bearerTokenConfig": { + "$ref": "GoogleCloudDialogflowCxV3beta1ToolAuthenticationBearerTokenConfig", + "description": "Config for bearer token auth." + }, "oauthConfig": { "$ref": "GoogleCloudDialogflowCxV3beta1ToolAuthenticationOAuthConfig", "description": "Config for OAuth." @@ -13510,6 +13403,17 @@ }, "type": "object" }, + "GoogleCloudDialogflowCxV3beta1ToolAuthenticationBearerTokenConfig": { + "description": "Config for authentication using bearer token.", + "id": "GoogleCloudDialogflowCxV3beta1ToolAuthenticationBearerTokenConfig", + "properties": { + "token": { + "description": "Required. The text token appended to the text `Bearer` to the request Authorization header. [Session parameters reference](https://cloud.google.com/dialogflow/cx/docs/concept/parameter#session-ref) can be used to pass the token dynamically, e.g. `$session.params.parameter-id`.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDialogflowCxV3beta1ToolAuthenticationOAuthConfig": { "description": "Config for authentication with OAuth.", "id": "GoogleCloudDialogflowCxV3beta1ToolAuthenticationOAuthConfig", @@ -13544,7 +13448,22 @@ "GoogleCloudDialogflowCxV3beta1ToolAuthenticationServiceAgentAuthConfig": { "description": "Config for auth using [Diglogflow service agent](https://cloud.google.com/iam/docs/service-agents#dialogflow-service-agent).", "id": "GoogleCloudDialogflowCxV3beta1ToolAuthenticationServiceAgentAuthConfig", - "properties": {}, + "properties": { + "serviceAgentAuth": { + "description": "Optional. Indicate the auth token type generated from the [Diglogflow service agent](https://cloud.google.com/iam/docs/service-agents#dialogflow-service-agent). The generated token is sent in the Authorization header.", + "enum": [ + "SERVICE_AGENT_AUTH_UNSPECIFIED", + "ID_TOKEN", + "ACCESS_TOKEN" + ], + "enumDescriptions": [ + "Service agent auth type unspecified. Default to ID_TOKEN.", + "Use [ID token](https://cloud.google.com/docs/authentication/token-types#id) generated from service agent. This can be used to access Cloud Function and Cloud Run after you grant Invoker role to `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`.", + "Use [access token](https://cloud.google.com/docs/authentication/token-types#access) generated from service agent. This can be used to access other Google Cloud APIs after you grant required roles to `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`." + ], + "type": "string" + } + }, "type": "object" }, "GoogleCloudDialogflowCxV3beta1ToolCall": { @@ -14043,17 +13962,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowCxV3beta1UpdateDocumentOperationMetadata": { - "description": "Metadata for UpdateDocument operation.", - "id": "GoogleCloudDialogflowCxV3beta1UpdateDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowCxV3beta1UserUtterance": { "description": "UserUtterance represents one message sent by the customer.", "id": "GoogleCloudDialogflowCxV3beta1UserUtterance", @@ -19160,7 +19068,7 @@ "id": "GoogleCloudDialogflowV2beta1ResponseMessageText", "properties": { "text": { - "description": "A collection of text responses.", + "description": "A collection of text response variants. If multiple variants are defined, only one text response variant is returned at runtime.", "items": { "type": "string" }, @@ -19550,88 +19458,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowV3alpha1CreateDocumentOperationMetadata": { - "description": "Metadata for CreateDocument operation.", - "id": "GoogleCloudDialogflowV3alpha1CreateDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, - "GoogleCloudDialogflowV3alpha1DeleteDocumentOperationMetadata": { - "description": "Metadata for DeleteDocument operation.", - "id": "GoogleCloudDialogflowV3alpha1DeleteDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, - "GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata": { - "description": "Metadata in google::longrunning::Operation for Knowledge operations.", - "id": "GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata", - "properties": { - "state": { - "description": "Required. Output only. The current state of this operation.", - "enum": [ - "STATE_UNSPECIFIED", - "PENDING", - "RUNNING", - "DONE" - ], - "enumDescriptions": [ - "State unspecified.", - "The operation has been created.", - "The operation is currently running.", - "The operation is done, either cancelled or completed." - ], - "readOnly": true, - "type": "string" - } - }, - "type": "object" - }, - "GoogleCloudDialogflowV3alpha1ImportDocumentsOperationMetadata": { - "description": "Metadata for ImportDocuments operation.", - "id": "GoogleCloudDialogflowV3alpha1ImportDocumentsOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, - "GoogleCloudDialogflowV3alpha1ImportDocumentsResponse": { - "description": "Response message for Documents.ImportDocuments.", - "id": "GoogleCloudDialogflowV3alpha1ImportDocumentsResponse", - "properties": { - "warnings": { - "description": "Includes details about skipped documents or any other warnings.", - "items": { - "$ref": "GoogleRpcStatus" - }, - "type": "array" - } - }, - "type": "object" - }, - "GoogleCloudDialogflowV3alpha1ReloadDocumentOperationMetadata": { - "description": "Metadata for ReloadDocument operation.", - "id": "GoogleCloudDialogflowV3alpha1ReloadDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudDialogflowV3alpha1TurnSignals": { "description": "Collection of all signals that were extracted for a single turn of the conversation.", "id": "GoogleCloudDialogflowV3alpha1TurnSignals", @@ -19701,17 +19527,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowV3alpha1UpdateDocumentOperationMetadata": { - "description": "Metadata for UpdateDocument operation.", - "id": "GoogleCloudDialogflowV3alpha1UpdateDocumentOperationMetadata", - "properties": { - "genericMetadata": { - "$ref": "GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata", - "description": "The generic information of the operation." - } - }, - "type": "object" - }, "GoogleCloudLocationListLocationsResponse": { "description": "The response message for Locations.ListLocations.", "id": "GoogleCloudLocationListLocationsResponse", diff --git a/dialogflow/v3beta1/dialogflow-gen.go b/dialogflow/v3beta1/dialogflow-gen.go index 13e9e2d8838..e496a82a351 100644 --- a/dialogflow/v3beta1/dialogflow-gen.go +++ b/dialogflow/v3beta1/dialogflow-gen.go @@ -959,29 +959,6 @@ func (s GoogleCloudDialogflowCxV3ConversationTurnVirtualAgentOutput) MarshalJSON return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowCxV3CreateDocumentOperationMetadata: Metadata for -// CreateDocument operation. -type GoogleCloudDialogflowCxV3CreateDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3CreateDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3CreateDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3CreateVersionOperationMetadata: Metadata associated // with the long running operation for Versions.CreateVersion. type GoogleCloudDialogflowCxV3CreateVersionOperationMetadata struct { @@ -1043,29 +1020,6 @@ func (s GoogleCloudDialogflowCxV3DataStoreConnection) MarshalJSON() ([]byte, err return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowCxV3DeleteDocumentOperationMetadata: Metadata for -// DeleteDocument operation. -type GoogleCloudDialogflowCxV3DeleteDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3DeleteDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3DeleteDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3DeployFlowMetadata: Metadata returned for the // Environments.DeployFlow long running operation. type GoogleCloudDialogflowCxV3DeployFlowMetadata struct { @@ -1797,81 +1751,6 @@ func (s GoogleCloudDialogflowCxV3GcsDestination) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata: Metadata in -// google::longrunning::Operation for Knowledge operations. -type GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata struct { - // State: Required. Output only. The current state of this operation. - // - // Possible values: - // "STATE_UNSPECIFIED" - State unspecified. - // "PENDING" - The operation has been created. - // "RUNNING" - The operation is currently running. - // "DONE" - The operation is done, either cancelled or completed. - State string `json:"state,omitempty"` - // ForceSendFields is a list of field names (e.g. "State") 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. "State") 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 GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowCxV3ImportDocumentsOperationMetadata: Metadata for -// ImportDocuments operation. -type GoogleCloudDialogflowCxV3ImportDocumentsOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3ImportDocumentsOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3ImportDocumentsOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowCxV3ImportDocumentsResponse: Response message for -// Documents.ImportDocuments. -type GoogleCloudDialogflowCxV3ImportDocumentsResponse struct { - // Warnings: Includes details about skipped documents or any other warnings. - Warnings []*GoogleRpcStatus `json:"warnings,omitempty"` - // ForceSendFields is a list of field names (e.g. "Warnings") 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. "Warnings") 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 GoogleCloudDialogflowCxV3ImportDocumentsResponse) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3ImportDocumentsResponse - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3ImportEntityTypesMetadata: Metadata returned for // the EntityTypes.ImportEntityTypes long running operation. type GoogleCloudDialogflowCxV3ImportEntityTypesMetadata struct { @@ -2685,29 +2564,6 @@ func (s GoogleCloudDialogflowCxV3QueryInput) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowCxV3ReloadDocumentOperationMetadata: Metadata for -// ReloadDocument operation. -type GoogleCloudDialogflowCxV3ReloadDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3ReloadDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3ReloadDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3ResponseMessage: Represents a response message that // can be returned by a conversational agent. Response messages are also used // for output audio synthesis. The approach is as follows: * If at least one @@ -3007,7 +2863,8 @@ type GoogleCloudDialogflowCxV3ResponseMessageText struct { // can be interrupted by the end user's speech and the client can then starts // the next Dialogflow request. AllowPlaybackInterruption bool `json:"allowPlaybackInterruption,omitempty"` - // Text: Required. A collection of text responses. + // Text: Required. A collection of text response variants. If multiple variants + // are defined, only one text response variant is returned at runtime. Text []string `json:"text,omitempty"` // ForceSendFields is a list of field names (e.g. "AllowPlaybackInterruption") // to unconditionally include in API requests. By default, fields with empty or @@ -3479,29 +3336,6 @@ func (s *GoogleCloudDialogflowCxV3TurnSignals) UnmarshalJSON(data []byte) error return nil } -// GoogleCloudDialogflowCxV3UpdateDocumentOperationMetadata: Metadata for -// UpdateDocument operation. -type GoogleCloudDialogflowCxV3UpdateDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3UpdateDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3UpdateDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3Webhook: Webhooks host the developer's business // logic. During a session, webhooks allow the developer to use the data // extracted by Dialogflow's natural language processing to generate dynamic @@ -4718,6 +4552,9 @@ type GoogleCloudDialogflowCxV3beta1BoostSpecConditionBoostSpec struct { // out completely. Setting to 0.0 means no boost applied. The boosting // condition is ignored. Boost float64 `json:"boost,omitempty"` + // BoostControlSpec: Optional. Complex specification for custom ranking based + // on customer defined attribute value. + BoostControlSpec *GoogleCloudDialogflowCxV3beta1BoostSpecConditionBoostSpecBoostControlSpec `json:"boostControlSpec,omitempty"` // Condition: Optional. An expression which specifies a boost condition. The // syntax and supported fields are the same as a filter expression. Examples: * // To boost documents with document ID "doc_1" or "doc_2", and color "Red" or @@ -4755,6 +4592,107 @@ func (s *GoogleCloudDialogflowCxV3beta1BoostSpecConditionBoostSpec) UnmarshalJSO return nil } +// GoogleCloudDialogflowCxV3beta1BoostSpecConditionBoostSpecBoostControlSpec: +// Specification for custom ranking based on customer specified attribute +// value. It provides more controls for customized ranking than the simple +// (condition, boost) combination above. +type GoogleCloudDialogflowCxV3beta1BoostSpecConditionBoostSpecBoostControlSpec struct { + // AttributeType: Optional. The attribute type to be used to determine the + // boost amount. The attribute value can be derived from the field value of the + // specified field_name. In the case of numerical it is straightforward i.e. + // attribute_value = numerical_field_value. In the case of freshness however, + // attribute_value = (time.now() - datetime_field_value). + // + // Possible values: + // "ATTRIBUTE_TYPE_UNSPECIFIED" - Unspecified AttributeType. + // "NUMERICAL" - The value of the numerical field will be used to dynamically + // update the boost amount. In this case, the attribute_value (the x value) of + // the control point will be the actual value of the numerical field for which + // the boost_amount is specified. + // "FRESHNESS" - For the freshness use case the attribute value will be the + // duration between the current time and the date in the datetime field + // specified. The value must be formatted as an XSD `dayTimeDuration` value (a + // restricted subset of an ISO 8601 duration value). The pattern for this is: + // `nDnM]`. E.g. `5D`, `3DT12H30M`, `T24H`. + AttributeType string `json:"attributeType,omitempty"` + // ControlPoints: Optional. The control points used to define the curve. The + // monotonic function (defined through the interpolation_type above) passes + // through the control points listed here. + ControlPoints []*GoogleCloudDialogflowCxV3beta1BoostSpecConditionBoostSpecBoostControlSpecControlPoint `json:"controlPoints,omitempty"` + // FieldName: Optional. The name of the field whose value will be used to + // determine the boost amount. + FieldName string `json:"fieldName,omitempty"` + // InterpolationType: Optional. The interpolation type to be applied to connect + // the control points listed below. + // + // Possible values: + // "INTERPOLATION_TYPE_UNSPECIFIED" - Interpolation type is unspecified. In + // this case, it defaults to Linear. + // "LINEAR" - Piecewise linear interpolation will be applied. + InterpolationType string `json:"interpolationType,omitempty"` + // ForceSendFields is a list of field names (e.g. "AttributeType") 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. "AttributeType") 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 GoogleCloudDialogflowCxV3beta1BoostSpecConditionBoostSpecBoostControlSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3beta1BoostSpecConditionBoostSpecBoostControlSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowCxV3beta1BoostSpecConditionBoostSpecBoostControlSpecCont +// rolPoint: The control points used to define the curve. The curve defined +// through these control points can only be monotonically increasing or +// decreasing(constant values are acceptable). +type GoogleCloudDialogflowCxV3beta1BoostSpecConditionBoostSpecBoostControlSpecControlPoint struct { + // AttributeValue: Optional. Can be one of: 1. The numerical field value. 2. + // The duration spec for freshness: The value must be formatted as an XSD + // `dayTimeDuration` value (a restricted subset of an ISO 8601 duration value). + // The pattern for this is: `nDnM]`. + AttributeValue string `json:"attributeValue,omitempty"` + // BoostAmount: Optional. The value between -1 to 1 by which to boost the score + // if the attribute_value evaluates to the value specified above. + BoostAmount float64 `json:"boostAmount,omitempty"` + // ForceSendFields is a list of field names (e.g. "AttributeValue") 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. "AttributeValue") 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 GoogleCloudDialogflowCxV3beta1BoostSpecConditionBoostSpecBoostControlSpecControlPoint) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3beta1BoostSpecConditionBoostSpecBoostControlSpecControlPoint + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleCloudDialogflowCxV3beta1BoostSpecConditionBoostSpecBoostControlSpecControlPoint) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudDialogflowCxV3beta1BoostSpecConditionBoostSpecBoostControlSpecControlPoint + var s1 struct { + BoostAmount gensupport.JSONFloat64 `json:"boostAmount"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.BoostAmount = float64(s1.BoostAmount) + return nil +} + // GoogleCloudDialogflowCxV3beta1BoostSpecs: Boost specifications for data // stores. type GoogleCloudDialogflowCxV3beta1BoostSpecs struct { @@ -5362,29 +5300,6 @@ func (s GoogleCloudDialogflowCxV3beta1ConversationTurnVirtualAgentOutput) Marsha return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowCxV3beta1CreateDocumentOperationMetadata: Metadata for -// CreateDocument operation. -type GoogleCloudDialogflowCxV3beta1CreateDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3beta1CreateDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3beta1CreateDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3beta1CreateVersionOperationMetadata: Metadata // associated with the long running operation for Versions.CreateVersion. type GoogleCloudDialogflowCxV3beta1CreateVersionOperationMetadata struct { @@ -5705,29 +5620,6 @@ func (s GoogleCloudDialogflowCxV3beta1DataStoreConnectionSignalsSearchSnippet) M return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowCxV3beta1DeleteDocumentOperationMetadata: Metadata for -// DeleteDocument operation. -type GoogleCloudDialogflowCxV3beta1DeleteDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3beta1DeleteDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3beta1DeleteDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3beta1DeployFlowMetadata: Metadata returned for the // Environments.DeployFlow long running operation. type GoogleCloudDialogflowCxV3beta1DeployFlowMetadata struct { @@ -7963,81 +7855,6 @@ func (s GoogleCloudDialogflowCxV3beta1GeneratorPlaceholder) MarshalJSON() ([]byt return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata: Metadata in -// google::longrunning::Operation for Knowledge operations. -type GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata struct { - // State: Required. Output only. The current state of this operation. - // - // Possible values: - // "STATE_UNSPECIFIED" - State unspecified. - // "PENDING" - The operation has been created. - // "RUNNING" - The operation is currently running. - // "DONE" - The operation is done, either cancelled or completed. - State string `json:"state,omitempty"` - // ForceSendFields is a list of field names (e.g. "State") 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. "State") 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 GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowCxV3beta1ImportDocumentsOperationMetadata: Metadata for -// ImportDocuments operation. -type GoogleCloudDialogflowCxV3beta1ImportDocumentsOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3beta1ImportDocumentsOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3beta1ImportDocumentsOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowCxV3beta1ImportDocumentsResponse: Response message for -// Documents.ImportDocuments. -type GoogleCloudDialogflowCxV3beta1ImportDocumentsResponse struct { - // Warnings: Includes details about skipped documents or any other warnings. - Warnings []*GoogleRpcStatus `json:"warnings,omitempty"` - // ForceSendFields is a list of field names (e.g. "Warnings") 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. "Warnings") 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 GoogleCloudDialogflowCxV3beta1ImportDocumentsResponse) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3beta1ImportDocumentsResponse - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3beta1ImportEntityTypesMetadata: Metadata returned // for the EntityTypes.ImportEntityTypes long running operation. type GoogleCloudDialogflowCxV3beta1ImportEntityTypesMetadata struct { @@ -10751,29 +10568,6 @@ func (s *GoogleCloudDialogflowCxV3beta1QueryResult) UnmarshalJSON(data []byte) e return nil } -// GoogleCloudDialogflowCxV3beta1ReloadDocumentOperationMetadata: Metadata for -// ReloadDocument operation. -type GoogleCloudDialogflowCxV3beta1ReloadDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3beta1ReloadDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3beta1ReloadDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3beta1ResourceName: Resource name and display name. type GoogleCloudDialogflowCxV3beta1ResourceName struct { // DisplayName: Display name. @@ -11092,7 +10886,8 @@ type GoogleCloudDialogflowCxV3beta1ResponseMessageText struct { // can be interrupted by the end user's speech and the client can then starts // the next Dialogflow request. AllowPlaybackInterruption bool `json:"allowPlaybackInterruption,omitempty"` - // Text: Required. A collection of text responses. + // Text: Required. A collection of text response variants. If multiple variants + // are defined, only one text response variant is returned at runtime. Text []string `json:"text,omitempty"` // ForceSendFields is a list of field names (e.g. "AllowPlaybackInterruption") // to unconditionally include in API requests. By default, fields with empty or @@ -12208,6 +12003,8 @@ func (s GoogleCloudDialogflowCxV3beta1Tool) MarshalJSON() ([]byte, error) { type GoogleCloudDialogflowCxV3beta1ToolAuthentication struct { // ApiKeyConfig: Config for API key auth. ApiKeyConfig *GoogleCloudDialogflowCxV3beta1ToolAuthenticationApiKeyConfig `json:"apiKeyConfig,omitempty"` + // BearerTokenConfig: Config for bearer token auth. + BearerTokenConfig *GoogleCloudDialogflowCxV3beta1ToolAuthenticationBearerTokenConfig `json:"bearerTokenConfig,omitempty"` // OauthConfig: Config for OAuth. OauthConfig *GoogleCloudDialogflowCxV3beta1ToolAuthenticationOAuthConfig `json:"oauthConfig,omitempty"` // ServiceAgentAuthConfig: Config for Diglogflow service agent @@ -12266,6 +12063,33 @@ func (s GoogleCloudDialogflowCxV3beta1ToolAuthenticationApiKeyConfig) MarshalJSO return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDialogflowCxV3beta1ToolAuthenticationBearerTokenConfig: Config +// for authentication using bearer token. +type GoogleCloudDialogflowCxV3beta1ToolAuthenticationBearerTokenConfig struct { + // Token: Required. The text token appended to the text `Bearer` to the request + // Authorization header. Session parameters reference + // (https://cloud.google.com/dialogflow/cx/docs/concept/parameter#session-ref) + // can be used to pass the token dynamically, e.g. + // `$session.params.parameter-id`. + Token string `json:"token,omitempty"` + // ForceSendFields is a list of field names (e.g. "Token") 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. "Token") 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 GoogleCloudDialogflowCxV3beta1ToolAuthenticationBearerTokenConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3beta1ToolAuthenticationBearerTokenConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDialogflowCxV3beta1ToolAuthenticationOAuthConfig: Config for // authentication with OAuth. type GoogleCloudDialogflowCxV3beta1ToolAuthenticationOAuthConfig struct { @@ -12305,6 +12129,41 @@ func (s GoogleCloudDialogflowCxV3beta1ToolAuthenticationOAuthConfig) MarshalJSON // Config for auth using Diglogflow service agent // (https://cloud.google.com/iam/docs/service-agents#dialogflow-service-agent). type GoogleCloudDialogflowCxV3beta1ToolAuthenticationServiceAgentAuthConfig struct { + // ServiceAgentAuth: Optional. Indicate the auth token type generated from the + // Diglogflow service agent + // (https://cloud.google.com/iam/docs/service-agents#dialogflow-service-agent). + // The generated token is sent in the Authorization header. + // + // Possible values: + // "SERVICE_AGENT_AUTH_UNSPECIFIED" - Service agent auth type unspecified. + // Default to ID_TOKEN. + // "ID_TOKEN" - Use [ID + // token](https://cloud.google.com/docs/authentication/token-types#id) + // generated from service agent. This can be used to access Cloud Function and + // Cloud Run after you grant Invoker role to + // `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`. + // "ACCESS_TOKEN" - Use [access + // token](https://cloud.google.com/docs/authentication/token-types#access) + // generated from service agent. This can be used to access other Google Cloud + // APIs after you grant required roles to + // `service-@gcp-sa-dialogflow.iam.gserviceaccount.com`. + ServiceAgentAuth string `json:"serviceAgentAuth,omitempty"` + // ForceSendFields is a list of field names (e.g. "ServiceAgentAuth") 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. "ServiceAgentAuth") 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 GoogleCloudDialogflowCxV3beta1ToolAuthenticationServiceAgentAuthConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowCxV3beta1ToolAuthenticationServiceAgentAuthConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } // GoogleCloudDialogflowCxV3beta1ToolCall: Represents a call of a specific @@ -13045,29 +12904,6 @@ func (s GoogleCloudDialogflowCxV3beta1TypeSchemaSchemaReference) MarshalJSON() ( return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowCxV3beta1UpdateDocumentOperationMetadata: Metadata for -// UpdateDocument operation. -type GoogleCloudDialogflowCxV3beta1UpdateDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowCxV3beta1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowCxV3beta1UpdateDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowCxV3beta1UpdateDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowCxV3beta1UserUtterance: UserUtterance represents one // message sent by the customer. type GoogleCloudDialogflowCxV3beta1UserUtterance struct { @@ -19908,7 +19744,8 @@ func (s GoogleCloudDialogflowV2beta1ResponseMessageTelephonyTransferCall) Marsha // GoogleCloudDialogflowV2beta1ResponseMessageText: The text response message. type GoogleCloudDialogflowV2beta1ResponseMessageText struct { - // Text: A collection of text responses. + // Text: A collection of text response variants. If multiple variants are + // defined, only one text response variant is returned at runtime. Text []string `json:"text,omitempty"` // ForceSendFields is a list of field names (e.g. "Text") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -20500,150 +20337,6 @@ func (s GoogleCloudDialogflowV3alpha1ConversationSignals) MarshalJSON() ([]byte, return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowV3alpha1CreateDocumentOperationMetadata: Metadata for -// CreateDocument operation. -type GoogleCloudDialogflowV3alpha1CreateDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowV3alpha1CreateDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowV3alpha1CreateDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowV3alpha1DeleteDocumentOperationMetadata: Metadata for -// DeleteDocument operation. -type GoogleCloudDialogflowV3alpha1DeleteDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowV3alpha1DeleteDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowV3alpha1DeleteDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata: Metadata in -// google::longrunning::Operation for Knowledge operations. -type GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata struct { - // State: Required. Output only. The current state of this operation. - // - // Possible values: - // "STATE_UNSPECIFIED" - State unspecified. - // "PENDING" - The operation has been created. - // "RUNNING" - The operation is currently running. - // "DONE" - The operation is done, either cancelled or completed. - State string `json:"state,omitempty"` - // ForceSendFields is a list of field names (e.g. "State") 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. "State") 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 GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowV3alpha1ImportDocumentsOperationMetadata: Metadata for -// ImportDocuments operation. -type GoogleCloudDialogflowV3alpha1ImportDocumentsOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowV3alpha1ImportDocumentsOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowV3alpha1ImportDocumentsOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowV3alpha1ImportDocumentsResponse: Response message for -// Documents.ImportDocuments. -type GoogleCloudDialogflowV3alpha1ImportDocumentsResponse struct { - // Warnings: Includes details about skipped documents or any other warnings. - Warnings []*GoogleRpcStatus `json:"warnings,omitempty"` - // ForceSendFields is a list of field names (e.g. "Warnings") 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. "Warnings") 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 GoogleCloudDialogflowV3alpha1ImportDocumentsResponse) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowV3alpha1ImportDocumentsResponse - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDialogflowV3alpha1ReloadDocumentOperationMetadata: Metadata for -// ReloadDocument operation. -type GoogleCloudDialogflowV3alpha1ReloadDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowV3alpha1ReloadDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowV3alpha1ReloadDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowV3alpha1TurnSignals: Collection of all signals that // were extracted for a single turn of the conversation. type GoogleCloudDialogflowV3alpha1TurnSignals struct { @@ -20712,29 +20405,6 @@ func (s *GoogleCloudDialogflowV3alpha1TurnSignals) UnmarshalJSON(data []byte) er return nil } -// GoogleCloudDialogflowV3alpha1UpdateDocumentOperationMetadata: Metadata for -// UpdateDocument operation. -type GoogleCloudDialogflowV3alpha1UpdateDocumentOperationMetadata struct { - // GenericMetadata: The generic information of the operation. - GenericMetadata *GoogleCloudDialogflowV3alpha1GenericKnowledgeOperationMetadata `json:"genericMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "GenericMetadata") 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. "GenericMetadata") 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 GoogleCloudDialogflowV3alpha1UpdateDocumentOperationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowV3alpha1UpdateDocumentOperationMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudLocationListLocationsResponse: The response message for // Locations.ListLocations. type GoogleCloudLocationListLocationsResponse struct { diff --git a/discoveryengine/v1/discoveryengine-api.json b/discoveryengine/v1/discoveryengine-api.json index 1ea9c272493..61f4f1da2a4 100644 --- a/discoveryengine/v1/discoveryengine-api.json +++ b/discoveryengine/v1/discoveryengine-api.json @@ -454,10 +454,71 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "trainCustomModel": { + "description": "Trains a custom model.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}:trainCustomModel", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.collections.dataStores.trainCustomModel", + "parameterOrder": [ + "dataStore" + ], + "parameters": { + "dataStore": { + "description": "Required. The resource name of the Data Store, such as `projects/*/locations/global/collections/default_collection/dataStores/default_data_store`. This field is used to identify the data store where to train the models.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+dataStore}:trainCustomModel", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1TrainCustomModelRequest" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } }, "resources": { "branches": { + "methods": { + "batchGetDocumentsMetadata": { + "description": "Gets index freshness metadata for Documents. Supported for website search only.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/branches/{branchesId}/batchGetDocumentsMetadata", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.collections.dataStores.branches.batchGetDocumentsMetadata", + "parameterOrder": [ + "parent" + ], + "parameters": { + "matcher.urisMatcher.uris": { + "description": "The exact URIs to match by.", + "location": "query", + "repeated": true, + "type": "string" + }, + "parent": { + "description": "Required. The parent branch resource name, such as `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/branches/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/batchGetDocumentsMetadata", + "response": { + "$ref": "GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, "resources": { "documents": { "methods": { @@ -1189,6 +1250,35 @@ } } }, + "customModels": { + "methods": { + "list": { + "description": "Gets a list of all the custom models.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/customModels", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.collections.dataStores.customModels.list", + "parameterOrder": [ + "dataStore" + ], + "parameters": { + "dataStore": { + "description": "Required. The resource name of the parent Data Store, such as `projects/*/locations/global/collections/default_collection/dataStores/default_data_store`. This field is used to identify the data store where to fetch the models from.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+dataStore}/customModels", + "response": { + "$ref": "GoogleCloudDiscoveryengineV1ListCustomModelsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "models": { "resources": { "operations": { @@ -3690,6 +3780,39 @@ }, "resources": { "branches": { + "methods": { + "batchGetDocumentsMetadata": { + "description": "Gets index freshness metadata for Documents. Supported for website search only.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/branches/{branchesId}/batchGetDocumentsMetadata", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.dataStores.branches.batchGetDocumentsMetadata", + "parameterOrder": [ + "parent" + ], + "parameters": { + "matcher.urisMatcher.uris": { + "description": "The exact URIs to match by.", + "location": "query", + "repeated": true, + "type": "string" + }, + "parent": { + "description": "Required. The parent branch resource name, such as `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/branches/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/batchGetDocumentsMetadata", + "response": { + "$ref": "GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, "resources": { "documents": { "methods": { @@ -5851,7 +5974,7 @@ } } }, - "revision": "20240801", + "revision": "20240813", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -6021,7 +6144,7 @@ "type": "string" }, "projectId": { - "description": "The project ID that the AlloyDB source is in with a length limit of 128 characters. If not specified, inherits the project ID from the parent request.", + "description": "The project ID that contains the AlloyDB source. Has a length limit of 128 characters. If not specified, inherits the project ID from the parent request.", "type": "string" }, "tableId": { @@ -6045,7 +6168,8 @@ "OUT_OF_DOMAIN_QUERY_IGNORED", "POTENTIAL_POLICY_VIOLATION", "NO_RELEVANT_CONTENT", - "JAIL_BREAKING_QUERY_IGNORED" + "JAIL_BREAKING_QUERY_IGNORED", + "CUSTOMER_POLICY_VIOLATION" ], "enumDescriptions": [ "Default value. The answer skipped reason is not specified.", @@ -6054,7 +6178,8 @@ "The out-of-domain query ignored case. Google skips the answer if there are no high-relevance search results.", "The potential policy violation case. Google skips the answer if there is a potential policy violation detected. This includes content that may be violent or toxic.", "The no relevant content case. Google skips the answer if there is no relevant content in the retrieved search results.", - "The jail-breaking query ignored case. For example, \"Reply in the tone of a competing company's CEO\". Google skips the answer if the query is classified as a jail-breaking query." + "The jail-breaking query ignored case. For example, \"Reply in the tone of a competing company's CEO\". Google skips the answer if the query is classified as a jail-breaking query.", + "The customer policy violation case. Google skips the summary if there is a customer policy violation detected. The policy is defined by the customer." ], "type": "string" }, @@ -6946,6 +7071,63 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponse": { + "description": "Response message for DocumentService.BatchGetDocumentsMetadata method.", + "id": "GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponse", + "properties": { + "documentsMetadata": { + "description": "The metadata of the Documents.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponseDocumentMetadata" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponseDocumentMetadata": { + "description": "The metadata of a Document.", + "id": "GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponseDocumentMetadata", + "properties": { + "lastRefreshedTime": { + "description": "The timestamp of the last time the Document was last indexed.", + "format": "google-datetime", + "type": "string" + }, + "matcherValue": { + "$ref": "GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponseDocumentMetadataMatcherValue", + "description": "The value of the matcher that was used to match the Document." + }, + "status": { + "description": "The status of the document.", + "enum": [ + "STATUS_UNSPECIFIED", + "STATUS_INDEXED", + "STATUS_NOT_IN_TARGET_SITE", + "STATUS_NOT_IN_INDEX" + ], + "enumDescriptions": [ + "Should never be set.", + "The Document is indexed.", + "The Document is not indexed because its URI is not in the TargetSite.", + "The Document is not indexed." + ], + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponseDocumentMetadataMatcherValue": { + "description": "The value of the matcher that was used to match the Document.", + "id": "GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponseDocumentMetadataMatcherValue", + "properties": { + "uri": { + "description": "If match by URI, the URI of the Document.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1BatchVerifyTargetSitesRequest": { "description": "Request message for SiteSearchEngineService.BatchVerifyTargetSites method.", "id": "GoogleCloudDiscoveryengineV1BatchVerifyTargetSitesRequest", @@ -6973,7 +7155,7 @@ "description": "BigQuery time partitioned table's _PARTITIONDATE in YYYY-MM-DD format." }, "projectId": { - "description": "The project ID (can be project # or ID) that the BigQuery source is in with a length limit of 128 characters. If not specified, inherits the project ID from the parent request.", + "description": "The project ID or the project number that contains the BigQuery source. Has a length limit of 128 characters. If not specified, inherits the project ID from the parent request.", "type": "string" }, "tableId": { @@ -7124,7 +7306,7 @@ "type": "string" }, "projectId": { - "description": "The project ID that the Bigtable source is in with a length limit of 128 characters. If not specified, inherits the project ID from the parent request.", + "description": "The project ID that contains the Bigtable source. Has a length limit of 128 characters. If not specified, inherits the project ID from the parent request.", "type": "string" }, "tableId": { @@ -7214,6 +7396,11 @@ "description": "Indicates that this claim required grounding check. When the system decided this claim doesn't require attribution/grounding check, this field will be set to false. In that case, no grounding check was done for the claim and therefore citation_indices, and anti_citation_indices should not be returned.", "type": "boolean" }, + "score": { + "description": "Confidence score for the claim in the answer candidate, in the range of [0, 1].", + "format": "double", + "type": "number" + }, "startPos": { "description": "Position indicating the start of the claim in the answer candidate, measured in bytes.", "format": "int32", @@ -7363,7 +7550,7 @@ "type": "boolean" }, "projectId": { - "description": "The project ID that the Cloud SQL source is in with a length limit of 128 characters. If not specified, inherits the project ID from the parent request.", + "description": "The project ID that contains the Cloud SQL source. Has a length limit of 128 characters. If not specified, inherits the project ID from the parent request.", "type": "string" }, "tableId": { @@ -7524,7 +7711,7 @@ "id": "GoogleCloudDiscoveryengineV1Control", "properties": { "associatedServingConfigIds": { - "description": "Output only. List of all ServingConfig ids this control is attached to. May take up to 10 minutes to update after changes.", + "description": "Output only. List of all ServingConfig IDs this control is attached to. May take up to 10 minutes to update after changes.", "items": { "type": "string" }, @@ -7916,6 +8103,67 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1CustomTuningModel": { + "description": "Metadata that describes a custom tuned model.", + "id": "GoogleCloudDiscoveryengineV1CustomTuningModel", + "properties": { + "createTime": { + "deprecated": true, + "description": "Timestamp the Model was created at.", + "format": "google-datetime", + "type": "string" + }, + "displayName": { + "description": "The display name of the model.", + "type": "string" + }, + "metrics": { + "additionalProperties": { + "format": "double", + "type": "number" + }, + "description": "The metrics of the trained model.", + "type": "object" + }, + "modelState": { + "description": "The state that the model is in (e.g.`TRAINING` or `TRAINING_FAILED`).", + "enum": [ + "MODEL_STATE_UNSPECIFIED", + "TRAINING_PAUSED", + "TRAINING", + "TRAINING_COMPLETE", + "READY_FOR_SERVING", + "TRAINING_FAILED", + "NO_IMPROVEMENT" + ], + "enumDescriptions": [ + "Default value.", + "The model is in a paused training state.", + "The model is currently training.", + "The model has successfully completed training.", + "The model is ready for serving.", + "The model training failed.", + "The model training finished successfully but metrics did not improve." + ], + "type": "string" + }, + "modelVersion": { + "description": "The version of the model.", + "format": "int64", + "type": "string" + }, + "name": { + "description": "Required. The fully qualified resource name of the model. Format: `projects/{project_number}/locations/{location}/collections/{collection}/dataStores/{data_store}/customTuningModels/{custom_tuning_model}` model must be an alpha-numerical string with limit of 40 characters.", + "type": "string" + }, + "trainingStartTime": { + "description": "Timestamp the model training was initiated.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1DataStore": { "description": "DataStore captures global settings and configs at the DataStore level.", "id": "GoogleCloudDiscoveryengineV1DataStore", @@ -7926,13 +8174,15 @@ "CONTENT_CONFIG_UNSPECIFIED", "NO_CONTENT", "CONTENT_REQUIRED", - "PUBLIC_WEBSITE" + "PUBLIC_WEBSITE", + "GOOGLE_WORKSPACE" ], "enumDescriptions": [ "Default value.", "Only contains documents without any Document.content.", "Only contains documents with Document.content.", - "The data store is used for public website search." + "The data store is used for public website search.", + "The data store is used for workspace search. Details of workspace data store are specified in the WorkspaceConfig." ], "type": "string" }, @@ -7999,6 +8249,10 @@ "startingSchema": { "$ref": "GoogleCloudDiscoveryengineV1Schema", "description": "The start schema to use for this DataStore when provisioning it. If unset, a default vertical specialized schema will be used. This field is only used by CreateDataStore API, and will be ignored if used in other APIs. This field will be omitted from all API responses including CreateDataStore API. To retrieve a schema of a DataStore, use SchemaService.GetSchema API instead. The provided schema will be validated against certain rules on schema. Learn more from [this doc](https://cloud.google.com/generative-ai-app-builder/docs/provide-schema)." + }, + "workspaceConfig": { + "$ref": "GoogleCloudDiscoveryengineV1WorkspaceConfig", + "description": "Config to store data store type configuration for workspace data. This must be set when DataStore.content_config is set as DataStore.ContentConfig.GOOGLE_WORKSPACE." } }, "type": "object" @@ -9110,6 +9364,20 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1ListCustomModelsResponse": { + "description": "Response message for SearchTuningService.ListCustomModels method.", + "id": "GoogleCloudDiscoveryengineV1ListCustomModelsResponse", + "properties": { + "models": { + "description": "List of custom tuning models.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1CustomTuningModel" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1ListDataStoresResponse": { "description": "Response message for DataStoreService.ListDataStores method.", "id": "GoogleCloudDiscoveryengineV1ListDataStoresResponse", @@ -10495,7 +10763,8 @@ "POTENTIAL_POLICY_VIOLATION", "LLM_ADDON_NOT_ENABLED", "NO_RELEVANT_CONTENT", - "JAIL_BREAKING_QUERY_IGNORED" + "JAIL_BREAKING_QUERY_IGNORED", + "CUSTOMER_POLICY_VIOLATION" ], "enumDescriptions": [ "Default value. The summary skipped reason is not specified.", @@ -10505,7 +10774,8 @@ "The potential policy violation case. Google skips the summary if there is a potential policy violation detected. This includes content that may be violent or toxic.", "The LLM addon not enabled case. Google skips the summary if the LLM addon is not enabled.", "The no relevant content case. Google skips the summary if there is no relevant content in the retrieved search results.", - "The jail-breaking query ignored case. For example, \"Reply in the tone of a competing company's CEO\". Only used when [SearchRequest.ContentSearchSpec.SummarySpec.ignore_jail_breaking_query] is set to `true`." + "The jail-breaking query ignored case. For example, \"Reply in the tone of a competing company's CEO\". Only used when [SearchRequest.ContentSearchSpec.SummarySpec.ignore_jail_breaking_query] is set to `true`.", + "The customer policy violation case. Google skips the summary if there is a customer policy violation detected. The policy is defined by the customer." ], "type": "string" }, @@ -10774,7 +11044,7 @@ "type": "string" }, "projectId": { - "description": "The project ID that the Spanner source is in with a length limit of 128 characters. If not specified, inherits the project ID from the parent request.", + "description": "The project ID that contains the Spanner source. Has a length limit of 128 characters. If not specified, inherits the project ID from the parent request.", "type": "string" }, "tableId": { @@ -10926,6 +11196,103 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1TrainCustomModelMetadata": { + "description": "Metadata related to the progress of the TrainCustomModel operation. This is returned by the google.longrunning.Operation.metadata field.", + "id": "GoogleCloudDiscoveryengineV1TrainCustomModelMetadata", + "properties": { + "createTime": { + "description": "Operation create time.", + "format": "google-datetime", + "type": "string" + }, + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1TrainCustomModelRequest": { + "description": "Request message for SearchTuningService.TrainCustomModel method.", + "id": "GoogleCloudDiscoveryengineV1TrainCustomModelRequest", + "properties": { + "errorConfig": { + "$ref": "GoogleCloudDiscoveryengineV1ImportErrorConfig", + "description": "The desired location of errors incurred during the data ingestion and training." + }, + "gcsTrainingInput": { + "$ref": "GoogleCloudDiscoveryengineV1TrainCustomModelRequestGcsTrainingInput", + "description": "Cloud Storage training input." + }, + "modelId": { + "description": "If not provided, a UUID will be generated.", + "type": "string" + }, + "modelType": { + "description": "Model to be trained. Supported values are: * **search-tuning**: Fine tuning the search system based on data provided.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1TrainCustomModelRequestGcsTrainingInput": { + "description": "Cloud Storage training data input.", + "id": "GoogleCloudDiscoveryengineV1TrainCustomModelRequestGcsTrainingInput", + "properties": { + "corpusDataPath": { + "description": "The Cloud Storage corpus data which could be associated in train data. The data path format is `gs:///`. A newline delimited jsonl/ndjson file. For search-tuning model, each line should have the _id, title and text. Example: `{\"_id\": \"doc1\", title: \"relevant doc\", \"text\": \"relevant text\"}`", + "type": "string" + }, + "queryDataPath": { + "description": "The gcs query data which could be associated in train data. The data path format is `gs:///`. A newline delimited jsonl/ndjson file. For search-tuning model, each line should have the _id and text. Example: {\"_id\": \"query1\", \"text\": \"example query\"}", + "type": "string" + }, + "testDataPath": { + "description": "Cloud Storage test data. Same format as train_data_path. If not provided, a random 80/20 train/test split will be performed on train_data_path.", + "type": "string" + }, + "trainDataPath": { + "description": "Cloud Storage training data path whose format should be `gs:///`. The file should be in tsv format. Each line should have the doc_id and query_id and score (number). For search-tuning model, it should have the query-id corpus-id score as tsv file header. The score should be a number in `[0, inf+)`. The larger the number is, the more relevant the pair is. Example: * `query-id\\tcorpus-id\\tscore` * `query1\\tdoc1\\t1`", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1TrainCustomModelResponse": { + "description": "Response of the TrainCustomModelRequest. This message is returned by the google.longrunning.Operations.response field.", + "id": "GoogleCloudDiscoveryengineV1TrainCustomModelResponse", + "properties": { + "errorConfig": { + "$ref": "GoogleCloudDiscoveryengineV1ImportErrorConfig", + "description": "Echoes the destination for the complete errors in the request if set." + }, + "errorSamples": { + "description": "A sample of errors encountered while processing the data.", + "items": { + "$ref": "GoogleRpcStatus" + }, + "type": "array" + }, + "metrics": { + "additionalProperties": { + "format": "double", + "type": "number" + }, + "description": "The metrics of the trained model.", + "type": "object" + }, + "modelName": { + "description": "Fully qualified name of the CustomTuningModel.", + "type": "string" + }, + "modelStatus": { + "description": "The trained model status. Possible values are: * **bad-data**: The training data quality is bad. * **no-improvement**: Tuning didn't improve performance. Won't deploy. * **in-progress**: Model training job creation is in progress. * **training**: Model is actively training. * **evaluating**: The model is evaluating trained metrics. * **indexing**: The model trained metrics are indexing. * **ready**: The model is ready for serving.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1TransactionInfo": { "description": "A transaction represents the entire purchase transaction.", "id": "GoogleCloudDiscoveryengineV1TransactionInfo", @@ -11110,6 +11477,37 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1WorkspaceConfig": { + "description": "Config to store data store type configuration for workspace data", + "id": "GoogleCloudDiscoveryengineV1WorkspaceConfig", + "properties": { + "dasherCustomerId": { + "description": "Obfuscated Dasher customer ID.", + "type": "string" + }, + "type": { + "description": "The Google Workspace data source.", + "enum": [ + "TYPE_UNSPECIFIED", + "GOOGLE_DRIVE", + "GOOGLE_MAIL", + "GOOGLE_SITES", + "GOOGLE_CALENDAR", + "GOOGLE_GROUPS" + ], + "enumDescriptions": [ + "Default value.", + "The data store is used to store content from Google Drive.", + "The data store is used to store content from Gmail.", + "The data store is used to store content from Google Sites.", + "The data store is used to store content from Google Calendar.", + "The data store is used to store content from Google Groups." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaAclConfig": { "description": "Access Control Configuration.", "id": "GoogleCloudDiscoveryengineV1alphaAclConfig", @@ -11139,7 +11537,8 @@ "OUT_OF_DOMAIN_QUERY_IGNORED", "POTENTIAL_POLICY_VIOLATION", "NO_RELEVANT_CONTENT", - "JAIL_BREAKING_QUERY_IGNORED" + "JAIL_BREAKING_QUERY_IGNORED", + "CUSTOMER_POLICY_VIOLATION" ], "enumDescriptions": [ "Default value. The answer skipped reason is not specified.", @@ -11148,7 +11547,8 @@ "The out-of-domain query ignored case. Google skips the answer if there are no high-relevance search results.", "The potential policy violation case. Google skips the answer if there is a potential policy violation detected. This includes content that may be violent or toxic.", "The no relevant content case. Google skips the answer if there is no relevant content in the retrieved search results.", - "The jail-breaking query ignored case. For example, \"Reply in the tone of a competing company's CEO\". Google skips the answer if the query is classified as a jail-breaking query." + "The jail-breaking query ignored case. For example, \"Reply in the tone of a competing company's CEO\". Google skips the answer if the query is classified as a jail-breaking query.", + "The customer policy violation case. Google skips the summary if there is a customer policy violation detected. The policy is defined by the customer." ], "type": "string" }, @@ -11690,7 +12090,7 @@ "id": "GoogleCloudDiscoveryengineV1alphaControl", "properties": { "associatedServingConfigIds": { - "description": "Output only. List of all ServingConfig ids this control is attached to. May take up to 10 minutes to update after changes.", + "description": "Output only. List of all ServingConfig IDs this control is attached to. May take up to 10 minutes to update after changes.", "items": { "type": "string" }, @@ -11986,13 +12386,15 @@ "CONTENT_CONFIG_UNSPECIFIED", "NO_CONTENT", "CONTENT_REQUIRED", - "PUBLIC_WEBSITE" + "PUBLIC_WEBSITE", + "GOOGLE_WORKSPACE" ], "enumDescriptions": [ "Default value.", "Only contains documents without any Document.content.", "Only contains documents with Document.content.", - "The data store is used for public website search." + "The data store is used for public website search.", + "The data store is used for workspace search. Details of workspace data store are specified in the WorkspaceConfig." ], "type": "string" }, @@ -12068,6 +12470,10 @@ "startingSchema": { "$ref": "GoogleCloudDiscoveryengineV1alphaSchema", "description": "The start schema to use for this DataStore when provisioning it. If unset, a default vertical specialized schema will be used. This field is only used by CreateDataStore API, and will be ignored if used in other APIs. This field will be omitted from all API responses including CreateDataStore API. To retrieve a schema of a DataStore, use SchemaService.GetSchema API instead. The provided schema will be validated against certain rules on schema. Learn more from [this doc](https://cloud.google.com/generative-ai-app-builder/docs/provide-schema)." + }, + "workspaceConfig": { + "$ref": "GoogleCloudDiscoveryengineV1alphaWorkspaceConfig", + "description": "Config to store data store type configuration for workspace data. This must be set when DataStore.content_config is set as DataStore.ContentConfig.GOOGLE_WORKSPACE." } }, "type": "object" @@ -14678,6 +15084,37 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaWorkspaceConfig": { + "description": "Config to store data store type configuration for workspace data", + "id": "GoogleCloudDiscoveryengineV1alphaWorkspaceConfig", + "properties": { + "dasherCustomerId": { + "description": "Obfuscated Dasher customer ID.", + "type": "string" + }, + "type": { + "description": "The Google Workspace data source.", + "enum": [ + "TYPE_UNSPECIFIED", + "GOOGLE_DRIVE", + "GOOGLE_MAIL", + "GOOGLE_SITES", + "GOOGLE_CALENDAR", + "GOOGLE_GROUPS" + ], + "enumDescriptions": [ + "Default value.", + "The data store is used to store content from Google Drive.", + "The data store is used to store content from Gmail.", + "The data store is used to store content from Google Sites.", + "The data store is used to store content from Google Calendar.", + "The data store is used to store content from Google Groups." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaBatchCreateTargetSiteMetadata": { "description": "Metadata related to the progress of the SiteSearchEngineService.BatchCreateTargetSites operation. This will be returned by the google.longrunning.Operation.metadata field.", "id": "GoogleCloudDiscoveryengineV1betaBatchCreateTargetSiteMetadata", @@ -14767,7 +15204,7 @@ "id": "GoogleCloudDiscoveryengineV1betaControl", "properties": { "associatedServingConfigIds": { - "description": "Output only. List of all ServingConfig ids this control is attached to. May take up to 10 minutes to update after changes.", + "description": "Output only. List of all ServingConfig IDs this control is attached to. May take up to 10 minutes to update after changes.", "items": { "type": "string" }, @@ -15048,13 +15485,15 @@ "CONTENT_CONFIG_UNSPECIFIED", "NO_CONTENT", "CONTENT_REQUIRED", - "PUBLIC_WEBSITE" + "PUBLIC_WEBSITE", + "GOOGLE_WORKSPACE" ], "enumDescriptions": [ "Default value.", "Only contains documents without any Document.content.", "Only contains documents with Document.content.", - "The data store is used for public website search." + "The data store is used for public website search.", + "The data store is used for workspace search. Details of workspace data store are specified in the WorkspaceConfig." ], "type": "string" }, @@ -15125,6 +15564,10 @@ "startingSchema": { "$ref": "GoogleCloudDiscoveryengineV1betaSchema", "description": "The start schema to use for this DataStore when provisioning it. If unset, a default vertical specialized schema will be used. This field is only used by CreateDataStore API, and will be ignored if used in other APIs. This field will be omitted from all API responses including CreateDataStore API. To retrieve a schema of a DataStore, use SchemaService.GetSchema API instead. The provided schema will be validated against certain rules on schema. Learn more from [this doc](https://cloud.google.com/generative-ai-app-builder/docs/provide-schema)." + }, + "workspaceConfig": { + "$ref": "GoogleCloudDiscoveryengineV1betaWorkspaceConfig", + "description": "Config to store data store type configuration for workspace data. This must be set when DataStore.content_config is set as DataStore.ContentConfig.GOOGLE_WORKSPACE." } }, "type": "object" @@ -16274,6 +16717,24 @@ "description": "The Unicode country/region code (CLDR) of a location, such as \"US\" and \"419\". For more information, see [Standard fields](https://cloud.google.com/apis/design/standard_fields). If set, then results will be boosted based on the region_code provided.", "type": "string" }, + "relevanceThreshold": { + "description": "The relevance threshold of the search results. Default to Google defined threshold, leveraging a balance of precision and recall to deliver both highly accurate results and comprehensive coverage of relevant information.", + "enum": [ + "RELEVANCE_THRESHOLD_UNSPECIFIED", + "LOWEST", + "LOW", + "MEDIUM", + "HIGH" + ], + "enumDescriptions": [ + "Default value. In this case, server behavior defaults to Google defined threshold.", + "Lowest relevance threshold.", + "Low relevance threshold.", + "Medium relevance threshold.", + "High relevance threshold." + ], + "type": "string" + }, "safeSearch": { "description": "Whether to turn on safe search. This is only supported for website search.", "type": "boolean" @@ -17070,6 +17531,37 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaWorkspaceConfig": { + "description": "Config to store data store type configuration for workspace data", + "id": "GoogleCloudDiscoveryengineV1betaWorkspaceConfig", + "properties": { + "dasherCustomerId": { + "description": "Obfuscated Dasher customer ID.", + "type": "string" + }, + "type": { + "description": "The Google Workspace data source.", + "enum": [ + "TYPE_UNSPECIFIED", + "GOOGLE_DRIVE", + "GOOGLE_MAIL", + "GOOGLE_SITES", + "GOOGLE_CALENDAR", + "GOOGLE_GROUPS" + ], + "enumDescriptions": [ + "Default value.", + "The data store is used to store content from Google Drive.", + "The data store is used to store content from Gmail.", + "The data store is used to store content from Google Sites.", + "The data store is used to store content from Google Calendar.", + "The data store is used to store content from Google Groups." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleLongrunningCancelOperationRequest": { "description": "The request message for Operations.CancelOperation.", "id": "GoogleLongrunningCancelOperationRequest", diff --git a/discoveryengine/v1/discoveryengine-gen.go b/discoveryengine/v1/discoveryengine-gen.go index 115e9f2e142..afa03477408 100644 --- a/discoveryengine/v1/discoveryengine-gen.go +++ b/discoveryengine/v1/discoveryengine-gen.go @@ -247,6 +247,7 @@ func NewProjectsLocationsCollectionsDataStoresService(s *Service) *ProjectsLocat rs.CompletionSuggestions = NewProjectsLocationsCollectionsDataStoresCompletionSuggestionsService(s) rs.Controls = NewProjectsLocationsCollectionsDataStoresControlsService(s) rs.Conversations = NewProjectsLocationsCollectionsDataStoresConversationsService(s) + rs.CustomModels = NewProjectsLocationsCollectionsDataStoresCustomModelsService(s) rs.Models = NewProjectsLocationsCollectionsDataStoresModelsService(s) rs.Operations = NewProjectsLocationsCollectionsDataStoresOperationsService(s) rs.Schemas = NewProjectsLocationsCollectionsDataStoresSchemasService(s) @@ -269,6 +270,8 @@ type ProjectsLocationsCollectionsDataStoresService struct { Conversations *ProjectsLocationsCollectionsDataStoresConversationsService + CustomModels *ProjectsLocationsCollectionsDataStoresCustomModelsService + Models *ProjectsLocationsCollectionsDataStoresModelsService Operations *ProjectsLocationsCollectionsDataStoresOperationsService @@ -346,6 +349,15 @@ type ProjectsLocationsCollectionsDataStoresConversationsService struct { s *Service } +func NewProjectsLocationsCollectionsDataStoresCustomModelsService(s *Service) *ProjectsLocationsCollectionsDataStoresCustomModelsService { + rs := &ProjectsLocationsCollectionsDataStoresCustomModelsService{s: s} + return rs +} + +type ProjectsLocationsCollectionsDataStoresCustomModelsService struct { + s *Service +} + func NewProjectsLocationsCollectionsDataStoresModelsService(s *Service) *ProjectsLocationsCollectionsDataStoresModelsService { rs := &ProjectsLocationsCollectionsDataStoresModelsService{s: s} rs.Operations = NewProjectsLocationsCollectionsDataStoresModelsOperationsService(s) @@ -1104,9 +1116,9 @@ type GoogleCloudDiscoveryengineV1AlloyDbSource struct { // LocationId: Required. The AlloyDB location to copy the data from with a // length limit of 256 characters. LocationId string `json:"locationId,omitempty"` - // ProjectId: The project ID that the AlloyDB source is in with a length limit - // of 128 characters. If not specified, inherits the project ID from the parent - // request. + // ProjectId: The project ID that contains the AlloyDB source. Has a length + // limit of 128 characters. If not specified, inherits the project ID from the + // parent request. ProjectId string `json:"projectId,omitempty"` // TableId: Required. The AlloyDB table to copy the data from with a length // limit of 256 characters. @@ -1150,6 +1162,9 @@ type GoogleCloudDiscoveryengineV1Answer struct { // "JAIL_BREAKING_QUERY_IGNORED" - The jail-breaking query ignored case. For // example, "Reply in the tone of a competing company's CEO". Google skips the // answer if the query is classified as a jail-breaking query. + // "CUSTOMER_POLICY_VIOLATION" - The customer policy violation case. Google + // skips the summary if there is a customer policy violation detected. The + // policy is defined by the customer. AnswerSkippedReasons []string `json:"answerSkippedReasons,omitempty"` // AnswerText: The textual answer. AnswerText string `json:"answerText,omitempty"` @@ -2387,6 +2402,90 @@ func (s GoogleCloudDiscoveryengineV1BatchCreateTargetSitesResponse) MarshalJSON( return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponse: Response +// message for DocumentService.BatchGetDocumentsMetadata method. +type GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponse struct { + // DocumentsMetadata: The metadata of the Documents. + DocumentsMetadata []*GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponseDocumentMetadata `json:"documentsMetadata,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "DocumentsMetadata") 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. "DocumentsMetadata") 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 GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponseDocumentMetadata +// : The metadata of a Document. +type GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponseDocumentMetadata struct { + // LastRefreshedTime: The timestamp of the last time the Document was last + // indexed. + LastRefreshedTime string `json:"lastRefreshedTime,omitempty"` + // MatcherValue: The value of the matcher that was used to match the Document. + MatcherValue *GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponseDocumentMetadataMatcherValue `json:"matcherValue,omitempty"` + // Status: The status of the document. + // + // Possible values: + // "STATUS_UNSPECIFIED" - Should never be set. + // "STATUS_INDEXED" - The Document is indexed. + // "STATUS_NOT_IN_TARGET_SITE" - The Document is not indexed because its URI + // is not in the TargetSite. + // "STATUS_NOT_IN_INDEX" - The Document is not indexed. + Status string `json:"status,omitempty"` + // ForceSendFields is a list of field names (e.g. "LastRefreshedTime") 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. "LastRefreshedTime") 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 GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponseDocumentMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponseDocumentMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponseDocumentMetadata +// MatcherValue: The value of the matcher that was used to match the Document. +type GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponseDocumentMetadataMatcherValue struct { + // Uri: If match by URI, the URI of the Document. + Uri string `json:"uri,omitempty"` + // ForceSendFields is a list of field names (e.g. "Uri") 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. "Uri") 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 GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponseDocumentMetadataMatcherValue) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponseDocumentMetadataMatcherValue + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1BatchVerifyTargetSitesRequest: Request message // for SiteSearchEngineService.BatchVerifyTargetSites method. type GoogleCloudDiscoveryengineV1BatchVerifyTargetSitesRequest struct { @@ -2414,8 +2513,8 @@ type GoogleCloudDiscoveryengineV1BigQuerySource struct { // PartitionDate: BigQuery time partitioned table's _PARTITIONDATE in // YYYY-MM-DD format. PartitionDate *GoogleTypeDate `json:"partitionDate,omitempty"` - // ProjectId: The project ID (can be project # or ID) that the BigQuery source - // is in with a length limit of 128 characters. If not specified, inherits the + // ProjectId: The project ID or the project number that contains the BigQuery + // source. Has a length limit of 128 characters. If not specified, inherits the // project ID from the parent request. ProjectId string `json:"projectId,omitempty"` // TableId: Required. The BigQuery table to copy the data from with a length @@ -2587,9 +2686,9 @@ type GoogleCloudDiscoveryengineV1BigtableSource struct { // InstanceId: Required. The instance ID of the Cloud Bigtable that needs to be // imported. InstanceId string `json:"instanceId,omitempty"` - // ProjectId: The project ID that the Bigtable source is in with a length limit - // of 128 characters. If not specified, inherits the project ID from the parent - // request. + // ProjectId: The project ID that contains the Bigtable source. Has a length + // limit of 128 characters. If not specified, inherits the project ID from the + // parent request. ProjectId string `json:"projectId,omitempty"` // TableId: Required. The table ID of the Cloud Bigtable that needs to be // imported. @@ -2722,6 +2821,9 @@ type GoogleCloudDiscoveryengineV1CheckGroundingResponseClaim struct { // done for the claim and therefore citation_indices, and anti_citation_indices // should not be returned. GroundingCheckRequired bool `json:"groundingCheckRequired,omitempty"` + // Score: Confidence score for the claim in the answer candidate, in the range + // of [0, 1]. + Score float64 `json:"score,omitempty"` // StartPos: Position indicating the start of the claim in the answer // candidate, measured in bytes. StartPos int64 `json:"startPos,omitempty"` @@ -2743,6 +2845,20 @@ func (s GoogleCloudDiscoveryengineV1CheckGroundingResponseClaim) MarshalJSON() ( return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +func (s *GoogleCloudDiscoveryengineV1CheckGroundingResponseClaim) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudDiscoveryengineV1CheckGroundingResponseClaim + var s1 struct { + Score gensupport.JSONFloat64 `json:"score"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Score = float64(s1.Score) + return nil +} + // GoogleCloudDiscoveryengineV1CheckGroundingSpec: Specification for the // grounding check. type GoogleCloudDiscoveryengineV1CheckGroundingSpec struct { @@ -2943,7 +3059,7 @@ type GoogleCloudDiscoveryengineV1CloudSqlSource struct { // additional cost. More info can be found here // (https://cloud.google.com/sql/pricing#serverless). Offload bool `json:"offload,omitempty"` - // ProjectId: The project ID that the Cloud SQL source is in with a length + // ProjectId: The project ID that contains the Cloud SQL source. Has a length // limit of 128 characters. If not specified, inherits the project ID from the // parent request. ProjectId string `json:"projectId,omitempty"` @@ -3192,7 +3308,7 @@ func (s GoogleCloudDiscoveryengineV1ConditionTimeRange) MarshalJSON() ([]byte, e // employ during serving. Must be attached to a ServingConfig to be considered // at serving time. Permitted actions dependent on `SolutionType`. type GoogleCloudDiscoveryengineV1Control struct { - // AssociatedServingConfigIds: Output only. List of all ServingConfig ids this + // AssociatedServingConfigIds: Output only. List of all ServingConfig IDs this // control is attached to. May take up to 10 minutes to update after changes. AssociatedServingConfigIds []string `json:"associatedServingConfigIds,omitempty"` // BoostAction: Defines a boost-type control @@ -3771,6 +3887,55 @@ func (s *GoogleCloudDiscoveryengineV1CustomAttribute) UnmarshalJSON(data []byte) return nil } +// GoogleCloudDiscoveryengineV1CustomTuningModel: Metadata that describes a +// custom tuned model. +type GoogleCloudDiscoveryengineV1CustomTuningModel struct { + // CreateTime: Timestamp the Model was created at. + CreateTime string `json:"createTime,omitempty"` + // DisplayName: The display name of the model. + DisplayName string `json:"displayName,omitempty"` + // Metrics: The metrics of the trained model. + Metrics map[string]float64 `json:"metrics,omitempty"` + // ModelState: The state that the model is in (e.g.`TRAINING` or + // `TRAINING_FAILED`). + // + // Possible values: + // "MODEL_STATE_UNSPECIFIED" - Default value. + // "TRAINING_PAUSED" - The model is in a paused training state. + // "TRAINING" - The model is currently training. + // "TRAINING_COMPLETE" - The model has successfully completed training. + // "READY_FOR_SERVING" - The model is ready for serving. + // "TRAINING_FAILED" - The model training failed. + // "NO_IMPROVEMENT" - The model training finished successfully but metrics + // did not improve. + ModelState string `json:"modelState,omitempty"` + // ModelVersion: The version of the model. + ModelVersion int64 `json:"modelVersion,omitempty,string"` + // Name: Required. The fully qualified resource name of the model. Format: + // `projects/{project_number}/locations/{location}/collections/{collection}/data + // Stores/{data_store}/customTuningModels/{custom_tuning_model}` model must be + // an alpha-numerical string with limit of 40 characters. + Name string `json:"name,omitempty"` + // TrainingStartTime: Timestamp the model training was initiated. + TrainingStartTime string `json:"trainingStartTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "CreateTime") 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. "CreateTime") 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 GoogleCloudDiscoveryengineV1CustomTuningModel) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1CustomTuningModel + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1DataStore: DataStore captures global settings // and configs at the DataStore level. type GoogleCloudDiscoveryengineV1DataStore struct { @@ -3782,6 +3947,8 @@ type GoogleCloudDiscoveryengineV1DataStore struct { // "NO_CONTENT" - Only contains documents without any Document.content. // "CONTENT_REQUIRED" - Only contains documents with Document.content. // "PUBLIC_WEBSITE" - The data store is used for public website search. + // "GOOGLE_WORKSPACE" - The data store is used for workspace search. Details + // of workspace data store are specified in the WorkspaceConfig. ContentConfig string `json:"contentConfig,omitempty"` // CreateTime: Output only. Timestamp the DataStore was created at. CreateTime string `json:"createTime,omitempty"` @@ -3835,6 +4002,10 @@ type GoogleCloudDiscoveryengineV1DataStore struct { // against certain rules on schema. Learn more from this doc // (https://cloud.google.com/generative-ai-app-builder/docs/provide-schema). StartingSchema *GoogleCloudDiscoveryengineV1Schema `json:"startingSchema,omitempty"` + // WorkspaceConfig: Config to store data store type configuration for workspace + // data. This must be set when DataStore.content_config is set as + // DataStore.ContentConfig.GOOGLE_WORKSPACE. + WorkspaceConfig *GoogleCloudDiscoveryengineV1WorkspaceConfig `json:"workspaceConfig,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` @@ -5422,6 +5593,32 @@ func (s GoogleCloudDiscoveryengineV1ListConversationsResponse) MarshalJSON() ([] return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1ListCustomModelsResponse: Response message for +// SearchTuningService.ListCustomModels method. +type GoogleCloudDiscoveryengineV1ListCustomModelsResponse struct { + // Models: List of custom tuning models. + Models []*GoogleCloudDiscoveryengineV1CustomTuningModel `json:"models,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Models") 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. "Models") 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 GoogleCloudDiscoveryengineV1ListCustomModelsResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1ListCustomModelsResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1ListDataStoresResponse: Response message for // DataStoreService.ListDataStores method. type GoogleCloudDiscoveryengineV1ListDataStoresResponse struct { @@ -7645,6 +7842,9 @@ type GoogleCloudDiscoveryengineV1SearchResponseSummary struct { // example, "Reply in the tone of a competing company's CEO". Only used when // [SearchRequest.ContentSearchSpec.SummarySpec.ignore_jail_breaking_query] is // set to `true`. + // "CUSTOMER_POLICY_VIOLATION" - The customer policy violation case. Google + // skips the summary if there is a customer policy violation detected. The + // policy is defined by the customer. SummarySkippedReasons []string `json:"summarySkippedReasons,omitempty"` // SummaryText: The summary content. SummaryText string `json:"summaryText,omitempty"` @@ -8010,9 +8210,9 @@ type GoogleCloudDiscoveryengineV1SpannerSource struct { EnableDataBoost bool `json:"enableDataBoost,omitempty"` // InstanceId: Required. The instance ID of the source Spanner table. InstanceId string `json:"instanceId,omitempty"` - // ProjectId: The project ID that the Spanner source is in with a length limit - // of 128 characters. If not specified, inherits the project ID from the parent - // request. + // ProjectId: The project ID that contains the Spanner source. Has a length + // limit of 128 characters. If not specified, inherits the project ID from the + // parent request. ProjectId string `json:"projectId,omitempty"` // TableId: Required. The table name of the Spanner database that needs to be // imported. @@ -8214,6 +8414,146 @@ func (s GoogleCloudDiscoveryengineV1TextInput) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1TrainCustomModelMetadata: Metadata related to +// the progress of the TrainCustomModel operation. This is returned by the +// google.longrunning.Operation.metadata field. +type GoogleCloudDiscoveryengineV1TrainCustomModelMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + // UpdateTime: Operation last update time. If the operation is done, this is + // also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "CreateTime") 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. "CreateTime") 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 GoogleCloudDiscoveryengineV1TrainCustomModelMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1TrainCustomModelMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1TrainCustomModelRequest: Request message for +// SearchTuningService.TrainCustomModel method. +type GoogleCloudDiscoveryengineV1TrainCustomModelRequest struct { + // ErrorConfig: The desired location of errors incurred during the data + // ingestion and training. + ErrorConfig *GoogleCloudDiscoveryengineV1ImportErrorConfig `json:"errorConfig,omitempty"` + // GcsTrainingInput: Cloud Storage training input. + GcsTrainingInput *GoogleCloudDiscoveryengineV1TrainCustomModelRequestGcsTrainingInput `json:"gcsTrainingInput,omitempty"` + // ModelId: If not provided, a UUID will be generated. + ModelId string `json:"modelId,omitempty"` + // ModelType: Model to be trained. Supported values are: * **search-tuning**: + // Fine tuning the search system based on data provided. + ModelType string `json:"modelType,omitempty"` + // ForceSendFields is a list of field names (e.g. "ErrorConfig") 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. "ErrorConfig") 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 GoogleCloudDiscoveryengineV1TrainCustomModelRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1TrainCustomModelRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1TrainCustomModelRequestGcsTrainingInput: Cloud +// Storage training data input. +type GoogleCloudDiscoveryengineV1TrainCustomModelRequestGcsTrainingInput struct { + // CorpusDataPath: The Cloud Storage corpus data which could be associated in + // train data. The data path format is `gs:///`. A newline delimited + // jsonl/ndjson file. For search-tuning model, each line should have the _id, + // title and text. Example: `{"_id": "doc1", title: "relevant doc", "text": + // "relevant text"}` + CorpusDataPath string `json:"corpusDataPath,omitempty"` + // QueryDataPath: The gcs query data which could be associated in train data. + // The data path format is `gs:///`. A newline delimited jsonl/ndjson file. For + // search-tuning model, each line should have the _id and text. Example: + // {"_id": "query1", "text": "example query"} + QueryDataPath string `json:"queryDataPath,omitempty"` + // TestDataPath: Cloud Storage test data. Same format as train_data_path. If + // not provided, a random 80/20 train/test split will be performed on + // train_data_path. + TestDataPath string `json:"testDataPath,omitempty"` + // TrainDataPath: Cloud Storage training data path whose format should be + // `gs:///`. The file should be in tsv format. Each line should have the doc_id + // and query_id and score (number). For search-tuning model, it should have the + // query-id corpus-id score as tsv file header. The score should be a number in + // `[0, inf+)`. The larger the number is, the more relevant the pair is. + // Example: * `query-id\tcorpus-id\tscore` * `query1\tdoc1\t1` + TrainDataPath string `json:"trainDataPath,omitempty"` + // ForceSendFields is a list of field names (e.g. "CorpusDataPath") 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. "CorpusDataPath") 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 GoogleCloudDiscoveryengineV1TrainCustomModelRequestGcsTrainingInput) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1TrainCustomModelRequestGcsTrainingInput + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1TrainCustomModelResponse: Response of the +// TrainCustomModelRequest. This message is returned by the +// google.longrunning.Operations.response field. +type GoogleCloudDiscoveryengineV1TrainCustomModelResponse struct { + // ErrorConfig: Echoes the destination for the complete errors in the request + // if set. + ErrorConfig *GoogleCloudDiscoveryengineV1ImportErrorConfig `json:"errorConfig,omitempty"` + // ErrorSamples: A sample of errors encountered while processing the data. + ErrorSamples []*GoogleRpcStatus `json:"errorSamples,omitempty"` + // Metrics: The metrics of the trained model. + Metrics map[string]float64 `json:"metrics,omitempty"` + // ModelName: Fully qualified name of the CustomTuningModel. + ModelName string `json:"modelName,omitempty"` + // ModelStatus: The trained model status. Possible values are: * **bad-data**: + // The training data quality is bad. * **no-improvement**: Tuning didn't + // improve performance. Won't deploy. * **in-progress**: Model training job + // creation is in progress. * **training**: Model is actively training. * + // **evaluating**: The model is evaluating trained metrics. * **indexing**: The + // model trained metrics are indexing. * **ready**: The model is ready for + // serving. + ModelStatus string `json:"modelStatus,omitempty"` + // ForceSendFields is a list of field names (e.g. "ErrorConfig") 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. "ErrorConfig") 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 GoogleCloudDiscoveryengineV1TrainCustomModelResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1TrainCustomModelResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1TransactionInfo: A transaction represents the // entire purchase transaction. type GoogleCloudDiscoveryengineV1TransactionInfo struct { @@ -8522,6 +8862,43 @@ func (s GoogleCloudDiscoveryengineV1UserInfo) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1WorkspaceConfig: Config to store data store type +// configuration for workspace data +type GoogleCloudDiscoveryengineV1WorkspaceConfig struct { + // DasherCustomerId: Obfuscated Dasher customer ID. + DasherCustomerId string `json:"dasherCustomerId,omitempty"` + // Type: The Google Workspace data source. + // + // Possible values: + // "TYPE_UNSPECIFIED" - Default value. + // "GOOGLE_DRIVE" - The data store is used to store content from Google + // Drive. + // "GOOGLE_MAIL" - The data store is used to store content from Gmail. + // "GOOGLE_SITES" - The data store is used to store content from Google + // Sites. + // "GOOGLE_CALENDAR" - The data store is used to store content from Google + // Calendar. + // "GOOGLE_GROUPS" - The data store is used to store content from Google + // Groups. + Type string `json:"type,omitempty"` + // ForceSendFields is a list of field names (e.g. "DasherCustomerId") 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. "DasherCustomerId") 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 GoogleCloudDiscoveryengineV1WorkspaceConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1WorkspaceConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaAclConfig: Access Control Configuration. type GoogleCloudDiscoveryengineV1alphaAclConfig struct { // IdpConfig: Identity provider config. @@ -8569,6 +8946,9 @@ type GoogleCloudDiscoveryengineV1alphaAnswer struct { // "JAIL_BREAKING_QUERY_IGNORED" - The jail-breaking query ignored case. For // example, "Reply in the tone of a competing company's CEO". Google skips the // answer if the query is classified as a jail-breaking query. + // "CUSTOMER_POLICY_VIOLATION" - The customer policy violation case. Google + // skips the summary if there is a customer policy violation detected. The + // policy is defined by the customer. AnswerSkippedReasons []string `json:"answerSkippedReasons,omitempty"` // AnswerText: The textual answer. AnswerText string `json:"answerText,omitempty"` @@ -9267,7 +9647,7 @@ func (s GoogleCloudDiscoveryengineV1alphaConditionTimeRange) MarshalJSON() ([]by // employ during serving. Must be attached to a ServingConfig to be considered // at serving time. Permitted actions dependent on `SolutionType`. type GoogleCloudDiscoveryengineV1alphaControl struct { - // AssociatedServingConfigIds: Output only. List of all ServingConfig ids this + // AssociatedServingConfigIds: Output only. List of all ServingConfig IDs this // control is attached to. May take up to 10 minutes to update after changes. AssociatedServingConfigIds []string `json:"associatedServingConfigIds,omitempty"` // BoostAction: Defines a boost-type control @@ -9668,6 +10048,8 @@ type GoogleCloudDiscoveryengineV1alphaDataStore struct { // "NO_CONTENT" - Only contains documents without any Document.content. // "CONTENT_REQUIRED" - Only contains documents with Document.content. // "PUBLIC_WEBSITE" - The data store is used for public website search. + // "GOOGLE_WORKSPACE" - The data store is used for workspace search. Details + // of workspace data store are specified in the WorkspaceConfig. ContentConfig string `json:"contentConfig,omitempty"` // CreateTime: Output only. Timestamp the DataStore was created at. CreateTime string `json:"createTime,omitempty"` @@ -9725,6 +10107,10 @@ type GoogleCloudDiscoveryengineV1alphaDataStore struct { // against certain rules on schema. Learn more from this doc // (https://cloud.google.com/generative-ai-app-builder/docs/provide-schema). StartingSchema *GoogleCloudDiscoveryengineV1alphaSchema `json:"startingSchema,omitempty"` + // WorkspaceConfig: Config to store data store type configuration for workspace + // data. This must be set when DataStore.content_config is set as + // DataStore.ContentConfig.GOOGLE_WORKSPACE. + WorkspaceConfig *GoogleCloudDiscoveryengineV1alphaWorkspaceConfig `json:"workspaceConfig,omitempty"` // ForceSendFields is a list of field names (e.g. "AclEnabled") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -13465,13 +13851,50 @@ func (s GoogleCloudDiscoveryengineV1alphaUserInfo) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDiscoveryengineV1betaBatchCreateTargetSiteMetadata: Metadata -// related to the progress of the -// SiteSearchEngineService.BatchCreateTargetSites operation. This will be -// returned by the google.longrunning.Operation.metadata field. -type GoogleCloudDiscoveryengineV1betaBatchCreateTargetSiteMetadata struct { - // CreateTime: Operation create time. - CreateTime string `json:"createTime,omitempty"` +// GoogleCloudDiscoveryengineV1alphaWorkspaceConfig: Config to store data store +// type configuration for workspace data +type GoogleCloudDiscoveryengineV1alphaWorkspaceConfig struct { + // DasherCustomerId: Obfuscated Dasher customer ID. + DasherCustomerId string `json:"dasherCustomerId,omitempty"` + // Type: The Google Workspace data source. + // + // Possible values: + // "TYPE_UNSPECIFIED" - Default value. + // "GOOGLE_DRIVE" - The data store is used to store content from Google + // Drive. + // "GOOGLE_MAIL" - The data store is used to store content from Gmail. + // "GOOGLE_SITES" - The data store is used to store content from Google + // Sites. + // "GOOGLE_CALENDAR" - The data store is used to store content from Google + // Calendar. + // "GOOGLE_GROUPS" - The data store is used to store content from Google + // Groups. + Type string `json:"type,omitempty"` + // ForceSendFields is a list of field names (e.g. "DasherCustomerId") 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. "DasherCustomerId") 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 GoogleCloudDiscoveryengineV1alphaWorkspaceConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaWorkspaceConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1betaBatchCreateTargetSiteMetadata: Metadata +// related to the progress of the +// SiteSearchEngineService.BatchCreateTargetSites operation. This will be +// returned by the google.longrunning.Operation.metadata field. +type GoogleCloudDiscoveryengineV1betaBatchCreateTargetSiteMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` // UpdateTime: Operation last update time. If the operation is done, this is // also the finish time. UpdateTime string `json:"updateTime,omitempty"` @@ -13599,7 +14022,7 @@ func (s GoogleCloudDiscoveryengineV1betaConditionTimeRange) MarshalJSON() ([]byt // employ during serving. Must be attached to a ServingConfig to be considered // at serving time. Permitted actions dependent on `SolutionType`. type GoogleCloudDiscoveryengineV1betaControl struct { - // AssociatedServingConfigIds: Output only. List of all ServingConfig ids this + // AssociatedServingConfigIds: Output only. List of all ServingConfig IDs this // control is attached to. May take up to 10 minutes to update after changes. AssociatedServingConfigIds []string `json:"associatedServingConfigIds,omitempty"` // BoostAction: Defines a boost-type control @@ -13968,6 +14391,8 @@ type GoogleCloudDiscoveryengineV1betaDataStore struct { // "NO_CONTENT" - Only contains documents without any Document.content. // "CONTENT_REQUIRED" - Only contains documents with Document.content. // "PUBLIC_WEBSITE" - The data store is used for public website search. + // "GOOGLE_WORKSPACE" - The data store is used for workspace search. Details + // of workspace data store are specified in the WorkspaceConfig. ContentConfig string `json:"contentConfig,omitempty"` // CreateTime: Output only. Timestamp the DataStore was created at. CreateTime string `json:"createTime,omitempty"` @@ -14023,6 +14448,10 @@ type GoogleCloudDiscoveryengineV1betaDataStore struct { // against certain rules on schema. Learn more from this doc // (https://cloud.google.com/generative-ai-app-builder/docs/provide-schema). StartingSchema *GoogleCloudDiscoveryengineV1betaSchema `json:"startingSchema,omitempty"` + // WorkspaceConfig: Config to store data store type configuration for workspace + // data. This must be set when DataStore.content_config is set as + // DataStore.ContentConfig.GOOGLE_WORKSPACE. + WorkspaceConfig *GoogleCloudDiscoveryengineV1betaWorkspaceConfig `json:"workspaceConfig,omitempty"` // ForceSendFields is a list of field names (e.g. "ContentConfig") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -15614,6 +16043,19 @@ type GoogleCloudDiscoveryengineV1betaSearchRequest struct { // (https://cloud.google.com/apis/design/standard_fields). If set, then results // will be boosted based on the region_code provided. RegionCode string `json:"regionCode,omitempty"` + // RelevanceThreshold: The relevance threshold of the search results. Default + // to Google defined threshold, leveraging a balance of precision and recall to + // deliver both highly accurate results and comprehensive coverage of relevant + // information. + // + // Possible values: + // "RELEVANCE_THRESHOLD_UNSPECIFIED" - Default value. In this case, server + // behavior defaults to Google defined threshold. + // "LOWEST" - Lowest relevance threshold. + // "LOW" - Low relevance threshold. + // "MEDIUM" - Medium relevance threshold. + // "HIGH" - High relevance threshold. + RelevanceThreshold string `json:"relevanceThreshold,omitempty"` // SafeSearch: Whether to turn on safe search. This is only supported for // website search. SafeSearch bool `json:"safeSearch,omitempty"` @@ -16927,6 +17369,43 @@ func (s GoogleCloudDiscoveryengineV1betaUserInfo) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1betaWorkspaceConfig: Config to store data store +// type configuration for workspace data +type GoogleCloudDiscoveryengineV1betaWorkspaceConfig struct { + // DasherCustomerId: Obfuscated Dasher customer ID. + DasherCustomerId string `json:"dasherCustomerId,omitempty"` + // Type: The Google Workspace data source. + // + // Possible values: + // "TYPE_UNSPECIFIED" - Default value. + // "GOOGLE_DRIVE" - The data store is used to store content from Google + // Drive. + // "GOOGLE_MAIL" - The data store is used to store content from Gmail. + // "GOOGLE_SITES" - The data store is used to store content from Google + // Sites. + // "GOOGLE_CALENDAR" - The data store is used to store content from Google + // Calendar. + // "GOOGLE_GROUPS" - The data store is used to store content from Google + // Groups. + Type string `json:"type,omitempty"` + // ForceSendFields is a list of field names (e.g. "DasherCustomerId") 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. "DasherCustomerId") 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 GoogleCloudDiscoveryengineV1betaWorkspaceConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaWorkspaceConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleLongrunningCancelOperationRequest: The request message for // Operations.CancelOperation. type GoogleLongrunningCancelOperationRequest struct { @@ -18351,6 +18830,229 @@ func (c *ProjectsLocationsCollectionsDataStoresPatchCall) Do(opts ...googleapi.C return ret, nil } +type ProjectsLocationsCollectionsDataStoresTrainCustomModelCall struct { + s *Service + dataStore string + googleclouddiscoveryenginev1traincustommodelrequest *GoogleCloudDiscoveryengineV1TrainCustomModelRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// TrainCustomModel: Trains a custom model. +// +// - dataStore: The resource name of the Data Store, such as +// `projects/*/locations/global/collections/default_collection/dataStores/defa +// ult_data_store`. This field is used to identify the data store where to +// train the models. +func (r *ProjectsLocationsCollectionsDataStoresService) TrainCustomModel(dataStore string, googleclouddiscoveryenginev1traincustommodelrequest *GoogleCloudDiscoveryengineV1TrainCustomModelRequest) *ProjectsLocationsCollectionsDataStoresTrainCustomModelCall { + c := &ProjectsLocationsCollectionsDataStoresTrainCustomModelCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.dataStore = dataStore + c.googleclouddiscoveryenginev1traincustommodelrequest = googleclouddiscoveryenginev1traincustommodelrequest + 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 *ProjectsLocationsCollectionsDataStoresTrainCustomModelCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresTrainCustomModelCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsCollectionsDataStoresTrainCustomModelCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresTrainCustomModelCall { + 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 *ProjectsLocationsCollectionsDataStoresTrainCustomModelCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsDataStoresTrainCustomModelCall) 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.googleclouddiscoveryenginev1traincustommodelrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+dataStore}:trainCustomModel") + 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{ + "dataStore": c.dataStore, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.collections.dataStores.trainCustomModel" 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 *ProjectsLocationsCollectionsDataStoresTrainCustomModelCall) 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 ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// BatchGetDocumentsMetadata: Gets index freshness metadata for Documents. +// Supported for website search only. +// +// - parent: The parent branch resource name, such as +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store}/branches/{branch}`. +func (r *ProjectsLocationsCollectionsDataStoresBranchesService) BatchGetDocumentsMetadata(parent string) *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall { + c := &ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// MatcherUrisMatcherUris sets the optional parameter +// "matcher.urisMatcher.uris": The exact URIs to match by. +func (c *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) MatcherUrisMatcherUris(matcherUrisMatcherUris ...string) *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall { + c.urlParams_.SetMulti("matcher.urisMatcher.uris", append([]string{}, matcherUrisMatcherUris...)) + 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 *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall { + 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 *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall { + 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 *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) 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, "v1/{+parent}/batchGetDocumentsMetadata") + 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{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.batchGetDocumentsMetadata" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponse.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 *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponse, 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 := &GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponse{ + 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 ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall struct { s *Service parent string @@ -21044,6 +21746,117 @@ func (c *ProjectsLocationsCollectionsDataStoresConversationsPatchCall) Do(opts . return ret, nil } +type ProjectsLocationsCollectionsDataStoresCustomModelsListCall struct { + s *Service + dataStore string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Gets a list of all the custom models. +// +// - dataStore: The resource name of the parent Data Store, such as +// `projects/*/locations/global/collections/default_collection/dataStores/defa +// ult_data_store`. This field is used to identify the data store where to +// fetch the models from. +func (r *ProjectsLocationsCollectionsDataStoresCustomModelsService) List(dataStore string) *ProjectsLocationsCollectionsDataStoresCustomModelsListCall { + c := &ProjectsLocationsCollectionsDataStoresCustomModelsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.dataStore = dataStore + 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 *ProjectsLocationsCollectionsDataStoresCustomModelsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresCustomModelsListCall { + 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 *ProjectsLocationsCollectionsDataStoresCustomModelsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresCustomModelsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsCollectionsDataStoresCustomModelsListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresCustomModelsListCall { + 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 *ProjectsLocationsCollectionsDataStoresCustomModelsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsDataStoresCustomModelsListCall) 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, "v1/{+dataStore}/customModels") + 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{ + "dataStore": c.dataStore, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.collections.dataStores.customModels.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1ListCustomModelsResponse.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 *ProjectsLocationsCollectionsDataStoresCustomModelsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ListCustomModelsResponse, 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 := &GoogleCloudDiscoveryengineV1ListCustomModelsResponse{ + 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 ProjectsLocationsCollectionsDataStoresModelsOperationsGetCall struct { s *Service name string @@ -30245,6 +31058,124 @@ func (c *ProjectsLocationsDataStoresPatchCall) Do(opts ...googleapi.CallOption) return ret, nil } +type ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// BatchGetDocumentsMetadata: Gets index freshness metadata for Documents. +// Supported for website search only. +// +// - parent: The parent branch resource name, such as +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store}/branches/{branch}`. +func (r *ProjectsLocationsDataStoresBranchesService) BatchGetDocumentsMetadata(parent string) *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall { + c := &ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// MatcherUrisMatcherUris sets the optional parameter +// "matcher.urisMatcher.uris": The exact URIs to match by. +func (c *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall) MatcherUrisMatcherUris(matcherUrisMatcherUris ...string) *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall { + c.urlParams_.SetMulti("matcher.urisMatcher.uris", append([]string{}, matcherUrisMatcherUris...)) + 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 *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall { + 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 *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall) Context(ctx context.Context) *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall { + 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 *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall) 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, "v1/{+parent}/batchGetDocumentsMetadata") + 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{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.dataStores.branches.batchGetDocumentsMetadata" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponse.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 *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponse, 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 := &GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponse{ + 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 ProjectsLocationsDataStoresBranchesDocumentsCreateCall struct { s *Service parent string diff --git a/discoveryengine/v1alpha/discoveryengine-api.json b/discoveryengine/v1alpha/discoveryengine-api.json index b1d715facca..7bc496fc4e7 100644 --- a/discoveryengine/v1alpha/discoveryengine-api.json +++ b/discoveryengine/v1alpha/discoveryengine-api.json @@ -246,7 +246,7 @@ ] }, "updateAclConfig": { - "description": "Default Acl Configuration for use in a location of a customer's project. Updates will only reflect to new data stores. Existing data stores will still use the old value.", + "description": "Default ACL configuration for use in a location of a customer's project. Updates will only reflect to new data stores. Existing data stores will still use the old value.", "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/aclConfig", "httpMethod": "PATCH", "id": "discoveryengine.projects.locations.updateAclConfig", @@ -681,6 +681,39 @@ }, "resources": { "branches": { + "methods": { + "batchGetDocumentsMetadata": { + "description": "Gets index freshness metadata for Documents. Supported for website search only.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/branches/{branchesId}/batchGetDocumentsMetadata", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.collections.dataStores.branches.batchGetDocumentsMetadata", + "parameterOrder": [ + "parent" + ], + "parameters": { + "matcher.urisMatcher.uris": { + "description": "The exact URIs to match by.", + "location": "query", + "repeated": true, + "type": "string" + }, + "parent": { + "description": "Required. The parent branch resource name, such as `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/branches/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+parent}/batchGetDocumentsMetadata", + "response": { + "$ref": "GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, "resources": { "documents": { "methods": { @@ -4450,6 +4483,39 @@ }, "resources": { "branches": { + "methods": { + "batchGetDocumentsMetadata": { + "description": "Gets index freshness metadata for Documents. Supported for website search only.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/branches/{branchesId}/batchGetDocumentsMetadata", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.dataStores.branches.batchGetDocumentsMetadata", + "parameterOrder": [ + "parent" + ], + "parameters": { + "matcher.urisMatcher.uris": { + "description": "The exact URIs to match by.", + "location": "query", + "repeated": true, + "type": "string" + }, + "parent": { + "description": "Required. The parent branch resource name, such as `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/branches/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+parent}/batchGetDocumentsMetadata", + "response": { + "$ref": "GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, "resources": { "documents": { "methods": { @@ -7289,6 +7355,80 @@ ] } } + }, + "userStores": { + "resources": { + "operations": { + "methods": { + "get": { + "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/userStores/{userStoresId}/operations/{operationsId}", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.userStores.operations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/userStores/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/userStores/{userStoresId}/operations", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.userStores.operations.list", + "parameterOrder": [ + "name" + ], + "parameters": { + "filter": { + "description": "The standard list filter.", + "location": "query", + "type": "string" + }, + "name": { + "description": "The name of the operation's parent resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/userStores/[^/]+$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "The standard list page size.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The standard list page token.", + "location": "query", + "type": "string" + } + }, + "path": "v1alpha/{+name}/operations", + "response": { + "$ref": "GoogleLongrunningListOperationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } } } }, @@ -7365,7 +7505,7 @@ } } }, - "revision": "20240801", + "revision": "20240813", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiDistribution": { @@ -7789,7 +7929,7 @@ "id": "GoogleCloudDiscoveryengineV1Control", "properties": { "associatedServingConfigIds": { - "description": "Output only. List of all ServingConfig ids this control is attached to. May take up to 10 minutes to update after changes.", + "description": "Output only. List of all ServingConfig IDs this control is attached to. May take up to 10 minutes to update after changes.", "items": { "type": "string" }, @@ -8003,13 +8143,15 @@ "CONTENT_CONFIG_UNSPECIFIED", "NO_CONTENT", "CONTENT_REQUIRED", - "PUBLIC_WEBSITE" + "PUBLIC_WEBSITE", + "GOOGLE_WORKSPACE" ], "enumDescriptions": [ "Default value.", "Only contains documents without any Document.content.", "Only contains documents with Document.content.", - "The data store is used for public website search." + "The data store is used for public website search.", + "The data store is used for workspace search. Details of workspace data store are specified in the WorkspaceConfig." ], "type": "string" }, @@ -8076,6 +8218,10 @@ "startingSchema": { "$ref": "GoogleCloudDiscoveryengineV1Schema", "description": "The start schema to use for this DataStore when provisioning it. If unset, a default vertical specialized schema will be used. This field is only used by CreateDataStore API, and will be ignored if used in other APIs. This field will be omitted from all API responses including CreateDataStore API. To retrieve a schema of a DataStore, use SchemaService.GetSchema API instead. The provided schema will be validated against certain rules on schema. Learn more from [this doc](https://cloud.google.com/generative-ai-app-builder/docs/provide-schema)." + }, + "workspaceConfig": { + "$ref": "GoogleCloudDiscoveryengineV1WorkspaceConfig", + "description": "Config to store data store type configuration for workspace data. This must be set when DataStore.content_config is set as DataStore.ContentConfig.GOOGLE_WORKSPACE." } }, "type": "object" @@ -9034,6 +9180,57 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1TrainCustomModelMetadata": { + "description": "Metadata related to the progress of the TrainCustomModel operation. This is returned by the google.longrunning.Operation.metadata field.", + "id": "GoogleCloudDiscoveryengineV1TrainCustomModelMetadata", + "properties": { + "createTime": { + "description": "Operation create time.", + "format": "google-datetime", + "type": "string" + }, + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1TrainCustomModelResponse": { + "description": "Response of the TrainCustomModelRequest. This message is returned by the google.longrunning.Operations.response field.", + "id": "GoogleCloudDiscoveryengineV1TrainCustomModelResponse", + "properties": { + "errorConfig": { + "$ref": "GoogleCloudDiscoveryengineV1ImportErrorConfig", + "description": "Echoes the destination for the complete errors in the request if set." + }, + "errorSamples": { + "description": "A sample of errors encountered while processing the data.", + "items": { + "$ref": "GoogleRpcStatus" + }, + "type": "array" + }, + "metrics": { + "additionalProperties": { + "format": "double", + "type": "number" + }, + "description": "The metrics of the trained model.", + "type": "object" + }, + "modelName": { + "description": "Fully qualified name of the CustomTuningModel.", + "type": "string" + }, + "modelStatus": { + "description": "The trained model status. Possible values are: * **bad-data**: The training data quality is bad. * **no-improvement**: Tuning didn't improve performance. Won't deploy. * **in-progress**: Model training job creation is in progress. * **training**: Model is actively training. * **evaluating**: The model is evaluating trained metrics. * **indexing**: The model trained metrics are indexing. * **ready**: The model is ready for serving.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1UpdateSchemaMetadata": { "description": "Metadata for UpdateSchema LRO.", "id": "GoogleCloudDiscoveryengineV1UpdateSchemaMetadata", @@ -9068,6 +9265,37 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1WorkspaceConfig": { + "description": "Config to store data store type configuration for workspace data", + "id": "GoogleCloudDiscoveryengineV1WorkspaceConfig", + "properties": { + "dasherCustomerId": { + "description": "Obfuscated Dasher customer ID.", + "type": "string" + }, + "type": { + "description": "The Google Workspace data source.", + "enum": [ + "TYPE_UNSPECIFIED", + "GOOGLE_DRIVE", + "GOOGLE_MAIL", + "GOOGLE_SITES", + "GOOGLE_CALENDAR", + "GOOGLE_GROUPS" + ], + "enumDescriptions": [ + "Default value.", + "The data store is used to store content from Google Drive.", + "The data store is used to store content from Gmail.", + "The data store is used to store content from Google Sites.", + "The data store is used to store content from Google Calendar.", + "The data store is used to store content from Google Groups." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaAclConfig": { "description": "Access Control Configuration.", "id": "GoogleCloudDiscoveryengineV1alphaAclConfig", @@ -9104,7 +9332,7 @@ "type": "string" }, "projectId": { - "description": "The project ID that the AlloyDB source is in with a length limit of 128 characters. If not specified, inherits the project ID from the parent request.", + "description": "The project ID that contains the AlloyDB source. Has a length limit of 128 characters. If not specified, inherits the project ID from the parent request.", "type": "string" }, "tableId": { @@ -9128,7 +9356,8 @@ "OUT_OF_DOMAIN_QUERY_IGNORED", "POTENTIAL_POLICY_VIOLATION", "NO_RELEVANT_CONTENT", - "JAIL_BREAKING_QUERY_IGNORED" + "JAIL_BREAKING_QUERY_IGNORED", + "CUSTOMER_POLICY_VIOLATION" ], "enumDescriptions": [ "Default value. The answer skipped reason is not specified.", @@ -9137,7 +9366,8 @@ "The out-of-domain query ignored case. Google skips the answer if there are no high-relevance search results.", "The potential policy violation case. Google skips the answer if there is a potential policy violation detected. This includes content that may be violent or toxic.", "The no relevant content case. Google skips the answer if there is no relevant content in the retrieved search results.", - "The jail-breaking query ignored case. For example, \"Reply in the tone of a competing company's CEO\". Google skips the answer if the query is classified as a jail-breaking query." + "The jail-breaking query ignored case. For example, \"Reply in the tone of a competing company's CEO\". Google skips the answer if the query is classified as a jail-breaking query.", + "The customer policy violation case. Google skips the summary if there is a customer policy violation detected. The policy is defined by the customer." ], "type": "string" }, @@ -10033,6 +10263,63 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponse": { + "description": "Response message for DocumentService.BatchGetDocumentsMetadata method.", + "id": "GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponse", + "properties": { + "documentsMetadata": { + "description": "The metadata of the Documents.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponseDocumentMetadata" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponseDocumentMetadata": { + "description": "The metadata of a Document.", + "id": "GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponseDocumentMetadata", + "properties": { + "lastRefreshedTime": { + "description": "The timestamp of the last time the Document was last indexed.", + "format": "google-datetime", + "type": "string" + }, + "matcherValue": { + "$ref": "GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponseDocumentMetadataMatcherValue", + "description": "The value of the matcher that was used to match the Document." + }, + "status": { + "description": "The status of the document.", + "enum": [ + "STATUS_UNSPECIFIED", + "STATUS_INDEXED", + "STATUS_NOT_IN_TARGET_SITE", + "STATUS_NOT_IN_INDEX" + ], + "enumDescriptions": [ + "Should never be set.", + "The Document is indexed.", + "The Document is not indexed because its URI is not in the TargetSite.", + "The Document is not indexed." + ], + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponseDocumentMetadataMatcherValue": { + "description": "The value of the matcher that was used to match the Document.", + "id": "GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponseDocumentMetadataMatcherValue", + "properties": { + "uri": { + "description": "If match by URI, the URI of the Document.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaBatchVerifyTargetSitesRequest": { "description": "Request message for SiteSearchEngineService.BatchVerifyTargetSites method.", "id": "GoogleCloudDiscoveryengineV1alphaBatchVerifyTargetSitesRequest", @@ -10060,7 +10347,7 @@ "description": "BigQuery time partitioned table's _PARTITIONDATE in YYYY-MM-DD format." }, "projectId": { - "description": "The project ID (can be project # or ID) that the BigQuery source is in with a length limit of 128 characters. If not specified, inherits the project ID from the parent request.", + "description": "The project ID or the project number that contains the BigQuery source. Has a length limit of 128 characters. If not specified, inherits the project ID from the parent request.", "type": "string" }, "tableId": { @@ -10211,7 +10498,7 @@ "type": "string" }, "projectId": { - "description": "The project ID that the Bigtable source is in with a length limit of 128 characters. If not specified, inherits the project ID from the parent request.", + "description": "The project ID that contains the Bigtable source. Has a length limit of 128 characters. If not specified, inherits the project ID from the parent request.", "type": "string" }, "tableId": { @@ -10301,6 +10588,11 @@ "description": "Indicates that this claim required grounding check. When the system decided this claim doesn't require attribution/grounding check, this field will be set to false. In that case, no grounding check was done for the claim and therefore citation_indices, and anti_citation_indices should not be returned.", "type": "boolean" }, + "score": { + "description": "Confidence score for the claim in the answer candidate, in the range of [0, 1].", + "format": "double", + "type": "number" + }, "startPos": { "description": "Position indicating the start of the claim in the answer candidate, measured in bytes.", "format": "int32", @@ -10539,7 +10831,7 @@ "type": "boolean" }, "projectId": { - "description": "The project ID that the Cloud SQL source is in with a length limit of 128 characters. If not specified, inherits the project ID from the parent request.", + "description": "The project ID that contains the Cloud SQL source. Has a length limit of 128 characters. If not specified, inherits the project ID from the parent request.", "type": "string" }, "tableId": { @@ -10700,7 +10992,7 @@ "id": "GoogleCloudDiscoveryengineV1alphaControl", "properties": { "associatedServingConfigIds": { - "description": "Output only. List of all ServingConfig ids this control is attached to. May take up to 10 minutes to update after changes.", + "description": "Output only. List of all ServingConfig IDs this control is attached to. May take up to 10 minutes to update after changes.", "items": { "type": "string" }, @@ -11191,13 +11483,15 @@ "CONTENT_CONFIG_UNSPECIFIED", "NO_CONTENT", "CONTENT_REQUIRED", - "PUBLIC_WEBSITE" + "PUBLIC_WEBSITE", + "GOOGLE_WORKSPACE" ], "enumDescriptions": [ "Default value.", "Only contains documents without any Document.content.", "Only contains documents with Document.content.", - "The data store is used for public website search." + "The data store is used for public website search.", + "The data store is used for workspace search. Details of workspace data store are specified in the WorkspaceConfig." ], "type": "string" }, @@ -11273,6 +11567,10 @@ "startingSchema": { "$ref": "GoogleCloudDiscoveryengineV1alphaSchema", "description": "The start schema to use for this DataStore when provisioning it. If unset, a default vertical specialized schema will be used. This field is only used by CreateDataStore API, and will be ignored if used in other APIs. This field will be omitted from all API responses including CreateDataStore API. To retrieve a schema of a DataStore, use SchemaService.GetSchema API instead. The provided schema will be validated against certain rules on schema. Learn more from [this doc](https://cloud.google.com/generative-ai-app-builder/docs/provide-schema)." + }, + "workspaceConfig": { + "$ref": "GoogleCloudDiscoveryengineV1alphaWorkspaceConfig", + "description": "Config to store data store type configuration for workspace data. This must be set when DataStore.content_config is set as DataStore.ContentConfig.GOOGLE_WORKSPACE." } }, "type": "object" @@ -15466,6 +15764,10 @@ "description": "Name of the string field as defined in the schema.", "type": "string" }, + "querySegment": { + "description": "Identifies the keywords within the search query that match a filter.", + "type": "string" + }, "values": { "description": "Values of the string field. The record will only be returned if the field value matches one of the values specified here.", "items": { @@ -15582,7 +15884,8 @@ "POTENTIAL_POLICY_VIOLATION", "LLM_ADDON_NOT_ENABLED", "NO_RELEVANT_CONTENT", - "JAIL_BREAKING_QUERY_IGNORED" + "JAIL_BREAKING_QUERY_IGNORED", + "CUSTOMER_POLICY_VIOLATION" ], "enumDescriptions": [ "Default value. The summary skipped reason is not specified.", @@ -15592,7 +15895,8 @@ "The potential policy violation case. Google skips the summary if there is a potential policy violation detected. This includes content that may be violent or toxic.", "The LLM addon not enabled case. Google skips the summary if the LLM addon is not enabled.", "The no relevant content case. Google skips the summary if there is no relevant content in the retrieved search results.", - "The jail-breaking query ignored case. For example, \"Reply in the tone of a competing company's CEO\". Only used when [SearchRequest.ContentSearchSpec.SummarySpec.ignore_jail_breaking_query] is set to `true`." + "The jail-breaking query ignored case. For example, \"Reply in the tone of a competing company's CEO\". Only used when [SearchRequest.ContentSearchSpec.SummarySpec.ignore_jail_breaking_query] is set to `true`.", + "The customer policy violation case. Google skips the summary if there is a customer policy violation detected. The policy is defined by the customer." ], "type": "string" }, @@ -16084,7 +16388,7 @@ "type": "string" }, "projectId": { - "description": "The project ID that the Spanner source is in with a length limit of 128 characters. If not specified, inherits the project ID from the parent request.", + "description": "The project ID that contains the Spanner source. Has a length limit of 128 characters. If not specified, inherits the project ID from the parent request.", "type": "string" }, "tableId": { @@ -16540,6 +16844,37 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaWorkspaceConfig": { + "description": "Config to store data store type configuration for workspace data", + "id": "GoogleCloudDiscoveryengineV1alphaWorkspaceConfig", + "properties": { + "dasherCustomerId": { + "description": "Obfuscated Dasher customer ID.", + "type": "string" + }, + "type": { + "description": "The Google Workspace data source.", + "enum": [ + "TYPE_UNSPECIFIED", + "GOOGLE_DRIVE", + "GOOGLE_MAIL", + "GOOGLE_SITES", + "GOOGLE_CALENDAR", + "GOOGLE_GROUPS" + ], + "enumDescriptions": [ + "Default value.", + "The data store is used to store content from Google Drive.", + "The data store is used to store content from Gmail.", + "The data store is used to store content from Google Sites.", + "The data store is used to store content from Google Calendar.", + "The data store is used to store content from Google Groups." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaBatchCreateTargetSiteMetadata": { "description": "Metadata related to the progress of the SiteSearchEngineService.BatchCreateTargetSites operation. This will be returned by the google.longrunning.Operation.metadata field.", "id": "GoogleCloudDiscoveryengineV1betaBatchCreateTargetSiteMetadata", @@ -16629,7 +16964,7 @@ "id": "GoogleCloudDiscoveryengineV1betaControl", "properties": { "associatedServingConfigIds": { - "description": "Output only. List of all ServingConfig ids this control is attached to. May take up to 10 minutes to update after changes.", + "description": "Output only. List of all ServingConfig IDs this control is attached to. May take up to 10 minutes to update after changes.", "items": { "type": "string" }, @@ -16910,13 +17245,15 @@ "CONTENT_CONFIG_UNSPECIFIED", "NO_CONTENT", "CONTENT_REQUIRED", - "PUBLIC_WEBSITE" + "PUBLIC_WEBSITE", + "GOOGLE_WORKSPACE" ], "enumDescriptions": [ "Default value.", "Only contains documents without any Document.content.", "Only contains documents with Document.content.", - "The data store is used for public website search." + "The data store is used for public website search.", + "The data store is used for workspace search. Details of workspace data store are specified in the WorkspaceConfig." ], "type": "string" }, @@ -16987,6 +17324,10 @@ "startingSchema": { "$ref": "GoogleCloudDiscoveryengineV1betaSchema", "description": "The start schema to use for this DataStore when provisioning it. If unset, a default vertical specialized schema will be used. This field is only used by CreateDataStore API, and will be ignored if used in other APIs. This field will be omitted from all API responses including CreateDataStore API. To retrieve a schema of a DataStore, use SchemaService.GetSchema API instead. The provided schema will be validated against certain rules on schema. Learn more from [this doc](https://cloud.google.com/generative-ai-app-builder/docs/provide-schema)." + }, + "workspaceConfig": { + "$ref": "GoogleCloudDiscoveryengineV1betaWorkspaceConfig", + "description": "Config to store data store type configuration for workspace data. This must be set when DataStore.content_config is set as DataStore.ContentConfig.GOOGLE_WORKSPACE." } }, "type": "object" @@ -18136,6 +18477,24 @@ "description": "The Unicode country/region code (CLDR) of a location, such as \"US\" and \"419\". For more information, see [Standard fields](https://cloud.google.com/apis/design/standard_fields). If set, then results will be boosted based on the region_code provided.", "type": "string" }, + "relevanceThreshold": { + "description": "The relevance threshold of the search results. Default to Google defined threshold, leveraging a balance of precision and recall to deliver both highly accurate results and comprehensive coverage of relevant information.", + "enum": [ + "RELEVANCE_THRESHOLD_UNSPECIFIED", + "LOWEST", + "LOW", + "MEDIUM", + "HIGH" + ], + "enumDescriptions": [ + "Default value. In this case, server behavior defaults to Google defined threshold.", + "Lowest relevance threshold.", + "Low relevance threshold.", + "Medium relevance threshold.", + "High relevance threshold." + ], + "type": "string" + }, "safeSearch": { "description": "Whether to turn on safe search. This is only supported for website search.", "type": "boolean" @@ -18932,6 +19291,37 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaWorkspaceConfig": { + "description": "Config to store data store type configuration for workspace data", + "id": "GoogleCloudDiscoveryengineV1betaWorkspaceConfig", + "properties": { + "dasherCustomerId": { + "description": "Obfuscated Dasher customer ID.", + "type": "string" + }, + "type": { + "description": "The Google Workspace data source.", + "enum": [ + "TYPE_UNSPECIFIED", + "GOOGLE_DRIVE", + "GOOGLE_MAIL", + "GOOGLE_SITES", + "GOOGLE_CALENDAR", + "GOOGLE_GROUPS" + ], + "enumDescriptions": [ + "Default value.", + "The data store is used to store content from Google Drive.", + "The data store is used to store content from Gmail.", + "The data store is used to store content from Google Sites.", + "The data store is used to store content from Google Calendar.", + "The data store is used to store content from Google Groups." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleLongrunningCancelOperationRequest": { "description": "The request message for Operations.CancelOperation.", "id": "GoogleLongrunningCancelOperationRequest", diff --git a/discoveryengine/v1alpha/discoveryengine-gen.go b/discoveryengine/v1alpha/discoveryengine-gen.go index 911b0337829..4f1ff4eafc5 100644 --- a/discoveryengine/v1alpha/discoveryengine-gen.go +++ b/discoveryengine/v1alpha/discoveryengine-gen.go @@ -181,6 +181,7 @@ func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { rs.Requirements = NewProjectsLocationsRequirementsService(s) rs.SampleQuerySets = NewProjectsLocationsSampleQuerySetsService(s) rs.UserEvents = NewProjectsLocationsUserEventsService(s) + rs.UserStores = NewProjectsLocationsUserStoresService(s) return rs } @@ -206,6 +207,8 @@ type ProjectsLocationsService struct { SampleQuerySets *ProjectsLocationsSampleQuerySetsService UserEvents *ProjectsLocationsUserEventsService + + UserStores *ProjectsLocationsUserStoresService } func NewProjectsLocationsCollectionsService(s *Service) *ProjectsLocationsCollectionsService { @@ -958,6 +961,27 @@ type ProjectsLocationsUserEventsService struct { s *Service } +func NewProjectsLocationsUserStoresService(s *Service) *ProjectsLocationsUserStoresService { + rs := &ProjectsLocationsUserStoresService{s: s} + rs.Operations = NewProjectsLocationsUserStoresOperationsService(s) + return rs +} + +type ProjectsLocationsUserStoresService struct { + s *Service + + Operations *ProjectsLocationsUserStoresOperationsService +} + +func NewProjectsLocationsUserStoresOperationsService(s *Service) *ProjectsLocationsUserStoresOperationsService { + rs := &ProjectsLocationsUserStoresOperationsService{s: s} + return rs +} + +type ProjectsLocationsUserStoresOperationsService struct { + s *Service +} + func NewProjectsOperationsService(s *Service) *ProjectsOperationsService { rs := &ProjectsOperationsService{s: s} return rs @@ -1718,7 +1742,7 @@ func (s GoogleCloudDiscoveryengineV1ConditionTimeRange) MarshalJSON() ([]byte, e // employ during serving. Must be attached to a ServingConfig to be considered // at serving time. Permitted actions dependent on `SolutionType`. type GoogleCloudDiscoveryengineV1Control struct { - // AssociatedServingConfigIds: Output only. List of all ServingConfig ids this + // AssociatedServingConfigIds: Output only. List of all ServingConfig IDs this // control is attached to. May take up to 10 minutes to update after changes. AssociatedServingConfigIds []string `json:"associatedServingConfigIds,omitempty"` // BoostAction: Defines a boost-type control @@ -2033,6 +2057,8 @@ type GoogleCloudDiscoveryengineV1DataStore struct { // "NO_CONTENT" - Only contains documents without any Document.content. // "CONTENT_REQUIRED" - Only contains documents with Document.content. // "PUBLIC_WEBSITE" - The data store is used for public website search. + // "GOOGLE_WORKSPACE" - The data store is used for workspace search. Details + // of workspace data store are specified in the WorkspaceConfig. ContentConfig string `json:"contentConfig,omitempty"` // CreateTime: Output only. Timestamp the DataStore was created at. CreateTime string `json:"createTime,omitempty"` @@ -2086,6 +2112,10 @@ type GoogleCloudDiscoveryengineV1DataStore struct { // against certain rules on schema. Learn more from this doc // (https://cloud.google.com/generative-ai-app-builder/docs/provide-schema). StartingSchema *GoogleCloudDiscoveryengineV1Schema `json:"startingSchema,omitempty"` + // WorkspaceConfig: Config to store data store type configuration for workspace + // data. This must be set when DataStore.content_config is set as + // DataStore.ContentConfig.GOOGLE_WORKSPACE. + WorkspaceConfig *GoogleCloudDiscoveryengineV1WorkspaceConfig `json:"workspaceConfig,omitempty"` // ForceSendFields is a list of field names (e.g. "ContentConfig") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -3378,6 +3408,72 @@ func (s GoogleCloudDiscoveryengineV1TargetSiteFailureReasonQuotaFailure) Marshal return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1TrainCustomModelMetadata: Metadata related to +// the progress of the TrainCustomModel operation. This is returned by the +// google.longrunning.Operation.metadata field. +type GoogleCloudDiscoveryengineV1TrainCustomModelMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + // UpdateTime: Operation last update time. If the operation is done, this is + // also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "CreateTime") 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. "CreateTime") 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 GoogleCloudDiscoveryengineV1TrainCustomModelMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1TrainCustomModelMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1TrainCustomModelResponse: Response of the +// TrainCustomModelRequest. This message is returned by the +// google.longrunning.Operations.response field. +type GoogleCloudDiscoveryengineV1TrainCustomModelResponse struct { + // ErrorConfig: Echoes the destination for the complete errors in the request + // if set. + ErrorConfig *GoogleCloudDiscoveryengineV1ImportErrorConfig `json:"errorConfig,omitempty"` + // ErrorSamples: A sample of errors encountered while processing the data. + ErrorSamples []*GoogleRpcStatus `json:"errorSamples,omitempty"` + // Metrics: The metrics of the trained model. + Metrics map[string]float64 `json:"metrics,omitempty"` + // ModelName: Fully qualified name of the CustomTuningModel. + ModelName string `json:"modelName,omitempty"` + // ModelStatus: The trained model status. Possible values are: * **bad-data**: + // The training data quality is bad. * **no-improvement**: Tuning didn't + // improve performance. Won't deploy. * **in-progress**: Model training job + // creation is in progress. * **training**: Model is actively training. * + // **evaluating**: The model is evaluating trained metrics. * **indexing**: The + // model trained metrics are indexing. * **ready**: The model is ready for + // serving. + ModelStatus string `json:"modelStatus,omitempty"` + // ForceSendFields is a list of field names (e.g. "ErrorConfig") 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. "ErrorConfig") 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 GoogleCloudDiscoveryengineV1TrainCustomModelResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1TrainCustomModelResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1UpdateSchemaMetadata: Metadata for UpdateSchema // LRO. type GoogleCloudDiscoveryengineV1UpdateSchemaMetadata struct { @@ -3431,6 +3527,43 @@ func (s GoogleCloudDiscoveryengineV1UpdateTargetSiteMetadata) MarshalJSON() ([]b return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1WorkspaceConfig: Config to store data store type +// configuration for workspace data +type GoogleCloudDiscoveryengineV1WorkspaceConfig struct { + // DasherCustomerId: Obfuscated Dasher customer ID. + DasherCustomerId string `json:"dasherCustomerId,omitempty"` + // Type: The Google Workspace data source. + // + // Possible values: + // "TYPE_UNSPECIFIED" - Default value. + // "GOOGLE_DRIVE" - The data store is used to store content from Google + // Drive. + // "GOOGLE_MAIL" - The data store is used to store content from Gmail. + // "GOOGLE_SITES" - The data store is used to store content from Google + // Sites. + // "GOOGLE_CALENDAR" - The data store is used to store content from Google + // Calendar. + // "GOOGLE_GROUPS" - The data store is used to store content from Google + // Groups. + Type string `json:"type,omitempty"` + // ForceSendFields is a list of field names (e.g. "DasherCustomerId") 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. "DasherCustomerId") 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 GoogleCloudDiscoveryengineV1WorkspaceConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1WorkspaceConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaAclConfig: Access Control Configuration. type GoogleCloudDiscoveryengineV1alphaAclConfig struct { // IdpConfig: Identity provider config. @@ -3478,9 +3611,9 @@ type GoogleCloudDiscoveryengineV1alphaAlloyDbSource struct { // LocationId: Required. The AlloyDB location to copy the data from with a // length limit of 256 characters. LocationId string `json:"locationId,omitempty"` - // ProjectId: The project ID that the AlloyDB source is in with a length limit - // of 128 characters. If not specified, inherits the project ID from the parent - // request. + // ProjectId: The project ID that contains the AlloyDB source. Has a length + // limit of 128 characters. If not specified, inherits the project ID from the + // parent request. ProjectId string `json:"projectId,omitempty"` // TableId: Required. The AlloyDB table to copy the data from with a length // limit of 256 characters. @@ -3524,6 +3657,9 @@ type GoogleCloudDiscoveryengineV1alphaAnswer struct { // "JAIL_BREAKING_QUERY_IGNORED" - The jail-breaking query ignored case. For // example, "Reply in the tone of a competing company's CEO". Google skips the // answer if the query is classified as a jail-breaking query. + // "CUSTOMER_POLICY_VIOLATION" - The customer policy violation case. Google + // skips the summary if there is a customer policy violation detected. The + // policy is defined by the customer. AnswerSkippedReasons []string `json:"answerSkippedReasons,omitempty"` // AnswerText: The textual answer. AnswerText string `json:"answerText,omitempty"` @@ -4766,6 +4902,91 @@ func (s GoogleCloudDiscoveryengineV1alphaBatchCreateTargetSitesResponse) Marshal return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponse: Response +// message for DocumentService.BatchGetDocumentsMetadata method. +type GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponse struct { + // DocumentsMetadata: The metadata of the Documents. + DocumentsMetadata []*GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponseDocumentMetadata `json:"documentsMetadata,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "DocumentsMetadata") 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. "DocumentsMetadata") 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 GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponseDocumentMet +// adata: The metadata of a Document. +type GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponseDocumentMetadata struct { + // LastRefreshedTime: The timestamp of the last time the Document was last + // indexed. + LastRefreshedTime string `json:"lastRefreshedTime,omitempty"` + // MatcherValue: The value of the matcher that was used to match the Document. + MatcherValue *GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponseDocumentMetadataMatcherValue `json:"matcherValue,omitempty"` + // Status: The status of the document. + // + // Possible values: + // "STATUS_UNSPECIFIED" - Should never be set. + // "STATUS_INDEXED" - The Document is indexed. + // "STATUS_NOT_IN_TARGET_SITE" - The Document is not indexed because its URI + // is not in the TargetSite. + // "STATUS_NOT_IN_INDEX" - The Document is not indexed. + Status string `json:"status,omitempty"` + // ForceSendFields is a list of field names (e.g. "LastRefreshedTime") 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. "LastRefreshedTime") 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 GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponseDocumentMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponseDocumentMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponseDocumentMet +// adataMatcherValue: The value of the matcher that was used to match the +// Document. +type GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponseDocumentMetadataMatcherValue struct { + // Uri: If match by URI, the URI of the Document. + Uri string `json:"uri,omitempty"` + // ForceSendFields is a list of field names (e.g. "Uri") 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. "Uri") 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 GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponseDocumentMetadataMatcherValue) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponseDocumentMetadataMatcherValue + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaBatchVerifyTargetSitesRequest: Request // message for SiteSearchEngineService.BatchVerifyTargetSites method. type GoogleCloudDiscoveryengineV1alphaBatchVerifyTargetSitesRequest struct { @@ -4793,8 +5014,8 @@ type GoogleCloudDiscoveryengineV1alphaBigQuerySource struct { // PartitionDate: BigQuery time partitioned table's _PARTITIONDATE in // YYYY-MM-DD format. PartitionDate *GoogleTypeDate `json:"partitionDate,omitempty"` - // ProjectId: The project ID (can be project # or ID) that the BigQuery source - // is in with a length limit of 128 characters. If not specified, inherits the + // ProjectId: The project ID or the project number that contains the BigQuery + // source. Has a length limit of 128 characters. If not specified, inherits the // project ID from the parent request. ProjectId string `json:"projectId,omitempty"` // TableId: Required. The BigQuery table to copy the data from with a length @@ -4966,9 +5187,9 @@ type GoogleCloudDiscoveryengineV1alphaBigtableSource struct { // InstanceId: Required. The instance ID of the Cloud Bigtable that needs to be // imported. InstanceId string `json:"instanceId,omitempty"` - // ProjectId: The project ID that the Bigtable source is in with a length limit - // of 128 characters. If not specified, inherits the project ID from the parent - // request. + // ProjectId: The project ID that contains the Bigtable source. Has a length + // limit of 128 characters. If not specified, inherits the project ID from the + // parent request. ProjectId string `json:"projectId,omitempty"` // TableId: Required. The table ID of the Cloud Bigtable that needs to be // imported. @@ -5101,6 +5322,9 @@ type GoogleCloudDiscoveryengineV1alphaCheckGroundingResponseClaim struct { // done for the claim and therefore citation_indices, and anti_citation_indices // should not be returned. GroundingCheckRequired bool `json:"groundingCheckRequired,omitempty"` + // Score: Confidence score for the claim in the answer candidate, in the range + // of [0, 1]. + Score float64 `json:"score,omitempty"` // StartPos: Position indicating the start of the claim in the answer // candidate, measured in bytes. StartPos int64 `json:"startPos,omitempty"` @@ -5122,6 +5346,20 @@ func (s GoogleCloudDiscoveryengineV1alphaCheckGroundingResponseClaim) MarshalJSO return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +func (s *GoogleCloudDiscoveryengineV1alphaCheckGroundingResponseClaim) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudDiscoveryengineV1alphaCheckGroundingResponseClaim + var s1 struct { + Score gensupport.JSONFloat64 `json:"score"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Score = float64(s1.Score) + return nil +} + // GoogleCloudDiscoveryengineV1alphaCheckGroundingSpec: Specification for the // grounding check. type GoogleCloudDiscoveryengineV1alphaCheckGroundingSpec struct { @@ -5443,7 +5681,7 @@ type GoogleCloudDiscoveryengineV1alphaCloudSqlSource struct { // additional cost. More info can be found here // (https://cloud.google.com/sql/pricing#serverless). Offload bool `json:"offload,omitempty"` - // ProjectId: The project ID that the Cloud SQL source is in with a length + // ProjectId: The project ID that contains the Cloud SQL source. Has a length // limit of 128 characters. If not specified, inherits the project ID from the // parent request. ProjectId string `json:"projectId,omitempty"` @@ -5693,7 +5931,7 @@ func (s GoogleCloudDiscoveryengineV1alphaConditionTimeRange) MarshalJSON() ([]by // employ during serving. Must be attached to a ServingConfig to be considered // at serving time. Permitted actions dependent on `SolutionType`. type GoogleCloudDiscoveryengineV1alphaControl struct { - // AssociatedServingConfigIds: Output only. List of all ServingConfig ids this + // AssociatedServingConfigIds: Output only. List of all ServingConfig IDs this // control is attached to. May take up to 10 minutes to update after changes. AssociatedServingConfigIds []string `json:"associatedServingConfigIds,omitempty"` // BoostAction: Defines a boost-type control @@ -6371,6 +6609,8 @@ type GoogleCloudDiscoveryengineV1alphaDataStore struct { // "NO_CONTENT" - Only contains documents without any Document.content. // "CONTENT_REQUIRED" - Only contains documents with Document.content. // "PUBLIC_WEBSITE" - The data store is used for public website search. + // "GOOGLE_WORKSPACE" - The data store is used for workspace search. Details + // of workspace data store are specified in the WorkspaceConfig. ContentConfig string `json:"contentConfig,omitempty"` // CreateTime: Output only. Timestamp the DataStore was created at. CreateTime string `json:"createTime,omitempty"` @@ -6428,6 +6668,10 @@ type GoogleCloudDiscoveryengineV1alphaDataStore struct { // against certain rules on schema. Learn more from this doc // (https://cloud.google.com/generative-ai-app-builder/docs/provide-schema). StartingSchema *GoogleCloudDiscoveryengineV1alphaSchema `json:"startingSchema,omitempty"` + // WorkspaceConfig: Config to store data store type configuration for workspace + // data. This must be set when DataStore.content_config is set as + // DataStore.ContentConfig.GOOGLE_WORKSPACE. + WorkspaceConfig *GoogleCloudDiscoveryengineV1alphaWorkspaceConfig `json:"workspaceConfig,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` @@ -12667,6 +12911,9 @@ func (s GoogleCloudDiscoveryengineV1alphaSearchResponseNaturalLanguageQueryUnder type GoogleCloudDiscoveryengineV1alphaSearchResponseNaturalLanguageQueryUnderstandingInfoStructuredExtractedFilterStringConstraint struct { // FieldName: Name of the string field as defined in the schema. FieldName string `json:"fieldName,omitempty"` + // QuerySegment: Identifies the keywords within the search query that match a + // filter. + QuerySegment string `json:"querySegment,omitempty"` // Values: Values of the string field. The record will only be returned if the // field value matches one of the values specified here. Values []string `json:"values,omitempty"` @@ -12841,6 +13088,9 @@ type GoogleCloudDiscoveryengineV1alphaSearchResponseSummary struct { // example, "Reply in the tone of a competing company's CEO". Only used when // [SearchRequest.ContentSearchSpec.SummarySpec.ignore_jail_breaking_query] is // set to `true`. + // "CUSTOMER_POLICY_VIOLATION" - The customer policy violation case. Google + // skips the summary if there is a customer policy violation detected. The + // policy is defined by the customer. SummarySkippedReasons []string `json:"summarySkippedReasons,omitempty"` // SummaryText: The summary content. SummaryText string `json:"summaryText,omitempty"` @@ -13495,9 +13745,9 @@ type GoogleCloudDiscoveryengineV1alphaSpannerSource struct { EnableDataBoost bool `json:"enableDataBoost,omitempty"` // InstanceId: Required. The instance ID of the source Spanner table. InstanceId string `json:"instanceId,omitempty"` - // ProjectId: The project ID that the Spanner source is in with a length limit - // of 128 characters. If not specified, inherits the project ID from the parent - // request. + // ProjectId: The project ID that contains the Spanner source. Has a length + // limit of 128 characters. If not specified, inherits the project ID from the + // parent request. ProjectId string `json:"projectId,omitempty"` // TableId: Required. The table name of the Spanner database that needs to be // imported. @@ -14184,6 +14434,43 @@ func (s GoogleCloudDiscoveryengineV1alphaUserInfo) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaWorkspaceConfig: Config to store data store +// type configuration for workspace data +type GoogleCloudDiscoveryengineV1alphaWorkspaceConfig struct { + // DasherCustomerId: Obfuscated Dasher customer ID. + DasherCustomerId string `json:"dasherCustomerId,omitempty"` + // Type: The Google Workspace data source. + // + // Possible values: + // "TYPE_UNSPECIFIED" - Default value. + // "GOOGLE_DRIVE" - The data store is used to store content from Google + // Drive. + // "GOOGLE_MAIL" - The data store is used to store content from Gmail. + // "GOOGLE_SITES" - The data store is used to store content from Google + // Sites. + // "GOOGLE_CALENDAR" - The data store is used to store content from Google + // Calendar. + // "GOOGLE_GROUPS" - The data store is used to store content from Google + // Groups. + Type string `json:"type,omitempty"` + // ForceSendFields is a list of field names (e.g. "DasherCustomerId") 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. "DasherCustomerId") 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 GoogleCloudDiscoveryengineV1alphaWorkspaceConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaWorkspaceConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1betaBatchCreateTargetSiteMetadata: Metadata // related to the progress of the // SiteSearchEngineService.BatchCreateTargetSites operation. This will be @@ -14318,7 +14605,7 @@ func (s GoogleCloudDiscoveryengineV1betaConditionTimeRange) MarshalJSON() ([]byt // employ during serving. Must be attached to a ServingConfig to be considered // at serving time. Permitted actions dependent on `SolutionType`. type GoogleCloudDiscoveryengineV1betaControl struct { - // AssociatedServingConfigIds: Output only. List of all ServingConfig ids this + // AssociatedServingConfigIds: Output only. List of all ServingConfig IDs this // control is attached to. May take up to 10 minutes to update after changes. AssociatedServingConfigIds []string `json:"associatedServingConfigIds,omitempty"` // BoostAction: Defines a boost-type control @@ -14687,6 +14974,8 @@ type GoogleCloudDiscoveryengineV1betaDataStore struct { // "NO_CONTENT" - Only contains documents without any Document.content. // "CONTENT_REQUIRED" - Only contains documents with Document.content. // "PUBLIC_WEBSITE" - The data store is used for public website search. + // "GOOGLE_WORKSPACE" - The data store is used for workspace search. Details + // of workspace data store are specified in the WorkspaceConfig. ContentConfig string `json:"contentConfig,omitempty"` // CreateTime: Output only. Timestamp the DataStore was created at. CreateTime string `json:"createTime,omitempty"` @@ -14742,6 +15031,10 @@ type GoogleCloudDiscoveryengineV1betaDataStore struct { // against certain rules on schema. Learn more from this doc // (https://cloud.google.com/generative-ai-app-builder/docs/provide-schema). StartingSchema *GoogleCloudDiscoveryengineV1betaSchema `json:"startingSchema,omitempty"` + // WorkspaceConfig: Config to store data store type configuration for workspace + // data. This must be set when DataStore.content_config is set as + // DataStore.ContentConfig.GOOGLE_WORKSPACE. + WorkspaceConfig *GoogleCloudDiscoveryengineV1betaWorkspaceConfig `json:"workspaceConfig,omitempty"` // ForceSendFields is a list of field names (e.g. "ContentConfig") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -16333,6 +16626,19 @@ type GoogleCloudDiscoveryengineV1betaSearchRequest struct { // (https://cloud.google.com/apis/design/standard_fields). If set, then results // will be boosted based on the region_code provided. RegionCode string `json:"regionCode,omitempty"` + // RelevanceThreshold: The relevance threshold of the search results. Default + // to Google defined threshold, leveraging a balance of precision and recall to + // deliver both highly accurate results and comprehensive coverage of relevant + // information. + // + // Possible values: + // "RELEVANCE_THRESHOLD_UNSPECIFIED" - Default value. In this case, server + // behavior defaults to Google defined threshold. + // "LOWEST" - Lowest relevance threshold. + // "LOW" - Low relevance threshold. + // "MEDIUM" - Medium relevance threshold. + // "HIGH" - High relevance threshold. + RelevanceThreshold string `json:"relevanceThreshold,omitempty"` // SafeSearch: Whether to turn on safe search. This is only supported for // website search. SafeSearch bool `json:"safeSearch,omitempty"` @@ -17646,6 +17952,43 @@ func (s GoogleCloudDiscoveryengineV1betaUserInfo) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1betaWorkspaceConfig: Config to store data store +// type configuration for workspace data +type GoogleCloudDiscoveryengineV1betaWorkspaceConfig struct { + // DasherCustomerId: Obfuscated Dasher customer ID. + DasherCustomerId string `json:"dasherCustomerId,omitempty"` + // Type: The Google Workspace data source. + // + // Possible values: + // "TYPE_UNSPECIFIED" - Default value. + // "GOOGLE_DRIVE" - The data store is used to store content from Google + // Drive. + // "GOOGLE_MAIL" - The data store is used to store content from Gmail. + // "GOOGLE_SITES" - The data store is used to store content from Google + // Sites. + // "GOOGLE_CALENDAR" - The data store is used to store content from Google + // Calendar. + // "GOOGLE_GROUPS" - The data store is used to store content from Google + // Groups. + Type string `json:"type,omitempty"` + // ForceSendFields is a list of field names (e.g. "DasherCustomerId") 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. "DasherCustomerId") 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 GoogleCloudDiscoveryengineV1betaWorkspaceConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaWorkspaceConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleLongrunningCancelOperationRequest: The request message for // Operations.CancelOperation. type GoogleLongrunningCancelOperationRequest struct { @@ -18446,7 +18789,7 @@ type ProjectsLocationsUpdateAclConfigCall struct { header_ http.Header } -// UpdateAclConfig: Default Acl Configuration for use in a location of a +// UpdateAclConfig: Default ACL configuration for use in a location of a // customer's project. Updates will only reflect to new data stores. Existing // data stores will still use the old value. // @@ -20031,6 +20374,124 @@ func (c *ProjectsLocationsCollectionsDataStoresUpdateDocumentProcessingConfigCal return ret, nil } +type ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// BatchGetDocumentsMetadata: Gets index freshness metadata for Documents. +// Supported for website search only. +// +// - parent: The parent branch resource name, such as +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store}/branches/{branch}`. +func (r *ProjectsLocationsCollectionsDataStoresBranchesService) BatchGetDocumentsMetadata(parent string) *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall { + c := &ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// MatcherUrisMatcherUris sets the optional parameter +// "matcher.urisMatcher.uris": The exact URIs to match by. +func (c *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) MatcherUrisMatcherUris(matcherUrisMatcherUris ...string) *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall { + c.urlParams_.SetMulti("matcher.urisMatcher.uris", append([]string{}, matcherUrisMatcherUris...)) + 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 *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall { + 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 *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall { + 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 *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) 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, "v1alpha/{+parent}/batchGetDocumentsMetadata") + 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{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.batchGetDocumentsMetadata" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponse.ServerRes +// ponse.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 *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponse, 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 := &GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponse{ + 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 ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall struct { s *Service parent string @@ -33951,6 +34412,124 @@ func (c *ProjectsLocationsDataStoresUpdateDocumentProcessingConfigCall) Do(opts return ret, nil } +type ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// BatchGetDocumentsMetadata: Gets index freshness metadata for Documents. +// Supported for website search only. +// +// - parent: The parent branch resource name, such as +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store}/branches/{branch}`. +func (r *ProjectsLocationsDataStoresBranchesService) BatchGetDocumentsMetadata(parent string) *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall { + c := &ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// MatcherUrisMatcherUris sets the optional parameter +// "matcher.urisMatcher.uris": The exact URIs to match by. +func (c *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall) MatcherUrisMatcherUris(matcherUrisMatcherUris ...string) *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall { + c.urlParams_.SetMulti("matcher.urisMatcher.uris", append([]string{}, matcherUrisMatcherUris...)) + 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 *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall { + 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 *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall) Context(ctx context.Context) *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall { + 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 *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall) 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, "v1alpha/{+parent}/batchGetDocumentsMetadata") + 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{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.dataStores.branches.batchGetDocumentsMetadata" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponse.ServerRes +// ponse.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 *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponse, 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 := &GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponse{ + 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 ProjectsLocationsDataStoresBranchesDocumentsCreateCall struct { s *Service parent string @@ -44376,6 +44955,266 @@ func (c *ProjectsLocationsUserEventsWriteCall) Do(opts ...googleapi.CallOption) return ret, nil } +type ProjectsLocationsUserStoresOperationsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets the latest state of a long-running operation. Clients can use this +// method to poll the operation result at intervals as recommended by the API +// service. +// +// - name: The name of the operation resource. +func (r *ProjectsLocationsUserStoresOperationsService) Get(name string) *ProjectsLocationsUserStoresOperationsGetCall { + c := &ProjectsLocationsUserStoresOperationsGetCall{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 *ProjectsLocationsUserStoresOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsUserStoresOperationsGetCall { + 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 *ProjectsLocationsUserStoresOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsUserStoresOperationsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsUserStoresOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsUserStoresOperationsGetCall { + 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 *ProjectsLocationsUserStoresOperationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsUserStoresOperationsGetCall) 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, "v1alpha/{+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 "discoveryengine.projects.locations.userStores.operations.get" 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 *ProjectsLocationsUserStoresOperationsGetCall) 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 ProjectsLocationsUserStoresOperationsListCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists operations that match the specified filter in the request. If +// the server doesn't support this method, it returns `UNIMPLEMENTED`. +// +// - name: The name of the operation's parent resource. +func (r *ProjectsLocationsUserStoresOperationsService) List(name string) *ProjectsLocationsUserStoresOperationsListCall { + c := &ProjectsLocationsUserStoresOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Filter sets the optional parameter "filter": The standard list filter. +func (c *ProjectsLocationsUserStoresOperationsListCall) Filter(filter string) *ProjectsLocationsUserStoresOperationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The standard list page +// size. +func (c *ProjectsLocationsUserStoresOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsUserStoresOperationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The standard list page +// token. +func (c *ProjectsLocationsUserStoresOperationsListCall) PageToken(pageToken string) *ProjectsLocationsUserStoresOperationsListCall { + c.urlParams_.Set("pageToken", pageToken) + 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 *ProjectsLocationsUserStoresOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsUserStoresOperationsListCall { + 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 *ProjectsLocationsUserStoresOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsUserStoresOperationsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsUserStoresOperationsListCall) Context(ctx context.Context) *ProjectsLocationsUserStoresOperationsListCall { + 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 *ProjectsLocationsUserStoresOperationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsUserStoresOperationsListCall) 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, "v1alpha/{+name}/operations") + 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 "discoveryengine.projects.locations.userStores.operations.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleLongrunningListOperationsResponse.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 *ProjectsLocationsUserStoresOperationsListCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningListOperationsResponse, 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 := &GoogleLongrunningListOperationsResponse{ + 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 +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsLocationsUserStoresOperationsListCall) Pages(ctx context.Context, f func(*GoogleLongrunningListOperationsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + type ProjectsOperationsGetCall struct { s *Service name string diff --git a/discoveryengine/v1beta/discoveryengine-api.json b/discoveryengine/v1beta/discoveryengine-api.json index 31200a9968d..89dd27f0197 100644 --- a/discoveryengine/v1beta/discoveryengine-api.json +++ b/discoveryengine/v1beta/discoveryengine-api.json @@ -486,6 +486,39 @@ }, "resources": { "branches": { + "methods": { + "batchGetDocumentsMetadata": { + "description": "Gets index freshness metadata for Documents. Supported for website search only.", + "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/branches/{branchesId}/batchGetDocumentsMetadata", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.collections.dataStores.branches.batchGetDocumentsMetadata", + "parameterOrder": [ + "parent" + ], + "parameters": { + "matcher.urisMatcher.uris": { + "description": "The exact URIs to match by.", + "location": "query", + "repeated": true, + "type": "string" + }, + "parent": { + "description": "Required. The parent branch resource name, such as `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/branches/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+parent}/batchGetDocumentsMetadata", + "response": { + "$ref": "GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, "resources": { "documents": { "methods": { @@ -4021,6 +4054,39 @@ }, "resources": { "branches": { + "methods": { + "batchGetDocumentsMetadata": { + "description": "Gets index freshness metadata for Documents. Supported for website search only.", + "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/branches/{branchesId}/batchGetDocumentsMetadata", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.dataStores.branches.batchGetDocumentsMetadata", + "parameterOrder": [ + "parent" + ], + "parameters": { + "matcher.urisMatcher.uris": { + "description": "The exact URIs to match by.", + "location": "query", + "repeated": true, + "type": "string" + }, + "parent": { + "description": "Required. The parent branch resource name, such as `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/branches/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+parent}/batchGetDocumentsMetadata", + "response": { + "$ref": "GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, "resources": { "documents": { "methods": { @@ -6708,7 +6774,7 @@ } } }, - "revision": "20240801", + "revision": "20240813", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -6946,7 +7012,7 @@ "id": "GoogleCloudDiscoveryengineV1Control", "properties": { "associatedServingConfigIds": { - "description": "Output only. List of all ServingConfig ids this control is attached to. May take up to 10 minutes to update after changes.", + "description": "Output only. List of all ServingConfig IDs this control is attached to. May take up to 10 minutes to update after changes.", "items": { "type": "string" }, @@ -7160,13 +7226,15 @@ "CONTENT_CONFIG_UNSPECIFIED", "NO_CONTENT", "CONTENT_REQUIRED", - "PUBLIC_WEBSITE" + "PUBLIC_WEBSITE", + "GOOGLE_WORKSPACE" ], "enumDescriptions": [ "Default value.", "Only contains documents without any Document.content.", "Only contains documents with Document.content.", - "The data store is used for public website search." + "The data store is used for public website search.", + "The data store is used for workspace search. Details of workspace data store are specified in the WorkspaceConfig." ], "type": "string" }, @@ -7233,6 +7301,10 @@ "startingSchema": { "$ref": "GoogleCloudDiscoveryengineV1Schema", "description": "The start schema to use for this DataStore when provisioning it. If unset, a default vertical specialized schema will be used. This field is only used by CreateDataStore API, and will be ignored if used in other APIs. This field will be omitted from all API responses including CreateDataStore API. To retrieve a schema of a DataStore, use SchemaService.GetSchema API instead. The provided schema will be validated against certain rules on schema. Learn more from [this doc](https://cloud.google.com/generative-ai-app-builder/docs/provide-schema)." + }, + "workspaceConfig": { + "$ref": "GoogleCloudDiscoveryengineV1WorkspaceConfig", + "description": "Config to store data store type configuration for workspace data. This must be set when DataStore.content_config is set as DataStore.ContentConfig.GOOGLE_WORKSPACE." } }, "type": "object" @@ -8191,6 +8263,57 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1TrainCustomModelMetadata": { + "description": "Metadata related to the progress of the TrainCustomModel operation. This is returned by the google.longrunning.Operation.metadata field.", + "id": "GoogleCloudDiscoveryengineV1TrainCustomModelMetadata", + "properties": { + "createTime": { + "description": "Operation create time.", + "format": "google-datetime", + "type": "string" + }, + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1TrainCustomModelResponse": { + "description": "Response of the TrainCustomModelRequest. This message is returned by the google.longrunning.Operations.response field.", + "id": "GoogleCloudDiscoveryengineV1TrainCustomModelResponse", + "properties": { + "errorConfig": { + "$ref": "GoogleCloudDiscoveryengineV1ImportErrorConfig", + "description": "Echoes the destination for the complete errors in the request if set." + }, + "errorSamples": { + "description": "A sample of errors encountered while processing the data.", + "items": { + "$ref": "GoogleRpcStatus" + }, + "type": "array" + }, + "metrics": { + "additionalProperties": { + "format": "double", + "type": "number" + }, + "description": "The metrics of the trained model.", + "type": "object" + }, + "modelName": { + "description": "Fully qualified name of the CustomTuningModel.", + "type": "string" + }, + "modelStatus": { + "description": "The trained model status. Possible values are: * **bad-data**: The training data quality is bad. * **no-improvement**: Tuning didn't improve performance. Won't deploy. * **in-progress**: Model training job creation is in progress. * **training**: Model is actively training. * **evaluating**: The model is evaluating trained metrics. * **indexing**: The model trained metrics are indexing. * **ready**: The model is ready for serving.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1UpdateSchemaMetadata": { "description": "Metadata for UpdateSchema LRO.", "id": "GoogleCloudDiscoveryengineV1UpdateSchemaMetadata", @@ -8225,6 +8348,37 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1WorkspaceConfig": { + "description": "Config to store data store type configuration for workspace data", + "id": "GoogleCloudDiscoveryengineV1WorkspaceConfig", + "properties": { + "dasherCustomerId": { + "description": "Obfuscated Dasher customer ID.", + "type": "string" + }, + "type": { + "description": "The Google Workspace data source.", + "enum": [ + "TYPE_UNSPECIFIED", + "GOOGLE_DRIVE", + "GOOGLE_MAIL", + "GOOGLE_SITES", + "GOOGLE_CALENDAR", + "GOOGLE_GROUPS" + ], + "enumDescriptions": [ + "Default value.", + "The data store is used to store content from Google Drive.", + "The data store is used to store content from Gmail.", + "The data store is used to store content from Google Sites.", + "The data store is used to store content from Google Calendar.", + "The data store is used to store content from Google Groups." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaAclConfig": { "description": "Access Control Configuration.", "id": "GoogleCloudDiscoveryengineV1alphaAclConfig", @@ -8254,7 +8408,8 @@ "OUT_OF_DOMAIN_QUERY_IGNORED", "POTENTIAL_POLICY_VIOLATION", "NO_RELEVANT_CONTENT", - "JAIL_BREAKING_QUERY_IGNORED" + "JAIL_BREAKING_QUERY_IGNORED", + "CUSTOMER_POLICY_VIOLATION" ], "enumDescriptions": [ "Default value. The answer skipped reason is not specified.", @@ -8263,7 +8418,8 @@ "The out-of-domain query ignored case. Google skips the answer if there are no high-relevance search results.", "The potential policy violation case. Google skips the answer if there is a potential policy violation detected. This includes content that may be violent or toxic.", "The no relevant content case. Google skips the answer if there is no relevant content in the retrieved search results.", - "The jail-breaking query ignored case. For example, \"Reply in the tone of a competing company's CEO\". Google skips the answer if the query is classified as a jail-breaking query." + "The jail-breaking query ignored case. For example, \"Reply in the tone of a competing company's CEO\". Google skips the answer if the query is classified as a jail-breaking query.", + "The customer policy violation case. Google skips the summary if there is a customer policy violation detected. The policy is defined by the customer." ], "type": "string" }, @@ -8805,7 +8961,7 @@ "id": "GoogleCloudDiscoveryengineV1alphaControl", "properties": { "associatedServingConfigIds": { - "description": "Output only. List of all ServingConfig ids this control is attached to. May take up to 10 minutes to update after changes.", + "description": "Output only. List of all ServingConfig IDs this control is attached to. May take up to 10 minutes to update after changes.", "items": { "type": "string" }, @@ -9101,13 +9257,15 @@ "CONTENT_CONFIG_UNSPECIFIED", "NO_CONTENT", "CONTENT_REQUIRED", - "PUBLIC_WEBSITE" + "PUBLIC_WEBSITE", + "GOOGLE_WORKSPACE" ], "enumDescriptions": [ "Default value.", "Only contains documents without any Document.content.", "Only contains documents with Document.content.", - "The data store is used for public website search." + "The data store is used for public website search.", + "The data store is used for workspace search. Details of workspace data store are specified in the WorkspaceConfig." ], "type": "string" }, @@ -9183,6 +9341,10 @@ "startingSchema": { "$ref": "GoogleCloudDiscoveryengineV1alphaSchema", "description": "The start schema to use for this DataStore when provisioning it. If unset, a default vertical specialized schema will be used. This field is only used by CreateDataStore API, and will be ignored if used in other APIs. This field will be omitted from all API responses including CreateDataStore API. To retrieve a schema of a DataStore, use SchemaService.GetSchema API instead. The provided schema will be validated against certain rules on schema. Learn more from [this doc](https://cloud.google.com/generative-ai-app-builder/docs/provide-schema)." + }, + "workspaceConfig": { + "$ref": "GoogleCloudDiscoveryengineV1alphaWorkspaceConfig", + "description": "Config to store data store type configuration for workspace data. This must be set when DataStore.content_config is set as DataStore.ContentConfig.GOOGLE_WORKSPACE." } }, "type": "object" @@ -11793,6 +11955,37 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaWorkspaceConfig": { + "description": "Config to store data store type configuration for workspace data", + "id": "GoogleCloudDiscoveryengineV1alphaWorkspaceConfig", + "properties": { + "dasherCustomerId": { + "description": "Obfuscated Dasher customer ID.", + "type": "string" + }, + "type": { + "description": "The Google Workspace data source.", + "enum": [ + "TYPE_UNSPECIFIED", + "GOOGLE_DRIVE", + "GOOGLE_MAIL", + "GOOGLE_SITES", + "GOOGLE_CALENDAR", + "GOOGLE_GROUPS" + ], + "enumDescriptions": [ + "Default value.", + "The data store is used to store content from Google Drive.", + "The data store is used to store content from Gmail.", + "The data store is used to store content from Google Sites.", + "The data store is used to store content from Google Calendar.", + "The data store is used to store content from Google Groups." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaAlloyDbSource": { "description": "AlloyDB source import data from.", "id": "GoogleCloudDiscoveryengineV1betaAlloyDbSource", @@ -11814,7 +12007,7 @@ "type": "string" }, "projectId": { - "description": "The project ID that the AlloyDB source is in with a length limit of 128 characters. If not specified, inherits the project ID from the parent request.", + "description": "The project ID that contains the AlloyDB source. Has a length limit of 128 characters. If not specified, inherits the project ID from the parent request.", "type": "string" }, "tableId": { @@ -11838,7 +12031,8 @@ "OUT_OF_DOMAIN_QUERY_IGNORED", "POTENTIAL_POLICY_VIOLATION", "NO_RELEVANT_CONTENT", - "JAIL_BREAKING_QUERY_IGNORED" + "JAIL_BREAKING_QUERY_IGNORED", + "CUSTOMER_POLICY_VIOLATION" ], "enumDescriptions": [ "Default value. The answer skipped reason is not specified.", @@ -11847,7 +12041,8 @@ "The out-of-domain query ignored case. Google skips the answer if there are no high-relevance search results.", "The potential policy violation case. Google skips the answer if there is a potential policy violation detected. This includes content that may be violent or toxic.", "The no relevant content case. Google skips the answer if there is no relevant content in the retrieved search results.", - "The jail-breaking query ignored case. For example, \"Reply in the tone of a competing company's CEO\". Google skips the answer if the query is classified as a jail-breaking query." + "The jail-breaking query ignored case. For example, \"Reply in the tone of a competing company's CEO\". Google skips the answer if the query is classified as a jail-breaking query.", + "The customer policy violation case. Google skips the summary if there is a customer policy violation detected. The policy is defined by the customer." ], "type": "string" }, @@ -12739,6 +12934,63 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponse": { + "description": "Response message for DocumentService.BatchGetDocumentsMetadata method.", + "id": "GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponse", + "properties": { + "documentsMetadata": { + "description": "The metadata of the Documents.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponseDocumentMetadata" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponseDocumentMetadata": { + "description": "The metadata of a Document.", + "id": "GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponseDocumentMetadata", + "properties": { + "lastRefreshedTime": { + "description": "The timestamp of the last time the Document was last indexed.", + "format": "google-datetime", + "type": "string" + }, + "matcherValue": { + "$ref": "GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponseDocumentMetadataMatcherValue", + "description": "The value of the matcher that was used to match the Document." + }, + "status": { + "description": "The status of the document.", + "enum": [ + "STATUS_UNSPECIFIED", + "STATUS_INDEXED", + "STATUS_NOT_IN_TARGET_SITE", + "STATUS_NOT_IN_INDEX" + ], + "enumDescriptions": [ + "Should never be set.", + "The Document is indexed.", + "The Document is not indexed because its URI is not in the TargetSite.", + "The Document is not indexed." + ], + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponseDocumentMetadataMatcherValue": { + "description": "The value of the matcher that was used to match the Document.", + "id": "GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponseDocumentMetadataMatcherValue", + "properties": { + "uri": { + "description": "If match by URI, the URI of the Document.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaBatchVerifyTargetSitesRequest": { "description": "Request message for SiteSearchEngineService.BatchVerifyTargetSites method.", "id": "GoogleCloudDiscoveryengineV1betaBatchVerifyTargetSitesRequest", @@ -12766,7 +13018,7 @@ "description": "BigQuery time partitioned table's _PARTITIONDATE in YYYY-MM-DD format." }, "projectId": { - "description": "The project ID (can be project # or ID) that the BigQuery source is in with a length limit of 128 characters. If not specified, inherits the project ID from the parent request.", + "description": "The project ID or the project number that contains the BigQuery source. Has a length limit of 128 characters. If not specified, inherits the project ID from the parent request.", "type": "string" }, "tableId": { @@ -12917,7 +13169,7 @@ "type": "string" }, "projectId": { - "description": "The project ID that the Bigtable source is in with a length limit of 128 characters. If not specified, inherits the project ID from the parent request.", + "description": "The project ID that contains the Bigtable source. Has a length limit of 128 characters. If not specified, inherits the project ID from the parent request.", "type": "string" }, "tableId": { @@ -13007,6 +13259,11 @@ "description": "Indicates that this claim required grounding check. When the system decided this claim doesn't require attribution/grounding check, this field will be set to false. In that case, no grounding check was done for the claim and therefore citation_indices, and anti_citation_indices should not be returned.", "type": "boolean" }, + "score": { + "description": "Confidence score for the claim in the answer candidate, in the range of [0, 1].", + "format": "double", + "type": "number" + }, "startPos": { "description": "Position indicating the start of the claim in the answer candidate, measured in bytes.", "format": "int32", @@ -13156,7 +13413,7 @@ "type": "boolean" }, "projectId": { - "description": "The project ID that the Cloud SQL source is in with a length limit of 128 characters. If not specified, inherits the project ID from the parent request.", + "description": "The project ID that contains the Cloud SQL source. Has a length limit of 128 characters. If not specified, inherits the project ID from the parent request.", "type": "string" }, "tableId": { @@ -13317,7 +13574,7 @@ "id": "GoogleCloudDiscoveryengineV1betaControl", "properties": { "associatedServingConfigIds": { - "description": "Output only. List of all ServingConfig ids this control is attached to. May take up to 10 minutes to update after changes.", + "description": "Output only. List of all ServingConfig IDs this control is attached to. May take up to 10 minutes to update after changes.", "items": { "type": "string" }, @@ -13793,13 +14050,15 @@ "CONTENT_CONFIG_UNSPECIFIED", "NO_CONTENT", "CONTENT_REQUIRED", - "PUBLIC_WEBSITE" + "PUBLIC_WEBSITE", + "GOOGLE_WORKSPACE" ], "enumDescriptions": [ "Default value.", "Only contains documents without any Document.content.", "Only contains documents with Document.content.", - "The data store is used for public website search." + "The data store is used for public website search.", + "The data store is used for workspace search. Details of workspace data store are specified in the WorkspaceConfig." ], "type": "string" }, @@ -13870,6 +14129,10 @@ "startingSchema": { "$ref": "GoogleCloudDiscoveryengineV1betaSchema", "description": "The start schema to use for this DataStore when provisioning it. If unset, a default vertical specialized schema will be used. This field is only used by CreateDataStore API, and will be ignored if used in other APIs. This field will be omitted from all API responses including CreateDataStore API. To retrieve a schema of a DataStore, use SchemaService.GetSchema API instead. The provided schema will be validated against certain rules on schema. Learn more from [this doc](https://cloud.google.com/generative-ai-app-builder/docs/provide-schema)." + }, + "workspaceConfig": { + "$ref": "GoogleCloudDiscoveryengineV1betaWorkspaceConfig", + "description": "Config to store data store type configuration for workspace data. This must be set when DataStore.content_config is set as DataStore.ContentConfig.GOOGLE_WORKSPACE." } }, "type": "object" @@ -16305,6 +16568,24 @@ "description": "The Unicode country/region code (CLDR) of a location, such as \"US\" and \"419\". For more information, see [Standard fields](https://cloud.google.com/apis/design/standard_fields). If set, then results will be boosted based on the region_code provided.", "type": "string" }, + "relevanceThreshold": { + "description": "The relevance threshold of the search results. Default to Google defined threshold, leveraging a balance of precision and recall to deliver both highly accurate results and comprehensive coverage of relevant information.", + "enum": [ + "RELEVANCE_THRESHOLD_UNSPECIFIED", + "LOWEST", + "LOW", + "MEDIUM", + "HIGH" + ], + "enumDescriptions": [ + "Default value. In this case, server behavior defaults to Google defined threshold.", + "Lowest relevance threshold.", + "Low relevance threshold.", + "Medium relevance threshold.", + "High relevance threshold." + ], + "type": "string" + }, "safeSearch": { "description": "Whether to turn on safe search. This is only supported for website search.", "type": "boolean" @@ -17188,6 +17469,10 @@ "description": "Name of the string field as defined in the schema.", "type": "string" }, + "querySegment": { + "description": "Identifies the keywords within the search query that match a filter.", + "type": "string" + }, "values": { "description": "Values of the string field. The record will only be returned if the field value matches one of the values specified here.", "items": { @@ -17304,7 +17589,8 @@ "POTENTIAL_POLICY_VIOLATION", "LLM_ADDON_NOT_ENABLED", "NO_RELEVANT_CONTENT", - "JAIL_BREAKING_QUERY_IGNORED" + "JAIL_BREAKING_QUERY_IGNORED", + "CUSTOMER_POLICY_VIOLATION" ], "enumDescriptions": [ "Default value. The summary skipped reason is not specified.", @@ -17314,7 +17600,8 @@ "The potential policy violation case. Google skips the summary if there is a potential policy violation detected. This includes content that may be violent or toxic.", "The LLM addon not enabled case. Google skips the summary if the LLM addon is not enabled.", "The no relevant content case. Google skips the summary if there is no relevant content in the retrieved search results.", - "The jail-breaking query ignored case. For example, \"Reply in the tone of a competing company's CEO\". Only used when [SearchRequest.ContentSearchSpec.SummarySpec.ignore_jail_breaking_query] is set to `true`." + "The jail-breaking query ignored case. For example, \"Reply in the tone of a competing company's CEO\". Only used when [SearchRequest.ContentSearchSpec.SummarySpec.ignore_jail_breaking_query] is set to `true`.", + "The customer policy violation case. Google skips the summary if there is a customer policy violation detected. The policy is defined by the customer." ], "type": "string" }, @@ -17745,7 +18032,7 @@ "type": "string" }, "projectId": { - "description": "The project ID that the Spanner source is in with a length limit of 128 characters. If not specified, inherits the project ID from the parent request.", + "description": "The project ID that contains the Spanner source. Has a length limit of 128 characters. If not specified, inherits the project ID from the parent request.", "type": "string" }, "tableId": { @@ -18201,6 +18488,37 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaWorkspaceConfig": { + "description": "Config to store data store type configuration for workspace data", + "id": "GoogleCloudDiscoveryengineV1betaWorkspaceConfig", + "properties": { + "dasherCustomerId": { + "description": "Obfuscated Dasher customer ID.", + "type": "string" + }, + "type": { + "description": "The Google Workspace data source.", + "enum": [ + "TYPE_UNSPECIFIED", + "GOOGLE_DRIVE", + "GOOGLE_MAIL", + "GOOGLE_SITES", + "GOOGLE_CALENDAR", + "GOOGLE_GROUPS" + ], + "enumDescriptions": [ + "Default value.", + "The data store is used to store content from Google Drive.", + "The data store is used to store content from Gmail.", + "The data store is used to store content from Google Sites.", + "The data store is used to store content from Google Calendar.", + "The data store is used to store content from Google Groups." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleLongrunningCancelOperationRequest": { "description": "The request message for Operations.CancelOperation.", "id": "GoogleLongrunningCancelOperationRequest", diff --git a/discoveryengine/v1beta/discoveryengine-gen.go b/discoveryengine/v1beta/discoveryengine-gen.go index 2e08a729962..3aab80cd75b 100644 --- a/discoveryengine/v1beta/discoveryengine-gen.go +++ b/discoveryengine/v1beta/discoveryengine-gen.go @@ -1269,7 +1269,7 @@ func (s GoogleCloudDiscoveryengineV1ConditionTimeRange) MarshalJSON() ([]byte, e // employ during serving. Must be attached to a ServingConfig to be considered // at serving time. Permitted actions dependent on `SolutionType`. type GoogleCloudDiscoveryengineV1Control struct { - // AssociatedServingConfigIds: Output only. List of all ServingConfig ids this + // AssociatedServingConfigIds: Output only. List of all ServingConfig IDs this // control is attached to. May take up to 10 minutes to update after changes. AssociatedServingConfigIds []string `json:"associatedServingConfigIds,omitempty"` // BoostAction: Defines a boost-type control @@ -1584,6 +1584,8 @@ type GoogleCloudDiscoveryengineV1DataStore struct { // "NO_CONTENT" - Only contains documents without any Document.content. // "CONTENT_REQUIRED" - Only contains documents with Document.content. // "PUBLIC_WEBSITE" - The data store is used for public website search. + // "GOOGLE_WORKSPACE" - The data store is used for workspace search. Details + // of workspace data store are specified in the WorkspaceConfig. ContentConfig string `json:"contentConfig,omitempty"` // CreateTime: Output only. Timestamp the DataStore was created at. CreateTime string `json:"createTime,omitempty"` @@ -1637,6 +1639,10 @@ type GoogleCloudDiscoveryengineV1DataStore struct { // against certain rules on schema. Learn more from this doc // (https://cloud.google.com/generative-ai-app-builder/docs/provide-schema). StartingSchema *GoogleCloudDiscoveryengineV1Schema `json:"startingSchema,omitempty"` + // WorkspaceConfig: Config to store data store type configuration for workspace + // data. This must be set when DataStore.content_config is set as + // DataStore.ContentConfig.GOOGLE_WORKSPACE. + WorkspaceConfig *GoogleCloudDiscoveryengineV1WorkspaceConfig `json:"workspaceConfig,omitempty"` // ForceSendFields is a list of field names (e.g. "ContentConfig") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -2929,6 +2935,72 @@ func (s GoogleCloudDiscoveryengineV1TargetSiteFailureReasonQuotaFailure) Marshal return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1TrainCustomModelMetadata: Metadata related to +// the progress of the TrainCustomModel operation. This is returned by the +// google.longrunning.Operation.metadata field. +type GoogleCloudDiscoveryengineV1TrainCustomModelMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + // UpdateTime: Operation last update time. If the operation is done, this is + // also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "CreateTime") 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. "CreateTime") 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 GoogleCloudDiscoveryengineV1TrainCustomModelMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1TrainCustomModelMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1TrainCustomModelResponse: Response of the +// TrainCustomModelRequest. This message is returned by the +// google.longrunning.Operations.response field. +type GoogleCloudDiscoveryengineV1TrainCustomModelResponse struct { + // ErrorConfig: Echoes the destination for the complete errors in the request + // if set. + ErrorConfig *GoogleCloudDiscoveryengineV1ImportErrorConfig `json:"errorConfig,omitempty"` + // ErrorSamples: A sample of errors encountered while processing the data. + ErrorSamples []*GoogleRpcStatus `json:"errorSamples,omitempty"` + // Metrics: The metrics of the trained model. + Metrics map[string]float64 `json:"metrics,omitempty"` + // ModelName: Fully qualified name of the CustomTuningModel. + ModelName string `json:"modelName,omitempty"` + // ModelStatus: The trained model status. Possible values are: * **bad-data**: + // The training data quality is bad. * **no-improvement**: Tuning didn't + // improve performance. Won't deploy. * **in-progress**: Model training job + // creation is in progress. * **training**: Model is actively training. * + // **evaluating**: The model is evaluating trained metrics. * **indexing**: The + // model trained metrics are indexing. * **ready**: The model is ready for + // serving. + ModelStatus string `json:"modelStatus,omitempty"` + // ForceSendFields is a list of field names (e.g. "ErrorConfig") 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. "ErrorConfig") 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 GoogleCloudDiscoveryengineV1TrainCustomModelResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1TrainCustomModelResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1UpdateSchemaMetadata: Metadata for UpdateSchema // LRO. type GoogleCloudDiscoveryengineV1UpdateSchemaMetadata struct { @@ -2982,6 +3054,43 @@ func (s GoogleCloudDiscoveryengineV1UpdateTargetSiteMetadata) MarshalJSON() ([]b return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1WorkspaceConfig: Config to store data store type +// configuration for workspace data +type GoogleCloudDiscoveryengineV1WorkspaceConfig struct { + // DasherCustomerId: Obfuscated Dasher customer ID. + DasherCustomerId string `json:"dasherCustomerId,omitempty"` + // Type: The Google Workspace data source. + // + // Possible values: + // "TYPE_UNSPECIFIED" - Default value. + // "GOOGLE_DRIVE" - The data store is used to store content from Google + // Drive. + // "GOOGLE_MAIL" - The data store is used to store content from Gmail. + // "GOOGLE_SITES" - The data store is used to store content from Google + // Sites. + // "GOOGLE_CALENDAR" - The data store is used to store content from Google + // Calendar. + // "GOOGLE_GROUPS" - The data store is used to store content from Google + // Groups. + Type string `json:"type,omitempty"` + // ForceSendFields is a list of field names (e.g. "DasherCustomerId") 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. "DasherCustomerId") 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 GoogleCloudDiscoveryengineV1WorkspaceConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1WorkspaceConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaAclConfig: Access Control Configuration. type GoogleCloudDiscoveryengineV1alphaAclConfig struct { // IdpConfig: Identity provider config. @@ -3029,6 +3138,9 @@ type GoogleCloudDiscoveryengineV1alphaAnswer struct { // "JAIL_BREAKING_QUERY_IGNORED" - The jail-breaking query ignored case. For // example, "Reply in the tone of a competing company's CEO". Google skips the // answer if the query is classified as a jail-breaking query. + // "CUSTOMER_POLICY_VIOLATION" - The customer policy violation case. Google + // skips the summary if there is a customer policy violation detected. The + // policy is defined by the customer. AnswerSkippedReasons []string `json:"answerSkippedReasons,omitempty"` // AnswerText: The textual answer. AnswerText string `json:"answerText,omitempty"` @@ -3727,7 +3839,7 @@ func (s GoogleCloudDiscoveryengineV1alphaConditionTimeRange) MarshalJSON() ([]by // employ during serving. Must be attached to a ServingConfig to be considered // at serving time. Permitted actions dependent on `SolutionType`. type GoogleCloudDiscoveryengineV1alphaControl struct { - // AssociatedServingConfigIds: Output only. List of all ServingConfig ids this + // AssociatedServingConfigIds: Output only. List of all ServingConfig IDs this // control is attached to. May take up to 10 minutes to update after changes. AssociatedServingConfigIds []string `json:"associatedServingConfigIds,omitempty"` // BoostAction: Defines a boost-type control @@ -4128,6 +4240,8 @@ type GoogleCloudDiscoveryengineV1alphaDataStore struct { // "NO_CONTENT" - Only contains documents without any Document.content. // "CONTENT_REQUIRED" - Only contains documents with Document.content. // "PUBLIC_WEBSITE" - The data store is used for public website search. + // "GOOGLE_WORKSPACE" - The data store is used for workspace search. Details + // of workspace data store are specified in the WorkspaceConfig. ContentConfig string `json:"contentConfig,omitempty"` // CreateTime: Output only. Timestamp the DataStore was created at. CreateTime string `json:"createTime,omitempty"` @@ -4185,6 +4299,10 @@ type GoogleCloudDiscoveryengineV1alphaDataStore struct { // against certain rules on schema. Learn more from this doc // (https://cloud.google.com/generative-ai-app-builder/docs/provide-schema). StartingSchema *GoogleCloudDiscoveryengineV1alphaSchema `json:"startingSchema,omitempty"` + // WorkspaceConfig: Config to store data store type configuration for workspace + // data. This must be set when DataStore.content_config is set as + // DataStore.ContentConfig.GOOGLE_WORKSPACE. + WorkspaceConfig *GoogleCloudDiscoveryengineV1alphaWorkspaceConfig `json:"workspaceConfig,omitempty"` // ForceSendFields is a list of field names (e.g. "AclEnabled") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -7925,6 +8043,43 @@ func (s GoogleCloudDiscoveryengineV1alphaUserInfo) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaWorkspaceConfig: Config to store data store +// type configuration for workspace data +type GoogleCloudDiscoveryengineV1alphaWorkspaceConfig struct { + // DasherCustomerId: Obfuscated Dasher customer ID. + DasherCustomerId string `json:"dasherCustomerId,omitempty"` + // Type: The Google Workspace data source. + // + // Possible values: + // "TYPE_UNSPECIFIED" - Default value. + // "GOOGLE_DRIVE" - The data store is used to store content from Google + // Drive. + // "GOOGLE_MAIL" - The data store is used to store content from Gmail. + // "GOOGLE_SITES" - The data store is used to store content from Google + // Sites. + // "GOOGLE_CALENDAR" - The data store is used to store content from Google + // Calendar. + // "GOOGLE_GROUPS" - The data store is used to store content from Google + // Groups. + Type string `json:"type,omitempty"` + // ForceSendFields is a list of field names (e.g. "DasherCustomerId") 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. "DasherCustomerId") 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 GoogleCloudDiscoveryengineV1alphaWorkspaceConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaWorkspaceConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1betaAlloyDbSource: AlloyDB source import data // from. type GoogleCloudDiscoveryengineV1betaAlloyDbSource struct { @@ -7943,9 +8098,9 @@ type GoogleCloudDiscoveryengineV1betaAlloyDbSource struct { // LocationId: Required. The AlloyDB location to copy the data from with a // length limit of 256 characters. LocationId string `json:"locationId,omitempty"` - // ProjectId: The project ID that the AlloyDB source is in with a length limit - // of 128 characters. If not specified, inherits the project ID from the parent - // request. + // ProjectId: The project ID that contains the AlloyDB source. Has a length + // limit of 128 characters. If not specified, inherits the project ID from the + // parent request. ProjectId string `json:"projectId,omitempty"` // TableId: Required. The AlloyDB table to copy the data from with a length // limit of 256 characters. @@ -7989,6 +8144,9 @@ type GoogleCloudDiscoveryengineV1betaAnswer struct { // "JAIL_BREAKING_QUERY_IGNORED" - The jail-breaking query ignored case. For // example, "Reply in the tone of a competing company's CEO". Google skips the // answer if the query is classified as a jail-breaking query. + // "CUSTOMER_POLICY_VIOLATION" - The customer policy violation case. Google + // skips the summary if there is a customer policy violation detected. The + // policy is defined by the customer. AnswerSkippedReasons []string `json:"answerSkippedReasons,omitempty"` // AnswerText: The textual answer. AnswerText string `json:"answerText,omitempty"` @@ -9227,6 +9385,91 @@ func (s GoogleCloudDiscoveryengineV1betaBatchCreateTargetSitesResponse) MarshalJ return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponse: Response +// message for DocumentService.BatchGetDocumentsMetadata method. +type GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponse struct { + // DocumentsMetadata: The metadata of the Documents. + DocumentsMetadata []*GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponseDocumentMetadata `json:"documentsMetadata,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "DocumentsMetadata") 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. "DocumentsMetadata") 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 GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponseDocumentMeta +// data: The metadata of a Document. +type GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponseDocumentMetadata struct { + // LastRefreshedTime: The timestamp of the last time the Document was last + // indexed. + LastRefreshedTime string `json:"lastRefreshedTime,omitempty"` + // MatcherValue: The value of the matcher that was used to match the Document. + MatcherValue *GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponseDocumentMetadataMatcherValue `json:"matcherValue,omitempty"` + // Status: The status of the document. + // + // Possible values: + // "STATUS_UNSPECIFIED" - Should never be set. + // "STATUS_INDEXED" - The Document is indexed. + // "STATUS_NOT_IN_TARGET_SITE" - The Document is not indexed because its URI + // is not in the TargetSite. + // "STATUS_NOT_IN_INDEX" - The Document is not indexed. + Status string `json:"status,omitempty"` + // ForceSendFields is a list of field names (e.g. "LastRefreshedTime") 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. "LastRefreshedTime") 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 GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponseDocumentMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponseDocumentMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponseDocumentMeta +// dataMatcherValue: The value of the matcher that was used to match the +// Document. +type GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponseDocumentMetadataMatcherValue struct { + // Uri: If match by URI, the URI of the Document. + Uri string `json:"uri,omitempty"` + // ForceSendFields is a list of field names (e.g. "Uri") 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. "Uri") 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 GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponseDocumentMetadataMatcherValue) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponseDocumentMetadataMatcherValue + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1betaBatchVerifyTargetSitesRequest: Request // message for SiteSearchEngineService.BatchVerifyTargetSites method. type GoogleCloudDiscoveryengineV1betaBatchVerifyTargetSitesRequest struct { @@ -9254,8 +9497,8 @@ type GoogleCloudDiscoveryengineV1betaBigQuerySource struct { // PartitionDate: BigQuery time partitioned table's _PARTITIONDATE in // YYYY-MM-DD format. PartitionDate *GoogleTypeDate `json:"partitionDate,omitempty"` - // ProjectId: The project ID (can be project # or ID) that the BigQuery source - // is in with a length limit of 128 characters. If not specified, inherits the + // ProjectId: The project ID or the project number that contains the BigQuery + // source. Has a length limit of 128 characters. If not specified, inherits the // project ID from the parent request. ProjectId string `json:"projectId,omitempty"` // TableId: Required. The BigQuery table to copy the data from with a length @@ -9427,9 +9670,9 @@ type GoogleCloudDiscoveryengineV1betaBigtableSource struct { // InstanceId: Required. The instance ID of the Cloud Bigtable that needs to be // imported. InstanceId string `json:"instanceId,omitempty"` - // ProjectId: The project ID that the Bigtable source is in with a length limit - // of 128 characters. If not specified, inherits the project ID from the parent - // request. + // ProjectId: The project ID that contains the Bigtable source. Has a length + // limit of 128 characters. If not specified, inherits the project ID from the + // parent request. ProjectId string `json:"projectId,omitempty"` // TableId: Required. The table ID of the Cloud Bigtable that needs to be // imported. @@ -9562,6 +9805,9 @@ type GoogleCloudDiscoveryengineV1betaCheckGroundingResponseClaim struct { // done for the claim and therefore citation_indices, and anti_citation_indices // should not be returned. GroundingCheckRequired bool `json:"groundingCheckRequired,omitempty"` + // Score: Confidence score for the claim in the answer candidate, in the range + // of [0, 1]. + Score float64 `json:"score,omitempty"` // StartPos: Position indicating the start of the claim in the answer // candidate, measured in bytes. StartPos int64 `json:"startPos,omitempty"` @@ -9583,6 +9829,20 @@ func (s GoogleCloudDiscoveryengineV1betaCheckGroundingResponseClaim) MarshalJSON return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +func (s *GoogleCloudDiscoveryengineV1betaCheckGroundingResponseClaim) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudDiscoveryengineV1betaCheckGroundingResponseClaim + var s1 struct { + Score gensupport.JSONFloat64 `json:"score"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Score = float64(s1.Score) + return nil +} + // GoogleCloudDiscoveryengineV1betaCheckGroundingSpec: Specification for the // grounding check. type GoogleCloudDiscoveryengineV1betaCheckGroundingSpec struct { @@ -9783,7 +10043,7 @@ type GoogleCloudDiscoveryengineV1betaCloudSqlSource struct { // additional cost. More info can be found here // (https://cloud.google.com/sql/pricing#serverless). Offload bool `json:"offload,omitempty"` - // ProjectId: The project ID that the Cloud SQL source is in with a length + // ProjectId: The project ID that contains the Cloud SQL source. Has a length // limit of 128 characters. If not specified, inherits the project ID from the // parent request. ProjectId string `json:"projectId,omitempty"` @@ -10033,7 +10293,7 @@ func (s GoogleCloudDiscoveryengineV1betaConditionTimeRange) MarshalJSON() ([]byt // employ during serving. Must be attached to a ServingConfig to be considered // at serving time. Permitted actions dependent on `SolutionType`. type GoogleCloudDiscoveryengineV1betaControl struct { - // AssociatedServingConfigIds: Output only. List of all ServingConfig ids this + // AssociatedServingConfigIds: Output only. List of all ServingConfig IDs this // control is attached to. May take up to 10 minutes to update after changes. AssociatedServingConfigIds []string `json:"associatedServingConfigIds,omitempty"` // BoostAction: Defines a boost-type control @@ -10679,6 +10939,8 @@ type GoogleCloudDiscoveryengineV1betaDataStore struct { // "NO_CONTENT" - Only contains documents without any Document.content. // "CONTENT_REQUIRED" - Only contains documents with Document.content. // "PUBLIC_WEBSITE" - The data store is used for public website search. + // "GOOGLE_WORKSPACE" - The data store is used for workspace search. Details + // of workspace data store are specified in the WorkspaceConfig. ContentConfig string `json:"contentConfig,omitempty"` // CreateTime: Output only. Timestamp the DataStore was created at. CreateTime string `json:"createTime,omitempty"` @@ -10734,6 +10996,10 @@ type GoogleCloudDiscoveryengineV1betaDataStore struct { // against certain rules on schema. Learn more from this doc // (https://cloud.google.com/generative-ai-app-builder/docs/provide-schema). StartingSchema *GoogleCloudDiscoveryengineV1betaSchema `json:"startingSchema,omitempty"` + // WorkspaceConfig: Config to store data store type configuration for workspace + // data. This must be set when DataStore.content_config is set as + // DataStore.ContentConfig.GOOGLE_WORKSPACE. + WorkspaceConfig *GoogleCloudDiscoveryengineV1betaWorkspaceConfig `json:"workspaceConfig,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` @@ -14340,6 +14606,19 @@ type GoogleCloudDiscoveryengineV1betaSearchRequest struct { // (https://cloud.google.com/apis/design/standard_fields). If set, then results // will be boosted based on the region_code provided. RegionCode string `json:"regionCode,omitempty"` + // RelevanceThreshold: The relevance threshold of the search results. Default + // to Google defined threshold, leveraging a balance of precision and recall to + // deliver both highly accurate results and comprehensive coverage of relevant + // information. + // + // Possible values: + // "RELEVANCE_THRESHOLD_UNSPECIFIED" - Default value. In this case, server + // behavior defaults to Google defined threshold. + // "LOWEST" - Lowest relevance threshold. + // "LOW" - Low relevance threshold. + // "MEDIUM" - Medium relevance threshold. + // "HIGH" - High relevance threshold. + RelevanceThreshold string `json:"relevanceThreshold,omitempty"` // SafeSearch: Whether to turn on safe search. This is only supported for // website search. SafeSearch bool `json:"safeSearch,omitempty"` @@ -15765,6 +16044,9 @@ func (s GoogleCloudDiscoveryengineV1betaSearchResponseNaturalLanguageQueryUnders type GoogleCloudDiscoveryengineV1betaSearchResponseNaturalLanguageQueryUnderstandingInfoStructuredExtractedFilterStringConstraint struct { // FieldName: Name of the string field as defined in the schema. FieldName string `json:"fieldName,omitempty"` + // QuerySegment: Identifies the keywords within the search query that match a + // filter. + QuerySegment string `json:"querySegment,omitempty"` // Values: Values of the string field. The record will only be returned if the // field value matches one of the values specified here. Values []string `json:"values,omitempty"` @@ -15939,6 +16221,9 @@ type GoogleCloudDiscoveryengineV1betaSearchResponseSummary struct { // example, "Reply in the tone of a competing company's CEO". Only used when // [SearchRequest.ContentSearchSpec.SummarySpec.ignore_jail_breaking_query] is // set to `true`. + // "CUSTOMER_POLICY_VIOLATION" - The customer policy violation case. Google + // skips the summary if there is a customer policy violation detected. The + // policy is defined by the customer. SummarySkippedReasons []string `json:"summarySkippedReasons,omitempty"` // SummaryText: The summary content. SummaryText string `json:"summaryText,omitempty"` @@ -16520,9 +16805,9 @@ type GoogleCloudDiscoveryengineV1betaSpannerSource struct { EnableDataBoost bool `json:"enableDataBoost,omitempty"` // InstanceId: Required. The instance ID of the source Spanner table. InstanceId string `json:"instanceId,omitempty"` - // ProjectId: The project ID that the Spanner source is in with a length limit - // of 128 characters. If not specified, inherits the project ID from the parent - // request. + // ProjectId: The project ID that contains the Spanner source. Has a length + // limit of 128 characters. If not specified, inherits the project ID from the + // parent request. ProjectId string `json:"projectId,omitempty"` // TableId: Required. The table name of the Spanner database that needs to be // imported. @@ -17209,6 +17494,43 @@ func (s GoogleCloudDiscoveryengineV1betaUserInfo) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1betaWorkspaceConfig: Config to store data store +// type configuration for workspace data +type GoogleCloudDiscoveryengineV1betaWorkspaceConfig struct { + // DasherCustomerId: Obfuscated Dasher customer ID. + DasherCustomerId string `json:"dasherCustomerId,omitempty"` + // Type: The Google Workspace data source. + // + // Possible values: + // "TYPE_UNSPECIFIED" - Default value. + // "GOOGLE_DRIVE" - The data store is used to store content from Google + // Drive. + // "GOOGLE_MAIL" - The data store is used to store content from Gmail. + // "GOOGLE_SITES" - The data store is used to store content from Google + // Sites. + // "GOOGLE_CALENDAR" - The data store is used to store content from Google + // Calendar. + // "GOOGLE_GROUPS" - The data store is used to store content from Google + // Groups. + Type string `json:"type,omitempty"` + // ForceSendFields is a list of field names (e.g. "DasherCustomerId") 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. "DasherCustomerId") 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 GoogleCloudDiscoveryengineV1betaWorkspaceConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaWorkspaceConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleLongrunningCancelOperationRequest: The request message for // Operations.CancelOperation. type GoogleLongrunningCancelOperationRequest struct { @@ -18740,6 +19062,124 @@ func (c *ProjectsLocationsCollectionsDataStoresTrainCustomModelCall) Do(opts ... return ret, nil } +type ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// BatchGetDocumentsMetadata: Gets index freshness metadata for Documents. +// Supported for website search only. +// +// - parent: The parent branch resource name, such as +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store}/branches/{branch}`. +func (r *ProjectsLocationsCollectionsDataStoresBranchesService) BatchGetDocumentsMetadata(parent string) *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall { + c := &ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// MatcherUrisMatcherUris sets the optional parameter +// "matcher.urisMatcher.uris": The exact URIs to match by. +func (c *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) MatcherUrisMatcherUris(matcherUrisMatcherUris ...string) *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall { + c.urlParams_.SetMulti("matcher.urisMatcher.uris", append([]string{}, matcherUrisMatcherUris...)) + 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 *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall { + 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 *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall { + 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 *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) 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, "v1beta/{+parent}/batchGetDocumentsMetadata") + 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{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.batchGetDocumentsMetadata" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponse.ServerResp +// onse.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 *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadataCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponse, 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 := &GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponse{ + 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 ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall struct { s *Service parent string @@ -31804,6 +32244,124 @@ func (c *ProjectsLocationsDataStoresPatchCall) Do(opts ...googleapi.CallOption) return ret, nil } +type ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// BatchGetDocumentsMetadata: Gets index freshness metadata for Documents. +// Supported for website search only. +// +// - parent: The parent branch resource name, such as +// `projects/{project}/locations/{location}/collections/{collection}/dataStore +// s/{data_store}/branches/{branch}`. +func (r *ProjectsLocationsDataStoresBranchesService) BatchGetDocumentsMetadata(parent string) *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall { + c := &ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// MatcherUrisMatcherUris sets the optional parameter +// "matcher.urisMatcher.uris": The exact URIs to match by. +func (c *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall) MatcherUrisMatcherUris(matcherUrisMatcherUris ...string) *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall { + c.urlParams_.SetMulti("matcher.urisMatcher.uris", append([]string{}, matcherUrisMatcherUris...)) + 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 *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall { + 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 *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall) Context(ctx context.Context) *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall { + 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 *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall) 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, "v1beta/{+parent}/batchGetDocumentsMetadata") + 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{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.dataStores.branches.batchGetDocumentsMetadata" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponse.ServerResp +// onse.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 *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponse, 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 := &GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponse{ + 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 ProjectsLocationsDataStoresBranchesDocumentsCreateCall struct { s *Service parent string diff --git a/displayvideo/v2/displayvideo-api.json b/displayvideo/v2/displayvideo-api.json index 0214ede2934..d9c1608026c 100644 --- a/displayvideo/v2/displayvideo-api.json +++ b/displayvideo/v2/displayvideo-api.json @@ -9267,7 +9267,7 @@ } } }, - "revision": "20240618", + "revision": "20240808", "rootUrl": "https://displayvideo.googleapis.com/", "schemas": { "ActivateManualTriggerRequest": { @@ -14105,7 +14105,8 @@ "EXCHANGE_UNITY_GBID", "EXCHANGE_CHARTBOOST_GBID", "EXCHANGE_ADMOST_GBID", - "EXCHANGE_TOPON_GBID" + "EXCHANGE_TOPON_GBID", + "EXCHANGE_NETFLIX" ], "enumDescriptions": [ "Exchange is not specified or is unknown in this version.", @@ -14189,7 +14190,8 @@ "Unity LevelPlay.", "Chartboost Mediation.", "AdMost.", - "TopOn." + "TopOn.", + "Netflix." ], "type": "string" } @@ -14298,7 +14300,8 @@ "EXCHANGE_UNITY_GBID", "EXCHANGE_CHARTBOOST_GBID", "EXCHANGE_ADMOST_GBID", - "EXCHANGE_TOPON_GBID" + "EXCHANGE_TOPON_GBID", + "EXCHANGE_NETFLIX" ], "enumDescriptions": [ "Exchange is not specified or is unknown in this version.", @@ -14382,7 +14385,8 @@ "Unity LevelPlay.", "Chartboost Mediation.", "AdMost.", - "TopOn." + "TopOn.", + "Netflix." ], "type": "string" }, @@ -14492,7 +14496,8 @@ "EXCHANGE_UNITY_GBID", "EXCHANGE_CHARTBOOST_GBID", "EXCHANGE_ADMOST_GBID", - "EXCHANGE_TOPON_GBID" + "EXCHANGE_TOPON_GBID", + "EXCHANGE_NETFLIX" ], "enumDescriptions": [ "Exchange is not specified or is unknown in this version.", @@ -14576,7 +14581,8 @@ "Unity LevelPlay.", "Chartboost Mediation.", "AdMost.", - "TopOn." + "TopOn.", + "Netflix." ], "type": "string" }, @@ -14687,7 +14693,8 @@ "EXCHANGE_UNITY_GBID", "EXCHANGE_CHARTBOOST_GBID", "EXCHANGE_ADMOST_GBID", - "EXCHANGE_TOPON_GBID" + "EXCHANGE_TOPON_GBID", + "EXCHANGE_NETFLIX" ], "enumDescriptions": [ "Exchange is not specified or is unknown in this version.", @@ -14771,7 +14778,8 @@ "Unity LevelPlay.", "Chartboost Mediation.", "AdMost.", - "TopOn." + "TopOn.", + "Netflix." ], "readOnly": true, "type": "string" @@ -15733,7 +15741,8 @@ "EXCHANGE_UNITY_GBID", "EXCHANGE_CHARTBOOST_GBID", "EXCHANGE_ADMOST_GBID", - "EXCHANGE_TOPON_GBID" + "EXCHANGE_TOPON_GBID", + "EXCHANGE_NETFLIX" ], "enumDescriptions": [ "Exchange is not specified or is unknown in this version.", @@ -15817,7 +15826,8 @@ "Unity LevelPlay.", "Chartboost Mediation.", "AdMost.", - "TopOn." + "TopOn.", + "Netflix." ], "type": "string" }, @@ -16644,7 +16654,8 @@ "EXCHANGE_UNITY_GBID", "EXCHANGE_CHARTBOOST_GBID", "EXCHANGE_ADMOST_GBID", - "EXCHANGE_TOPON_GBID" + "EXCHANGE_TOPON_GBID", + "EXCHANGE_NETFLIX" ], "enumDescriptions": [ "Exchange is not specified or is unknown in this version.", @@ -16728,7 +16739,8 @@ "Unity LevelPlay.", "Chartboost Mediation.", "AdMost.", - "TopOn." + "TopOn.", + "Netflix." ], "type": "string" }, @@ -18903,8 +18915,8 @@ "Advertiser ID. If selected, all filter IDs must be Advertiser IDs that belong to the Partner specified in CreateSdfDownloadTaskRequest.", "Campaign ID. If selected, all filter IDs must be Campaign IDs that belong to the Advertiser or Partner specified in CreateSdfDownloadTaskRequest.", "Media Product ID. If selected, all filter IDs must be Media Product IDs that belong to the Advertiser or Partner specified in CreateSdfDownloadTaskRequest. Can only be used for downloading `FILE_TYPE_MEDIA_PRODUCT`.", - "Insertion Order ID. If selected, all filter IDs must be Insertion Order IDs that belong to the Advertiser or Partner specified in CreateSdfDownloadTaskRequest. Can only be used for downloading `FILE_TYPE_INSERTION_ORDER`, `FILE_TYPE_LINE_ITEM`, `FILE_TYPE_AD_GROUP`, and `FILE_TYPE_AD`.", - "Line Item ID. If selected, all filter IDs must be Line Item IDs that belong to the Advertiser or Partner specified in CreateSdfDownloadTaskRequest. Can only be used for downloading `FILE_TYPE_LINE_ITEM`, `FILE_TYPE_AD_GROUP`, and `FILE_TYPE_AD`." + "Insertion Order ID. If selected, all filter IDs must be Insertion Order IDs that belong to the Advertiser or Partner specified in CreateSdfDownloadTaskRequest. Can only be used for downloading `FILE_TYPE_INSERTION_ORDER`, `FILE_TYPE_LINE_ITEM`, `FILE_TYPE_LINE_ITEM_QA`, `FILE_TYPE_AD_GROUP`, `FILE_TYPE_AD_GROUP_QA`, and `FILE_TYPE_AD`.", + "Line Item ID. If selected, all filter IDs must be Line Item IDs that belong to the Advertiser or Partner specified in CreateSdfDownloadTaskRequest. Can only be used for downloading `FILE_TYPE_LINE_ITEM`, `FILE_TYPE_LINE_ITEM_QA`,`FILE_TYPE_AD_GROUP`, `FILE_TYPE_AD_GROUP_QA`, and `FILE_TYPE_AD`." ], "type": "string" } @@ -19760,7 +19772,8 @@ "type": "array" }, "publisherReviewStatuses": { - "description": "Publisher review statuses for the creative. **Warning:** This field will be deprecated on June 26th, 2024. After this date, this field will be empty. Read our [feature deprecation announcement](/display-video/api/deprecations#features.creative_publisher_review_statuses) for more information.", + "deprecated": true, + "description": "Publisher review statuses for the creative.", "items": { "$ref": "PublisherReviewStatus" }, diff --git a/displayvideo/v2/displayvideo-gen.go b/displayvideo/v2/displayvideo-gen.go index b85770516a1..a3b6eea601c 100644 --- a/displayvideo/v2/displayvideo-gen.go +++ b/displayvideo/v2/displayvideo-gen.go @@ -6829,6 +6829,7 @@ type ExchangeAssignedTargetingOptionDetails struct { // "EXCHANGE_CHARTBOOST_GBID" - Chartboost Mediation. // "EXCHANGE_ADMOST_GBID" - AdMost. // "EXCHANGE_TOPON_GBID" - TopOn. + // "EXCHANGE_NETFLIX" - Netflix. Exchange string `json:"exchange,omitempty"` // ForceSendFields is a list of field names (e.g. "Exchange") to // unconditionally include in API requests. By default, fields with empty or @@ -6961,6 +6962,7 @@ type ExchangeConfigEnabledExchange struct { // "EXCHANGE_CHARTBOOST_GBID" - Chartboost Mediation. // "EXCHANGE_ADMOST_GBID" - AdMost. // "EXCHANGE_TOPON_GBID" - TopOn. + // "EXCHANGE_NETFLIX" - Netflix. Exchange string `json:"exchange,omitempty"` // GoogleAdManagerAgencyId: Output only. Agency ID of Google Ad Manager. The // field is only relevant when Google Ad Manager is the enabled exchange. @@ -7077,6 +7079,7 @@ type ExchangeReviewStatus struct { // "EXCHANGE_CHARTBOOST_GBID" - Chartboost Mediation. // "EXCHANGE_ADMOST_GBID" - AdMost. // "EXCHANGE_TOPON_GBID" - TopOn. + // "EXCHANGE_NETFLIX" - Netflix. Exchange string `json:"exchange,omitempty"` // Status: Status of the exchange review. // @@ -7196,6 +7199,7 @@ type ExchangeTargetingOptionDetails struct { // "EXCHANGE_CHARTBOOST_GBID" - Chartboost Mediation. // "EXCHANGE_ADMOST_GBID" - AdMost. // "EXCHANGE_TOPON_GBID" - TopOn. + // "EXCHANGE_NETFLIX" - Netflix. Exchange string `json:"exchange,omitempty"` // ForceSendFields is a list of field names (e.g. "Exchange") to // unconditionally include in API requests. By default, fields with empty or @@ -8228,6 +8232,7 @@ type GuaranteedOrder struct { // "EXCHANGE_CHARTBOOST_GBID" - Chartboost Mediation. // "EXCHANGE_ADMOST_GBID" - AdMost. // "EXCHANGE_TOPON_GBID" - TopOn. + // "EXCHANGE_NETFLIX" - Netflix. Exchange string `json:"exchange,omitempty"` // GuaranteedOrderId: Output only. The unique identifier of the guaranteed // order. The guaranteed order IDs have the format @@ -9010,6 +9015,7 @@ type InventorySource struct { // "EXCHANGE_CHARTBOOST_GBID" - Chartboost Mediation. // "EXCHANGE_ADMOST_GBID" - AdMost. // "EXCHANGE_TOPON_GBID" - TopOn. + // "EXCHANGE_NETFLIX" - Netflix. Exchange string `json:"exchange,omitempty"` // GuaranteedOrderId: Immutable. The ID of the guaranteed order that this // inventory source belongs to. Only applicable when commitment is @@ -11968,11 +11974,13 @@ type ParentEntityFilter struct { // filter IDs must be Insertion Order IDs that belong to the Advertiser or // Partner specified in CreateSdfDownloadTaskRequest. Can only be used for // downloading `FILE_TYPE_INSERTION_ORDER`, `FILE_TYPE_LINE_ITEM`, - // `FILE_TYPE_AD_GROUP`, and `FILE_TYPE_AD`. + // `FILE_TYPE_LINE_ITEM_QA`, `FILE_TYPE_AD_GROUP`, `FILE_TYPE_AD_GROUP_QA`, and + // `FILE_TYPE_AD`. // "FILTER_TYPE_LINE_ITEM_ID" - Line Item ID. If selected, all filter IDs // must be Line Item IDs that belong to the Advertiser or Partner specified in // CreateSdfDownloadTaskRequest. Can only be used for downloading - // `FILE_TYPE_LINE_ITEM`, `FILE_TYPE_AD_GROUP`, and `FILE_TYPE_AD`. + // `FILE_TYPE_LINE_ITEM`, `FILE_TYPE_LINE_ITEM_QA`,`FILE_TYPE_AD_GROUP`, + // `FILE_TYPE_AD_GROUP_QA`, and `FILE_TYPE_AD`. FilterType string `json:"filterType,omitempty"` // ForceSendFields is a list of field names (e.g. "FileType") to // unconditionally include in API requests. By default, fields with empty or @@ -13105,10 +13113,6 @@ type ReviewStatusInfo struct { // ExchangeReviewStatuses: Exchange review statuses for the creative. ExchangeReviewStatuses []*ExchangeReviewStatus `json:"exchangeReviewStatuses,omitempty"` // PublisherReviewStatuses: Publisher review statuses for the creative. - // **Warning:** This field will be deprecated on June 26th, 2024. After this - // date, this field will be empty. Read our feature deprecation announcement - // (/display-video/api/deprecations#features.creative_publisher_review_statuses) - // for more information. PublisherReviewStatuses []*PublisherReviewStatus `json:"publisherReviewStatuses,omitempty"` // ForceSendFields is a list of field names (e.g. "ApprovalStatus") to // unconditionally include in API requests. By default, fields with empty or diff --git a/displayvideo/v3/displayvideo-api.json b/displayvideo/v3/displayvideo-api.json index 49f74318f5f..3f440fcf0cb 100644 --- a/displayvideo/v3/displayvideo-api.json +++ b/displayvideo/v3/displayvideo-api.json @@ -9222,7 +9222,7 @@ } } }, - "revision": "20240717", + "revision": "20240808", "rootUrl": "https://displayvideo.googleapis.com/", "schemas": { "ActiveViewVideoViewabilityMetricConfig": { @@ -10048,7 +10048,8 @@ "EXCHANGE_UNITY_GBID", "EXCHANGE_CHARTBOOST_GBID", "EXCHANGE_ADMOST_GBID", - "EXCHANGE_TOPON_GBID" + "EXCHANGE_TOPON_GBID", + "EXCHANGE_NETFLIX" ], "enumDescriptions": [ "Exchange is not specified or is unknown in this version.", @@ -10132,7 +10133,8 @@ "Unity LevelPlay.", "Chartboost Mediation.", "AdMost.", - "TopOn." + "TopOn.", + "Netflix." ], "type": "string" }, @@ -14819,7 +14821,8 @@ "EXCHANGE_UNITY_GBID", "EXCHANGE_CHARTBOOST_GBID", "EXCHANGE_ADMOST_GBID", - "EXCHANGE_TOPON_GBID" + "EXCHANGE_TOPON_GBID", + "EXCHANGE_NETFLIX" ], "enumDescriptions": [ "Exchange is not specified or is unknown in this version.", @@ -14903,7 +14906,8 @@ "Unity LevelPlay.", "Chartboost Mediation.", "AdMost.", - "TopOn." + "TopOn.", + "Netflix." ], "type": "string" } @@ -15012,7 +15016,8 @@ "EXCHANGE_UNITY_GBID", "EXCHANGE_CHARTBOOST_GBID", "EXCHANGE_ADMOST_GBID", - "EXCHANGE_TOPON_GBID" + "EXCHANGE_TOPON_GBID", + "EXCHANGE_NETFLIX" ], "enumDescriptions": [ "Exchange is not specified or is unknown in this version.", @@ -15096,7 +15101,8 @@ "Unity LevelPlay.", "Chartboost Mediation.", "AdMost.", - "TopOn." + "TopOn.", + "Netflix." ], "type": "string" }, @@ -15206,7 +15212,8 @@ "EXCHANGE_UNITY_GBID", "EXCHANGE_CHARTBOOST_GBID", "EXCHANGE_ADMOST_GBID", - "EXCHANGE_TOPON_GBID" + "EXCHANGE_TOPON_GBID", + "EXCHANGE_NETFLIX" ], "enumDescriptions": [ "Exchange is not specified or is unknown in this version.", @@ -15290,7 +15297,8 @@ "Unity LevelPlay.", "Chartboost Mediation.", "AdMost.", - "TopOn." + "TopOn.", + "Netflix." ], "type": "string" }, @@ -15401,7 +15409,8 @@ "EXCHANGE_UNITY_GBID", "EXCHANGE_CHARTBOOST_GBID", "EXCHANGE_ADMOST_GBID", - "EXCHANGE_TOPON_GBID" + "EXCHANGE_TOPON_GBID", + "EXCHANGE_NETFLIX" ], "enumDescriptions": [ "Exchange is not specified or is unknown in this version.", @@ -15485,7 +15494,8 @@ "Unity LevelPlay.", "Chartboost Mediation.", "AdMost.", - "TopOn." + "TopOn.", + "Netflix." ], "readOnly": true, "type": "string" @@ -16447,7 +16457,8 @@ "EXCHANGE_UNITY_GBID", "EXCHANGE_CHARTBOOST_GBID", "EXCHANGE_ADMOST_GBID", - "EXCHANGE_TOPON_GBID" + "EXCHANGE_TOPON_GBID", + "EXCHANGE_NETFLIX" ], "enumDescriptions": [ "Exchange is not specified or is unknown in this version.", @@ -16531,7 +16542,8 @@ "Unity LevelPlay.", "Chartboost Mediation.", "AdMost.", - "TopOn." + "TopOn.", + "Netflix." ], "type": "string" }, @@ -17372,7 +17384,8 @@ "EXCHANGE_UNITY_GBID", "EXCHANGE_CHARTBOOST_GBID", "EXCHANGE_ADMOST_GBID", - "EXCHANGE_TOPON_GBID" + "EXCHANGE_TOPON_GBID", + "EXCHANGE_NETFLIX" ], "enumDescriptions": [ "Exchange is not specified or is unknown in this version.", @@ -17456,7 +17469,8 @@ "Unity LevelPlay.", "Chartboost Mediation.", "AdMost.", - "TopOn." + "TopOn.", + "Netflix." ], "type": "string" }, diff --git a/displayvideo/v3/displayvideo-gen.go b/displayvideo/v3/displayvideo-gen.go index 22b43a5ad0f..6658a26a2e9 100644 --- a/displayvideo/v3/displayvideo-gen.go +++ b/displayvideo/v3/displayvideo-gen.go @@ -1682,6 +1682,7 @@ type AlgorithmRulesComparisonValue struct { // "EXCHANGE_CHARTBOOST_GBID" - Chartboost Mediation. // "EXCHANGE_ADMOST_GBID" - AdMost. // "EXCHANGE_TOPON_GBID" - TopOn. + // "EXCHANGE_NETFLIX" - Netflix. ExchangeValue string `json:"exchangeValue,omitempty"` // Int64Value: Integer value. Int64Value int64 `json:"int64Value,omitempty,string"` @@ -7604,6 +7605,7 @@ type ExchangeAssignedTargetingOptionDetails struct { // "EXCHANGE_CHARTBOOST_GBID" - Chartboost Mediation. // "EXCHANGE_ADMOST_GBID" - AdMost. // "EXCHANGE_TOPON_GBID" - TopOn. + // "EXCHANGE_NETFLIX" - Netflix. Exchange string `json:"exchange,omitempty"` // ForceSendFields is a list of field names (e.g. "Exchange") to // unconditionally include in API requests. By default, fields with empty or @@ -7736,6 +7738,7 @@ type ExchangeConfigEnabledExchange struct { // "EXCHANGE_CHARTBOOST_GBID" - Chartboost Mediation. // "EXCHANGE_ADMOST_GBID" - AdMost. // "EXCHANGE_TOPON_GBID" - TopOn. + // "EXCHANGE_NETFLIX" - Netflix. Exchange string `json:"exchange,omitempty"` // GoogleAdManagerAgencyId: Output only. Agency ID of Google Ad Manager. The // field is only relevant when Google Ad Manager is the enabled exchange. @@ -7852,6 +7855,7 @@ type ExchangeReviewStatus struct { // "EXCHANGE_CHARTBOOST_GBID" - Chartboost Mediation. // "EXCHANGE_ADMOST_GBID" - AdMost. // "EXCHANGE_TOPON_GBID" - TopOn. + // "EXCHANGE_NETFLIX" - Netflix. Exchange string `json:"exchange,omitempty"` // Status: Status of the exchange review. // @@ -7971,6 +7975,7 @@ type ExchangeTargetingOptionDetails struct { // "EXCHANGE_CHARTBOOST_GBID" - Chartboost Mediation. // "EXCHANGE_ADMOST_GBID" - AdMost. // "EXCHANGE_TOPON_GBID" - TopOn. + // "EXCHANGE_NETFLIX" - Netflix. Exchange string `json:"exchange,omitempty"` // ForceSendFields is a list of field names (e.g. "Exchange") to // unconditionally include in API requests. By default, fields with empty or @@ -9003,6 +9008,7 @@ type GuaranteedOrder struct { // "EXCHANGE_CHARTBOOST_GBID" - Chartboost Mediation. // "EXCHANGE_ADMOST_GBID" - AdMost. // "EXCHANGE_TOPON_GBID" - TopOn. + // "EXCHANGE_NETFLIX" - Netflix. Exchange string `json:"exchange,omitempty"` // GuaranteedOrderId: Output only. The unique identifier of the guaranteed // order. The guaranteed order IDs have the format @@ -9801,6 +9807,7 @@ type InventorySource struct { // "EXCHANGE_CHARTBOOST_GBID" - Chartboost Mediation. // "EXCHANGE_ADMOST_GBID" - AdMost. // "EXCHANGE_TOPON_GBID" - TopOn. + // "EXCHANGE_NETFLIX" - Netflix. Exchange string `json:"exchange,omitempty"` // GuaranteedOrderId: Immutable. The ID of the guaranteed order that this // inventory source belongs to. Only applicable when commitment is diff --git a/dlp/v2/dlp-api.json b/dlp/v2/dlp-api.json index 38994d2ccbe..bb9f94b8062 100644 --- a/dlp/v2/dlp-api.json +++ b/dlp/v2/dlp-api.json @@ -347,7 +347,7 @@ "type": "string" }, "parent": { - "description": "The parent resource name. The format of this value is as follows: locations/ LOCATION_ID", + "description": "The parent resource name. The format of this value is as follows: `locations/{location_id}`", "location": "query", "type": "string" } @@ -391,7 +391,7 @@ "type": "string" }, "parent": { - "description": "The parent resource name. The format of this value is as follows: locations/ LOCATION_ID", + "description": "The parent resource name. The format of this value is as follows: `locations/{location_id}`", "location": "path", "pattern": "^locations/[^/]+$", "required": true, @@ -424,7 +424,7 @@ ], "parameters": { "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID + Organizations scope, location specified: `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no location specified (defaults to global): `organizations/`ORG_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` + Organizations scope, location specified: `organizations/{org_id}/locations/{location_id}` + Organizations scope, no location specified (defaults to global): `organizations/{org_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^organizations/[^/]+$", "required": true, @@ -523,7 +523,7 @@ "type": "string" }, "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID + Organizations scope, location specified: `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no location specified (defaults to global): `organizations/`ORG_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` + Organizations scope, location specified: `organizations/{org_id}/locations/{location_id}` + Organizations scope, no location specified (defaults to global): `organizations/{org_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^organizations/[^/]+$", "required": true, @@ -580,7 +580,7 @@ ], "parameters": { "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID + Organizations scope, location specified: `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no location specified (defaults to global): `organizations/`ORG_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` + Organizations scope, location specified: `organizations/{org_id}/locations/{location_id}` + Organizations scope, no location specified (defaults to global): `organizations/{org_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^organizations/[^/]+$", "required": true, @@ -679,7 +679,7 @@ "type": "string" }, "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID + Organizations scope, location specified: `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no location specified (defaults to global): `organizations/`ORG_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` + Organizations scope, location specified: `organizations/{org_id}/locations/{location_id}` + Organizations scope, no location specified (defaults to global): `organizations/{org_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^organizations/[^/]+$", "required": true, @@ -813,7 +813,7 @@ ], "parameters": { "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization): + Projects scope: `projects/`PROJECT_ID`/locations/`LOCATION_ID + Organizations scope: `organizations/`ORG_ID`/locations/`LOCATION_ID", + "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization): + Projects scope: `projects/{project_id}/locations/{location_id}` + Organizations scope: `organizations/{org_id}/locations/{location_id}`", "location": "path", "pattern": "^organizations/[^/]+/locations/[^/]+$", "required": true, @@ -1005,7 +1005,7 @@ ], "parameters": { "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID + Organizations scope, location specified: `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no location specified (defaults to global): `organizations/`ORG_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` + Organizations scope, location specified: `organizations/{org_id}/locations/{location_id}` + Organizations scope, no location specified (defaults to global): `organizations/{org_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^organizations/[^/]+/locations/[^/]+$", "required": true, @@ -1104,7 +1104,7 @@ "type": "string" }, "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID + Organizations scope, location specified: `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no location specified (defaults to global): `organizations/`ORG_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` + Organizations scope, location specified: `organizations/{org_id}/locations/{location_id}` + Organizations scope, no location specified (defaults to global): `organizations/{org_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^organizations/[^/]+/locations/[^/]+$", "required": true, @@ -1161,7 +1161,7 @@ ], "parameters": { "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization): + Projects scope: `projects/`PROJECT_ID`/locations/`LOCATION_ID + Organizations scope: `organizations/`ORG_ID`/locations/`LOCATION_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization): + Projects scope: `projects/{project_id}/locations/{location_id}` + Organizations scope: `organizations/{org_id}/locations/{location_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^organizations/[^/]+/locations/[^/]+$", "required": true, @@ -1255,7 +1255,7 @@ "type": "string" }, "parent": { - "description": "Required. Parent resource name. The format of this value is as follows: `projects/`PROJECT_ID`/locations/`LOCATION_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value is as follows: `projects/{project_id}/locations/{location_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^organizations/[^/]+/locations/[^/]+$", "required": true, @@ -1338,7 +1338,7 @@ "type": "string" }, "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^organizations/[^/]+/locations/[^/]+$", "required": true, @@ -1482,7 +1482,7 @@ ], "parameters": { "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID + Organizations scope, location specified: `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no location specified (defaults to global): `organizations/`ORG_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` + Organizations scope, location specified: `organizations/{org_id}/locations/{location_id}` + Organizations scope, no location specified (defaults to global): `organizations/{org_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^organizations/[^/]+/locations/[^/]+$", "required": true, @@ -1581,7 +1581,7 @@ "type": "string" }, "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID + Organizations scope, location specified: `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no location specified (defaults to global): `organizations/`ORG_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` + Organizations scope, location specified: `organizations/{org_id}/locations/{location_id}` + Organizations scope, no location specified (defaults to global): `organizations/{org_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^organizations/[^/]+/locations/[^/]+$", "required": true, @@ -1638,7 +1638,7 @@ ], "parameters": { "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^organizations/[^/]+/locations/[^/]+$", "required": true, @@ -1742,7 +1742,7 @@ "type": "string" }, "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^organizations/[^/]+/locations/[^/]+$", "required": true, @@ -1889,7 +1889,7 @@ ], "parameters": { "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID + Organizations scope, location specified: `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no location specified (defaults to global): `organizations/`ORG_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` + Organizations scope, location specified: `organizations/{org_id}/locations/{location_id}` + Organizations scope, no location specified (defaults to global): `organizations/{org_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^organizations/[^/]+/locations/[^/]+$", "required": true, @@ -1988,7 +1988,7 @@ "type": "string" }, "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^organizations/[^/]+/locations/[^/]+$", "required": true, @@ -2147,7 +2147,7 @@ ], "parameters": { "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID + Organizations scope, location specified: `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no location specified (defaults to global): `organizations/`ORG_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` + Organizations scope, location specified: `organizations/{org_id}/locations/{location_id}` + Organizations scope, no location specified (defaults to global): `organizations/{org_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^organizations/[^/]+$", "required": true, @@ -2246,7 +2246,7 @@ "type": "string" }, "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^organizations/[^/]+$", "required": true, @@ -2307,7 +2307,7 @@ ], "parameters": { "parent": { - "description": "Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -2335,7 +2335,7 @@ ], "parameters": { "parent": { - "description": "Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -2363,7 +2363,7 @@ ], "parameters": { "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -2395,7 +2395,7 @@ ], "parameters": { "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID + Organizations scope, location specified: `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no location specified (defaults to global): `organizations/`ORG_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` + Organizations scope, location specified: `organizations/{org_id}/locations/{location_id}` + Organizations scope, no location specified (defaults to global): `organizations/{org_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -2494,7 +2494,7 @@ "type": "string" }, "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID + Organizations scope, location specified: `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no location specified (defaults to global): `organizations/`ORG_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` + Organizations scope, location specified: `organizations/{org_id}/locations/{location_id}` + Organizations scope, no location specified (defaults to global): `organizations/{org_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -2579,7 +2579,7 @@ ], "parameters": { "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -2683,7 +2683,7 @@ "type": "string" }, "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -2727,7 +2727,7 @@ ], "parameters": { "parent": { - "description": "Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -2759,7 +2759,7 @@ ], "parameters": { "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID + Organizations scope, location specified: `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no location specified (defaults to global): `organizations/`ORG_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` + Organizations scope, location specified: `organizations/{org_id}/locations/{location_id}` + Organizations scope, no location specified (defaults to global): `organizations/{org_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -2858,7 +2858,7 @@ "type": "string" }, "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID + Organizations scope, location specified: `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no location specified (defaults to global): `organizations/`ORG_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` + Organizations scope, location specified: `organizations/{org_id}/locations/{location_id}` + Organizations scope, no location specified (defaults to global): `organizations/{org_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -2943,7 +2943,7 @@ ], "parameters": { "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -3047,7 +3047,7 @@ "type": "string" }, "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -3196,7 +3196,7 @@ ], "parameters": { "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization): + Projects scope: `projects/`PROJECT_ID`/locations/`LOCATION_ID + Organizations scope: `organizations/`ORG_ID`/locations/`LOCATION_ID", + "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization): + Projects scope: `projects/{project_id}/locations/{location_id}` + Organizations scope: `organizations/{org_id}/locations/{location_id}`", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -3388,7 +3388,7 @@ ], "parameters": { "parent": { - "description": "Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -3416,7 +3416,7 @@ ], "parameters": { "parent": { - "description": "Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -3444,7 +3444,7 @@ ], "parameters": { "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -3476,7 +3476,7 @@ ], "parameters": { "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID + Organizations scope, location specified: `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no location specified (defaults to global): `organizations/`ORG_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` + Organizations scope, location specified: `organizations/{org_id}/locations/{location_id}` + Organizations scope, no location specified (defaults to global): `organizations/{org_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -3575,7 +3575,7 @@ "type": "string" }, "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID + Organizations scope, location specified: `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no location specified (defaults to global): `organizations/`ORG_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` + Organizations scope, location specified: `organizations/{org_id}/locations/{location_id}` + Organizations scope, no location specified (defaults to global): `organizations/{org_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -3632,7 +3632,7 @@ ], "parameters": { "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization): + Projects scope: `projects/`PROJECT_ID`/locations/`LOCATION_ID + Organizations scope: `organizations/`ORG_ID`/locations/`LOCATION_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization): + Projects scope: `projects/{project_id}/locations/{location_id}` + Organizations scope: `organizations/{org_id}/locations/{location_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -3726,7 +3726,7 @@ "type": "string" }, "parent": { - "description": "Required. Parent resource name. The format of this value is as follows: `projects/`PROJECT_ID`/locations/`LOCATION_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value is as follows: `projects/{project_id}/locations/{location_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -3811,7 +3811,7 @@ ], "parameters": { "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -3971,7 +3971,7 @@ "type": "string" }, "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -4115,7 +4115,7 @@ ], "parameters": { "parent": { - "description": "Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -4147,7 +4147,7 @@ ], "parameters": { "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID + Organizations scope, location specified: `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no location specified (defaults to global): `organizations/`ORG_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` + Organizations scope, location specified: `organizations/{org_id}/locations/{location_id}` + Organizations scope, no location specified (defaults to global): `organizations/{org_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -4246,7 +4246,7 @@ "type": "string" }, "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID + Organizations scope, location specified: `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no location specified (defaults to global): `organizations/`ORG_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` + Organizations scope, location specified: `organizations/{org_id}/locations/{location_id}` + Organizations scope, no location specified (defaults to global): `organizations/{org_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -4331,7 +4331,7 @@ ], "parameters": { "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -4463,7 +4463,7 @@ "type": "string" }, "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -4610,7 +4610,7 @@ ], "parameters": { "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID + Organizations scope, location specified: `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no location specified (defaults to global): `organizations/`ORG_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` + Organizations scope, location specified: `organizations/{org_id}/locations/{location_id}` + Organizations scope, no location specified (defaults to global): `organizations/{org_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -4709,7 +4709,7 @@ "type": "string" }, "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -4868,7 +4868,7 @@ ], "parameters": { "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID + Organizations scope, location specified: `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no location specified (defaults to global): `organizations/`ORG_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` + Organizations scope, location specified: `organizations/{org_id}/locations/{location_id}` + Organizations scope, no location specified (defaults to global): `organizations/{org_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -4967,7 +4967,7 @@ "type": "string" }, "parent": { - "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/`PROJECT_ID`/locations/` LOCATION_ID + Projects scope, no location specified (defaults to global): `projects/`PROJECT_ID The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", + "description": "Required. Parent resource name. The format of this value varies depending on the scope of the request (project or organization) and whether you have [specified a processing location](https://cloud.google.com/sensitive-data-protection/docs/specifying-location): + Projects scope, location specified: `projects/{project_id}/locations/{location_id}` + Projects scope, no location specified (defaults to global): `projects/{project_id}` The following example `parent` string specifies a parent project with the identifier `example-project`, and specifies the `europe-west3` location for processing data: parent=projects/example-project/locations/europe-west3", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -5015,7 +5015,7 @@ } } }, - "revision": "20240805", + "revision": "20240808", "rootUrl": "https://dlp.googleapis.com/", "schemas": { "GooglePrivacyDlpV2Action": { @@ -6428,7 +6428,7 @@ "description": "Required. The key used by the encryption algorithm." }, "customAlphabet": { - "description": "This is supported by mapping these to the alphanumeric characters that the FFX mode natively supports. This happens before/after encryption/decryption. Each character listed must appear only once. Number of characters must be in the range [2, 95]. This must be encoded as ASCII. The order of characters does not matter. The full list of allowed characters is: 0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz ~`!@#$%^\u0026*()_-+={[}]|\\:;\"'\u003c,\u003e.?/", + "description": "This is supported by mapping these to the alphanumeric characters that the FFX mode natively supports. This happens before/after encryption/decryption. Each character listed must appear only once. Number of characters must be in the range [2, 95]. This must be encoded as ASCII. The order of characters does not matter. The full list of allowed characters is: ``0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz~`!@#$%^\u0026*()_-+={[}]|\\:;\"'\u003c,\u003e.?/``", "type": "string" }, "radix": { @@ -6524,6 +6524,10 @@ "pubSubNotification": { "$ref": "GooglePrivacyDlpV2PubSubNotification", "description": "Publish a message into the Pub/Sub topic." + }, + "tagResources": { + "$ref": "GooglePrivacyDlpV2TagResources", + "description": "Tags the profiled resources with the specified tag values." } }, "type": "object" @@ -7305,6 +7309,10 @@ "description": "How often existing tables should have their profiles refreshed. New tables are scanned as quickly as possible depending on system capacity.", "id": "GooglePrivacyDlpV2DiscoveryCloudSqlGenerationCadence", "properties": { + "inspectTemplateModifiedCadence": { + "$ref": "GooglePrivacyDlpV2DiscoveryInspectTemplateModifiedCadence", + "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": "Data changes (non-schema changes) in Cloud SQL tables can't trigger reprofiling. If you set this field, profiles are refreshed at this frequency regardless of whether the underlying tables have changed. Defaults to never.", "enum": [ @@ -8014,14 +8022,14 @@ "description": "The file cluster type." }, "fileExtensionsScanned": { - "description": "A sample of file types scanned in this cluster. Empty if no files were scanned.", + "description": "A sample of file types scanned in this cluster. Empty if no files were scanned. File extensions can be derived from the file name or the file content.", "items": { "$ref": "GooglePrivacyDlpV2FileExtensionInfo" }, "type": "array" }, "fileExtensionsSeen": { - "description": "A sample of file types seen in this cluster. Empty if no files were seen.", + "description": "A sample of file types seen in this cluster. Empty if no files were seen. File extensions can be derived from the file name or the file content.", "items": { "$ref": "GooglePrivacyDlpV2FileExtensionInfo" }, @@ -11442,6 +11450,67 @@ }, "type": "object" }, + "GooglePrivacyDlpV2TagCondition": { + "description": "The tag to attach to profiles matching the condition. At most one `TagCondition` can be specified per sensitivity level.", + "id": "GooglePrivacyDlpV2TagCondition", + "properties": { + "sensitivityScore": { + "$ref": "GooglePrivacyDlpV2SensitivityScore", + "description": "Conditions attaching the tag to a resource on its profile having this sensitivity score." + }, + "tag": { + "$ref": "GooglePrivacyDlpV2TagValue", + "description": "The tag value to attach to resources." + } + }, + "type": "object" + }, + "GooglePrivacyDlpV2TagResources": { + "description": "If set, attaches the [tags] (https://cloud.google.com/resource-manager/docs/tags/tags-overview) provided to profiled resources. Tags support [access control](https://cloud.google.com/iam/docs/tags-access-control). You can conditionally grant or deny access to a resource based on whether the resource has a specific tag.", + "id": "GooglePrivacyDlpV2TagResources", + "properties": { + "lowerDataRiskToLow": { + "description": "Whether applying a tag to a resource should lower the risk of the profile for that resource. For example, in conjunction with an [IAM deny policy](https://cloud.google.com/iam/docs/deny-overview), you can deny all principals a permission if a tag value is present, mitigating the risk of the resource. This also lowers the data risk of resources at the lower levels of the resource hierarchy. For example, reducing the data risk of a table data profile also reduces the data risk of the constituent column data profiles.", + "type": "boolean" + }, + "profileGenerationsToTag": { + "description": "The profile generations for which the tag should be attached to resources. If you attach a tag to only new profiles, then if the sensitivity score of a profile subsequently changes, its tag doesn't change. By default, this field includes only new profiles. To include both new and updated profiles for tagging, this field should explicitly include both `PROFILE_GENERATION_NEW` and `PROFILE_GENERATION_UPDATE`.", + "items": { + "enum": [ + "PROFILE_GENERATION_UNSPECIFIED", + "PROFILE_GENERATION_NEW", + "PROFILE_GENERATION_UPDATE" + ], + "enumDescriptions": [ + "Unused.", + "The profile is the first profile for the resource.", + "The profile is an update to a previous profile." + ], + "type": "string" + }, + "type": "array" + }, + "tagConditions": { + "description": "The tags to associate with different conditions.", + "items": { + "$ref": "GooglePrivacyDlpV2TagCondition" + }, + "type": "array" + } + }, + "type": "object" + }, + "GooglePrivacyDlpV2TagValue": { + "description": "A value of a tag.", + "id": "GooglePrivacyDlpV2TagValue", + "properties": { + "namespacedValue": { + "description": "The namespaced name for the tag value to attach to resources. Must be in the format `{parent_id}/{tag_key_short_name}/{short_name}`, for example, \"123456/environment/prod\".", + "type": "string" + } + }, + "type": "object" + }, "GooglePrivacyDlpV2TaggedField": { "description": "A column with a semantic tag attached.", "id": "GooglePrivacyDlpV2TaggedField", @@ -11532,7 +11601,7 @@ }, "timestampField": { "$ref": "GooglePrivacyDlpV2FieldId", - "description": "Specification of the field containing the timestamp of scanned items. Used for data sources like Datastore and BigQuery. *For BigQuery* If this value is not specified and the table was modified between the given start and end times, the entire table will be scanned. If this value is specified, then rows are filtered based on the given start and end times. Rows with a `NULL` value in the provided BigQuery column are skipped. Valid data types of the provided BigQuery column are: `INTEGER`, `DATE`, `TIMESTAMP`, and `DATETIME`. If your BigQuery table is [partitioned at ingestion time](https://cloud.google.com/bigquery/docs/partitioned-tables#ingestion_time), you can use any of the following pseudo-columns as your timestamp field. When used with Cloud DLP, these pseudo-column names are case sensitive. - _PARTITIONTIME - _PARTITIONDATE - _PARTITION_LOAD_TIME *For Datastore* If this value is specified, then entities are filtered based on the given start and end times. If an entity does not contain the provided timestamp property or contains empty or invalid values, then it is included. Valid data types of the provided timestamp property are: `TIMESTAMP`. See the [known issue](https://cloud.google.com/sensitive-data-protection/docs/known-issues#bq-timespan) related to this operation." + "description": "Specification of the field containing the timestamp of scanned items. Used for data sources like Datastore and BigQuery. **For BigQuery** If this value is not specified and the table was modified between the given start and end times, the entire table will be scanned. If this value is specified, then rows are filtered based on the given start and end times. Rows with a `NULL` value in the provided BigQuery column are skipped. Valid data types of the provided BigQuery column are: `INTEGER`, `DATE`, `TIMESTAMP`, and `DATETIME`. If your BigQuery table is [partitioned at ingestion time](https://cloud.google.com/bigquery/docs/partitioned-tables#ingestion_time), you can use any of the following pseudo-columns as your timestamp field. When used with Cloud DLP, these pseudo-column names are case sensitive. - `_PARTITIONTIME` - `_PARTITIONDATE` - `_PARTITION_LOAD_TIME` **For Datastore** If this value is specified, then entities are filtered based on the given start and end times. If an entity does not contain the provided timestamp property or contains empty or invalid values, then it is included. Valid data types of the provided timestamp property are: `TIMESTAMP`. See the [known issue](https://cloud.google.com/sensitive-data-protection/docs/known-issues#bq-timespan) related to this operation." } }, "type": "object" diff --git a/dlp/v2/dlp-gen.go b/dlp/v2/dlp-gen.go index 09341ec9e22..176f4f5433f 100644 --- a/dlp/v2/dlp-gen.go +++ b/dlp/v2/dlp-gen.go @@ -2568,8 +2568,9 @@ type GooglePrivacyDlpV2CryptoReplaceFfxFpeConfig struct { // encryption/decryption. Each character listed must appear only once. Number // of characters must be in the range [2, 95]. This must be encoded as ASCII. // The order of characters does not matter. The full list of allowed characters - // is: 0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz - // ~`!@#$%^&*()_-+={[}]|\:;"'<,>.?/ + // is: + // ``0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz~`!@#$%^&*()_ + // -+={[}]|\:;"'<,>.?/`` CustomAlphabet string `json:"customAlphabet,omitempty"` // Radix: The native way to select the alphabet. Must be in the range [2, 95]. Radix int64 `json:"radix,omitempty"` @@ -2690,6 +2691,8 @@ type GooglePrivacyDlpV2DataProfileAction struct { ExportData *GooglePrivacyDlpV2Export `json:"exportData,omitempty"` // PubSubNotification: Publish a message into the Pub/Sub topic. PubSubNotification *GooglePrivacyDlpV2PubSubNotification `json:"pubSubNotification,omitempty"` + // TagResources: Tags the profiled resources with the specified tag values. + TagResources *GooglePrivacyDlpV2TagResources `json:"tagResources,omitempty"` // ForceSendFields is a list of field names (e.g. "ExportData") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -3903,6 +3906,10 @@ func (s GooglePrivacyDlpV2DiscoveryCloudSqlFilter) MarshalJSON() ([]byte, error) // tables should have their profiles refreshed. New tables are scanned as // quickly as possible depending on system capacity. type GooglePrivacyDlpV2DiscoveryCloudSqlGenerationCadence struct { + // InspectTemplateModifiedCadence: 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. + InspectTemplateModifiedCadence *GooglePrivacyDlpV2DiscoveryInspectTemplateModifiedCadence `json:"inspectTemplateModifiedCadence,omitempty"` // RefreshFrequency: Data changes (non-schema changes) in Cloud SQL tables // can't trigger reprofiling. If you set this field, profiles are refreshed at // this frequency regardless of whether the underlying tables have changed. @@ -3919,15 +3926,16 @@ type GooglePrivacyDlpV2DiscoveryCloudSqlGenerationCadence struct { RefreshFrequency string `json:"refreshFrequency,omitempty"` // SchemaModifiedCadence: When to reprofile if the schema has changed. SchemaModifiedCadence *GooglePrivacyDlpV2SchemaModifiedCadence `json:"schemaModifiedCadence,omitempty"` - // ForceSendFields is a list of field names (e.g. "RefreshFrequency") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See + // ForceSendFields is a list of field names (e.g. + // "InspectTemplateModifiedCadence") 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. "RefreshFrequency") 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. "InspectTemplateModifiedCadence") + // 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:"-"` } @@ -4787,10 +4795,12 @@ type GooglePrivacyDlpV2FileClusterSummary struct { // FileClusterType: The file cluster type. FileClusterType *GooglePrivacyDlpV2FileClusterType `json:"fileClusterType,omitempty"` // FileExtensionsScanned: A sample of file types scanned in this cluster. Empty - // if no files were scanned. + // if no files were scanned. File extensions can be derived from the file name + // or the file content. FileExtensionsScanned []*GooglePrivacyDlpV2FileExtensionInfo `json:"fileExtensionsScanned,omitempty"` // FileExtensionsSeen: A sample of file types seen in this cluster. Empty if no - // files were seen. + // files were seen. File extensions can be derived from the file name or the + // file content. FileExtensionsSeen []*GooglePrivacyDlpV2FileExtensionInfo `json:"fileExtensionsSeen,omitempty"` // FileStoreInfoTypeSummaries: InfoTypes detected in this cluster. FileStoreInfoTypeSummaries []*GooglePrivacyDlpV2FileStoreInfoTypeSummary `json:"fileStoreInfoTypeSummaries,omitempty"` @@ -9384,6 +9394,108 @@ func (s GooglePrivacyDlpV2TableReference) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GooglePrivacyDlpV2TagCondition: The tag to attach to profiles matching the +// condition. At most one `TagCondition` can be specified per sensitivity +// level. +type GooglePrivacyDlpV2TagCondition struct { + // SensitivityScore: Conditions attaching the tag to a resource on its profile + // having this sensitivity score. + SensitivityScore *GooglePrivacyDlpV2SensitivityScore `json:"sensitivityScore,omitempty"` + // Tag: The tag value to attach to resources. + Tag *GooglePrivacyDlpV2TagValue `json:"tag,omitempty"` + // ForceSendFields is a list of field names (e.g. "SensitivityScore") 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. "SensitivityScore") 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 GooglePrivacyDlpV2TagCondition) MarshalJSON() ([]byte, error) { + type NoMethod GooglePrivacyDlpV2TagCondition + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GooglePrivacyDlpV2TagResources: If set, attaches the [tags] +// (https://cloud.google.com/resource-manager/docs/tags/tags-overview) provided +// to profiled resources. Tags support access control +// (https://cloud.google.com/iam/docs/tags-access-control). You can +// conditionally grant or deny access to a resource based on whether the +// resource has a specific tag. +type GooglePrivacyDlpV2TagResources struct { + // LowerDataRiskToLow: Whether applying a tag to a resource should lower the + // risk of the profile for that resource. For example, in conjunction with an + // IAM deny policy (https://cloud.google.com/iam/docs/deny-overview), you can + // deny all principals a permission if a tag value is present, mitigating the + // risk of the resource. This also lowers the data risk of resources at the + // lower levels of the resource hierarchy. For example, reducing the data risk + // of a table data profile also reduces the data risk of the constituent column + // data profiles. + LowerDataRiskToLow bool `json:"lowerDataRiskToLow,omitempty"` + // ProfileGenerationsToTag: The profile generations for which the tag should be + // attached to resources. If you attach a tag to only new profiles, then if the + // sensitivity score of a profile subsequently changes, its tag doesn't change. + // By default, this field includes only new profiles. To include both new and + // updated profiles for tagging, this field should explicitly include both + // `PROFILE_GENERATION_NEW` and `PROFILE_GENERATION_UPDATE`. + // + // Possible values: + // "PROFILE_GENERATION_UNSPECIFIED" - Unused. + // "PROFILE_GENERATION_NEW" - The profile is the first profile for the + // resource. + // "PROFILE_GENERATION_UPDATE" - The profile is an update to a previous + // profile. + ProfileGenerationsToTag []string `json:"profileGenerationsToTag,omitempty"` + // TagConditions: The tags to associate with different conditions. + TagConditions []*GooglePrivacyDlpV2TagCondition `json:"tagConditions,omitempty"` + // ForceSendFields is a list of field names (e.g. "LowerDataRiskToLow") 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. "LowerDataRiskToLow") 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 GooglePrivacyDlpV2TagResources) MarshalJSON() ([]byte, error) { + type NoMethod GooglePrivacyDlpV2TagResources + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GooglePrivacyDlpV2TagValue: A value of a tag. +type GooglePrivacyDlpV2TagValue struct { + // NamespacedValue: The namespaced name for the tag value to attach to + // resources. Must be in the format + // `{parent_id}/{tag_key_short_name}/{short_name}`, for example, + // "123456/environment/prod". + NamespacedValue string `json:"namespacedValue,omitempty"` + // ForceSendFields is a list of field names (e.g. "NamespacedValue") 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. "NamespacedValue") 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 GooglePrivacyDlpV2TagValue) MarshalJSON() ([]byte, error) { + type NoMethod GooglePrivacyDlpV2TagValue + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GooglePrivacyDlpV2TaggedField: A column with a semantic tag attached. type GooglePrivacyDlpV2TaggedField struct { // CustomTag: A column can be tagged with a custom tag. In this case, the user @@ -9503,8 +9615,8 @@ type GooglePrivacyDlpV2TimespanConfig struct { // no lower time limit is applied. StartTime string `json:"startTime,omitempty"` // TimestampField: Specification of the field containing the timestamp of - // scanned items. Used for data sources like Datastore and BigQuery. *For - // BigQuery* If this value is not specified and the table was modified between + // scanned items. Used for data sources like Datastore and BigQuery. **For + // BigQuery** If this value is not specified and the table was modified between // the given start and end times, the entire table will be scanned. If this // value is specified, then rows are filtered based on the given start and end // times. Rows with a `NULL` value in the provided BigQuery column are skipped. @@ -9514,11 +9626,12 @@ type GooglePrivacyDlpV2TimespanConfig struct { // (https://cloud.google.com/bigquery/docs/partitioned-tables#ingestion_time), // you can use any of the following pseudo-columns as your timestamp field. // When used with Cloud DLP, these pseudo-column names are case sensitive. - - // _PARTITIONTIME - _PARTITIONDATE - _PARTITION_LOAD_TIME *For Datastore* If - // this value is specified, then entities are filtered based on the given start - // and end times. If an entity does not contain the provided timestamp property - // or contains empty or invalid values, then it is included. Valid data types - // of the provided timestamp property are: `TIMESTAMP`. See the known issue + // `_PARTITIONTIME` - `_PARTITIONDATE` - `_PARTITION_LOAD_TIME` **For + // Datastore** If this value is specified, then entities are filtered based on + // the given start and end times. If an entity does not contain the provided + // timestamp property or contains empty or invalid values, then it is included. + // Valid data types of the provided timestamp property are: `TIMESTAMP`. See + // the known issue // (https://cloud.google.com/sensitive-data-protection/docs/known-issues#bq-timespan) // related to this operation. TimestampField *GooglePrivacyDlpV2FieldId `json:"timestampField,omitempty"` @@ -10411,7 +10524,7 @@ func (c *InfoTypesListCall) LocationId(locationId string) *InfoTypesListCall { } // Parent sets the optional parameter "parent": The parent resource name. The -// format of this value is as follows: locations/ LOCATION_ID +// format of this value is as follows: `locations/{location_id}` func (c *InfoTypesListCall) Parent(parent string) *InfoTypesListCall { c.urlParams_.Set("parent", parent) return c @@ -10519,7 +10632,7 @@ type LocationsInfoTypesListCall struct { // to learn more. // // - parent: The parent resource name. The format of this value is as follows: -// locations/ LOCATION_ID. +// `locations/{location_id}`. func (r *LocationsInfoTypesService) List(parent string) *LocationsInfoTypesListCall { c := &LocationsInfoTypesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -10656,11 +10769,12 @@ type OrganizationsDeidentifyTemplatesCreateCall struct { // the scope of the request (project or organization) and whether you have // specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID + Organizations scope, location specified: -// `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no -// location specified (defaults to global): `organizations/`ORG_ID The +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` + +// Organizations scope, location specified: +// `organizations/{org_id}/locations/{location_id}` + Organizations scope, no +// location specified (defaults to global): `organizations/{org_id}` The // following example `parent` string specifies a parent project with the // identifier `example-project`, and specifies the `europe-west3` location // for processing data: @@ -10985,11 +11099,12 @@ type OrganizationsDeidentifyTemplatesListCall struct { // the scope of the request (project or organization) and whether you have // specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID + Organizations scope, location specified: -// `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no -// location specified (defaults to global): `organizations/`ORG_ID The +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` + +// Organizations scope, location specified: +// `organizations/{org_id}/locations/{location_id}` + Organizations scope, no +// location specified (defaults to global): `organizations/{org_id}` The // following example `parent` string specifies a parent project with the // identifier `example-project`, and specifies the `europe-west3` location // for processing data: @@ -11270,11 +11385,12 @@ type OrganizationsInspectTemplatesCreateCall struct { // the scope of the request (project or organization) and whether you have // specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID + Organizations scope, location specified: -// `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no -// location specified (defaults to global): `organizations/`ORG_ID The +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` + +// Organizations scope, location specified: +// `organizations/{org_id}/locations/{location_id}` + Organizations scope, no +// location specified (defaults to global): `organizations/{org_id}` The // following example `parent` string specifies a parent project with the // identifier `example-project`, and specifies the `europe-west3` location // for processing data: @@ -11598,11 +11714,12 @@ type OrganizationsInspectTemplatesListCall struct { // the scope of the request (project or organization) and whether you have // specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID + Organizations scope, location specified: -// `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no -// location specified (defaults to global): `organizations/`ORG_ID The +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` + +// Organizations scope, location specified: +// `organizations/{org_id}/locations/{location_id}` + Organizations scope, no +// location specified (defaults to global): `organizations/{org_id}` The // following example `parent` string specifies a parent project with the // identifier `example-project`, and specifies the `europe-west3` location // for processing data: @@ -12172,8 +12289,8 @@ type OrganizationsLocationsConnectionsCreateCall struct { // // - parent: Parent resource name. The format of this value varies depending on // the scope of the request (project or organization): + Projects scope: -// `projects/`PROJECT_ID`/locations/`LOCATION_ID + Organizations scope: -// `organizations/`ORG_ID`/locations/`LOCATION_ID. +// `projects/{project_id}/locations/{location_id}` + Organizations scope: +// `organizations/{org_id}/locations/{location_id}`. func (r *OrganizationsLocationsConnectionsService) Create(parent string, googleprivacydlpv2createconnectionrequest *GooglePrivacyDlpV2CreateConnectionRequest) *OrganizationsLocationsConnectionsCreateCall { c := &OrganizationsLocationsConnectionsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -12898,11 +13015,12 @@ type OrganizationsLocationsDeidentifyTemplatesCreateCall struct { // the scope of the request (project or organization) and whether you have // specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID + Organizations scope, location specified: -// `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no -// location specified (defaults to global): `organizations/`ORG_ID The +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` + +// Organizations scope, location specified: +// `organizations/{org_id}/locations/{location_id}` + Organizations scope, no +// location specified (defaults to global): `organizations/{org_id}` The // following example `parent` string specifies a parent project with the // identifier `example-project`, and specifies the `europe-west3` location // for processing data: @@ -13227,11 +13345,12 @@ type OrganizationsLocationsDeidentifyTemplatesListCall struct { // the scope of the request (project or organization) and whether you have // specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID + Organizations scope, location specified: -// `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no -// location specified (defaults to global): `organizations/`ORG_ID The +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` + +// Organizations scope, location specified: +// `organizations/{org_id}/locations/{location_id}` + Organizations scope, no +// location specified (defaults to global): `organizations/{org_id}` The // following example `parent` string specifies a parent project with the // identifier `example-project`, and specifies the `europe-west3` location // for processing data: @@ -13507,8 +13626,8 @@ type OrganizationsLocationsDiscoveryConfigsCreateCall struct { // // - parent: Parent resource name. The format of this value varies depending on // the scope of the request (project or organization): + Projects scope: -// `projects/`PROJECT_ID`/locations/`LOCATION_ID + Organizations scope: -// `organizations/`ORG_ID`/locations/`LOCATION_ID The following example +// `projects/{project_id}/locations/{location_id}` + Organizations scope: +// `organizations/{org_id}/locations/{location_id}` The following example // `parent` string specifies a parent project with the identifier // `example-project`, and specifies the `europe-west3` location for // processing data: parent=projects/example-project/locations/europe-west3. @@ -13820,7 +13939,7 @@ type OrganizationsLocationsDiscoveryConfigsListCall struct { // List: Lists discovery configurations. // // - parent: Parent resource name. The format of this value is as follows: -// `projects/`PROJECT_ID`/locations/`LOCATION_ID The following example +// `projects/{project_id}/locations/{location_id}` The following example // `parent` string specifies a parent project with the identifier // `example-project`, and specifies the `europe-west3` location for // processing data: parent=projects/example-project/locations/europe-west3. @@ -14089,11 +14208,12 @@ type OrganizationsLocationsDlpJobsListCall struct { // - parent: Parent resource name. The format of this value varies depending on // whether you have specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID The following example `parent` string specifies a -// parent project with the identifier `example-project`, and specifies the -// `europe-west3` location for processing data: +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` The +// following example `parent` string specifies a parent project with the +// identifier `example-project`, and specifies the `europe-west3` location +// for processing data: // parent=projects/example-project/locations/europe-west3. func (r *OrganizationsLocationsDlpJobsService) List(parentid string) *OrganizationsLocationsDlpJobsListCall { c := &OrganizationsLocationsDlpJobsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -14689,11 +14809,12 @@ type OrganizationsLocationsInspectTemplatesCreateCall struct { // the scope of the request (project or organization) and whether you have // specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID + Organizations scope, location specified: -// `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no -// location specified (defaults to global): `organizations/`ORG_ID The +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` + +// Organizations scope, location specified: +// `organizations/{org_id}/locations/{location_id}` + Organizations scope, no +// location specified (defaults to global): `organizations/{org_id}` The // following example `parent` string specifies a parent project with the // identifier `example-project`, and specifies the `europe-west3` location // for processing data: @@ -15017,11 +15138,12 @@ type OrganizationsLocationsInspectTemplatesListCall struct { // the scope of the request (project or organization) and whether you have // specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID + Organizations scope, location specified: -// `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no -// location specified (defaults to global): `organizations/`ORG_ID The +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` + +// Organizations scope, location specified: +// `organizations/{org_id}/locations/{location_id}` + Organizations scope, no +// location specified (defaults to global): `organizations/{org_id}` The // following example `parent` string specifies a parent project with the // identifier `example-project`, and specifies the `europe-west3` location // for processing data: @@ -15301,11 +15423,12 @@ type OrganizationsLocationsJobTriggersCreateCall struct { // - parent: Parent resource name. The format of this value varies depending on // whether you have specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID The following example `parent` string specifies a -// parent project with the identifier `example-project`, and specifies the -// `europe-west3` location for processing data: +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` The +// following example `parent` string specifies a parent project with the +// identifier `example-project`, and specifies the `europe-west3` location +// for processing data: // parent=projects/example-project/locations/europe-west3. func (r *OrganizationsLocationsJobTriggersService) Create(parentid string, googleprivacydlpv2createjobtriggerrequest *GooglePrivacyDlpV2CreateJobTriggerRequest) *OrganizationsLocationsJobTriggersCreateCall { c := &OrganizationsLocationsJobTriggersCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -15623,11 +15746,12 @@ type OrganizationsLocationsJobTriggersListCall struct { // - parent: Parent resource name. The format of this value varies depending on // whether you have specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID The following example `parent` string specifies a -// parent project with the identifier `example-project`, and specifies the -// `europe-west3` location for processing data: +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` The +// following example `parent` string specifies a parent project with the +// identifier `example-project`, and specifies the `europe-west3` location +// for processing data: // parent=projects/example-project/locations/europe-west3. func (r *OrganizationsLocationsJobTriggersService) List(parentid string) *OrganizationsLocationsJobTriggersListCall { c := &OrganizationsLocationsJobTriggersListCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -16221,11 +16345,12 @@ type OrganizationsLocationsStoredInfoTypesCreateCall struct { // the scope of the request (project or organization) and whether you have // specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID + Organizations scope, location specified: -// `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no -// location specified (defaults to global): `organizations/`ORG_ID The +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` + +// Organizations scope, location specified: +// `organizations/{org_id}/locations/{location_id}` + Organizations scope, no +// location specified (defaults to global): `organizations/{org_id}` The // following example `parent` string specifies a parent project with the // identifier `example-project`, and specifies the `europe-west3` location // for processing data: @@ -16549,11 +16674,12 @@ type OrganizationsLocationsStoredInfoTypesListCall struct { // the scope of the request (project or organization) and whether you have // specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID The following example `parent` string specifies a -// parent project with the identifier `example-project`, and specifies the -// `europe-west3` location for processing data: +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` The +// following example `parent` string specifies a parent project with the +// identifier `example-project`, and specifies the `europe-west3` location +// for processing data: // parent=projects/example-project/locations/europe-west3. func (r *OrganizationsLocationsStoredInfoTypesService) List(parentid string) *OrganizationsLocationsStoredInfoTypesListCall { c := &OrganizationsLocationsStoredInfoTypesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -17221,11 +17347,12 @@ type OrganizationsStoredInfoTypesCreateCall struct { // the scope of the request (project or organization) and whether you have // specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID + Organizations scope, location specified: -// `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no -// location specified (defaults to global): `organizations/`ORG_ID The +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` + +// Organizations scope, location specified: +// `organizations/{org_id}/locations/{location_id}` + Organizations scope, no +// location specified (defaults to global): `organizations/{org_id}` The // following example `parent` string specifies a parent project with the // identifier `example-project`, and specifies the `europe-west3` location // for processing data: @@ -17549,11 +17676,12 @@ type OrganizationsStoredInfoTypesListCall struct { // the scope of the request (project or organization) and whether you have // specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID The following example `parent` string specifies a -// parent project with the identifier `example-project`, and specifies the -// `europe-west3` location for processing data: +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` The +// following example `parent` string specifies a parent project with the +// identifier `example-project`, and specifies the `europe-west3` location +// for processing data: // parent=projects/example-project/locations/europe-west3. func (r *OrganizationsStoredInfoTypesService) List(parentid string) *OrganizationsStoredInfoTypesListCall { c := &OrganizationsStoredInfoTypesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -17834,11 +17962,12 @@ type ProjectsContentDeidentifyCall struct { // - parent: Parent resource name. The format of this value varies depending on // whether you have specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID The following example `parent` string specifies a -// parent project with the identifier `example-project`, and specifies the -// `europe-west3` location for processing data: +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` The +// following example `parent` string specifies a parent project with the +// identifier `example-project`, and specifies the `europe-west3` location +// for processing data: // parent=projects/example-project/locations/europe-west3. func (r *ProjectsContentService) Deidentify(parentid string, googleprivacydlpv2deidentifycontentrequest *GooglePrivacyDlpV2DeidentifyContentRequest) *ProjectsContentDeidentifyCall { c := &ProjectsContentDeidentifyCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -17950,11 +18079,12 @@ type ProjectsContentInspectCall struct { // - parent: Parent resource name. The format of this value varies depending on // whether you have specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID The following example `parent` string specifies a -// parent project with the identifier `example-project`, and specifies the -// `europe-west3` location for processing data: +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` The +// following example `parent` string specifies a parent project with the +// identifier `example-project`, and specifies the `europe-west3` location +// for processing data: // parent=projects/example-project/locations/europe-west3. func (r *ProjectsContentService) Inspect(parentid string, googleprivacydlpv2inspectcontentrequest *GooglePrivacyDlpV2InspectContentRequest) *ProjectsContentInspectCall { c := &ProjectsContentInspectCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -18062,11 +18192,12 @@ type ProjectsContentReidentifyCall struct { // - parent: Parent resource name. The format of this value varies depending on // whether you have specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID The following example `parent` string specifies a -// parent project with the identifier `example-project`, and specifies the -// `europe-west3` location for processing data: +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` The +// following example `parent` string specifies a parent project with the +// identifier `example-project`, and specifies the `europe-west3` location +// for processing data: // parent=projects/example-project/locations/europe-west3. func (r *ProjectsContentService) Reidentify(parentid string, googleprivacydlpv2reidentifycontentrequest *GooglePrivacyDlpV2ReidentifyContentRequest) *ProjectsContentReidentifyCall { c := &ProjectsContentReidentifyCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -18176,11 +18307,12 @@ type ProjectsDeidentifyTemplatesCreateCall struct { // the scope of the request (project or organization) and whether you have // specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID + Organizations scope, location specified: -// `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no -// location specified (defaults to global): `organizations/`ORG_ID The +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` + +// Organizations scope, location specified: +// `organizations/{org_id}/locations/{location_id}` + Organizations scope, no +// location specified (defaults to global): `organizations/{org_id}` The // following example `parent` string specifies a parent project with the // identifier `example-project`, and specifies the `europe-west3` location // for processing data: @@ -18505,11 +18637,12 @@ type ProjectsDeidentifyTemplatesListCall struct { // the scope of the request (project or organization) and whether you have // specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID + Organizations scope, location specified: -// `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no -// location specified (defaults to global): `organizations/`ORG_ID The +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` + +// Organizations scope, location specified: +// `organizations/{org_id}/locations/{location_id}` + Organizations scope, no +// location specified (defaults to global): `organizations/{org_id}` The // following example `parent` string specifies a parent project with the // identifier `example-project`, and specifies the `europe-west3` location // for processing data: @@ -18900,11 +19033,12 @@ type ProjectsDlpJobsCreateCall struct { // - parent: Parent resource name. The format of this value varies depending on // whether you have specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID The following example `parent` string specifies a -// parent project with the identifier `example-project`, and specifies the -// `europe-west3` location for processing data: +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` The +// following example `parent` string specifies a parent project with the +// identifier `example-project`, and specifies the `europe-west3` location +// for processing data: // parent=projects/example-project/locations/europe-west3. func (r *ProjectsDlpJobsService) Create(parentid string, googleprivacydlpv2createdlpjobrequest *GooglePrivacyDlpV2CreateDlpJobRequest) *ProjectsDlpJobsCreateCall { c := &ProjectsDlpJobsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -19228,11 +19362,12 @@ type ProjectsDlpJobsListCall struct { // - parent: Parent resource name. The format of this value varies depending on // whether you have specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID The following example `parent` string specifies a -// parent project with the identifier `example-project`, and specifies the -// `europe-west3` location for processing data: +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` The +// following example `parent` string specifies a parent project with the +// identifier `example-project`, and specifies the `europe-west3` location +// for processing data: // parent=projects/example-project/locations/europe-west3. func (r *ProjectsDlpJobsService) List(parentid string) *ProjectsDlpJobsListCall { c := &ProjectsDlpJobsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -19439,11 +19574,12 @@ type ProjectsImageRedactCall struct { // - parent: Parent resource name. The format of this value varies depending on // whether you have specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID The following example `parent` string specifies a -// parent project with the identifier `example-project`, and specifies the -// `europe-west3` location for processing data: +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` The +// following example `parent` string specifies a parent project with the +// identifier `example-project`, and specifies the `europe-west3` location +// for processing data: // parent=projects/example-project/locations/europe-west3. func (r *ProjectsImageService) Redact(parentid string, googleprivacydlpv2redactimagerequest *GooglePrivacyDlpV2RedactImageRequest) *ProjectsImageRedactCall { c := &ProjectsImageRedactCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -19553,11 +19689,12 @@ type ProjectsInspectTemplatesCreateCall struct { // the scope of the request (project or organization) and whether you have // specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID + Organizations scope, location specified: -// `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no -// location specified (defaults to global): `organizations/`ORG_ID The +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` + +// Organizations scope, location specified: +// `organizations/{org_id}/locations/{location_id}` + Organizations scope, no +// location specified (defaults to global): `organizations/{org_id}` The // following example `parent` string specifies a parent project with the // identifier `example-project`, and specifies the `europe-west3` location // for processing data: @@ -19881,11 +20018,12 @@ type ProjectsInspectTemplatesListCall struct { // the scope of the request (project or organization) and whether you have // specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID + Organizations scope, location specified: -// `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no -// location specified (defaults to global): `organizations/`ORG_ID The +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` + +// Organizations scope, location specified: +// `organizations/{org_id}/locations/{location_id}` + Organizations scope, no +// location specified (defaults to global): `organizations/{org_id}` The // following example `parent` string specifies a parent project with the // identifier `example-project`, and specifies the `europe-west3` location // for processing data: @@ -20269,11 +20407,12 @@ type ProjectsJobTriggersCreateCall struct { // - parent: Parent resource name. The format of this value varies depending on // whether you have specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID The following example `parent` string specifies a -// parent project with the identifier `example-project`, and specifies the -// `europe-west3` location for processing data: +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` The +// following example `parent` string specifies a parent project with the +// identifier `example-project`, and specifies the `europe-west3` location +// for processing data: // parent=projects/example-project/locations/europe-west3. func (r *ProjectsJobTriggersService) Create(parentid string, googleprivacydlpv2createjobtriggerrequest *GooglePrivacyDlpV2CreateJobTriggerRequest) *ProjectsJobTriggersCreateCall { c := &ProjectsJobTriggersCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -20591,11 +20730,12 @@ type ProjectsJobTriggersListCall struct { // - parent: Parent resource name. The format of this value varies depending on // whether you have specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID The following example `parent` string specifies a -// parent project with the identifier `example-project`, and specifies the -// `europe-west3` location for processing data: +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` The +// following example `parent` string specifies a parent project with the +// identifier `example-project`, and specifies the `europe-west3` location +// for processing data: // parent=projects/example-project/locations/europe-west3. func (r *ProjectsJobTriggersService) List(parentid string) *ProjectsJobTriggersListCall { c := &ProjectsJobTriggersListCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -21196,8 +21336,8 @@ type ProjectsLocationsConnectionsCreateCall struct { // // - parent: Parent resource name. The format of this value varies depending on // the scope of the request (project or organization): + Projects scope: -// `projects/`PROJECT_ID`/locations/`LOCATION_ID + Organizations scope: -// `organizations/`ORG_ID`/locations/`LOCATION_ID. +// `projects/{project_id}/locations/{location_id}` + Organizations scope: +// `organizations/{org_id}/locations/{location_id}`. func (r *ProjectsLocationsConnectionsService) Create(parent string, googleprivacydlpv2createconnectionrequest *GooglePrivacyDlpV2CreateConnectionRequest) *ProjectsLocationsConnectionsCreateCall { c := &ProjectsLocationsConnectionsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -21924,11 +22064,12 @@ type ProjectsLocationsContentDeidentifyCall struct { // - parent: Parent resource name. The format of this value varies depending on // whether you have specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID The following example `parent` string specifies a -// parent project with the identifier `example-project`, and specifies the -// `europe-west3` location for processing data: +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` The +// following example `parent` string specifies a parent project with the +// identifier `example-project`, and specifies the `europe-west3` location +// for processing data: // parent=projects/example-project/locations/europe-west3. func (r *ProjectsLocationsContentService) Deidentify(parentid string, googleprivacydlpv2deidentifycontentrequest *GooglePrivacyDlpV2DeidentifyContentRequest) *ProjectsLocationsContentDeidentifyCall { c := &ProjectsLocationsContentDeidentifyCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -22040,11 +22181,12 @@ type ProjectsLocationsContentInspectCall struct { // - parent: Parent resource name. The format of this value varies depending on // whether you have specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID The following example `parent` string specifies a -// parent project with the identifier `example-project`, and specifies the -// `europe-west3` location for processing data: +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` The +// following example `parent` string specifies a parent project with the +// identifier `example-project`, and specifies the `europe-west3` location +// for processing data: // parent=projects/example-project/locations/europe-west3. func (r *ProjectsLocationsContentService) Inspect(parentid string, googleprivacydlpv2inspectcontentrequest *GooglePrivacyDlpV2InspectContentRequest) *ProjectsLocationsContentInspectCall { c := &ProjectsLocationsContentInspectCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -22152,11 +22294,12 @@ type ProjectsLocationsContentReidentifyCall struct { // - parent: Parent resource name. The format of this value varies depending on // whether you have specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID The following example `parent` string specifies a -// parent project with the identifier `example-project`, and specifies the -// `europe-west3` location for processing data: +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` The +// following example `parent` string specifies a parent project with the +// identifier `example-project`, and specifies the `europe-west3` location +// for processing data: // parent=projects/example-project/locations/europe-west3. func (r *ProjectsLocationsContentService) Reidentify(parentid string, googleprivacydlpv2reidentifycontentrequest *GooglePrivacyDlpV2ReidentifyContentRequest) *ProjectsLocationsContentReidentifyCall { c := &ProjectsLocationsContentReidentifyCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -22266,11 +22409,12 @@ type ProjectsLocationsDeidentifyTemplatesCreateCall struct { // the scope of the request (project or organization) and whether you have // specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID + Organizations scope, location specified: -// `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no -// location specified (defaults to global): `organizations/`ORG_ID The +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` + +// Organizations scope, location specified: +// `organizations/{org_id}/locations/{location_id}` + Organizations scope, no +// location specified (defaults to global): `organizations/{org_id}` The // following example `parent` string specifies a parent project with the // identifier `example-project`, and specifies the `europe-west3` location // for processing data: @@ -22595,11 +22739,12 @@ type ProjectsLocationsDeidentifyTemplatesListCall struct { // the scope of the request (project or organization) and whether you have // specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID + Organizations scope, location specified: -// `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no -// location specified (defaults to global): `organizations/`ORG_ID The +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` + +// Organizations scope, location specified: +// `organizations/{org_id}/locations/{location_id}` + Organizations scope, no +// location specified (defaults to global): `organizations/{org_id}` The // following example `parent` string specifies a parent project with the // identifier `example-project`, and specifies the `europe-west3` location // for processing data: @@ -22875,8 +23020,8 @@ type ProjectsLocationsDiscoveryConfigsCreateCall struct { // // - parent: Parent resource name. The format of this value varies depending on // the scope of the request (project or organization): + Projects scope: -// `projects/`PROJECT_ID`/locations/`LOCATION_ID + Organizations scope: -// `organizations/`ORG_ID`/locations/`LOCATION_ID The following example +// `projects/{project_id}/locations/{location_id}` + Organizations scope: +// `organizations/{org_id}/locations/{location_id}` The following example // `parent` string specifies a parent project with the identifier // `example-project`, and specifies the `europe-west3` location for // processing data: parent=projects/example-project/locations/europe-west3. @@ -23188,7 +23333,7 @@ type ProjectsLocationsDiscoveryConfigsListCall struct { // List: Lists discovery configurations. // // - parent: Parent resource name. The format of this value is as follows: -// `projects/`PROJECT_ID`/locations/`LOCATION_ID The following example +// `projects/{project_id}/locations/{location_id}` The following example // `parent` string specifies a parent project with the identifier // `example-project`, and specifies the `europe-west3` location for // processing data: parent=projects/example-project/locations/europe-west3. @@ -23567,11 +23712,12 @@ type ProjectsLocationsDlpJobsCreateCall struct { // - parent: Parent resource name. The format of this value varies depending on // whether you have specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID The following example `parent` string specifies a -// parent project with the identifier `example-project`, and specifies the -// `europe-west3` location for processing data: +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` The +// following example `parent` string specifies a parent project with the +// identifier `example-project`, and specifies the `europe-west3` location +// for processing data: // parent=projects/example-project/locations/europe-west3. func (r *ProjectsLocationsDlpJobsService) Create(parentid string, googleprivacydlpv2createdlpjobrequest *GooglePrivacyDlpV2CreateDlpJobRequest) *ProjectsLocationsDlpJobsCreateCall { c := &ProjectsLocationsDlpJobsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -24102,11 +24248,12 @@ type ProjectsLocationsDlpJobsListCall struct { // - parent: Parent resource name. The format of this value varies depending on // whether you have specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID The following example `parent` string specifies a -// parent project with the identifier `example-project`, and specifies the -// `europe-west3` location for processing data: +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` The +// following example `parent` string specifies a parent project with the +// identifier `example-project`, and specifies the `europe-west3` location +// for processing data: // parent=projects/example-project/locations/europe-west3. func (r *ProjectsLocationsDlpJobsService) List(parentid string) *ProjectsLocationsDlpJobsListCall { c := &ProjectsLocationsDlpJobsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -24704,11 +24851,12 @@ type ProjectsLocationsImageRedactCall struct { // - parent: Parent resource name. The format of this value varies depending on // whether you have specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID The following example `parent` string specifies a -// parent project with the identifier `example-project`, and specifies the -// `europe-west3` location for processing data: +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` The +// following example `parent` string specifies a parent project with the +// identifier `example-project`, and specifies the `europe-west3` location +// for processing data: // parent=projects/example-project/locations/europe-west3. func (r *ProjectsLocationsImageService) Redact(parentid string, googleprivacydlpv2redactimagerequest *GooglePrivacyDlpV2RedactImageRequest) *ProjectsLocationsImageRedactCall { c := &ProjectsLocationsImageRedactCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -24818,11 +24966,12 @@ type ProjectsLocationsInspectTemplatesCreateCall struct { // the scope of the request (project or organization) and whether you have // specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID + Organizations scope, location specified: -// `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no -// location specified (defaults to global): `organizations/`ORG_ID The +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` + +// Organizations scope, location specified: +// `organizations/{org_id}/locations/{location_id}` + Organizations scope, no +// location specified (defaults to global): `organizations/{org_id}` The // following example `parent` string specifies a parent project with the // identifier `example-project`, and specifies the `europe-west3` location // for processing data: @@ -25146,11 +25295,12 @@ type ProjectsLocationsInspectTemplatesListCall struct { // the scope of the request (project or organization) and whether you have // specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID + Organizations scope, location specified: -// `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no -// location specified (defaults to global): `organizations/`ORG_ID The +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` + +// Organizations scope, location specified: +// `organizations/{org_id}/locations/{location_id}` + Organizations scope, no +// location specified (defaults to global): `organizations/{org_id}` The // following example `parent` string specifies a parent project with the // identifier `example-project`, and specifies the `europe-west3` location // for processing data: @@ -25534,11 +25684,12 @@ type ProjectsLocationsJobTriggersCreateCall struct { // - parent: Parent resource name. The format of this value varies depending on // whether you have specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID The following example `parent` string specifies a -// parent project with the identifier `example-project`, and specifies the -// `europe-west3` location for processing data: +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` The +// following example `parent` string specifies a parent project with the +// identifier `example-project`, and specifies the `europe-west3` location +// for processing data: // parent=projects/example-project/locations/europe-west3. func (r *ProjectsLocationsJobTriggersService) Create(parentid string, googleprivacydlpv2createjobtriggerrequest *GooglePrivacyDlpV2CreateJobTriggerRequest) *ProjectsLocationsJobTriggersCreateCall { c := &ProjectsLocationsJobTriggersCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -25961,11 +26112,12 @@ type ProjectsLocationsJobTriggersListCall struct { // - parent: Parent resource name. The format of this value varies depending on // whether you have specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID The following example `parent` string specifies a -// parent project with the identifier `example-project`, and specifies the -// `europe-west3` location for processing data: +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` The +// following example `parent` string specifies a parent project with the +// identifier `example-project`, and specifies the `europe-west3` location +// for processing data: // parent=projects/example-project/locations/europe-west3. func (r *ProjectsLocationsJobTriggersService) List(parentid string) *ProjectsLocationsJobTriggersListCall { c := &ProjectsLocationsJobTriggersListCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -26559,11 +26711,12 @@ type ProjectsLocationsStoredInfoTypesCreateCall struct { // the scope of the request (project or organization) and whether you have // specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID + Organizations scope, location specified: -// `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no -// location specified (defaults to global): `organizations/`ORG_ID The +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` + +// Organizations scope, location specified: +// `organizations/{org_id}/locations/{location_id}` + Organizations scope, no +// location specified (defaults to global): `organizations/{org_id}` The // following example `parent` string specifies a parent project with the // identifier `example-project`, and specifies the `europe-west3` location // for processing data: @@ -26887,11 +27040,12 @@ type ProjectsLocationsStoredInfoTypesListCall struct { // the scope of the request (project or organization) and whether you have // specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID The following example `parent` string specifies a -// parent project with the identifier `example-project`, and specifies the -// `europe-west3` location for processing data: +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` The +// following example `parent` string specifies a parent project with the +// identifier `example-project`, and specifies the `europe-west3` location +// for processing data: // parent=projects/example-project/locations/europe-west3. func (r *ProjectsLocationsStoredInfoTypesService) List(parentid string) *ProjectsLocationsStoredInfoTypesListCall { c := &ProjectsLocationsStoredInfoTypesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -27559,11 +27713,12 @@ type ProjectsStoredInfoTypesCreateCall struct { // the scope of the request (project or organization) and whether you have // specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID + Organizations scope, location specified: -// `organizations/`ORG_ID`/locations/`LOCATION_ID + Organizations scope, no -// location specified (defaults to global): `organizations/`ORG_ID The +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` + +// Organizations scope, location specified: +// `organizations/{org_id}/locations/{location_id}` + Organizations scope, no +// location specified (defaults to global): `organizations/{org_id}` The // following example `parent` string specifies a parent project with the // identifier `example-project`, and specifies the `europe-west3` location // for processing data: @@ -27887,11 +28042,12 @@ type ProjectsStoredInfoTypesListCall struct { // the scope of the request (project or organization) and whether you have // specified a processing location // (https://cloud.google.com/sensitive-data-protection/docs/specifying-location): -// - Projects scope, location specified: `projects/`PROJECT_ID`/locations/` -// LOCATION_ID + Projects scope, no location specified (defaults to global): -// `projects/`PROJECT_ID The following example `parent` string specifies a -// parent project with the identifier `example-project`, and specifies the -// `europe-west3` location for processing data: +// - Projects scope, location specified: +// `projects/{project_id}/locations/{location_id}` + Projects scope, no +// location specified (defaults to global): `projects/{project_id}` The +// following example `parent` string specifies a parent project with the +// identifier `example-project`, and specifies the `europe-west3` location +// for processing data: // parent=projects/example-project/locations/europe-west3. func (r *ProjectsStoredInfoTypesService) List(parentid string) *ProjectsStoredInfoTypesListCall { c := &ProjectsStoredInfoTypesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} diff --git a/documentai/v1/documentai-api.json b/documentai/v1/documentai-api.json index b35165ed3eb..aaf83d7070d 100644 --- a/documentai/v1/documentai-api.json +++ b/documentai/v1/documentai-api.json @@ -1042,7 +1042,7 @@ } } }, - "revision": "20240716", + "revision": "20240813", "rootUrl": "https://documentai.googleapis.com/", "schemas": { "GoogleCloudDocumentaiUiv1beta3AutoLabelDocumentsMetadata": { @@ -4471,6 +4471,10 @@ "$ref": "GoogleCloudDocumentaiV1GcsDocument", "description": "A raw document on Google Cloud Storage." }, + "imagelessMode": { + "description": "Optional. Option to remove images from the document.", + "type": "boolean" + }, "inlineDocument": { "$ref": "GoogleCloudDocumentaiV1Document", "description": "An inline document proto." diff --git a/documentai/v1/documentai-gen.go b/documentai/v1/documentai-gen.go index d942a0a2fe8..46af4f9b57f 100644 --- a/documentai/v1/documentai-gen.go +++ b/documentai/v1/documentai-gen.go @@ -4839,6 +4839,8 @@ type GoogleCloudDocumentaiV1ProcessRequest struct { FieldMask string `json:"fieldMask,omitempty"` // GcsDocument: A raw document on Google Cloud Storage. GcsDocument *GoogleCloudDocumentaiV1GcsDocument `json:"gcsDocument,omitempty"` + // ImagelessMode: Optional. Option to remove images from the document. + ImagelessMode bool `json:"imagelessMode,omitempty"` // InlineDocument: An inline document proto. InlineDocument *GoogleCloudDocumentaiV1Document `json:"inlineDocument,omitempty"` // Labels: Optional. The labels with user-defined metadata for the request. diff --git a/documentai/v1beta3/documentai-api.json b/documentai/v1beta3/documentai-api.json index 2f94a28dca8..90f48fb6a5f 100644 --- a/documentai/v1beta3/documentai-api.json +++ b/documentai/v1beta3/documentai-api.json @@ -1284,7 +1284,7 @@ } } }, - "revision": "20240716", + "revision": "20240813", "rootUrl": "https://documentai.googleapis.com/", "schemas": { "GoogleCloudDocumentaiUiv1beta3AutoLabelDocumentsMetadata": { @@ -9073,6 +9073,10 @@ "$ref": "GoogleCloudDocumentaiV1beta3GcsDocument", "description": "A raw document on Google Cloud Storage." }, + "imagelessMode": { + "description": "Optional. Option to remove images from the document.", + "type": "boolean" + }, "inlineDocument": { "$ref": "GoogleCloudDocumentaiV1beta3Document", "description": "An inline document proto." diff --git a/documentai/v1beta3/documentai-gen.go b/documentai/v1beta3/documentai-gen.go index d43435983d5..dac275c3bc6 100644 --- a/documentai/v1beta3/documentai-gen.go +++ b/documentai/v1beta3/documentai-gen.go @@ -10565,6 +10565,8 @@ type GoogleCloudDocumentaiV1beta3ProcessRequest struct { FieldMask string `json:"fieldMask,omitempty"` // GcsDocument: A raw document on Google Cloud Storage. GcsDocument *GoogleCloudDocumentaiV1beta3GcsDocument `json:"gcsDocument,omitempty"` + // ImagelessMode: Optional. Option to remove images from the document. + ImagelessMode bool `json:"imagelessMode,omitempty"` // InlineDocument: An inline document proto. InlineDocument *GoogleCloudDocumentaiV1beta3Document `json:"inlineDocument,omitempty"` // Labels: Optional. The labels with user-defined metadata for the request. diff --git a/drive/v2/drive-api.json b/drive/v2/drive-api.json index d4542a7873e..137b4ec21ad 100644 --- a/drive/v2/drive-api.json +++ b/drive/v2/drive-api.json @@ -3869,7 +3869,7 @@ } } }, - "revision": "20240730", + "revision": "20240809", "rootUrl": "https://www.googleapis.com/", "schemas": { "About": { @@ -5469,7 +5469,7 @@ }, "lastModifyingUser": { "$ref": "User", - "description": "Output only. The last user to modify this file." + "description": "Output only. The last user to modify this file. This field is only populated when the last modification was performed by a signed-in user." }, "lastModifyingUserName": { "description": "Output only. Name of the last user to modify this file.", @@ -5547,7 +5547,7 @@ "type": "array" }, "parents": { - "description": "Collection of parent folders which contain this file. If not specified as part of an insert request, the file will be placed directly in the user's My Drive folder. If not specified as part of a copy request, the file will inherit any discoverable parents of the source file. Update requests can also use the `addParents` and `removeParents` parameters to modify the parents list.", + "description": "The ID of the parent folder containing the file. A file can only have one parent folder; specifying multiple parents isn't supported. If not specified as part of an insert request, the file is placed directly in the user's My Drive folder. If not specified as part of a copy request, the file inherits any discoverable parent of the source file. Update requests must use the `addParents` and `removeParents` parameters to modify the parents list.", "items": { "$ref": "ParentReference" }, @@ -6049,7 +6049,7 @@ "type": "object" }, "ParentReference": { - "description": "A reference to a file's parent. Some resource methods (such as `parents.get`) require a `parentId`. Use the `parents.list` method to retrieve the ID for a parent.", + "description": "A reference to a file's parent. A file can only have one parent folder; specifying multiple parents isn't supported. Some resource methods (such as `parents.get`) require a `parentId`. Use the `parents.list` method to retrieve the ID for a parent.", "id": "ParentReference", "properties": { "id": { @@ -6394,7 +6394,7 @@ }, "lastModifyingUser": { "$ref": "User", - "description": "Output only. The last user to modify this revision." + "description": "Output only. The last user to modify this revision. This field is only populated when the last modification was performed by a signed-in user." }, "lastModifyingUserName": { "description": "Output only. Name of the last user to modify this revision.", diff --git a/drive/v2/drive-gen.go b/drive/v2/drive-gen.go index 8ed6e50e3fb..aa0ea731906 100644 --- a/drive/v2/drive-gen.go +++ b/drive/v2/drive-gen.go @@ -1697,7 +1697,9 @@ type File struct { LabelInfo *FileLabelInfo `json:"labelInfo,omitempty"` // Labels: A group of labels for the file. Labels *FileLabels `json:"labels,omitempty"` - // LastModifyingUser: Output only. The last user to modify this file. + // LastModifyingUser: Output only. The last user to modify this file. This + // field is only populated when the last modification was performed by a + // signed-in user. LastModifyingUser *User `json:"lastModifyingUser,omitempty"` // LastModifyingUserName: Output only. Name of the last user to modify this // file. @@ -1744,12 +1746,13 @@ type File struct { // have more than one owner. This field isn't populated for items in shared // drives. Owners []*User `json:"owners,omitempty"` - // Parents: Collection of parent folders which contain this file. If not - // specified as part of an insert request, the file will be placed directly in - // the user's My Drive folder. If not specified as part of a copy request, the - // file will inherit any discoverable parents of the source file. Update - // requests can also use the `addParents` and `removeParents` parameters to - // modify the parents list. + // Parents: The ID of the parent folder containing the file. A file can only + // have one parent folder; specifying multiple parents isn't supported. If not + // specified as part of an insert request, the file is placed directly in the + // user's My Drive folder. If not specified as part of a copy request, the file + // inherits any discoverable parent of the source file. Update requests must + // use the `addParents` and `removeParents` parameters to modify the parents + // list. Parents []*ParentReference `json:"parents,omitempty"` // PermissionIds: Output only. List of permission IDs for users with access to // this file. @@ -2677,9 +2680,10 @@ func (s ParentList) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// ParentReference: A reference to a file's parent. Some resource methods (such -// as `parents.get`) require a `parentId`. Use the `parents.list` method to -// retrieve the ID for a parent. +// ParentReference: A reference to a file's parent. A file can only have one +// parent folder; specifying multiple parents isn't supported. Some resource +// methods (such as `parents.get`) require a `parentId`. Use the `parents.list` +// method to retrieve the ID for a parent. type ParentReference struct { // Id: The ID of the parent. Id string `json:"id,omitempty"` @@ -3035,7 +3039,9 @@ type Revision struct { Id string `json:"id,omitempty"` // Kind: Output only. This is always `drive#revision`. Kind string `json:"kind,omitempty"` - // LastModifyingUser: Output only. The last user to modify this revision. + // LastModifyingUser: Output only. The last user to modify this revision. This + // field is only populated when the last modification was performed by a + // signed-in user. LastModifyingUser *User `json:"lastModifyingUser,omitempty"` // LastModifyingUserName: Output only. Name of the last user to modify this // revision. diff --git a/drive/v3/drive-api.json b/drive/v3/drive-api.json index 609829fe586..703e7117889 100644 --- a/drive/v3/drive-api.json +++ b/drive/v3/drive-api.json @@ -2523,7 +2523,7 @@ } } }, - "revision": "20240730", + "revision": "20240809", "rootUrl": "https://www.googleapis.com/", "schemas": { "About": { @@ -3735,7 +3735,7 @@ }, "lastModifyingUser": { "$ref": "User", - "description": "Output only. The last user to modify the file." + "description": "Output only. The last user to modify the file. This field is only populated when the last modification was performed by a signed-in user." }, "linkShareMetadata": { "description": "Contains details about the link URLs that clients are using to refer to this item.", @@ -3793,7 +3793,7 @@ "type": "array" }, "parents": { - "description": "The IDs of the parent folders which contain the file. If not specified as part of a create request, the file is placed directly in the user's My Drive folder. If not specified as part of a copy request, the file inherits any discoverable parents of the source file. Update requests must use the `addParents` and `removeParents` parameters to modify the parents list.", + "description": "The ID of the parent folder containing the file. A file can only have one parent folder; specifying multiple parents isn't supported. If not specified as part of a create request, the file is placed directly in the user's My Drive folder. If not specified as part of a copy request, the file inherits any discoverable parent of the source file. Update requests must use the `addParents` and `removeParents` parameters to modify the parents list.", "items": { "type": "string" }, @@ -4494,7 +4494,7 @@ }, "lastModifyingUser": { "$ref": "User", - "description": "Output only. The last user to modify this revision." + "description": "Output only. The last user to modify this revision. This field is only populated when the last modification was performed by a signed-in user." }, "md5Checksum": { "description": "Output only. The MD5 checksum of the revision's content. This is only applicable to files with binary content in Drive.", diff --git a/drive/v3/drive-gen.go b/drive/v3/drive-gen.go index 3f4042bf8a1..5a35b65a854 100644 --- a/drive/v3/drive-gen.go +++ b/drive/v3/drive-gen.go @@ -1286,7 +1286,9 @@ type File struct { Kind string `json:"kind,omitempty"` // LabelInfo: Output only. An overview of the labels on the file. LabelInfo *FileLabelInfo `json:"labelInfo,omitempty"` - // LastModifyingUser: Output only. The last user to modify the file. + // LastModifyingUser: Output only. The last user to modify the file. This field + // is only populated when the last modification was performed by a signed-in + // user. LastModifyingUser *User `json:"lastModifyingUser,omitempty"` // LinkShareMetadata: Contains details about the link URLs that clients are // using to refer to this item. @@ -1325,10 +1327,11 @@ type File struct { // have more than one owner. This field isn't populated for items in shared // drives. Owners []*User `json:"owners,omitempty"` - // Parents: The IDs of the parent folders which contain the file. If not + // Parents: The ID of the parent folder containing the file. A file can only + // have one parent folder; specifying multiple parents isn't supported. If not // specified as part of a create request, the file is placed directly in the // user's My Drive folder. If not specified as part of a copy request, the file - // inherits any discoverable parents of the source file. Update requests must + // inherits any discoverable parent of the source file. Update requests must // use the `addParents` and `removeParents` parameters to modify the parents // list. Parents []string `json:"parents,omitempty"` @@ -2487,7 +2490,9 @@ type Revision struct { // Kind: Output only. Identifies what kind of resource this is. Value: the // fixed string "drive#revision". Kind string `json:"kind,omitempty"` - // LastModifyingUser: Output only. The last user to modify this revision. + // LastModifyingUser: Output only. The last user to modify this revision. This + // field is only populated when the last modification was performed by a + // signed-in user. LastModifyingUser *User `json:"lastModifyingUser,omitempty"` // Md5Checksum: Output only. The MD5 checksum of the revision's content. This // is only applicable to files with binary content in Drive. diff --git a/firebaseml/v2beta/firebaseml-api.json b/firebaseml/v2beta/firebaseml-api.json index f33346d3a6c..ab61e736519 100644 --- a/firebaseml/v2beta/firebaseml-api.json +++ b/firebaseml/v2beta/firebaseml-api.json @@ -206,7 +206,7 @@ } } }, - "revision": "20240808", + "revision": "20240813", "rootUrl": "https://firebaseml.googleapis.com/", "schemas": { "Date": { @@ -290,7 +290,7 @@ "The finish reason is unspecified.", "Token generation reached a natural stopping point or a configured stop sequence.", "Token generation reached the configured maximum output tokens.", - "Token generation stopped because the content potentially contains safety violations. NOTE: When streaming, Candidate.content is empty if content filters blocks the output.", + "Token generation stopped because the content potentially contains safety violations. NOTE: When streaming, content is empty if content filters blocks the output.", "Token generation stopped because the content potentially contains copyright violations.", "All other reasons that stopped the token generation.", "Token generation stopped because the content contains forbidden terms.", @@ -503,9 +503,9 @@ ], "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 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." + "Default model behavior, model decides to predict either function calls or natural language response.", + "Model is constrained to always predicting function calls only. If \"allowed_function_names\" are set, the predicted function calls will be limited to any one of \"allowed_function_names\", else the predicted function calls will be any one of the provided \"function_declarations\".", + "Model will not predict any function calls. Model behavior is same as when not passing any function declarations." ], "type": "string" } @@ -1305,11 +1305,11 @@ "type": "object" }, "GoogleCloudAiplatformV1beta1VertexAISearch": { - "description": "Retrieve from Vertex AI Search datastore for grounding. See https://cloud.google.com/vertex-ai-search-and-conversation", + "description": "Retrieve from Vertex AI Search datastore for grounding. See https://cloud.google.com/products/agent-builder", "id": "GoogleCloudAiplatformV1beta1VertexAISearch", "properties": { "datastore": { - "description": "Required. Fully-qualified Vertex AI Search's datastore resource ID. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}`", + "description": "Required. Fully-qualified Vertex AI Search data store resource ID. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}`", "type": "string" } }, diff --git a/firebaseml/v2beta/firebaseml-gen.go b/firebaseml/v2beta/firebaseml-gen.go index 0495747aa68..bda7c304977 100644 --- a/firebaseml/v2beta/firebaseml-gen.go +++ b/firebaseml/v2beta/firebaseml-gen.go @@ -284,8 +284,8 @@ type GoogleCloudAiplatformV1beta1Candidate struct { // "MAX_TOKENS" - Token generation reached the configured maximum output // tokens. // "SAFETY" - Token generation stopped because the content potentially - // contains safety violations. NOTE: When streaming, Candidate.content is empty - // if content filters blocks the output. + // contains safety violations. NOTE: When streaming, content is empty if + // content filters blocks the output. // "RECITATION" - Token generation stopped because the content potentially // contains copyright violations. // "OTHER" - All other reasons that stopped the token generation. @@ -557,13 +557,13 @@ type GoogleCloudAiplatformV1beta1FunctionCallingConfig struct { // Possible values: // "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 response. - // "ANY" - Model is constrained to always predicting a function call only. If - // "allowed_function_names" are set, the predicted function call will be + // "AUTO" - Default model behavior, model decides to predict either function + // calls or natural language response. + // "ANY" - Model is constrained to always predicting function calls only. If + // "allowed_function_names" are set, the predicted function calls will be // limited to any one of "allowed_function_names", else the predicted function - // call will be any one of the provided "function_declarations". - // "NONE" - Model will not predict any function call. Model behavior is same + // calls will be any one of the provided "function_declarations". + // "NONE" - Model will not predict any function calls. Model behavior is same // as when not passing any function declarations. Mode string `json:"mode,omitempty"` // ForceSendFields is a list of field names (e.g. "AllowedFunctionNames") to @@ -1532,10 +1532,9 @@ func (s GoogleCloudAiplatformV1beta1ToolConfig) MarshalJSON() ([]byte, error) { } // GoogleCloudAiplatformV1beta1VertexAISearch: Retrieve from Vertex AI Search -// datastore for grounding. See -// https://cloud.google.com/vertex-ai-search-and-conversation +// datastore for grounding. See https://cloud.google.com/products/agent-builder type GoogleCloudAiplatformV1beta1VertexAISearch struct { - // Datastore: Required. Fully-qualified Vertex AI Search's datastore resource + // Datastore: Required. Fully-qualified Vertex AI Search data store resource // ID. Format: // `projects/{project}/locations/{location}/collections/{collection}/dataStores/ // {dataStore}` diff --git a/gkehub/v1/gkehub-api.json b/gkehub/v1/gkehub-api.json index 95f38398cf2..3c0de6cf222 100644 --- a/gkehub/v1/gkehub-api.json +++ b/gkehub/v1/gkehub-api.json @@ -2111,7 +2111,7 @@ } } }, - "revision": "20240727", + "revision": "20240809", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AppDevExperienceFeatureSpec": { @@ -2593,6 +2593,44 @@ }, "type": "object" }, + "CompliancePostureConfig": { + "description": "CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture.", + "id": "CompliancePostureConfig", + "properties": { + "complianceStandards": { + "description": "List of enabled compliance standards.", + "items": { + "$ref": "ComplianceStandard" + }, + "type": "array" + }, + "mode": { + "description": "Defines the enablement mode for Compliance Posture.", + "enum": [ + "MODE_UNSPECIFIED", + "DISABLED", + "ENABLED" + ], + "enumDescriptions": [ + "Default value not specified.", + "Disables Compliance Posture features on the cluster.", + "Enables Compliance Posture features on the cluster." + ], + "type": "string" + } + }, + "type": "object" + }, + "ComplianceStandard": { + "id": "ComplianceStandard", + "properties": { + "standard": { + "description": "Name of the compliance standard.", + "type": "string" + } + }, + "type": "object" + }, "ConfigManagementConfigSync": { "description": "Configuration for Config Sync", "id": "ConfigManagementConfigSync", @@ -3559,6 +3597,10 @@ "$ref": "BinaryAuthorizationConfig", "description": "Optional. Enable/Disable binary authorization features for the cluster." }, + "compliancePostureConfig": { + "$ref": "CompliancePostureConfig", + "description": "Optional. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask." + }, "securityPostureConfig": { "$ref": "SecurityPostureConfig", "description": "Enable/Disable Security Posture features for the cluster." diff --git a/gkehub/v1/gkehub-gen.go b/gkehub/v1/gkehub-gen.go index 50024af0dc1..15044b88568 100644 --- a/gkehub/v1/gkehub-gen.go +++ b/gkehub/v1/gkehub-gen.go @@ -1062,6 +1062,57 @@ func (s CommonFleetDefaultMemberConfigSpec) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// CompliancePostureConfig: CompliancePostureConfig defines the settings needed +// to enable/disable features for the Compliance Posture. +type CompliancePostureConfig struct { + // ComplianceStandards: List of enabled compliance standards. + ComplianceStandards []*ComplianceStandard `json:"complianceStandards,omitempty"` + // Mode: Defines the enablement mode for Compliance Posture. + // + // Possible values: + // "MODE_UNSPECIFIED" - Default value not specified. + // "DISABLED" - Disables Compliance Posture features on the cluster. + // "ENABLED" - Enables Compliance Posture features on the cluster. + Mode string `json:"mode,omitempty"` + // ForceSendFields is a list of field names (e.g. "ComplianceStandards") 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. "ComplianceStandards") 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 CompliancePostureConfig) MarshalJSON() ([]byte, error) { + type NoMethod CompliancePostureConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type ComplianceStandard struct { + // Standard: Name of the compliance standard. + Standard string `json:"standard,omitempty"` + // ForceSendFields is a list of field names (e.g. "Standard") 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. "Standard") 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 ComplianceStandard) MarshalJSON() ([]byte, error) { + type NoMethod ComplianceStandard + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ConfigManagementConfigSync: Configuration for Config Sync type ConfigManagementConfigSync struct { // AllowVerticalScale: Set to true to allow the vertical scaling. Defaults to @@ -2059,6 +2110,11 @@ type DefaultClusterConfig struct { // BinaryAuthorizationConfig: Optional. Enable/Disable binary authorization // features for the cluster. BinaryAuthorizationConfig *BinaryAuthorizationConfig `json:"binaryAuthorizationConfig,omitempty"` + // CompliancePostureConfig: Optional. Enable/Disable Compliance Posture + // features for the cluster. Note that on UpdateFleet, only full replacement of + // this field is allowed. Users are not allowed for partial updates through + // field mask. + CompliancePostureConfig *CompliancePostureConfig `json:"compliancePostureConfig,omitempty"` // SecurityPostureConfig: Enable/Disable Security Posture features for the // cluster. SecurityPostureConfig *SecurityPostureConfig `json:"securityPostureConfig,omitempty"` diff --git a/gkehub/v1alpha/gkehub-api.json b/gkehub/v1alpha/gkehub-api.json index e0663e2dbc7..0495bb3bb4a 100644 --- a/gkehub/v1alpha/gkehub-api.json +++ b/gkehub/v1alpha/gkehub-api.json @@ -2185,7 +2185,7 @@ } } }, - "revision": "20240727", + "revision": "20240809", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AnthosObservabilityFeatureSpec": { @@ -2817,6 +2817,44 @@ }, "type": "object" }, + "CompliancePostureConfig": { + "description": "CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture.", + "id": "CompliancePostureConfig", + "properties": { + "complianceStandards": { + "description": "List of enabled compliance standards.", + "items": { + "$ref": "ComplianceStandard" + }, + "type": "array" + }, + "mode": { + "description": "Defines the enablement mode for Compliance Posture.", + "enum": [ + "MODE_UNSPECIFIED", + "DISABLED", + "ENABLED" + ], + "enumDescriptions": [ + "Default value not specified.", + "Disables Compliance Posture features on the cluster.", + "Enables Compliance Posture features on the cluster." + ], + "type": "string" + } + }, + "type": "object" + }, + "ComplianceStandard": { + "id": "ComplianceStandard", + "properties": { + "standard": { + "description": "Name of the compliance standard.", + "type": "string" + } + }, + "type": "object" + }, "ConfigManagementBinauthzConfig": { "description": "Configuration for Binauthz", "id": "ConfigManagementBinauthzConfig", @@ -3843,6 +3881,10 @@ "$ref": "BinaryAuthorizationConfig", "description": "Optional. Enable/Disable binary authorization features for the cluster." }, + "compliancePostureConfig": { + "$ref": "CompliancePostureConfig", + "description": "Optional. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask." + }, "securityPostureConfig": { "$ref": "SecurityPostureConfig", "description": "Enable/Disable Security Posture features for the cluster." diff --git a/gkehub/v1alpha/gkehub-gen.go b/gkehub/v1alpha/gkehub-gen.go index 312db926445..5a296bef10e 100644 --- a/gkehub/v1alpha/gkehub-gen.go +++ b/gkehub/v1alpha/gkehub-gen.go @@ -1254,6 +1254,57 @@ func (s CommonFleetDefaultMemberConfigSpec) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// CompliancePostureConfig: CompliancePostureConfig defines the settings needed +// to enable/disable features for the Compliance Posture. +type CompliancePostureConfig struct { + // ComplianceStandards: List of enabled compliance standards. + ComplianceStandards []*ComplianceStandard `json:"complianceStandards,omitempty"` + // Mode: Defines the enablement mode for Compliance Posture. + // + // Possible values: + // "MODE_UNSPECIFIED" - Default value not specified. + // "DISABLED" - Disables Compliance Posture features on the cluster. + // "ENABLED" - Enables Compliance Posture features on the cluster. + Mode string `json:"mode,omitempty"` + // ForceSendFields is a list of field names (e.g. "ComplianceStandards") 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. "ComplianceStandards") 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 CompliancePostureConfig) MarshalJSON() ([]byte, error) { + type NoMethod CompliancePostureConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type ComplianceStandard struct { + // Standard: Name of the compliance standard. + Standard string `json:"standard,omitempty"` + // ForceSendFields is a list of field names (e.g. "Standard") 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. "Standard") 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 ComplianceStandard) MarshalJSON() ([]byte, error) { + type NoMethod ComplianceStandard + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ConfigManagementBinauthzConfig: Configuration for Binauthz type ConfigManagementBinauthzConfig struct { // Enabled: Whether binauthz is enabled in this cluster. @@ -2331,6 +2382,11 @@ type DefaultClusterConfig struct { // BinaryAuthorizationConfig: Optional. Enable/Disable binary authorization // features for the cluster. BinaryAuthorizationConfig *BinaryAuthorizationConfig `json:"binaryAuthorizationConfig,omitempty"` + // CompliancePostureConfig: Optional. Enable/Disable Compliance Posture + // features for the cluster. Note that on UpdateFleet, only full replacement of + // this field is allowed. Users are not allowed for partial updates through + // field mask. + CompliancePostureConfig *CompliancePostureConfig `json:"compliancePostureConfig,omitempty"` // SecurityPostureConfig: Enable/Disable Security Posture features for the // cluster. SecurityPostureConfig *SecurityPostureConfig `json:"securityPostureConfig,omitempty"` diff --git a/gkehub/v1beta/gkehub-api.json b/gkehub/v1beta/gkehub-api.json index 28959f8014d..3996215ce41 100644 --- a/gkehub/v1beta/gkehub-api.json +++ b/gkehub/v1beta/gkehub-api.json @@ -2111,7 +2111,7 @@ } } }, - "revision": "20240727", + "revision": "20240809", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AnthosObservabilityFeatureSpec": { @@ -2627,6 +2627,44 @@ }, "type": "object" }, + "CompliancePostureConfig": { + "description": "CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture.", + "id": "CompliancePostureConfig", + "properties": { + "complianceStandards": { + "description": "List of enabled compliance standards.", + "items": { + "$ref": "ComplianceStandard" + }, + "type": "array" + }, + "mode": { + "description": "Defines the enablement mode for Compliance Posture.", + "enum": [ + "MODE_UNSPECIFIED", + "DISABLED", + "ENABLED" + ], + "enumDescriptions": [ + "Default value not specified.", + "Disables Compliance Posture features on the cluster.", + "Enables Compliance Posture features on the cluster." + ], + "type": "string" + } + }, + "type": "object" + }, + "ComplianceStandard": { + "id": "ComplianceStandard", + "properties": { + "standard": { + "description": "Name of the compliance standard.", + "type": "string" + } + }, + "type": "object" + }, "ConfigManagementBinauthzConfig": { "description": "Configuration for Binauthz", "id": "ConfigManagementBinauthzConfig", @@ -3653,6 +3691,10 @@ "$ref": "BinaryAuthorizationConfig", "description": "Optional. Enable/Disable binary authorization features for the cluster." }, + "compliancePostureConfig": { + "$ref": "CompliancePostureConfig", + "description": "Optional. Enable/Disable Compliance Posture features for the cluster. Note that on UpdateFleet, only full replacement of this field is allowed. Users are not allowed for partial updates through field mask." + }, "securityPostureConfig": { "$ref": "SecurityPostureConfig", "description": "Enable/Disable Security Posture features for the cluster." diff --git a/gkehub/v1beta/gkehub-gen.go b/gkehub/v1beta/gkehub-gen.go index b534ff73d64..988f7248767 100644 --- a/gkehub/v1beta/gkehub-gen.go +++ b/gkehub/v1beta/gkehub-gen.go @@ -1115,6 +1115,57 @@ func (s CommonFleetDefaultMemberConfigSpec) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// CompliancePostureConfig: CompliancePostureConfig defines the settings needed +// to enable/disable features for the Compliance Posture. +type CompliancePostureConfig struct { + // ComplianceStandards: List of enabled compliance standards. + ComplianceStandards []*ComplianceStandard `json:"complianceStandards,omitempty"` + // Mode: Defines the enablement mode for Compliance Posture. + // + // Possible values: + // "MODE_UNSPECIFIED" - Default value not specified. + // "DISABLED" - Disables Compliance Posture features on the cluster. + // "ENABLED" - Enables Compliance Posture features on the cluster. + Mode string `json:"mode,omitempty"` + // ForceSendFields is a list of field names (e.g. "ComplianceStandards") 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. "ComplianceStandards") 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 CompliancePostureConfig) MarshalJSON() ([]byte, error) { + type NoMethod CompliancePostureConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type ComplianceStandard struct { + // Standard: Name of the compliance standard. + Standard string `json:"standard,omitempty"` + // ForceSendFields is a list of field names (e.g. "Standard") 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. "Standard") 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 ComplianceStandard) MarshalJSON() ([]byte, error) { + type NoMethod ComplianceStandard + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ConfigManagementBinauthzConfig: Configuration for Binauthz type ConfigManagementBinauthzConfig struct { // Enabled: Whether binauthz is enabled in this cluster. @@ -2192,6 +2243,11 @@ type DefaultClusterConfig struct { // BinaryAuthorizationConfig: Optional. Enable/Disable binary authorization // features for the cluster. BinaryAuthorizationConfig *BinaryAuthorizationConfig `json:"binaryAuthorizationConfig,omitempty"` + // CompliancePostureConfig: Optional. Enable/Disable Compliance Posture + // features for the cluster. Note that on UpdateFleet, only full replacement of + // this field is allowed. Users are not allowed for partial updates through + // field mask. + CompliancePostureConfig *CompliancePostureConfig `json:"compliancePostureConfig,omitempty"` // SecurityPostureConfig: Enable/Disable Security Posture features for the // cluster. SecurityPostureConfig *SecurityPostureConfig `json:"securityPostureConfig,omitempty"` diff --git a/gkehub/v2/gkehub-api.json b/gkehub/v2/gkehub-api.json new file mode 100644 index 00000000000..993a11c62b1 --- /dev/null +++ b/gkehub/v2/gkehub-api.json @@ -0,0 +1,435 @@ +{ + "auth": { + "oauth2": { + "scopes": { + "https://www.googleapis.com/auth/cloud-platform": { + "description": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account." + } + } + } + }, + "basePath": "", + "baseUrl": "https://gkehub.googleapis.com/", + "batchPath": "batch", + "canonicalName": "GKE Hub", + "description": "", + "discoveryVersion": "v1", + "documentationLink": "https://cloud.google.com/anthos/multicluster-management/connect/registering-a-cluster", + "fullyEncodeReservedExpansion": true, + "icons": { + "x16": "http://www.google.com/images/icons/product/search-16.gif", + "x32": "http://www.google.com/images/icons/product/search-32.gif" + }, + "id": "gkehub:v2", + "kind": "discovery#restDescription", + "mtlsRootUrl": "https://gkehub.mtls.googleapis.com/", + "name": "gkehub", + "ownerDomain": "google.com", + "ownerName": "Google", + "parameters": { + "$.xgafv": { + "description": "V1 error format.", + "enum": [ + "1", + "2" + ], + "enumDescriptions": [ + "v1 error format", + "v2 error format" + ], + "location": "query", + "type": "string" + }, + "access_token": { + "description": "OAuth access token.", + "location": "query", + "type": "string" + }, + "alt": { + "default": "json", + "description": "Data format for response.", + "enum": [ + "json", + "media", + "proto" + ], + "enumDescriptions": [ + "Responses with Content-Type of application/json", + "Media download with context-dependent Content-Type", + "Responses with Content-Type of application/x-protobuf" + ], + "location": "query", + "type": "string" + }, + "callback": { + "description": "JSONP", + "location": "query", + "type": "string" + }, + "fields": { + "description": "Selector specifying which fields to include in a partial response.", + "location": "query", + "type": "string" + }, + "key": { + "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.", + "location": "query", + "type": "string" + }, + "oauth_token": { + "description": "OAuth 2.0 token for the current user.", + "location": "query", + "type": "string" + }, + "prettyPrint": { + "default": "true", + "description": "Returns response with indentations and line breaks.", + "location": "query", + "type": "boolean" + }, + "quotaUser": { + "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", + "location": "query", + "type": "string" + }, + "uploadType": { + "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", + "location": "query", + "type": "string" + }, + "upload_protocol": { + "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", + "location": "query", + "type": "string" + } + }, + "protocol": "rest", + "resources": { + "projects": { + "resources": { + "locations": { + "methods": { + "get": { + "description": "Gets information about a location.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}", + "httpMethod": "GET", + "id": "gkehub.projects.locations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Resource name for the location.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+name}", + "response": { + "$ref": "Location" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists information about the supported locations for this service.", + "flatPath": "v2/projects/{projectsId}/locations", + "httpMethod": "GET", + "id": "gkehub.projects.locations.list", + "parameterOrder": [ + "name" + ], + "parameters": { + "filter": { + "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).", + "location": "query", + "type": "string" + }, + "name": { + "description": "The resource that owns the locations collection, if applicable.", + "location": "path", + "pattern": "^projects/[^/]+$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "The maximum number of results to return. If not set, the service selects a default.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page.", + "location": "query", + "type": "string" + } + }, + "path": "v2/{+name}/locations", + "response": { + "$ref": "ListLocationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, + "resources": { + "operations": { + "methods": { + "cancel": { + "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", + "httpMethod": "POST", + "id": "gkehub.projects.locations.operations.cancel", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to be cancelled.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+name}:cancel", + "request": { + "$ref": "CancelOperationRequest" + }, + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", + "httpMethod": "GET", + "id": "gkehub.projects.locations.operations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/operations", + "httpMethod": "GET", + "id": "gkehub.projects.locations.operations.list", + "parameterOrder": [ + "name" + ], + "parameters": { + "filter": { + "description": "The standard list filter.", + "location": "query", + "type": "string" + }, + "name": { + "description": "The name of the operation's parent resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "The standard list page size.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The standard list page token.", + "location": "query", + "type": "string" + } + }, + "path": "v2/{+name}/operations", + "response": { + "$ref": "ListOperationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + } + } + } + }, + "revision": "20240809", + "rootUrl": "https://gkehub.googleapis.com/", + "schemas": { + "CancelOperationRequest": { + "description": "The request message for Operations.CancelOperation.", + "id": "CancelOperationRequest", + "properties": {}, + "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", + "properties": {}, + "type": "object" + }, + "GoogleRpcStatus": { + "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": "GoogleRpcStatus", + "properties": { + "code": { + "description": "The status code, which should be an enum value of google.rpc.Code.", + "format": "int32", + "type": "integer" + }, + "details": { + "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", + "items": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.", + "type": "string" + } + }, + "type": "object" + }, + "ListLocationsResponse": { + "description": "The response message for Locations.ListLocations.", + "id": "ListLocationsResponse", + "properties": { + "locations": { + "description": "A list of locations that matches the specified filter in the request.", + "items": { + "$ref": "Location" + }, + "type": "array" + }, + "nextPageToken": { + "description": "The standard List next-page token.", + "type": "string" + } + }, + "type": "object" + }, + "ListOperationsResponse": { + "description": "The response message for Operations.ListOperations.", + "id": "ListOperationsResponse", + "properties": { + "nextPageToken": { + "description": "The standard List next-page token.", + "type": "string" + }, + "operations": { + "description": "A list of operations that matches the specified filter in the request.", + "items": { + "$ref": "Operation" + }, + "type": "array" + } + }, + "type": "object" + }, + "Location": { + "description": "A resource that represents a Google Cloud location.", + "id": "Location", + "properties": { + "displayName": { + "description": "The friendly name for this location, typically a nearby city name. For example, \"Tokyo\".", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Cross-service attributes for the location. For example {\"cloud.googleapis.com/region\": \"us-east1\"}", + "type": "object" + }, + "locationId": { + "description": "The canonical id for this location. For example: `\"us-east1\"`.", + "type": "string" + }, + "metadata": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "description": "Service-specific metadata. For example the available capacity at the given location.", + "type": "object" + }, + "name": { + "description": "Resource name for the location, which may vary between implementations. For example: `\"projects/example-project/locations/us-east1\"`", + "type": "string" + } + }, + "type": "object" + }, + "Operation": { + "description": "This resource represents a long-running operation that is the result of a network API call.", + "id": "Operation", + "properties": { + "done": { + "description": "If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.", + "type": "boolean" + }, + "error": { + "$ref": "GoogleRpcStatus", + "description": "The error result of the operation in case of failure or cancellation." + }, + "metadata": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "description": "Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.", + "type": "object" + }, + "name": { + "description": "The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.", + "type": "string" + }, + "response": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "description": "The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.", + "type": "object" + } + }, + "type": "object" + } + }, + "servicePath": "", + "title": "GKE Hub API", + "version": "v2", + "version_module": true +} \ No newline at end of file diff --git a/gkehub/v2/gkehub-gen.go b/gkehub/v2/gkehub-gen.go new file mode 100644 index 00000000000..81a76b4eafb --- /dev/null +++ b/gkehub/v2/gkehub-gen.go @@ -0,0 +1,1004 @@ +// Copyright 2024 Google LLC. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +// Code generated file. DO NOT EDIT. + +// Package gkehub provides access to the GKE Hub API. +// +// For product documentation, see: https://cloud.google.com/anthos/multicluster-management/connect/registering-a-cluster +// +// # Library status +// +// These client libraries are officially supported by Google. However, this +// library is considered complete and is in maintenance mode. This means +// that we will address critical bugs and security issues but will not add +// any new features. +// +// When possible, we recommend using our newer +// [Cloud Client Libraries for Go](https://pkg.go.dev/cloud.google.com/go) +// that are still actively being worked and iterated on. +// +// # Creating a client +// +// Usage example: +// +// import "google.golang.org/api/gkehub/v2" +// ... +// ctx := context.Background() +// gkehubService, err := gkehub.NewService(ctx) +// +// In this example, Google Application Default Credentials are used for +// authentication. For information on how to create and obtain Application +// Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials. +// +// # Other authentication options +// +// To use an API key for authentication (note: some APIs do not support API +// keys), use [google.golang.org/api/option.WithAPIKey]: +// +// gkehubService, err := gkehub.NewService(ctx, option.WithAPIKey("AIza...")) +// +// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth +// flow, use [google.golang.org/api/option.WithTokenSource]: +// +// config := &oauth2.Config{...} +// // ... +// token, err := config.Exchange(ctx, ...) +// gkehubService, err := gkehub.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token))) +// +// See [google.golang.org/api/option.ClientOption] for details on options. +package gkehub // import "google.golang.org/api/gkehub/v2" + +import ( + "bytes" + "context" + "encoding/json" + "errors" + "fmt" + "io" + "net/http" + "net/url" + "strconv" + "strings" + + googleapi "google.golang.org/api/googleapi" + internal "google.golang.org/api/internal" + gensupport "google.golang.org/api/internal/gensupport" + option "google.golang.org/api/option" + internaloption "google.golang.org/api/option/internaloption" + htransport "google.golang.org/api/transport/http" +) + +// Always reference these packages, just in case the auto-generated code +// below doesn't. +var _ = bytes.NewBuffer +var _ = strconv.Itoa +var _ = fmt.Sprintf +var _ = json.NewDecoder +var _ = io.Copy +var _ = url.Parse +var _ = gensupport.MarshalJSON +var _ = googleapi.Version +var _ = errors.New +var _ = strings.Replace +var _ = context.Canceled +var _ = internaloption.WithDefaultEndpoint +var _ = internal.Version + +const apiId = "gkehub:v2" +const apiName = "gkehub" +const apiVersion = "v2" +const basePath = "https://gkehub.googleapis.com/" +const basePathTemplate = "https://gkehub.UNIVERSE_DOMAIN/" +const mtlsBasePath = "https://gkehub.mtls.googleapis.com/" + +// OAuth2 scopes used by this API. +const ( + // See, edit, configure, and delete your Google Cloud data and see the email + // address for your Google Account. + CloudPlatformScope = "https://www.googleapis.com/auth/cloud-platform" +) + +// NewService creates a new Service. +func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, error) { + scopesOption := internaloption.WithDefaultScopes( + "https://www.googleapis.com/auth/cloud-platform", + ) + // NOTE: prepend, so we don't override user-specified scopes. + opts = append([]option.ClientOption{scopesOption}, opts...) + opts = append(opts, internaloption.WithDefaultEndpoint(basePath)) + opts = append(opts, internaloption.WithDefaultEndpointTemplate(basePathTemplate)) + opts = append(opts, internaloption.WithDefaultMTLSEndpoint(mtlsBasePath)) + opts = append(opts, internaloption.EnableNewAuthLibrary()) + client, endpoint, err := htransport.NewClient(ctx, opts...) + if err != nil { + return nil, err + } + s, err := New(client) + if err != nil { + return nil, err + } + if endpoint != "" { + s.BasePath = endpoint + } + return s, nil +} + +// New creates a new Service. It uses the provided http.Client for requests. +// +// Deprecated: please use NewService instead. +// To provide a custom HTTP client, use option.WithHTTPClient. +// If you are using google.golang.org/api/googleapis/transport.APIKey, use option.WithAPIKey with NewService instead. +func New(client *http.Client) (*Service, error) { + if client == nil { + return nil, errors.New("client is nil") + } + s := &Service{client: client, BasePath: basePath} + s.Projects = NewProjectsService(s) + return s, nil +} + +type Service struct { + client *http.Client + BasePath string // API endpoint base URL + UserAgent string // optional additional User-Agent fragment + + Projects *ProjectsService +} + +func (s *Service) userAgent() string { + if s.UserAgent == "" { + return googleapi.UserAgent + } + return googleapi.UserAgent + " " + s.UserAgent +} + +func NewProjectsService(s *Service) *ProjectsService { + rs := &ProjectsService{s: s} + rs.Locations = NewProjectsLocationsService(s) + return rs +} + +type ProjectsService struct { + s *Service + + Locations *ProjectsLocationsService +} + +func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { + rs := &ProjectsLocationsService{s: s} + rs.Operations = NewProjectsLocationsOperationsService(s) + return rs +} + +type ProjectsLocationsService struct { + s *Service + + Operations *ProjectsLocationsOperationsService +} + +func NewProjectsLocationsOperationsService(s *Service) *ProjectsLocationsOperationsService { + rs := &ProjectsLocationsOperationsService{s: s} + return rs +} + +type ProjectsLocationsOperationsService struct { + s *Service +} + +// CancelOperationRequest: The request message for Operations.CancelOperation. +type CancelOperationRequest struct { +} + +// 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 +// { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } +type Empty struct { + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` +} + +// GoogleRpcStatus: The `Status` type defines a logical error model that is +// suitable for different programming environments, including REST APIs and RPC +// APIs. It is used by gRPC (https://github.com/grpc). Each `Status` message +// contains three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it in the +// API Design Guide (https://cloud.google.com/apis/design/errors). +type GoogleRpcStatus struct { + // Code: The status code, which should be an enum value of google.rpc.Code. + Code int64 `json:"code,omitempty"` + // Details: A list of messages that carry the error details. There is a common + // set of message types for APIs to use. + Details []googleapi.RawMessage `json:"details,omitempty"` + // Message: A developer-facing error message, which should be in English. Any + // user-facing error message should be localized and sent in the + // google.rpc.Status.details field, or localized by the client. + Message string `json:"message,omitempty"` + // ForceSendFields is a list of field names (e.g. "Code") 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. "Code") 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 GoogleRpcStatus) MarshalJSON() ([]byte, error) { + type NoMethod GoogleRpcStatus + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ListLocationsResponse: The response message for Locations.ListLocations. +type ListLocationsResponse struct { + // Locations: A list of locations that matches the specified filter in the + // request. + Locations []*Location `json:"locations,omitempty"` + // NextPageToken: The standard List next-page token. + NextPageToken string `json:"nextPageToken,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Locations") 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. "Locations") 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 ListLocationsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListLocationsResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ListOperationsResponse: The response message for Operations.ListOperations. +type ListOperationsResponse struct { + // NextPageToken: The standard List next-page token. + NextPageToken string `json:"nextPageToken,omitempty"` + // Operations: A list of operations that matches the specified filter in the + // request. + Operations []*Operation `json:"operations,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "NextPageToken") 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. "NextPageToken") 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 ListOperationsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListOperationsResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// Location: A resource that represents a Google Cloud location. +type Location struct { + // DisplayName: The friendly name for this location, typically a nearby city + // name. For example, "Tokyo". + DisplayName string `json:"displayName,omitempty"` + // Labels: Cross-service attributes for the location. For example + // {"cloud.googleapis.com/region": "us-east1"} + Labels map[string]string `json:"labels,omitempty"` + // LocationId: The canonical id for this location. For example: "us-east1". + LocationId string `json:"locationId,omitempty"` + // Metadata: Service-specific metadata. For example the available capacity at + // the given location. + Metadata googleapi.RawMessage `json:"metadata,omitempty"` + // Name: Resource name for the location, which may vary between + // implementations. For example: + // "projects/example-project/locations/us-east1" + 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. "DisplayName") 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. "DisplayName") 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 Location) MarshalJSON() ([]byte, error) { + type NoMethod Location + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// Operation: This resource represents a long-running operation that is the +// result of a network API call. +type Operation struct { + // Done: If the value is `false`, it means the operation is still in progress. + // If `true`, the operation is completed, and either `error` or `response` is + // available. + Done bool `json:"done,omitempty"` + // Error: The error result of the operation in case of failure or cancellation. + Error *GoogleRpcStatus `json:"error,omitempty"` + // Metadata: Service-specific metadata associated with the operation. It + // typically contains progress information and common metadata such as create + // time. Some services might not provide such metadata. Any method that returns + // a long-running operation should document the metadata type, if any. + Metadata googleapi.RawMessage `json:"metadata,omitempty"` + // Name: The server-assigned name, which is only unique within the same service + // that originally returns it. If you use the default HTTP mapping, the `name` + // should be a resource name ending with `operations/{unique_id}`. + Name string `json:"name,omitempty"` + // Response: The normal, successful response of the operation. If the original + // method returns no data on success, such as `Delete`, the response is + // `google.protobuf.Empty`. If the original method is standard + // `Get`/`Create`/`Update`, the response should be the resource. For other + // methods, the response should have the type `XxxResponse`, where `Xxx` is the + // original method name. For example, if the original method name is + // `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`. + Response googleapi.RawMessage `json:"response,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Done") 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. "Done") 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 Operation) MarshalJSON() ([]byte, error) { + type NoMethod Operation + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type ProjectsLocationsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets information about a location. +// +// - name: Resource name for the location. +func (r *ProjectsLocationsService) Get(name string) *ProjectsLocationsGetCall { + c := &ProjectsLocationsGetCall{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 *ProjectsLocationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsGetCall { + 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 *ProjectsLocationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGetCall) Context(ctx context.Context) *ProjectsLocationsGetCall { + 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 *ProjectsLocationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGetCall) 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, "v2/{+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 "gkehub.projects.locations.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *Location.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 *ProjectsLocationsGetCall) Do(opts ...googleapi.CallOption) (*Location, 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 := &Location{ + 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 ProjectsLocationsListCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists information about the supported locations for this service. +// +// - name: The resource that owns the locations collection, if applicable. +func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall { + c := &ProjectsLocationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Filter sets the optional parameter "filter": A filter to narrow down results +// to a preferred subset. The filtering language accepts strings like +// "displayName=tokyo", and is documented in more detail in AIP-160 +// (https://google.aip.dev/160). +func (c *ProjectsLocationsListCall) Filter(filter string) *ProjectsLocationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number of +// results to return. If not set, the service selects a default. +func (c *ProjectsLocationsListCall) PageSize(pageSize int64) *ProjectsLocationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A page token received +// from the `next_page_token` field in the response. Send that page token to +// receive the subsequent page. +func (c *ProjectsLocationsListCall) PageToken(pageToken string) *ProjectsLocationsListCall { + c.urlParams_.Set("pageToken", pageToken) + 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 *ProjectsLocationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsListCall { + 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 *ProjectsLocationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsListCall) Context(ctx context.Context) *ProjectsLocationsListCall { + 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 *ProjectsLocationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsListCall) 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, "v2/{+name}/locations") + 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 "gkehub.projects.locations.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *ListLocationsResponse.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 *ProjectsLocationsListCall) Do(opts ...googleapi.CallOption) (*ListLocationsResponse, 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 := &ListLocationsResponse{ + 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 +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsLocationsListCall) Pages(ctx context.Context, f func(*ListLocationsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + +type ProjectsLocationsOperationsCancelCall struct { + s *Service + name string + canceloperationrequest *CancelOperationRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Cancel: Starts asynchronous cancellation on a long-running operation. The +// server makes a best effort to cancel the operation, but success is not +// guaranteed. If the server doesn't support this method, it returns +// `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or +// other methods to check whether the cancellation succeeded or whether the +// operation completed despite cancellation. On successful cancellation, the +// operation is not deleted; instead, it becomes an operation with an +// Operation.error value with a google.rpc.Status.code of 1, corresponding to +// `Code.CANCELLED`. +// +// - name: The name of the operation resource to be cancelled. +func (r *ProjectsLocationsOperationsService) Cancel(name string, canceloperationrequest *CancelOperationRequest) *ProjectsLocationsOperationsCancelCall { + c := &ProjectsLocationsOperationsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.canceloperationrequest = canceloperationrequest + 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 *ProjectsLocationsOperationsCancelCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsCancelCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsOperationsCancelCall) Context(ctx context.Context) *ProjectsLocationsOperationsCancelCall { + 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 *ProjectsLocationsOperationsCancelCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsOperationsCancelCall) 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.canceloperationrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+name}:cancel") + 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{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkehub.projects.locations.operations.cancel" call. +// Any non-2xx status code is an error. Response headers are in either +// *Empty.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 *ProjectsLocationsOperationsCancelCall) Do(opts ...googleapi.CallOption) (*Empty, 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 := &Empty{ + 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 ProjectsLocationsOperationsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets the latest state of a long-running operation. Clients can use this +// method to poll the operation result at intervals as recommended by the API +// service. +// +// - name: The name of the operation resource. +func (r *ProjectsLocationsOperationsService) Get(name string) *ProjectsLocationsOperationsGetCall { + c := &ProjectsLocationsOperationsGetCall{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 *ProjectsLocationsOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsGetCall { + 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 *ProjectsLocationsOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsOperationsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsOperationsGetCall { + 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 *ProjectsLocationsOperationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsOperationsGetCall) 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, "v2/{+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 "gkehub.projects.locations.operations.get" 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 *ProjectsLocationsOperationsGetCall) 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 ProjectsLocationsOperationsListCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists operations that match the specified filter in the request. If +// the server doesn't support this method, it returns `UNIMPLEMENTED`. +// +// - name: The name of the operation's parent resource. +func (r *ProjectsLocationsOperationsService) List(name string) *ProjectsLocationsOperationsListCall { + c := &ProjectsLocationsOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Filter sets the optional parameter "filter": The standard list filter. +func (c *ProjectsLocationsOperationsListCall) Filter(filter string) *ProjectsLocationsOperationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The standard list page +// size. +func (c *ProjectsLocationsOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsOperationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The standard list page +// token. +func (c *ProjectsLocationsOperationsListCall) PageToken(pageToken string) *ProjectsLocationsOperationsListCall { + c.urlParams_.Set("pageToken", pageToken) + 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 *ProjectsLocationsOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsListCall { + 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 *ProjectsLocationsOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsOperationsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsOperationsListCall) Context(ctx context.Context) *ProjectsLocationsOperationsListCall { + 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 *ProjectsLocationsOperationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsOperationsListCall) 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, "v2/{+name}/operations") + 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 "gkehub.projects.locations.operations.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *ListOperationsResponse.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 *ProjectsLocationsOperationsListCall) Do(opts ...googleapi.CallOption) (*ListOperationsResponse, 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 := &ListOperationsResponse{ + 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 +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsLocationsOperationsListCall) Pages(ctx context.Context, f func(*ListOperationsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} diff --git a/gkehub/v2beta/gkehub-api.json b/gkehub/v2beta/gkehub-api.json new file mode 100644 index 00000000000..a587b00fb0a --- /dev/null +++ b/gkehub/v2beta/gkehub-api.json @@ -0,0 +1,435 @@ +{ + "auth": { + "oauth2": { + "scopes": { + "https://www.googleapis.com/auth/cloud-platform": { + "description": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account." + } + } + } + }, + "basePath": "", + "baseUrl": "https://gkehub.googleapis.com/", + "batchPath": "batch", + "canonicalName": "GKE Hub", + "description": "", + "discoveryVersion": "v1", + "documentationLink": "https://cloud.google.com/anthos/multicluster-management/connect/registering-a-cluster", + "fullyEncodeReservedExpansion": true, + "icons": { + "x16": "http://www.google.com/images/icons/product/search-16.gif", + "x32": "http://www.google.com/images/icons/product/search-32.gif" + }, + "id": "gkehub:v2beta", + "kind": "discovery#restDescription", + "mtlsRootUrl": "https://gkehub.mtls.googleapis.com/", + "name": "gkehub", + "ownerDomain": "google.com", + "ownerName": "Google", + "parameters": { + "$.xgafv": { + "description": "V1 error format.", + "enum": [ + "1", + "2" + ], + "enumDescriptions": [ + "v1 error format", + "v2 error format" + ], + "location": "query", + "type": "string" + }, + "access_token": { + "description": "OAuth access token.", + "location": "query", + "type": "string" + }, + "alt": { + "default": "json", + "description": "Data format for response.", + "enum": [ + "json", + "media", + "proto" + ], + "enumDescriptions": [ + "Responses with Content-Type of application/json", + "Media download with context-dependent Content-Type", + "Responses with Content-Type of application/x-protobuf" + ], + "location": "query", + "type": "string" + }, + "callback": { + "description": "JSONP", + "location": "query", + "type": "string" + }, + "fields": { + "description": "Selector specifying which fields to include in a partial response.", + "location": "query", + "type": "string" + }, + "key": { + "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.", + "location": "query", + "type": "string" + }, + "oauth_token": { + "description": "OAuth 2.0 token for the current user.", + "location": "query", + "type": "string" + }, + "prettyPrint": { + "default": "true", + "description": "Returns response with indentations and line breaks.", + "location": "query", + "type": "boolean" + }, + "quotaUser": { + "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", + "location": "query", + "type": "string" + }, + "uploadType": { + "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", + "location": "query", + "type": "string" + }, + "upload_protocol": { + "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", + "location": "query", + "type": "string" + } + }, + "protocol": "rest", + "resources": { + "projects": { + "resources": { + "locations": { + "methods": { + "get": { + "description": "Gets information about a location.", + "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}", + "httpMethod": "GET", + "id": "gkehub.projects.locations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Resource name for the location.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+name}", + "response": { + "$ref": "Location" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists information about the supported locations for this service.", + "flatPath": "v2beta/projects/{projectsId}/locations", + "httpMethod": "GET", + "id": "gkehub.projects.locations.list", + "parameterOrder": [ + "name" + ], + "parameters": { + "filter": { + "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).", + "location": "query", + "type": "string" + }, + "name": { + "description": "The resource that owns the locations collection, if applicable.", + "location": "path", + "pattern": "^projects/[^/]+$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "The maximum number of results to return. If not set, the service selects a default.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page.", + "location": "query", + "type": "string" + } + }, + "path": "v2beta/{+name}/locations", + "response": { + "$ref": "ListLocationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, + "resources": { + "operations": { + "methods": { + "cancel": { + "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", + "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", + "httpMethod": "POST", + "id": "gkehub.projects.locations.operations.cancel", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to be cancelled.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+name}:cancel", + "request": { + "$ref": "CancelOperationRequest" + }, + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", + "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", + "httpMethod": "GET", + "id": "gkehub.projects.locations.operations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", + "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/operations", + "httpMethod": "GET", + "id": "gkehub.projects.locations.operations.list", + "parameterOrder": [ + "name" + ], + "parameters": { + "filter": { + "description": "The standard list filter.", + "location": "query", + "type": "string" + }, + "name": { + "description": "The name of the operation's parent resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "The standard list page size.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The standard list page token.", + "location": "query", + "type": "string" + } + }, + "path": "v2beta/{+name}/operations", + "response": { + "$ref": "ListOperationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + } + } + } + }, + "revision": "20240809", + "rootUrl": "https://gkehub.googleapis.com/", + "schemas": { + "CancelOperationRequest": { + "description": "The request message for Operations.CancelOperation.", + "id": "CancelOperationRequest", + "properties": {}, + "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", + "properties": {}, + "type": "object" + }, + "GoogleRpcStatus": { + "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": "GoogleRpcStatus", + "properties": { + "code": { + "description": "The status code, which should be an enum value of google.rpc.Code.", + "format": "int32", + "type": "integer" + }, + "details": { + "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", + "items": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.", + "type": "string" + } + }, + "type": "object" + }, + "ListLocationsResponse": { + "description": "The response message for Locations.ListLocations.", + "id": "ListLocationsResponse", + "properties": { + "locations": { + "description": "A list of locations that matches the specified filter in the request.", + "items": { + "$ref": "Location" + }, + "type": "array" + }, + "nextPageToken": { + "description": "The standard List next-page token.", + "type": "string" + } + }, + "type": "object" + }, + "ListOperationsResponse": { + "description": "The response message for Operations.ListOperations.", + "id": "ListOperationsResponse", + "properties": { + "nextPageToken": { + "description": "The standard List next-page token.", + "type": "string" + }, + "operations": { + "description": "A list of operations that matches the specified filter in the request.", + "items": { + "$ref": "Operation" + }, + "type": "array" + } + }, + "type": "object" + }, + "Location": { + "description": "A resource that represents a Google Cloud location.", + "id": "Location", + "properties": { + "displayName": { + "description": "The friendly name for this location, typically a nearby city name. For example, \"Tokyo\".", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Cross-service attributes for the location. For example {\"cloud.googleapis.com/region\": \"us-east1\"}", + "type": "object" + }, + "locationId": { + "description": "The canonical id for this location. For example: `\"us-east1\"`.", + "type": "string" + }, + "metadata": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "description": "Service-specific metadata. For example the available capacity at the given location.", + "type": "object" + }, + "name": { + "description": "Resource name for the location, which may vary between implementations. For example: `\"projects/example-project/locations/us-east1\"`", + "type": "string" + } + }, + "type": "object" + }, + "Operation": { + "description": "This resource represents a long-running operation that is the result of a network API call.", + "id": "Operation", + "properties": { + "done": { + "description": "If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.", + "type": "boolean" + }, + "error": { + "$ref": "GoogleRpcStatus", + "description": "The error result of the operation in case of failure or cancellation." + }, + "metadata": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "description": "Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.", + "type": "object" + }, + "name": { + "description": "The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.", + "type": "string" + }, + "response": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "description": "The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.", + "type": "object" + } + }, + "type": "object" + } + }, + "servicePath": "", + "title": "GKE Hub API", + "version": "v2beta", + "version_module": true +} \ No newline at end of file diff --git a/gkehub/v2beta/gkehub-gen.go b/gkehub/v2beta/gkehub-gen.go new file mode 100644 index 00000000000..65b2ca83dc2 --- /dev/null +++ b/gkehub/v2beta/gkehub-gen.go @@ -0,0 +1,1004 @@ +// Copyright 2024 Google LLC. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +// Code generated file. DO NOT EDIT. + +// Package gkehub provides access to the GKE Hub API. +// +// For product documentation, see: https://cloud.google.com/anthos/multicluster-management/connect/registering-a-cluster +// +// # Library status +// +// These client libraries are officially supported by Google. However, this +// library is considered complete and is in maintenance mode. This means +// that we will address critical bugs and security issues but will not add +// any new features. +// +// When possible, we recommend using our newer +// [Cloud Client Libraries for Go](https://pkg.go.dev/cloud.google.com/go) +// that are still actively being worked and iterated on. +// +// # Creating a client +// +// Usage example: +// +// import "google.golang.org/api/gkehub/v2beta" +// ... +// ctx := context.Background() +// gkehubService, err := gkehub.NewService(ctx) +// +// In this example, Google Application Default Credentials are used for +// authentication. For information on how to create and obtain Application +// Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials. +// +// # Other authentication options +// +// To use an API key for authentication (note: some APIs do not support API +// keys), use [google.golang.org/api/option.WithAPIKey]: +// +// gkehubService, err := gkehub.NewService(ctx, option.WithAPIKey("AIza...")) +// +// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth +// flow, use [google.golang.org/api/option.WithTokenSource]: +// +// config := &oauth2.Config{...} +// // ... +// token, err := config.Exchange(ctx, ...) +// gkehubService, err := gkehub.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token))) +// +// See [google.golang.org/api/option.ClientOption] for details on options. +package gkehub // import "google.golang.org/api/gkehub/v2beta" + +import ( + "bytes" + "context" + "encoding/json" + "errors" + "fmt" + "io" + "net/http" + "net/url" + "strconv" + "strings" + + googleapi "google.golang.org/api/googleapi" + internal "google.golang.org/api/internal" + gensupport "google.golang.org/api/internal/gensupport" + option "google.golang.org/api/option" + internaloption "google.golang.org/api/option/internaloption" + htransport "google.golang.org/api/transport/http" +) + +// Always reference these packages, just in case the auto-generated code +// below doesn't. +var _ = bytes.NewBuffer +var _ = strconv.Itoa +var _ = fmt.Sprintf +var _ = json.NewDecoder +var _ = io.Copy +var _ = url.Parse +var _ = gensupport.MarshalJSON +var _ = googleapi.Version +var _ = errors.New +var _ = strings.Replace +var _ = context.Canceled +var _ = internaloption.WithDefaultEndpoint +var _ = internal.Version + +const apiId = "gkehub:v2beta" +const apiName = "gkehub" +const apiVersion = "v2beta" +const basePath = "https://gkehub.googleapis.com/" +const basePathTemplate = "https://gkehub.UNIVERSE_DOMAIN/" +const mtlsBasePath = "https://gkehub.mtls.googleapis.com/" + +// OAuth2 scopes used by this API. +const ( + // See, edit, configure, and delete your Google Cloud data and see the email + // address for your Google Account. + CloudPlatformScope = "https://www.googleapis.com/auth/cloud-platform" +) + +// NewService creates a new Service. +func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, error) { + scopesOption := internaloption.WithDefaultScopes( + "https://www.googleapis.com/auth/cloud-platform", + ) + // NOTE: prepend, so we don't override user-specified scopes. + opts = append([]option.ClientOption{scopesOption}, opts...) + opts = append(opts, internaloption.WithDefaultEndpoint(basePath)) + opts = append(opts, internaloption.WithDefaultEndpointTemplate(basePathTemplate)) + opts = append(opts, internaloption.WithDefaultMTLSEndpoint(mtlsBasePath)) + opts = append(opts, internaloption.EnableNewAuthLibrary()) + client, endpoint, err := htransport.NewClient(ctx, opts...) + if err != nil { + return nil, err + } + s, err := New(client) + if err != nil { + return nil, err + } + if endpoint != "" { + s.BasePath = endpoint + } + return s, nil +} + +// New creates a new Service. It uses the provided http.Client for requests. +// +// Deprecated: please use NewService instead. +// To provide a custom HTTP client, use option.WithHTTPClient. +// If you are using google.golang.org/api/googleapis/transport.APIKey, use option.WithAPIKey with NewService instead. +func New(client *http.Client) (*Service, error) { + if client == nil { + return nil, errors.New("client is nil") + } + s := &Service{client: client, BasePath: basePath} + s.Projects = NewProjectsService(s) + return s, nil +} + +type Service struct { + client *http.Client + BasePath string // API endpoint base URL + UserAgent string // optional additional User-Agent fragment + + Projects *ProjectsService +} + +func (s *Service) userAgent() string { + if s.UserAgent == "" { + return googleapi.UserAgent + } + return googleapi.UserAgent + " " + s.UserAgent +} + +func NewProjectsService(s *Service) *ProjectsService { + rs := &ProjectsService{s: s} + rs.Locations = NewProjectsLocationsService(s) + return rs +} + +type ProjectsService struct { + s *Service + + Locations *ProjectsLocationsService +} + +func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { + rs := &ProjectsLocationsService{s: s} + rs.Operations = NewProjectsLocationsOperationsService(s) + return rs +} + +type ProjectsLocationsService struct { + s *Service + + Operations *ProjectsLocationsOperationsService +} + +func NewProjectsLocationsOperationsService(s *Service) *ProjectsLocationsOperationsService { + rs := &ProjectsLocationsOperationsService{s: s} + return rs +} + +type ProjectsLocationsOperationsService struct { + s *Service +} + +// CancelOperationRequest: The request message for Operations.CancelOperation. +type CancelOperationRequest struct { +} + +// 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 +// { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } +type Empty struct { + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` +} + +// GoogleRpcStatus: The `Status` type defines a logical error model that is +// suitable for different programming environments, including REST APIs and RPC +// APIs. It is used by gRPC (https://github.com/grpc). Each `Status` message +// contains three pieces of data: error code, error message, and error details. +// You can find out more about this error model and how to work with it in the +// API Design Guide (https://cloud.google.com/apis/design/errors). +type GoogleRpcStatus struct { + // Code: The status code, which should be an enum value of google.rpc.Code. + Code int64 `json:"code,omitempty"` + // Details: A list of messages that carry the error details. There is a common + // set of message types for APIs to use. + Details []googleapi.RawMessage `json:"details,omitempty"` + // Message: A developer-facing error message, which should be in English. Any + // user-facing error message should be localized and sent in the + // google.rpc.Status.details field, or localized by the client. + Message string `json:"message,omitempty"` + // ForceSendFields is a list of field names (e.g. "Code") 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. "Code") 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 GoogleRpcStatus) MarshalJSON() ([]byte, error) { + type NoMethod GoogleRpcStatus + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ListLocationsResponse: The response message for Locations.ListLocations. +type ListLocationsResponse struct { + // Locations: A list of locations that matches the specified filter in the + // request. + Locations []*Location `json:"locations,omitempty"` + // NextPageToken: The standard List next-page token. + NextPageToken string `json:"nextPageToken,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Locations") 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. "Locations") 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 ListLocationsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListLocationsResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ListOperationsResponse: The response message for Operations.ListOperations. +type ListOperationsResponse struct { + // NextPageToken: The standard List next-page token. + NextPageToken string `json:"nextPageToken,omitempty"` + // Operations: A list of operations that matches the specified filter in the + // request. + Operations []*Operation `json:"operations,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "NextPageToken") 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. "NextPageToken") 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 ListOperationsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListOperationsResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// Location: A resource that represents a Google Cloud location. +type Location struct { + // DisplayName: The friendly name for this location, typically a nearby city + // name. For example, "Tokyo". + DisplayName string `json:"displayName,omitempty"` + // Labels: Cross-service attributes for the location. For example + // {"cloud.googleapis.com/region": "us-east1"} + Labels map[string]string `json:"labels,omitempty"` + // LocationId: The canonical id for this location. For example: "us-east1". + LocationId string `json:"locationId,omitempty"` + // Metadata: Service-specific metadata. For example the available capacity at + // the given location. + Metadata googleapi.RawMessage `json:"metadata,omitempty"` + // Name: Resource name for the location, which may vary between + // implementations. For example: + // "projects/example-project/locations/us-east1" + 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. "DisplayName") 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. "DisplayName") 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 Location) MarshalJSON() ([]byte, error) { + type NoMethod Location + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// Operation: This resource represents a long-running operation that is the +// result of a network API call. +type Operation struct { + // Done: If the value is `false`, it means the operation is still in progress. + // If `true`, the operation is completed, and either `error` or `response` is + // available. + Done bool `json:"done,omitempty"` + // Error: The error result of the operation in case of failure or cancellation. + Error *GoogleRpcStatus `json:"error,omitempty"` + // Metadata: Service-specific metadata associated with the operation. It + // typically contains progress information and common metadata such as create + // time. Some services might not provide such metadata. Any method that returns + // a long-running operation should document the metadata type, if any. + Metadata googleapi.RawMessage `json:"metadata,omitempty"` + // Name: The server-assigned name, which is only unique within the same service + // that originally returns it. If you use the default HTTP mapping, the `name` + // should be a resource name ending with `operations/{unique_id}`. + Name string `json:"name,omitempty"` + // Response: The normal, successful response of the operation. If the original + // method returns no data on success, such as `Delete`, the response is + // `google.protobuf.Empty`. If the original method is standard + // `Get`/`Create`/`Update`, the response should be the resource. For other + // methods, the response should have the type `XxxResponse`, where `Xxx` is the + // original method name. For example, if the original method name is + // `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`. + Response googleapi.RawMessage `json:"response,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Done") 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. "Done") 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 Operation) MarshalJSON() ([]byte, error) { + type NoMethod Operation + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type ProjectsLocationsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets information about a location. +// +// - name: Resource name for the location. +func (r *ProjectsLocationsService) Get(name string) *ProjectsLocationsGetCall { + c := &ProjectsLocationsGetCall{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 *ProjectsLocationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsGetCall { + 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 *ProjectsLocationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGetCall) Context(ctx context.Context) *ProjectsLocationsGetCall { + 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 *ProjectsLocationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGetCall) 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 "gkehub.projects.locations.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *Location.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 *ProjectsLocationsGetCall) Do(opts ...googleapi.CallOption) (*Location, 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 := &Location{ + 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 ProjectsLocationsListCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists information about the supported locations for this service. +// +// - name: The resource that owns the locations collection, if applicable. +func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall { + c := &ProjectsLocationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Filter sets the optional parameter "filter": A filter to narrow down results +// to a preferred subset. The filtering language accepts strings like +// "displayName=tokyo", and is documented in more detail in AIP-160 +// (https://google.aip.dev/160). +func (c *ProjectsLocationsListCall) Filter(filter string) *ProjectsLocationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number of +// results to return. If not set, the service selects a default. +func (c *ProjectsLocationsListCall) PageSize(pageSize int64) *ProjectsLocationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A page token received +// from the `next_page_token` field in the response. Send that page token to +// receive the subsequent page. +func (c *ProjectsLocationsListCall) PageToken(pageToken string) *ProjectsLocationsListCall { + c.urlParams_.Set("pageToken", pageToken) + 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 *ProjectsLocationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsListCall { + 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 *ProjectsLocationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsListCall) Context(ctx context.Context) *ProjectsLocationsListCall { + 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 *ProjectsLocationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsListCall) 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}/locations") + 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 "gkehub.projects.locations.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *ListLocationsResponse.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 *ProjectsLocationsListCall) Do(opts ...googleapi.CallOption) (*ListLocationsResponse, 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 := &ListLocationsResponse{ + 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 +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsLocationsListCall) Pages(ctx context.Context, f func(*ListLocationsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + +type ProjectsLocationsOperationsCancelCall struct { + s *Service + name string + canceloperationrequest *CancelOperationRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Cancel: Starts asynchronous cancellation on a long-running operation. The +// server makes a best effort to cancel the operation, but success is not +// guaranteed. If the server doesn't support this method, it returns +// `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or +// other methods to check whether the cancellation succeeded or whether the +// operation completed despite cancellation. On successful cancellation, the +// operation is not deleted; instead, it becomes an operation with an +// Operation.error value with a google.rpc.Status.code of 1, corresponding to +// `Code.CANCELLED`. +// +// - name: The name of the operation resource to be cancelled. +func (r *ProjectsLocationsOperationsService) Cancel(name string, canceloperationrequest *CancelOperationRequest) *ProjectsLocationsOperationsCancelCall { + c := &ProjectsLocationsOperationsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.canceloperationrequest = canceloperationrequest + 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 *ProjectsLocationsOperationsCancelCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsCancelCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsOperationsCancelCall) Context(ctx context.Context) *ProjectsLocationsOperationsCancelCall { + 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 *ProjectsLocationsOperationsCancelCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsOperationsCancelCall) 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.canceloperationrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2beta/{+name}:cancel") + 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{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkehub.projects.locations.operations.cancel" call. +// Any non-2xx status code is an error. Response headers are in either +// *Empty.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 *ProjectsLocationsOperationsCancelCall) Do(opts ...googleapi.CallOption) (*Empty, 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 := &Empty{ + 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 ProjectsLocationsOperationsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets the latest state of a long-running operation. Clients can use this +// method to poll the operation result at intervals as recommended by the API +// service. +// +// - name: The name of the operation resource. +func (r *ProjectsLocationsOperationsService) Get(name string) *ProjectsLocationsOperationsGetCall { + c := &ProjectsLocationsOperationsGetCall{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 *ProjectsLocationsOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsGetCall { + 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 *ProjectsLocationsOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsOperationsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsOperationsGetCall { + 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 *ProjectsLocationsOperationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsOperationsGetCall) 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 "gkehub.projects.locations.operations.get" 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 *ProjectsLocationsOperationsGetCall) 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 ProjectsLocationsOperationsListCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists operations that match the specified filter in the request. If +// the server doesn't support this method, it returns `UNIMPLEMENTED`. +// +// - name: The name of the operation's parent resource. +func (r *ProjectsLocationsOperationsService) List(name string) *ProjectsLocationsOperationsListCall { + c := &ProjectsLocationsOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Filter sets the optional parameter "filter": The standard list filter. +func (c *ProjectsLocationsOperationsListCall) Filter(filter string) *ProjectsLocationsOperationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The standard list page +// size. +func (c *ProjectsLocationsOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsOperationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The standard list page +// token. +func (c *ProjectsLocationsOperationsListCall) PageToken(pageToken string) *ProjectsLocationsOperationsListCall { + c.urlParams_.Set("pageToken", pageToken) + 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 *ProjectsLocationsOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsListCall { + 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 *ProjectsLocationsOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsOperationsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsOperationsListCall) Context(ctx context.Context) *ProjectsLocationsOperationsListCall { + 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 *ProjectsLocationsOperationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsOperationsListCall) 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}/operations") + 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 "gkehub.projects.locations.operations.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *ListOperationsResponse.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 *ProjectsLocationsOperationsListCall) Do(opts ...googleapi.CallOption) (*ListOperationsResponse, 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 := &ListOperationsResponse{ + 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 +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsLocationsOperationsListCall) Pages(ctx context.Context, f func(*ListOperationsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} diff --git a/go.mod b/go.mod index b3a6a969771..d9364297210 100644 --- a/go.mod +++ b/go.mod @@ -1,11 +1,11 @@ module google.golang.org/api -go 1.20 +go 1.21 require ( - cloud.google.com/go v0.115.0 - cloud.google.com/go/auth v0.8.1 - cloud.google.com/go/auth/oauth2adapt v0.2.3 + cloud.google.com/go v0.115.1 + cloud.google.com/go/auth v0.9.0 + cloud.google.com/go/auth/oauth2adapt v0.2.4 cloud.google.com/go/compute/metadata v0.5.0 github.com/google/go-cmp v0.6.0 github.com/google/s2a-go v0.1.8 @@ -15,14 +15,14 @@ require ( go.opencensus.io v0.24.0 go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc v0.49.0 go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.49.0 - golang.org/x/net v0.27.0 + golang.org/x/net v0.28.0 golang.org/x/oauth2 v0.22.0 golang.org/x/sync v0.8.0 golang.org/x/time v0.6.0 - google.golang.org/genproto v0.0.0-20240730163845-b1a4ccb954bf - google.golang.org/genproto/googleapis/bytestream v0.0.0-20240730163845-b1a4ccb954bf - google.golang.org/genproto/googleapis/rpc v0.0.0-20240730163845-b1a4ccb954bf - google.golang.org/grpc v1.64.1 + google.golang.org/genproto v0.0.0-20240814211410-ddb44dafa142 + google.golang.org/genproto/googleapis/bytestream v0.0.0-20240814211410-ddb44dafa142 + google.golang.org/genproto/googleapis/rpc v0.0.0-20240814211410-ddb44dafa142 + google.golang.org/grpc v1.65.0 google.golang.org/protobuf v1.34.2 ) @@ -34,7 +34,7 @@ require ( go.opentelemetry.io/otel v1.24.0 // indirect go.opentelemetry.io/otel/metric v1.24.0 // indirect go.opentelemetry.io/otel/trace v1.24.0 // indirect - golang.org/x/crypto v0.25.0 // indirect - golang.org/x/sys v0.22.0 // indirect - golang.org/x/text v0.16.0 // indirect + golang.org/x/crypto v0.26.0 // indirect + golang.org/x/sys v0.23.0 // indirect + golang.org/x/text v0.17.0 // indirect ) diff --git a/go.sum b/go.sum index 4f5f4c039da..f26a5b90147 100644 --- a/go.sum +++ b/go.sum @@ -1,10 +1,10 @@ cloud.google.com/go v0.26.0/go.mod h1:aQUYkXzVsufM+DwF1aE+0xfcU+56JwCaLick0ClmMTw= -cloud.google.com/go v0.115.0 h1:CnFSK6Xo3lDYRoBKEcAtia6VSC837/ZkJuRduSFnr14= -cloud.google.com/go v0.115.0/go.mod h1:8jIM5vVgoAEoiVxQ/O4BFTfHqulPZgs/ufEzMcFMdWU= -cloud.google.com/go/auth v0.8.1 h1:QZW9FjC5lZzN864p13YxvAtGUlQ+KgRL+8Sg45Z6vxo= -cloud.google.com/go/auth v0.8.1/go.mod h1:qGVp/Y3kDRSDZ5gFD/XPUfYQ9xW1iI7q8RIRoCyBbJc= -cloud.google.com/go/auth/oauth2adapt v0.2.3 h1:MlxF+Pd3OmSudg/b1yZ5lJwoXCEaeedAguodky1PcKI= -cloud.google.com/go/auth/oauth2adapt v0.2.3/go.mod h1:tMQXOfZzFuNuUxOypHlQEXgdfX5cuhwU+ffUuXRJE8I= +cloud.google.com/go v0.115.1 h1:Jo0SM9cQnSkYfp44+v+NQXHpcHqlnRJk2qxh6yvxxxQ= +cloud.google.com/go v0.115.1/go.mod h1:DuujITeaufu3gL68/lOFIirVNJwQeyf5UXyi+Wbgknc= +cloud.google.com/go/auth v0.9.0 h1:cYhKl1JUhynmxjXfrk4qdPc6Amw7i+GC9VLflgT0p5M= +cloud.google.com/go/auth v0.9.0/go.mod h1:2HsApZBr9zGZhC9QAXsYVYaWk8kNUt37uny+XVKi7wM= +cloud.google.com/go/auth/oauth2adapt v0.2.4 h1:0GWE/FUsXhf6C+jAkWgYm7X9tK8cuEIfy19DBn6B6bY= +cloud.google.com/go/auth/oauth2adapt v0.2.4/go.mod h1:jC/jOpwFP6JBxhB3P5Rr0a9HLMC/Pe3eaL4NmdvqPtc= cloud.google.com/go/compute/metadata v0.5.0 h1:Zr0eK8JbFv6+Wi4ilXAR8FJ3wyNdpxHKJNPos6LTZOY= cloud.google.com/go/compute/metadata v0.5.0/go.mod h1:aHnloV2TPI38yx4s9+wAZhHykWvVCfu7hQbF+9CWoiY= github.com/BurntSushi/toml v0.3.1/go.mod h1:xHWCNGjB5oqiDr8zfno3MHue2Ht5sIBksp03qcyfWMU= @@ -40,6 +40,7 @@ github.com/golang/protobuf v1.4.0/go.mod h1:jodUvKwWbYaEsadDk5Fwe5c77LiNKVO9IDvq github.com/golang/protobuf v1.4.1/go.mod h1:U8fpvMrcmy5pZrNK1lt4xCsGvpyWQ/VVv6QDs8UjoX8= github.com/golang/protobuf v1.4.3/go.mod h1:oDoupMAO8OvCJWAcko0GGGIgR6R6ocIYbsSw735rRwI= github.com/golang/protobuf v1.5.4 h1:i7eJL8qZTpSEXOPTxNKhASYpMn+8e5Q6AdndVa1dWek= +github.com/golang/protobuf v1.5.4/go.mod h1:lnTiLA8Wa4RWRcIUkrtSVa5nRhsEGBg48fD6rSs7xps= github.com/google/go-cmp v0.2.0/go.mod h1:oXzfMopK8JAjlY9xF4vHSVASa0yLyX7SntLO5aqRK0M= github.com/google/go-cmp v0.3.0/go.mod h1:8QqcDgzrUqlUb/G2PQTWiueGozuR1884gddMywk6iLU= github.com/google/go-cmp v0.3.1/go.mod h1:8QqcDgzrUqlUb/G2PQTWiueGozuR1884gddMywk6iLU= @@ -66,7 +67,8 @@ github.com/stretchr/objx v0.5.0/go.mod h1:Yh+to48EsGEfYuaHDzXPcE3xhTkx73EhmCGUpE github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg= github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU= github.com/stretchr/testify v1.8.1/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4= -github.com/stretchr/testify v1.8.4 h1:CcVxjf3Q8PM0mHUKJCdn+eZZtm5yQwehR5yeSVQQcUk= +github.com/stretchr/testify v1.9.0 h1:HtqpIVDClZ4nwg75+f6Lvsy/wHu+3BoSGCbBAcpTsTg= +github.com/stretchr/testify v1.9.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY= go.opencensus.io v0.24.0 h1:y73uSU6J157QMP2kn2r30vwW1A2W2WFwSCGnAVxeaD0= go.opencensus.io v0.24.0/go.mod h1:vNK8G9p7aAivkbmorf4v+7Hgx+Zs0yY+0fOtgBfjQKo= go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc v0.49.0 h1:4Pp6oUg3+e/6M4C0A/3kJ2VYa++dsWVTtGgLVj5xtHg= @@ -81,8 +83,8 @@ go.opentelemetry.io/otel/trace v1.24.0 h1:CsKnnL4dUAr/0llH9FKuc698G04IrpWV0MQA/Y go.opentelemetry.io/otel/trace v1.24.0/go.mod h1:HPc3Xr/cOApsBI154IU0OI0HJexz+aw5uPdbs3UCjNU= golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w= golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto= -golang.org/x/crypto v0.25.0 h1:ypSNr+bnYL2YhwoMt2zPxHFmbAN1KZs/njMG3hxUp30= -golang.org/x/crypto v0.25.0/go.mod h1:T+wALwcMOSE0kXgUAnPAHqTLW+XHgcELELW8VaDgm/M= +golang.org/x/crypto v0.26.0 h1:RrRspgV4mU+YwB4FYnuBoKsUapNIL5cohGAmSH3azsw= +golang.org/x/crypto v0.26.0/go.mod h1:GY7jblb9wI+FOo5y8/S2oY4zWP07AkOJ4+jxCqdqn54= golang.org/x/exp v0.0.0-20190121172915-509febef88a4/go.mod h1:CJ0aWSM057203Lf6IL+f9T1iT9GByDxfZKAQTCR3kQA= golang.org/x/lint v0.0.0-20181026193005-c67002cb31c3/go.mod h1:UVdnD1Gm6xHRNCYTkRU2/jEulfH38KcIWyp/GAMgvoE= golang.org/x/lint v0.0.0-20190227174305-5b3e6a55c961/go.mod h1:wehouNa3lNwaWXcvxsM5YxQ5yQlVC4a0KAMCusXpPoU= @@ -93,8 +95,8 @@ golang.org/x/net v0.0.0-20190213061140-3a22650c66bd/go.mod h1:mL1N/T3taQHkDXs73r golang.org/x/net v0.0.0-20190311183353-d8887717615a/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg= golang.org/x/net v0.0.0-20190404232315-eb5bcb51f2a3/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg= golang.org/x/net v0.0.0-20201110031124-69a78807bb2b/go.mod h1:sp8m0HH+o8qH0wwXwYZr8TS3Oi6o0r6Gce1SSxlDquU= -golang.org/x/net v0.27.0 h1:5K3Njcw06/l2y9vpGCSdcxWOYHOUk3dVNGDXN+FvAys= -golang.org/x/net v0.27.0/go.mod h1:dDi0PyhWNoiUOrAS8uXv/vnScO4wnHQO4mj9fn/RytE= +golang.org/x/net v0.28.0 h1:a9JDOJc5GMUJ0+UDqmLT86WiEy7iWyIhz8gz8E4e5hE= +golang.org/x/net v0.28.0/go.mod h1:yqtgsTWOOnlGLG9GFRrK3++bGOUEkNBoHZc8MEDWPNg= golang.org/x/oauth2 v0.0.0-20180821212333-d2e6202438be/go.mod h1:N/0e6XlmueqKjAGxoOufVs8QHGRruUQn6yWY3a++T0U= golang.org/x/oauth2 v0.22.0 h1:BzDx2FehcG7jJwgWLELCdmLuxk2i+x9UDpSiss2u0ZA= golang.org/x/oauth2 v0.22.0/go.mod h1:XYTD2NtWslqkgxebSiOHnXEap4TF09sJSc7H1sXbhtI= @@ -107,12 +109,12 @@ golang.org/x/sys v0.0.0-20180830151530-49385e6e1522/go.mod h1:STP8DvDyc/dI5b8T5h golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= golang.org/x/sys v0.0.0-20190412213103-97732733099d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20200930185726-fdedc70b468f/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= -golang.org/x/sys v0.22.0 h1:RI27ohtqKCnwULzJLqkv897zojh5/DwS/ENaMzUOaWI= -golang.org/x/sys v0.22.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA= +golang.org/x/sys v0.23.0 h1:YfKFowiIMvtgl1UERQoTPPToxltDeZfbj4H7dVUCwmM= +golang.org/x/sys v0.23.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA= golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= golang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ= -golang.org/x/text v0.16.0 h1:a94ExnEXNtEwYLGJSIUxnWoxoRz/ZcCsV63ROupILh4= -golang.org/x/text v0.16.0/go.mod h1:GhwF1Be+LQoKShO3cGOHzqOgRrGaYc9AvblQOmPVHnI= +golang.org/x/text v0.17.0 h1:XtiM5bkSOt+ewxlOE/aE/AKEHibwj/6gvWMl9Rsh0Qc= +golang.org/x/text v0.17.0/go.mod h1:BuEKDfySbSR4drPmRPG/7iBdf8hvFMuRexcpahXilzY= golang.org/x/time v0.6.0 h1:eTDhh4ZXt5Qf0augr54TN6suAUudPcawVZeIAPU7D4U= golang.org/x/time v0.6.0/go.mod h1:3BpzKBy/shNhVucY/MWOyx10tF3SFh9QdLuxbVysPQM= golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= @@ -126,20 +128,21 @@ google.golang.org/appengine v1.4.0/go.mod h1:xpcJRLb0r/rnEns0DIKYYv+WjYCduHsrkT7 google.golang.org/genproto v0.0.0-20180817151627-c66870c02cf8/go.mod h1:JiN7NxoALGmiZfu7CAH4rXhgtRTLTxftemlI0sWmxmc= google.golang.org/genproto v0.0.0-20190819201941-24fa4b261c55/go.mod h1:DMBHOl98Agz4BDEuKkezgsaosCRResVns1a3J2ZsMNc= google.golang.org/genproto v0.0.0-20200526211855-cb27e3aa2013/go.mod h1:NbSheEEYHJ7i3ixzK3sjbqSGDJWnxyFXZblF3eUsNvo= -google.golang.org/genproto v0.0.0-20240730163845-b1a4ccb954bf h1:OqdXDEakZCVtDiZTjcxfwbHPCT11ycCEsTKesBVKvyY= -google.golang.org/genproto v0.0.0-20240730163845-b1a4ccb954bf/go.mod h1:mCr1K1c8kX+1iSBREvU3Juo11CB+QOEWxbRS01wWl5M= -google.golang.org/genproto/googleapis/api v0.0.0-20240725223205-93522f1f2a9f h1:b1Ln/PG8orm0SsBbHZWke8dDp2lrCD4jSmfglFpTZbk= -google.golang.org/genproto/googleapis/bytestream v0.0.0-20240730163845-b1a4ccb954bf h1:T4tsZBlZYXK3j40sQNP5MBO32I+rn6ypV1PpklsiV8k= -google.golang.org/genproto/googleapis/bytestream v0.0.0-20240730163845-b1a4ccb954bf/go.mod h1:5/MT647Cn/GGhwTpXC7QqcaR5Cnee4v4MKCU1/nwnIQ= -google.golang.org/genproto/googleapis/rpc v0.0.0-20240730163845-b1a4ccb954bf h1:liao9UHurZLtiEwBgT9LMOnKYsHze6eA6w1KQCMVN2Q= -google.golang.org/genproto/googleapis/rpc v0.0.0-20240730163845-b1a4ccb954bf/go.mod h1:Ue6ibwXGpU+dqIcODieyLOcgj7z8+IcskoNIgZxtrFY= +google.golang.org/genproto v0.0.0-20240814211410-ddb44dafa142 h1:oLiyxGgE+rt22duwci1+TG7bg2/L1LQsXwfjPlmuJA0= +google.golang.org/genproto v0.0.0-20240814211410-ddb44dafa142/go.mod h1:G11eXq53iI5Q+kyNOmCvnzBaxEA2Q/Ik5Tj7nqBE8j4= +google.golang.org/genproto/googleapis/api v0.0.0-20240730163845-b1a4ccb954bf h1:GillM0Ef0pkZPIB+5iO6SDK+4T9pf6TpaYR6ICD5rVE= +google.golang.org/genproto/googleapis/api v0.0.0-20240730163845-b1a4ccb954bf/go.mod h1:OFMYQFHJ4TM3JRlWDZhJbZfra2uqc3WLBZiaaqP4DtU= +google.golang.org/genproto/googleapis/bytestream v0.0.0-20240814211410-ddb44dafa142 h1:abw8n4dbagiJlEWXb1eDu2nB0NDSf6o4J7YO8Fb/ik0= +google.golang.org/genproto/googleapis/bytestream v0.0.0-20240814211410-ddb44dafa142/go.mod h1:gQizMG9jZ0L2ADJaM+JdZV4yTCON/CQpnHRPoM+54w4= +google.golang.org/genproto/googleapis/rpc v0.0.0-20240814211410-ddb44dafa142 h1:e7S5W7MGGLaSu8j3YjdezkZ+m1/Nm0uRVRMEMGk26Xs= +google.golang.org/genproto/googleapis/rpc v0.0.0-20240814211410-ddb44dafa142/go.mod h1:UqMtugtsSgubUsoxbuAoiCXvqvErP7Gf0so0mK9tHxU= google.golang.org/grpc v1.19.0/go.mod h1:mqu4LbDTu4XGKhr4mRzUsmM4RtVoemTSY81AxZiDr8c= google.golang.org/grpc v1.23.0/go.mod h1:Y5yQAOtifL1yxbo5wqy6BxZv8vAUGQwXBOALyacEbxg= google.golang.org/grpc v1.25.1/go.mod h1:c3i+UQWmh7LiEpx4sFZnkU36qjEYZ0imhYfXVyQciAY= google.golang.org/grpc v1.27.0/go.mod h1:qbnxyOmOxrQa7FizSgH+ReBfzJrCY1pSN7KXBS8abTk= google.golang.org/grpc v1.33.2/go.mod h1:JMHMWHQWaTccqQQlmk3MJZS+GWXOdAesneDmEnv2fbc= -google.golang.org/grpc v1.64.1 h1:LKtvyfbX3UGVPFcGqJ9ItpVWW6oN/2XqTxfAnwRRXiA= -google.golang.org/grpc v1.64.1/go.mod h1:hiQF4LFZelK2WKaP6W0L92zGHtiQdZxk8CrSdvyjeP0= +google.golang.org/grpc v1.65.0 h1:bs/cUb4lp1G5iImFFd3u5ixQzweKizoZJAwBNLR42lc= +google.golang.org/grpc v1.65.0/go.mod h1:WgYC2ypjlB0EiQi6wdKixMqukr6lBc0Vo+oOgjrM5ZQ= google.golang.org/protobuf v0.0.0-20200109180630-ec00e32a8dfd/go.mod h1:DFci5gLYBciE7Vtevhsrf46CRTquxDuWsQurQQe4oz8= google.golang.org/protobuf v0.0.0-20200221191635-4d8936d0db64/go.mod h1:kwYJMbMJ01Woi6D6+Kah6886xMZcty6N08ah7+eCXa0= google.golang.org/protobuf v0.0.0-20200228230310-ab0ca4ff8a60/go.mod h1:cfTl7dwQJ+fmap5saPgwCLgHXTUD7jkjRqWcaiX5VyM= diff --git a/go.work b/go.work index 151d410e0bf..6ac9264e8cd 100644 --- a/go.work +++ b/go.work @@ -1,4 +1,4 @@ -go 1.20 +go 1.21 use ( . diff --git a/go.work.sum b/go.work.sum index d6ff0f9571f..572660cd429 100644 --- a/go.work.sum +++ b/go.work.sum @@ -3,29 +3,54 @@ cloud.google.com/go v0.110.2/go.mod h1:k04UEeEtb6ZBRTv3dZz4CeJC3jKGxyhl0sAiVVqux cloud.google.com/go v0.112.0 h1:tpFCD7hpHFlQ8yPwT3x+QeXqc2T6+n6T+hmABHfDUSM= cloud.google.com/go v0.112.0/go.mod h1:3jEEVwZ/MHU4djK5t5RHuKOA/GbLddgTdVubX1qnPD4= cloud.google.com/go/accessapproval v1.7.5/go.mod h1:g88i1ok5dvQ9XJsxpUInWWvUBrIZhyPDPbk4T01OoJ0= +cloud.google.com/go/accessapproval v1.7.11/go.mod h1:KGK3+CLDWm4BvjN0wFtZqdFUGhxlTvTF6PhAwQJGL4M= cloud.google.com/go/accesscontextmanager v1.8.5/go.mod h1:TInEhcZ7V9jptGNqN3EzZ5XMhT6ijWxTGjzyETwmL0Q= +cloud.google.com/go/accesscontextmanager v1.8.11/go.mod h1:nwPysISS3KR5qXipAU6cW/UbDavDdTBBgPohbkhGSok= cloud.google.com/go/aiplatform v1.60.0/go.mod h1:eTlGuHOahHprZw3Hio5VKmtThIOak5/qy6pzdsqcQnM= +cloud.google.com/go/aiplatform v1.68.0/go.mod h1:105MFA3svHjC3Oazl7yjXAmIR89LKhRAeNdnDKJczME= cloud.google.com/go/analytics v0.23.0/go.mod h1:YPd7Bvik3WS95KBok2gPXDqQPHy08TsCQG6CdUCb+u0= +cloud.google.com/go/analytics v0.23.6/go.mod h1:cFz5GwWHrWQi8OHKP9ep3Z4pvHgGcG9lPnFQ+8kXsNo= cloud.google.com/go/apigateway v1.6.5/go.mod h1:6wCwvYRckRQogyDDltpANi3zsCDl6kWi0b4Je+w2UiI= +cloud.google.com/go/apigateway v1.6.11/go.mod h1:4KsrYHn/kSWx8SNUgizvaz+lBZ4uZfU7mUDsGhmkWfM= cloud.google.com/go/apigeeconnect v1.6.5/go.mod h1:MEKm3AiT7s11PqTfKE3KZluZA9O91FNysvd3E6SJ6Ow= +cloud.google.com/go/apigeeconnect v1.6.11/go.mod h1:iMQLTeKxtKL+sb0D+pFlS/TO6za2IUOh/cwMEtn/4g0= cloud.google.com/go/apigeeregistry v0.8.3/go.mod h1:aInOWnqF4yMQx8kTjDqHNXjZGh/mxeNlAf52YqtASUs= +cloud.google.com/go/apigeeregistry v0.8.9/go.mod h1:4XivwtSdfSO16XZdMEQDBCMCWDp3jkCBRhVgamQfLSA= cloud.google.com/go/appengine v1.8.5/go.mod h1:uHBgNoGLTS5di7BvU25NFDuKa82v0qQLjyMJLuPQrVo= +cloud.google.com/go/appengine v1.8.11/go.mod h1:xET3coaDUj+OP4TgnZlgQ+rG2R9fG2nblya13czP56Q= cloud.google.com/go/area120 v0.8.5/go.mod h1:BcoFCbDLZjsfe4EkCnEq1LKvHSK0Ew/zk5UFu6GMyA0= +cloud.google.com/go/area120 v0.8.11/go.mod h1:VBxJejRAJqeuzXQBbh5iHBYUkIjZk5UzFZLCXmzap2o= cloud.google.com/go/artifactregistry v1.14.7/go.mod h1:0AUKhzWQzfmeTvT4SjfI4zjot72EMfrkvL9g9aRjnnM= +cloud.google.com/go/artifactregistry v1.14.13/go.mod h1:zQ/T4xoAFPtcxshl+Q4TJBgsy7APYR/BLd2z3xEAqRA= cloud.google.com/go/asset v1.17.2/go.mod h1:SVbzde67ehddSoKf5uebOD1sYw8Ab/jD/9EIeWg99q4= +cloud.google.com/go/asset v1.19.5/go.mod h1:sqyLOYaLLfc4ACcn3YxqHno+J7lRt9NJTdO50zCUcY0= cloud.google.com/go/assuredworkloads v1.11.5/go.mod h1:FKJ3g3ZvkL2D7qtqIGnDufFkHxwIpNM9vtmhvt+6wqk= +cloud.google.com/go/assuredworkloads v1.11.11/go.mod h1:vaYs6+MHqJvLKYgZBOsuuOhBgNNIguhRU0Kt7JTGcnI= cloud.google.com/go/automl v1.13.5/go.mod h1:MDw3vLem3yh+SvmSgeYUmUKqyls6NzSumDm9OJ3xJ1Y= +cloud.google.com/go/automl v1.13.11/go.mod h1:oMJdXRDOVC+Eq3PnGhhxSut5Hm9TSyVx1aLEOgerOw8= cloud.google.com/go/baremetalsolution v1.2.4/go.mod h1:BHCmxgpevw9IEryE99HbYEfxXkAEA3hkMJbYYsHtIuY= +cloud.google.com/go/baremetalsolution v1.2.10/go.mod h1:eO2c2NMRy5ytcNPhG78KPsWGNsX5W/tUsCOWmYihx6I= cloud.google.com/go/batch v1.8.0/go.mod h1:k8V7f6VE2Suc0zUM4WtoibNrA6D3dqBpB+++e3vSGYc= +cloud.google.com/go/batch v1.9.2/go.mod h1:smqwS4sleDJVAEzBt/TzFfXLktmWjFNugGDWl8coKX4= cloud.google.com/go/beyondcorp v1.0.4/go.mod h1:Gx8/Rk2MxrvWfn4WIhHIG1NV7IBfg14pTKv1+EArVcc= +cloud.google.com/go/beyondcorp v1.0.10/go.mod h1:G09WxvxJASbxbrzaJUMVvNsB1ZiaKxpbtkjiFtpDtbo= cloud.google.com/go/bigquery v1.59.1/go.mod h1:VP1UJYgevyTwsV7desjzNzDND5p6hZB+Z8gZJN1GQUc= +cloud.google.com/go/bigquery v1.62.0/go.mod h1:5ee+ZkF1x/ntgCsFQJAQTM3QkAZOecfCmvxhkJsWRSA= +cloud.google.com/go/bigtable v1.27.2-0.20240730134218-123c88616251/go.mod h1:avmXcmxVbLJAo9moICRYMgDyTTPoV0MA0lHKnyqV4fQ= cloud.google.com/go/billing v1.18.2/go.mod h1:PPIwVsOOQ7xzbADCwNe8nvK776QpfrOAUkvKjCUcpSE= +cloud.google.com/go/billing v1.18.9/go.mod h1:bKTnh8MBfCMUT1fzZ936CPN9rZG7ZEiHB2J3SjIjByc= cloud.google.com/go/binaryauthorization v1.8.1/go.mod h1:1HVRyBerREA/nhI7yLang4Zn7vfNVA3okoAR9qYQJAQ= +cloud.google.com/go/binaryauthorization v1.8.7/go.mod h1:cRj4teQhOme5SbWQa96vTDATQdMftdT5324BznxANtg= cloud.google.com/go/certificatemanager v1.7.5/go.mod h1:uX+v7kWqy0Y3NG/ZhNvffh0kuqkKZIXdvlZRO7z0VtM= +cloud.google.com/go/certificatemanager v1.8.5/go.mod h1:r2xINtJ/4xSz85VsqvjY53qdlrdCjyniib9Jp98ZKKM= cloud.google.com/go/channel v1.17.5/go.mod h1:FlpaOSINDAXgEext0KMaBq/vwpLMkkPAw9b2mApQeHc= +cloud.google.com/go/channel v1.17.11/go.mod h1:gjWCDBcTGQce/BSMoe2lAqhlq0dIRiZuktvBKXUawp0= cloud.google.com/go/cloudbuild v1.15.1/go.mod h1:gIofXZSu+XD2Uy+qkOrGKEx45zd7s28u/k8f99qKals= +cloud.google.com/go/cloudbuild v1.16.5/go.mod h1:HXLpZ8QeYZgmDIWpbl9Gs22p6o6uScgQ/cV9HF9cIZU= cloud.google.com/go/clouddms v1.7.4/go.mod h1:RdrVqoFG9RWI5AvZ81SxJ/xvxPdtcRhFotwdE79DieY= +cloud.google.com/go/clouddms v1.7.10/go.mod h1:PzHELq0QDyA7VaD9z6mzh2mxeBz4kM6oDe8YxMxd4RA= cloud.google.com/go/cloudtasks v1.12.6/go.mod h1:b7c7fe4+TJsFZfDyzO51F7cjq7HLUlRi/KZQLQjDsaY= +cloud.google.com/go/cloudtasks v1.12.12/go.mod h1:8UmM+duMrQpzzRREo0i3x3TrFjsgI/3FQw3664/JblA= cloud.google.com/go/compute v1.19.0/go.mod h1:rikpw2y+UMidAe9tISo04EHNOIf42RLYF/q8Bs93scU= cloud.google.com/go/compute v1.20.1/go.mod h1:4tCnrn48xsqlwSAiLf1HXMQk8CONslYbdiEZc9FEIbM= cloud.google.com/go/compute v1.23.3/go.mod h1:VCgBUoMnIVIR0CscqQiPJLAG25E3ZRZMzcFZeQ+h8CI= @@ -36,106 +61,200 @@ cloud.google.com/go/compute v1.27.0 h1:EGawh2RUnfHT5g8f/FX3Ds6KZuIBC77hZoDrBvEZw cloud.google.com/go/compute v1.27.1 h1:0WbBLIPNANheCRZ4h8QhgzjN53KMutbiVBOLtPiVzBU= cloud.google.com/go/compute v1.27.2 h1:5cE5hdrwJV/92ravlwIFRGnyH9CpLGhh4N0ZDVTU+BA= cloud.google.com/go/compute v1.27.4 h1:XM8ulx6crjdl09XBfji7viFgZOEQuIxBwKmjRH9Rtmc= +cloud.google.com/go/compute v1.27.4/go.mod h1:7JZS+h21ERAGHOy5qb7+EPyXlQwzshzrx1x6L9JhTqU= cloud.google.com/go/compute/metadata v0.2.3/go.mod h1:VAV5nSsACxMJvgaAuX6Pk2AawlZn8kiOGuCv6gTkwuA= cloud.google.com/go/contactcenterinsights v1.13.0/go.mod h1:ieq5d5EtHsu8vhe2y3amtZ+BE+AQwX5qAy7cpo0POsI= +cloud.google.com/go/contactcenterinsights v1.13.6/go.mod h1:mL+DbN3pMQGaAbDC4wZhryLciwSwHf5Tfk4Itr72Zyk= cloud.google.com/go/container v1.31.0/go.mod h1:7yABn5s3Iv3lmw7oMmyGbeV6tQj86njcTijkkGuvdZA= +cloud.google.com/go/container v1.38.0/go.mod h1:U0uPBvkVWOJGY/0qTVuPS7NeafFEUsHSPqT5pB8+fCY= cloud.google.com/go/containeranalysis v0.11.4/go.mod h1:cVZT7rXYBS9NG1rhQbWL9pWbXCKHWJPYraE8/FTSYPE= +cloud.google.com/go/containeranalysis v0.12.1/go.mod h1:+/lcJIQSFt45TC0N9Nq7/dPbl0isk6hnC4EvBBqyXsM= cloud.google.com/go/datacatalog v1.19.3/go.mod h1:ra8V3UAsciBpJKQ+z9Whkxzxv7jmQg1hfODr3N3YPJ4= +cloud.google.com/go/datacatalog v1.20.5/go.mod h1:DB0QWF9nelpsbB0eR/tA0xbHZZMvpoFD1XFy3Qv/McI= cloud.google.com/go/dataflow v0.9.5/go.mod h1:udl6oi8pfUHnL0z6UN9Lf9chGqzDMVqcYTcZ1aPnCZQ= +cloud.google.com/go/dataflow v0.9.11/go.mod h1:CCLufd7I4pPfyp54qMgil/volrL2ZKYjXeYLfQmBGJs= cloud.google.com/go/dataform v0.9.2/go.mod h1:S8cQUwPNWXo7m/g3DhWHsLBoufRNn9EgFrMgne2j7cI= +cloud.google.com/go/dataform v0.9.8/go.mod h1:cGJdyVdunN7tkeXHPNosuMzmryx55mp6cInYBgxN3oA= cloud.google.com/go/datafusion v1.7.5/go.mod h1:bYH53Oa5UiqahfbNK9YuYKteeD4RbQSNMx7JF7peGHc= +cloud.google.com/go/datafusion v1.7.11/go.mod h1:aU9zoBHgYmoPp4dzccgm/Gi4xWDMXodSZlNZ4WNeptw= cloud.google.com/go/datalabeling v0.8.5/go.mod h1:IABB2lxQnkdUbMnQaOl2prCOfms20mcPxDBm36lps+s= +cloud.google.com/go/datalabeling v0.8.11/go.mod h1:6IGUV3z7hlkAU5ndKVshv/8z+7pxE+k0qXsEjyzO1Xg= cloud.google.com/go/dataplex v1.14.2/go.mod h1:0oGOSFlEKef1cQeAHXy4GZPB/Ife0fz/PxBf+ZymA2U= +cloud.google.com/go/dataplex v1.18.2/go.mod h1:NuBpJJMGGQn2xctX+foHEDKRbizwuiHJamKvvSteY3Q= cloud.google.com/go/dataproc/v2 v2.4.0/go.mod h1:3B1Ht2aRB8VZIteGxQS/iNSJGzt9+CA0WGnDVMEm7Z4= +cloud.google.com/go/dataproc/v2 v2.5.3/go.mod h1:RgA5QR7v++3xfP7DlgY3DUmoDSTaaemPe0ayKrQfyeg= cloud.google.com/go/dataqna v0.8.5/go.mod h1:vgihg1mz6n7pb5q2YJF7KlXve6tCglInd6XO0JGOlWM= +cloud.google.com/go/dataqna v0.8.11/go.mod h1:74Icl1oFKKZXPd+W7YDtqJLa+VwLV6wZ+UF+sHo2QZQ= cloud.google.com/go/datastore v1.15.0/go.mod h1:GAeStMBIt9bPS7jMJA85kgkpsMkvseWWXiaHya9Jes8= +cloud.google.com/go/datastore v1.17.1/go.mod h1:mtzZ2HcVtz90OVrEXXGDc2pO4NM1kiBQy8YV4qGe0ZM= cloud.google.com/go/datastream v1.10.4/go.mod h1:7kRxPdxZxhPg3MFeCSulmAJnil8NJGGvSNdn4p1sRZo= +cloud.google.com/go/datastream v1.10.10/go.mod h1:NqchuNjhPlISvWbk426/AU/S+Kgv7srlID9P5XOAbtg= cloud.google.com/go/deploy v1.17.1/go.mod h1:SXQyfsXrk0fBmgBHRzBjQbZhMfKZ3hMQBw5ym7MN/50= +cloud.google.com/go/deploy v1.20.0/go.mod h1:PaOfS47VrvmYnxG5vhHg0KU60cKeWcqyLbMBjxS8DW8= cloud.google.com/go/dialogflow v1.49.0/go.mod h1:dhVrXKETtdPlpPhE7+2/k4Z8FRNUp6kMV3EW3oz/fe0= +cloud.google.com/go/dialogflow v1.55.0/go.mod h1:0u0hSlJiFpMkMpMNoFrQETwDjaRm8Q8hYKv+jz5JeRA= cloud.google.com/go/dlp v1.11.2/go.mod h1:9Czi+8Y/FegpWzgSfkRlyz+jwW6Te9Rv26P3UfU/h/w= +cloud.google.com/go/dlp v1.15.0/go.mod h1:LtPZxZAenBXKzvWIOB2hdHIXuEcK0wW0En8//u+/nNA= cloud.google.com/go/documentai v1.25.0/go.mod h1:ftLnzw5VcXkLItp6pw1mFic91tMRyfv6hHEY5br4KzY= +cloud.google.com/go/documentai v1.30.5/go.mod h1:5ajlDvaPyl9tc+K/jZE8WtYIqSXqAD33Z1YAYIjfad4= cloud.google.com/go/domains v0.9.5/go.mod h1:dBzlxgepazdFhvG7u23XMhmMKBjrkoUNaw0A8AQB55Y= +cloud.google.com/go/domains v0.9.11/go.mod h1:efo5552kUyxsXEz30+RaoIS2lR7tp3M/rhiYtKXkhkk= cloud.google.com/go/edgecontainer v1.1.5/go.mod h1:rgcjrba3DEDEQAidT4yuzaKWTbkTI5zAMu3yy6ZWS0M= +cloud.google.com/go/edgecontainer v1.2.5/go.mod h1:OAb6tElD3F3oBujFAup14PKOs9B/lYobTb6LARmoACY= cloud.google.com/go/errorreporting v0.3.0/go.mod h1:xsP2yaAp+OAW4OIm60An2bbLpqIhKXdWR/tawvl7QzU= +cloud.google.com/go/errorreporting v0.3.1/go.mod h1:6xVQXU1UuntfAf+bVkFk6nld41+CPyF2NSPCyXE3Ztk= cloud.google.com/go/essentialcontacts v1.6.6/go.mod h1:XbqHJGaiH0v2UvtuucfOzFXN+rpL/aU5BCZLn4DYl1Q= +cloud.google.com/go/essentialcontacts v1.6.12/go.mod h1:UGhWTIYewH8Ma4wDRJp8cMAHUCeAOCKsuwd6GLmmQLc= cloud.google.com/go/eventarc v1.13.4/go.mod h1:zV5sFVoAa9orc/52Q+OuYUG9xL2IIZTbbuTHC6JSY8s= +cloud.google.com/go/eventarc v1.13.10/go.mod h1:KlCcOMApmUaqOEZUpZRVH+p0nnnsY1HaJB26U4X5KXE= cloud.google.com/go/filestore v1.8.1/go.mod h1:MbN9KcaM47DRTIuLfQhJEsjaocVebNtNQhSLhKCF5GM= +cloud.google.com/go/filestore v1.8.7/go.mod h1:dKfyH0YdPAKdYHqAR/bxZeil85Y5QmrEVQwIYuRjcXI= cloud.google.com/go/firestore v1.14.0/go.mod h1:96MVaHLsEhbvkBEdZgfN+AS/GIkco1LRpH9Xp9YZfzQ= +cloud.google.com/go/firestore v1.16.0/go.mod h1:+22v/7p+WNBSQwdSwP57vz47aZiY+HrDkrOsJNhk7rg= cloud.google.com/go/functions v1.16.0/go.mod h1:nbNpfAG7SG7Duw/o1iZ6ohvL7mc6MapWQVpqtM29n8k= +cloud.google.com/go/functions v1.16.6/go.mod h1:wOzZakhMueNQaBUJdf0yjsJIe0GBRu+ZTvdSTzqHLs0= cloud.google.com/go/gkebackup v1.3.5/go.mod h1:KJ77KkNN7Wm1LdMopOelV6OodM01pMuK2/5Zt1t4Tvc= +cloud.google.com/go/gkebackup v1.5.4/go.mod h1:V+llvHlRD0bCyrkYaAMJX+CHralceQcaOWjNQs8/Ymw= cloud.google.com/go/gkeconnect v0.8.5/go.mod h1:LC/rS7+CuJ5fgIbXv8tCD/mdfnlAadTaUufgOkmijuk= +cloud.google.com/go/gkeconnect v0.8.11/go.mod h1:ejHv5ehbceIglu1GsMwlH0nZpTftjxEY6DX7tvaM8gA= cloud.google.com/go/gkehub v0.14.5/go.mod h1:6bzqxM+a+vEH/h8W8ec4OJl4r36laxTs3A/fMNHJ0wA= +cloud.google.com/go/gkehub v0.14.11/go.mod h1:CsmDJ4qbBnSPkoBltEubK6qGOjG0xNfeeT5jI5gCnRQ= cloud.google.com/go/gkemulticloud v1.1.1/go.mod h1:C+a4vcHlWeEIf45IB5FFR5XGjTeYhF83+AYIpTy4i2Q= +cloud.google.com/go/gkemulticloud v1.2.4/go.mod h1:PjTtoKLQpIRztrL+eKQw8030/S4c7rx/WvHydDJlpGE= cloud.google.com/go/gsuiteaddons v1.6.5/go.mod h1:Lo4P2IvO8uZ9W+RaC6s1JVxo42vgy+TX5a6hfBZ0ubs= +cloud.google.com/go/gsuiteaddons v1.6.11/go.mod h1:U7mk5PLBzDpHhgHv5aJkuvLp9RQzZFpa8hgWAB+xVIk= cloud.google.com/go/iam v0.13.0/go.mod h1:ljOg+rcNfzZ5d6f1nAUJ8ZIxOaZUVoS14bKCtaLZ/D0= cloud.google.com/go/iam v1.1.5/go.mod h1:rB6P/Ic3mykPbFio+vo7403drjlgvoWfYpJhMXEbzv8= cloud.google.com/go/iam v1.1.6 h1:bEa06k05IO4f4uJonbB5iAgKTPpABy1ayxaIZV/GHVc= cloud.google.com/go/iam v1.1.6/go.mod h1:O0zxdPeGBoFdWW3HWmBxJsk0pfvNM/p/qa82rWOGTwI= +cloud.google.com/go/iam v1.1.12/go.mod h1:9LDX8J7dN5YRyzVHxwQzrQs9opFFqn0Mxs9nAeB+Hhg= cloud.google.com/go/iap v1.9.4/go.mod h1:vO4mSq0xNf/Pu6E5paORLASBwEmphXEjgCFg7aeNu1w= +cloud.google.com/go/iap v1.9.10/go.mod h1:pO0FEirrhMOT1H0WVwpD5dD9r3oBhvsunyBQtNXzzc0= cloud.google.com/go/ids v1.4.5/go.mod h1:p0ZnyzjMWxww6d2DvMGnFwCsSxDJM666Iir1bK1UuBo= +cloud.google.com/go/ids v1.4.11/go.mod h1:+ZKqWELpJm8WcRRsSvKZWUdkriu4A3XsLLzToTv3418= cloud.google.com/go/iot v1.7.5/go.mod h1:nq3/sqTz3HGaWJi1xNiX7F41ThOzpud67vwk0YsSsqs= +cloud.google.com/go/iot v1.7.11/go.mod h1:0vZJOqFy9kVLbUXwTP95e0dWHakfR4u5IWqsKMGIfHk= cloud.google.com/go/kms v1.15.7/go.mod h1:ub54lbsa6tDkUwnu4W7Yt1aAIFLnspgh0kPGToDukeI= +cloud.google.com/go/kms v1.18.4/go.mod h1:SG1bgQ3UWW6/KdPo9uuJnzELXY5YTTMJtDYvajiQ22g= cloud.google.com/go/language v1.12.3/go.mod h1:evFX9wECX6mksEva8RbRnr/4wi/vKGYnAJrTRXU8+f8= +cloud.google.com/go/language v1.12.9/go.mod h1:B9FbD17g1EkilctNGUDAdSrBHiFOlKNErLljO7jplDU= cloud.google.com/go/lifesciences v0.9.5/go.mod h1:OdBm0n7C0Osh5yZB7j9BXyrMnTRGBJIZonUMxo5CzPw= +cloud.google.com/go/lifesciences v0.9.11/go.mod h1:NMxu++FYdv55TxOBEvLIhiAvah8acQwXsz79i9l9/RY= cloud.google.com/go/logging v1.9.0/go.mod h1:1Io0vnZv4onoUnsVUQY3HZ3Igb1nBchky0A0y7BBBhE= +cloud.google.com/go/logging v1.11.0/go.mod h1:5LDiJC/RxTt+fHc1LAt20R9TKiUTReDg6RuuFOZ67+A= cloud.google.com/go/longrunning v0.5.4/go.mod h1:zqNVncI0BOP8ST6XQD1+VcvuShMmq7+xFSzOL++V0dI= cloud.google.com/go/longrunning v0.5.5 h1:GOE6pZFdSrTb4KAiKnXsJBtlE6mEyaW44oKyMILWnOg= cloud.google.com/go/longrunning v0.5.5/go.mod h1:WV2LAxD8/rg5Z1cNW6FJ/ZpX4E4VnDnoTk0yawPBB7s= +cloud.google.com/go/longrunning v0.5.11/go.mod h1:rDn7//lmlfWV1Dx6IB4RatCPenTwwmqXuiP0/RgoEO4= cloud.google.com/go/managedidentities v1.6.5/go.mod h1:fkFI2PwwyRQbjLxlm5bQ8SjtObFMW3ChBGNqaMcgZjI= +cloud.google.com/go/managedidentities v1.6.11/go.mod h1:df+8oZ1D4Eri+NrcpuiR5Hd6MGgiMqn0ZCzNmBYPS0A= cloud.google.com/go/maps v1.6.4/go.mod h1:rhjqRy8NWmDJ53saCfsXQ0LKwBHfi6OSh5wkq6BaMhI= +cloud.google.com/go/maps v1.11.5/go.mod h1:MOS/NN0L6b7Kumr8bLux9XTpd8+D54DYxBMUjq+XfXs= cloud.google.com/go/mediatranslation v0.8.5/go.mod h1:y7kTHYIPCIfgyLbKncgqouXJtLsU+26hZhHEEy80fSs= +cloud.google.com/go/mediatranslation v0.8.11/go.mod h1:3sNEm0fx61eHk7rfzBzrljVV9XKr931xI3OFacQBVFg= cloud.google.com/go/memcache v1.10.5/go.mod h1:/FcblbNd0FdMsx4natdj+2GWzTq+cjZvMa1I+9QsuMA= +cloud.google.com/go/memcache v1.10.11/go.mod h1:ubJ7Gfz/xQawQY5WO5pht4Q0dhzXBFeEszAeEJnwBHU= cloud.google.com/go/metastore v1.13.4/go.mod h1:FMv9bvPInEfX9Ac1cVcRXp8EBBQnBcqH6gz3KvJ9BAE= +cloud.google.com/go/metastore v1.13.10/go.mod h1:RPhMnBxUmTLT1fN7fNbPqtH5EoGHueDxubmJ1R1yT84= cloud.google.com/go/monitoring v1.18.0/go.mod h1:c92vVBCeq/OB4Ioyo+NbN2U7tlg5ZH41PZcdvfc+Lcg= +cloud.google.com/go/monitoring v1.20.3/go.mod h1:GPIVIdNznIdGqEjtRKQWTLcUeRnPjZW85szouimiczU= cloud.google.com/go/networkconnectivity v1.14.4/go.mod h1:PU12q++/IMnDJAB+3r+tJtuCXCfwfN+C6Niyj6ji1Po= +cloud.google.com/go/networkconnectivity v1.14.10/go.mod h1:f7ZbGl4CV08DDb7lw+NmMXQTKKjMhgCEEwFbEukWuOY= cloud.google.com/go/networkmanagement v1.9.4/go.mod h1:daWJAl0KTFytFL7ar33I6R/oNBH8eEOX/rBNHrC/8TA= +cloud.google.com/go/networkmanagement v1.13.6/go.mod h1:WXBijOnX90IFb6sberjnGrVtZbgDNcPDUYOlGXmG8+4= cloud.google.com/go/networksecurity v0.9.5/go.mod h1:KNkjH/RsylSGyyZ8wXpue8xpCEK+bTtvof8SBfIhMG8= +cloud.google.com/go/networksecurity v0.9.11/go.mod h1:4xbpOqCwplmFgymAjPFM6ZIplVC6+eQ4m7sIiEq9oJA= cloud.google.com/go/notebooks v1.11.3/go.mod h1:0wQyI2dQC3AZyQqWnRsp+yA+kY4gC7ZIVP4Qg3AQcgo= +cloud.google.com/go/notebooks v1.11.9/go.mod h1:JmnRX0eLgHRJiyxw8HOgumW9iRajImZxr7r75U16uXw= cloud.google.com/go/optimization v1.6.3/go.mod h1:8ve3svp3W6NFcAEFr4SfJxrldzhUl4VMUJmhrqVKtYA= +cloud.google.com/go/optimization v1.6.9/go.mod h1:mcvkDy0p4s5k7iSaiKrwwpN0IkteHhGmuW5rP9nXA5M= cloud.google.com/go/orchestration v1.8.5/go.mod h1:C1J7HesE96Ba8/hZ71ISTV2UAat0bwN+pi85ky38Yq8= +cloud.google.com/go/orchestration v1.9.6/go.mod h1:gQvdIsHESZJigimnbUA8XLbYeFlSg/z+A7ppds5JULg= cloud.google.com/go/orgpolicy v1.12.1/go.mod h1:aibX78RDl5pcK3jA8ysDQCFkVxLj3aOQqrbBaUL2V5I= +cloud.google.com/go/orgpolicy v1.12.7/go.mod h1:Os3GlUFRPf1UxOHTup5b70BARnhHeQNNVNZzJXPbWYI= cloud.google.com/go/osconfig v1.12.5/go.mod h1:D9QFdxzfjgw3h/+ZaAb5NypM8bhOMqBzgmbhzWViiW8= +cloud.google.com/go/osconfig v1.13.2/go.mod h1:eupylkWQJCwSIEMkpVR4LqpgKkQi0mD4m1DzNCgpQso= cloud.google.com/go/oslogin v1.13.1/go.mod h1:vS8Sr/jR7QvPWpCjNqy6LYZr5Zs1e8ZGW/KPn9gmhws= +cloud.google.com/go/oslogin v1.13.7/go.mod h1:xq027cL0fojpcEcpEQdWayiDn8tIx3WEFYMM6+q7U+E= cloud.google.com/go/phishingprotection v0.8.5/go.mod h1:g1smd68F7mF1hgQPuYn3z8HDbNre8L6Z0b7XMYFmX7I= +cloud.google.com/go/phishingprotection v0.8.11/go.mod h1:Mge0cylqVFs+D0EyxlsTOJ1Guf3qDgrztHzxZqkhRQM= cloud.google.com/go/policytroubleshooter v1.10.3/go.mod h1:+ZqG3agHT7WPb4EBIRqUv4OyIwRTZvsVDHZ8GlZaoxk= +cloud.google.com/go/policytroubleshooter v1.10.9/go.mod h1:X8HEPVBWz8E+qwI/QXnhBLahEHdcuPO3M9YvSj0LDek= cloud.google.com/go/privatecatalog v0.9.5/go.mod h1:fVWeBOVe7uj2n3kWRGlUQqR/pOd450J9yZoOECcQqJk= +cloud.google.com/go/privatecatalog v0.9.11/go.mod h1:awEF2a8M6UgoqVJcF/MthkF8SSo6OoWQ7TtPNxUlljY= cloud.google.com/go/pubsub v1.36.1/go.mod h1:iYjCa9EzWOoBiTdd4ps7QoMtMln5NwaZQpK1hbRfBDE= +cloud.google.com/go/pubsub v1.40.0/go.mod h1:BVJI4sI2FyXp36KFKvFwcfDRDfR8MiLT8mMhmIhdAeA= cloud.google.com/go/pubsublite v1.8.1/go.mod h1:fOLdU4f5xldK4RGJrBMm+J7zMWNj/k4PxwEZXy39QS0= +cloud.google.com/go/pubsublite v1.8.2/go.mod h1:4r8GSa9NznExjuLPEJlF1VjOPOpgf3IT6k8x/YgaOPI= cloud.google.com/go/recaptchaenterprise/v2 v2.9.2/go.mod h1:trwwGkfhCmp05Ll5MSJPXY7yvnO0p4v3orGANAFHAuU= +cloud.google.com/go/recaptchaenterprise/v2 v2.14.2/go.mod h1:MwPgdgvBkE46aWuuXeBTCB8hQJ88p+CpXInROZYCTkc= cloud.google.com/go/recommendationengine v0.8.5/go.mod h1:A38rIXHGFvoPvmy6pZLozr0g59NRNREz4cx7F58HAsQ= +cloud.google.com/go/recommendationengine v0.8.11/go.mod h1:cEkU4tCXAF88a4boMFZym7U7uyxvVwcQtKzS85IbQio= cloud.google.com/go/recommender v1.12.1/go.mod h1:gf95SInWNND5aPas3yjwl0I572dtudMhMIG4ni8nr+0= +cloud.google.com/go/recommender v1.12.7/go.mod h1:lG8DVtczLltWuaCv4IVpNphONZTzaCC9KdxLYeZM5G4= cloud.google.com/go/redis v1.14.2/go.mod h1:g0Lu7RRRz46ENdFKQ2EcQZBAJ2PtJHJLuiiRuEXwyQw= +cloud.google.com/go/redis v1.16.4/go.mod h1:unCVfLP5eFrVhGLDnb7IaSaWxuZ+7cBgwwBwbdG9m9w= cloud.google.com/go/resourcemanager v1.9.5/go.mod h1:hep6KjelHA+ToEjOfO3garMKi/CLYwTqeAw7YiEI9x8= +cloud.google.com/go/resourcemanager v1.9.11/go.mod h1:SbNAbjVLoi2rt9G74bEYb3aw1iwvyWPOJMnij4SsmHA= cloud.google.com/go/resourcesettings v1.6.5/go.mod h1:WBOIWZraXZOGAgoR4ukNj0o0HiSMO62H9RpFi9WjP9I= +cloud.google.com/go/resourcesettings v1.7.4/go.mod h1:seBdLuyeq+ol2u9G2+74GkSjQaxaBWF+vVb6mVzQFG0= cloud.google.com/go/retail v1.16.0/go.mod h1:LW7tllVveZo4ReWt68VnldZFWJRzsh9np+01J9dYWzE= +cloud.google.com/go/retail v1.17.4/go.mod h1:oPkL1FzW7D+v/hX5alYIx52ro2FY/WPAviwR1kZZTMs= cloud.google.com/go/run v1.3.4/go.mod h1:FGieuZvQ3tj1e9GnzXqrMABSuir38AJg5xhiYq+SF3o= +cloud.google.com/go/run v1.4.0/go.mod h1:4G9iHLjdOC+CQ0CzA0+6nLeR6NezVPmlj+GULmb0zE4= cloud.google.com/go/scheduler v1.10.6/go.mod h1:pe2pNCtJ+R01E06XCDOJs1XvAMbv28ZsQEbqknxGOuE= +cloud.google.com/go/scheduler v1.10.12/go.mod h1:6DRtOddMWJ001HJ6MS148rtLSh/S2oqd2hQC3n5n9fQ= cloud.google.com/go/secretmanager v1.11.5/go.mod h1:eAGv+DaCHkeVyQi0BeXgAHOU0RdrMeZIASKc+S7VqH4= +cloud.google.com/go/secretmanager v1.13.5/go.mod h1:/OeZ88l5Z6nBVilV0SXgv6XJ243KP2aIhSWRMrbvDCQ= cloud.google.com/go/security v1.15.5/go.mod h1:KS6X2eG3ynWjqcIX976fuToN5juVkF6Ra6c7MPnldtc= +cloud.google.com/go/security v1.17.4/go.mod h1:KMuDJH+sEB3KTODd/tLJ7kZK+u2PQt+Cfu0oAxzIhgo= cloud.google.com/go/securitycenter v1.24.4/go.mod h1:PSccin+o1EMYKcFQzz9HMMnZ2r9+7jbc+LvPjXhpwcU= +cloud.google.com/go/securitycenter v1.33.1/go.mod h1:jeFisdYUWHr+ig72T4g0dnNCFhRwgwGoQV6GFuEwafw= cloud.google.com/go/servicedirectory v1.11.4/go.mod h1:Bz2T9t+/Ehg6x+Y7Ycq5xiShYLD96NfEsWNHyitj1qM= +cloud.google.com/go/servicedirectory v1.11.11/go.mod h1:pnynaftaj9LmRLIc6t3r7r7rdCZZKKxui/HaF/RqYfs= cloud.google.com/go/shell v1.7.5/go.mod h1:hL2++7F47/IfpfTO53KYf1EC+F56k3ThfNEXd4zcuiE= +cloud.google.com/go/shell v1.7.11/go.mod h1:SywZHWac7onifaT9m9MmegYp3GgCLm+tgk+w2lXK8vg= cloud.google.com/go/spanner v1.57.0/go.mod h1:aXQ5QDdhPRIqVhYmnkAdwPYvj/DRN0FguclhEWw+jOo= +cloud.google.com/go/spanner v1.65.0/go.mod h1:dQGB+w5a67gtyE3qSKPPxzniedrnAmV6tewQeBY7Hxs= cloud.google.com/go/speech v1.21.1/go.mod h1:E5GHZXYQlkqWQwY5xRSLHw2ci5NMQNG52FfMU1aZrIA= +cloud.google.com/go/speech v1.24.0/go.mod h1:HcVyIh5jRXM5zDMcbFCW+DF2uK/MSGN6Rastt6bj1ic= cloud.google.com/go/storage v1.29.0/go.mod h1:4puEjyTKnku6gfKoTfNOU/W+a9JyuVNxjpS5GBrB8h4= cloud.google.com/go/storage v1.36.0/go.mod h1:M6M/3V/D3KpzMTJyPOR/HU6n2Si5QdaXYEsng2xgOs8= cloud.google.com/go/storage v1.37.0/go.mod h1:i34TiT2IhiNDmcj65PqwCjcoUX7Z5pLzS8DEmoiFq1k= +cloud.google.com/go/storage v1.41.0/go.mod h1:J1WCa/Z2FcgdEDuPUY8DxT5I+d9mFKsCepp5vR6Sq80= cloud.google.com/go/storagetransfer v1.10.4/go.mod h1:vef30rZKu5HSEf/x1tK3WfWrL0XVoUQN/EPDRGPzjZs= +cloud.google.com/go/storagetransfer v1.10.10/go.mod h1:8+nX+WgQ2ZJJnK8e+RbK/zCXk8T7HdwyQAJeY7cEcm0= cloud.google.com/go/talent v1.6.6/go.mod h1:y/WQDKrhVz12WagoarpAIyKKMeKGKHWPoReZ0g8tseQ= +cloud.google.com/go/talent v1.6.12/go.mod h1:nT9kNVuJhZX2QgqKZS6t6eCWZs5XEBYRBv6bIMnPmo4= cloud.google.com/go/texttospeech v1.7.5/go.mod h1:tzpCuNWPwrNJnEa4Pu5taALuZL4QRRLcb+K9pbhXT6M= +cloud.google.com/go/texttospeech v1.7.11/go.mod h1:Ua125HU+WT2IkIo5MzQtuNpNEk72soShJQVdorZ1SAE= cloud.google.com/go/tpu v1.6.5/go.mod h1:P9DFOEBIBhuEcZhXi+wPoVy/cji+0ICFi4TtTkMHSSs= +cloud.google.com/go/tpu v1.6.11/go.mod h1:W0C4xaSj1Ay3VX/H96FRvLt2HDs0CgdRPVI4e7PoCDk= cloud.google.com/go/trace v1.10.5/go.mod h1:9hjCV1nGBCtXbAE4YK7OqJ8pmPYSxPA0I67JwRd5s3M= +cloud.google.com/go/trace v1.10.11/go.mod h1:fUr5L3wSXerNfT0f1bBg08W4axS2VbHGgYcfH4KuTXU= cloud.google.com/go/translate v1.10.1/go.mod h1:adGZcQNom/3ogU65N9UXHOnnSvjPwA/jKQUMnsYXOyk= +cloud.google.com/go/translate v1.10.7/go.mod h1:mH/+8tvcItuy1cOWqU+/Y3iFHgkVUObNIQYI/kiFFiY= cloud.google.com/go/video v1.20.4/go.mod h1:LyUVjyW+Bwj7dh3UJnUGZfyqjEto9DnrvTe1f/+QrW0= +cloud.google.com/go/video v1.22.0/go.mod h1:CxPshUNAb1ucnzbtruEHlAal9XY+SPG2cFqC/woJzII= cloud.google.com/go/videointelligence v1.11.5/go.mod h1:/PkeQjpRponmOerPeJxNPuxvi12HlW7Em0lJO14FC3I= +cloud.google.com/go/videointelligence v1.11.11/go.mod h1:dab2Ca3AXT6vNJmt3/6ieuquYRckpsActDekLcsd6dU= cloud.google.com/go/vision/v2 v2.8.0/go.mod h1:ocqDiA2j97pvgogdyhoxiQp2ZkDCyr0HWpicywGGRhU= +cloud.google.com/go/vision/v2 v2.8.6/go.mod h1:G3v0uovxCye3u369JfrHGY43H6u/IQ08x9dw5aVH8yY= cloud.google.com/go/vmmigration v1.7.5/go.mod h1:pkvO6huVnVWzkFioxSghZxIGcsstDvYiVCxQ9ZH3eYI= +cloud.google.com/go/vmmigration v1.7.11/go.mod h1:PmD1fDB0TEHGQR1tDZt9GEXFB9mnKKalLcTVRJKzcQA= cloud.google.com/go/vmwareengine v1.1.1/go.mod h1:nMpdsIVkUrSaX8UvmnBhzVzG7PPvNYc5BszcvIVudYs= +cloud.google.com/go/vmwareengine v1.2.0/go.mod h1:rPjCHu6hG9N8d6PhkoDWFkqL9xpbFY+ueVW+0pNFbZg= cloud.google.com/go/vpcaccess v1.7.5/go.mod h1:slc5ZRvvjP78c2dnL7m4l4R9GwL3wDLcpIWz6P/ziig= +cloud.google.com/go/vpcaccess v1.7.11/go.mod h1:a2cuAiSCI4TVK0Dt6/dRjf22qQvfY+podxst2VvAkcI= cloud.google.com/go/webrisk v1.9.5/go.mod h1:aako0Fzep1Q714cPEM5E+mtYX8/jsfegAuS8aivxy3U= +cloud.google.com/go/webrisk v1.9.11/go.mod h1:mK6M8KEO0ZI7VkrjCq3Tjzw4vYq+3c4DzlMUDVaiswE= cloud.google.com/go/websecurityscanner v1.6.5/go.mod h1:QR+DWaxAz2pWooylsBF854/Ijvuoa3FCyS1zBa1rAVQ= +cloud.google.com/go/websecurityscanner v1.6.11/go.mod h1:vhAZjksELSg58EZfUQ1BMExD+hxqpn0G0DuyCZQjiTg= cloud.google.com/go/workflows v1.12.4/go.mod h1:yQ7HUqOkdJK4duVtMeBCAOPiN1ZF1E9pAMX51vpwB/w= +cloud.google.com/go/workflows v1.12.10/go.mod h1:RcKqCiOmKs8wFUEf3EwWZPH5eHc7Oq0kamIyOUCk0IE= +github.com/anmitsu/go-shlex v0.0.0-20200514113438-38f4b401e2be/go.mod h1:ySMOLuWl6zY27l47sB3qLNK6tF2fkHG55UZxx8oIVo4= github.com/antihax/optional v1.0.0/go.mod h1:uupD/76wgC+ih3iEmQUL+0Ugr19nfwCT1kdvxnR2qWY= +github.com/armon/go-socks5 v0.0.0-20160902184237-e75332964ef5/go.mod h1:wHh0iHkYZB8zMSxRWpUBQtwG5a7fFgvEO+odwuTv2gs= github.com/census-instrumentation/opencensus-proto v0.4.1/go.mod h1:4T9NM4+4Vw91VeyqjLS6ao50K5bOcLKN6Q42XnYaRYw= github.com/cespare/xxhash/v2 v2.1.1/go.mod h1:VGX0DQ3Q6kWi7AoAeZDth3/j3BFtOZR5XLFGgcrjCOs= github.com/cespare/xxhash/v2 v2.2.0/go.mod h1:VGX0DQ3Q6kWi7AoAeZDth3/j3BFtOZR5XLFGgcrjCOs= @@ -145,12 +264,16 @@ github.com/cncf/xds/go v0.0.0-20210805033703-aa0b78936158/go.mod h1:eXthEFrGJvWH github.com/cncf/xds/go v0.0.0-20210922020428-25de7278fc84/go.mod h1:eXthEFrGJvWHgFFCl3hGmgk+/aYT6PnTQLykKQRLhEs= github.com/cncf/xds/go v0.0.0-20211011173535-cb28da3451f1/go.mod h1:eXthEFrGJvWHgFFCl3hGmgk+/aYT6PnTQLykKQRLhEs= github.com/cncf/xds/go v0.0.0-20231128003011-0fa0005c9caa/go.mod h1:x/1Gn8zydmfq8dk6e9PdstVsDgu9RuyIIJqAaF//0IM= +github.com/cncf/xds/go v0.0.0-20240318125728-8a4994d93e50/go.mod h1:5e1+Vvlzido69INQaVO6d87Qn543Xr6nooe9Kz7oBFM= +github.com/elazarl/goproxy v0.0.0-20230808193330-2592e75ae04a/go.mod h1:Ro8st/ElPeALwNFlcTpWmkr6IoMFfkjXAvTHpevnDsM= github.com/envoyproxy/go-control-plane v0.9.9-0.20201210154907-fd9021fe5dad/go.mod h1:cXg6YxExXjJnVBQHBLXeUAgxn2UodCpnH306RInaBQk= github.com/envoyproxy/go-control-plane v0.9.9-0.20210217033140-668b12f5399d/go.mod h1:cXg6YxExXjJnVBQHBLXeUAgxn2UodCpnH306RInaBQk= github.com/envoyproxy/go-control-plane v0.9.10-0.20210907150352-cf90f659a021/go.mod h1:AFq3mo9L8Lqqiid3OhADV3RfLJnjiw63cSpi+fDTRC0= github.com/envoyproxy/go-control-plane v0.12.0/go.mod h1:ZBTaoJ23lqITozF0M6G4/IragXCQKCnYbmlmtHvwRG0= github.com/envoyproxy/protoc-gen-validate v1.0.4/go.mod h1:qys6tmnRsYrQqIhm2bvKZH4Blx/1gTIZ2UKVY1M+Yew= github.com/ghodss/yaml v1.0.0/go.mod h1:4dBDuWmgqj2HViK6kFavaiC9ZROes6MMH2rRYeMEF04= +github.com/gliderlabs/ssh v0.3.7/go.mod h1:zpHEXBstFnQYtGnB8k8kQLol82umzn/2/snG7alWVD8= +github.com/go-git/go-git-fixtures/v4 v4.3.2-0.20231010084843-55a94097c399/go.mod h1:1OCfN199q1Jm3HZlxleg+Dw/mwps2Wbk9frAWm+4FII= github.com/go-logr/logr v1.3.0/go.mod h1:9T104GzyrTigFIr8wt5mBrctHMim0Nb2HLGrmQ40KvY= github.com/golang/glog v1.2.0/go.mod h1:6AhwSGph0fcJtXVM/PEHPqZlFeoLxhs7/t5UDAwmO+w= github.com/golang/protobuf v1.3.3/go.mod h1:vzj43D7+SQXF/4pzW/hwtAqwc6iTitCiVSaWz5lYuqw= @@ -159,7 +282,9 @@ github.com/golang/protobuf v1.5.2/go.mod h1:XVQd3VNwM+JqD3oG2Ue2ip4fOMUkwXdXDdiu github.com/golang/snappy v0.0.3/go.mod h1:/XxbfmMg8lxefKM7IXC3fBNl/7bRcc72aCRzEWrmP2Q= github.com/golang/snappy v0.0.4/go.mod h1:/XxbfmMg8lxefKM7IXC3fBNl/7bRcc72aCRzEWrmP2Q= github.com/google/go-cmp v0.5.9/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY= +github.com/google/go-pkcs11 v0.2.1-0.20230907215043-c6f79328ddf9/go.mod h1:6eQoGcuNJpa7jnd5pMGdkSaQpNDYvPlXWMcjXXThLlY= github.com/google/martian/v3 v3.3.2/go.mod h1:oBOf6HBosgwRXnUGWUB05QECsc6uvmMiJ3+6W4l/CUk= +github.com/google/martian/v3 v3.3.3/go.mod h1:iEPrYcgCF7jA9OtScMFQyAlZZ4YXTKEtJ1E6RWzmBA0= github.com/google/s2a-go v0.1.0/go.mod h1:OJpEgntRZo8ugHpF9hkoLJbS5dSI20XZeXJ9JVywLlM= github.com/google/uuid v1.3.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= github.com/google/uuid v1.5.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= @@ -167,10 +292,16 @@ github.com/googleapis/enterprise-certificate-proxy v0.2.3/go.mod h1:AwSRAtLfXpU5 github.com/googleapis/gax-go/v2 v2.8.0/go.mod h1:4orTrqY6hXxxaUL4LHIPl6lGo8vAE38/qKbhSAKP6QI= github.com/googleapis/gax-go/v2 v2.12.0/go.mod h1:y+aIqrI5eb1YGMVJfuV3185Ts/D7qKpsEkdD5+I6QGU= github.com/grpc-ecosystem/grpc-gateway v1.16.0/go.mod h1:BDjrQk3hbvj6Nolgz8mAMFbcEtjT1g+wF4CSlocrBnw= +github.com/kr/pretty v0.3.1/go.mod h1:hoEshYVHaxMs3cyo3Yncou5ZscifuDolrwPKZanG3xk= +github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE= +github.com/mmcloughlin/avo v0.5.0/go.mod h1:ChHFdoV7ql95Wi7vuq2YT1bwCJqiWdZrQ1im3VujLYM= +github.com/onsi/gomega v1.27.10/go.mod h1:RsS8tutOdbdgzbPtzzATp12yT7kM5I5aElG3evPbQ0M= github.com/rogpeppe/fastuuid v1.2.0/go.mod h1:jVj6XXZzXRy/MSR5jhDC/2q6DgLz+nrA6LYCDYWNEvQ= +github.com/rogpeppe/go-internal v1.11.0/go.mod h1:ddIwULY96R17DhadqLgMfk9H9tvdUzkipdSkR5nkCZA= +github.com/sirupsen/logrus v1.9.0/go.mod h1:naHLuLoDiP4jHNo9R0sCBMtWGeIprob74mVsIT4qYEQ= github.com/stretchr/testify v1.5.1/go.mod h1:5W2xD1RspED5o8YsWQXVCued0rvSQ+mT+I5cxcmMvtA= github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg= -github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo= +github.com/stretchr/testify v1.9.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY= go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc v0.46.1/go.mod h1:4UoMYEZOC0yN/sPGH76KPkkU7zgiEWYWL9vwmbnTJPE= go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc v0.47.0/go.mod h1:r9vWsPS/3AQItv3OSlEJ/E4mbrhUbbw18meOjArPtKQ= go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.46.1/go.mod h1:sEGXWArGqc3tVa+ekntsN65DmVbVeW+7lTKTjZF3/Fo= @@ -181,6 +312,7 @@ go.opentelemetry.io/otel/metric v1.21.0/go.mod h1:o1p3CA8nNHW8j5yuQLdc1eeqEaPfzu go.opentelemetry.io/otel/metric v1.22.0/go.mod h1:evJGjVpZv0mQ5QBRJoBF64yMuOf4xCWdXjK8pzFvliY= go.opentelemetry.io/otel/sdk v1.21.0 h1:FTt8qirL1EysG6sTQRZ5TokkU8d0ugCj8htOgThZXQ8= go.opentelemetry.io/otel/sdk v1.21.0/go.mod h1:Nna6Yv7PWTdgJHVRD9hIYywQBRx7pbox6nwBnZIxl/E= +go.opentelemetry.io/otel/sdk v1.24.0/go.mod h1:KVrIYw6tEubO9E96HQpcmpTKDVn9gdv35HoYiQWGDFg= go.opentelemetry.io/otel/trace v1.21.0/go.mod h1:LGbsEB0f9LGjN+OZaQQ26sohbOmiMR+BaslueVtS/qQ= go.opentelemetry.io/otel/trace v1.22.0/go.mod h1:RbbHXVqKES9QhzZq/fE5UnOSILqRt40a21sPw2He1xo= go.opentelemetry.io/proto/otlp v0.7.0/go.mod h1:PqfVotwruBrMGOCsRd/89rSnXhoiJIqeYNgFYFoEGnI= @@ -269,4 +401,5 @@ google.golang.org/grpc v1.62.0/go.mod h1:IWTG0VlJLCh1SkC58F7np9ka9mx/WNkjl4PGJai google.golang.org/grpc/cmd/protoc-gen-go-grpc v1.1.0/go.mod h1:6Kw0yEErY5E/yWrBtf03jp27GLLJujG4z/JK95pnjjw= google.golang.org/protobuf v1.30.0/go.mod h1:HV8QOd/L58Z+nl8r43ehVNZIU/HEI6OcFqwMG9pJV4I= google.golang.org/protobuf v1.32.0/go.mod h1:c6P6GXX6sHbq/GpV6MGZEdwhWPcYBgnhAHhKbcUYpos= +gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q= gopkg.in/yaml.v2 v2.2.3/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI= diff --git a/healthcare/v1beta1/healthcare-api.json b/healthcare/v1beta1/healthcare-api.json index 0ffd84a7183..fc4d0c77626 100644 --- a/healthcare/v1beta1/healthcare-api.json +++ b/healthcare/v1beta1/healthcare-api.json @@ -4201,6 +4201,53 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "Encounter-everything": { + "description": "Retrieves an Encounter resource and resources related to that Encounter. Implements the FHIR extended operation Encounter-everything ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/encounter-operations.html#everything), [STU3](http://hl7.org/implement/standards/fhir/STU3/encounter-operations.html#everything), or [R4](https://hl7.org/implement/standards/fhir/R4/encounter-operation-everything.html). On success, the response body contains a JSON-encoded representation of a `Bundle` resource of type `searchset`, containing the results of the operation. Errors generated by the FHIR store contain a JSON-encoded `OperationOutcome` resource describing the reason for the error. If the request cannot be mapped to a valid API method on a FHIR store, a generic GCP error might be returned instead. The resources in scope for the response are: * The Encounter resource itself. * All the resources directly referenced by the Encounter resource, including attachments and binaries. * Resources directly referencing the Encounter resource that meet the inclusion criteria. The inclusion criteria are based on the membership rules in the Encounter Compartment definition ([DSTU2](http://hl7.org/fhir/DSTU2/compartment-encounter.html), [STU3](http://www.hl7.org/fhir/stu3/compartmentdefinition-encounter.html), [R4](http://hl7.org/fhir/R4/compartmentdefinition-encounter.html)), which details the eligible resource types and referencing search parameters. * Resources referencing to the Encounter resource through the \"http://hl7.org/fhir/StructureDefinition/encounter-associatedEncounter\" extension.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/fhirStores/{fhirStoresId}/fhir/Encounter/{EncounterId}/$everything", + "httpMethod": "GET", + "id": "healthcare.projects.locations.datasets.fhirStores.fhir.Encounter-everything", + "parameterOrder": [ + "name" + ], + "parameters": { + "_count": { + "description": "Optional. Maximum number of resources in a page. If not specified, 100 is used. May not be larger than 1000.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "_page_token": { + "description": "Optional. Used to retrieve the next or previous page of results when using pagination. Set `_page_token` to the value of _page_token set in next or previous page links' url. Next and previous page are returned in the response bundle's links field, where `link.relation` is \"previous\" or \"next\". Omit `_page_token` if no previous request has been made.", + "location": "query", + "type": "string" + }, + "_since": { + "description": "Optional. If provided, only resources updated after this time are returned. The time uses the format YYYY-MM-DDThh:mm:ss.sss+zz:zz. For example, `2015-02-07T13:28:17.239+02:00` or `2017-01-01T00:00:00Z`. The time must be specified to the second and include a time zone.", + "location": "query", + "type": "string" + }, + "_type": { + "description": "Optional. String of comma-delimited FHIR resource types. If provided, only resources of the specified resource type(s) are returned. Specifying multiple `_type` parameters isn't supported. For example, the result of `_type=Observation\u0026_type=Encounter` is undefined. Use `_type=Observation,Encounter` instead.", + "location": "query", + "type": "string" + }, + "name": { + "description": "Required. Name of the Encounter resource for which the information is required.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/fhirStores/[^/]+/fhir/Encounter/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+name}/$everything", + "response": { + "$ref": "HttpBody" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-healthcare", + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "Observation-lastn": { "description": "Retrieves the N most recent `Observation` resources for a subject matching search criteria specified as query parameters, grouped by `Observation.code`, sorted from most recent to oldest. Implements the FHIR extended operation Observation-lastn ([STU3](https://hl7.org/implement/standards/fhir/STU3/observation-operations.html#lastn), [R4](https://hl7.org/implement/standards/fhir/R4/observation-operations.html#lastn)). DSTU2 doesn't define the Observation-lastn method, but the server supports it the same way it supports STU3. Search terms are provided as query parameters following the same pattern as the search method. The following search parameters must be provided: - `subject` or `patient` to specify a subject for the Observation. - `code`, `category` or any of the composite parameters that include `code`. Any other valid Observation search parameters can also be provided. This operation accepts an additional query parameter `max`, which specifies N, the maximum number of Observations to return from each group, with a default of 1. Searches with over 1000 results are rejected. Results are counted before grouping and limiting the results with `max`. To stay within the limit, constrain these searches using Observation search parameters such as `_lastUpdated` or `date`. On success, the response body contains a JSON-encoded representation of a `Bundle` resource of type `searchset`, containing the results of the operation. Errors generated by the FHIR store contain a JSON-encoded `OperationOutcome` resource describing the reason for the error. If the request cannot be mapped to a valid API method on a FHIR store, a generic GCP error might be returned instead.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/fhirStores/{fhirStoresId}/fhir/Observation/$lastn", @@ -5701,7 +5748,7 @@ } } }, - "revision": "20240731", + "revision": "20240808", "rootUrl": "https://healthcare.googleapis.com/", "schemas": { "AccessDeterminationLogConfig": { diff --git a/healthcare/v1beta1/healthcare-gen.go b/healthcare/v1beta1/healthcare-gen.go index 682f69b2676..d37a4c8840e 100644 --- a/healthcare/v1beta1/healthcare-gen.go +++ b/healthcare/v1beta1/healthcare-gen.go @@ -22031,6 +22031,146 @@ func (c *ProjectsLocationsDatasetsFhirStoresFhirConsentEnforcementStatusCall) Do return c.doRequest("") } +type ProjectsLocationsDatasetsFhirStoresFhirEncounterEverythingCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// EncounterEverything: Retrieves an Encounter resource and resources related +// to that Encounter. Implements the FHIR extended operation +// Encounter-everything (DSTU2 +// (http://hl7.org/implement/standards/fhir/DSTU2/encounter-operations.html#everything), +// STU3 +// (http://hl7.org/implement/standards/fhir/STU3/encounter-operations.html#everything), +// or R4 +// (https://hl7.org/implement/standards/fhir/R4/encounter-operation-everything.html). +// On success, the response body contains a JSON-encoded representation of a +// `Bundle` resource of type `searchset`, containing the results of the +// operation. Errors generated by the FHIR store contain a JSON-encoded +// `OperationOutcome` resource describing the reason for the error. If the +// request cannot be mapped to a valid API method on a FHIR store, a generic +// GCP error might be returned instead. The resources in scope for the response +// are: * The Encounter resource itself. * All the resources directly +// referenced by the Encounter resource, including attachments and binaries. * +// Resources directly referencing the Encounter resource that meet the +// inclusion criteria. The inclusion criteria are based on the membership rules +// in the Encounter Compartment definition (DSTU2 +// (http://hl7.org/fhir/DSTU2/compartment-encounter.html), STU3 +// (http://www.hl7.org/fhir/stu3/compartmentdefinition-encounter.html), R4 +// (http://hl7.org/fhir/R4/compartmentdefinition-encounter.html)), which +// details the eligible resource types and referencing search parameters. * +// Resources referencing to the Encounter resource through the +// "http://hl7.org/fhir/StructureDefinition/encounter-associatedEncounter" +// extension. +// +// - name: Name of the Encounter resource for which the information is +// required. +func (r *ProjectsLocationsDatasetsFhirStoresFhirService) EncounterEverything(name string) *ProjectsLocationsDatasetsFhirStoresFhirEncounterEverythingCall { + c := &ProjectsLocationsDatasetsFhirStoresFhirEncounterEverythingCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Count sets the optional parameter "_count": Maximum number of resources in a +// page. If not specified, 100 is used. May not be larger than 1000. +func (c *ProjectsLocationsDatasetsFhirStoresFhirEncounterEverythingCall) Count(Count int64) *ProjectsLocationsDatasetsFhirStoresFhirEncounterEverythingCall { + c.urlParams_.Set("_count", fmt.Sprint(Count)) + return c +} + +// PageToken sets the optional parameter "_page_token": Used to retrieve the +// next or previous page of results when using pagination. Set `_page_token` to +// the value of _page_token set in next or previous page links' url. Next and +// previous page are returned in the response bundle's links field, where +// `link.relation` is "previous" or "next". Omit `_page_token` if no previous +// request has been made. +func (c *ProjectsLocationsDatasetsFhirStoresFhirEncounterEverythingCall) PageToken(PageToken string) *ProjectsLocationsDatasetsFhirStoresFhirEncounterEverythingCall { + c.urlParams_.Set("_page_token", PageToken) + return c +} + +// Since sets the optional parameter "_since": If provided, only resources +// updated after this time are returned. The time uses the format +// YYYY-MM-DDThh:mm:ss.sss+zz:zz. For example, `2015-02-07T13:28:17.239+02:00` +// or `2017-01-01T00:00:00Z`. The time must be specified to the second and +// include a time zone. +func (c *ProjectsLocationsDatasetsFhirStoresFhirEncounterEverythingCall) Since(Since string) *ProjectsLocationsDatasetsFhirStoresFhirEncounterEverythingCall { + c.urlParams_.Set("_since", Since) + return c +} + +// Type sets the optional parameter "_type": String of comma-delimited FHIR +// resource types. If provided, only resources of the specified resource +// type(s) are returned. Specifying multiple `_type` parameters isn't +// supported. For example, the result of `_type=Observation&_type=Encounter` is +// undefined. Use `_type=Observation,Encounter` instead. +func (c *ProjectsLocationsDatasetsFhirStoresFhirEncounterEverythingCall) Type(Type string) *ProjectsLocationsDatasetsFhirStoresFhirEncounterEverythingCall { + c.urlParams_.Set("_type", Type) + 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 *ProjectsLocationsDatasetsFhirStoresFhirEncounterEverythingCall) Fields(s ...googleapi.Field) *ProjectsLocationsDatasetsFhirStoresFhirEncounterEverythingCall { + 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 *ProjectsLocationsDatasetsFhirStoresFhirEncounterEverythingCall) IfNoneMatch(entityTag string) *ProjectsLocationsDatasetsFhirStoresFhirEncounterEverythingCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsDatasetsFhirStoresFhirEncounterEverythingCall) Context(ctx context.Context) *ProjectsLocationsDatasetsFhirStoresFhirEncounterEverythingCall { + 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 *ProjectsLocationsDatasetsFhirStoresFhirEncounterEverythingCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsDatasetsFhirStoresFhirEncounterEverythingCall) 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, "v1beta1/{+name}/$everything") + 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 "healthcare.projects.locations.datasets.fhirStores.fhir.Encounter-everything" call. +func (c *ProjectsLocationsDatasetsFhirStoresFhirEncounterEverythingCall) Do(opts ...googleapi.CallOption) (*http.Response, error) { + gensupport.SetOptions(c.urlParams_, opts...) + return c.doRequest("") +} + type ProjectsLocationsDatasetsFhirStoresFhirObservationLastnCall struct { s *Service parent string diff --git a/internal/kokoro/vet.sh b/internal/kokoro/vet.sh index 1305a84ad0d..58b17ee694b 100755 --- a/internal/kokoro/vet.sh +++ b/internal/kokoro/vet.sh @@ -41,7 +41,7 @@ golint ./... 2>&1 | ( grep -vE "\.pb\.go:" || true ) | tee /dev/stderr | (! read) -staticcheck -go 1.9 ./... 2>&1 | ( +staticcheck -go 1.23 ./... 2>&1 | ( grep -v "SA1019" | grep -v "S1007" | grep -v "error var Done should have name of the form ErrFoo" | diff --git a/internal/version.go b/internal/version.go index 48b023adec3..e4e4e6bf7ae 100644 --- a/internal/version.go +++ b/internal/version.go @@ -5,4 +5,4 @@ package internal // Version is the current tagged release of the library. -const Version = "0.192.0" +const Version = "0.193.0" diff --git a/manufacturers/v1/manufacturers-api.json b/manufacturers/v1/manufacturers-api.json index 0432a4c3160..e163193cebd 100644 --- a/manufacturers/v1/manufacturers-api.json +++ b/manufacturers/v1/manufacturers-api.json @@ -416,7 +416,7 @@ } } }, - "revision": "20240716", + "revision": "20240809", "rootUrl": "https://manufacturers.googleapis.com/", "schemas": { "Attributes": { @@ -513,6 +513,13 @@ }, "type": "array" }, + "intendedCountry": { + "description": "Optional. List of countries to show this product in. Countries provided in this attribute will override any of the countries configured at feed level. The values should be: the [CLDR territory code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) of the countries in which this item will be shown.", + "items": { + "type": "string" + }, + "type": "array" + }, "itemGroupId": { "description": "The item group id of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#itemgroupid.", "type": "string" @@ -697,10 +704,34 @@ "description": "The destination status.", "id": "DestinationStatus", "properties": { + "approvedCountries": { + "description": "Output only. List of country codes (ISO 3166-1 alpha-2) where the offer is approved.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, "destination": { "description": "The name of the destination.", "type": "string" }, + "disapprovedCountries": { + "description": "Output only. List of country codes (ISO 3166-1 alpha-2) where the offer is disapproved.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "pendingCountries": { + "description": "Output only. List of country codes (ISO 3166-1 alpha-2) where the offer is pending approval.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, "status": { "description": "The status of the destination.", "enum": [ @@ -1224,6 +1255,10 @@ }, "type": "array" }, + "feedLabel": { + "description": "Optional. The feed label for the product.", + "type": "string" + }, "issues": { "description": "A server-generated list of issues associated with the product.", "items": { diff --git a/manufacturers/v1/manufacturers-gen.go b/manufacturers/v1/manufacturers-gen.go index 5ecf37c398b..eb63c667ae5 100644 --- a/manufacturers/v1/manufacturers-gen.go +++ b/manufacturers/v1/manufacturers-gen.go @@ -259,6 +259,12 @@ type Attributes struct { // "ClientShoppingCatalog" or "PartnerShoppingCatalog". For more information, // see https://support.google.com/manufacturers/answer/7443550 IncludedDestination []string `json:"includedDestination,omitempty"` + // IntendedCountry: Optional. List of countries to show this product in. + // Countries provided in this attribute will override any of the countries + // configured at feed level. The values should be: the CLDR territory code + // (http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) of the + // countries in which this item will be shown. + IntendedCountry []string `json:"intendedCountry,omitempty"` // ItemGroupId: The item group id of the product. For more information, see // https://support.google.com/manufacturers/answer/6124116#itemgroupid. ItemGroupId string `json:"itemGroupId,omitempty"` @@ -436,8 +442,17 @@ func (s Count) MarshalJSON() ([]byte, error) { // DestinationStatus: The destination status. type DestinationStatus struct { + // ApprovedCountries: Output only. List of country codes (ISO 3166-1 alpha-2) + // where the offer is approved. + ApprovedCountries []string `json:"approvedCountries,omitempty"` // Destination: The name of the destination. Destination string `json:"destination,omitempty"` + // DisapprovedCountries: Output only. List of country codes (ISO 3166-1 + // alpha-2) where the offer is disapproved. + DisapprovedCountries []string `json:"disapprovedCountries,omitempty"` + // PendingCountries: Output only. List of country codes (ISO 3166-1 alpha-2) + // where the offer is pending approval. + PendingCountries []string `json:"pendingCountries,omitempty"` // Status: The status of the destination. // // Possible values: @@ -446,15 +461,15 @@ type DestinationStatus struct { // "PENDING" - The decision is still pending. // "DISAPPROVED" - The product is disapproved. Please look at the issues. Status string `json:"status,omitempty"` - // ForceSendFields is a list of field names (e.g. "Destination") to + // ForceSendFields is a list of field names (e.g. "ApprovedCountries") 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. "Destination") 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. "ApprovedCountries") 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:"-"` } @@ -970,6 +985,8 @@ type Product struct { ContentLanguage string `json:"contentLanguage,omitempty"` // DestinationStatuses: The status of the destinations. DestinationStatuses []*DestinationStatus `json:"destinationStatuses,omitempty"` + // FeedLabel: Optional. The feed label for the product. + FeedLabel string `json:"feedLabel,omitempty"` // Issues: A server-generated list of issues associated with the product. Issues []*Issue `json:"issues,omitempty"` // Name: Name in the format `{target_country}:{content_language}:{product_id}`. diff --git a/migrationcenter/v1alpha1/migrationcenter-api.json b/migrationcenter/v1alpha1/migrationcenter-api.json index 3ee67cfeb2b..0877b3ca2d1 100644 --- a/migrationcenter/v1alpha1/migrationcenter-api.json +++ b/migrationcenter/v1alpha1/migrationcenter-api.json @@ -2473,7 +2473,7 @@ } } }, - "revision": "20240711", + "revision": "20240808", "rootUrl": "https://migrationcenter.googleapis.com/", "schemas": { "AddAssetsToGroupRequest": { @@ -3791,6 +3791,16 @@ "description": "Optional. Total memory in bytes limited by db deployment.", "format": "int64", "type": "string" + }, + "physicalCoreCount": { + "description": "Optional. Number of total physical cores.", + "format": "int32", + "type": "integer" + }, + "physicalCoreLimit": { + "description": "Optional. Number of total physical cores limited by db deployment.", + "format": "int32", + "type": "integer" } }, "type": "object" @@ -3845,6 +3855,10 @@ "description": "The instance's name.", "type": "string" }, + "network": { + "$ref": "DatabaseInstanceNetwork", + "description": "Optional. Networking details." + }, "role": { "description": "The instance role in the database engine.", "enum": [ @@ -3864,6 +3878,31 @@ }, "type": "object" }, + "DatabaseInstanceNetwork": { + "description": "Network details of a database instance.", + "id": "DatabaseInstanceNetwork", + "properties": { + "hostNames": { + "description": "Optional. The instance's host names.", + "items": { + "type": "string" + }, + "type": "array" + }, + "ipAddresses": { + "description": "Optional. The instance's IP addresses.", + "items": { + "type": "string" + }, + "type": "array" + }, + "primaryMacAddress": { + "description": "Optional. The instance's primary MAC address.", + "type": "string" + } + }, + "type": "object" + }, "DatabaseObjects": { "description": "Details of a group of database objects.", "id": "DatabaseObjects", @@ -7004,6 +7043,11 @@ "description": "Output only. Database licensing monthly cost for this preference set. Only present for databases.", "readOnly": true }, + "monthlyCostGcveProtected": { + "$ref": "Money", + "description": "Output only. GCVE Protected nodes cost for this preference set.", + "readOnly": true + }, "monthlyCostNetworkEgress": { "$ref": "Money", "description": "Output only. Network Egress monthly cost for this preference set. Only present for virtual machines.", @@ -7019,6 +7063,11 @@ "description": "Output only. Miscellaneous monthly cost for this preference set.", "readOnly": true }, + "monthlyCostPortableVmwareLicense": { + "$ref": "Money", + "description": "Output only. VMware portable license monthly cost for this preference set. Only present for VMware target with portable license service type. This cost is not paid to google, but is an estimate of license costs paid to VMware.", + "readOnly": true + }, "monthlyCostStorage": { "$ref": "Money", "description": "Output only. Storage monthly cost for this preference set.", @@ -7736,7 +7785,13 @@ "SqlServerSchemaDetails": { "description": "Specific details for a SqlServer database.", "id": "SqlServerSchemaDetails", - "properties": {}, + "properties": { + "clrObjectCount": { + "description": "Optional. SqlServer number of CLR objects.", + "format": "int32", + "type": "integer" + } + }, "type": "object" }, "SqlServerServerFlag": { @@ -7873,6 +7928,48 @@ }, "type": "object" }, + "VMwareEngineMachinePreferences": { + "description": "The type of machines to consider when calculating virtual machine migration insights and recommendations for VMware Engine. Not all machine types are available in all zones and regions.", + "id": "VMwareEngineMachinePreferences", + "properties": { + "allowedMachineSeries": { + "description": "Optional. VMware Engine on Google Cloud machine series to consider for insights and recommendations. If empty, no restriction is applied on the machine series.", + "items": { + "$ref": "MachineSeries" + }, + "type": "array" + }, + "protectedNodes": { + "description": "Optional. Whether to use VMware Engine Protected offering.", + "enum": [ + "PROTECTED_NODES_UNSPECIFIED", + "PROTECTED_NODES_ENABLED", + "PROTECTED_NODES_DISABLED" + ], + "enumDescriptions": [ + "Unspecified protected nodes preference.", + "Use only protected nodes for the selected allowed_machine_series.", + "Do not use protected nodes." + ], + "type": "string" + }, + "storageOnlyNodes": { + "description": "Optional. Whether to use storage-only nodes, if those are available.", + "enum": [ + "STORAGE_ONLY_NODES_UNSPECIFIED", + "STORAGE_ONLY_NODES_ENABLED", + "STORAGE_ONLY_NODES_DISABLED" + ], + "enumDescriptions": [ + "Unspecified storage-only nodes preference.", + "Use storage-only nodes for selected allowed_machine_series, if available.", + "Do not use storage-only nodes." + ], + "type": "string" + } + }, + "type": "object" + }, "ValidateImportJobRequest": { "description": "A request to validate an import job.", "id": "ValidateImportJobRequest", @@ -8323,11 +8420,34 @@ "format": "double", "type": "number" }, + "licenseDiscountPercentage": { + "description": "Optional. Discount percentage for the license type offered to you by Broadcom. Must be between 0 and 100. Only valid when service_type is set to SERVICE_TYPE_PORTABLE_LICENSE.", + "format": "float", + "type": "number" + }, + "machinePreferences": { + "$ref": "VMwareEngineMachinePreferences", + "description": "Optional. Preferences concerning the machine types to consider on Google Cloud VMware Engine." + }, "memoryOvercommitRatio": { "description": "Memory overcommit ratio. Acceptable values are 1.0, 1.25, 1.5, 1.75 and 2.0.", "format": "double", "type": "number" }, + "serviceType": { + "description": "Optional. VMWare Service Type (Fully Licensed or Portable License).", + "enum": [ + "SERVICE_TYPE_UNSPECIFIED", + "SERVICE_TYPE_FULLY_LICENSED", + "SERVICE_TYPE_PORTABLE_LICENSE" + ], + "enumDescriptions": [ + "Same as SERVICE_TYPE_FULLY_LICENSED.", + "Google provided VCF license.", + "Bring Your Own License." + ], + "type": "string" + }, "storageDeduplicationCompressionRatio": { "description": "The Deduplication and Compression ratio is based on the logical (Used Before) space required to store data before applying deduplication and compression, in relation to the physical (Used After) space required after applying deduplication and compression. Specifically, the ratio is the Used Before space divided by the Used After space. For example, if the Used Before space is 3 GB, but the physical Used After space is 1 GB, the deduplication and compression ratio is 3x. Acceptable values are between 1.0 and 4.0.", "format": "double", diff --git a/migrationcenter/v1alpha1/migrationcenter-gen.go b/migrationcenter/v1alpha1/migrationcenter-gen.go index 65359264941..47bcd324863 100644 --- a/migrationcenter/v1alpha1/migrationcenter-gen.go +++ b/migrationcenter/v1alpha1/migrationcenter-gen.go @@ -1832,6 +1832,11 @@ type DatabaseDeploymentTopology struct { MemoryBytes int64 `json:"memoryBytes,omitempty,string"` // MemoryLimitBytes: Optional. Total memory in bytes limited by db deployment. MemoryLimitBytes int64 `json:"memoryLimitBytes,omitempty,string"` + // PhysicalCoreCount: Optional. Number of total physical cores. + PhysicalCoreCount int64 `json:"physicalCoreCount,omitempty"` + // PhysicalCoreLimit: Optional. Number of total physical cores limited by db + // deployment. + PhysicalCoreLimit int64 `json:"physicalCoreLimit,omitempty"` // ForceSendFields is a list of field names (e.g. "CoreCount") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -1909,6 +1914,8 @@ func (s DatabaseDetailsParentDatabaseDeployment) MarshalJSON() ([]byte, error) { type DatabaseInstance struct { // InstanceName: The instance's name. InstanceName string `json:"instanceName,omitempty"` + // Network: Optional. Networking details. + Network *DatabaseInstanceNetwork `json:"network,omitempty"` // Role: The instance role in the database engine. // // Possible values: @@ -1935,6 +1942,32 @@ func (s DatabaseInstance) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// DatabaseInstanceNetwork: Network details of a database instance. +type DatabaseInstanceNetwork struct { + // HostNames: Optional. The instance's host names. + HostNames []string `json:"hostNames,omitempty"` + // IpAddresses: Optional. The instance's IP addresses. + IpAddresses []string `json:"ipAddresses,omitempty"` + // PrimaryMacAddress: Optional. The instance's primary MAC address. + PrimaryMacAddress string `json:"primaryMacAddress,omitempty"` + // ForceSendFields is a list of field names (e.g. "HostNames") 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. "HostNames") 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 DatabaseInstanceNetwork) MarshalJSON() ([]byte, error) { + type NoMethod DatabaseInstanceNetwork + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // DatabaseObjects: Details of a group of database objects. type DatabaseObjects struct { // Category: The category of the objects. @@ -5542,6 +5575,9 @@ type ReportSummaryGroupPreferenceSetFinding struct { // MonthlyCostDatabaseLicensing: Output only. Database licensing monthly cost // for this preference set. Only present for databases. MonthlyCostDatabaseLicensing *Money `json:"monthlyCostDatabaseLicensing,omitempty"` + // MonthlyCostGcveProtected: Output only. GCVE Protected nodes cost for this + // preference set. + MonthlyCostGcveProtected *Money `json:"monthlyCostGcveProtected,omitempty"` // MonthlyCostNetworkEgress: Output only. Network Egress monthly cost for this // preference set. Only present for virtual machines. MonthlyCostNetworkEgress *Money `json:"monthlyCostNetworkEgress,omitempty"` @@ -5551,6 +5587,11 @@ type ReportSummaryGroupPreferenceSetFinding struct { // MonthlyCostOther: Output only. Miscellaneous monthly cost for this // preference set. MonthlyCostOther *Money `json:"monthlyCostOther,omitempty"` + // MonthlyCostPortableVmwareLicense: Output only. VMware portable license + // monthly cost for this preference set. Only present for VMware target with + // portable license service type. This cost is not paid to google, but is an + // estimate of license costs paid to VMware. + MonthlyCostPortableVmwareLicense *Money `json:"monthlyCostPortableVmwareLicense,omitempty"` // MonthlyCostStorage: Output only. Storage monthly cost for this preference // set. MonthlyCostStorage *Money `json:"monthlyCostStorage,omitempty"` @@ -6451,6 +6492,24 @@ func (s SqlServerFeature) MarshalJSON() ([]byte, error) { // SqlServerSchemaDetails: Specific details for a SqlServer database. type SqlServerSchemaDetails struct { + // ClrObjectCount: Optional. SqlServer number of CLR objects. + ClrObjectCount int64 `json:"clrObjectCount,omitempty"` + // ForceSendFields is a list of field names (e.g. "ClrObjectCount") 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. "ClrObjectCount") 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 SqlServerSchemaDetails) MarshalJSON() ([]byte, error) { + type NoMethod SqlServerSchemaDetails + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } // SqlServerServerFlag: SQL Server server flag details. @@ -6638,6 +6697,50 @@ func (s UploadFileInfo) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// VMwareEngineMachinePreferences: The type of machines to consider when +// calculating virtual machine migration insights and recommendations for +// VMware Engine. Not all machine types are available in all zones and regions. +type VMwareEngineMachinePreferences struct { + // AllowedMachineSeries: Optional. VMware Engine on Google Cloud machine series + // to consider for insights and recommendations. If empty, no restriction is + // applied on the machine series. + AllowedMachineSeries []*MachineSeries `json:"allowedMachineSeries,omitempty"` + // ProtectedNodes: Optional. Whether to use VMware Engine Protected offering. + // + // Possible values: + // "PROTECTED_NODES_UNSPECIFIED" - Unspecified protected nodes preference. + // "PROTECTED_NODES_ENABLED" - Use only protected nodes for the selected + // allowed_machine_series. + // "PROTECTED_NODES_DISABLED" - Do not use protected nodes. + ProtectedNodes string `json:"protectedNodes,omitempty"` + // StorageOnlyNodes: Optional. Whether to use storage-only nodes, if those are + // available. + // + // Possible values: + // "STORAGE_ONLY_NODES_UNSPECIFIED" - Unspecified storage-only nodes + // preference. + // "STORAGE_ONLY_NODES_ENABLED" - Use storage-only nodes for selected + // allowed_machine_series, if available. + // "STORAGE_ONLY_NODES_DISABLED" - Do not use storage-only nodes. + StorageOnlyNodes string `json:"storageOnlyNodes,omitempty"` + // ForceSendFields is a list of field names (e.g. "AllowedMachineSeries") 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. "AllowedMachineSeries") 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 VMwareEngineMachinePreferences) MarshalJSON() ([]byte, error) { + type NoMethod VMwareEngineMachinePreferences + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ValidateImportJobRequest: A request to validate an import job. type ValidateImportJobRequest struct { // RequestId: Optional. An optional request ID to identify requests. Specify a @@ -7108,9 +7211,24 @@ type VmwareEnginePreferences struct { // CpuOvercommitRatio: CPU overcommit ratio. Acceptable values are between 1.0 // and 8.0, with 0.1 increment. CpuOvercommitRatio float64 `json:"cpuOvercommitRatio,omitempty"` + // LicenseDiscountPercentage: Optional. Discount percentage for the license + // type offered to you by Broadcom. Must be between 0 and 100. Only valid when + // service_type is set to SERVICE_TYPE_PORTABLE_LICENSE. + LicenseDiscountPercentage float64 `json:"licenseDiscountPercentage,omitempty"` + // MachinePreferences: Optional. Preferences concerning the machine types to + // consider on Google Cloud VMware Engine. + MachinePreferences *VMwareEngineMachinePreferences `json:"machinePreferences,omitempty"` // MemoryOvercommitRatio: Memory overcommit ratio. Acceptable values are 1.0, // 1.25, 1.5, 1.75 and 2.0. MemoryOvercommitRatio float64 `json:"memoryOvercommitRatio,omitempty"` + // ServiceType: Optional. VMWare Service Type (Fully Licensed or Portable + // License). + // + // Possible values: + // "SERVICE_TYPE_UNSPECIFIED" - Same as SERVICE_TYPE_FULLY_LICENSED. + // "SERVICE_TYPE_FULLY_LICENSED" - Google provided VCF license. + // "SERVICE_TYPE_PORTABLE_LICENSE" - Bring Your Own License. + ServiceType string `json:"serviceType,omitempty"` // StorageDeduplicationCompressionRatio: The Deduplication and Compression // ratio is based on the logical (Used Before) space required to store data // before applying deduplication and compression, in relation to the physical @@ -7142,6 +7260,7 @@ func (s *VmwareEnginePreferences) UnmarshalJSON(data []byte) error { type NoMethod VmwareEnginePreferences var s1 struct { CpuOvercommitRatio gensupport.JSONFloat64 `json:"cpuOvercommitRatio"` + LicenseDiscountPercentage gensupport.JSONFloat64 `json:"licenseDiscountPercentage"` MemoryOvercommitRatio gensupport.JSONFloat64 `json:"memoryOvercommitRatio"` StorageDeduplicationCompressionRatio gensupport.JSONFloat64 `json:"storageDeduplicationCompressionRatio"` *NoMethod @@ -7151,6 +7270,7 @@ func (s *VmwareEnginePreferences) UnmarshalJSON(data []byte) error { return err } s.CpuOvercommitRatio = float64(s1.CpuOvercommitRatio) + s.LicenseDiscountPercentage = float64(s1.LicenseDiscountPercentage) s.MemoryOvercommitRatio = float64(s1.MemoryOvercommitRatio) s.StorageDeduplicationCompressionRatio = float64(s1.StorageDeduplicationCompressionRatio) return nil diff --git a/networkconnectivity/v1/networkconnectivity-api.json b/networkconnectivity/v1/networkconnectivity-api.json index c7f8c380522..79c3ba49dcc 100644 --- a/networkconnectivity/v1/networkconnectivity-api.json +++ b/networkconnectivity/v1/networkconnectivity-api.json @@ -2812,7 +2812,7 @@ } } }, - "revision": "20240717", + "revision": "20240807", "rootUrl": "https://networkconnectivity.googleapis.com/", "schemas": { "AcceptHubSpokeRequest": { @@ -2963,13 +2963,15 @@ "STATE_UNSPECIFIED", "VALID", "CONNECTION_POLICY_MISSING", - "POLICY_LIMIT_REACHED" + "POLICY_LIMIT_REACHED", + "CONSUMER_INSTANCE_PROJECT_NOT_ALLOWLISTED" ], "enumDescriptions": [ "Default state, when Connection Map is created initially.", "Set when policy and map configuration is valid, and their matching can lead to allowing creation of PSC Connections subject to other constraints like connections limit.", "No Service Connection Policy found for this network and Service Class", - "Service Connection Policy limit reached for this network and Service Class" + "Service Connection Policy limit reached for this network and Service Class", + "The consumer instance project is not in AllowedGoogleProducersResourceHierarchyLevels of the matching ServiceConnectionPolicy." ], "readOnly": true, "type": "string" @@ -3620,6 +3622,14 @@ }, "type": "array" }, + "producerVpcSpokes": { + "description": "Output only. The list of Producer VPC spokes that this VPC spoke is a service consumer VPC spoke for. These producer VPCs are connected through VPC peering to this spoke's backing VPC network.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, "uri": { "description": "Required. The URI of the VPC network resource.", "type": "string" diff --git a/networkconnectivity/v1/networkconnectivity-gen.go b/networkconnectivity/v1/networkconnectivity-gen.go index 25e9e741598..444fb9ff1c8 100644 --- a/networkconnectivity/v1/networkconnectivity-gen.go +++ b/networkconnectivity/v1/networkconnectivity-gen.go @@ -643,6 +643,9 @@ type ConsumerPscConfig struct { // network and Service Class // "POLICY_LIMIT_REACHED" - Service Connection Policy limit reached for this // network and Service Class + // "CONSUMER_INSTANCE_PROJECT_NOT_ALLOWLISTED" - The consumer instance + // project is not in AllowedGoogleProducersResourceHierarchyLevels of the + // matching ServiceConnectionPolicy. State string `json:"state,omitempty"` // ForceSendFields is a list of field names (e.g. "ConsumerInstanceProject") to // unconditionally include in API requests. By default, fields with empty or @@ -1377,6 +1380,10 @@ type LinkedVpcNetwork struct { // IncludeExportRanges: Optional. IP ranges allowed to be included from // peering. IncludeExportRanges []string `json:"includeExportRanges,omitempty"` + // ProducerVpcSpokes: Output only. The list of Producer VPC spokes that this + // VPC spoke is a service consumer VPC spoke for. These producer VPCs are + // connected through VPC peering to this spoke's backing VPC network. + ProducerVpcSpokes []string `json:"producerVpcSpokes,omitempty"` // Uri: Required. The URI of the VPC network resource. Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "ExcludeExportRanges") to diff --git a/networkconnectivity/v1alpha1/networkconnectivity-api.json b/networkconnectivity/v1alpha1/networkconnectivity-api.json index c7114e4c842..3f963fa79d2 100644 --- a/networkconnectivity/v1alpha1/networkconnectivity-api.json +++ b/networkconnectivity/v1alpha1/networkconnectivity-api.json @@ -1116,7 +1116,7 @@ } } }, - "revision": "20240423", + "revision": "20240807", "rootUrl": "https://networkconnectivity.googleapis.com/", "schemas": { "AuditConfig": { @@ -1393,6 +1393,10 @@ "description": "User-defined labels.", "type": "object" }, + "migration": { + "$ref": "Migration", + "description": "Optional. Should be present if usage is set to FOR_MIGRATION." + }, "name": { "description": "Immutable. The name of an internal range. Format: projects/{project}/locations/{location}/internalRanges/{internal_range} See: https://google.aip.dev/122#fields-representing-resource-names", "type": "string" @@ -1456,12 +1460,14 @@ "enum": [ "USAGE_UNSPECIFIED", "FOR_VPC", - "EXTERNAL_TO_VPC" + "EXTERNAL_TO_VPC", + "FOR_MIGRATION" ], "enumDescriptions": [ "Unspecified usage is allowed in calls which identify the resource by other fields and do not need Usage set to complete. These are, i.e.: GetInternalRange and DeleteInternalRange. Usage needs to be specified explicitly in CreateInternalRange or UpdateInternalRange calls.", "A VPC resource can use the reserved CIDR block by associating it with the internal range resource if usage is set to FOR_VPC.", - "Ranges created with EXTERNAL_TO_VPC cannot be associated with VPC resources and are meant to block out address ranges for various use cases such as usage on-premises, with dynamic route announcements via Interconnect." + "Ranges created with EXTERNAL_TO_VPC cannot be associated with VPC resources and are meant to block out address ranges for various use cases such as usage on-premises, with dynamic route announcements via Interconnect.", + "Ranges created FOR_MIGRATION can be used to lock a CIDR range between a source and target subnet. If usage is set to FOR_MIGRATION the peering value has to be set to FOR_SELF or default to FOR_SELF when unset." ], "type": "string" }, @@ -1603,6 +1609,21 @@ }, "type": "object" }, + "Migration": { + "description": "Specification for migration with source and target resource names.", + "id": "Migration", + "properties": { + "source": { + "description": "Immutable. Resource path as an URI of the source resource, for example a subnet. The project for the source resource should match the project for the InternalRange. An example: /projects/{project}/regions/{region}/subnetworks/{subnet}", + "type": "string" + }, + "target": { + "description": "Immutable. Resource path of the target resource. The target project can be different, as in the cases when migrating to peer networks. The resource For example: /projects/{project}/regions/{region}/subnetworks/{subnet}", + "type": "string" + } + }, + "type": "object" + }, "OperationMetadata": { "description": "Represents the metadata of the long-running operation.", "id": "OperationMetadata", diff --git a/networkconnectivity/v1alpha1/networkconnectivity-gen.go b/networkconnectivity/v1alpha1/networkconnectivity-gen.go index 7e836bee98f..b6aef193027 100644 --- a/networkconnectivity/v1alpha1/networkconnectivity-gen.go +++ b/networkconnectivity/v1alpha1/networkconnectivity-gen.go @@ -648,6 +648,8 @@ type InternalRange struct { IpCidrRange string `json:"ipCidrRange,omitempty"` // Labels: User-defined labels. Labels map[string]string `json:"labels,omitempty"` + // Migration: Optional. Should be present if usage is set to FOR_MIGRATION. + Migration *Migration `json:"migration,omitempty"` // Name: Immutable. The name of an internal range. Format: // projects/{project}/locations/{location}/internalRanges/{internal_range} See: // https://google.aip.dev/122#fields-representing-resource-names @@ -718,6 +720,10 @@ type InternalRange struct { // associated with VPC resources and are meant to block out address ranges for // various use cases such as usage on-premises, with dynamic route // announcements via Interconnect. + // "FOR_MIGRATION" - Ranges created FOR_MIGRATION can be used to lock a CIDR + // range between a source and target subnet. If usage is set to FOR_MIGRATION + // the peering value has to be set to FOR_SELF or default to FOR_SELF when + // unset. Usage string `json:"usage,omitempty"` // Users: Output only. The list of resources that refer to this internal range. // Resources that use the internal range for their range allocation are @@ -906,6 +912,37 @@ func (s Location) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// Migration: Specification for migration with source and target resource +// names. +type Migration struct { + // Source: Immutable. Resource path as an URI of the source resource, for + // example a subnet. The project for the source resource should match the + // project for the InternalRange. An example: + // /projects/{project}/regions/{region}/subnetworks/{subnet} + Source string `json:"source,omitempty"` + // Target: Immutable. Resource path of the target resource. The target project + // can be different, as in the cases when migrating to peer networks. The + // resource For example: + // /projects/{project}/regions/{region}/subnetworks/{subnet} + Target string `json:"target,omitempty"` + // ForceSendFields is a list of field names (e.g. "Source") 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. "Source") 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 Migration) MarshalJSON() ([]byte, error) { + type NoMethod Migration + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // OperationMetadata: Represents the metadata of the long-running operation. type OperationMetadata struct { // ApiVersion: Output only. API version used to start the operation. diff --git a/networkmanagement/v1/networkmanagement-api.json b/networkmanagement/v1/networkmanagement-api.json index a8991c0c9ab..13b589f5337 100644 --- a/networkmanagement/v1/networkmanagement-api.json +++ b/networkmanagement/v1/networkmanagement-api.json @@ -591,7 +591,7 @@ } } }, - "revision": "20240725", + "revision": "20240807", "rootUrl": "https://networkmanagement.googleapis.com/", "schemas": { "AbortInfo": { @@ -1142,7 +1142,9 @@ "CLOUD_NAT_NO_ADDRESSES", "ROUTING_LOOP", "DROPPED_INSIDE_GOOGLE_MANAGED_SERVICE", - "LOAD_BALANCER_BACKEND_INVALID_NETWORK" + "LOAD_BALANCER_BACKEND_INVALID_NETWORK", + "BACKEND_SERVICE_NAMED_PORT_NOT_DEFINED", + "DESTINATION_IS_PRIVATE_NAT_IP_RANGE" ], "enumDescriptions": [ "Cause is unspecified.", @@ -1210,7 +1212,9 @@ "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 a load balancer backend instance not having a network interface in the network expected by the load balancer." + "Packet is dropped due to a load balancer backend instance not having a network interface in the network expected by the load balancer.", + "Packet is dropped due to a backend service named port not being defined on the instance group level.", + "Packet is dropped due to a destination IP range being part of a Private NAT IP range." ], "type": "string" }, diff --git a/networkmanagement/v1/networkmanagement-gen.go b/networkmanagement/v1/networkmanagement-gen.go index d32cac15b75..6723f1ee49c 100644 --- a/networkmanagement/v1/networkmanagement-gen.go +++ b/networkmanagement/v1/networkmanagement-gen.go @@ -1002,6 +1002,10 @@ type DropInfo struct { // "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. + // "BACKEND_SERVICE_NAMED_PORT_NOT_DEFINED" - Packet is dropped due to a + // backend service named port not being defined on the instance group level. + // "DESTINATION_IS_PRIVATE_NAT_IP_RANGE" - Packet is dropped due to a + // destination IP range being part of a Private NAT IP range. Cause string `json:"cause,omitempty"` // DestinationIp: Destination IP address of the dropped packet (if relevant). DestinationIp string `json:"destinationIp,omitempty"` diff --git a/networkmanagement/v1beta1/networkmanagement-api.json b/networkmanagement/v1beta1/networkmanagement-api.json index 7e80b4ba3c2..3771e0054b6 100644 --- a/networkmanagement/v1beta1/networkmanagement-api.json +++ b/networkmanagement/v1beta1/networkmanagement-api.json @@ -585,13 +585,180 @@ } } } + }, + "vpcFlowLogsConfigs": { + "methods": { + "create": { + "description": "Creates a new `VpcFlowLogsConfig`. If a configuration with the exact same settings already exists (even if the ID is different), the creation fails. Notes: 1. Creating a configuration with state=DISABLED will fail. 2. The following fields are not considrered as `settings` for the purpose of the check mentioned above, therefore - creating another configuration with the same fields but different values for the following fields will fail as well: - name - create_time - update_time - labels - description", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/vpcFlowLogsConfigs", + "httpMethod": "POST", + "id": "networkmanagement.projects.locations.vpcFlowLogsConfigs.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent resource of the VPC Flow Logs configuration to create: `projects/{project_id}/locations/global`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "vpcFlowLogsConfigId": { + "description": "Required. ID of the `VpcFlowLogsConfig`.", + "location": "query", + "type": "string" + } + }, + "path": "v1beta1/{+parent}/vpcFlowLogsConfigs", + "request": { + "$ref": "VpcFlowLogsConfig" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes a specific `VpcFlowLogsConfig`.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/vpcFlowLogsConfigs/{vpcFlowLogsConfigsId}", + "httpMethod": "DELETE", + "id": "networkmanagement.projects.locations.vpcFlowLogsConfigs.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. `VpcFlowLogsConfig` resource name using the form: `projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/vpcFlowLogsConfigs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets the details of a specific `VpcFlowLogsConfig`.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/vpcFlowLogsConfigs/{vpcFlowLogsConfigsId}", + "httpMethod": "GET", + "id": "networkmanagement.projects.locations.vpcFlowLogsConfigs.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. `VpcFlowLogsConfig` resource name using the form: `projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/vpcFlowLogsConfigs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+name}", + "response": { + "$ref": "VpcFlowLogsConfig" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists all `VpcFlowLogsConfigs` in a given project.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/vpcFlowLogsConfigs", + "httpMethod": "GET", + "id": "networkmanagement.projects.locations.vpcFlowLogsConfigs.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "Optional. Lists the `VpcFlowLogsConfigs` that match the filter expression. A filter expression must use the supported [CEL logic operators] (https://cloud.google.com/vpc/docs/about-flow-logs-records#supported_cel_logic_operators).", + "location": "query", + "type": "string" + }, + "orderBy": { + "description": "Optional. Field to use to sort the list.", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Optional. Number of `VpcFlowLogsConfigs` to return.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. Page token from an earlier query, as returned in `next_page_token`.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent resource of the VpcFlowLogsConfig: `projects/{project_id}/locations/global`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+parent}/vpcFlowLogsConfigs", + "response": { + "$ref": "ListVpcFlowLogsConfigsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Updates an existing `VpcFlowLogsConfig`. If a configuration with the exact same settings already exists (even if the ID is different), the creation fails. Notes: 1. The following fields are not considrered as `settings` for the purpose of the check mentioned above, therefore - updating another configuration with the same fields but different values for the following fields will fail as well: - name - create_time - update_time - labels - description", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/vpcFlowLogsConfigs/{vpcFlowLogsConfigsId}", + "httpMethod": "PATCH", + "id": "networkmanagement.projects.locations.vpcFlowLogsConfigs.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Identifier. Unique name of the configuration using the form: `projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config_id}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/vpcFlowLogsConfigs/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Required. Mask of fields to update. At least one path must be supplied in this field.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1beta1/{+name}", + "request": { + "$ref": "VpcFlowLogsConfig" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } } } } } } }, - "revision": "20240725", + "revision": "20240807", "rootUrl": "https://networkmanagement.googleapis.com/", "schemas": { "AbortInfo": { @@ -1147,7 +1314,9 @@ "CLOUD_NAT_NO_ADDRESSES", "ROUTING_LOOP", "DROPPED_INSIDE_GOOGLE_MANAGED_SERVICE", - "LOAD_BALANCER_BACKEND_INVALID_NETWORK" + "LOAD_BALANCER_BACKEND_INVALID_NETWORK", + "BACKEND_SERVICE_NAMED_PORT_NOT_DEFINED", + "DESTINATION_IS_PRIVATE_NAT_IP_RANGE" ], "enumDescriptions": [ "Cause is unspecified.", @@ -1215,7 +1384,9 @@ "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 a load balancer backend instance not having a network interface in the network expected by the load balancer." + "Packet is dropped due to a load balancer backend instance not having a network interface in the network expected by the load balancer.", + "Packet is dropped due to a backend service named port not being defined on the instance group level.", + "Packet is dropped due to a destination IP range being part of a Private NAT IP range." ], "type": "string" }, @@ -1821,6 +1992,31 @@ }, "type": "object" }, + "ListVpcFlowLogsConfigsResponse": { + "description": "Response for the `ListVpcFlowLogsConfigs` method.", + "id": "ListVpcFlowLogsConfigsResponse", + "properties": { + "nextPageToken": { + "description": "Page token to fetch the next set of configurations.", + "type": "string" + }, + "unreachable": { + "description": "Locations that could not be reached (when querying all locations with `-`).", + "items": { + "type": "string" + }, + "type": "array" + }, + "vpcFlowLogsConfigs": { + "description": "List of VPC Flow Log configurations.", + "items": { + "$ref": "VpcFlowLogsConfig" + }, + "type": "array" + } + }, + "type": "object" + }, "LoadBalancerBackend": { "description": "For display only. Metadata associated with a specific load balancer backend.", "id": "LoadBalancerBackend", @@ -2895,6 +3091,116 @@ }, "type": "object" }, + "VpcFlowLogsConfig": { + "description": "A configuration to generate VPC Flow Logs.", + "id": "VpcFlowLogsConfig", + "properties": { + "aggregationInterval": { + "description": "Optional. The aggregation interval for the logs. Default value is INTERVAL_5_SEC.", + "enum": [ + "AGGREGATION_INTERVAL_UNSPECIFIED", + "INTERVAL_5_SEC", + "INTERVAL_30_SEC", + "INTERVAL_1_MIN", + "INTERVAL_5_MIN", + "INTERVAL_10_MIN", + "INTERVAL_15_MIN" + ], + "enumDescriptions": [ + "If not specified, will default to INTERVAL_5_SEC.", + "Aggregate logs in 5s intervals.", + "Aggregate logs in 30s intervals.", + "Aggregate logs in 1m intervals.", + "Aggregate logs in 5m intervals.", + "Aggregate logs in 10m intervals.", + "Aggregate logs in 15m intervals." + ], + "type": "string" + }, + "createTime": { + "description": "Output only. The time the config was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "Optional. The user-supplied description of the VPC Flow Logs configuration. Maximum of 512 characters.", + "type": "string" + }, + "filterExpr": { + "description": "Optional. Export filter used to define which VPC Flow Logs should be logged.", + "type": "string" + }, + "flowSampling": { + "description": "Optional. The value of the field must be in (0, 1]. The sampling rate of VPC Flow Logs where 1.0 means all collected logs are reported. Setting the sampling rate to 0.0 is not allowed. If you want to disable VPC Flow Logs, use the state field instead. Default value is 1.0.", + "format": "float", + "type": "number" + }, + "interconnectAttachment": { + "description": "Traffic will be logged from the Interconnect Attachment. Format: projects/{project_id}/regions/{region}/interconnectAttachments/{name}", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Resource labels to represent user-provided metadata.", + "type": "object" + }, + "metadata": { + "description": "Optional. Configures whether all, none or a subset of metadata fields should be added to the reported VPC flow logs. Default value is INCLUDE_ALL_METADATA.", + "enum": [ + "METADATA_UNSPECIFIED", + "INCLUDE_ALL_METADATA", + "EXCLUDE_ALL_METADATA", + "CUSTOM_METADATA" + ], + "enumDescriptions": [ + "If not specified, will default to INCLUDE_ALL_METADATA.", + "Include all metadata fields.", + "Exclude all metadata fields.", + "Include only custom fields (specified in metadata_fields)." + ], + "type": "string" + }, + "metadataFields": { + "description": "Optional. Custom metadata fields to include in the reported VPC flow logs. Can only be specified if \"metadata\" was set to CUSTOM_METADATA.", + "items": { + "type": "string" + }, + "type": "array" + }, + "name": { + "description": "Identifier. Unique name of the configuration using the form: `projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config_id}`", + "type": "string" + }, + "state": { + "description": "Optional. The state of the VPC Flow Log configuration. Default value is ENABLED. When creating a new configuration, it must be enabled.", + "enum": [ + "STATE_UNSPECIFIED", + "ENABLED", + "DISABLED" + ], + "enumDescriptions": [ + "If not specified, will default to ENABLED.", + "When ENABLED, this configuration will generate logs.", + "When DISABLED, this configuration will not generate logs." + ], + "type": "string" + }, + "updateTime": { + "description": "Output only. The time the config was updated.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "vpnTunnel": { + "description": "Traffic will be logged from the VPN Tunnel. Format: projects/{project_id}/regions/{region}/vpnTunnels/{name}", + "type": "string" + } + }, + "type": "object" + }, "VpnGatewayInfo": { "description": "For display only. Metadata associated with a Compute Engine VPN gateway.", "id": "VpnGatewayInfo", diff --git a/networkmanagement/v1beta1/networkmanagement-gen.go b/networkmanagement/v1beta1/networkmanagement-gen.go index 36d37599fbf..5fbcc3165ef 100644 --- a/networkmanagement/v1beta1/networkmanagement-gen.go +++ b/networkmanagement/v1beta1/networkmanagement-gen.go @@ -169,6 +169,7 @@ type ProjectsService struct { func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { rs := &ProjectsLocationsService{s: s} rs.Global = NewProjectsLocationsGlobalService(s) + rs.VpcFlowLogsConfigs = NewProjectsLocationsVpcFlowLogsConfigsService(s) return rs } @@ -176,6 +177,8 @@ type ProjectsLocationsService struct { s *Service Global *ProjectsLocationsGlobalService + + VpcFlowLogsConfigs *ProjectsLocationsVpcFlowLogsConfigsService } func NewProjectsLocationsGlobalService(s *Service) *ProjectsLocationsGlobalService { @@ -211,6 +214,15 @@ type ProjectsLocationsGlobalOperationsService struct { s *Service } +func NewProjectsLocationsVpcFlowLogsConfigsService(s *Service) *ProjectsLocationsVpcFlowLogsConfigsService { + rs := &ProjectsLocationsVpcFlowLogsConfigsService{s: s} + return rs +} + +type ProjectsLocationsVpcFlowLogsConfigsService struct { + s *Service +} + // AbortInfo: Details of the final state "abort" and associated resource. type AbortInfo struct { // Cause: Causes that the analysis is aborted. @@ -1006,6 +1018,10 @@ type DropInfo struct { // "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. + // "BACKEND_SERVICE_NAMED_PORT_NOT_DEFINED" - Packet is dropped due to a + // backend service named port not being defined on the instance group level. + // "DESTINATION_IS_PRIVATE_NAT_IP_RANGE" - Packet is dropped due to a + // destination IP range being part of a Private NAT IP range. Cause string `json:"cause,omitempty"` // DestinationIp: Destination IP address of the dropped packet (if relevant). DestinationIp string `json:"destinationIp,omitempty"` @@ -1682,6 +1698,37 @@ func (s ListOperationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ListVpcFlowLogsConfigsResponse: Response for the `ListVpcFlowLogsConfigs` +// method. +type ListVpcFlowLogsConfigsResponse struct { + // NextPageToken: Page token to fetch the next set of configurations. + NextPageToken string `json:"nextPageToken,omitempty"` + // Unreachable: Locations that could not be reached (when querying all + // locations with `-`). + Unreachable []string `json:"unreachable,omitempty"` + // VpcFlowLogsConfigs: List of VPC Flow Log configurations. + VpcFlowLogsConfigs []*VpcFlowLogsConfig `json:"vpcFlowLogsConfigs,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "NextPageToken") 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. "NextPageToken") 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 ListVpcFlowLogsConfigsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListVpcFlowLogsConfigsResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // LoadBalancerBackend: For display only. Metadata associated with a specific // load balancer backend. type LoadBalancerBackend struct { @@ -2795,6 +2842,108 @@ func (s VpcConnectorInfo) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// VpcFlowLogsConfig: A configuration to generate VPC Flow Logs. +type VpcFlowLogsConfig struct { + // AggregationInterval: Optional. The aggregation interval for the logs. + // Default value is INTERVAL_5_SEC. + // + // Possible values: + // "AGGREGATION_INTERVAL_UNSPECIFIED" - If not specified, will default to + // INTERVAL_5_SEC. + // "INTERVAL_5_SEC" - Aggregate logs in 5s intervals. + // "INTERVAL_30_SEC" - Aggregate logs in 30s intervals. + // "INTERVAL_1_MIN" - Aggregate logs in 1m intervals. + // "INTERVAL_5_MIN" - Aggregate logs in 5m intervals. + // "INTERVAL_10_MIN" - Aggregate logs in 10m intervals. + // "INTERVAL_15_MIN" - Aggregate logs in 15m intervals. + AggregationInterval string `json:"aggregationInterval,omitempty"` + // CreateTime: Output only. The time the config was created. + CreateTime string `json:"createTime,omitempty"` + // Description: Optional. The user-supplied description of the VPC Flow Logs + // configuration. Maximum of 512 characters. + Description string `json:"description,omitempty"` + // FilterExpr: Optional. Export filter used to define which VPC Flow Logs + // should be logged. + FilterExpr string `json:"filterExpr,omitempty"` + // FlowSampling: Optional. The value of the field must be in (0, 1]. The + // sampling rate of VPC Flow Logs where 1.0 means all collected logs are + // reported. Setting the sampling rate to 0.0 is not allowed. If you want to + // disable VPC Flow Logs, use the state field instead. Default value is 1.0. + FlowSampling float64 `json:"flowSampling,omitempty"` + // InterconnectAttachment: Traffic will be logged from the Interconnect + // Attachment. Format: + // projects/{project_id}/regions/{region}/interconnectAttachments/{name} + InterconnectAttachment string `json:"interconnectAttachment,omitempty"` + // Labels: Optional. Resource labels to represent user-provided metadata. + Labels map[string]string `json:"labels,omitempty"` + // Metadata: Optional. Configures whether all, none or a subset of metadata + // fields should be added to the reported VPC flow logs. Default value is + // INCLUDE_ALL_METADATA. + // + // Possible values: + // "METADATA_UNSPECIFIED" - If not specified, will default to + // INCLUDE_ALL_METADATA. + // "INCLUDE_ALL_METADATA" - Include all metadata fields. + // "EXCLUDE_ALL_METADATA" - Exclude all metadata fields. + // "CUSTOM_METADATA" - Include only custom fields (specified in + // metadata_fields). + Metadata string `json:"metadata,omitempty"` + // MetadataFields: Optional. Custom metadata fields to include in the reported + // VPC flow logs. Can only be specified if "metadata" was set to + // CUSTOM_METADATA. + MetadataFields []string `json:"metadataFields,omitempty"` + // Name: Identifier. Unique name of the configuration using the form: + // `projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_con + // fig_id}` + Name string `json:"name,omitempty"` + // State: Optional. The state of the VPC Flow Log configuration. Default value + // is ENABLED. When creating a new configuration, it must be enabled. + // + // Possible values: + // "STATE_UNSPECIFIED" - If not specified, will default to ENABLED. + // "ENABLED" - When ENABLED, this configuration will generate logs. + // "DISABLED" - When DISABLED, this configuration will not generate logs. + State string `json:"state,omitempty"` + // UpdateTime: Output only. The time the config was updated. + UpdateTime string `json:"updateTime,omitempty"` + // VpnTunnel: Traffic will be logged from the VPN Tunnel. Format: + // projects/{project_id}/regions/{region}/vpnTunnels/{name} + VpnTunnel string `json:"vpnTunnel,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "AggregationInterval") 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. "AggregationInterval") 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 VpcFlowLogsConfig) MarshalJSON() ([]byte, error) { + type NoMethod VpcFlowLogsConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *VpcFlowLogsConfig) UnmarshalJSON(data []byte) error { + type NoMethod VpcFlowLogsConfig + var s1 struct { + FlowSampling gensupport.JSONFloat64 `json:"flowSampling"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.FlowSampling = float64(s1.FlowSampling) + return nil +} + // VpnGatewayInfo: For display only. Metadata associated with a Compute Engine // VPN gateway. type VpnGatewayInfo struct { @@ -4663,3 +4812,601 @@ func (c *ProjectsLocationsGlobalOperationsListCall) Pages(ctx context.Context, f c.PageToken(x.NextPageToken) } } + +type ProjectsLocationsVpcFlowLogsConfigsCreateCall struct { + s *Service + parent string + vpcflowlogsconfig *VpcFlowLogsConfig + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a new `VpcFlowLogsConfig`. If a configuration with the exact +// same settings already exists (even if the ID is different), the creation +// fails. Notes: 1. Creating a configuration with state=DISABLED will fail. 2. +// The following fields are not considrered as `settings` for the purpose of +// the check mentioned above, therefore - creating another configuration with +// the same fields but different values for the following fields will fail as +// well: - name - create_time - update_time - labels - description +// +// - parent: The parent resource of the VPC Flow Logs configuration to create: +// `projects/{project_id}/locations/global`. +func (r *ProjectsLocationsVpcFlowLogsConfigsService) Create(parent string, vpcflowlogsconfig *VpcFlowLogsConfig) *ProjectsLocationsVpcFlowLogsConfigsCreateCall { + c := &ProjectsLocationsVpcFlowLogsConfigsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.vpcflowlogsconfig = vpcflowlogsconfig + return c +} + +// VpcFlowLogsConfigId sets the optional parameter "vpcFlowLogsConfigId": +// Required. ID of the `VpcFlowLogsConfig`. +func (c *ProjectsLocationsVpcFlowLogsConfigsCreateCall) VpcFlowLogsConfigId(vpcFlowLogsConfigId string) *ProjectsLocationsVpcFlowLogsConfigsCreateCall { + c.urlParams_.Set("vpcFlowLogsConfigId", vpcFlowLogsConfigId) + 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 *ProjectsLocationsVpcFlowLogsConfigsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsVpcFlowLogsConfigsCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsVpcFlowLogsConfigsCreateCall) Context(ctx context.Context) *ProjectsLocationsVpcFlowLogsConfigsCreateCall { + 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 *ProjectsLocationsVpcFlowLogsConfigsCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVpcFlowLogsConfigsCreateCall) 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.vpcflowlogsconfig) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+parent}/vpcFlowLogsConfigs") + 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 "networkmanagement.projects.locations.vpcFlowLogsConfigs.create" 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 *ProjectsLocationsVpcFlowLogsConfigsCreateCall) 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 ProjectsLocationsVpcFlowLogsConfigsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes a specific `VpcFlowLogsConfig`. +// +// - name: `VpcFlowLogsConfig` resource name using the form: +// `projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_c +// onfig}`. +func (r *ProjectsLocationsVpcFlowLogsConfigsService) Delete(name string) *ProjectsLocationsVpcFlowLogsConfigsDeleteCall { + c := &ProjectsLocationsVpcFlowLogsConfigsDeleteCall{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 *ProjectsLocationsVpcFlowLogsConfigsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsVpcFlowLogsConfigsDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsVpcFlowLogsConfigsDeleteCall) Context(ctx context.Context) *ProjectsLocationsVpcFlowLogsConfigsDeleteCall { + 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 *ProjectsLocationsVpcFlowLogsConfigsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVpcFlowLogsConfigsDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("DELETE", 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 "networkmanagement.projects.locations.vpcFlowLogsConfigs.delete" 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 *ProjectsLocationsVpcFlowLogsConfigsDeleteCall) 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 ProjectsLocationsVpcFlowLogsConfigsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets the details of a specific `VpcFlowLogsConfig`. +// +// - name: `VpcFlowLogsConfig` resource name using the form: +// `projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_c +// onfig}`. +func (r *ProjectsLocationsVpcFlowLogsConfigsService) Get(name string) *ProjectsLocationsVpcFlowLogsConfigsGetCall { + c := &ProjectsLocationsVpcFlowLogsConfigsGetCall{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 *ProjectsLocationsVpcFlowLogsConfigsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsVpcFlowLogsConfigsGetCall { + 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 *ProjectsLocationsVpcFlowLogsConfigsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsVpcFlowLogsConfigsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsVpcFlowLogsConfigsGetCall) Context(ctx context.Context) *ProjectsLocationsVpcFlowLogsConfigsGetCall { + 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 *ProjectsLocationsVpcFlowLogsConfigsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVpcFlowLogsConfigsGetCall) 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, "v1beta1/{+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 "networkmanagement.projects.locations.vpcFlowLogsConfigs.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *VpcFlowLogsConfig.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 *ProjectsLocationsVpcFlowLogsConfigsGetCall) Do(opts ...googleapi.CallOption) (*VpcFlowLogsConfig, 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 := &VpcFlowLogsConfig{ + 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 ProjectsLocationsVpcFlowLogsConfigsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists all `VpcFlowLogsConfigs` in a given project. +// +// - parent: The parent resource of the VpcFlowLogsConfig: +// `projects/{project_id}/locations/global`. +func (r *ProjectsLocationsVpcFlowLogsConfigsService) List(parent string) *ProjectsLocationsVpcFlowLogsConfigsListCall { + c := &ProjectsLocationsVpcFlowLogsConfigsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Filter sets the optional parameter "filter": Lists the `VpcFlowLogsConfigs` +// that match the filter expression. A filter expression must use the supported +// [CEL logic operators] +// (https://cloud.google.com/vpc/docs/about-flow-logs-records#supported_cel_logic_operators). +func (c *ProjectsLocationsVpcFlowLogsConfigsListCall) Filter(filter string) *ProjectsLocationsVpcFlowLogsConfigsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// OrderBy sets the optional parameter "orderBy": Field to use to sort the +// list. +func (c *ProjectsLocationsVpcFlowLogsConfigsListCall) OrderBy(orderBy string) *ProjectsLocationsVpcFlowLogsConfigsListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + +// PageSize sets the optional parameter "pageSize": Number of +// `VpcFlowLogsConfigs` to return. +func (c *ProjectsLocationsVpcFlowLogsConfigsListCall) PageSize(pageSize int64) *ProjectsLocationsVpcFlowLogsConfigsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": Page token from an +// earlier query, as returned in `next_page_token`. +func (c *ProjectsLocationsVpcFlowLogsConfigsListCall) PageToken(pageToken string) *ProjectsLocationsVpcFlowLogsConfigsListCall { + c.urlParams_.Set("pageToken", pageToken) + 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 *ProjectsLocationsVpcFlowLogsConfigsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsVpcFlowLogsConfigsListCall { + 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 *ProjectsLocationsVpcFlowLogsConfigsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsVpcFlowLogsConfigsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsVpcFlowLogsConfigsListCall) Context(ctx context.Context) *ProjectsLocationsVpcFlowLogsConfigsListCall { + 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 *ProjectsLocationsVpcFlowLogsConfigsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVpcFlowLogsConfigsListCall) 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, "v1beta1/{+parent}/vpcFlowLogsConfigs") + 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{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "networkmanagement.projects.locations.vpcFlowLogsConfigs.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *ListVpcFlowLogsConfigsResponse.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 *ProjectsLocationsVpcFlowLogsConfigsListCall) Do(opts ...googleapi.CallOption) (*ListVpcFlowLogsConfigsResponse, 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 := &ListVpcFlowLogsConfigsResponse{ + 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 +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsLocationsVpcFlowLogsConfigsListCall) Pages(ctx context.Context, f func(*ListVpcFlowLogsConfigsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + +type ProjectsLocationsVpcFlowLogsConfigsPatchCall struct { + s *Service + name string + vpcflowlogsconfig *VpcFlowLogsConfig + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates an existing `VpcFlowLogsConfig`. If a configuration with the +// exact same settings already exists (even if the ID is different), the +// creation fails. Notes: 1. The following fields are not considrered as +// `settings` for the purpose of the check mentioned above, therefore - +// updating another configuration with the same fields but different values for +// the following fields will fail as well: - name - create_time - update_time - +// labels - description +// +// - name: Identifier. Unique name of the configuration using the form: +// `projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_c +// onfig_id}`. +func (r *ProjectsLocationsVpcFlowLogsConfigsService) Patch(name string, vpcflowlogsconfig *VpcFlowLogsConfig) *ProjectsLocationsVpcFlowLogsConfigsPatchCall { + c := &ProjectsLocationsVpcFlowLogsConfigsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.vpcflowlogsconfig = vpcflowlogsconfig + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. Mask of +// fields to update. At least one path must be supplied in this field. +func (c *ProjectsLocationsVpcFlowLogsConfigsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsVpcFlowLogsConfigsPatchCall { + 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 *ProjectsLocationsVpcFlowLogsConfigsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsVpcFlowLogsConfigsPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsVpcFlowLogsConfigsPatchCall) Context(ctx context.Context) *ProjectsLocationsVpcFlowLogsConfigsPatchCall { + 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 *ProjectsLocationsVpcFlowLogsConfigsPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVpcFlowLogsConfigsPatchCall) 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.vpcflowlogsconfig) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+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 "networkmanagement.projects.locations.vpcFlowLogsConfigs.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 *ProjectsLocationsVpcFlowLogsConfigsPatchCall) 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 +} diff --git a/option/internaloption/internaloption_test.go b/option/internaloption/internaloption_test.go index 8917f885dfa..81cfcd50d96 100644 --- a/option/internaloption/internaloption_test.go +++ b/option/internaloption/internaloption_test.go @@ -58,6 +58,6 @@ func TestDefaultApply(t *testing.T) { cmpopts.IgnoreFields(google.Credentials{}, "udMu", "universeDomain"), } if !cmp.Equal(got, want, ignore...) { - t.Errorf(cmp.Diff(got, want, ignore...)) + t.Error(cmp.Diff(got, want, ignore...)) } } diff --git a/option/option_test.go b/option/option_test.go index a1e60418088..04c3716513b 100644 --- a/option/option_test.go +++ b/option/option_test.go @@ -99,7 +99,7 @@ func TestApply(t *testing.T) { cmpopts.IgnoreFields(google.Credentials{}, "udMu", "universeDomain"), } if !cmp.Equal(got, want, ignore...) { - t.Errorf(cmp.Diff(got, want, ignore...)) + t.Error(cmp.Diff(got, want, ignore...)) } } @@ -130,6 +130,6 @@ func TestApplyClientCertSource(t *testing.T) { t.Error(err) } if !cmp.Equal(certGot, certWant, cmpopts.IgnoreUnexported(big.Int{}), cmpopts.IgnoreFields(tls.Certificate{}, "Leaf")) { - t.Errorf(cmp.Diff(certGot, certWant, cmpopts.IgnoreUnexported(big.Int{}), cmpopts.IgnoreFields(tls.Certificate{}, "Leaf"))) + t.Error(cmp.Diff(certGot, certWant, cmpopts.IgnoreUnexported(big.Int{}), cmpopts.IgnoreFields(tls.Certificate{}, "Leaf"))) } } diff --git a/playintegrity/v1/playintegrity-api.json b/playintegrity/v1/playintegrity-api.json index 91f9cee8b6d..a423ad4c106 100644 --- a/playintegrity/v1/playintegrity-api.json +++ b/playintegrity/v1/playintegrity-api.json @@ -170,7 +170,7 @@ } } }, - "revision": "20240725", + "revision": "20240813", "rootUrl": "https://playintegrity.googleapis.com/", "schemas": { "AccountActivity": { @@ -367,7 +367,7 @@ "type": "object" }, "DeviceIntegrity": { - "description": "Contains the device attestation information. Next tag: 4", + "description": "Contains the device attestation information.", "id": "DeviceIntegrity", "properties": { "deviceRecall": { @@ -403,7 +403,7 @@ "type": "object" }, "DeviceRecall": { - "description": "Contains the recall bits per device set by the developer. Next tag: 3", + "description": "Contains the recall bits per device set by the developer.", "id": "DeviceRecall", "properties": { "values": { @@ -589,7 +589,7 @@ "id": "WriteDeviceRecallRequest", "properties": { "integrityToken": { - "description": "Required. Integrity token obtained from calling Play Integrity API. Note that the integrity token contains the existing device recall bits. The write will only succeed if those bits in the integrity token are up to date.", + "description": "Required. Integrity token obtained from calling Play Integrity API.", "type": "string" }, "newValues": { diff --git a/playintegrity/v1/playintegrity-gen.go b/playintegrity/v1/playintegrity-gen.go index eddf6faa50c..eba28198029 100644 --- a/playintegrity/v1/playintegrity-gen.go +++ b/playintegrity/v1/playintegrity-gen.go @@ -428,7 +428,7 @@ func (s DecodeIntegrityTokenResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// DeviceIntegrity: Contains the device attestation information. Next tag: 4 +// DeviceIntegrity: Contains the device attestation information. type DeviceIntegrity struct { // DeviceRecall: Details about the device recall bits set by the developer. DeviceRecall *DeviceRecall `json:"deviceRecall,omitempty"` @@ -470,8 +470,7 @@ func (s DeviceIntegrity) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// DeviceRecall: Contains the recall bits per device set by the developer. Next -// tag: 3 +// DeviceRecall: Contains the recall bits per device set by the developer. type DeviceRecall struct { // Values: Required. Contains the recall bits values. Values *Values `json:"values,omitempty"` @@ -721,9 +720,7 @@ func (s WriteDates) MarshalJSON() ([]byte, error) { // WriteDeviceRecallRequest: Request to write device recall bits. type WriteDeviceRecallRequest struct { // IntegrityToken: Required. Integrity token obtained from calling Play - // Integrity API. Note that the integrity token contains the existing device - // recall bits. The write will only succeed if those bits in the integrity - // token are up to date. + // Integrity API. IntegrityToken string `json:"integrityToken,omitempty"` // NewValues: Required. The new values for the device recall bits to be // written. diff --git a/recaptchaenterprise/v1/recaptchaenterprise-api.json b/recaptchaenterprise/v1/recaptchaenterprise-api.json index 554ac63ce3a..ac4b0ced7e3 100644 --- a/recaptchaenterprise/v1/recaptchaenterprise-api.json +++ b/recaptchaenterprise/v1/recaptchaenterprise-api.json @@ -516,6 +516,42 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "listIpOverrides": { + "description": "Lists all IP overrides for a key.", + "flatPath": "v1/projects/{projectsId}/keys/{keysId}:listIpOverrides", + "httpMethod": "GET", + "id": "recaptchaenterprise.projects.keys.listIpOverrides", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Optional. The maximum number of overrides to return. Default is 10. Max limit is 100. If the number of overrides is less than the page_size, all overrides are returned. If the page size is more than 100, it is coerced to 100.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. The next_page_token value returned from a previous ListIpOverridesRequest, if any.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent key for which the IP overrides are listed, in the format `projects/{project}/keys/{key}`.", + "location": "path", + "pattern": "^projects/[^/]+/keys/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}:listIpOverrides", + "response": { + "$ref": "GoogleCloudRecaptchaenterpriseV1ListIpOverridesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "migrate": { "description": "Migrates an existing key from reCAPTCHA to reCAPTCHA Enterprise. Once a key is migrated, it can be used from either product. SiteVerify requests are billed as CreateAssessment calls. You must be authenticated as one of the current owners of the reCAPTCHA Key, and your user must have the reCAPTCHA Enterprise Admin IAM role in the destination project.", "flatPath": "v1/projects/{projectsId}/keys/{keysId}:migrate", @@ -578,6 +614,34 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "removeIpOverride": { + "description": "Removes an IP override from a key. The following restrictions hold: * If the IP isn't found in an existing IP override, a `NOT_FOUND` error will be returned. * If the IP is found in an existing IP override, but the override type does not match, a `NOT_FOUND` error will be returned.", + "flatPath": "v1/projects/{projectsId}/keys/{keysId}:removeIpOverride", + "httpMethod": "POST", + "id": "recaptchaenterprise.projects.keys.removeIpOverride", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the key from which the IP override is removed, in the format `projects/{project}/keys/{key}`.", + "location": "path", + "pattern": "^projects/[^/]+/keys/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}:removeIpOverride", + "request": { + "$ref": "GoogleCloudRecaptchaenterpriseV1RemoveIpOverrideRequest" + }, + "response": { + "$ref": "GoogleCloudRecaptchaenterpriseV1RemoveIpOverrideResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "retrieveLegacySecretKey": { "description": "Returns the secret key related to the specified public key. You must use the legacy secret key only in a 3rd party integration with legacy reCAPTCHA.", "flatPath": "v1/projects/{projectsId}/keys/{keysId}:retrieveLegacySecretKey", @@ -722,7 +786,7 @@ } } }, - "revision": "20240804", + "revision": "20240811", "rootUrl": "https://recaptchaenterprise.googleapis.com/", "schemas": { "GoogleCloudRecaptchaenterpriseV1AccountDefenderAssessment": { @@ -1538,6 +1602,24 @@ }, "type": "object" }, + "GoogleCloudRecaptchaenterpriseV1ListIpOverridesResponse": { + "description": "Response for ListIpOverrides.", + "id": "GoogleCloudRecaptchaenterpriseV1ListIpOverridesResponse", + "properties": { + "ipOverrides": { + "description": "IP Overrides details.", + "items": { + "$ref": "GoogleCloudRecaptchaenterpriseV1IpOverrideData" + }, + "type": "array" + }, + "nextPageToken": { + "description": "Token to retrieve the next page of results. If this field is empty, no keys remain in the results.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudRecaptchaenterpriseV1ListKeysResponse": { "description": "Response to request to list keys in a project.", "id": "GoogleCloudRecaptchaenterpriseV1ListKeysResponse", @@ -1710,6 +1792,23 @@ }, "type": "object" }, + "GoogleCloudRecaptchaenterpriseV1RemoveIpOverrideRequest": { + "description": "The removeIpOverride request message.", + "id": "GoogleCloudRecaptchaenterpriseV1RemoveIpOverrideRequest", + "properties": { + "ipOverrideData": { + "$ref": "GoogleCloudRecaptchaenterpriseV1IpOverrideData", + "description": "Required. IP override to be removed from the key." + } + }, + "type": "object" + }, + "GoogleCloudRecaptchaenterpriseV1RemoveIpOverrideResponse": { + "description": "Response for RemoveIpOverride.", + "id": "GoogleCloudRecaptchaenterpriseV1RemoveIpOverrideResponse", + "properties": {}, + "type": "object" + }, "GoogleCloudRecaptchaenterpriseV1ReorderFirewallPoliciesRequest": { "description": "The reorder firewall policies request message.", "id": "GoogleCloudRecaptchaenterpriseV1ReorderFirewallPoliciesRequest", diff --git a/recaptchaenterprise/v1/recaptchaenterprise-gen.go b/recaptchaenterprise/v1/recaptchaenterprise-gen.go index 2b2d6fbc32b..e5c9dd85e90 100644 --- a/recaptchaenterprise/v1/recaptchaenterprise-gen.go +++ b/recaptchaenterprise/v1/recaptchaenterprise-gen.go @@ -1362,6 +1362,35 @@ func (s GoogleCloudRecaptchaenterpriseV1ListFirewallPoliciesResponse) MarshalJSO return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudRecaptchaenterpriseV1ListIpOverridesResponse: Response for +// ListIpOverrides. +type GoogleCloudRecaptchaenterpriseV1ListIpOverridesResponse struct { + // IpOverrides: IP Overrides details. + IpOverrides []*GoogleCloudRecaptchaenterpriseV1IpOverrideData `json:"ipOverrides,omitempty"` + // NextPageToken: Token to retrieve the next page of results. If this field is + // empty, no keys remain in the results. + NextPageToken string `json:"nextPageToken,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "IpOverrides") 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. "IpOverrides") 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 GoogleCloudRecaptchaenterpriseV1ListIpOverridesResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRecaptchaenterpriseV1ListIpOverridesResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudRecaptchaenterpriseV1ListKeysResponse: Response to request to // list keys in a project. type GoogleCloudRecaptchaenterpriseV1ListKeysResponse struct { @@ -1636,6 +1665,36 @@ func (s GoogleCloudRecaptchaenterpriseV1RelatedAccountGroupMembership) MarshalJS return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudRecaptchaenterpriseV1RemoveIpOverrideRequest: The +// removeIpOverride request message. +type GoogleCloudRecaptchaenterpriseV1RemoveIpOverrideRequest struct { + // IpOverrideData: Required. IP override to be removed from the key. + IpOverrideData *GoogleCloudRecaptchaenterpriseV1IpOverrideData `json:"ipOverrideData,omitempty"` + // ForceSendFields is a list of field names (e.g. "IpOverrideData") 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. "IpOverrideData") 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 GoogleCloudRecaptchaenterpriseV1RemoveIpOverrideRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRecaptchaenterpriseV1RemoveIpOverrideRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRecaptchaenterpriseV1RemoveIpOverrideResponse: Response for +// RemoveIpOverride. +type GoogleCloudRecaptchaenterpriseV1RemoveIpOverrideResponse struct { + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` +} + // GoogleCloudRecaptchaenterpriseV1ReorderFirewallPoliciesRequest: The reorder // firewall policies request message. type GoogleCloudRecaptchaenterpriseV1ReorderFirewallPoliciesRequest struct { @@ -4118,6 +4177,152 @@ func (c *ProjectsKeysListCall) Pages(ctx context.Context, f func(*GoogleCloudRec } } +type ProjectsKeysListIpOverridesCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// ListIpOverrides: Lists all IP overrides for a key. +// +// - parent: The parent key for which the IP overrides are listed, in the +// format `projects/{project}/keys/{key}`. +func (r *ProjectsKeysService) ListIpOverrides(parent string) *ProjectsKeysListIpOverridesCall { + c := &ProjectsKeysListIpOverridesCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number of +// overrides to return. Default is 10. Max limit is 100. If the number of +// overrides is less than the page_size, all overrides are returned. If the +// page size is more than 100, it is coerced to 100. +func (c *ProjectsKeysListIpOverridesCall) PageSize(pageSize int64) *ProjectsKeysListIpOverridesCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The next_page_token value +// returned from a previous ListIpOverridesRequest, if any. +func (c *ProjectsKeysListIpOverridesCall) PageToken(pageToken string) *ProjectsKeysListIpOverridesCall { + c.urlParams_.Set("pageToken", pageToken) + 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 *ProjectsKeysListIpOverridesCall) Fields(s ...googleapi.Field) *ProjectsKeysListIpOverridesCall { + 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 *ProjectsKeysListIpOverridesCall) IfNoneMatch(entityTag string) *ProjectsKeysListIpOverridesCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsKeysListIpOverridesCall) Context(ctx context.Context) *ProjectsKeysListIpOverridesCall { + 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 *ProjectsKeysListIpOverridesCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsKeysListIpOverridesCall) 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, "v1/{+parent}:listIpOverrides") + 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{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "recaptchaenterprise.projects.keys.listIpOverrides" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudRecaptchaenterpriseV1ListIpOverridesResponse.ServerResponse.Heade +// r 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 *ProjectsKeysListIpOverridesCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecaptchaenterpriseV1ListIpOverridesResponse, 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 := &GoogleCloudRecaptchaenterpriseV1ListIpOverridesResponse{ + 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 +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsKeysListIpOverridesCall) Pages(ctx context.Context, f func(*GoogleCloudRecaptchaenterpriseV1ListIpOverridesResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + type ProjectsKeysMigrateCall struct { s *Service name string @@ -4336,6 +4541,113 @@ func (c *ProjectsKeysPatchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRe return ret, nil } +type ProjectsKeysRemoveIpOverrideCall struct { + s *Service + name string + googlecloudrecaptchaenterprisev1removeipoverriderequest *GoogleCloudRecaptchaenterpriseV1RemoveIpOverrideRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// RemoveIpOverride: Removes an IP override from a key. The following +// restrictions hold: * If the IP isn't found in an existing IP override, a +// `NOT_FOUND` error will be returned. * If the IP is found in an existing IP +// override, but the override type does not match, a `NOT_FOUND` error will be +// returned. +// +// - name: The name of the key from which the IP override is removed, in the +// format `projects/{project}/keys/{key}`. +func (r *ProjectsKeysService) RemoveIpOverride(name string, googlecloudrecaptchaenterprisev1removeipoverriderequest *GoogleCloudRecaptchaenterpriseV1RemoveIpOverrideRequest) *ProjectsKeysRemoveIpOverrideCall { + c := &ProjectsKeysRemoveIpOverrideCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googlecloudrecaptchaenterprisev1removeipoverriderequest = googlecloudrecaptchaenterprisev1removeipoverriderequest + 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 *ProjectsKeysRemoveIpOverrideCall) Fields(s ...googleapi.Field) *ProjectsKeysRemoveIpOverrideCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsKeysRemoveIpOverrideCall) Context(ctx context.Context) *ProjectsKeysRemoveIpOverrideCall { + 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 *ProjectsKeysRemoveIpOverrideCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsKeysRemoveIpOverrideCall) 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.googlecloudrecaptchaenterprisev1removeipoverriderequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:removeIpOverride") + 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{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "recaptchaenterprise.projects.keys.removeIpOverride" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudRecaptchaenterpriseV1RemoveIpOverrideResponse.ServerResponse.Head +// er 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 *ProjectsKeysRemoveIpOverrideCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecaptchaenterpriseV1RemoveIpOverrideResponse, 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 := &GoogleCloudRecaptchaenterpriseV1RemoveIpOverrideResponse{ + 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 ProjectsKeysRetrieveLegacySecretKeyCall struct { s *Service key string diff --git a/redis/v1/redis-api.json b/redis/v1/redis-api.json index 862c71346ce..8131657b50f 100644 --- a/redis/v1/redis-api.json +++ b/redis/v1/redis-api.json @@ -821,7 +821,7 @@ } } }, - "revision": "20240711", + "revision": "20240812", "rootUrl": "https://redis.googleapis.com/", "schemas": { "AOFConfig": { @@ -987,6 +987,10 @@ "readOnly": true, "type": "string" }, + "crossClusterReplicationConfig": { + "$ref": "CrossClusterReplicationConfig", + "description": "Optional. Cross cluster replication config." + }, "deletionProtectionEnabled": { "description": "Optional. The delete operation will fail when the value is set to true.", "type": "boolean" @@ -1059,7 +1063,7 @@ "type": "integer" }, "shardCount": { - "description": "Required. Number of shards for the Redis cluster.", + "description": "Optional. Number of shards for the Redis cluster.", "format": "int32", "type": "integer" }, @@ -1165,40 +1169,61 @@ }, "type": "object" }, - "CustomMetadataData": { - "description": "Any custom metadata associated with the resource. i.e. A spanner instance can have multiple databases with its own unique metadata. Information for these individual databases can be captured in custom metadata data", - "id": "CustomMetadataData", + "CrossClusterReplicationConfig": { + "description": "Cross cluster replication config.", + "id": "CrossClusterReplicationConfig", "properties": { - "databaseMetadata": { + "clusterRole": { + "description": "The role of the cluster in cross cluster replication.", + "enum": [ + "CLUSTER_ROLE_UNSPECIFIED", + "NONE", + "PRIMARY", + "SECONDARY" + ], + "enumDescriptions": [ + "Cluster role is not set. The behavior is equivalent to NONE.", + "This cluster does not participate in cross cluster replication. It is an independent cluster and does not replicate to or from any other clusters.", + "A cluster that allows both reads and writes. Any data written to this cluster is also replicated to the attached secondary clusters.", + "A cluster that allows only reads and replicates data from a primary cluster." + ], + "type": "string" + }, + "membership": { + "$ref": "Membership", + "description": "Output only. An output only view of all the member clusters participating in the cross cluster replication. This view will be provided by every member cluster irrespective of its cluster role(primary or secondary). A primary cluster can provide information about all the secondary clusters replicating from it. However, a secondary cluster only knows about the primary cluster from which it is replicating. However, for scenarios, where the primary cluster is unavailable(e.g. regional outage), a GetCluster request can be sent to any other member cluster and this field will list all the member clusters participating in cross cluster replication.", + "readOnly": true + }, + "primaryCluster": { + "$ref": "RemoteCluster", + "description": "Details of the primary cluster that is used as the replication source for this secondary cluster. This field is only set for a secondary cluster." + }, + "secondaryClusters": { + "description": "List of secondary clusters that are replicating from this primary cluster. This field is only set for a primary cluster.", "items": { - "$ref": "DatabaseMetadata" + "$ref": "RemoteCluster" }, "type": "array" + }, + "updateTime": { + "description": "Output only. The last time cross cluster replication config was updated.", + "format": "google-datetime", + "readOnly": true, + "type": "string" } }, "type": "object" }, - "DatabaseMetadata": { - "description": "Metadata for individual databases created in an instance. i.e. spanner instance can have multiple databases with unique configuration settings.", - "id": "DatabaseMetadata", + "CustomMetadataData": { + "description": "Any custom metadata associated with the resource. e.g. A spanner instance can have multiple databases with its own unique metadata. Information for these individual databases can be captured in custom metadata data", + "id": "CustomMetadataData", "properties": { - "backupConfiguration": { - "$ref": "BackupConfiguration", - "description": "Backup configuration for this database" - }, - "backupRun": { - "$ref": "BackupRun", - "description": "Information about the last backup attempt for this database" - }, - "product": { - "$ref": "Product" - }, - "resourceId": { - "$ref": "DatabaseResourceId" - }, - "resourceName": { - "description": "Required. Database name. Resource name to follow CAIS resource_name format as noted here go/condor-common-datamodel", - "type": "string" + "internalResourceMetadata": { + "description": "Metadata for individual internal resources in an instance. e.g. spanner instance can have multiple databases with unique configuration.", + "items": { + "$ref": "InternalResourceMetadata" + }, + "type": "array" } }, "type": "object" @@ -1340,6 +1365,24 @@ "description": "Required. Unique identifier for the signal. This is an unique id which would be mainatined by partner to identify a signal.", "type": "string" }, + "signalSeverity": { + "description": "The severity of the signal, such as if it's a HIGH or LOW severity.", + "enum": [ + "SIGNAL_SEVERITY_UNSPECIFIED", + "CRITICAL", + "HIGH", + "MEDIUM", + "LOW" + ], + "enumDescriptions": [ + "This value is used for findings when a source doesn't write a severity value.", + "A critical vulnerability is easily discoverable by an external actor, exploitable.", + "A high risk vulnerability can be easily discovered and exploited in combination with other vulnerabilities.", + "A medium risk vulnerability could be used by an actor to gain access to resources or privileges that enable them to eventually gain access and the ability to execute arbitrary code or exfiltrate data.", + "A low risk vulnerability hampers a security organization's ability to detect vulnerabilities or active threats in their deployment." + ], + "type": "string" + }, "signalType": { "description": "Required. Type of signal, for example, `AVAILABLE_IN_MULTIPLE_ZONES`, `LOGGING_MOST_ERRORS`, etc.", "enum": [ @@ -1636,7 +1679,7 @@ "type": "string" }, "resourceType": { - "description": "Required. The type of resource this ID is identifying. Ex redis.googleapis.com/Instance, redis.googleapis.com/Cluster, alloydb.googleapis.com/Cluster, alloydb.googleapis.com/Instance, spanner.googleapis.com/Instance REQUIRED Please refer go/condor-common-datamodel", + "description": "Required. The type of resource this ID is identifying. Ex redis.googleapis.com/Instance, redis.googleapis.com/Cluster, alloydb.googleapis.com/Cluster, alloydb.googleapis.com/Instance, spanner.googleapis.com/Instance, spanner.googleapis.com/Database, firestore.googleapis.com/Database, sqladmin.googleapis.com/Instance, bigtableadmin.googleapis.com/Cluster, bigtableadmin.googleapis.com/Instance REQUIRED Please refer go/condor-common-datamodel", "type": "string" }, "uniqueId": { @@ -2570,6 +2613,31 @@ }, "type": "object" }, + "InternalResourceMetadata": { + "description": "Metadata for individual internal resources in an instance. e.g. spanner instance can have multiple databases with unique configuration settings. Similarly bigtable can have multiple clusters within same bigtable instance.", + "id": "InternalResourceMetadata", + "properties": { + "backupConfiguration": { + "$ref": "BackupConfiguration", + "description": "Backup configuration for this database" + }, + "backupRun": { + "$ref": "BackupRun", + "description": "Information about the last backup attempt for this database" + }, + "product": { + "$ref": "Product" + }, + "resourceId": { + "$ref": "DatabaseResourceId" + }, + "resourceName": { + "description": "Required. internal resource name for spanner this will be database name e.g.\"spanner.googleapis.com/projects/123/abc/instances/inst1/databases/db1\"", + "type": "string" + } + }, + "type": "object" + }, "ListClustersResponse": { "description": "Response for ListClusters.", "id": "ListClustersResponse", @@ -2780,6 +2848,26 @@ }, "type": "object" }, + "Membership": { + "description": "An output only view of all the member clusters participating in the cross cluster replication.", + "id": "Membership", + "properties": { + "primaryCluster": { + "$ref": "RemoteCluster", + "description": "Output only. The primary cluster that acts as the source of replication for the secondary clusters.", + "readOnly": true + }, + "secondaryClusters": { + "description": "Output only. The list of secondary clusters replicating from the primary cluster.", + "items": { + "$ref": "RemoteCluster" + }, + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, "NodeInfo": { "description": "Node specific properties.", "id": "NodeInfo", @@ -3050,7 +3138,9 @@ "ENGINE_CLOUD_SPANNER_WITH_GOOGLESQL_DIALECT", "ENGINE_MEMORYSTORE_FOR_REDIS", "ENGINE_MEMORYSTORE_FOR_REDIS_CLUSTER", - "ENGINE_OTHER" + "ENGINE_OTHER", + "ENGINE_FIRESTORE_WITH_NATIVE_MODE", + "ENGINE_FIRESTORE_WITH_DATASTORE_MODE" ], "enumDeprecated": [ false, @@ -3066,6 +3156,8 @@ false, false, false, + false, + false, false ], "enumDescriptions": [ @@ -3082,7 +3174,9 @@ "Cloud Spanner with Google SQL dialect.", "Memorystore with Redis dialect.", "Memorystore with Redis cluster dialect.", - "Other refers to rest of other database engine. This is to be when engine is known, but it is not present in this enum." + "Other refers to rest of other database engine. This is to be when engine is known, but it is not present in this enum.", + "Firestore with native mode.", + "Firestore with datastore mode." ], "type": "string" }, @@ -3099,7 +3193,8 @@ "ON_PREM", "PRODUCT_TYPE_MEMORYSTORE", "PRODUCT_TYPE_BIGTABLE", - "PRODUCT_TYPE_OTHER" + "PRODUCT_TYPE_OTHER", + "PRODUCT_TYPE_FIRESTORE" ], "enumDeprecated": [ false, @@ -3112,6 +3207,7 @@ true, false, false, + false, false ], "enumDescriptions": [ @@ -3125,7 +3221,8 @@ "On premises database product.", "Memorystore product area in GCP", "Bigtable product area in GCP", - "Other refers to rest of other product type. This is to be when product type is known, but it is not present in this enum." + "Other refers to rest of other product type. This is to be when product type is known, but it is not present in this enum.", + "Firestore product area in GCP." ], "type": "string" }, @@ -3238,6 +3335,22 @@ }, "type": "object" }, + "RemoteCluster": { + "description": "Details of the remote cluster associated with this cluster in a cross cluster replication setup.", + "id": "RemoteCluster", + "properties": { + "cluster": { + "description": "The full resource path of the remote cluster in the format: projects//locations//clusters/", + "type": "string" + }, + "uid": { + "description": "Output only. The unique identifier of the remote cluster.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "RescheduleMaintenanceRequest": { "description": "Request for RescheduleMaintenance.", "id": "RescheduleMaintenanceRequest", diff --git a/redis/v1/redis-gen.go b/redis/v1/redis-gen.go index 6f66010a01a..b6ce611ff38 100644 --- a/redis/v1/redis-gen.go +++ b/redis/v1/redis-gen.go @@ -409,6 +409,8 @@ type Cluster struct { // CreateTime: Output only. The timestamp associated with the cluster creation // request. CreateTime string `json:"createTime,omitempty"` + // CrossClusterReplicationConfig: Optional. Cross cluster replication config. + CrossClusterReplicationConfig *CrossClusterReplicationConfig `json:"crossClusterReplicationConfig,omitempty"` // DeletionProtectionEnabled: Optional. The delete operation will fail when the // value is set to true. DeletionProtectionEnabled bool `json:"deletionProtectionEnabled,omitempty"` @@ -447,7 +449,7 @@ type Cluster struct { RedisConfigs map[string]string `json:"redisConfigs,omitempty"` // ReplicaCount: Optional. The number of replica nodes per shard. ReplicaCount int64 `json:"replicaCount,omitempty"` - // ShardCount: Required. Number of shards for the Redis cluster. + // ShardCount: Optional. Number of shards for the Redis cluster. ShardCount int64 `json:"shardCount,omitempty"` // SizeGb: Output only. Redis memory size in GB for the entire cluster rounded // up to the next integer. @@ -574,58 +576,84 @@ func (s Compliance) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// CustomMetadataData: Any custom metadata associated with the resource. i.e. A -// spanner instance can have multiple databases with its own unique metadata. -// Information for these individual databases can be captured in custom -// metadata data -type CustomMetadataData struct { - DatabaseMetadata []*DatabaseMetadata `json:"databaseMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "DatabaseMetadata") to +// CrossClusterReplicationConfig: Cross cluster replication config. +type CrossClusterReplicationConfig struct { + // ClusterRole: The role of the cluster in cross cluster replication. + // + // Possible values: + // "CLUSTER_ROLE_UNSPECIFIED" - Cluster role is not set. The behavior is + // equivalent to NONE. + // "NONE" - This cluster does not participate in cross cluster replication. + // It is an independent cluster and does not replicate to or from any other + // clusters. + // "PRIMARY" - A cluster that allows both reads and writes. Any data written + // to this cluster is also replicated to the attached secondary clusters. + // "SECONDARY" - A cluster that allows only reads and replicates data from a + // primary cluster. + ClusterRole string `json:"clusterRole,omitempty"` + // Membership: Output only. An output only view of all the member clusters + // participating in the cross cluster replication. This view will be provided + // by every member cluster irrespective of its cluster role(primary or + // secondary). A primary cluster can provide information about all the + // secondary clusters replicating from it. However, a secondary cluster only + // knows about the primary cluster from which it is replicating. However, for + // scenarios, where the primary cluster is unavailable(e.g. regional outage), a + // GetCluster request can be sent to any other member cluster and this field + // will list all the member clusters participating in cross cluster + // replication. + Membership *Membership `json:"membership,omitempty"` + // PrimaryCluster: Details of the primary cluster that is used as the + // replication source for this secondary cluster. This field is only set for a + // secondary cluster. + PrimaryCluster *RemoteCluster `json:"primaryCluster,omitempty"` + // SecondaryClusters: List of secondary clusters that are replicating from this + // primary cluster. This field is only set for a primary cluster. + SecondaryClusters []*RemoteCluster `json:"secondaryClusters,omitempty"` + // UpdateTime: Output only. The last time cross cluster replication config was + // updated. + UpdateTime string `json:"updateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "ClusterRole") 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. "DatabaseMetadata") 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. "ClusterRole") 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 CustomMetadataData) MarshalJSON() ([]byte, error) { - type NoMethod CustomMetadataData +func (s CrossClusterReplicationConfig) MarshalJSON() ([]byte, error) { + type NoMethod CrossClusterReplicationConfig return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// DatabaseMetadata: Metadata for individual databases created in an instance. -// i.e. spanner instance can have multiple databases with unique configuration -// settings. -type DatabaseMetadata struct { - // BackupConfiguration: Backup configuration for this database - BackupConfiguration *BackupConfiguration `json:"backupConfiguration,omitempty"` - // BackupRun: Information about the last backup attempt for this database - BackupRun *BackupRun `json:"backupRun,omitempty"` - Product *Product `json:"product,omitempty"` - ResourceId *DatabaseResourceId `json:"resourceId,omitempty"` - // ResourceName: Required. Database name. Resource name to follow CAIS - // resource_name format as noted here go/condor-common-datamodel - ResourceName string `json:"resourceName,omitempty"` - // ForceSendFields is a list of field names (e.g. "BackupConfiguration") to - // unconditionally include in API requests. By default, fields with empty or +// CustomMetadataData: Any custom metadata associated with the resource. e.g. A +// spanner instance can have multiple databases with its own unique metadata. +// Information for these individual databases can be captured in custom +// metadata data +type CustomMetadataData struct { + // InternalResourceMetadata: Metadata for individual internal resources in an + // instance. e.g. spanner instance can have multiple databases with unique + // configuration. + InternalResourceMetadata []*InternalResourceMetadata `json:"internalResourceMetadata,omitempty"` + // ForceSendFields is a list of field names (e.g. "InternalResourceMetadata") + // 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. "BackupConfiguration") 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. "InternalResourceMetadata") 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 DatabaseMetadata) MarshalJSON() ([]byte, error) { - type NoMethod DatabaseMetadata +func (s CustomMetadataData) MarshalJSON() ([]byte, error) { + type NoMethod CustomMetadataData return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } @@ -736,6 +764,22 @@ type DatabaseResourceHealthSignalData struct { // SignalId: Required. Unique identifier for the signal. This is an unique id // which would be mainatined by partner to identify a signal. SignalId string `json:"signalId,omitempty"` + // SignalSeverity: The severity of the signal, such as if it's a HIGH or LOW + // severity. + // + // Possible values: + // "SIGNAL_SEVERITY_UNSPECIFIED" - This value is used for findings when a + // source doesn't write a severity value. + // "CRITICAL" - A critical vulnerability is easily discoverable by an + // external actor, exploitable. + // "HIGH" - A high risk vulnerability can be easily discovered and exploited + // in combination with other vulnerabilities. + // "MEDIUM" - A medium risk vulnerability could be used by an actor to gain + // access to resources or privileges that enable them to eventually gain access + // and the ability to execute arbitrary code or exfiltrate data. + // "LOW" - A low risk vulnerability hampers a security organization's ability + // to detect vulnerabilities or active threats in their deployment. + SignalSeverity string `json:"signalSeverity,omitempty"` // SignalType: Required. Type of signal, for example, // `AVAILABLE_IN_MULTIPLE_ZONES`, `LOGGING_MOST_ERRORS`, etc. // @@ -973,8 +1017,10 @@ type DatabaseResourceId struct { // ResourceType: Required. The type of resource this ID is identifying. Ex // redis.googleapis.com/Instance, redis.googleapis.com/Cluster, // alloydb.googleapis.com/Cluster, alloydb.googleapis.com/Instance, - // spanner.googleapis.com/Instance REQUIRED Please refer - // go/condor-common-datamodel + // spanner.googleapis.com/Instance, spanner.googleapis.com/Database, + // firestore.googleapis.com/Database, sqladmin.googleapis.com/Instance, + // bigtableadmin.googleapis.com/Cluster, bigtableadmin.googleapis.com/Instance + // REQUIRED Please refer go/condor-common-datamodel ResourceType string `json:"resourceType,omitempty"` // UniqueId: Required. A service-local token that distinguishes this resource // from other resources within the same service. @@ -1875,6 +1921,39 @@ func (s InstanceAuthString) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// InternalResourceMetadata: Metadata for individual internal resources in an +// instance. e.g. spanner instance can have multiple databases with unique +// configuration settings. Similarly bigtable can have multiple clusters within +// same bigtable instance. +type InternalResourceMetadata struct { + // BackupConfiguration: Backup configuration for this database + BackupConfiguration *BackupConfiguration `json:"backupConfiguration,omitempty"` + // BackupRun: Information about the last backup attempt for this database + BackupRun *BackupRun `json:"backupRun,omitempty"` + Product *Product `json:"product,omitempty"` + ResourceId *DatabaseResourceId `json:"resourceId,omitempty"` + // ResourceName: Required. internal resource name for spanner this will be + // database name + // e.g."spanner.googleapis.com/projects/123/abc/instances/inst1/databases/db1" + ResourceName string `json:"resourceName,omitempty"` + // ForceSendFields is a list of field names (e.g. "BackupConfiguration") 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. "BackupConfiguration") 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 InternalResourceMetadata) MarshalJSON() ([]byte, error) { + type NoMethod InternalResourceMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ListClustersResponse: Response for ListClusters. type ListClustersResponse struct { // Clusters: A list of Redis clusters in the project in the specified location, @@ -2159,6 +2238,33 @@ func (s ManagedCertificateAuthority) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// Membership: An output only view of all the member clusters participating in +// the cross cluster replication. +type Membership struct { + // PrimaryCluster: Output only. The primary cluster that acts as the source of + // replication for the secondary clusters. + PrimaryCluster *RemoteCluster `json:"primaryCluster,omitempty"` + // SecondaryClusters: Output only. The list of secondary clusters replicating + // from the primary cluster. + SecondaryClusters []*RemoteCluster `json:"secondaryClusters,omitempty"` + // ForceSendFields is a list of field names (e.g. "PrimaryCluster") 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. "PrimaryCluster") 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 Membership) MarshalJSON() ([]byte, error) { + type NoMethod Membership + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // NodeInfo: Node specific properties. type NodeInfo struct { // Id: Output only. Node identifying string. e.g. 'node-0', 'node-1' @@ -2456,6 +2562,8 @@ type Product struct { // dialect. // "ENGINE_OTHER" - Other refers to rest of other database engine. This is to // be when engine is known, but it is not present in this enum. + // "ENGINE_FIRESTORE_WITH_NATIVE_MODE" - Firestore with native mode. + // "ENGINE_FIRESTORE_WITH_DATASTORE_MODE" - Firestore with datastore mode. Engine string `json:"engine,omitempty"` // Type: Type of specific database product. It could be CloudSQL, AlloyDB etc.. // @@ -2473,6 +2581,7 @@ type Product struct { // "PRODUCT_TYPE_BIGTABLE" - Bigtable product area in GCP // "PRODUCT_TYPE_OTHER" - Other refers to rest of other product type. This is // to be when product type is known, but it is not present in this enum. + // "PRODUCT_TYPE_FIRESTORE" - Firestore product area in GCP. Type string `json:"type,omitempty"` // Version: Version of the underlying database engine. Example values: For // MySQL, it could be "8.0", "5.7" etc.. For Postgres, it could be "14", "15" @@ -2623,6 +2732,32 @@ func (s ReconciliationOperationMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// RemoteCluster: Details of the remote cluster associated with this cluster in +// a cross cluster replication setup. +type RemoteCluster struct { + // Cluster: The full resource path of the remote cluster in the format: + // projects//locations//clusters/ + Cluster string `json:"cluster,omitempty"` + // Uid: Output only. The unique identifier of the remote cluster. + Uid string `json:"uid,omitempty"` + // ForceSendFields is a list of field names (e.g. "Cluster") 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. "Cluster") 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 RemoteCluster) MarshalJSON() ([]byte, error) { + type NoMethod RemoteCluster + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // RescheduleMaintenanceRequest: Request for RescheduleMaintenance. type RescheduleMaintenanceRequest struct { // RescheduleType: Required. If reschedule type is SPECIFIC_TIME, must set up diff --git a/redis/v1beta1/redis-api.json b/redis/v1beta1/redis-api.json index 4760ddc20df..7742c590964 100644 --- a/redis/v1beta1/redis-api.json +++ b/redis/v1beta1/redis-api.json @@ -821,7 +821,7 @@ } } }, - "revision": "20240711", + "revision": "20240812", "rootUrl": "https://redis.googleapis.com/", "schemas": { "AOFConfig": { @@ -987,6 +987,10 @@ "readOnly": true, "type": "string" }, + "crossClusterReplicationConfig": { + "$ref": "CrossClusterReplicationConfig", + "description": "Optional. Cross cluster replication config." + }, "deletionProtectionEnabled": { "description": "Optional. The delete operation will fail when the value is set to true.", "type": "boolean" @@ -1059,7 +1063,7 @@ "type": "integer" }, "shardCount": { - "description": "Required. Number of shards for the Redis cluster.", + "description": "Optional. Number of shards for the Redis cluster.", "format": "int32", "type": "integer" }, @@ -1165,40 +1169,61 @@ }, "type": "object" }, - "CustomMetadataData": { - "description": "Any custom metadata associated with the resource. i.e. A spanner instance can have multiple databases with its own unique metadata. Information for these individual databases can be captured in custom metadata data", - "id": "CustomMetadataData", + "CrossClusterReplicationConfig": { + "description": "Cross cluster replication config.", + "id": "CrossClusterReplicationConfig", "properties": { - "databaseMetadata": { + "clusterRole": { + "description": "The role of the cluster in cross cluster replication.", + "enum": [ + "CLUSTER_ROLE_UNSPECIFIED", + "NONE", + "PRIMARY", + "SECONDARY" + ], + "enumDescriptions": [ + "Cluster role is not set. The behavior is equivalent to NONE.", + "This cluster does not participate in cross cluster replication. It is an independent cluster and does not replicate to or from any other clusters.", + "A cluster that allows both reads and writes. Any data written to this cluster is also replicated to the attached secondary clusters.", + "A cluster that allows only reads and replicates data from a primary cluster." + ], + "type": "string" + }, + "membership": { + "$ref": "Membership", + "description": "Output only. An output only view of all the member clusters participating in the cross cluster replication. This view will be provided by every member cluster irrespective of its cluster role(primary or secondary). A primary cluster can provide information about all the secondary clusters replicating from it. However, a secondary cluster only knows about the primary cluster from which it is replicating. However, for scenarios, where the primary cluster is unavailable(e.g. regional outage), a GetCluster request can be sent to any other member cluster and this field will list all the member clusters participating in cross cluster replication.", + "readOnly": true + }, + "primaryCluster": { + "$ref": "RemoteCluster", + "description": "Details of the primary cluster that is used as the replication source for this secondary cluster. This field is only set for a secondary cluster." + }, + "secondaryClusters": { + "description": "List of secondary clusters that are replicating from this primary cluster. This field is only set for a primary cluster.", "items": { - "$ref": "DatabaseMetadata" + "$ref": "RemoteCluster" }, "type": "array" + }, + "updateTime": { + "description": "Output only. The last time cross cluster replication config was updated.", + "format": "google-datetime", + "readOnly": true, + "type": "string" } }, "type": "object" }, - "DatabaseMetadata": { - "description": "Metadata for individual databases created in an instance. i.e. spanner instance can have multiple databases with unique configuration settings.", - "id": "DatabaseMetadata", + "CustomMetadataData": { + "description": "Any custom metadata associated with the resource. e.g. A spanner instance can have multiple databases with its own unique metadata. Information for these individual databases can be captured in custom metadata data", + "id": "CustomMetadataData", "properties": { - "backupConfiguration": { - "$ref": "BackupConfiguration", - "description": "Backup configuration for this database" - }, - "backupRun": { - "$ref": "BackupRun", - "description": "Information about the last backup attempt for this database" - }, - "product": { - "$ref": "Product" - }, - "resourceId": { - "$ref": "DatabaseResourceId" - }, - "resourceName": { - "description": "Required. Database name. Resource name to follow CAIS resource_name format as noted here go/condor-common-datamodel", - "type": "string" + "internalResourceMetadata": { + "description": "Metadata for individual internal resources in an instance. e.g. spanner instance can have multiple databases with unique configuration.", + "items": { + "$ref": "InternalResourceMetadata" + }, + "type": "array" } }, "type": "object" @@ -1340,6 +1365,24 @@ "description": "Required. Unique identifier for the signal. This is an unique id which would be mainatined by partner to identify a signal.", "type": "string" }, + "signalSeverity": { + "description": "The severity of the signal, such as if it's a HIGH or LOW severity.", + "enum": [ + "SIGNAL_SEVERITY_UNSPECIFIED", + "CRITICAL", + "HIGH", + "MEDIUM", + "LOW" + ], + "enumDescriptions": [ + "This value is used for findings when a source doesn't write a severity value.", + "A critical vulnerability is easily discoverable by an external actor, exploitable.", + "A high risk vulnerability can be easily discovered and exploited in combination with other vulnerabilities.", + "A medium risk vulnerability could be used by an actor to gain access to resources or privileges that enable them to eventually gain access and the ability to execute arbitrary code or exfiltrate data.", + "A low risk vulnerability hampers a security organization's ability to detect vulnerabilities or active threats in their deployment." + ], + "type": "string" + }, "signalType": { "description": "Required. Type of signal, for example, `AVAILABLE_IN_MULTIPLE_ZONES`, `LOGGING_MOST_ERRORS`, etc.", "enum": [ @@ -1636,7 +1679,7 @@ "type": "string" }, "resourceType": { - "description": "Required. The type of resource this ID is identifying. Ex redis.googleapis.com/Instance, redis.googleapis.com/Cluster, alloydb.googleapis.com/Cluster, alloydb.googleapis.com/Instance, spanner.googleapis.com/Instance REQUIRED Please refer go/condor-common-datamodel", + "description": "Required. The type of resource this ID is identifying. Ex redis.googleapis.com/Instance, redis.googleapis.com/Cluster, alloydb.googleapis.com/Cluster, alloydb.googleapis.com/Instance, spanner.googleapis.com/Instance, spanner.googleapis.com/Database, firestore.googleapis.com/Database, sqladmin.googleapis.com/Instance, bigtableadmin.googleapis.com/Cluster, bigtableadmin.googleapis.com/Instance REQUIRED Please refer go/condor-common-datamodel", "type": "string" }, "uniqueId": { @@ -2577,6 +2620,31 @@ }, "type": "object" }, + "InternalResourceMetadata": { + "description": "Metadata for individual internal resources in an instance. e.g. spanner instance can have multiple databases with unique configuration settings. Similarly bigtable can have multiple clusters within same bigtable instance.", + "id": "InternalResourceMetadata", + "properties": { + "backupConfiguration": { + "$ref": "BackupConfiguration", + "description": "Backup configuration for this database" + }, + "backupRun": { + "$ref": "BackupRun", + "description": "Information about the last backup attempt for this database" + }, + "product": { + "$ref": "Product" + }, + "resourceId": { + "$ref": "DatabaseResourceId" + }, + "resourceName": { + "description": "Required. internal resource name for spanner this will be database name e.g.\"spanner.googleapis.com/projects/123/abc/instances/inst1/databases/db1\"", + "type": "string" + } + }, + "type": "object" + }, "ListClustersResponse": { "description": "Response for ListClusters.", "id": "ListClustersResponse", @@ -2787,6 +2855,26 @@ }, "type": "object" }, + "Membership": { + "description": "An output only view of all the member clusters participating in the cross cluster replication.", + "id": "Membership", + "properties": { + "primaryCluster": { + "$ref": "RemoteCluster", + "description": "Output only. The primary cluster that acts as the source of replication for the secondary clusters.", + "readOnly": true + }, + "secondaryClusters": { + "description": "Output only. The list of secondary clusters replicating from the primary cluster.", + "items": { + "$ref": "RemoteCluster" + }, + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, "NodeInfo": { "description": "Node specific properties.", "id": "NodeInfo", @@ -3057,7 +3145,9 @@ "ENGINE_CLOUD_SPANNER_WITH_GOOGLESQL_DIALECT", "ENGINE_MEMORYSTORE_FOR_REDIS", "ENGINE_MEMORYSTORE_FOR_REDIS_CLUSTER", - "ENGINE_OTHER" + "ENGINE_OTHER", + "ENGINE_FIRESTORE_WITH_NATIVE_MODE", + "ENGINE_FIRESTORE_WITH_DATASTORE_MODE" ], "enumDeprecated": [ false, @@ -3073,6 +3163,8 @@ false, false, false, + false, + false, false ], "enumDescriptions": [ @@ -3089,7 +3181,9 @@ "Cloud Spanner with Google SQL dialect.", "Memorystore with Redis dialect.", "Memorystore with Redis cluster dialect.", - "Other refers to rest of other database engine. This is to be when engine is known, but it is not present in this enum." + "Other refers to rest of other database engine. This is to be when engine is known, but it is not present in this enum.", + "Firestore with native mode.", + "Firestore with datastore mode." ], "type": "string" }, @@ -3106,7 +3200,8 @@ "ON_PREM", "PRODUCT_TYPE_MEMORYSTORE", "PRODUCT_TYPE_BIGTABLE", - "PRODUCT_TYPE_OTHER" + "PRODUCT_TYPE_OTHER", + "PRODUCT_TYPE_FIRESTORE" ], "enumDeprecated": [ false, @@ -3119,6 +3214,7 @@ true, false, false, + false, false ], "enumDescriptions": [ @@ -3132,7 +3228,8 @@ "On premises database product.", "Memorystore product area in GCP", "Bigtable product area in GCP", - "Other refers to rest of other product type. This is to be when product type is known, but it is not present in this enum." + "Other refers to rest of other product type. This is to be when product type is known, but it is not present in this enum.", + "Firestore product area in GCP." ], "type": "string" }, @@ -3245,6 +3342,22 @@ }, "type": "object" }, + "RemoteCluster": { + "description": "Details of the remote cluster associated with this cluster in a cross cluster replication setup.", + "id": "RemoteCluster", + "properties": { + "cluster": { + "description": "The full resource path of the remote cluster in the format: projects//locations//clusters/", + "type": "string" + }, + "uid": { + "description": "Output only. The unique identifier of the remote cluster.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "RescheduleMaintenanceRequest": { "description": "Request for RescheduleMaintenance.", "id": "RescheduleMaintenanceRequest", diff --git a/redis/v1beta1/redis-gen.go b/redis/v1beta1/redis-gen.go index c3a5b40177f..ab078697e2d 100644 --- a/redis/v1beta1/redis-gen.go +++ b/redis/v1beta1/redis-gen.go @@ -409,6 +409,8 @@ type Cluster struct { // CreateTime: Output only. The timestamp associated with the cluster creation // request. CreateTime string `json:"createTime,omitempty"` + // CrossClusterReplicationConfig: Optional. Cross cluster replication config. + CrossClusterReplicationConfig *CrossClusterReplicationConfig `json:"crossClusterReplicationConfig,omitempty"` // DeletionProtectionEnabled: Optional. The delete operation will fail when the // value is set to true. DeletionProtectionEnabled bool `json:"deletionProtectionEnabled,omitempty"` @@ -447,7 +449,7 @@ type Cluster struct { RedisConfigs map[string]string `json:"redisConfigs,omitempty"` // ReplicaCount: Optional. The number of replica nodes per shard. ReplicaCount int64 `json:"replicaCount,omitempty"` - // ShardCount: Required. Number of shards for the Redis cluster. + // ShardCount: Optional. Number of shards for the Redis cluster. ShardCount int64 `json:"shardCount,omitempty"` // SizeGb: Output only. Redis memory size in GB for the entire cluster rounded // up to the next integer. @@ -574,58 +576,84 @@ func (s Compliance) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// CustomMetadataData: Any custom metadata associated with the resource. i.e. A -// spanner instance can have multiple databases with its own unique metadata. -// Information for these individual databases can be captured in custom -// metadata data -type CustomMetadataData struct { - DatabaseMetadata []*DatabaseMetadata `json:"databaseMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "DatabaseMetadata") to +// CrossClusterReplicationConfig: Cross cluster replication config. +type CrossClusterReplicationConfig struct { + // ClusterRole: The role of the cluster in cross cluster replication. + // + // Possible values: + // "CLUSTER_ROLE_UNSPECIFIED" - Cluster role is not set. The behavior is + // equivalent to NONE. + // "NONE" - This cluster does not participate in cross cluster replication. + // It is an independent cluster and does not replicate to or from any other + // clusters. + // "PRIMARY" - A cluster that allows both reads and writes. Any data written + // to this cluster is also replicated to the attached secondary clusters. + // "SECONDARY" - A cluster that allows only reads and replicates data from a + // primary cluster. + ClusterRole string `json:"clusterRole,omitempty"` + // Membership: Output only. An output only view of all the member clusters + // participating in the cross cluster replication. This view will be provided + // by every member cluster irrespective of its cluster role(primary or + // secondary). A primary cluster can provide information about all the + // secondary clusters replicating from it. However, a secondary cluster only + // knows about the primary cluster from which it is replicating. However, for + // scenarios, where the primary cluster is unavailable(e.g. regional outage), a + // GetCluster request can be sent to any other member cluster and this field + // will list all the member clusters participating in cross cluster + // replication. + Membership *Membership `json:"membership,omitempty"` + // PrimaryCluster: Details of the primary cluster that is used as the + // replication source for this secondary cluster. This field is only set for a + // secondary cluster. + PrimaryCluster *RemoteCluster `json:"primaryCluster,omitempty"` + // SecondaryClusters: List of secondary clusters that are replicating from this + // primary cluster. This field is only set for a primary cluster. + SecondaryClusters []*RemoteCluster `json:"secondaryClusters,omitempty"` + // UpdateTime: Output only. The last time cross cluster replication config was + // updated. + UpdateTime string `json:"updateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "ClusterRole") 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. "DatabaseMetadata") 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. "ClusterRole") 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 CustomMetadataData) MarshalJSON() ([]byte, error) { - type NoMethod CustomMetadataData +func (s CrossClusterReplicationConfig) MarshalJSON() ([]byte, error) { + type NoMethod CrossClusterReplicationConfig return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// DatabaseMetadata: Metadata for individual databases created in an instance. -// i.e. spanner instance can have multiple databases with unique configuration -// settings. -type DatabaseMetadata struct { - // BackupConfiguration: Backup configuration for this database - BackupConfiguration *BackupConfiguration `json:"backupConfiguration,omitempty"` - // BackupRun: Information about the last backup attempt for this database - BackupRun *BackupRun `json:"backupRun,omitempty"` - Product *Product `json:"product,omitempty"` - ResourceId *DatabaseResourceId `json:"resourceId,omitempty"` - // ResourceName: Required. Database name. Resource name to follow CAIS - // resource_name format as noted here go/condor-common-datamodel - ResourceName string `json:"resourceName,omitempty"` - // ForceSendFields is a list of field names (e.g. "BackupConfiguration") to - // unconditionally include in API requests. By default, fields with empty or +// CustomMetadataData: Any custom metadata associated with the resource. e.g. A +// spanner instance can have multiple databases with its own unique metadata. +// Information for these individual databases can be captured in custom +// metadata data +type CustomMetadataData struct { + // InternalResourceMetadata: Metadata for individual internal resources in an + // instance. e.g. spanner instance can have multiple databases with unique + // configuration. + InternalResourceMetadata []*InternalResourceMetadata `json:"internalResourceMetadata,omitempty"` + // ForceSendFields is a list of field names (e.g. "InternalResourceMetadata") + // 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. "BackupConfiguration") 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. "InternalResourceMetadata") 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 DatabaseMetadata) MarshalJSON() ([]byte, error) { - type NoMethod DatabaseMetadata +func (s CustomMetadataData) MarshalJSON() ([]byte, error) { + type NoMethod CustomMetadataData return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } @@ -736,6 +764,22 @@ type DatabaseResourceHealthSignalData struct { // SignalId: Required. Unique identifier for the signal. This is an unique id // which would be mainatined by partner to identify a signal. SignalId string `json:"signalId,omitempty"` + // SignalSeverity: The severity of the signal, such as if it's a HIGH or LOW + // severity. + // + // Possible values: + // "SIGNAL_SEVERITY_UNSPECIFIED" - This value is used for findings when a + // source doesn't write a severity value. + // "CRITICAL" - A critical vulnerability is easily discoverable by an + // external actor, exploitable. + // "HIGH" - A high risk vulnerability can be easily discovered and exploited + // in combination with other vulnerabilities. + // "MEDIUM" - A medium risk vulnerability could be used by an actor to gain + // access to resources or privileges that enable them to eventually gain access + // and the ability to execute arbitrary code or exfiltrate data. + // "LOW" - A low risk vulnerability hampers a security organization's ability + // to detect vulnerabilities or active threats in their deployment. + SignalSeverity string `json:"signalSeverity,omitempty"` // SignalType: Required. Type of signal, for example, // `AVAILABLE_IN_MULTIPLE_ZONES`, `LOGGING_MOST_ERRORS`, etc. // @@ -973,8 +1017,10 @@ type DatabaseResourceId struct { // ResourceType: Required. The type of resource this ID is identifying. Ex // redis.googleapis.com/Instance, redis.googleapis.com/Cluster, // alloydb.googleapis.com/Cluster, alloydb.googleapis.com/Instance, - // spanner.googleapis.com/Instance REQUIRED Please refer - // go/condor-common-datamodel + // spanner.googleapis.com/Instance, spanner.googleapis.com/Database, + // firestore.googleapis.com/Database, sqladmin.googleapis.com/Instance, + // bigtableadmin.googleapis.com/Cluster, bigtableadmin.googleapis.com/Instance + // REQUIRED Please refer go/condor-common-datamodel ResourceType string `json:"resourceType,omitempty"` // UniqueId: Required. A service-local token that distinguishes this resource // from other resources within the same service. @@ -1879,6 +1925,39 @@ func (s InstanceAuthString) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// InternalResourceMetadata: Metadata for individual internal resources in an +// instance. e.g. spanner instance can have multiple databases with unique +// configuration settings. Similarly bigtable can have multiple clusters within +// same bigtable instance. +type InternalResourceMetadata struct { + // BackupConfiguration: Backup configuration for this database + BackupConfiguration *BackupConfiguration `json:"backupConfiguration,omitempty"` + // BackupRun: Information about the last backup attempt for this database + BackupRun *BackupRun `json:"backupRun,omitempty"` + Product *Product `json:"product,omitempty"` + ResourceId *DatabaseResourceId `json:"resourceId,omitempty"` + // ResourceName: Required. internal resource name for spanner this will be + // database name + // e.g."spanner.googleapis.com/projects/123/abc/instances/inst1/databases/db1" + ResourceName string `json:"resourceName,omitempty"` + // ForceSendFields is a list of field names (e.g. "BackupConfiguration") 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. "BackupConfiguration") 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 InternalResourceMetadata) MarshalJSON() ([]byte, error) { + type NoMethod InternalResourceMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ListClustersResponse: Response for ListClusters. type ListClustersResponse struct { // Clusters: A list of Redis clusters in the project in the specified location, @@ -2163,6 +2242,33 @@ func (s ManagedCertificateAuthority) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// Membership: An output only view of all the member clusters participating in +// the cross cluster replication. +type Membership struct { + // PrimaryCluster: Output only. The primary cluster that acts as the source of + // replication for the secondary clusters. + PrimaryCluster *RemoteCluster `json:"primaryCluster,omitempty"` + // SecondaryClusters: Output only. The list of secondary clusters replicating + // from the primary cluster. + SecondaryClusters []*RemoteCluster `json:"secondaryClusters,omitempty"` + // ForceSendFields is a list of field names (e.g. "PrimaryCluster") 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. "PrimaryCluster") 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 Membership) MarshalJSON() ([]byte, error) { + type NoMethod Membership + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // NodeInfo: Node specific properties. type NodeInfo struct { // Id: Output only. Node identifying string. e.g. 'node-0', 'node-1' @@ -2460,6 +2566,8 @@ type Product struct { // dialect. // "ENGINE_OTHER" - Other refers to rest of other database engine. This is to // be when engine is known, but it is not present in this enum. + // "ENGINE_FIRESTORE_WITH_NATIVE_MODE" - Firestore with native mode. + // "ENGINE_FIRESTORE_WITH_DATASTORE_MODE" - Firestore with datastore mode. Engine string `json:"engine,omitempty"` // Type: Type of specific database product. It could be CloudSQL, AlloyDB etc.. // @@ -2477,6 +2585,7 @@ type Product struct { // "PRODUCT_TYPE_BIGTABLE" - Bigtable product area in GCP // "PRODUCT_TYPE_OTHER" - Other refers to rest of other product type. This is // to be when product type is known, but it is not present in this enum. + // "PRODUCT_TYPE_FIRESTORE" - Firestore product area in GCP. Type string `json:"type,omitempty"` // Version: Version of the underlying database engine. Example values: For // MySQL, it could be "8.0", "5.7" etc.. For Postgres, it could be "14", "15" @@ -2627,6 +2736,32 @@ func (s ReconciliationOperationMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// RemoteCluster: Details of the remote cluster associated with this cluster in +// a cross cluster replication setup. +type RemoteCluster struct { + // Cluster: The full resource path of the remote cluster in the format: + // projects//locations//clusters/ + Cluster string `json:"cluster,omitempty"` + // Uid: Output only. The unique identifier of the remote cluster. + Uid string `json:"uid,omitempty"` + // ForceSendFields is a list of field names (e.g. "Cluster") 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. "Cluster") 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 RemoteCluster) MarshalJSON() ([]byte, error) { + type NoMethod RemoteCluster + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // RescheduleMaintenanceRequest: Request for RescheduleMaintenance. type RescheduleMaintenanceRequest struct { // RescheduleType: Required. If reschedule type is SPECIFIC_TIME, must set up diff --git a/retail/v2/retail-api.json b/retail/v2/retail-api.json index e86502f43e1..c0cc07351e2 100644 --- a/retail/v2/retail-api.json +++ b/retail/v2/retail-api.json @@ -2092,7 +2092,7 @@ } } }, - "revision": "20240801", + "revision": "20240816", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -4641,7 +4641,7 @@ "id": "GoogleCloudRetailV2RuleForceReturnFacetAction", "properties": { "facetPositionAdjustments": { - "description": "Each instance corresponds to a force return attribute for the given condition. There can't be more 3 instances here.", + "description": "Each instance corresponds to a force return attribute for the given condition. There can't be more 15 instances here.", "items": { "$ref": "GoogleCloudRetailV2RuleForceReturnFacetActionFacetPositionAdjustment" }, diff --git a/retail/v2/retail-gen.go b/retail/v2/retail-gen.go index 1bd94aea2b9..06a0ac8a343 100644 --- a/retail/v2/retail-gen.go +++ b/retail/v2/retail-gen.go @@ -4355,7 +4355,7 @@ func (s GoogleCloudRetailV2RuleFilterAction) MarshalJSON() ([]byte, error) { // current rank. type GoogleCloudRetailV2RuleForceReturnFacetAction struct { // FacetPositionAdjustments: Each instance corresponds to a force return - // attribute for the given condition. There can't be more 3 instances here. + // attribute for the given condition. There can't be more 15 instances here. FacetPositionAdjustments []*GoogleCloudRetailV2RuleForceReturnFacetActionFacetPositionAdjustment `json:"facetPositionAdjustments,omitempty"` // ForceSendFields is a list of field names (e.g. "FacetPositionAdjustments") // to unconditionally include in API requests. By default, fields with empty or diff --git a/retail/v2alpha/retail-api.json b/retail/v2alpha/retail-api.json index 8572689cf8a..ab031b58c94 100644 --- a/retail/v2alpha/retail-api.json +++ b/retail/v2alpha/retail-api.json @@ -2613,7 +2613,7 @@ } } }, - "revision": "20240801", + "revision": "20240816", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -6494,7 +6494,7 @@ "id": "GoogleCloudRetailV2alphaRuleForceReturnFacetAction", "properties": { "facetPositionAdjustments": { - "description": "Each instance corresponds to a force return attribute for the given condition. There can't be more 3 instances here.", + "description": "Each instance corresponds to a force return attribute for the given condition. There can't be more 15 instances here.", "items": { "$ref": "GoogleCloudRetailV2alphaRuleForceReturnFacetActionFacetPositionAdjustment" }, diff --git a/retail/v2alpha/retail-gen.go b/retail/v2alpha/retail-gen.go index ff42ee52377..c007b65b331 100644 --- a/retail/v2alpha/retail-gen.go +++ b/retail/v2alpha/retail-gen.go @@ -6389,7 +6389,7 @@ func (s GoogleCloudRetailV2alphaRuleFilterAction) MarshalJSON() ([]byte, error) // current rank. type GoogleCloudRetailV2alphaRuleForceReturnFacetAction struct { // FacetPositionAdjustments: Each instance corresponds to a force return - // attribute for the given condition. There can't be more 3 instances here. + // attribute for the given condition. There can't be more 15 instances here. FacetPositionAdjustments []*GoogleCloudRetailV2alphaRuleForceReturnFacetActionFacetPositionAdjustment `json:"facetPositionAdjustments,omitempty"` // ForceSendFields is a list of field names (e.g. "FacetPositionAdjustments") // to unconditionally include in API requests. By default, fields with empty or diff --git a/retail/v2beta/retail-api.json b/retail/v2beta/retail-api.json index cb388d27240..280bbb06b7d 100644 --- a/retail/v2beta/retail-api.json +++ b/retail/v2beta/retail-api.json @@ -2237,7 +2237,7 @@ } } }, - "revision": "20240801", + "revision": "20240816", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -6442,7 +6442,7 @@ "id": "GoogleCloudRetailV2betaRuleForceReturnFacetAction", "properties": { "facetPositionAdjustments": { - "description": "Each instance corresponds to a force return attribute for the given condition. There can't be more 3 instances here.", + "description": "Each instance corresponds to a force return attribute for the given condition. There can't be more 15 instances here.", "items": { "$ref": "GoogleCloudRetailV2betaRuleForceReturnFacetActionFacetPositionAdjustment" }, diff --git a/retail/v2beta/retail-gen.go b/retail/v2beta/retail-gen.go index 0a01ea1c9ab..d2f45ddf02d 100644 --- a/retail/v2beta/retail-gen.go +++ b/retail/v2beta/retail-gen.go @@ -6761,7 +6761,7 @@ func (s GoogleCloudRetailV2betaRuleFilterAction) MarshalJSON() ([]byte, error) { // current rank. type GoogleCloudRetailV2betaRuleForceReturnFacetAction struct { // FacetPositionAdjustments: Each instance corresponds to a force return - // attribute for the given condition. There can't be more 3 instances here. + // attribute for the given condition. There can't be more 15 instances here. FacetPositionAdjustments []*GoogleCloudRetailV2betaRuleForceReturnFacetActionFacetPositionAdjustment `json:"facetPositionAdjustments,omitempty"` // ForceSendFields is a list of field names (e.g. "FacetPositionAdjustments") // to unconditionally include in API requests. By default, fields with empty or diff --git a/run/v2/run-api.json b/run/v2/run-api.json index b45bfb60e6a..67483f7a1ca 100644 --- a/run/v2/run-api.json +++ b/run/v2/run-api.json @@ -416,6 +416,38 @@ } }, "resources": { + "builds": { + "methods": { + "submit": { + "description": "Submits a build in a given project.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/builds:submit", + "httpMethod": "POST", + "id": "run.projects.locations.builds.submit", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The project and location to build in. Location must be a region, e.g., 'us-central1' or 'global' if the global builder is to be used. Format: projects/{project}/locations/{location}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+parent}/builds:submit", + "request": { + "$ref": "GoogleCloudRunV2SubmitBuildRequest" + }, + "response": { + "$ref": "GoogleCloudRunV2SubmitBuildResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "jobs": { "methods": { "create": { @@ -1494,7 +1526,7 @@ } } }, - "revision": "20240802", + "revision": "20240809", "rootUrl": "https://run.googleapis.com/", "schemas": { "GoogleCloudRunV2BinaryAuthorization": { @@ -1516,6 +1548,41 @@ }, "type": "object" }, + "GoogleCloudRunV2BuildpacksBuild": { + "description": "Build the source using Buildpacks.", + "id": "GoogleCloudRunV2BuildpacksBuild", + "properties": { + "baseImage": { + "description": "Optional. The base image used to opt into automatic base image updates.", + "type": "string" + }, + "cacheImageUri": { + "description": "Optional. cache_image_uri is the GCR/AR URL where the cache image will be stored. cache_image_uri is optional and omitting it will disable caching. This URL must be stable across builds. It is used to derive a build-specific temporary URL by substituting the tag with the build ID. The build will clean up the temporary image on a best-effort basis.", + "type": "string" + }, + "enableAutomaticUpdates": { + "description": "Optional. Whether or not the application container will be enrolled in automatic base image updates. When true, the application will be built on a scratch base image, so the base layers can be appended at run time.", + "type": "boolean" + }, + "environmentVariables": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. User-provided build-time environment variables.", + "type": "object" + }, + "functionTarget": { + "description": "Optional. Name of the function target if the source is a function source. Required for function builds.", + "type": "string" + }, + "runtime": { + "deprecated": true, + "description": "The runtime name, e.g. 'go113'. Leave blank for generic builds.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudRunV2CancelExecutionRequest": { "description": "Request message for deleting an Execution.", "id": "GoogleCloudRunV2CancelExecutionRequest", @@ -1812,6 +1879,12 @@ }, "type": "object" }, + "GoogleCloudRunV2DockerBuild": { + "description": "Build the source using Docker. This means the source has a Dockerfile.", + "id": "GoogleCloudRunV2DockerBuild", + "properties": {}, + "type": "object" + }, "GoogleCloudRunV2EmptyDirVolumeSource": { "description": "In memory (tmpfs) ephemeral storage. It is ephemeral in the sense that when the sandbox is taken down, the data is destroyed with it (it does not persist across sandbox runs).", "id": "GoogleCloudRunV2EmptyDirVolumeSource", @@ -1844,7 +1917,7 @@ "type": "string" }, "value": { - "description": "Variable references $(VAR_NAME) are expanded using the previous defined environment variables in the container and any route environment variables. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not. Defaults to \"\", and the maximum length is 32768 bytes.", + "description": "Literal value of the environment variable. Defaults to \"\", and the maximum length is 32768 bytes. Variable references are not supported in Cloud Run.", "type": "string" }, "valueSource": { @@ -3321,6 +3394,79 @@ }, "type": "object" }, + "GoogleCloudRunV2StorageSource": { + "description": "Location of the source in an archive file in Google Cloud Storage.", + "id": "GoogleCloudRunV2StorageSource", + "properties": { + "bucket": { + "description": "Required. Google Cloud Storage bucket containing the source (see [Bucket Name Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).", + "type": "string" + }, + "generation": { + "description": "Optional. Google Cloud Storage generation for the object. If the generation is omitted, the latest generation will be used.", + "format": "int64", + "type": "string" + }, + "object": { + "description": "Required. Google Cloud Storage object containing the source. This object must be a gzipped archive file (`.tar.gz`) containing source to build.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudRunV2SubmitBuildRequest": { + "description": "Request message for submitting a Build.", + "id": "GoogleCloudRunV2SubmitBuildRequest", + "properties": { + "buildpackBuild": { + "$ref": "GoogleCloudRunV2BuildpacksBuild", + "description": "Build the source using Buildpacks." + }, + "dockerBuild": { + "$ref": "GoogleCloudRunV2DockerBuild", + "description": "Build the source using Docker. This means the source has a Dockerfile." + }, + "imageUri": { + "description": "Required. Artifact Registry URI to store the built image.", + "type": "string" + }, + "serviceAccount": { + "description": "Optional. The service account to use for the build. If not set, the default Cloud Build service account for the project will be used.", + "type": "string" + }, + "storageSource": { + "$ref": "GoogleCloudRunV2StorageSource", + "description": "Required. Source for the build." + }, + "tags": { + "description": "Optional. Additional tags to annotate the build.", + "items": { + "type": "string" + }, + "type": "array" + }, + "workerPool": { + "description": "Optional. Name of the Cloud Build Custom Worker Pool that should be used to build the function. The format of this field is `projects/{project}/locations/{region}/workerPools/{workerPool}` where {project} and {region} are the project id and region respectively where the worker pool is defined and {workerPool} is the short name of the worker pool.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudRunV2SubmitBuildResponse": { + "description": "Response message for submitting a Build.", + "id": "GoogleCloudRunV2SubmitBuildResponse", + "properties": { + "baseImageUri": { + "description": "URI of the base builder image in Artifact Registry being used in the build. Used to opt into automatic base image updates.", + "type": "string" + }, + "buildOperation": { + "$ref": "GoogleLongrunningOperation", + "description": "Cloud Build operation to be polled via CloudBuild API." + } + }, + "type": "object" + }, "GoogleCloudRunV2TCPSocketAction": { "description": "TCPSocketAction describes an action based on opening a socket", "id": "GoogleCloudRunV2TCPSocketAction", diff --git a/run/v2/run-gen.go b/run/v2/run-gen.go index 1c12e78e19f..2e2d48c1ec1 100644 --- a/run/v2/run-gen.go +++ b/run/v2/run-gen.go @@ -168,6 +168,7 @@ type ProjectsService struct { func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { rs := &ProjectsLocationsService{s: s} + rs.Builds = NewProjectsLocationsBuildsService(s) rs.Jobs = NewProjectsLocationsJobsService(s) rs.Operations = NewProjectsLocationsOperationsService(s) rs.Services = NewProjectsLocationsServicesService(s) @@ -177,6 +178,8 @@ func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { type ProjectsLocationsService struct { s *Service + Builds *ProjectsLocationsBuildsService + Jobs *ProjectsLocationsJobsService Operations *ProjectsLocationsOperationsService @@ -184,6 +187,15 @@ type ProjectsLocationsService struct { Services *ProjectsLocationsServicesService } +func NewProjectsLocationsBuildsService(s *Service) *ProjectsLocationsBuildsService { + rs := &ProjectsLocationsBuildsService{s: s} + return rs +} + +type ProjectsLocationsBuildsService struct { + s *Service +} + func NewProjectsLocationsJobsService(s *Service) *ProjectsLocationsJobsService { rs := &ProjectsLocationsJobsService{s: s} rs.Executions = NewProjectsLocationsJobsExecutionsService(s) @@ -279,6 +291,48 @@ func (s GoogleCloudRunV2BinaryAuthorization) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudRunV2BuildpacksBuild: Build the source using Buildpacks. +type GoogleCloudRunV2BuildpacksBuild struct { + // BaseImage: Optional. The base image used to opt into automatic base image + // updates. + BaseImage string `json:"baseImage,omitempty"` + // CacheImageUri: Optional. cache_image_uri is the GCR/AR URL where the cache + // image will be stored. cache_image_uri is optional and omitting it will + // disable caching. This URL must be stable across builds. It is used to derive + // a build-specific temporary URL by substituting the tag with the build ID. + // The build will clean up the temporary image on a best-effort basis. + CacheImageUri string `json:"cacheImageUri,omitempty"` + // EnableAutomaticUpdates: Optional. Whether or not the application container + // will be enrolled in automatic base image updates. When true, the application + // will be built on a scratch base image, so the base layers can be appended at + // run time. + EnableAutomaticUpdates bool `json:"enableAutomaticUpdates,omitempty"` + // EnvironmentVariables: Optional. User-provided build-time environment + // variables. + EnvironmentVariables map[string]string `json:"environmentVariables,omitempty"` + // FunctionTarget: Optional. Name of the function target if the source is a + // function source. Required for function builds. + FunctionTarget string `json:"functionTarget,omitempty"` + // Runtime: The runtime name, e.g. 'go113'. Leave blank for generic builds. + Runtime string `json:"runtime,omitempty"` + // ForceSendFields is a list of field names (e.g. "BaseImage") 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. "BaseImage") 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 GoogleCloudRunV2BuildpacksBuild) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRunV2BuildpacksBuild + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudRunV2CancelExecutionRequest: Request message for deleting an // Execution. type GoogleCloudRunV2CancelExecutionRequest struct { @@ -567,6 +621,11 @@ func (s GoogleCloudRunV2ContainerPort) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudRunV2DockerBuild: Build the source using Docker. This means the +// source has a Dockerfile. +type GoogleCloudRunV2DockerBuild struct { +} + // GoogleCloudRunV2EmptyDirVolumeSource: In memory (tmpfs) ephemeral storage. // It is ephemeral in the sense that when the sandbox is taken down, the data // is destroyed with it (it does not persist across sandbox runs). @@ -613,13 +672,9 @@ type GoogleCloudRunV2EnvVar struct { // Name: Required. Name of the environment variable. Must not exceed 32768 // characters. Name string `json:"name,omitempty"` - // Value: Variable references $(VAR_NAME) are expanded using the previous - // defined environment variables in the container and any route environment - // variables. If a variable cannot be resolved, the reference in the input - // string will be unchanged. The $(VAR_NAME) syntax can be escaped with a - // double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, - // regardless of whether the variable exists or not. Defaults to "", and the - // maximum length is 32768 bytes. + // Value: Literal value of the environment variable. Defaults to "", and the + // maximum length is 32768 bytes. Variable references are not supported in + // Cloud Run. Value string `json:"value,omitempty"` // ValueSource: Source for the environment variable's value. ValueSource *GoogleCloudRunV2EnvVarSource `json:"valueSource,omitempty"` @@ -2351,6 +2406,108 @@ func (s GoogleCloudRunV2ServiceScaling) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudRunV2StorageSource: Location of the source in an archive file in +// Google Cloud Storage. +type GoogleCloudRunV2StorageSource struct { + // Bucket: Required. Google Cloud Storage bucket containing the source (see + // Bucket Name Requirements + // (https://cloud.google.com/storage/docs/bucket-naming#requirements)). + Bucket string `json:"bucket,omitempty"` + // Generation: Optional. Google Cloud Storage generation for the object. If the + // generation is omitted, the latest generation will be used. + Generation int64 `json:"generation,omitempty,string"` + // Object: Required. Google Cloud Storage object containing the source. This + // object must be a gzipped archive file (`.tar.gz`) containing source to + // build. + Object string `json:"object,omitempty"` + // ForceSendFields is a list of field names (e.g. "Bucket") 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. "Bucket") 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 GoogleCloudRunV2StorageSource) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRunV2StorageSource + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRunV2SubmitBuildRequest: Request message for submitting a Build. +type GoogleCloudRunV2SubmitBuildRequest struct { + // BuildpackBuild: Build the source using Buildpacks. + BuildpackBuild *GoogleCloudRunV2BuildpacksBuild `json:"buildpackBuild,omitempty"` + // DockerBuild: Build the source using Docker. This means the source has a + // Dockerfile. + DockerBuild *GoogleCloudRunV2DockerBuild `json:"dockerBuild,omitempty"` + // ImageUri: Required. Artifact Registry URI to store the built image. + ImageUri string `json:"imageUri,omitempty"` + // ServiceAccount: Optional. The service account to use for the build. If not + // set, the default Cloud Build service account for the project will be used. + ServiceAccount string `json:"serviceAccount,omitempty"` + // StorageSource: Required. Source for the build. + StorageSource *GoogleCloudRunV2StorageSource `json:"storageSource,omitempty"` + // Tags: Optional. Additional tags to annotate the build. + Tags []string `json:"tags,omitempty"` + // WorkerPool: Optional. Name of the Cloud Build Custom Worker Pool that should + // be used to build the function. The format of this field is + // `projects/{project}/locations/{region}/workerPools/{workerPool}` where + // {project} and {region} are the project id and region respectively where the + // worker pool is defined and {workerPool} is the short name of the worker + // pool. + WorkerPool string `json:"workerPool,omitempty"` + // ForceSendFields is a list of field names (e.g. "BuildpackBuild") 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. "BuildpackBuild") 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 GoogleCloudRunV2SubmitBuildRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRunV2SubmitBuildRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRunV2SubmitBuildResponse: Response message for submitting a +// Build. +type GoogleCloudRunV2SubmitBuildResponse struct { + // BaseImageUri: URI of the base builder image in Artifact Registry being used + // in the build. Used to opt into automatic base image updates. + BaseImageUri string `json:"baseImageUri,omitempty"` + // BuildOperation: Cloud Build operation to be polled via CloudBuild API. + BuildOperation *GoogleLongrunningOperation `json:"buildOperation,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "BaseImageUri") 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. "BaseImageUri") 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 GoogleCloudRunV2SubmitBuildResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRunV2SubmitBuildResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudRunV2TCPSocketAction: TCPSocketAction describes an action based // on opening a socket type GoogleCloudRunV2TCPSocketAction struct { @@ -5361,6 +5518,110 @@ func (c *ProjectsLocationsExportProjectMetadataCall) Do(opts ...googleapi.CallOp return ret, nil } +type ProjectsLocationsBuildsSubmitCall struct { + s *Service + parent string + googlecloudrunv2submitbuildrequest *GoogleCloudRunV2SubmitBuildRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Submit: Submits a build in a given project. +// +// - parent: The project and location to build in. Location must be a region, +// e.g., 'us-central1' or 'global' if the global builder is to be used. +// Format: projects/{project}/locations/{location}. +func (r *ProjectsLocationsBuildsService) Submit(parent string, googlecloudrunv2submitbuildrequest *GoogleCloudRunV2SubmitBuildRequest) *ProjectsLocationsBuildsSubmitCall { + c := &ProjectsLocationsBuildsSubmitCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googlecloudrunv2submitbuildrequest = googlecloudrunv2submitbuildrequest + 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 *ProjectsLocationsBuildsSubmitCall) Fields(s ...googleapi.Field) *ProjectsLocationsBuildsSubmitCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsBuildsSubmitCall) Context(ctx context.Context) *ProjectsLocationsBuildsSubmitCall { + 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 *ProjectsLocationsBuildsSubmitCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBuildsSubmitCall) 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.googlecloudrunv2submitbuildrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+parent}/builds:submit") + 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 "run.projects.locations.builds.submit" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudRunV2SubmitBuildResponse.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 *ProjectsLocationsBuildsSubmitCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRunV2SubmitBuildResponse, 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 := &GoogleCloudRunV2SubmitBuildResponse{ + 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 ProjectsLocationsJobsCreateCall struct { s *Service parent string diff --git a/searchads360/v0/searchads360-api.json b/searchads360/v0/searchads360-api.json index 7ac13f7a467..54d6a06092a 100644 --- a/searchads360/v0/searchads360-api.json +++ b/searchads360/v0/searchads360-api.json @@ -260,7 +260,7 @@ } } }, - "revision": "20240414", + "revision": "20240808", "rootUrl": "https://searchads360.googleapis.com/", "schemas": { "GoogleAdsSearchads360V0Common__AdScheduleInfo": { @@ -346,6 +346,17 @@ }, "type": "object" }, + "GoogleAdsSearchads360V0Common__AdTextAsset": { + "description": "A text asset used inside an ad.", + "id": "GoogleAdsSearchads360V0Common__AdTextAsset", + "properties": { + "text": { + "description": "Asset text.", + "type": "string" + } + }, + "type": "object" + }, "GoogleAdsSearchads360V0Common__AgeRangeInfo": { "description": "An age range criterion.", "id": "GoogleAdsSearchads360V0Common__AgeRangeInfo", @@ -1012,6 +1023,11 @@ "format": "double", "type": "number" }, + "averageQualityScore": { + "description": "The average quality score.", + "format": "double", + "type": "number" + }, "clicks": { "description": "The number of clicks.", "format": "int64", @@ -1540,6 +1556,20 @@ "format": "int64", "type": "string" }, + "descriptions": { + "description": "List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.", + "items": { + "$ref": "GoogleAdsSearchads360V0Common__AdTextAsset" + }, + "type": "array" + }, + "headlines": { + "description": "List of text assets for headlines. When the ad serves the headlines will be selected from this list.", + "items": { + "$ref": "GoogleAdsSearchads360V0Common__AdTextAsset" + }, + "type": "array" + }, "path1": { "description": "Text appended to the auto-generated visible URL with a delimiter.", "type": "string" @@ -1738,6 +1768,27 @@ ], "type": "string" }, + "geoTargetCity": { + "description": "Resource name of the geo target constant that represents a city.", + "type": "string" + }, + "geoTargetCountry": { + "description": "Resource name of the geo target constant that represents a country.", + "type": "string" + }, + "geoTargetMetro": { + "description": "Resource name of the geo target constant that represents a metro.", + "type": "string" + }, + "geoTargetRegion": { + "description": "Resource name of the geo target constant that represents a region.", + "type": "string" + }, + "hour": { + "description": "Hour of day as a number between 0 and 23, inclusive.", + "format": "int32", + "type": "integer" + }, "keyword": { "$ref": "GoogleAdsSearchads360V0Common__Keyword", "description": "Keyword criterion." @@ -2144,7 +2195,7 @@ }, "targetSpendMicros": { "deprecated": true, - "description": "The spend target under which to maximize clicks. A TargetSpend bidder will attempt to spend the smaller of this value or the natural throttling spend amount. If not specified, the budget is used as the spend target. This field is deprecated and should no longer be used. See https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html for details.", + "description": "Deprecated: The spend target under which to maximize clicks. A TargetSpend bidder will attempt to spend the smaller of this value or the natural throttling spend amount. If not specified, the budget is used as the spend target. This field is deprecated and should no longer be used. See https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html for details.", "format": "int64", "type": "string" } @@ -2181,7 +2232,7 @@ "id": "GoogleAdsSearchads360V0Common__TextLabel", "properties": { "backgroundColor": { - "description": "Background color of the label in RGB format. This string must match the regular expression '^\\#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Note: The background color may not be visible for manager accounts.", + "description": "Background color of the label in HEX format. This string must match the regular expression '^\\#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Note: The background color may not be visible for manager accounts.", "type": "string" }, "description": { @@ -3032,7 +3083,7 @@ "type": "object" }, "GoogleAdsSearchads360V0Errors__SearchAds360Error": { - "description": "SearchAds360-specific error.", + "description": "Search Ads 360-specific error.", "id": "GoogleAdsSearchads360V0Errors__SearchAds360Error", "properties": { "details": { @@ -3893,7 +3944,8 @@ "DISCOVERY_MULTI_ASSET_AD", "DISCOVERY_CAROUSEL_AD", "TRAVEL_AD", - "DISCOVERY_VIDEO_RESPONSIVE_AD" + "DISCOVERY_VIDEO_RESPONSIVE_AD", + "MULTIMEDIA_AD" ], "enumDescriptions": [ "No value has been specified.", @@ -3929,7 +3981,8 @@ "Discovery multi asset ad.", "Discovery carousel ad.", "Travel ad.", - "Discovery video responsive ad." + "Discovery video responsive ad.", + "Multimedia ad." ], "readOnly": true, "type": "string" @@ -4145,7 +4198,7 @@ "type": "string" }, "engineId": { - "description": "Output only. ID of the ad in the external engine account. This field is for SearchAds 360 account only, for example, Yahoo Japan, Microsoft, Baidu etc. For non-SearchAds 360 entity, use \"ad_group_ad.ad.id\" instead.", + "description": "Output only. ID of the ad in the external engine account. This field is for Search Ads 360 account only, for example, Yahoo Japan, Microsoft, Baidu etc. For non-Search Ads 360 entity, use \"ad_group_ad.ad.id\" instead.", "readOnly": true, "type": "string" }, @@ -5512,7 +5565,8 @@ "VIDEO_SEQUENCE", "APP_CAMPAIGN_FOR_PRE_REGISTRATION", "VIDEO_REACH_TARGET_FREQUENCY", - "TRAVEL_ACTIVITIES" + "TRAVEL_ACTIVITIES", + "SOCIAL_FACEBOOK_TRACKING_ONLY" ], "enumDescriptions": [ "Not specified.", @@ -5535,7 +5589,8 @@ "Video campaigns with sequence video ads.", "App Campaign for pre registration, specialized for advertising mobile app pre-registration, that targets multiple advertising channels across Google Play, YouTube and Display Network.", "Video reach campaign with Target Frequency bidding strategy.", - "Travel Activities campaigns." + "Travel Activities campaigns.", + "Facebook tracking only social campaigns." ], "type": "string" }, @@ -5555,7 +5610,8 @@ "PERFORMANCE_MAX", "LOCAL_SERVICES", "DISCOVERY", - "TRAVEL" + "TRAVEL", + "SOCIAL" ], "enumDescriptions": [ "Not specified.", @@ -5571,7 +5627,8 @@ "Performance Max campaigns.", "Local services campaigns.", "Discovery campaigns.", - "Travel campaigns." + "Travel campaigns.", + "Social campaigns." ], "type": "string" }, @@ -6470,7 +6527,7 @@ "type": "string" }, "merchantId": { - "description": "Output only. The SearchAds360 inventory account ID containing the product that was clicked on. SearchAds360 generates this ID when you link an inventory account in SearchAds360.", + "description": "Output only. The Search Ads 360 inventory account ID containing the product that was clicked on. Search Ads 360 generates this ID when you link an inventory account in Search Ads 360.", "format": "int64", "readOnly": true, "type": "string" @@ -6535,7 +6592,7 @@ "type": "string" }, "visitId": { - "description": "Output only. The SearchAds360 visit ID that the conversion is attributed to.", + "description": "Output only. The Search Ads 360 visit ID that the conversion is attributed to.", "format": "int64", "readOnly": true, "type": "string" @@ -7327,6 +7384,11 @@ "description": "Immutable. Name of the resource. CustomerManagerLink resource names have the form: `customers/{customer_id}/customerManagerLinks/{manager_customer_id}~{manager_link_id}`", "type": "string" }, + "startTime": { + "description": "Output only. The timestamp when the CustomerManagerLink was created. The timestamp is in the customer's time zone and in \"yyyy-MM-dd HH:mm:ss\" format.", + "readOnly": true, + "type": "string" + }, "status": { "description": "Status of the link between the customer and the manager.", "enum": [ diff --git a/searchads360/v0/searchads360-gen.go b/searchads360/v0/searchads360-gen.go index 6b5c50ac636..17fa8d9443c 100644 --- a/searchads360/v0/searchads360-gen.go +++ b/searchads360/v0/searchads360-gen.go @@ -267,6 +267,28 @@ func (s GoogleAdsSearchads360V0Common__AdScheduleInfo) MarshalJSON() ([]byte, er return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleAdsSearchads360V0Common__AdTextAsset: A text asset used inside an ad. +type GoogleAdsSearchads360V0Common__AdTextAsset struct { + // Text: Asset text. + Text string `json:"text,omitempty"` + // ForceSendFields is a list of field names (e.g. "Text") 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. "Text") 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 GoogleAdsSearchads360V0Common__AdTextAsset) MarshalJSON() ([]byte, error) { + type NoMethod GoogleAdsSearchads360V0Common__AdTextAsset + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleAdsSearchads360V0Common__AgeRangeInfo: An age range criterion. type GoogleAdsSearchads360V0Common__AgeRangeInfo struct { // Type: Type of the age range. @@ -1035,6 +1057,8 @@ type GoogleAdsSearchads360V0Common__Metrics struct { // metrics_currency parameter at // https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause AverageCpm float64 `json:"averageCpm,omitempty"` + // AverageQualityScore: The average quality score. + AverageQualityScore float64 `json:"averageQualityScore,omitempty"` // Clicks: The number of clicks. Clicks int64 `json:"clicks,omitempty,string"` // ClientAccountConversions: The number of client account conversions. This @@ -1574,6 +1598,7 @@ func (s *GoogleAdsSearchads360V0Common__Metrics) UnmarshalJSON(data []byte) erro AverageCost gensupport.JSONFloat64 `json:"averageCost"` AverageCpc gensupport.JSONFloat64 `json:"averageCpc"` AverageCpm gensupport.JSONFloat64 `json:"averageCpm"` + AverageQualityScore gensupport.JSONFloat64 `json:"averageQualityScore"` ClientAccountConversions gensupport.JSONFloat64 `json:"clientAccountConversions"` ClientAccountConversionsValue gensupport.JSONFloat64 `json:"clientAccountConversionsValue"` ClientAccountCrossSellUnitsSold gensupport.JSONFloat64 `json:"clientAccountCrossSellUnitsSold"` @@ -1640,6 +1665,7 @@ func (s *GoogleAdsSearchads360V0Common__Metrics) UnmarshalJSON(data []byte) erro s.AverageCost = float64(s1.AverageCost) s.AverageCpc = float64(s1.AverageCpc) s.AverageCpm = float64(s1.AverageCpm) + s.AverageQualityScore = float64(s1.AverageQualityScore) s.ClientAccountConversions = float64(s1.ClientAccountConversions) s.ClientAccountConversionsValue = float64(s1.ClientAccountConversionsValue) s.ClientAccountCrossSellUnitsSold = float64(s1.ClientAccountCrossSellUnitsSold) @@ -1849,6 +1875,12 @@ type GoogleAdsSearchads360V0Common__SearchAds360ProductAdInfo struct { type GoogleAdsSearchads360V0Common__SearchAds360ResponsiveSearchAdInfo struct { // AdTrackingId: The tracking id of the ad. AdTrackingId int64 `json:"adTrackingId,omitempty,string"` + // Descriptions: List of text assets for descriptions. When the ad serves the + // descriptions will be selected from this list. + Descriptions []*GoogleAdsSearchads360V0Common__AdTextAsset `json:"descriptions,omitempty"` + // Headlines: List of text assets for headlines. When the ad serves the + // headlines will be selected from this list. + Headlines []*GoogleAdsSearchads360V0Common__AdTextAsset `json:"headlines,omitempty"` // Path1: Text appended to the auto-generated visible URL with a delimiter. Path1 string `json:"path1,omitempty"` // Path2: Text appended to path1 with a delimiter. @@ -2008,6 +2040,20 @@ type GoogleAdsSearchads360V0Common__Segments struct { // "CONNECTED_TV" - Smart TVs and game consoles. // "OTHER" - Other device types. Device string `json:"device,omitempty"` + // GeoTargetCity: Resource name of the geo target constant that represents a + // city. + GeoTargetCity string `json:"geoTargetCity,omitempty"` + // GeoTargetCountry: Resource name of the geo target constant that represents a + // country. + GeoTargetCountry string `json:"geoTargetCountry,omitempty"` + // GeoTargetMetro: Resource name of the geo target constant that represents a + // metro. + GeoTargetMetro string `json:"geoTargetMetro,omitempty"` + // GeoTargetRegion: Resource name of the geo target constant that represents a + // region. + GeoTargetRegion string `json:"geoTargetRegion,omitempty"` + // Hour: Hour of day as a number between 0 and 23, inclusive. + Hour int64 `json:"hour,omitempty"` // Keyword: Keyword criterion. Keyword *GoogleAdsSearchads360V0Common__Keyword `json:"keyword,omitempty"` // Month: Month as represented by the date of the first day of a month. @@ -2377,10 +2423,11 @@ type GoogleAdsSearchads360V0Common__TargetSpend struct { // CpcBidCeilingMicros: Maximum bid limit that can be set by the bid strategy. // The limit applies to all keywords managed by the strategy. CpcBidCeilingMicros int64 `json:"cpcBidCeilingMicros,omitempty,string"` - // TargetSpendMicros: The spend target under which to maximize clicks. A - // TargetSpend bidder will attempt to spend the smaller of this value or the - // natural throttling spend amount. If not specified, the budget is used as the - // spend target. This field is deprecated and should no longer be used. See + // TargetSpendMicros: Deprecated: The spend target under which to maximize + // clicks. A TargetSpend bidder will attempt to spend the smaller of this value + // or the natural throttling spend amount. If not specified, the budget is used + // as the spend target. This field is deprecated and should no longer be used. + // See // https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html // for details. TargetSpendMicros int64 `json:"targetSpendMicros,omitempty,string"` @@ -2453,7 +2500,7 @@ func (s GoogleAdsSearchads360V0Common__TextAsset) MarshalJSON() ([]byte, error) // GoogleAdsSearchads360V0Common__TextLabel: A type of label displaying text on // a colored background. type GoogleAdsSearchads360V0Common__TextLabel struct { - // BackgroundColor: Background color of the label in RGB format. This string + // BackgroundColor: Background color of the label in HEX format. This string // must match the regular expression '^\#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. // Note: The background color may not be visible for manager accounts. BackgroundColor string `json:"backgroundColor,omitempty"` @@ -3339,7 +3386,7 @@ func (s GoogleAdsSearchads360V0Errors__QuotaErrorDetails) MarshalJSON() ([]byte, return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleAdsSearchads360V0Errors__SearchAds360Error: SearchAds360-specific +// GoogleAdsSearchads360V0Errors__SearchAds360Error: Search Ads 360-specific // error. type GoogleAdsSearchads360V0Errors__SearchAds360Error struct { // Details: Additional error details, which are returned by certain error @@ -4481,6 +4528,7 @@ type GoogleAdsSearchads360V0Resources__Ad struct { // "DISCOVERY_CAROUSEL_AD" - Discovery carousel ad. // "TRAVEL_AD" - Travel ad. // "DISCOVERY_VIDEO_RESPONSIVE_AD" - Discovery video responsive ad. + // "MULTIMEDIA_AD" - Multimedia ad. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "DisplayUrl") to // unconditionally include in API requests. By default, fields with empty or @@ -4644,8 +4692,8 @@ type GoogleAdsSearchads360V0Resources__AdGroupAd struct { // HH:mm:ss.ssssss" format. CreationTime string `json:"creationTime,omitempty"` // EngineId: Output only. ID of the ad in the external engine account. This - // field is for SearchAds 360 account only, for example, Yahoo Japan, - // Microsoft, Baidu etc. For non-SearchAds 360 entity, use "ad_group_ad.ad.id" + // field is for Search Ads 360 account only, for example, Yahoo Japan, + // Microsoft, Baidu etc. For non-Search Ads 360 entity, use "ad_group_ad.ad.id" // instead. EngineId string `json:"engineId,omitempty"` // EngineStatus: Output only. Additional status of the ad in the external @@ -5915,6 +5963,7 @@ type GoogleAdsSearchads360V0Resources__Campaign struct { // "VIDEO_REACH_TARGET_FREQUENCY" - Video reach campaign with Target // Frequency bidding strategy. // "TRAVEL_ACTIVITIES" - Travel Activities campaigns. + // "SOCIAL_FACEBOOK_TRACKING_ONLY" - Facebook tracking only social campaigns. AdvertisingChannelSubType string `json:"advertisingChannelSubType,omitempty"` // AdvertisingChannelType: Immutable. The primary serving target for ads within // the campaign. The targeting options can be refined in `network_settings`. @@ -5941,6 +5990,7 @@ type GoogleAdsSearchads360V0Resources__Campaign struct { // "LOCAL_SERVICES" - Local services campaigns. // "DISCOVERY" - Discovery campaigns. // "TRAVEL" - Travel campaigns. + // "SOCIAL" - Social campaigns. AdvertisingChannelType string `json:"advertisingChannelType,omitempty"` // BiddingStrategy: Portfolio bidding strategy used by campaign. BiddingStrategy string `json:"biddingStrategy,omitempty"` @@ -6711,9 +6761,9 @@ type GoogleAdsSearchads360V0Resources__Conversion struct { FloodlightOriginalRevenue int64 `json:"floodlightOriginalRevenue,omitempty,string"` // Id: Output only. The ID of the conversion Id int64 `json:"id,omitempty,string"` - // MerchantId: Output only. The SearchAds360 inventory account ID containing - // the product that was clicked on. SearchAds360 generates this ID when you - // link an inventory account in SearchAds360. + // MerchantId: Output only. The Search Ads 360 inventory account ID containing + // the product that was clicked on. Search Ads 360 generates this ID when you + // link an inventory account in Search Ads 360. MerchantId int64 `json:"merchantId,omitempty,string"` // ProductChannel: Output only. The sales channel of the product that was // clicked on: Online or Local. @@ -6752,7 +6802,7 @@ type GoogleAdsSearchads360V0Resources__Conversion struct { // "ENABLED" - The conversion is enabled. // "REMOVED" - The conversion has been removed. Status string `json:"status,omitempty"` - // VisitId: Output only. The SearchAds360 visit ID that the conversion is + // VisitId: Output only. The Search Ads 360 visit ID that the conversion is // attributed to. VisitId int64 `json:"visitId,omitempty,string"` // ForceSendFields is a list of field names (e.g. "AdId") to unconditionally @@ -7467,6 +7517,10 @@ type GoogleAdsSearchads360V0Resources__CustomerManagerLink struct { // `customers/{customer_id}/customerManagerLinks/{manager_customer_id}~{manager_ // link_id}` ResourceName string `json:"resourceName,omitempty"` + // StartTime: Output only. The timestamp when the CustomerManagerLink was + // created. The timestamp is in the customer's time zone and in "yyyy-MM-dd + // HH:mm:ss" format. + StartTime string `json:"startTime,omitempty"` // Status: Status of the link between the customer and the manager. // // Possible values: diff --git a/securitycenter/v1/securitycenter-api.json b/securitycenter/v1/securitycenter-api.json index cde70d19cd3..76cf152c492 100644 --- a/securitycenter/v1/securitycenter-api.json +++ b/securitycenter/v1/securitycenter-api.json @@ -15,6 +15,13 @@ "description": "Security Command Center API provides access to temporal views of assets and findings within an organization.", "discoveryVersion": "v1", "documentationLink": "https://cloud.google.com/security-command-center", + "endpoints": [ + { + "description": "Regional Endpoint", + "endpointUrl": "https://securitycenter.me-central2.rep.googleapis.com/", + "location": "me-central2" + } + ], "fullyEncodeReservedExpansion": true, "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", @@ -6027,7 +6034,7 @@ } } }, - "revision": "20240806", + "revision": "20240809", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { diff --git a/securitycenter/v1beta1/securitycenter-api.json b/securitycenter/v1beta1/securitycenter-api.json index d9c964c1875..7cb1c9cb423 100644 --- a/securitycenter/v1beta1/securitycenter-api.json +++ b/securitycenter/v1beta1/securitycenter-api.json @@ -15,6 +15,13 @@ "description": "Security Command Center API provides access to temporal views of assets and findings within an organization.", "discoveryVersion": "v1", "documentationLink": "https://cloud.google.com/security-command-center", + "endpoints": [ + { + "description": "Regional Endpoint", + "endpointUrl": "https://securitycenter.me-central2.rep.googleapis.com/", + "location": "me-central2" + } + ], "fullyEncodeReservedExpansion": true, "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", @@ -896,7 +903,7 @@ } } }, - "revision": "20240806", + "revision": "20240809", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { diff --git a/securitycenter/v1beta2/securitycenter-api.json b/securitycenter/v1beta2/securitycenter-api.json index e71294b9a51..788f2fcff95 100644 --- a/securitycenter/v1beta2/securitycenter-api.json +++ b/securitycenter/v1beta2/securitycenter-api.json @@ -15,6 +15,13 @@ "description": "Security Command Center API provides access to temporal views of assets and findings within an organization.", "discoveryVersion": "v1", "documentationLink": "https://cloud.google.com/security-command-center", + "endpoints": [ + { + "description": "Regional Endpoint", + "endpointUrl": "https://securitycenter.me-central2.rep.googleapis.com/", + "location": "me-central2" + } + ], "fullyEncodeReservedExpansion": true, "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", @@ -1906,7 +1913,7 @@ } } }, - "revision": "20240806", + "revision": "20240809", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { diff --git a/serviceusage/v1/serviceusage-api.json b/serviceusage/v1/serviceusage-api.json index 74e89d1c2a2..e6b34e1bdf7 100644 --- a/serviceusage/v1/serviceusage-api.json +++ b/serviceusage/v1/serviceusage-api.json @@ -426,7 +426,7 @@ } } }, - "revision": "20240712", + "revision": "20240811", "rootUrl": "https://serviceusage.googleapis.com/", "schemas": { "AddEnableRulesMetadata": { @@ -488,6 +488,83 @@ }, "type": "object" }, + "Analysis": { + "description": "A message to group the analysis information.", + "id": "Analysis", + "properties": { + "analysis": { + "$ref": "AnalysisResult", + "description": "Output only. Analysis result of updating a policy.", + "readOnly": true + }, + "analysisType": { + "description": "Output only. The type of analysis.", + "enum": [ + "ANALYSIS_TYPE_UNSPECIFIED", + "ANALYSIS_TYPE_DEPENDENCY", + "ANALYSIS_TYPE_RESOURCE_USAGE" + ], + "enumDescriptions": [ + "Unspecified analysis type. Do not use.", + "The analysis of service dependencies.", + "The analysis of service resource usage." + ], + "readOnly": true, + "type": "string" + }, + "displayName": { + "description": "Output only. The user friendly display name of the analysis type. E.g. service dependency analysis, service resource usage analysis, etc.", + "readOnly": true, + "type": "string" + }, + "service": { + "description": "The names of the service that has analysis result of warnings or blockers. Example: `services/storage.googleapis.com`.", + "type": "string" + } + }, + "type": "object" + }, + "AnalysisResult": { + "description": "An analysis result including blockers and warnings.", + "id": "AnalysisResult", + "properties": { + "blockers": { + "description": "Blocking information that would prevent the policy changes at runtime.", + "items": { + "$ref": "Impact" + }, + "type": "array" + }, + "warnings": { + "description": "Warning information indicating that the policy changes might be unsafe, but will not block the changes at runtime.", + "items": { + "$ref": "Impact" + }, + "type": "array" + } + }, + "type": "object" + }, + "AnalyzeConsumerPolicyMetadata": { + "description": "Metadata for the `AnalyzeConsumerPolicy` method.", + "id": "AnalyzeConsumerPolicyMetadata", + "properties": {}, + "type": "object" + }, + "AnalyzeConsumerPolicyResponse": { + "description": "The response of analyzing a consumer policy update.", + "id": "AnalyzeConsumerPolicyResponse", + "properties": { + "analysis": { + "description": "The list of analyses returned from performing the intended policy update analysis. The analysis is grouped by service name and different analysis types. The empty analysis list means that the consumer policy can be updated without any warnings or blockers.", + "items": { + "$ref": "Analysis" + }, + "type": "array" + } + }, + "type": "object" + }, "Api": { "description": "Api is a light-weight descriptor for an API Interface. Interfaces are also described as \"protocol buffer services\" in some contexts, such as by the \"service\" keyword in a .proto file, but they are different from API Services, which represent a concrete implementation of an interface as opposed to simply a description of methods and bindings. They are also sometimes simply referred to as \"APIs\" in other contexts, such as the name of this message itself. See https://cloud.google.com/apis/design/glossary for detailed terminology.", "id": "Api", @@ -2020,6 +2097,31 @@ }, "type": "object" }, + "Impact": { + "description": "A message to group impacts of updating a policy.", + "id": "Impact", + "properties": { + "detail": { + "description": "Output only. User friendly impact detail in a free form message.", + "readOnly": true, + "type": "string" + }, + "impactType": { + "description": "Output only. The type of impact.", + "enum": [ + "IMPACT_TYPE_UNSPECIFIED", + "DEPENDENCY_MISSING_DEPENDENCIES" + ], + "enumDescriptions": [ + "Reserved Blocks (Block n contains codes from 100n to 100(n+1) -1 Block 0 - Special/Admin codes Block 1 - Impact Type of ANALYSIS_TYPE_DEPENDENCY Block 2 - Impact Type of ANALYSIS_TYPE_RESOURCE_USAGE ...", + "Block 1 - Impact Type of ANALYSIS_TYPE_DEPENDENCY" + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "ImportAdminOverridesMetadata": { "description": "Metadata message that provides information such as progress, partial failures, and similar information on each GetOperation call of LRO returned by ImportAdminOverrides.", "id": "ImportAdminOverridesMetadata", diff --git a/serviceusage/v1/serviceusage-gen.go b/serviceusage/v1/serviceusage-gen.go index 7010ee5af38..8c0bdb5b258 100644 --- a/serviceusage/v1/serviceusage-gen.go +++ b/serviceusage/v1/serviceusage-gen.go @@ -269,6 +269,99 @@ func (s AdminQuotaPolicy) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// Analysis: A message to group the analysis information. +type Analysis struct { + // Analysis: Output only. Analysis result of updating a policy. + Analysis *AnalysisResult `json:"analysis,omitempty"` + // AnalysisType: Output only. The type of analysis. + // + // Possible values: + // "ANALYSIS_TYPE_UNSPECIFIED" - Unspecified analysis type. Do not use. + // "ANALYSIS_TYPE_DEPENDENCY" - The analysis of service dependencies. + // "ANALYSIS_TYPE_RESOURCE_USAGE" - The analysis of service resource usage. + AnalysisType string `json:"analysisType,omitempty"` + // DisplayName: Output only. The user friendly display name of the analysis + // type. E.g. service dependency analysis, service resource usage analysis, + // etc. + DisplayName string `json:"displayName,omitempty"` + // Service: The names of the service that has analysis result of warnings or + // blockers. Example: `services/storage.googleapis.com`. + Service string `json:"service,omitempty"` + // ForceSendFields is a list of field names (e.g. "Analysis") 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. "Analysis") 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 Analysis) MarshalJSON() ([]byte, error) { + type NoMethod Analysis + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// AnalysisResult: An analysis result including blockers and warnings. +type AnalysisResult struct { + // Blockers: Blocking information that would prevent the policy changes at + // runtime. + Blockers []*Impact `json:"blockers,omitempty"` + // Warnings: Warning information indicating that the policy changes might be + // unsafe, but will not block the changes at runtime. + Warnings []*Impact `json:"warnings,omitempty"` + // ForceSendFields is a list of field names (e.g. "Blockers") 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. "Blockers") 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 AnalysisResult) MarshalJSON() ([]byte, error) { + type NoMethod AnalysisResult + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// AnalyzeConsumerPolicyMetadata: Metadata for the `AnalyzeConsumerPolicy` +// method. +type AnalyzeConsumerPolicyMetadata struct { +} + +// AnalyzeConsumerPolicyResponse: The response of analyzing a consumer policy +// update. +type AnalyzeConsumerPolicyResponse struct { + // Analysis: The list of analyses returned from performing the intended policy + // update analysis. The analysis is grouped by service name and different + // analysis types. The empty analysis list means that the consumer policy can + // be updated without any warnings or blockers. + Analysis []*Analysis `json:"analysis,omitempty"` + // ForceSendFields is a list of field names (e.g. "Analysis") 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. "Analysis") 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 AnalyzeConsumerPolicyResponse) MarshalJSON() ([]byte, error) { + type NoMethod AnalyzeConsumerPolicyResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Api: Api is a light-weight descriptor for an API Interface. Interfaces are // also described as "protocol buffer services" in some contexts, such as by // the "service" keyword in a .proto file, but they are different from API @@ -2393,6 +2486,38 @@ func (s HttpRule) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// Impact: A message to group impacts of updating a policy. +type Impact struct { + // Detail: Output only. User friendly impact detail in a free form message. + Detail string `json:"detail,omitempty"` + // ImpactType: Output only. The type of impact. + // + // Possible values: + // "IMPACT_TYPE_UNSPECIFIED" - Reserved Blocks (Block n contains codes from + // 100n to 100(n+1) -1 Block 0 - Special/Admin codes Block 1 - Impact Type of + // ANALYSIS_TYPE_DEPENDENCY Block 2 - Impact Type of + // ANALYSIS_TYPE_RESOURCE_USAGE ... + // "DEPENDENCY_MISSING_DEPENDENCIES" - Block 1 - Impact Type of + // ANALYSIS_TYPE_DEPENDENCY + ImpactType string `json:"impactType,omitempty"` + // ForceSendFields is a list of field names (e.g. "Detail") 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. "Detail") 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 Impact) MarshalJSON() ([]byte, error) { + type NoMethod Impact + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ImportAdminOverridesMetadata: Metadata message that provides information // such as progress, partial failures, and similar information on each // GetOperation call of LRO returned by ImportAdminOverrides. diff --git a/serviceusage/v1beta1/serviceusage-api.json b/serviceusage/v1beta1/serviceusage-api.json index 6eb28168259..0d60f34212a 100644 --- a/serviceusage/v1beta1/serviceusage-api.json +++ b/serviceusage/v1beta1/serviceusage-api.json @@ -964,7 +964,7 @@ } } }, - "revision": "20240712", + "revision": "20240811", "rootUrl": "https://serviceusage.googleapis.com/", "schemas": { "AddEnableRulesMetadata": { @@ -1026,6 +1026,83 @@ }, "type": "object" }, + "Analysis": { + "description": "A message to group the analysis information.", + "id": "Analysis", + "properties": { + "analysis": { + "$ref": "AnalysisResult", + "description": "Output only. Analysis result of updating a policy.", + "readOnly": true + }, + "analysisType": { + "description": "Output only. The type of analysis.", + "enum": [ + "ANALYSIS_TYPE_UNSPECIFIED", + "ANALYSIS_TYPE_DEPENDENCY", + "ANALYSIS_TYPE_RESOURCE_USAGE" + ], + "enumDescriptions": [ + "Unspecified analysis type. Do not use.", + "The analysis of service dependencies.", + "The analysis of service resource usage." + ], + "readOnly": true, + "type": "string" + }, + "displayName": { + "description": "Output only. The user friendly display name of the analysis type. E.g. service dependency analysis, service resource usage analysis, etc.", + "readOnly": true, + "type": "string" + }, + "service": { + "description": "The names of the service that has analysis result of warnings or blockers. Example: `services/storage.googleapis.com`.", + "type": "string" + } + }, + "type": "object" + }, + "AnalysisResult": { + "description": "An analysis result including blockers and warnings.", + "id": "AnalysisResult", + "properties": { + "blockers": { + "description": "Blocking information that would prevent the policy changes at runtime.", + "items": { + "$ref": "Impact" + }, + "type": "array" + }, + "warnings": { + "description": "Warning information indicating that the policy changes might be unsafe, but will not block the changes at runtime.", + "items": { + "$ref": "Impact" + }, + "type": "array" + } + }, + "type": "object" + }, + "AnalyzeConsumerPolicyMetadata": { + "description": "Metadata for the `AnalyzeConsumerPolicy` method.", + "id": "AnalyzeConsumerPolicyMetadata", + "properties": {}, + "type": "object" + }, + "AnalyzeConsumerPolicyResponse": { + "description": "The response of analyzing a consumer policy update.", + "id": "AnalyzeConsumerPolicyResponse", + "properties": { + "analysis": { + "description": "The list of analyses returned from performing the intended policy update analysis. The analysis is grouped by service name and different analysis types. The empty analysis list means that the consumer policy can be updated without any warnings or blockers.", + "items": { + "$ref": "Analysis" + }, + "type": "array" + } + }, + "type": "object" + }, "Api": { "description": "Api is a light-weight descriptor for an API Interface. Interfaces are also described as \"protocol buffer services\" in some contexts, such as by the \"service\" keyword in a .proto file, but they are different from API Services, which represent a concrete implementation of an interface as opposed to simply a description of methods and bindings. They are also sometimes simply referred to as \"APIs\" in other contexts, such as the name of this message itself. See https://cloud.google.com/apis/design/glossary for detailed terminology.", "id": "Api", @@ -2597,6 +2674,31 @@ }, "type": "object" }, + "Impact": { + "description": "A message to group impacts of updating a policy.", + "id": "Impact", + "properties": { + "detail": { + "description": "Output only. User friendly impact detail in a free form message.", + "readOnly": true, + "type": "string" + }, + "impactType": { + "description": "Output only. The type of impact.", + "enum": [ + "IMPACT_TYPE_UNSPECIFIED", + "DEPENDENCY_MISSING_DEPENDENCIES" + ], + "enumDescriptions": [ + "Reserved Blocks (Block n contains codes from 100n to 100(n+1) -1 Block 0 - Special/Admin codes Block 1 - Impact Type of ANALYSIS_TYPE_DEPENDENCY Block 2 - Impact Type of ANALYSIS_TYPE_RESOURCE_USAGE ...", + "Block 1 - Impact Type of ANALYSIS_TYPE_DEPENDENCY" + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "ImportAdminOverridesMetadata": { "description": "Metadata message that provides information such as progress, partial failures, and similar information on each GetOperation call of LRO returned by ImportAdminOverrides.", "id": "ImportAdminOverridesMetadata", diff --git a/serviceusage/v1beta1/serviceusage-gen.go b/serviceusage/v1beta1/serviceusage-gen.go index 32fe10cf515..dee89abafd2 100644 --- a/serviceusage/v1beta1/serviceusage-gen.go +++ b/serviceusage/v1beta1/serviceusage-gen.go @@ -317,6 +317,99 @@ func (s AdminQuotaPolicy) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// Analysis: A message to group the analysis information. +type Analysis struct { + // Analysis: Output only. Analysis result of updating a policy. + Analysis *AnalysisResult `json:"analysis,omitempty"` + // AnalysisType: Output only. The type of analysis. + // + // Possible values: + // "ANALYSIS_TYPE_UNSPECIFIED" - Unspecified analysis type. Do not use. + // "ANALYSIS_TYPE_DEPENDENCY" - The analysis of service dependencies. + // "ANALYSIS_TYPE_RESOURCE_USAGE" - The analysis of service resource usage. + AnalysisType string `json:"analysisType,omitempty"` + // DisplayName: Output only. The user friendly display name of the analysis + // type. E.g. service dependency analysis, service resource usage analysis, + // etc. + DisplayName string `json:"displayName,omitempty"` + // Service: The names of the service that has analysis result of warnings or + // blockers. Example: `services/storage.googleapis.com`. + Service string `json:"service,omitempty"` + // ForceSendFields is a list of field names (e.g. "Analysis") 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. "Analysis") 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 Analysis) MarshalJSON() ([]byte, error) { + type NoMethod Analysis + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// AnalysisResult: An analysis result including blockers and warnings. +type AnalysisResult struct { + // Blockers: Blocking information that would prevent the policy changes at + // runtime. + Blockers []*Impact `json:"blockers,omitempty"` + // Warnings: Warning information indicating that the policy changes might be + // unsafe, but will not block the changes at runtime. + Warnings []*Impact `json:"warnings,omitempty"` + // ForceSendFields is a list of field names (e.g. "Blockers") 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. "Blockers") 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 AnalysisResult) MarshalJSON() ([]byte, error) { + type NoMethod AnalysisResult + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// AnalyzeConsumerPolicyMetadata: Metadata for the `AnalyzeConsumerPolicy` +// method. +type AnalyzeConsumerPolicyMetadata struct { +} + +// AnalyzeConsumerPolicyResponse: The response of analyzing a consumer policy +// update. +type AnalyzeConsumerPolicyResponse struct { + // Analysis: The list of analyses returned from performing the intended policy + // update analysis. The analysis is grouped by service name and different + // analysis types. The empty analysis list means that the consumer policy can + // be updated without any warnings or blockers. + Analysis []*Analysis `json:"analysis,omitempty"` + // ForceSendFields is a list of field names (e.g. "Analysis") 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. "Analysis") 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 AnalyzeConsumerPolicyResponse) MarshalJSON() ([]byte, error) { + type NoMethod AnalyzeConsumerPolicyResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Api: Api is a light-weight descriptor for an API Interface. Interfaces are // also described as "protocol buffer services" in some contexts, such as by // the "service" keyword in a .proto file, but they are different from API @@ -2469,6 +2562,38 @@ func (s HttpRule) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// Impact: A message to group impacts of updating a policy. +type Impact struct { + // Detail: Output only. User friendly impact detail in a free form message. + Detail string `json:"detail,omitempty"` + // ImpactType: Output only. The type of impact. + // + // Possible values: + // "IMPACT_TYPE_UNSPECIFIED" - Reserved Blocks (Block n contains codes from + // 100n to 100(n+1) -1 Block 0 - Special/Admin codes Block 1 - Impact Type of + // ANALYSIS_TYPE_DEPENDENCY Block 2 - Impact Type of + // ANALYSIS_TYPE_RESOURCE_USAGE ... + // "DEPENDENCY_MISSING_DEPENDENCIES" - Block 1 - Impact Type of + // ANALYSIS_TYPE_DEPENDENCY + ImpactType string `json:"impactType,omitempty"` + // ForceSendFields is a list of field names (e.g. "Detail") 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. "Detail") 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 Impact) MarshalJSON() ([]byte, error) { + type NoMethod Impact + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ImportAdminOverridesMetadata: Metadata message that provides information // such as progress, partial failures, and similar information on each // GetOperation call of LRO returned by ImportAdminOverrides. diff --git a/spanner/v1/spanner-api.json b/spanner/v1/spanner-api.json index 6669f96f8e0..4fb50d3f1bf 100644 --- a/spanner/v1/spanner-api.json +++ b/spanner/v1/spanner-api.json @@ -26,6 +26,11 @@ "description": "Regional Endpoint", "endpointUrl": "https://spanner.me-central2.rep.googleapis.com/", "location": "me-central2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://spanner.us-west1.rep.googleapis.com/", + "location": "us-west1" } ], "fullyEncodeReservedExpansion": true, @@ -169,7 +174,7 @@ "instanceConfigs": { "methods": { "create": { - "description": "Creates an instance configuration and begins preparing it to be used. The returned long-running operation can be used to track the progress of preparing the new instance config. The instance configuration name is assigned by the caller. If the named instance configuration already exists, `CreateInstanceConfig` returns `ALREADY_EXISTS`. Immediately after the request returns: * The instance configuration is readable via the API, with all requested attributes. The instance config's reconciling field is set to true. Its state is `CREATING`. While the operation is pending: * Cancelling the operation renders the instance configuration immediately unreadable via the API. * Except for deleting the creating resource, all other attempts to modify the instance configuration are rejected. Upon completion of the returned operation: * Instances can be created using the instance configuration. * The instance config's reconciling field becomes false. Its state becomes `READY`. The returned long-running operation will have a name of the format `/operations/` and can be used to track creation of the instance config. The metadata field type is CreateInstanceConfigMetadata. The response field type is InstanceConfig, if successful. Authorization requires `spanner.instanceConfigs.create` permission on the resource parent.", + "description": "Creates an instance configuration and begins preparing it to be used. The returned long-running operation can be used to track the progress of preparing the new instance configuration. The instance configuration name is assigned by the caller. If the named instance configuration already exists, `CreateInstanceConfig` returns `ALREADY_EXISTS`. Immediately after the request returns: * The instance configuration is readable via the API, with all requested attributes. The instance configuration's reconciling field is set to true. Its state is `CREATING`. While the operation is pending: * Cancelling the operation renders the instance configuration immediately unreadable via the API. * Except for deleting the creating resource, all other attempts to modify the instance configuration are rejected. Upon completion of the returned operation: * Instances can be created using the instance configuration. * The instance configuration's reconciling field becomes false. Its state becomes `READY`. The returned long-running operation will have a name of the format `/operations/` and can be used to track creation of the instance configuration. The metadata field type is CreateInstanceConfigMetadata. The response field type is InstanceConfig, if successful. Authorization requires `spanner.instanceConfigs.create` permission on the resource parent.", "flatPath": "v1/projects/{projectsId}/instanceConfigs", "httpMethod": "POST", "id": "spanner.projects.instanceConfigs.create", @@ -178,7 +183,7 @@ ], "parameters": { "parent": { - "description": "Required. The name of the project in which to create the instance config. Values are of the form `projects/`.", + "description": "Required. The name of the project in which to create the instance configuration. Values are of the form `projects/`.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -198,7 +203,7 @@ ] }, "delete": { - "description": "Deletes the instance config. Deletion is only allowed when no instances are using the configuration. If any instances are using the config, returns `FAILED_PRECONDITION`. Only user-managed configurations can be deleted. Authorization requires `spanner.instanceConfigs.delete` permission on the resource name.", + "description": "Deletes the instance configuration. Deletion is only allowed when no instances are using the configuration. If any instances are using the configuration, returns `FAILED_PRECONDITION`. Only user-managed configurations can be deleted. Authorization requires `spanner.instanceConfigs.delete` permission on the resource name.", "flatPath": "v1/projects/{projectsId}/instanceConfigs/{instanceConfigsId}", "httpMethod": "DELETE", "id": "spanner.projects.instanceConfigs.delete", @@ -207,7 +212,7 @@ ], "parameters": { "etag": { - "description": "Used for optimistic concurrency control as a way to help prevent simultaneous deletes of an instance configuration from overwriting each other. If not empty, the API only deletes the instance configuration when the etag provided matches the current status of the requested instance config. Otherwise, deletes the instance configuration without checking the current status of the requested instance config.", + "description": "Used for optimistic concurrency control as a way to help prevent simultaneous deletes of an instance configuration from overwriting each other. If not empty, the API only deletes the instance configuration when the etag provided matches the current status of the requested instance configuration. Otherwise, deletes the instance configuration without checking the current status of the requested instance configuration.", "location": "query", "type": "string" }, @@ -297,7 +302,7 @@ ] }, "patch": { - "description": "Updates an instance config. The returned long-running operation can be used to track the progress of updating the instance. If the named instance configuration does not exist, returns `NOT_FOUND`. Only user-managed configurations can be updated. Immediately after the request returns: * The instance config's reconciling field is set to true. While the operation is pending: * Cancelling the operation sets its metadata's cancel_time. The operation is guaranteed to succeed at undoing all changes, after which point it terminates with a `CANCELLED` status. * All other attempts to modify the instance configuration are rejected. * Reading the instance configuration via the API continues to give the pre-request values. Upon completion of the returned operation: * Creating instances using the instance configuration uses the new values. * The instance config's new values are readable via the API. * The instance config's reconciling field becomes false. The returned long-running operation will have a name of the format `/operations/` and can be used to track the instance configuration modification. The metadata field type is UpdateInstanceConfigMetadata. The response field type is InstanceConfig, if successful. Authorization requires `spanner.instanceConfigs.update` permission on the resource name.", + "description": "Updates an instance configuration. The returned long-running operation can be used to track the progress of updating the instance. If the named instance configuration does not exist, returns `NOT_FOUND`. Only user-managed configurations can be updated. Immediately after the request returns: * The instance configuration's reconciling field is set to true. While the operation is pending: * Cancelling the operation sets its metadata's cancel_time. The operation is guaranteed to succeed at undoing all changes, after which point it terminates with a `CANCELLED` status. * All other attempts to modify the instance configuration are rejected. * Reading the instance configuration via the API continues to give the pre-request values. Upon completion of the returned operation: * Creating instances using the instance configuration uses the new values. * The new values of the instance configuration are readable via the API. * The instance configuration's reconciling field becomes false. The returned long-running operation will have a name of the format `/operations/` and can be used to track the instance configuration modification. The metadata field type is UpdateInstanceConfigMetadata. The response field type is InstanceConfig, if successful. Authorization requires `spanner.instanceConfigs.update` permission on the resource name.", "flatPath": "v1/projects/{projectsId}/instanceConfigs/{instanceConfigsId}", "httpMethod": "PATCH", "id": "spanner.projects.instanceConfigs.patch", @@ -748,7 +753,7 @@ ] }, "move": { - "description": "Moves the instance to the target instance config. The returned long-running operation can be used to track the progress of moving the instance. `MoveInstance` returns `FAILED_PRECONDITION` if the instance meets any of the following criteria: * Has an ongoing move to a different instance config * Has backups * Has an ongoing update * Is under free trial * Contains any CMEK-enabled databases While the operation is pending: * All other attempts to modify the instance, including changes to its compute capacity, are rejected. * The following database and backup admin operations are rejected: * DatabaseAdmin.CreateDatabase, * DatabaseAdmin.UpdateDatabaseDdl (Disabled if default_leader is specified in the request.) * DatabaseAdmin.RestoreDatabase * DatabaseAdmin.CreateBackup * DatabaseAdmin.CopyBackup * Both the source and target instance configurations are subject to hourly compute and storage charges. * The instance may experience higher read-write latencies and a higher transaction abort rate. However, moving an instance does not cause any downtime. The returned long-running operation will have a name of the format `/operations/` and can be used to track the move instance operation. The metadata field type is MoveInstanceMetadata. The response field type is Instance, if successful. Cancelling the operation sets its metadata's cancel_time. Cancellation is not immediate since it involves moving any data previously moved to target instance configuration back to the original instance config. The same operation can be used to track the progress of the cancellation. Upon successful completion of the cancellation, the operation terminates with `CANCELLED` status. Upon completion(if not cancelled) of the returned operation: * Instance would be successfully moved to the target instance config. * You are billed for compute and storage in target instance config. Authorization requires `spanner.instances.update` permission on the resource instance. For more details, please see [documentation](https://cloud.google.com/spanner/docs/move-instance).", + "description": "Moves an instance to the target instance configuration. You can use the returned long-running operation to track the progress of moving the instance. `MoveInstance` returns `FAILED_PRECONDITION` if the instance meets any of the following criteria: * Is undergoing a move to a different instance configuration * Has backups * Has an ongoing update * Contains any CMEK-enabled databases * Is a free trial instance While the operation is pending: * All other attempts to modify the instance, including changes to its compute capacity, are rejected. * The following database and backup admin operations are rejected: * `DatabaseAdmin.CreateDatabase` * `DatabaseAdmin.UpdateDatabaseDdl` (disabled if default_leader is specified in the request.) * `DatabaseAdmin.RestoreDatabase` * `DatabaseAdmin.CreateBackup` * `DatabaseAdmin.CopyBackup` * Both the source and target instance configurations are subject to hourly compute and storage charges. * The instance might experience higher read-write latencies and a higher transaction abort rate. However, moving an instance doesn't cause any downtime. The returned long-running operation has a name of the format `/operations/` and can be used to track the move instance operation. The metadata field type is MoveInstanceMetadata. The response field type is Instance, if successful. Cancelling the operation sets its metadata's cancel_time. Cancellation is not immediate because it involves moving any data previously moved to the target instance configuration back to the original instance configuration. You can use this operation to track the progress of the cancellation. Upon successful completion of the cancellation, the operation terminates with `CANCELLED` status. If not cancelled, upon completion of the returned operation: * The instance successfully moves to the target instance configuration. * You are billed for compute and storage in target instance configuration. Authorization requires the `spanner.instances.update` permission on the resource instance. For more details, see [Move an instance](https://cloud.google.com/spanner/docs/move-instance).", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}:move", "httpMethod": "POST", "id": "spanner.projects.instances.move", @@ -3254,7 +3259,7 @@ } } }, - "revision": "20240731", + "revision": "20240807", "rootUrl": "https://spanner.googleapis.com/", "schemas": { "AutoscalingConfig": { @@ -3366,11 +3371,28 @@ "readOnly": true, "type": "array" }, + "exclusiveSizeBytes": { + "description": "Output only. For a backup in an incremental backup chain, this is the storage space needed to keep the data that has changed since the previous backup. For all other backups, this is always the size of the backup. This value may change if backups on the same chain get deleted or expired. This field can be used to calculate the total storage space used by a set of backups. For example, the total space used by all backups of a database can be computed by summing up this field.", + "format": "int64", + "readOnly": true, + "type": "string" + }, "expireTime": { "description": "Required for the CreateBackup operation. The expiration time of the backup, with microseconds granularity that must be at least 6 hours and at most 366 days from the time the CreateBackup request is processed. Once the `expire_time` has passed, the backup is eligible to be automatically deleted by Cloud Spanner to free the resources used by the backup.", "format": "google-datetime", "type": "string" }, + "freeableSizeBytes": { + "description": "Output only. The number of bytes that will be freed by deleting this backup. This value will be zero if, for example, this backup is part of an incremental backup chain and younger backups in the chain require that we keep its data. For backups not in an incremental backup chain, this is always the size of the backup. This value may change if backups on the same chain get created, deleted or expired.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "incrementalBackupChainId": { + "description": "Output only. Populated only for backups in an incremental backup chain. Backups share the same chain id if and only if they belong to the same incremental backup chain. Use this field to determine which backups are part of the same incremental backup chain. The ordering of backups in the chain can be determined by ordering the backup `version_time`.", + "readOnly": true, + "type": "string" + }, "maxExpireTime": { "description": "Output only. The max allowed expiration time of the backup, with microseconds granularity. A backup's expiration time can be configured in multiple APIs: CreateBackup, UpdateBackup, CopyBackup. When updating or copying an existing backup, the expiration time specified must be less than `Backup.max_expire_time`.", "format": "google-datetime", @@ -3381,6 +3403,12 @@ "description": "Output only for the CreateBackup operation. Required for the UpdateBackup operation. A globally unique identifier for the backup which cannot be changed. Values are of the form `projects//instances//backups/a-z*[a-z0-9]` The final segment of the name must be between 2 and 60 characters in length. The backup is stored in the location(s) specified in the instance configuration of the instance containing the backup, identified by the prefix of the backup name of the form `projects//instances/`.", "type": "string" }, + "oldestVersionTime": { + "description": "Output only. Data deleted at a time older than this is guaranteed not to be retained in order to support this backup. For a backup in an incremental backup chain, this is the version time of the oldest backup that exists or ever existed in the chain. For all other backups, this is the version time of the backup. This field can be used to understand what data is being retained by the backup system.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, "referencingBackups": { "description": "Output only. The names of the destination backups being created by copying this source backup. The backup names are of the form `projects//instances//backups/`. Referencing backups may exist in different instances. The existence of any referencing backup prevents the backup from being deleted. When the copy operation is done (either successfully completed or cancelled or the destination backup is deleted), the reference to the backup is removed.", "items": { @@ -3398,7 +3426,7 @@ "type": "array" }, "sizeBytes": { - "description": "Output only. Size of the backup in bytes.", + "description": "Output only. Size of the backup in bytes. For a backup in an incremental backup chain, this is the sum of the `exclusive_size_bytes` of itself and all older backups in the chain.", "format": "int64", "readOnly": true, "type": "string" @@ -3463,6 +3491,10 @@ "$ref": "FullBackupSpec", "description": "The schedule creates only full backups." }, + "incrementalBackupSpec": { + "$ref": "IncrementalBackupSpec", + "description": "The schedule creates incremental backup chains." + }, "name": { "description": "Identifier. Output only for the CreateBackupSchedule operation. Required for the UpdateBackupSchedule operation. A globally unique identifier for the backup schedule which cannot be changed. Values are of the form `projects//instances//databases//backupSchedules/a-z*[a-z0-9]` The final segment of the name must be between 2 and 60 characters in length.", "type": "string" @@ -3989,7 +4021,7 @@ "properties": { "instanceConfig": { "$ref": "InstanceConfig", - "description": "Required. The InstanceConfig proto of the configuration to create. instance_config.name must be `/instanceConfigs/`. instance_config.base_config must be a Google-managed configuration name, e.g. /instanceConfigs/us-east1, /instanceConfigs/nam3." + "description": "Required. The `InstanceConfig` proto of the configuration to create. `instance_config.name` must be `/instanceConfigs/`. `instance_config.base_config` must be a Google-managed configuration name, e.g. /instanceConfigs/us-east1, /instanceConfigs/nam3." }, "instanceConfigId": { "description": "Required. The ID of the instance configuration to create. Valid identifiers are of the form `custom-[-a-z0-9]*[a-z0-9]` and must be between 2 and 64 characters in length. The `custom-` prefix is required to avoid name conflicts with Google-managed configurations.", @@ -4680,6 +4712,12 @@ }, "type": "object" }, + "IncrementalBackupSpec": { + "description": "The specification for incremental backup chains. An incremental backup stores the delta of changes between a previous backup and the database contents at a given version time. An incremental backup chain consists of a full backup and zero or more successive incremental backups. The first backup created for an incremental backup chain is always a full backup.", + "id": "IncrementalBackupSpec", + "properties": {}, + "type": "object" + }, "IndexAdvice": { "description": "Recommendation to add new indexes to run queries more efficiently.", "id": "IndexAdvice", @@ -4750,6 +4788,22 @@ "description": "Required. The descriptive name for this instance as it appears in UIs. Must be unique per project and between 4 and 30 characters in length.", "type": "string" }, + "edition": { + "description": "Optional. The `Edition` of the current instance.", + "enum": [ + "EDITION_UNSPECIFIED", + "STANDARD", + "ENTERPRISE", + "ENTERPRISE_PLUS" + ], + "enumDescriptions": [ + "Edition not specified.", + "Standard edition.", + "Enterprise edition.", + "Enterprise Plus edition." + ], + "type": "string" + }, "endpointUris": { "description": "Deprecated. This field is not populated.", "items": { @@ -4787,12 +4841,12 @@ "type": "string" }, "nodeCount": { - "description": "The number of nodes allocated to this instance. At most, one of either `node_count` or `processing_units` should be present in the message. Users can set the node_count field to specify the target number of nodes allocated to the instance. If autoscaling is enabled, node_count is treated as an OUTPUT_ONLY field and reflects the current number of nodes allocated to the instance. This might be zero in API responses for instances that are not yet in the `READY` state. For more information, see [Compute capacity, nodes, and processing units](https://cloud.google.com/spanner/docs/compute-capacity).", + "description": "The number of nodes allocated to this instance. At most, one of either `node_count` or `processing_units` should be present in the message. Users can set the `node_count` field to specify the target number of nodes allocated to the instance. If autoscaling is enabled, `node_count` is treated as an `OUTPUT_ONLY` field and reflects the current number of nodes allocated to the instance. This might be zero in API responses for instances that are not yet in the `READY` state. For more information, see [Compute capacity, nodes, and processing units](https://cloud.google.com/spanner/docs/compute-capacity).", "format": "int32", "type": "integer" }, "processingUnits": { - "description": "The number of processing units allocated to this instance. At most, one of either `processing_units` or `node_count` should be present in the message. Users can set the `processing_units` field to specify the target number of processing units allocated to the instance. If autoscaling is enabled, `processing_units` is treated as an `OUTPUT_ONLY` field and reflects the current number of processing units allocated to the instance. This might be zero in API responses for instances that are not yet in the `READY` state. See [the documentation](https://cloud.google.com/spanner/docs/compute-capacity) for more information about nodes and processing units.", + "description": "The number of processing units allocated to this instance. At most, one of either `processing_units` or `node_count` should be present in the message. Users can set the `processing_units` field to specify the target number of processing units allocated to the instance. If autoscaling is enabled, `processing_units` is treated as an `OUTPUT_ONLY` field and reflects the current number of processing units allocated to the instance. This might be zero in API responses for instances that are not yet in the `READY` state. For more information, see [Compute capacity, nodes and processing units](https://cloud.google.com/spanner/docs/compute-capacity).", "format": "int32", "type": "integer" }, @@ -4829,7 +4883,7 @@ "type": "string" }, "configType": { - "description": "Output only. Whether this instance configuration is a Google- or user-managed configuration.", + "description": "Output only. Whether this instance configuration is a Google-managed or user-managed configuration.", "enum": [ "TYPE_UNSPECIFIED", "GOOGLE_MANAGED", @@ -4852,7 +4906,7 @@ "type": "string" }, "freeInstanceAvailability": { - "description": "Output only. Describes whether free instances are available to be created in this instance config.", + "description": "Output only. Describes whether free instances are available to be created in this instance configuration.", "enum": [ "FREE_INSTANCE_AVAILABILITY_UNSPECIFIED", "AVAILABLE", @@ -4862,9 +4916,9 @@ ], "enumDescriptions": [ "Not specified.", - "Indicates that free instances are available to be created in this instance config.", - "Indicates that free instances are not supported in this instance config.", - "Indicates that free instances are currently not available to be created in this instance config.", + "Indicates that free instances are available to be created in this instance configuration.", + "Indicates that free instances are not supported in this instance configuration.", + "Indicates that free instances are currently not available to be created in this instance configuration.", "Indicates that additional free instances cannot be created in this instance configuration because the project has reached its limit of free instances." ], "readOnly": true, @@ -4914,7 +4968,7 @@ "type": "string" }, "reconciling": { - "description": "Output only. If true, the instance configuration is being created or updated. If false, there are no ongoing operations for the instance config.", + "description": "Output only. If true, the instance configuration is being created or updated. If false, there are no ongoing operations for the instance configuration.", "readOnly": true, "type": "boolean" }, @@ -5298,7 +5352,7 @@ "type": "string" }, "operations": { - "description": "The list of matching instance configuration long-running operations. Each operation's name will be prefixed by the instance config's name. The operation's metadata field type `metadata.type_url` describes the type of the metadata.", + "description": "The list of matching instance configuration long-running operations. Each operation's name will be prefixed by the name of the instance configuration. The operation's metadata field type `metadata.type_url` describes the type of the metadata.", "items": { "$ref": "Operation" }, @@ -5582,7 +5636,7 @@ "id": "MoveInstanceRequest", "properties": { "targetConfig": { - "description": "Required. The target instance configuration for the instance to move. Values are of the form `projects//instanceConfigs/`.", + "description": "Required. The target instance configuration where to move the instance. Values are of the form `projects//instanceConfigs/`.", "type": "string" } }, diff --git a/spanner/v1/spanner-gen.go b/spanner/v1/spanner-gen.go index 1f91797c0a5..1c24b85fcdd 100644 --- a/spanner/v1/spanner-gen.go +++ b/spanner/v1/spanner-gen.go @@ -549,12 +549,34 @@ type Backup struct { // restored. If a key version is revoked in the middle of a restore, the // restore behavior is undefined. EncryptionInformation []*EncryptionInfo `json:"encryptionInformation,omitempty"` + // ExclusiveSizeBytes: Output only. For a backup in an incremental backup + // chain, this is the storage space needed to keep the data that has changed + // since the previous backup. For all other backups, this is always the size of + // the backup. This value may change if backups on the same chain get deleted + // or expired. This field can be used to calculate the total storage space used + // by a set of backups. For example, the total space used by all backups of a + // database can be computed by summing up this field. + ExclusiveSizeBytes int64 `json:"exclusiveSizeBytes,omitempty,string"` // ExpireTime: Required for the CreateBackup operation. The expiration time of // the backup, with microseconds granularity that must be at least 6 hours and // at most 366 days from the time the CreateBackup request is processed. Once // the `expire_time` has passed, the backup is eligible to be automatically // deleted by Cloud Spanner to free the resources used by the backup. ExpireTime string `json:"expireTime,omitempty"` + // FreeableSizeBytes: Output only. The number of bytes that will be freed by + // deleting this backup. This value will be zero if, for example, this backup + // is part of an incremental backup chain and younger backups in the chain + // require that we keep its data. For backups not in an incremental backup + // chain, this is always the size of the backup. This value may change if + // backups on the same chain get created, deleted or expired. + FreeableSizeBytes int64 `json:"freeableSizeBytes,omitempty,string"` + // IncrementalBackupChainId: Output only. Populated only for backups in an + // incremental backup chain. Backups share the same chain id if and only if + // they belong to the same incremental backup chain. Use this field to + // determine which backups are part of the same incremental backup chain. The + // ordering of backups in the chain can be determined by ordering the backup + // `version_time`. + IncrementalBackupChainId string `json:"incrementalBackupChainId,omitempty"` // MaxExpireTime: Output only. The max allowed expiration time of the backup, // with microseconds granularity. A backup's expiration time can be configured // in multiple APIs: CreateBackup, UpdateBackup, CopyBackup. When updating or @@ -570,6 +592,13 @@ type Backup struct { // containing the backup, identified by the prefix of the backup name of the // form `projects//instances/`. Name string `json:"name,omitempty"` + // OldestVersionTime: Output only. Data deleted at a time older than this is + // guaranteed not to be retained in order to support this backup. For a backup + // in an incremental backup chain, this is the version time of the oldest + // backup that exists or ever existed in the chain. For all other backups, this + // is the version time of the backup. This field can be used to understand what + // data is being retained by the backup system. + OldestVersionTime string `json:"oldestVersionTime,omitempty"` // ReferencingBackups: Output only. The names of the destination backups being // created by copying this source backup. The backup names are of the form // `projects//instances//backups/`. Referencing backups may exist in different @@ -585,7 +614,9 @@ type Backup struct { // backup from being deleted. When a restored database from the backup enters // the `READY` state, the reference to the backup is removed. ReferencingDatabases []string `json:"referencingDatabases,omitempty"` - // SizeBytes: Output only. Size of the backup in bytes. + // SizeBytes: Output only. Size of the backup in bytes. For a backup in an + // incremental backup chain, this is the sum of the `exclusive_size_bytes` of + // itself and all older backups in the chain. SizeBytes int64 `json:"sizeBytes,omitempty,string"` // State: Output only. The current state of the backup. // @@ -661,6 +692,8 @@ type BackupSchedule struct { EncryptionConfig *CreateBackupEncryptionConfig `json:"encryptionConfig,omitempty"` // FullBackupSpec: The schedule creates only full backups. FullBackupSpec *FullBackupSpec `json:"fullBackupSpec,omitempty"` + // IncrementalBackupSpec: The schedule creates incremental backup chains. + IncrementalBackupSpec *IncrementalBackupSpec `json:"incrementalBackupSpec,omitempty"` // Name: Identifier. Output only for the CreateBackupSchedule operation. // Required for the UpdateBackupSchedule operation. A globally unique // identifier for the backup schedule which cannot be changed. Values are of @@ -1540,9 +1573,9 @@ func (s CreateInstanceConfigMetadata) MarshalJSON() ([]byte, error) { // CreateInstanceConfigRequest: The request for CreateInstanceConfigRequest. type CreateInstanceConfigRequest struct { - // InstanceConfig: Required. The InstanceConfig proto of the configuration to - // create. instance_config.name must be `/instanceConfigs/`. - // instance_config.base_config must be a Google-managed configuration name, + // InstanceConfig: Required. The `InstanceConfig` proto of the configuration to + // create. `instance_config.name` must be `/instanceConfigs/`. + // `instance_config.base_config` must be a Google-managed configuration name, // e.g. /instanceConfigs/us-east1, /instanceConfigs/nam3. InstanceConfig *InstanceConfig `json:"instanceConfig,omitempty"` // InstanceConfigId: Required. The ID of the instance configuration to create. @@ -2580,6 +2613,15 @@ func (s IncludeReplicas) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// IncrementalBackupSpec: The specification for incremental backup chains. An +// incremental backup stores the delta of changes between a previous backup and +// the database contents at a given version time. An incremental backup chain +// consists of a full backup and zero or more successive incremental backups. +// The first backup created for an incremental backup chain is always a full +// backup. +type IncrementalBackupSpec struct { +} + // IndexAdvice: Recommendation to add new indexes to run queries more // efficiently. type IndexAdvice struct { @@ -2690,6 +2732,14 @@ type Instance struct { // in UIs. Must be unique per project and between 4 and 30 characters in // length. DisplayName string `json:"displayName,omitempty"` + // Edition: Optional. The `Edition` of the current instance. + // + // Possible values: + // "EDITION_UNSPECIFIED" - Edition not specified. + // "STANDARD" - Standard edition. + // "ENTERPRISE" - Enterprise edition. + // "ENTERPRISE_PLUS" - Enterprise Plus edition. + Edition string `json:"edition,omitempty"` // EndpointUris: Deprecated. This field is not populated. EndpointUris []string `json:"endpointUris,omitempty"` // FreeInstanceMetadata: Free instance metadata. Only populated for free @@ -2729,12 +2779,12 @@ type Instance struct { Name string `json:"name,omitempty"` // NodeCount: The number of nodes allocated to this instance. At most, one of // either `node_count` or `processing_units` should be present in the message. - // Users can set the node_count field to specify the target number of nodes - // allocated to the instance. If autoscaling is enabled, node_count is treated - // as an OUTPUT_ONLY field and reflects the current number of nodes allocated - // to the instance. This might be zero in API responses for instances that are - // not yet in the `READY` state. For more information, see Compute capacity, - // nodes, and processing units + // Users can set the `node_count` field to specify the target number of nodes + // allocated to the instance. If autoscaling is enabled, `node_count` is + // treated as an `OUTPUT_ONLY` field and reflects the current number of nodes + // allocated to the instance. This might be zero in API responses for instances + // that are not yet in the `READY` state. For more information, see Compute + // capacity, nodes, and processing units // (https://cloud.google.com/spanner/docs/compute-capacity). NodeCount int64 `json:"nodeCount,omitempty"` // ProcessingUnits: The number of processing units allocated to this instance. @@ -2744,9 +2794,8 @@ type Instance struct { // is enabled, `processing_units` is treated as an `OUTPUT_ONLY` field and // reflects the current number of processing units allocated to the instance. // This might be zero in API responses for instances that are not yet in the - // `READY` state. See the documentation - // (https://cloud.google.com/spanner/docs/compute-capacity) for more - // information about nodes and processing units. + // `READY` state. For more information, see Compute capacity, nodes and + // processing units (https://cloud.google.com/spanner/docs/compute-capacity). ProcessingUnits int64 `json:"processingUnits,omitempty"` // State: Output only. The current instance state. For CreateInstance, the // state must be either omitted or set to `CREATING`. For UpdateInstance, the @@ -2792,8 +2841,8 @@ type InstanceConfig struct { // configurations. `base_config` must refer to a configuration of type // `GOOGLE_MANAGED` in the same project as this configuration. BaseConfig string `json:"baseConfig,omitempty"` - // ConfigType: Output only. Whether this instance configuration is a Google- or - // user-managed configuration. + // ConfigType: Output only. Whether this instance configuration is a + // Google-managed or user-managed configuration. // // Possible values: // "TYPE_UNSPECIFIED" - Unspecified. @@ -2814,16 +2863,16 @@ type InstanceConfig struct { // instance configuration is overwritten blindly. Etag string `json:"etag,omitempty"` // FreeInstanceAvailability: Output only. Describes whether free instances are - // available to be created in this instance config. + // available to be created in this instance configuration. // // Possible values: // "FREE_INSTANCE_AVAILABILITY_UNSPECIFIED" - Not specified. // "AVAILABLE" - Indicates that free instances are available to be created in - // this instance config. + // this instance configuration. // "UNSUPPORTED" - Indicates that free instances are not supported in this - // instance config. + // instance configuration. // "DISABLED" - Indicates that free instances are currently not available to - // be created in this instance config. + // be created in this instance configuration. // "QUOTA_EXCEEDED" - Indicates that additional free instances cannot be // created in this instance configuration because the project has reached its // limit of free instances. @@ -2872,7 +2921,7 @@ type InstanceConfig struct { QuorumType string `json:"quorumType,omitempty"` // Reconciling: Output only. If true, the instance configuration is being // created or updated. If false, there are no ongoing operations for the - // instance config. + // instance configuration. Reconciling bool `json:"reconciling,omitempty"` // Replicas: The geographic placement of nodes in this instance configuration // and their replication properties. To create user-managed configurations, @@ -3397,9 +3446,9 @@ type ListInstanceConfigOperationsResponse struct { // ListInstanceConfigOperations call to fetch more of the matching metadata. NextPageToken string `json:"nextPageToken,omitempty"` // Operations: The list of matching instance configuration long-running - // operations. Each operation's name will be prefixed by the instance config's - // name. The operation's metadata field type `metadata.type_url` describes the - // type of the metadata. + // operations. Each operation's name will be prefixed by the name of the + // instance configuration. The operation's metadata field type + // `metadata.type_url` describes the type of the metadata. Operations []*Operation `json:"operations,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -3802,8 +3851,8 @@ func (s *MetricMatrixRow) UnmarshalJSON(data []byte) error { // MoveInstanceRequest: The request for MoveInstance. type MoveInstanceRequest struct { - // TargetConfig: Required. The target instance configuration for the instance - // to move. Values are of the form `projects//instanceConfigs/`. + // TargetConfig: Required. The target instance configuration where to move the + // instance. Values are of the form `projects//instanceConfigs/`. TargetConfig string `json:"targetConfig,omitempty"` // ForceSendFields is a list of field names (e.g. "TargetConfig") to // unconditionally include in API requests. By default, fields with empty or @@ -6605,25 +6654,26 @@ type ProjectsInstanceConfigsCreateCall struct { // Create: Creates an instance configuration and begins preparing it to be // used. The returned long-running operation can be used to track the progress -// of preparing the new instance config. The instance configuration name is -// assigned by the caller. If the named instance configuration already exists, -// `CreateInstanceConfig` returns `ALREADY_EXISTS`. Immediately after the -// request returns: * The instance configuration is readable via the API, with -// all requested attributes. The instance config's reconciling field is set to -// true. Its state is `CREATING`. While the operation is pending: * Cancelling -// the operation renders the instance configuration immediately unreadable via -// the API. * Except for deleting the creating resource, all other attempts to -// modify the instance configuration are rejected. Upon completion of the -// returned operation: * Instances can be created using the instance -// configuration. * The instance config's reconciling field becomes false. Its -// state becomes `READY`. The returned long-running operation will have a name -// of the format `/operations/` and can be used to track creation of the -// instance config. The metadata field type is CreateInstanceConfigMetadata. -// The response field type is InstanceConfig, if successful. Authorization -// requires `spanner.instanceConfigs.create` permission on the resource parent. +// of preparing the new instance configuration. The instance configuration name +// is assigned by the caller. If the named instance configuration already +// exists, `CreateInstanceConfig` returns `ALREADY_EXISTS`. Immediately after +// the request returns: * The instance configuration is readable via the API, +// with all requested attributes. The instance configuration's reconciling +// field is set to true. Its state is `CREATING`. While the operation is +// pending: * Cancelling the operation renders the instance configuration +// immediately unreadable via the API. * Except for deleting the creating +// resource, all other attempts to modify the instance configuration are +// rejected. Upon completion of the returned operation: * Instances can be +// created using the instance configuration. * The instance configuration's +// reconciling field becomes false. Its state becomes `READY`. The returned +// long-running operation will have a name of the format `/operations/` and can +// be used to track creation of the instance configuration. The metadata field +// type is CreateInstanceConfigMetadata. The response field type is +// InstanceConfig, if successful. Authorization requires +// `spanner.instanceConfigs.create` permission on the resource parent. // -// - parent: The name of the project in which to create the instance config. -// Values are of the form `projects/`. +// - parent: The name of the project in which to create the instance +// configuration. Values are of the form `projects/`. func (r *ProjectsInstanceConfigsService) Create(parent string, createinstanceconfigrequest *CreateInstanceConfigRequest) *ProjectsInstanceConfigsCreateCall { c := &ProjectsInstanceConfigsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -6721,11 +6771,11 @@ type ProjectsInstanceConfigsDeleteCall struct { header_ http.Header } -// Delete: Deletes the instance config. Deletion is only allowed when no +// Delete: Deletes the instance configuration. Deletion is only allowed when no // instances are using the configuration. If any instances are using the -// config, returns `FAILED_PRECONDITION`. Only user-managed configurations can -// be deleted. Authorization requires `spanner.instanceConfigs.delete` -// permission on the resource name. +// configuration, returns `FAILED_PRECONDITION`. Only user-managed +// configurations can be deleted. Authorization requires +// `spanner.instanceConfigs.delete` permission on the resource name. // // - name: The name of the instance configuration to be deleted. Values are of // the form `projects//instanceConfigs/`. @@ -6739,9 +6789,9 @@ func (r *ProjectsInstanceConfigsService) Delete(name string) *ProjectsInstanceCo // control as a way to help prevent simultaneous deletes of an instance // configuration from overwriting each other. If not empty, the API only // deletes the instance configuration when the etag provided matches the -// current status of the requested instance config. Otherwise, deletes the -// instance configuration without checking the current status of the requested -// instance config. +// current status of the requested instance configuration. Otherwise, deletes +// the instance configuration without checking the current status of the +// requested instance configuration. func (c *ProjectsInstanceConfigsDeleteCall) Etag(etag string) *ProjectsInstanceConfigsDeleteCall { c.urlParams_.Set("etag", etag) return c @@ -7097,23 +7147,24 @@ type ProjectsInstanceConfigsPatchCall struct { header_ http.Header } -// Patch: Updates an instance config. The returned long-running operation can -// be used to track the progress of updating the instance. If the named -// instance configuration does not exist, returns `NOT_FOUND`. Only +// Patch: Updates an instance configuration. The returned long-running +// operation can be used to track the progress of updating the instance. If the +// named instance configuration does not exist, returns `NOT_FOUND`. Only // user-managed configurations can be updated. Immediately after the request -// returns: * The instance config's reconciling field is set to true. While the -// operation is pending: * Cancelling the operation sets its metadata's -// cancel_time. The operation is guaranteed to succeed at undoing all changes, -// after which point it terminates with a `CANCELLED` status. * All other -// attempts to modify the instance configuration are rejected. * Reading the -// instance configuration via the API continues to give the pre-request values. -// Upon completion of the returned operation: * Creating instances using the -// instance configuration uses the new values. * The instance config's new -// values are readable via the API. * The instance config's reconciling field -// becomes false. The returned long-running operation will have a name of the -// format `/operations/` and can be used to track the instance configuration -// modification. The metadata field type is UpdateInstanceConfigMetadata. The -// response field type is InstanceConfig, if successful. Authorization requires +// returns: * The instance configuration's reconciling field is set to true. +// While the operation is pending: * Cancelling the operation sets its +// metadata's cancel_time. The operation is guaranteed to succeed at undoing +// all changes, after which point it terminates with a `CANCELLED` status. * +// All other attempts to modify the instance configuration are rejected. * +// Reading the instance configuration via the API continues to give the +// pre-request values. Upon completion of the returned operation: * Creating +// instances using the instance configuration uses the new values. * The new +// values of the instance configuration are readable via the API. * The +// instance configuration's reconciling field becomes false. The returned +// long-running operation will have a name of the format `/operations/` and can +// be used to track the instance configuration modification. The metadata field +// type is UpdateInstanceConfigMetadata. The response field type is +// InstanceConfig, if successful. Authorization requires // `spanner.instanceConfigs.update` permission on the resource name. // // - name: A unique identifier for the instance configuration. Values are of @@ -8747,34 +8798,35 @@ type ProjectsInstancesMoveCall struct { header_ http.Header } -// Move: Moves the instance to the target instance config. The returned -// long-running operation can be used to track the progress of moving the +// Move: Moves an instance to the target instance configuration. You can use +// the returned long-running operation to track the progress of moving the // instance. `MoveInstance` returns `FAILED_PRECONDITION` if the instance meets -// any of the following criteria: * Has an ongoing move to a different instance -// config * Has backups * Has an ongoing update * Is under free trial * -// Contains any CMEK-enabled databases While the operation is pending: * All -// other attempts to modify the instance, including changes to its compute -// capacity, are rejected. * The following database and backup admin operations -// are rejected: * DatabaseAdmin.CreateDatabase, * -// DatabaseAdmin.UpdateDatabaseDdl (Disabled if default_leader is specified in -// the request.) * DatabaseAdmin.RestoreDatabase * DatabaseAdmin.CreateBackup * -// DatabaseAdmin.CopyBackup * Both the source and target instance -// configurations are subject to hourly compute and storage charges. * The -// instance may experience higher read-write latencies and a higher transaction -// abort rate. However, moving an instance does not cause any downtime. The -// returned long-running operation will have a name of the format +// any of the following criteria: * Is undergoing a move to a different +// instance configuration * Has backups * Has an ongoing update * Contains any +// CMEK-enabled databases * Is a free trial instance While the operation is +// pending: * All other attempts to modify the instance, including changes to +// its compute capacity, are rejected. * The following database and backup +// admin operations are rejected: * `DatabaseAdmin.CreateDatabase` * +// `DatabaseAdmin.UpdateDatabaseDdl` (disabled if default_leader is specified +// in the request.) * `DatabaseAdmin.RestoreDatabase` * +// `DatabaseAdmin.CreateBackup` * `DatabaseAdmin.CopyBackup` * Both the source +// and target instance configurations are subject to hourly compute and storage +// charges. * The instance might experience higher read-write latencies and a +// higher transaction abort rate. However, moving an instance doesn't cause any +// downtime. The returned long-running operation has a name of the format // `/operations/` and can be used to track the move instance operation. The // metadata field type is MoveInstanceMetadata. The response field type is // Instance, if successful. Cancelling the operation sets its metadata's -// cancel_time. Cancellation is not immediate since it involves moving any data -// previously moved to target instance configuration back to the original -// instance config. The same operation can be used to track the progress of the -// cancellation. Upon successful completion of the cancellation, the operation -// terminates with `CANCELLED` status. Upon completion(if not cancelled) of the -// returned operation: * Instance would be successfully moved to the target -// instance config. * You are billed for compute and storage in target instance -// config. Authorization requires `spanner.instances.update` permission on the -// resource instance. For more details, please see documentation +// cancel_time. Cancellation is not immediate because it involves moving any +// data previously moved to the target instance configuration back to the +// original instance configuration. You can use this operation to track the +// progress of the cancellation. Upon successful completion of the +// cancellation, the operation terminates with `CANCELLED` status. If not +// cancelled, upon completion of the returned operation: * The instance +// successfully moves to the target instance configuration. * You are billed +// for compute and storage in target instance configuration. Authorization +// requires the `spanner.instances.update` permission on the resource instance. +// For more details, see Move an instance // (https://cloud.google.com/spanner/docs/move-instance). // // - name: The instance to move. Values are of the form `projects//instances/`. diff --git a/vmmigration/v1/vmmigration-api.json b/vmmigration/v1/vmmigration-api.json index 8dc686259f9..bdc41e4fd11 100644 --- a/vmmigration/v1/vmmigration-api.json +++ b/vmmigration/v1/vmmigration-api.json @@ -1180,66 +1180,6 @@ } } }, - "diskMigrationJobs": { - "methods": { - "cancel": { - "description": "Cancels the disk migration job.", - "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/sources/{sourcesId}/diskMigrationJobs/{diskMigrationJobsId}:cancel", - "httpMethod": "POST", - "id": "vmmigration.projects.locations.sources.diskMigrationJobs.cancel", - "parameterOrder": [ - "name" - ], - "parameters": { - "name": { - "description": "Required. The name of the DiskMigrationJob.", - "location": "path", - "pattern": "^projects/[^/]+/locations/[^/]+/sources/[^/]+/diskMigrationJobs/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1/{+name}:cancel", - "request": { - "$ref": "CancelDiskMigrationJobRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, - "run": { - "description": "Runs the disk migration job.", - "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/sources/{sourcesId}/diskMigrationJobs/{diskMigrationJobsId}:run", - "httpMethod": "POST", - "id": "vmmigration.projects.locations.sources.diskMigrationJobs.run", - "parameterOrder": [ - "name" - ], - "parameters": { - "name": { - "description": "Required. The name of the DiskMigrationJob.", - "location": "path", - "pattern": "^projects/[^/]+/locations/[^/]+/sources/[^/]+/diskMigrationJobs/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1/{+name}:run", - "request": { - "$ref": "RunDiskMigrationJobRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - } - } - }, "migratingVms": { "methods": { "create": { @@ -2280,7 +2220,7 @@ } } }, - "revision": "20240712", + "revision": "20240808", "rootUrl": "https://vmmigration.googleapis.com/", "schemas": { "AccessKeyCredentials": { @@ -2461,11 +2401,6 @@ "description": "User specified tags to add to every M2VM generated resource in AWS. These tags will be set in addition to the default tags that are set as part of the migration process. The tags must not begin with the reserved prefix `m2vm`.", "type": "object" }, - "networkInsights": { - "$ref": "NetworkInsights", - "description": "Output only. Information about the network coniguration of the source. Only gatherred upon request.", - "readOnly": true - }, "publicIp": { "description": "Output only. The source's public IP. All communication initiated by this source will originate from this IP.", "readOnly": true, @@ -2968,12 +2903,6 @@ "properties": {}, "type": "object" }, - "CancelDiskMigrationJobRequest": { - "description": "Request message for 'CancelDiskMigrationJob' request.", - "id": "CancelDiskMigrationJobRequest", - "properties": {}, - "type": "object" - }, "CancelImageImportJobRequest": { "description": "Request message for 'CancelImageImportJob' request.", "id": "CancelImageImportJobRequest", @@ -3180,6 +3109,20 @@ "description": "Output only. The OS license returned from the adaptation module report.", "readOnly": true }, + "bootConversion": { + "description": "Optional. By default the virtual machine will keep its existing boot option. Setting this property will trigger an internal process which will convert the virtual machine from using the existing boot option to another.", + "enum": [ + "BOOT_CONVERSION_UNSPECIFIED", + "NONE", + "BIOS_TO_EFI" + ], + "enumDescriptions": [ + "Unspecified conversion type.", + "No conversion.", + "Convert from BIOS to EFI." + ], + "type": "string" + }, "bootOption": { "description": "Output only. The VM Boot Option, as set in the source VM.", "enum": [ @@ -3217,6 +3160,14 @@ ], "type": "string" }, + "enableIntegrityMonitoring": { + "description": "Optional. Defines whether the instance has integrity monitoring enabled. This can be set to true only if the VM boot option is EFI, and vTPM is enabled.", + "type": "boolean" + }, + "enableVtpm": { + "description": "Optional. Defines whether the instance has vTPM enabled. This can be set to true only if the VM boot option is EFI.", + "type": "boolean" + }, "encryption": { "$ref": "Encryption", "description": "Optional. Immutable. The encryption to apply to the VM disks." @@ -3313,6 +3264,20 @@ "$ref": "AppliedLicense", "description": "The OS license returned from the adaptation module report." }, + "bootConversion": { + "description": "Optional. By default the virtual machine will keep its existing boot option. Setting this property will trigger an internal process which will convert the virtual machine from using the existing boot option to another.", + "enum": [ + "BOOT_CONVERSION_UNSPECIFIED", + "NONE", + "BIOS_TO_EFI" + ], + "enumDescriptions": [ + "Unspecified conversion type.", + "No conversion.", + "Convert from BIOS to EFI." + ], + "type": "string" + }, "bootOption": { "description": "The VM Boot Option, as set in the source VM.", "enum": [ @@ -3349,6 +3314,14 @@ ], "type": "string" }, + "enableIntegrityMonitoring": { + "description": "Optional. Defines whether the instance has integrity monitoring enabled.", + "type": "boolean" + }, + "enableVtpm": { + "description": "Optional. Defines whether the instance has vTPM enabled.", + "type": "boolean" + }, "encryption": { "$ref": "Encryption", "description": "Optional. The encryption to apply to the VM disks." @@ -3864,6 +3837,14 @@ "$ref": "ComputeScheduling", "description": "Optional. Compute instance scheduling information (if empty default is used)." }, + "enableIntegrityMonitoring": { + "description": "Optional. Defines whether the instance has integrity monitoring enabled.", + "type": "boolean" + }, + "enableVtpm": { + "description": "Optional. Defines whether the instance has vTPM enabled.", + "type": "boolean" + }, "encryption": { "$ref": "Encryption", "description": "Optional. The encryption to apply to the VM." @@ -5007,23 +4988,6 @@ }, "type": "object" }, - "NetworkInsights": { - "description": "Information about the network coniguration of the source.", - "id": "NetworkInsights", - "properties": { - "sourceNetworkConfig": { - "description": "Output only. The gathered network configuration of the source. Presented in json format.", - "readOnly": true, - "type": "string" - }, - "sourceNetworkTerraform": { - "description": "Output only. The gathered network configuration of the source. Presented in terraform format.", - "readOnly": true, - "type": "string" - } - }, - "type": "object" - }, "NetworkInterface": { "description": "NetworkInterface represents a NIC of a VM.", "id": "NetworkInterface", @@ -5041,7 +5005,7 @@ "type": "string" }, "networkTier": { - "description": "Optional. The networking tier used for configuring network access configuration. If left empty, will default to PREMIUM.", + "description": "Optional. The networking tier used for optimizing connectivity between instances and systems on the internet. Applies only for external ephemeral IP addresses. If left empty, will default to PREMIUM.", "enum": [ "COMPUTE_ENGINE_NETWORK_TIER_UNSPECIFIED", "NETWORK_TIER_STANDARD", @@ -5397,12 +5361,6 @@ "properties": {}, "type": "object" }, - "RunDiskMigrationJobRequest": { - "description": "Request message for 'RunDiskMigrationJobRequest' request.", - "id": "RunDiskMigrationJobRequest", - "properties": {}, - "type": "object" - }, "SchedulePolicy": { "description": "A policy for scheduling replications.", "id": "SchedulePolicy", diff --git a/vmmigration/v1/vmmigration-gen.go b/vmmigration/v1/vmmigration-gen.go index 7f7098c4578..a5c233a90a6 100644 --- a/vmmigration/v1/vmmigration-gen.go +++ b/vmmigration/v1/vmmigration-gen.go @@ -232,7 +232,6 @@ type ProjectsLocationsOperationsService struct { func NewProjectsLocationsSourcesService(s *Service) *ProjectsLocationsSourcesService { rs := &ProjectsLocationsSourcesService{s: s} rs.DatacenterConnectors = NewProjectsLocationsSourcesDatacenterConnectorsService(s) - rs.DiskMigrationJobs = NewProjectsLocationsSourcesDiskMigrationJobsService(s) rs.MigratingVms = NewProjectsLocationsSourcesMigratingVmsService(s) rs.UtilizationReports = NewProjectsLocationsSourcesUtilizationReportsService(s) return rs @@ -243,8 +242,6 @@ type ProjectsLocationsSourcesService struct { DatacenterConnectors *ProjectsLocationsSourcesDatacenterConnectorsService - DiskMigrationJobs *ProjectsLocationsSourcesDiskMigrationJobsService - MigratingVms *ProjectsLocationsSourcesMigratingVmsService UtilizationReports *ProjectsLocationsSourcesUtilizationReportsService @@ -259,15 +256,6 @@ type ProjectsLocationsSourcesDatacenterConnectorsService struct { s *Service } -func NewProjectsLocationsSourcesDiskMigrationJobsService(s *Service) *ProjectsLocationsSourcesDiskMigrationJobsService { - rs := &ProjectsLocationsSourcesDiskMigrationJobsService{s: s} - return rs -} - -type ProjectsLocationsSourcesDiskMigrationJobsService struct { - s *Service -} - func NewProjectsLocationsSourcesMigratingVmsService(s *Service) *ProjectsLocationsSourcesMigratingVmsService { rs := &ProjectsLocationsSourcesMigratingVmsService{s: s} rs.CloneJobs = NewProjectsLocationsSourcesMigratingVmsCloneJobsService(s) @@ -545,9 +533,6 @@ type AwsSourceDetails struct { // tags that are set as part of the migration process. The tags must not begin // with the reserved prefix `m2vm`. MigrationResourcesUserTags map[string]string `json:"migrationResourcesUserTags,omitempty"` - // NetworkInsights: Output only. Information about the network coniguration of - // the source. Only gatherred upon request. - NetworkInsights *NetworkInsights `json:"networkInsights,omitempty"` // PublicIp: Output only. The source's public IP. All communication initiated // by this source will originate from this IP. PublicIp string `json:"publicIp,omitempty"` @@ -969,11 +954,6 @@ type CancelCloneJobRequest struct { type CancelCutoverJobRequest struct { } -// CancelDiskMigrationJobRequest: Request message for 'CancelDiskMigrationJob' -// request. -type CancelDiskMigrationJobRequest struct { -} - // CancelImageImportJobRequest: Request message for 'CancelImageImportJob' // request. type CancelImageImportJobRequest struct { @@ -1175,6 +1155,16 @@ type ComputeEngineTargetDefaults struct { // AppliedLicense: Output only. The OS license returned from the adaptation // module report. AppliedLicense *AppliedLicense `json:"appliedLicense,omitempty"` + // BootConversion: Optional. By default the virtual machine will keep its + // existing boot option. Setting this property will trigger an internal process + // which will convert the virtual machine from using the existing boot option + // to another. + // + // Possible values: + // "BOOT_CONVERSION_UNSPECIFIED" - Unspecified conversion type. + // "NONE" - No conversion. + // "BIOS_TO_EFI" - Convert from BIOS to EFI. + BootConversion string `json:"bootConversion,omitempty"` // BootOption: Output only. The VM Boot Option, as set in the source VM. // // Possible values: @@ -1197,6 +1187,13 @@ type ComputeEngineTargetDefaults struct { // "COMPUTE_ENGINE_DISK_TYPE_HYPERDISK_BALANCED" - Hyperdisk balanced disk // type. DiskType string `json:"diskType,omitempty"` + // EnableIntegrityMonitoring: Optional. Defines whether the instance has + // integrity monitoring enabled. This can be set to true only if the VM boot + // option is EFI, and vTPM is enabled. + EnableIntegrityMonitoring bool `json:"enableIntegrityMonitoring,omitempty"` + // EnableVtpm: Optional. Defines whether the instance has vTPM enabled. This + // can be set to true only if the VM boot option is EFI. + EnableVtpm bool `json:"enableVtpm,omitempty"` // Encryption: Optional. Immutable. The encryption to apply to the VM disks. Encryption *Encryption `json:"encryption,omitempty"` // Hostname: The hostname to assign to the VM. @@ -1260,6 +1257,16 @@ type ComputeEngineTargetDetails struct { AdditionalLicenses []string `json:"additionalLicenses,omitempty"` // AppliedLicense: The OS license returned from the adaptation module report. AppliedLicense *AppliedLicense `json:"appliedLicense,omitempty"` + // BootConversion: Optional. By default the virtual machine will keep its + // existing boot option. Setting this property will trigger an internal process + // which will convert the virtual machine from using the existing boot option + // to another. + // + // Possible values: + // "BOOT_CONVERSION_UNSPECIFIED" - Unspecified conversion type. + // "NONE" - No conversion. + // "BIOS_TO_EFI" - Convert from BIOS to EFI. + BootConversion string `json:"bootConversion,omitempty"` // BootOption: The VM Boot Option, as set in the source VM. // // Possible values: @@ -1282,6 +1289,11 @@ type ComputeEngineTargetDetails struct { // "COMPUTE_ENGINE_DISK_TYPE_HYPERDISK_BALANCED" - Hyperdisk balanced disk // type. DiskType string `json:"diskType,omitempty"` + // EnableIntegrityMonitoring: Optional. Defines whether the instance has + // integrity monitoring enabled. + EnableIntegrityMonitoring bool `json:"enableIntegrityMonitoring,omitempty"` + // EnableVtpm: Optional. Defines whether the instance has vTPM enabled. + EnableVtpm bool `json:"enableVtpm,omitempty"` // Encryption: Optional. The encryption to apply to the VM disks. Encryption *Encryption `json:"encryption,omitempty"` // Hostname: The hostname to assign to the VM. @@ -1750,6 +1762,11 @@ type DisksMigrationVmTargetDefaults struct { // ComputeScheduling: Optional. Compute instance scheduling information (if // empty default is used). ComputeScheduling *ComputeScheduling `json:"computeScheduling,omitempty"` + // EnableIntegrityMonitoring: Optional. Defines whether the instance has + // integrity monitoring enabled. + EnableIntegrityMonitoring bool `json:"enableIntegrityMonitoring,omitempty"` + // EnableVtpm: Optional. Defines whether the instance has vTPM enabled. + EnableVtpm bool `json:"enableVtpm,omitempty"` // Encryption: Optional. The encryption to apply to the VM. Encryption *Encryption `json:"encryption,omitempty"` // Hostname: Optional. The hostname to assign to the VM. @@ -2915,32 +2932,6 @@ func (s MigrationWarning) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// NetworkInsights: Information about the network coniguration of the source. -type NetworkInsights struct { - // SourceNetworkConfig: Output only. The gathered network configuration of the - // source. Presented in json format. - SourceNetworkConfig string `json:"sourceNetworkConfig,omitempty"` - // SourceNetworkTerraform: Output only. The gathered network configuration of - // the source. Presented in terraform format. - SourceNetworkTerraform string `json:"sourceNetworkTerraform,omitempty"` - // ForceSendFields is a list of field names (e.g. "SourceNetworkConfig") 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. "SourceNetworkConfig") 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 NetworkInsights) MarshalJSON() ([]byte, error) { - type NoMethod NetworkInsights - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // NetworkInterface: NetworkInterface represents a NIC of a VM. type NetworkInterface struct { // ExternalIp: Optional. The external IP to define in the NIC. @@ -2951,8 +2942,9 @@ type NetworkInterface struct { InternalIp string `json:"internalIp,omitempty"` // Network: The network to connect the NIC to. Network string `json:"network,omitempty"` - // NetworkTier: Optional. The networking tier used for configuring network - // access configuration. If left empty, will default to PREMIUM. + // NetworkTier: Optional. The networking tier used for optimizing connectivity + // between instances and systems on the internet. Applies only for external + // ephemeral IP addresses. If left empty, will default to PREMIUM. // // Possible values: // "COMPUTE_ENGINE_NETWORK_TIER_UNSPECIFIED" - An unspecified network tier. @@ -3337,11 +3329,6 @@ func (s ReplicationSync) MarshalJSON() ([]byte, error) { type ResumeMigrationRequest struct { } -// RunDiskMigrationJobRequest: Request message for 'RunDiskMigrationJobRequest' -// request. -type RunDiskMigrationJobRequest struct { -} - // SchedulePolicy: A policy for scheduling replications. type SchedulePolicy struct { // IdleDuration: The idle duration between replication stages. @@ -7887,208 +7874,6 @@ func (c *ProjectsLocationsSourcesDatacenterConnectorsUpgradeApplianceCall) Do(op return ret, nil } -type ProjectsLocationsSourcesDiskMigrationJobsCancelCall struct { - s *Service - name string - canceldiskmigrationjobrequest *CancelDiskMigrationJobRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Cancel: Cancels the disk migration job. -// -// - name: The name of the DiskMigrationJob. -func (r *ProjectsLocationsSourcesDiskMigrationJobsService) Cancel(name string, canceldiskmigrationjobrequest *CancelDiskMigrationJobRequest) *ProjectsLocationsSourcesDiskMigrationJobsCancelCall { - c := &ProjectsLocationsSourcesDiskMigrationJobsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - c.canceldiskmigrationjobrequest = canceldiskmigrationjobrequest - 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 *ProjectsLocationsSourcesDiskMigrationJobsCancelCall) Fields(s ...googleapi.Field) *ProjectsLocationsSourcesDiskMigrationJobsCancelCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsSourcesDiskMigrationJobsCancelCall) Context(ctx context.Context) *ProjectsLocationsSourcesDiskMigrationJobsCancelCall { - 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 *ProjectsLocationsSourcesDiskMigrationJobsCancelCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsSourcesDiskMigrationJobsCancelCall) 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.canceldiskmigrationjobrequest) - if err != nil { - return nil, err - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:cancel") - 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{ - "name": c.name, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "vmmigration.projects.locations.sources.diskMigrationJobs.cancel" 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 *ProjectsLocationsSourcesDiskMigrationJobsCancelCall) 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 ProjectsLocationsSourcesDiskMigrationJobsRunCall struct { - s *Service - name string - rundiskmigrationjobrequest *RunDiskMigrationJobRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Run: Runs the disk migration job. -// -// - name: The name of the DiskMigrationJob. -func (r *ProjectsLocationsSourcesDiskMigrationJobsService) Run(name string, rundiskmigrationjobrequest *RunDiskMigrationJobRequest) *ProjectsLocationsSourcesDiskMigrationJobsRunCall { - c := &ProjectsLocationsSourcesDiskMigrationJobsRunCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - c.rundiskmigrationjobrequest = rundiskmigrationjobrequest - 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 *ProjectsLocationsSourcesDiskMigrationJobsRunCall) Fields(s ...googleapi.Field) *ProjectsLocationsSourcesDiskMigrationJobsRunCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsSourcesDiskMigrationJobsRunCall) Context(ctx context.Context) *ProjectsLocationsSourcesDiskMigrationJobsRunCall { - 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 *ProjectsLocationsSourcesDiskMigrationJobsRunCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsSourcesDiskMigrationJobsRunCall) 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.rundiskmigrationjobrequest) - if err != nil { - return nil, err - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:run") - 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{ - "name": c.name, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "vmmigration.projects.locations.sources.diskMigrationJobs.run" 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 *ProjectsLocationsSourcesDiskMigrationJobsRunCall) 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 ProjectsLocationsSourcesMigratingVmsCreateCall struct { s *Service parent string diff --git a/vmmigration/v1alpha1/vmmigration-api.json b/vmmigration/v1alpha1/vmmigration-api.json index 338595c2122..8cd2c47de3d 100644 --- a/vmmigration/v1alpha1/vmmigration-api.json +++ b/vmmigration/v1alpha1/vmmigration-api.json @@ -1180,66 +1180,6 @@ } } }, - "diskMigrationJobs": { - "methods": { - "cancel": { - "description": "Cancels the disk migration job.", - "flatPath": "v1alpha1/projects/{projectsId}/locations/{locationsId}/sources/{sourcesId}/diskMigrationJobs/{diskMigrationJobsId}:cancel", - "httpMethod": "POST", - "id": "vmmigration.projects.locations.sources.diskMigrationJobs.cancel", - "parameterOrder": [ - "name" - ], - "parameters": { - "name": { - "description": "Required. The name of the DiskMigrationJob.", - "location": "path", - "pattern": "^projects/[^/]+/locations/[^/]+/sources/[^/]+/diskMigrationJobs/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1alpha1/{+name}:cancel", - "request": { - "$ref": "CancelDiskMigrationJobRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, - "run": { - "description": "Runs the disk migration job.", - "flatPath": "v1alpha1/projects/{projectsId}/locations/{locationsId}/sources/{sourcesId}/diskMigrationJobs/{diskMigrationJobsId}:run", - "httpMethod": "POST", - "id": "vmmigration.projects.locations.sources.diskMigrationJobs.run", - "parameterOrder": [ - "name" - ], - "parameters": { - "name": { - "description": "Required. The name of the DiskMigrationJob.", - "location": "path", - "pattern": "^projects/[^/]+/locations/[^/]+/sources/[^/]+/diskMigrationJobs/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1alpha1/{+name}:run", - "request": { - "$ref": "RunDiskMigrationJobRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - } - } - }, "migratingVms": { "methods": { "create": { @@ -2280,7 +2220,7 @@ } } }, - "revision": "20240712", + "revision": "20240808", "rootUrl": "https://vmmigration.googleapis.com/", "schemas": { "AccessKeyCredentials": { @@ -2461,11 +2401,6 @@ "description": "User specified tags to add to every M2VM generated resource in AWS. These tags will be set in addition to the default tags that are set as part of the migration process. The tags must not begin with the reserved prefix `m2vm`.", "type": "object" }, - "networkInsights": { - "$ref": "NetworkInsights", - "description": "Output only. Information about the network coniguration of the source. Only gatherred upon request.", - "readOnly": true - }, "publicIp": { "description": "Output only. The source's public IP. All communication initiated by this source will originate from this IP.", "readOnly": true, @@ -2968,12 +2903,6 @@ "properties": {}, "type": "object" }, - "CancelDiskMigrationJobRequest": { - "description": "Request message for 'CancelDiskMigrationJob' request.", - "id": "CancelDiskMigrationJobRequest", - "properties": {}, - "type": "object" - }, "CancelImageImportJobRequest": { "description": "Request message for 'CancelImageImportJob' request.", "id": "CancelImageImportJobRequest", @@ -3192,6 +3121,20 @@ "description": "Output only. The OS license returned from the adaptation module report.", "readOnly": true }, + "bootConversion": { + "description": "Optional. By default the virtual machine will keep its existing boot option. Setting this property will trigger an internal process which will convert the virtual machine from using the existing boot option to another.", + "enum": [ + "BOOT_CONVERSION_UNSPECIFIED", + "NONE", + "BIOS_TO_EFI" + ], + "enumDescriptions": [ + "Unspecified conversion type.", + "No conversion.", + "Convert from BIOS to EFI." + ], + "type": "string" + }, "bootOption": { "description": "Output only. The VM Boot Option, as set in the source VM.", "enum": [ @@ -3229,6 +3172,14 @@ ], "type": "string" }, + "enableIntegrityMonitoring": { + "description": "Optional. Defines whether the instance has integrity monitoring enabled. This can be set to true only if the VM boot option is EFI, and vTPM is enabled.", + "type": "boolean" + }, + "enableVtpm": { + "description": "Optional. Defines whether the instance has vTPM enabled. This can be set to true only if the VM boot option is EFI.", + "type": "boolean" + }, "encryption": { "$ref": "Encryption", "description": "Optional. Immutable. The encryption to apply to the VM disks." @@ -3325,6 +3276,20 @@ "$ref": "AppliedLicense", "description": "The OS license returned from the adaptation module report." }, + "bootConversion": { + "description": "Optional. By default the virtual machine will keep its existing boot option. Setting this property will trigger an internal process which will convert the virtual machine from using the existing boot option to another.", + "enum": [ + "BOOT_CONVERSION_UNSPECIFIED", + "NONE", + "BIOS_TO_EFI" + ], + "enumDescriptions": [ + "Unspecified conversion type.", + "No conversion.", + "Convert from BIOS to EFI." + ], + "type": "string" + }, "bootOption": { "description": "The VM Boot Option, as set in the source VM.", "enum": [ @@ -3361,6 +3326,14 @@ ], "type": "string" }, + "enableIntegrityMonitoring": { + "description": "Optional. Defines whether the instance has integrity monitoring enabled.", + "type": "boolean" + }, + "enableVtpm": { + "description": "Optional. Defines whether the instance has vTPM enabled.", + "type": "boolean" + }, "encryption": { "$ref": "Encryption", "description": "Optional. The encryption to apply to the VM disks." @@ -3899,6 +3872,14 @@ "$ref": "ComputeScheduling", "description": "Optional. Compute instance scheduling information (if empty default is used)." }, + "enableIntegrityMonitoring": { + "description": "Optional. Defines whether the instance has integrity monitoring enabled.", + "type": "boolean" + }, + "enableVtpm": { + "description": "Optional. Defines whether the instance has vTPM enabled.", + "type": "boolean" + }, "encryption": { "$ref": "Encryption", "description": "Optional. The encryption to apply to the VM." @@ -5052,23 +5033,6 @@ }, "type": "object" }, - "NetworkInsights": { - "description": "Information about the network coniguration of the source.", - "id": "NetworkInsights", - "properties": { - "sourceNetworkConfig": { - "description": "Output only. The gathered network configuration of the source. Presented in json format.", - "readOnly": true, - "type": "string" - }, - "sourceNetworkTerraform": { - "description": "Output only. The gathered network configuration of the source. Presented in terraform format.", - "readOnly": true, - "type": "string" - } - }, - "type": "object" - }, "NetworkInterface": { "description": "NetworkInterface represents a NIC of a VM.", "id": "NetworkInterface", @@ -5086,7 +5050,7 @@ "type": "string" }, "networkTier": { - "description": "Optional. The networking tier used for configuring network access configuration. If left empty, will default to PREMIUM.", + "description": "Optional. The networking tier used for optimizing connectivity between instances and systems on the internet. Applies only for external ephemeral IP addresses. If left empty, will default to PREMIUM.", "enum": [ "COMPUTE_ENGINE_NETWORK_TIER_UNSPECIFIED", "NETWORK_TIER_STANDARD", @@ -5448,12 +5412,6 @@ "properties": {}, "type": "object" }, - "RunDiskMigrationJobRequest": { - "description": "Request message for 'RunDiskMigrationJobRequest' request.", - "id": "RunDiskMigrationJobRequest", - "properties": {}, - "type": "object" - }, "SchedulePolicy": { "description": "A policy for scheduling replications.", "id": "SchedulePolicy", diff --git a/vmmigration/v1alpha1/vmmigration-gen.go b/vmmigration/v1alpha1/vmmigration-gen.go index a4199c4dd0d..c8eab0e2569 100644 --- a/vmmigration/v1alpha1/vmmigration-gen.go +++ b/vmmigration/v1alpha1/vmmigration-gen.go @@ -232,7 +232,6 @@ type ProjectsLocationsOperationsService struct { func NewProjectsLocationsSourcesService(s *Service) *ProjectsLocationsSourcesService { rs := &ProjectsLocationsSourcesService{s: s} rs.DatacenterConnectors = NewProjectsLocationsSourcesDatacenterConnectorsService(s) - rs.DiskMigrationJobs = NewProjectsLocationsSourcesDiskMigrationJobsService(s) rs.MigratingVms = NewProjectsLocationsSourcesMigratingVmsService(s) rs.UtilizationReports = NewProjectsLocationsSourcesUtilizationReportsService(s) return rs @@ -243,8 +242,6 @@ type ProjectsLocationsSourcesService struct { DatacenterConnectors *ProjectsLocationsSourcesDatacenterConnectorsService - DiskMigrationJobs *ProjectsLocationsSourcesDiskMigrationJobsService - MigratingVms *ProjectsLocationsSourcesMigratingVmsService UtilizationReports *ProjectsLocationsSourcesUtilizationReportsService @@ -259,15 +256,6 @@ type ProjectsLocationsSourcesDatacenterConnectorsService struct { s *Service } -func NewProjectsLocationsSourcesDiskMigrationJobsService(s *Service) *ProjectsLocationsSourcesDiskMigrationJobsService { - rs := &ProjectsLocationsSourcesDiskMigrationJobsService{s: s} - return rs -} - -type ProjectsLocationsSourcesDiskMigrationJobsService struct { - s *Service -} - func NewProjectsLocationsSourcesMigratingVmsService(s *Service) *ProjectsLocationsSourcesMigratingVmsService { rs := &ProjectsLocationsSourcesMigratingVmsService{s: s} rs.CloneJobs = NewProjectsLocationsSourcesMigratingVmsCloneJobsService(s) @@ -545,9 +533,6 @@ type AwsSourceDetails struct { // tags that are set as part of the migration process. The tags must not begin // with the reserved prefix `m2vm`. MigrationResourcesUserTags map[string]string `json:"migrationResourcesUserTags,omitempty"` - // NetworkInsights: Output only. Information about the network coniguration of - // the source. Only gatherred upon request. - NetworkInsights *NetworkInsights `json:"networkInsights,omitempty"` // PublicIp: Output only. The source's public IP. All communication initiated // by this source will originate from this IP. PublicIp string `json:"publicIp,omitempty"` @@ -969,11 +954,6 @@ type CancelCloneJobRequest struct { type CancelCutoverJobRequest struct { } -// CancelDiskMigrationJobRequest: Request message for 'CancelDiskMigrationJob' -// request. -type CancelDiskMigrationJobRequest struct { -} - // CancelImageImportJobRequest: Request message for 'CancelImageImportJob' // request. type CancelImageImportJobRequest struct { @@ -1181,6 +1161,16 @@ type ComputeEngineTargetDefaults struct { // AppliedLicense: Output only. The OS license returned from the adaptation // module report. AppliedLicense *AppliedLicense `json:"appliedLicense,omitempty"` + // BootConversion: Optional. By default the virtual machine will keep its + // existing boot option. Setting this property will trigger an internal process + // which will convert the virtual machine from using the existing boot option + // to another. + // + // Possible values: + // "BOOT_CONVERSION_UNSPECIFIED" - Unspecified conversion type. + // "NONE" - No conversion. + // "BIOS_TO_EFI" - Convert from BIOS to EFI. + BootConversion string `json:"bootConversion,omitempty"` // BootOption: Output only. The VM Boot Option, as set in the source VM. // // Possible values: @@ -1203,6 +1193,13 @@ type ComputeEngineTargetDefaults struct { // "COMPUTE_ENGINE_DISK_TYPE_HYPERDISK_BALANCED" - Hyperdisk balanced disk // type. DiskType string `json:"diskType,omitempty"` + // EnableIntegrityMonitoring: Optional. Defines whether the instance has + // integrity monitoring enabled. This can be set to true only if the VM boot + // option is EFI, and vTPM is enabled. + EnableIntegrityMonitoring bool `json:"enableIntegrityMonitoring,omitempty"` + // EnableVtpm: Optional. Defines whether the instance has vTPM enabled. This + // can be set to true only if the VM boot option is EFI. + EnableVtpm bool `json:"enableVtpm,omitempty"` // Encryption: Optional. Immutable. The encryption to apply to the VM disks. Encryption *Encryption `json:"encryption,omitempty"` // Hostname: The hostname to assign to the VM. @@ -1266,6 +1263,16 @@ type ComputeEngineTargetDetails struct { AdditionalLicenses []string `json:"additionalLicenses,omitempty"` // AppliedLicense: The OS license returned from the adaptation module report. AppliedLicense *AppliedLicense `json:"appliedLicense,omitempty"` + // BootConversion: Optional. By default the virtual machine will keep its + // existing boot option. Setting this property will trigger an internal process + // which will convert the virtual machine from using the existing boot option + // to another. + // + // Possible values: + // "BOOT_CONVERSION_UNSPECIFIED" - Unspecified conversion type. + // "NONE" - No conversion. + // "BIOS_TO_EFI" - Convert from BIOS to EFI. + BootConversion string `json:"bootConversion,omitempty"` // BootOption: The VM Boot Option, as set in the source VM. // // Possible values: @@ -1288,6 +1295,11 @@ type ComputeEngineTargetDetails struct { // "COMPUTE_ENGINE_DISK_TYPE_HYPERDISK_BALANCED" - Hyperdisk balanced disk // type. DiskType string `json:"diskType,omitempty"` + // EnableIntegrityMonitoring: Optional. Defines whether the instance has + // integrity monitoring enabled. + EnableIntegrityMonitoring bool `json:"enableIntegrityMonitoring,omitempty"` + // EnableVtpm: Optional. Defines whether the instance has vTPM enabled. + EnableVtpm bool `json:"enableVtpm,omitempty"` // Encryption: Optional. The encryption to apply to the VM disks. Encryption *Encryption `json:"encryption,omitempty"` // Hostname: The hostname to assign to the VM. @@ -1766,6 +1778,11 @@ type DisksMigrationVmTargetDefaults struct { // ComputeScheduling: Optional. Compute instance scheduling information (if // empty default is used). ComputeScheduling *ComputeScheduling `json:"computeScheduling,omitempty"` + // EnableIntegrityMonitoring: Optional. Defines whether the instance has + // integrity monitoring enabled. + EnableIntegrityMonitoring bool `json:"enableIntegrityMonitoring,omitempty"` + // EnableVtpm: Optional. Defines whether the instance has vTPM enabled. + EnableVtpm bool `json:"enableVtpm,omitempty"` // Encryption: Optional. The encryption to apply to the VM. Encryption *Encryption `json:"encryption,omitempty"` // Hostname: Optional. The hostname to assign to the VM. @@ -2938,32 +2955,6 @@ func (s MigrationWarning) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// NetworkInsights: Information about the network coniguration of the source. -type NetworkInsights struct { - // SourceNetworkConfig: Output only. The gathered network configuration of the - // source. Presented in json format. - SourceNetworkConfig string `json:"sourceNetworkConfig,omitempty"` - // SourceNetworkTerraform: Output only. The gathered network configuration of - // the source. Presented in terraform format. - SourceNetworkTerraform string `json:"sourceNetworkTerraform,omitempty"` - // ForceSendFields is a list of field names (e.g. "SourceNetworkConfig") 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. "SourceNetworkConfig") 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 NetworkInsights) MarshalJSON() ([]byte, error) { - type NoMethod NetworkInsights - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // NetworkInterface: NetworkInterface represents a NIC of a VM. type NetworkInterface struct { // ExternalIp: Optional. The external IP to define in the NIC. @@ -2974,8 +2965,9 @@ type NetworkInterface struct { InternalIp string `json:"internalIp,omitempty"` // Network: The network to connect the NIC to. Network string `json:"network,omitempty"` - // NetworkTier: Optional. The networking tier used for configuring network - // access configuration. If left empty, will default to PREMIUM. + // NetworkTier: Optional. The networking tier used for optimizing connectivity + // between instances and systems on the internet. Applies only for external + // ephemeral IP addresses. If left empty, will default to PREMIUM. // // Possible values: // "COMPUTE_ENGINE_NETWORK_TIER_UNSPECIFIED" - An unspecified network tier. @@ -3362,11 +3354,6 @@ func (s ReplicationSync) MarshalJSON() ([]byte, error) { type ResumeMigrationRequest struct { } -// RunDiskMigrationJobRequest: Request message for 'RunDiskMigrationJobRequest' -// request. -type RunDiskMigrationJobRequest struct { -} - // SchedulePolicy: A policy for scheduling replications. type SchedulePolicy struct { // IdleDuration: The idle duration between replication stages. @@ -8024,208 +8011,6 @@ func (c *ProjectsLocationsSourcesDatacenterConnectorsUpgradeApplianceCall) Do(op return ret, nil } -type ProjectsLocationsSourcesDiskMigrationJobsCancelCall struct { - s *Service - name string - canceldiskmigrationjobrequest *CancelDiskMigrationJobRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Cancel: Cancels the disk migration job. -// -// - name: The name of the DiskMigrationJob. -func (r *ProjectsLocationsSourcesDiskMigrationJobsService) Cancel(name string, canceldiskmigrationjobrequest *CancelDiskMigrationJobRequest) *ProjectsLocationsSourcesDiskMigrationJobsCancelCall { - c := &ProjectsLocationsSourcesDiskMigrationJobsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - c.canceldiskmigrationjobrequest = canceldiskmigrationjobrequest - 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 *ProjectsLocationsSourcesDiskMigrationJobsCancelCall) Fields(s ...googleapi.Field) *ProjectsLocationsSourcesDiskMigrationJobsCancelCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsSourcesDiskMigrationJobsCancelCall) Context(ctx context.Context) *ProjectsLocationsSourcesDiskMigrationJobsCancelCall { - 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 *ProjectsLocationsSourcesDiskMigrationJobsCancelCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsSourcesDiskMigrationJobsCancelCall) 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.canceldiskmigrationjobrequest) - if err != nil { - return nil, err - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha1/{+name}:cancel") - 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{ - "name": c.name, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "vmmigration.projects.locations.sources.diskMigrationJobs.cancel" 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 *ProjectsLocationsSourcesDiskMigrationJobsCancelCall) 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 ProjectsLocationsSourcesDiskMigrationJobsRunCall struct { - s *Service - name string - rundiskmigrationjobrequest *RunDiskMigrationJobRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Run: Runs the disk migration job. -// -// - name: The name of the DiskMigrationJob. -func (r *ProjectsLocationsSourcesDiskMigrationJobsService) Run(name string, rundiskmigrationjobrequest *RunDiskMigrationJobRequest) *ProjectsLocationsSourcesDiskMigrationJobsRunCall { - c := &ProjectsLocationsSourcesDiskMigrationJobsRunCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - c.rundiskmigrationjobrequest = rundiskmigrationjobrequest - 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 *ProjectsLocationsSourcesDiskMigrationJobsRunCall) Fields(s ...googleapi.Field) *ProjectsLocationsSourcesDiskMigrationJobsRunCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsSourcesDiskMigrationJobsRunCall) Context(ctx context.Context) *ProjectsLocationsSourcesDiskMigrationJobsRunCall { - 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 *ProjectsLocationsSourcesDiskMigrationJobsRunCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsSourcesDiskMigrationJobsRunCall) 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.rundiskmigrationjobrequest) - if err != nil { - return nil, err - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha1/{+name}:run") - 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{ - "name": c.name, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "vmmigration.projects.locations.sources.diskMigrationJobs.run" 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 *ProjectsLocationsSourcesDiskMigrationJobsRunCall) 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 ProjectsLocationsSourcesMigratingVmsCreateCall struct { s *Service parent string diff --git a/youtube/v3/youtube-api.json b/youtube/v3/youtube-api.json index 4c0e1dfe098..57933503ba4 100644 --- a/youtube/v3/youtube-api.json +++ b/youtube/v3/youtube-api.json @@ -1770,7 +1770,7 @@ "type": "string" }, "part": { - "description": "The *part* parameter specifies the liveChatComment resource parts that the API response will include. Supported values are id and snippet.", + "description": "The *part* parameter specifies the liveChatComment resource parts that the API response will include. Supported values are id, snippet, and authorDetails.", "location": "query", "repeated": true, "required": true, @@ -4072,7 +4072,7 @@ } } }, - "revision": "20240514", + "revision": "20240814", "rootUrl": "https://youtube.googleapis.com/", "schemas": { "AbuseReport": { @@ -10259,6 +10259,18 @@ "PlaylistStatus": { "id": "PlaylistStatus", "properties": { + "podcastStatus": { + "description": "The playlist's podcast status.", + "enum": [ + "enabled", + "disabled" + ], + "enumDescriptions": [ + "", + "" + ], + "type": "string" + }, "privacyStatus": { "description": "The playlist's privacy status.", "enum": [ diff --git a/youtube/v3/youtube-gen.go b/youtube/v3/youtube-gen.go index 87ed93a47c6..90ba46f5453 100644 --- a/youtube/v3/youtube-gen.go +++ b/youtube/v3/youtube-gen.go @@ -6381,6 +6381,12 @@ func (s PlaylistSnippet) MarshalJSON() ([]byte, error) { } type PlaylistStatus struct { + // PodcastStatus: The playlist's podcast status. + // + // Possible values: + // "enabled" + // "disabled" + PodcastStatus string `json:"podcastStatus,omitempty"` // PrivacyStatus: The playlist's privacy status. // // Possible values: @@ -6388,13 +6394,13 @@ type PlaylistStatus struct { // "unlisted" // "private" PrivacyStatus string `json:"privacyStatus,omitempty"` - // ForceSendFields is a list of field names (e.g. "PrivacyStatus") to + // ForceSendFields is a list of field names (e.g. "PodcastStatus") 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. "PrivacyStatus") to include in API + // NullFields is a list of field names (e.g. "PodcastStatus") 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. @@ -13159,7 +13165,8 @@ type LiveChatMessagesListCall struct { // // - liveChatId: The id of the live chat for which comments should be returned. // - part: The *part* parameter specifies the liveChatComment resource parts -// that the API response will include. Supported values are id and snippet. +// that the API response will include. Supported values are id, snippet, and +// authorDetails. func (r *LiveChatMessagesService) List(liveChatId string, part []string) *LiveChatMessagesListCall { c := &LiveChatMessagesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.urlParams_.Set("liveChatId", liveChatId)