diff --git a/CHANGES.md b/CHANGES.md index 46a57ffb27e..cc1dcf26895 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -1,5 +1,29 @@ # Changes +## [0.204.0](https://github.com/googleapis/google-api-go-client/compare/v0.203.0...v0.204.0) (2024-10-31) + + +### Features + +* **all:** Auto-regenerate discovery clients ([#2837](https://github.com/googleapis/google-api-go-client/issues/2837)) ([343ae0e](https://github.com/googleapis/google-api-go-client/commit/343ae0e8222988b33ce388661056cd3a834a54a6)) +* **all:** Auto-regenerate discovery clients ([#2839](https://github.com/googleapis/google-api-go-client/issues/2839)) ([37b271e](https://github.com/googleapis/google-api-go-client/commit/37b271e98c5041584a0c4fc0741c2798ab05dbca)) +* **all:** Auto-regenerate discovery clients ([#2841](https://github.com/googleapis/google-api-go-client/issues/2841)) ([fb3747b](https://github.com/googleapis/google-api-go-client/commit/fb3747b8f9c99f0cf41b5830322192bcb0092f0a)) +* **all:** Auto-regenerate discovery clients ([#2842](https://github.com/googleapis/google-api-go-client/issues/2842)) ([7221d2c](https://github.com/googleapis/google-api-go-client/commit/7221d2c798d6ae77f88c60de23e5871e92fe03d3)) +* **all:** Auto-regenerate discovery clients ([#2844](https://github.com/googleapis/google-api-go-client/issues/2844)) ([56c5ddb](https://github.com/googleapis/google-api-go-client/commit/56c5ddb8eaf93f57891f285d913b21fb357b87a0)) +* **all:** Auto-regenerate discovery clients ([#2845](https://github.com/googleapis/google-api-go-client/issues/2845)) ([9d5f008](https://github.com/googleapis/google-api-go-client/commit/9d5f008642ce0996af3e4c84f9a017b64c6eb3d3)) +* **all:** Auto-regenerate discovery clients ([#2848](https://github.com/googleapis/google-api-go-client/issues/2848)) ([5bc448d](https://github.com/googleapis/google-api-go-client/commit/5bc448d6497f0c355b530d7b17d9f034a02aee6f)) +* **all:** Auto-regenerate discovery clients ([#2850](https://github.com/googleapis/google-api-go-client/issues/2850)) ([7955ec4](https://github.com/googleapis/google-api-go-client/commit/7955ec454d23d0a36a8ae1c0253b95f7fa3a930c)) + + +### Bug Fixes + +* **transport/grpc:** Pass through cert source to new auth lib ([#2840](https://github.com/googleapis/google-api-go-client/issues/2840)) ([c67e7c0](https://github.com/googleapis/google-api-go-client/commit/c67e7c09f9cbe3aea06cfe54f4e550ac16725c6c)) + + +### Documentation + +* Mark WithUniverseDomain as stable ([#2847](https://github.com/googleapis/google-api-go-client/issues/2847)) ([29e20f6](https://github.com/googleapis/google-api-go-client/commit/29e20f602923858630f5e00d5fbd303bcf421f13)) + ## [0.203.0](https://github.com/googleapis/google-api-go-client/compare/v0.202.0...v0.203.0) (2024-10-23) diff --git a/accesscontextmanager/v1/accesscontextmanager-api.json b/accesscontextmanager/v1/accesscontextmanager-api.json index c9a118fd722..fdce80f6af9 100644 --- a/accesscontextmanager/v1/accesscontextmanager-api.json +++ b/accesscontextmanager/v1/accesscontextmanager-api.json @@ -1206,7 +1206,7 @@ ], "parameters": { "append": { - "description": "Optional. This field controls whether or not certain repeated settings in the update request overwrite or append to existing settings on the binding. If true, then append. Otherwise overwrite. So far, only scoped_access_settings supports appending. Global access_levels, dry_run_access_levels, and reauth_settings are not compatible with append functionality, and the request will return an error if append=true when these settings are in the update_mask. The request will also return an error if append=true when \"scoped_access_settings\" is not set in the update_mask.", + "description": "Optional. This field controls whether or not certain repeated settings in the update request overwrite or append to existing settings on the binding. If true, then append. Otherwise overwrite. So far, only scoped_access_settings supports appending. Global access_levels, dry_run_access_levels, reauth_settings, and session_settings are not compatible with append functionality, and the request will return an error if append=true when these settings are in the update_mask. The request will also return an error if append=true when \"scoped_access_settings\" is not set in the update_mask.", "location": "query", "type": "boolean" }, @@ -1218,7 +1218,7 @@ "type": "string" }, "updateMask": { - "description": "Required. Only the fields specified in this mask are updated. Because name and group_key cannot be changed, update_mask is required and may only contain the following fields: `access_levels`, `dry_run_access_levels`, `reauth_settings`, `scoped_access_settings`. update_mask { paths: \"access_levels\" }", + "description": "Required. Only the fields specified in this mask are updated. Because name and group_key cannot be changed, update_mask is required and may only contain the following fields: `access_levels`, `dry_run_access_levels`, `reauth_settings` `session_settings`, `scoped_access_settings`. update_mask { paths: \"access_levels\" }", "format": "google-fieldmask", "location": "query", "type": "string" @@ -1295,7 +1295,7 @@ } } }, - "revision": "20241014", + "revision": "20241022", "rootUrl": "https://accesscontextmanager.googleapis.com/", "schemas": { "AccessContextManagerOperationMetadata": { @@ -1387,6 +1387,10 @@ "reauthSettings": { "$ref": "ReauthSettings", "description": "Optional. Reauth settings applied to user access on a given AccessScope." + }, + "sessionSettings": { + "$ref": "SessionSettings", + "description": "Optional. Session settings applied to user access on a given AccessScope. Migrated from ReauthSettings" } }, "type": "object" @@ -1880,7 +1884,7 @@ "type": "object" }, "GcpUserAccessBinding": { - "description": "Restricts access to Cloud Console and Google Cloud APIs for a set of users using Context-Aware Access.", + "description": "Restricts access to Cloud Console and Google Cloud APIs for a set of users using Context-Aware Access. Next ID: 11", "id": "GcpUserAccessBinding", "properties": { "accessLevels": { @@ -2500,6 +2504,47 @@ }, "type": "object" }, + "SessionSettings": { + "description": "Stores settings related to Google Cloud Session Length including session duration, the type of challenge (i.e. method) they should face when their session expires, and other related settings.", + "id": "SessionSettings", + "properties": { + "maxInactivity": { + "description": "Optional. How long a user is allowed to take between actions before a new access token must be issued. Presently only set for Cloud Apps.", + "format": "google-duration", + "type": "string" + }, + "sessionLength": { + "description": "Optional. The session length. Setting this field to zero is equal to disabling. Session. Also can set infinite session by flipping the enabled bit to false below. If use_oidc_max_age is true, for OIDC apps, the session length will be the minimum of this field and OIDC max_age param.", + "format": "google-duration", + "type": "string" + }, + "sessionLengthEnabled": { + "description": "Optional. Big red button to turn off GCSL. When false, all fields set above will be disregarded and the session length is basically infinite.", + "type": "boolean" + }, + "sessionReauthMethod": { + "description": "Optional. Session method when users GCP session is up.", + "enum": [ + "SESSION_REAUTH_METHOD_UNSPECIFIED", + "LOGIN", + "SECURITY_KEY", + "PASSWORD" + ], + "enumDescriptions": [ + "If method undefined in API, we will use LOGIN by default.", + "The user will prompted to perform regular login. Users who are enrolled for two-step verification and haven't chosen to \"Remember this computer\" will be prompted for their second factor.", + "The user will be prompted to autheticate using their security key. If no security key has been configured, then we will fallback to LOGIN.", + "The user will be prompted for their password." + ], + "type": "string" + }, + "useOidcMaxAge": { + "description": "Optional. Only useful for OIDC apps. When false, the OIDC max_age param, if passed in the authentication request will be ignored. When true, the re-auth period will be the minimum of the session_length field and the max_age OIDC param.", + "type": "boolean" + } + }, + "type": "object" + }, "SetIamPolicyRequest": { "description": "Request message for `SetIamPolicy` method.", "id": "SetIamPolicyRequest", diff --git a/accesscontextmanager/v1/accesscontextmanager-gen.go b/accesscontextmanager/v1/accesscontextmanager-gen.go index b883825b92e..1ea5064d44a 100644 --- a/accesscontextmanager/v1/accesscontextmanager-gen.go +++ b/accesscontextmanager/v1/accesscontextmanager-gen.go @@ -380,6 +380,9 @@ type AccessSettings struct { // ReauthSettings: Optional. Reauth settings applied to user access on a given // AccessScope. ReauthSettings *ReauthSettings `json:"reauthSettings,omitempty"` + // SessionSettings: Optional. Session settings applied to user access on a + // given AccessScope. Migrated from ReauthSettings + SessionSettings *SessionSettings `json:"sessionSettings,omitempty"` // ForceSendFields is a list of field names (e.g. "AccessLevels") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -1188,7 +1191,7 @@ func (s Expr) MarshalJSON() ([]byte, error) { } // GcpUserAccessBinding: Restricts access to Cloud Console and Google Cloud -// APIs for a set of users using Context-Aware Access. +// APIs for a set of users using Context-Aware Access. Next ID: 11 type GcpUserAccessBinding struct { // AccessLevels: Optional. Access level that a user must have to be granted // access. Only one access level is supported, not multiple. This repeated @@ -2185,6 +2188,58 @@ func (s ServicePerimeterConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// SessionSettings: Stores settings related to Google Cloud Session Length +// including session duration, the type of challenge (i.e. method) they should +// face when their session expires, and other related settings. +type SessionSettings struct { + // MaxInactivity: Optional. How long a user is allowed to take between actions + // before a new access token must be issued. Presently only set for Cloud Apps. + MaxInactivity string `json:"maxInactivity,omitempty"` + // SessionLength: Optional. The session length. Setting this field to zero is + // equal to disabling. Session. Also can set infinite session by flipping the + // enabled bit to false below. If use_oidc_max_age is true, for OIDC apps, the + // session length will be the minimum of this field and OIDC max_age param. + SessionLength string `json:"sessionLength,omitempty"` + // SessionLengthEnabled: Optional. Big red button to turn off GCSL. When false, + // all fields set above will be disregarded and the session length is basically + // infinite. + SessionLengthEnabled bool `json:"sessionLengthEnabled,omitempty"` + // SessionReauthMethod: Optional. Session method when users GCP session is up. + // + // Possible values: + // "SESSION_REAUTH_METHOD_UNSPECIFIED" - If method undefined in API, we will + // use LOGIN by default. + // "LOGIN" - The user will prompted to perform regular login. Users who are + // enrolled for two-step verification and haven't chosen to "Remember this + // computer" will be prompted for their second factor. + // "SECURITY_KEY" - The user will be prompted to autheticate using their + // security key. If no security key has been configured, then we will fallback + // to LOGIN. + // "PASSWORD" - The user will be prompted for their password. + SessionReauthMethod string `json:"sessionReauthMethod,omitempty"` + // UseOidcMaxAge: Optional. Only useful for OIDC apps. When false, the OIDC + // max_age param, if passed in the authentication request will be ignored. When + // true, the re-auth period will be the minimum of the session_length field and + // the max_age OIDC param. + UseOidcMaxAge bool `json:"useOidcMaxAge,omitempty"` + // ForceSendFields is a list of field names (e.g. "MaxInactivity") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "MaxInactivity") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s SessionSettings) MarshalJSON() ([]byte, error) { + type NoMethod SessionSettings + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // SetIamPolicyRequest: Request message for `SetIamPolicy` method. type SetIamPolicyRequest struct { // Policy: REQUIRED: The complete policy to be applied to the `resource`. The @@ -6605,11 +6660,11 @@ func (r *OrganizationsGcpUserAccessBindingsService) Patch(name string, gcpuserac // not certain repeated settings in the update request overwrite or append to // existing settings on the binding. If true, then append. Otherwise overwrite. // So far, only scoped_access_settings supports appending. Global -// access_levels, dry_run_access_levels, and reauth_settings are not compatible -// with append functionality, and the request will return an error if -// append=true when these settings are in the update_mask. The request will -// also return an error if append=true when "scoped_access_settings" is not set -// in the update_mask. +// access_levels, dry_run_access_levels, reauth_settings, and session_settings +// are not compatible with append functionality, and the request will return an +// error if append=true when these settings are in the update_mask. The request +// will also return an error if append=true when "scoped_access_settings" is +// not set in the update_mask. func (c *OrganizationsGcpUserAccessBindingsPatchCall) Append(append bool) *OrganizationsGcpUserAccessBindingsPatchCall { c.urlParams_.Set("append", fmt.Sprint(append)) return c @@ -6618,8 +6673,9 @@ func (c *OrganizationsGcpUserAccessBindingsPatchCall) Append(append bool) *Organ // UpdateMask sets the optional parameter "updateMask": Required. Only the // fields specified in this mask are updated. Because name and group_key cannot // be changed, update_mask is required and may only contain the following -// fields: `access_levels`, `dry_run_access_levels`, `reauth_settings`, -// `scoped_access_settings`. update_mask { paths: "access_levels" } +// fields: `access_levels`, `dry_run_access_levels`, `reauth_settings` +// `session_settings`, `scoped_access_settings`. update_mask { paths: +// "access_levels" } func (c *OrganizationsGcpUserAccessBindingsPatchCall) UpdateMask(updateMask string) *OrganizationsGcpUserAccessBindingsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c diff --git a/aiplatform/v1/aiplatform-api.json b/aiplatform/v1/aiplatform-api.json index a8f5d532d87..b1a84d2598a 100644 --- a/aiplatform/v1/aiplatform-api.json +++ b/aiplatform/v1/aiplatform-api.json @@ -5401,7 +5401,7 @@ "type": "string" }, "updateMask": { - "description": "Field mask is used to specify the fields to be overwritten in the FeatureView resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then only the non-empty fields present in the request will be overwritten. Set the update_mask to `*` to override all fields. Updatable fields: * `labels` * `service_agent_type` * `big_query_source` * `big_query_source.uri` * `big_query_source.entity_id_columns` * `feature_registry_source` * `feature_registry_source.feature_groups` * `sync_config` * `sync_config.cron`", + "description": "Field mask is used to specify the fields to be overwritten in the FeatureView resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then only the non-empty fields present in the request will be overwritten. Set the update_mask to `*` to override all fields. Updatable fields: * `labels` * `service_agent_type` * `big_query_source` * `big_query_source.uri` * `big_query_source.entity_id_columns` * `feature_registry_source` * `feature_registry_source.feature_groups` * `sync_config` * `sync_config.cron` * `optimized_config.automatic_resources`", "format": "google-fieldmask", "location": "query", "type": "string" @@ -12796,6 +12796,34 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "stop": { + "description": "Stops a NotebookRuntime.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/notebookRuntimes/{notebookRuntimesId}:stop", + "httpMethod": "POST", + "id": "aiplatform.projects.locations.notebookRuntimes.stop", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the NotebookRuntime resource to be stopped. Instead of checking whether the name is in valid NotebookRuntime resource name format, directly throw NotFound exception if there is no such NotebookRuntime in spanner.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/notebookRuntimes/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}:stop", + "request": { + "$ref": "GoogleCloudAiplatformV1StopNotebookRuntimeRequest" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "upgrade": { "description": "Upgrades a NotebookRuntime.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/notebookRuntimes/{notebookRuntimesId}:upgrade", @@ -17874,7 +17902,7 @@ } } }, - "revision": "20241007", + "revision": "20241025", "rootUrl": "https://aiplatform.googleapis.com/", "schemas": { "CloudAiLargeModelsVisionGenerateVideoResponse": { @@ -19655,6 +19683,18 @@ }, "type": "object" }, + "GoogleCloudAiplatformV1ClientConnectionConfig": { + "description": "Configurations (e.g. inference timeout) that are applied on your endpoints.", + "id": "GoogleCloudAiplatformV1ClientConnectionConfig", + "properties": { + "inferenceTimeout": { + "description": "Customizable online prediction request timeout.", + "format": "google-duration", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudAiplatformV1CoherenceInput": { "description": "Input for coherence metric.", "id": "GoogleCloudAiplatformV1CoherenceInput", @@ -20547,10 +20587,6 @@ "description": "The ID of the location to store protected artifacts. e.g. us-central1. Populate only when the location is different than CustomJob location. List of supported locations: https://cloud.google.com/vertex-ai/docs/general/locations", "type": "string" }, - "pscInterfaceConfig": { - "$ref": "GoogleCloudAiplatformV1PscInterfaceConfig", - "description": "Optional. Configuration for PSC-I for CustomJob." - }, "reservedIpRanges": { "description": "Optional. A list of names for the reserved ip ranges under the VPC network that can be used for this job. If set, we will deploy the job within the provided ip ranges. Otherwise, the job will be deployed to any ip ranges under the provided VPC network. Example: ['vertex-ai-ip-range'].", "items": { @@ -21352,6 +21388,13 @@ "sharedResources": { "description": "The resource name of the shared DeploymentResourcePool to deploy on. Format: `projects/{project}/locations/{location}/deploymentResourcePools/{deployment_resource_pool}`", "type": "string" + }, + "systemLabels": { + "additionalProperties": { + "type": "string" + }, + "description": "System labels to apply to Model Garden deployments. System labels are managed by Google for internal use only.", + "type": "object" } }, "type": "object" @@ -21562,6 +21605,10 @@ "description": "Models are deployed into it, and afterwards Endpoint is called to obtain predictions and explanations.", "id": "GoogleCloudAiplatformV1Endpoint", "properties": { + "clientConnectionConfig": { + "$ref": "GoogleCloudAiplatformV1ClientConnectionConfig", + "description": "Configurations that are applied to the endpoint for online prediction." + }, "createTime": { "description": "Output only. Timestamp when this Endpoint was created.", "format": "google-datetime", @@ -23669,6 +23716,10 @@ "description": "Identifier. Name of the FeatureView. Format: `projects/{project}/locations/{location}/featureOnlineStores/{feature_online_store}/featureViews/{feature_view}`", "type": "string" }, + "optimizedConfig": { + "$ref": "GoogleCloudAiplatformV1FeatureViewOptimizedConfig", + "description": "Optional. Configuration for FeatureView created under Optimized FeatureOnlineStore." + }, "satisfiesPzi": { "description": "Output only. Reserved for future use.", "readOnly": true, @@ -23848,6 +23899,17 @@ }, "type": "object" }, + "GoogleCloudAiplatformV1FeatureViewOptimizedConfig": { + "description": "Configuration for FeatureViews created in Optimized FeatureOnlineStore.", + "id": "GoogleCloudAiplatformV1FeatureViewOptimizedConfig", + "properties": { + "automaticResources": { + "$ref": "GoogleCloudAiplatformV1AutomaticResources", + "description": "Optional. A description of resources that the FeatureView uses, which to large degree are decided by Vertex AI, and optionally allows only a modest additional configuration. If min_replica_count is not set, the default value is 2. If max_replica_count is not set, the default value is 6. The max allowed replica count is 1000." + } + }, + "type": "object" + }, "GoogleCloudAiplatformV1FeatureViewSync": { "description": "FeatureViewSync is a representation of sync operation which copies data from data source to Feature View in Online Store.", "id": "GoogleCloudAiplatformV1FeatureViewSync", @@ -25049,6 +25111,10 @@ "description": "Chunk from context retrieved by the retrieval tools.", "id": "GoogleCloudAiplatformV1GroundingChunkRetrievedContext", "properties": { + "text": { + "description": "Text of the attribution.", + "type": "string" + }, "title": { "description": "Title of the attribution.", "type": "string" @@ -31006,12 +31072,6 @@ }, "type": "object" }, - "GoogleCloudAiplatformV1PscInterfaceConfig": { - "description": "Configuration for PSC-I.", - "id": "GoogleCloudAiplatformV1PscInterfaceConfig", - "properties": {}, - "type": "object" - }, "GoogleCloudAiplatformV1PublisherModel": { "description": "A Model Garden Publisher Model.", "id": "GoogleCloudAiplatformV1PublisherModel", @@ -31223,7 +31283,7 @@ "additionalProperties": { "type": "string" }, - "description": "Optional. Labels for the deployment. For managing deployment config like verifying, source of deployment config, etc.", + "description": "Optional. Labels for the deployment config. For managing deployment config like verifying, source of deployment config, etc.", "type": "object" }, "sampleRequest": { @@ -35102,6 +35162,14 @@ }, "type": "array" }, + "infillPrefix": { + "description": "Preamble: For infill prompt, the prefix before expected model response.", + "type": "string" + }, + "infillSuffix": { + "description": "Preamble: For infill prompt, the suffix after expected model response.", + "type": "string" + }, "inputPrefixes": { "description": "Preamble: The input prefixes before each example input.", "items": { @@ -35116,6 +35184,13 @@ }, "type": "array" }, + "predictionInputs": { + "description": "Preamble: The input test data for prediction. Each PartList in this field represents one text-only input set for a single model request.", + "items": { + "$ref": "GoogleCloudAiplatformV1SchemaPromptSpecPartList" + }, + "type": "array" + }, "promptMessage": { "$ref": "GoogleCloudAiplatformV1SchemaPromptSpecPromptMessage", "description": "The prompt message." @@ -37467,6 +37542,12 @@ "properties": {}, "type": "object" }, + "GoogleCloudAiplatformV1StopNotebookRuntimeRequest": { + "description": "Request message for NotebookService.StopNotebookRuntime.", + "id": "GoogleCloudAiplatformV1StopNotebookRuntimeRequest", + "properties": {}, + "type": "object" + }, "GoogleCloudAiplatformV1StopTrialRequest": { "description": "Request message for VizierService.StopTrial.", "id": "GoogleCloudAiplatformV1StopTrialRequest", @@ -40349,6 +40430,7 @@ "type": "array" }, "similarityTopK": { + "deprecated": true, "description": "Optional. Number of top k results to return from the selected corpora.", "format": "int32", "type": "integer" diff --git a/aiplatform/v1/aiplatform-gen.go b/aiplatform/v1/aiplatform-gen.go index 1fcadfd0326..907dccf3a92 100644 --- a/aiplatform/v1/aiplatform-gen.go +++ b/aiplatform/v1/aiplatform-gen.go @@ -3949,6 +3949,29 @@ func (s GoogleCloudAiplatformV1CitationMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudAiplatformV1ClientConnectionConfig: Configurations (e.g. +// inference timeout) that are applied on your endpoints. +type GoogleCloudAiplatformV1ClientConnectionConfig struct { + // InferenceTimeout: Customizable online prediction request timeout. + InferenceTimeout string `json:"inferenceTimeout,omitempty"` + // ForceSendFields is a list of field names (e.g. "InferenceTimeout") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "InferenceTimeout") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAiplatformV1ClientConnectionConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1ClientConnectionConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAiplatformV1CoherenceInput: Input for coherence metric. type GoogleCloudAiplatformV1CoherenceInput struct { // Instance: Required. Coherence instance. @@ -5335,8 +5358,6 @@ type GoogleCloudAiplatformV1CustomJobSpec struct { // than CustomJob location. List of supported locations: // https://cloud.google.com/vertex-ai/docs/general/locations ProtectedArtifactLocationId string `json:"protectedArtifactLocationId,omitempty"` - // PscInterfaceConfig: Optional. Configuration for PSC-I for CustomJob. - PscInterfaceConfig *GoogleCloudAiplatformV1PscInterfaceConfig `json:"pscInterfaceConfig,omitempty"` // ReservedIpRanges: Optional. A list of names for the reserved ip ranges under // the VPC network that can be used for this job. If set, we will deploy the // job within the provided ip ranges. Otherwise, the job will be deployed to @@ -6425,6 +6446,9 @@ type GoogleCloudAiplatformV1DeployedModel struct { // `projects/{project}/locations/{location}/deploymentResourcePools/{deployment_ // resource_pool}` SharedResources string `json:"sharedResources,omitempty"` + // SystemLabels: System labels to apply to Model Garden deployments. System + // labels are managed by Google for internal use only. + SystemLabels map[string]string `json:"systemLabels,omitempty"` // ForceSendFields is a list of field names (e.g. "AutomaticResources") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -6794,6 +6818,9 @@ func (s GoogleCloudAiplatformV1EncryptionSpec) MarshalJSON() ([]byte, error) { // GoogleCloudAiplatformV1Endpoint: Models are deployed into it, and afterwards // Endpoint is called to obtain predictions and explanations. type GoogleCloudAiplatformV1Endpoint struct { + // ClientConnectionConfig: Configurations that are applied to the endpoint for + // online prediction. + ClientConnectionConfig *GoogleCloudAiplatformV1ClientConnectionConfig `json:"clientConnectionConfig,omitempty"` // CreateTime: Output only. Timestamp when this Endpoint was created. CreateTime string `json:"createTime,omitempty"` // DedicatedEndpointDns: Output only. DNS of the dedicated endpoint. Will only @@ -6872,15 +6899,15 @@ type GoogleCloudAiplatformV1Endpoint struct { // 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 + // ForceSendFields is a list of field names (e.g. "ClientConnectionConfig") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://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 + // NullFields is a list of field names (e.g. "ClientConnectionConfig") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -9668,6 +9695,9 @@ type GoogleCloudAiplatformV1FeatureView struct { // `projects/{project}/locations/{location}/featureOnlineStores/{feature_online_ // store}/featureViews/{feature_view}` Name string `json:"name,omitempty"` + // OptimizedConfig: Optional. Configuration for FeatureView created under + // Optimized FeatureOnlineStore. + OptimizedConfig *GoogleCloudAiplatformV1FeatureViewOptimizedConfig `json:"optimizedConfig,omitempty"` // SatisfiesPzi: Output only. Reserved for future use. SatisfiesPzi bool `json:"satisfiesPzi,omitempty"` // SatisfiesPzs: Output only. Reserved for future use. @@ -9918,6 +9948,33 @@ func (s GoogleCloudAiplatformV1FeatureViewIndexConfigTreeAHConfig) MarshalJSON() return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudAiplatformV1FeatureViewOptimizedConfig: Configuration for +// FeatureViews created in Optimized FeatureOnlineStore. +type GoogleCloudAiplatformV1FeatureViewOptimizedConfig struct { + // AutomaticResources: Optional. A description of resources that the + // FeatureView uses, which to large degree are decided by Vertex AI, and + // optionally allows only a modest additional configuration. If + // min_replica_count is not set, the default value is 2. If max_replica_count + // is not set, the default value is 6. The max allowed replica count is 1000. + AutomaticResources *GoogleCloudAiplatformV1AutomaticResources `json:"automaticResources,omitempty"` + // ForceSendFields is a list of field names (e.g. "AutomaticResources") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AutomaticResources") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAiplatformV1FeatureViewOptimizedConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1FeatureViewOptimizedConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAiplatformV1FeatureViewSync: FeatureViewSync is a representation // of sync operation which copies data from data source to Feature View in // Online Store. @@ -11791,19 +11848,21 @@ func (s GoogleCloudAiplatformV1GroundingChunk) MarshalJSON() ([]byte, error) { // GoogleCloudAiplatformV1GroundingChunkRetrievedContext: Chunk from context // retrieved by the retrieval tools. type GoogleCloudAiplatformV1GroundingChunkRetrievedContext struct { + // Text: Text of the attribution. + Text string `json:"text,omitempty"` // Title: Title of the attribution. Title string `json:"title,omitempty"` // Uri: URI reference of the attribution. Uri string `json:"uri,omitempty"` - // ForceSendFields is a list of field names (e.g. "Title") to unconditionally + // 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. "Title") 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. "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:"-"` } @@ -19832,10 +19891,6 @@ func (s GoogleCloudAiplatformV1PscAutomatedEndpoints) MarshalJSON() ([]byte, err return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudAiplatformV1PscInterfaceConfig: Configuration for PSC-I. -type GoogleCloudAiplatformV1PscInterfaceConfig struct { -} - // GoogleCloudAiplatformV1PublisherModel: A Model Garden Publisher Model. type GoogleCloudAiplatformV1PublisherModel struct { // Frameworks: Optional. Additional information about the model's Frameworks. @@ -20027,8 +20082,8 @@ func (s GoogleCloudAiplatformV1PublisherModelCallToActionDeploy) MarshalJSON() ( // GoogleCloudAiplatformV1PublisherModelCallToActionDeployDeployMetadata: // Metadata information about the deployment for managing deployment config. type GoogleCloudAiplatformV1PublisherModelCallToActionDeployDeployMetadata struct { - // Labels: Optional. Labels for the deployment. For managing deployment config - // like verifying, source of deployment config, etc. + // Labels: Optional. Labels for the deployment config. For managing deployment + // config like verifying, source of deployment config, etc. Labels map[string]string `json:"labels,omitempty"` // SampleRequest: Optional. Sample request for deployed endpoint. SampleRequest string `json:"sampleRequest,omitempty"` @@ -26049,10 +26104,20 @@ type GoogleCloudAiplatformV1SchemaPromptSpecStructuredPrompt struct { Context *GoogleCloudAiplatformV1Content `json:"context,omitempty"` // Examples: Preamble: A set of examples for expected model response. Examples []*GoogleCloudAiplatformV1SchemaPromptSpecPartList `json:"examples,omitempty"` + // InfillPrefix: Preamble: For infill prompt, the prefix before expected model + // response. + InfillPrefix string `json:"infillPrefix,omitempty"` + // InfillSuffix: Preamble: For infill prompt, the suffix after expected model + // response. + InfillSuffix string `json:"infillSuffix,omitempty"` // InputPrefixes: Preamble: The input prefixes before each example input. InputPrefixes []string `json:"inputPrefixes,omitempty"` // OutputPrefixes: Preamble: The output prefixes before each example output. OutputPrefixes []string `json:"outputPrefixes,omitempty"` + // PredictionInputs: Preamble: The input test data for prediction. Each + // PartList in this field represents one text-only input set for a single model + // request. + PredictionInputs []*GoogleCloudAiplatformV1SchemaPromptSpecPartList `json:"predictionInputs,omitempty"` // PromptMessage: The prompt message. PromptMessage *GoogleCloudAiplatformV1SchemaPromptSpecPromptMessage `json:"promptMessage,omitempty"` // ForceSendFields is a list of field names (e.g. "Context") to unconditionally @@ -29904,6 +29969,11 @@ func (s GoogleCloudAiplatformV1StartNotebookRuntimeOperationMetadata) MarshalJSO type GoogleCloudAiplatformV1StartNotebookRuntimeRequest struct { } +// GoogleCloudAiplatformV1StopNotebookRuntimeRequest: Request message for +// NotebookService.StopNotebookRuntime. +type GoogleCloudAiplatformV1StopNotebookRuntimeRequest struct { +} + // GoogleCloudAiplatformV1StopTrialRequest: Request message for // VizierService.StopTrial. type GoogleCloudAiplatformV1StopTrialRequest struct { @@ -53440,7 +53510,7 @@ func (r *ProjectsLocationsFeatureOnlineStoresFeatureViewsService) Patch(name str // `big_query_source` * `big_query_source.uri` * // `big_query_source.entity_id_columns` * `feature_registry_source` * // `feature_registry_source.feature_groups` * `sync_config` * -// `sync_config.cron` +// `sync_config.cron` * `optimized_config.automatic_resources` func (c *ProjectsLocationsFeatureOnlineStoresFeatureViewsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsFeatureOnlineStoresFeatureViewsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -80879,6 +80949,111 @@ func (c *ProjectsLocationsNotebookRuntimesStartCall) Do(opts ...googleapi.CallOp return ret, nil } +type ProjectsLocationsNotebookRuntimesStopCall struct { + s *Service + name string + googlecloudaiplatformv1stopnotebookruntimerequest *GoogleCloudAiplatformV1StopNotebookRuntimeRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Stop: Stops a NotebookRuntime. +// +// - name: The name of the NotebookRuntime resource to be stopped. Instead of +// checking whether the name is in valid NotebookRuntime resource name +// format, directly throw NotFound exception if there is no such +// NotebookRuntime in spanner. +func (r *ProjectsLocationsNotebookRuntimesService) Stop(name string, googlecloudaiplatformv1stopnotebookruntimerequest *GoogleCloudAiplatformV1StopNotebookRuntimeRequest) *ProjectsLocationsNotebookRuntimesStopCall { + c := &ProjectsLocationsNotebookRuntimesStopCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googlecloudaiplatformv1stopnotebookruntimerequest = googlecloudaiplatformv1stopnotebookruntimerequest + 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 *ProjectsLocationsNotebookRuntimesStopCall) Fields(s ...googleapi.Field) *ProjectsLocationsNotebookRuntimesStopCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsNotebookRuntimesStopCall) Context(ctx context.Context) *ProjectsLocationsNotebookRuntimesStopCall { + 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 *ProjectsLocationsNotebookRuntimesStopCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsNotebookRuntimesStopCall) 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.googlecloudaiplatformv1stopnotebookruntimerequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:stop") + 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 "aiplatform.projects.locations.notebookRuntimes.stop" 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 *ProjectsLocationsNotebookRuntimesStopCall) 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 ProjectsLocationsNotebookRuntimesUpgradeCall struct { s *Service name string diff --git a/aiplatform/v1beta1/aiplatform-api.json b/aiplatform/v1beta1/aiplatform-api.json index 95734a54552..141a51f0b00 100644 --- a/aiplatform/v1beta1/aiplatform-api.json +++ b/aiplatform/v1beta1/aiplatform-api.json @@ -4990,6 +4990,34 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "update": { + "description": "Updates an Endpoint with a long running operation.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}:update", + "httpMethod": "POST", + "id": "aiplatform.projects.locations.endpoints.update", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Output only. The resource name of the Endpoint.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+name}:update", + "request": { + "$ref": "GoogleCloudAiplatformV1beta1UpdateEndpointLongRunningRequest" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } }, "resources": { @@ -7100,7 +7128,7 @@ "type": "string" }, "updateMask": { - "description": "Field mask is used to specify the fields to be overwritten in the FeatureView resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then only the non-empty fields present in the request will be overwritten. Set the update_mask to `*` to override all fields. Updatable fields: * `labels` * `service_agent_type` * `big_query_source` * `big_query_source.uri` * `big_query_source.entity_id_columns` * `feature_registry_source` * `feature_registry_source.feature_groups` * `sync_config` * `sync_config.cron`", + "description": "Field mask is used to specify the fields to be overwritten in the FeatureView resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then only the non-empty fields present in the request will be overwritten. Set the update_mask to `*` to override all fields. Updatable fields: * `labels` * `service_agent_type` * `big_query_source` * `big_query_source.uri` * `big_query_source.entity_id_columns` * `feature_registry_source` * `feature_registry_source.feature_groups` * `sync_config` * `sync_config.cron` * `optimized_config.automatic_resources`", "format": "google-fieldmask", "location": "query", "type": "string" @@ -15140,6 +15168,34 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "stop": { + "description": "Stops a NotebookRuntime.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookRuntimes/{notebookRuntimesId}:stop", + "httpMethod": "POST", + "id": "aiplatform.projects.locations.notebookRuntimes.stop", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the NotebookRuntime resource to be stopped. Instead of checking whether the name is in valid NotebookRuntime resource name format, directly throw NotFound exception if there is no such NotebookRuntime in spanner.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/notebookRuntimes/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+name}:stop", + "request": { + "$ref": "GoogleCloudAiplatformV1beta1StopNotebookRuntimeRequest" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "upgrade": { "description": "Upgrades a NotebookRuntime.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookRuntimes/{notebookRuntimesId}:upgrade", @@ -21230,7 +21286,7 @@ } } }, - "revision": "20241007", + "revision": "20241025", "rootUrl": "https://aiplatform.googleapis.com/", "schemas": { "CloudAiLargeModelsVisionGenerateVideoResponse": { @@ -23440,6 +23496,45 @@ }, "type": "object" }, + "GoogleCloudAiplatformV1beta1ClientConnectionConfig": { + "description": "Configurations (e.g. inference timeout) that are applied on your endpoints.", + "id": "GoogleCloudAiplatformV1beta1ClientConnectionConfig", + "properties": { + "inferenceTimeout": { + "description": "Customizable online prediction request timeout.", + "format": "google-duration", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudAiplatformV1beta1CodeExecutionResult": { + "description": "Result of executing the [ExecutableCode]. Always follows a `part` containing the [ExecutableCode].", + "id": "GoogleCloudAiplatformV1beta1CodeExecutionResult", + "properties": { + "outcome": { + "description": "Required. Outcome of the code execution.", + "enum": [ + "OUTCOME_UNSPECIFIED", + "OUTCOME_OK", + "OUTCOME_FAILED", + "OUTCOME_DEADLINE_EXCEEDED" + ], + "enumDescriptions": [ + "Unspecified status. This value should not be used.", + "Code execution completed successfully.", + "Code execution finished but with a failure. `stderr` should contain the reason.", + "Code execution ran for too long, and was cancelled. There may or may not be a partial output present." + ], + "type": "string" + }, + "output": { + "description": "Optional. Contains stdout when code execution is successful, stderr or other description otherwise.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudAiplatformV1beta1CoherenceInput": { "description": "Input for coherence metric.", "id": "GoogleCloudAiplatformV1beta1CoherenceInput", @@ -25418,6 +25513,13 @@ "sharedResources": { "description": "The resource name of the shared DeploymentResourcePool to deploy on. Format: `projects/{project}/locations/{location}/deploymentResourcePools/{deployment_resource_pool}`", "type": "string" + }, + "systemLabels": { + "additionalProperties": { + "type": "string" + }, + "description": "System labels to apply to Model Garden deployments. System labels are managed by Google for internal use only.", + "type": "object" } }, "type": "object" @@ -25718,6 +25820,10 @@ "description": "Models are deployed into it, and afterwards Endpoint is called to obtain predictions and explanations.", "id": "GoogleCloudAiplatformV1beta1Endpoint", "properties": { + "clientConnectionConfig": { + "$ref": "GoogleCloudAiplatformV1beta1ClientConnectionConfig", + "description": "Configurations that are applied to the endpoint for online prediction." + }, "createTime": { "description": "Output only. Timestamp when this Endpoint was created.", "format": "google-datetime", @@ -26466,6 +26572,29 @@ }, "type": "object" }, + "GoogleCloudAiplatformV1beta1ExecutableCode": { + "description": "Code generated by the model that is meant to be executed, and the result returned to the model. Generated when using the [FunctionDeclaration] tool and [FunctionCallingConfig] mode is set to [Mode.CODE].", + "id": "GoogleCloudAiplatformV1beta1ExecutableCode", + "properties": { + "code": { + "description": "Required. The code to be executed.", + "type": "string" + }, + "language": { + "description": "Required. Programming language of the `code`.", + "enum": [ + "LANGUAGE_UNSPECIFIED", + "PYTHON" + ], + "enumDescriptions": [ + "Unspecified language. This value should not be used.", + "Python \u003e= 3.10, with numpy and simpy available." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudAiplatformV1beta1ExecuteExtensionRequest": { "description": "Request message for ExtensionExecutionService.ExecuteExtension.", "id": "GoogleCloudAiplatformV1beta1ExecuteExtensionRequest", @@ -27337,7 +27466,7 @@ }, "privateServiceConnectConfig": { "$ref": "GoogleCloudAiplatformV1beta1ExtensionPrivateServiceConnectConfig", - "description": "Optional. The PrivateServiceConnect config for the extension. If specified, the service endpoints associated with the Extension should be registered with private network access in the provided Service Directory (https://cloud.google.com/service-directory/docs/configuring-private-network-access). If the service contains more than one endpoint with a network, the service will arbitrarilty choose one of the endpoints to use for extension execution." + "description": "Optional. The PrivateServiceConnect config for the extension. If specified, the service endpoints associated with the Extension should be [registered with private network access in the provided Service Directory](https://cloud.google.com/service-directory/docs/configuring-private-network-access). If the service contains more than one endpoint with a network, the service will arbitrarilty choose one of the endpoints to use for extension execution." }, "runtimeConfig": { "$ref": "GoogleCloudAiplatformV1beta1RuntimeConfig", @@ -29679,6 +29808,10 @@ "description": "Chunk from context retrieved by the retrieval tools.", "id": "GoogleCloudAiplatformV1beta1GroundingChunkRetrievedContext", "properties": { + "text": { + "description": "Text of the attribution.", + "type": "string" + }, "title": { "description": "Title of the attribution.", "type": "string" @@ -30162,14 +30295,17 @@ }, "partialFailureBigquerySink": { "$ref": "GoogleCloudAiplatformV1beta1BigQueryDestination", - "description": "The BigQuery destination to write partial failures to. It should be a bigquery table resource name (e.g. \"bq://projectId.bqDatasetId.bqTableId\"). If the dataset id does not exist, it will be created. If the table does not exist, it will be created with the expected schema. If the table exists, the schema will be validated and data will be added to this existing table." + "deprecated": true, + "description": "The BigQuery destination to write partial failures to. It should be a bigquery table resource name (e.g. \"bq://projectId.bqDatasetId.bqTableId\"). The dataset must exist. If the table does not exist, it will be created with the expected schema. If the table exists, the schema will be validated and data will be added to this existing table. Deprecated. Prefer to use `import_result_bq_sink`." }, "partialFailureGcsSink": { "$ref": "GoogleCloudAiplatformV1beta1GcsDestination", - "description": "The Cloud Storage path to write partial failures to." + "deprecated": true, + "description": "The Cloud Storage path to write partial failures to. Deprecated. Prefer to use `import_result_gcs_sink`." }, "ragFileChunkingConfig": { "$ref": "GoogleCloudAiplatformV1beta1RagFileChunkingConfig", + "deprecated": true, "description": "Specifies the size and overlap of chunks after importing RagFiles." }, "ragFileParsingConfig": { @@ -30738,7 +30874,7 @@ "properties": { "apiKeyConfig": { "$ref": "GoogleCloudAiplatformV1beta1ApiAuthApiKeyConfig", - "description": "Required. The SecretManager secret version resource name (e.g. projects/{project}/secrets/{secret}/versions/{version}) storing the Jira API key (https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/)." + "description": "Required. The SecretManager secret version resource name (e.g. projects/{project}/secrets/{secret}/versions/{version}) storing the Jira API key. See [Manage API tokens for your Atlassian account](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/)." }, "customQueries": { "description": "A list of custom Jira queries to import. For information about JQL (Jira Query Language), see https://support.atlassian.com/jira-service-management-cloud/docs/use-advanced-search-with-jira-query-language-jql/", @@ -35779,6 +35915,14 @@ "description": "A datatype containing media that is part of a multi-part `Content` message. A `Part` consists of data which has an associated datatype. A `Part` can only contain one of the accepted types in `Part.data`. A `Part` must have a fixed IANA MIME type identifying the type and subtype of the media if `inline_data` or `file_data` field is filled with raw bytes.", "id": "GoogleCloudAiplatformV1beta1Part", "properties": { + "codeExecutionResult": { + "$ref": "GoogleCloudAiplatformV1beta1CodeExecutionResult", + "description": "Optional. Result of executing the [ExecutableCode]." + }, + "executableCode": { + "$ref": "GoogleCloudAiplatformV1beta1ExecutableCode", + "description": "Optional. Code generated by the model that is meant to be executed." + }, "fileData": { "$ref": "GoogleCloudAiplatformV1beta1FileData", "description": "Optional. URI based data." @@ -36157,6 +36301,10 @@ "description": "The runtime config of a PipelineJob.", "id": "GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfig", "properties": { + "defaultRuntime": { + "$ref": "GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfigDefaultRuntime", + "description": "Optional. The default runtime for the PipelineJob. If not provided, Vertex Custom Job(on demand) is used as the runtime. For Vertex Custom Job, please refer to https://cloud.google.com/vertex-ai/docs/training/overview." + }, "failurePolicy": { "description": "Represents the failure policy of a pipeline. Currently, the default of a pipeline is that the pipeline will continue to run until no more tasks can be executed, also known as PIPELINE_FAILURE_POLICY_FAIL_SLOW. However, if a pipeline is set to PIPELINE_FAILURE_POLICY_FAIL_FAST, it will stop scheduling any new tasks when a task has failed. Any scheduled tasks will continue to completion.", "enum": [ @@ -36200,6 +36348,17 @@ }, "type": "object" }, + "GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfigDefaultRuntime": { + "description": "The default runtime for the PipelineJob.", + "id": "GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfigDefaultRuntime", + "properties": { + "persistentResourceRuntimeDetail": { + "$ref": "GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfigPersistentResourceRuntimeDetail", + "description": "Persistent resource based runtime detail." + } + }, + "type": "object" + }, "GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfigInputArtifact": { "description": "The type of an input artifact.", "id": "GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfigInputArtifact", @@ -36211,6 +36370,36 @@ }, "type": "object" }, + "GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfigPersistentResourceRuntimeDetail": { + "description": "Persistent resource based runtime detail. For more information, refer to https://cloud.google.com/vertex-ai/docs/training/persistent-resource-overview", + "id": "GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfigPersistentResourceRuntimeDetail", + "properties": { + "persistentResourceName": { + "description": "Persistent resource name. Format: `projects/{project}/locations/{location}/persistentResources/{persistent_resource}`", + "type": "string" + }, + "taskResourceUnavailableTimeoutBehavior": { + "description": "Specifies the behavior to take if the timeout is reached.", + "enum": [ + "TASK_RESOURCE_UNAVAILABLE_TIMEOUT_BEHAVIOR_UNSPECIFIED", + "FAIL", + "FALL_BACK_TO_ON_DEMAND" + ], + "enumDescriptions": [ + "Unspecified. Behavior is same as `FAIL`.", + "Fail the task if the timeout is reached.", + "Fall back to on-demand execution if the timeout is reached." + ], + "type": "string" + }, + "taskResourceUnavailableWaitTimeMs": { + "description": "The max time a pipeline task waits for the required CPU, memory, or accelerator resource to become available from the specified persistent resource. Default wait time is 0.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudAiplatformV1beta1PipelineTaskDetail": { "description": "The runtime detail of a task execution.", "id": "GoogleCloudAiplatformV1beta1PipelineTaskDetail", @@ -36865,7 +37054,7 @@ "id": "GoogleCloudAiplatformV1beta1PscInterfaceConfig", "properties": { "networkAttachment": { - "description": "Optional. The full name of the Compute Engine [network attachment](https://cloud.google.com/vpc/docs/about-network-attachments) to attach to the resource. For example, `projects/12345/regions/us-central1/networkAttachments/myNA`. is of the form `projects/{project}/regions/{region}/networkAttachments/{networkAttachment}`. Where {project} is a project number, as in `12345`, and {networkAttachment} is a network attachment name. To specify this field, you must have already [created a network attachment] (https://cloud.google.com/vpc/docs/create-manage-network-attachments#create-network-attachments). This field is only used for resources using PSC-I.", + "description": "Optional. The name of the Compute Engine [network attachment](https://cloud.google.com/vpc/docs/about-network-attachments) to attach to the resource within the region and user project. To specify this field, you must have already [created a network attachment] (https://cloud.google.com/vpc/docs/create-manage-network-attachments#create-network-attachments). This field is only used for resources using PSC-I.", "type": "string" } }, @@ -37086,7 +37275,7 @@ "additionalProperties": { "type": "string" }, - "description": "Optional. Labels for the deployment. For managing deployment config like verifying, source of deployment config, etc.", + "description": "Optional. Labels for the deployment config. For managing deployment config like verifying, source of deployment config, etc.", "type": "object" }, "sampleRequest": { @@ -37901,10 +38090,12 @@ }, "ragEmbeddingModelConfig": { "$ref": "GoogleCloudAiplatformV1beta1RagEmbeddingModelConfig", + "deprecated": true, "description": "Optional. Immutable. The embedding model config of the RagCorpus." }, "ragVectorDbConfig": { "$ref": "GoogleCloudAiplatformV1beta1RagVectorDbConfig", + "deprecated": true, "description": "Optional. Immutable. The Vector DB config of the RagCorpus." }, "updateTime": { @@ -38089,11 +38280,13 @@ "id": "GoogleCloudAiplatformV1beta1RagFileChunkingConfig", "properties": { "chunkOverlap": { + "deprecated": true, "description": "The overlap between chunks.", "format": "int32", "type": "integer" }, "chunkSize": { + "deprecated": true, "description": "The size of the chunks.", "format": "int32", "type": "integer" @@ -38106,6 +38299,7 @@ "id": "GoogleCloudAiplatformV1beta1RagFileParsingConfig", "properties": { "useAdvancedPdfParsing": { + "deprecated": true, "description": "Whether to use advanced PDF parsing.", "type": "boolean" } @@ -38118,9 +38312,11 @@ "properties": { "ranking": { "$ref": "GoogleCloudAiplatformV1beta1RagQueryRanking", + "deprecated": true, "description": "Optional. Configurations for hybrid search results ranking." }, "similarityTopK": { + "deprecated": true, "description": "Optional. The number of contexts to retrieve.", "format": "int32", "type": "integer" @@ -38278,6 +38474,13 @@ "description": "Optional. Default image for user to choose a preferred ML framework (for example, TensorFlow or Pytorch) by choosing from [Vertex prebuilt images](https://cloud.google.com/vertex-ai/docs/training/pre-built-containers). Either this or the resource_pool_images is required. Use this field if you need all the resource pools to have the same Ray image. Otherwise, use the {@code resource_pool_images} field.", "type": "string" }, + "nfsMounts": { + "description": "Optional. Use if you want to mount to any NFS storages.", + "items": { + "$ref": "GoogleCloudAiplatformV1beta1NfsMount" + }, + "type": "array" + }, "rayLogsSpec": { "$ref": "GoogleCloudAiplatformV1beta1RayLogsSpec", "description": "Optional. OSS Ray logging configurations." @@ -38545,7 +38748,7 @@ "id": "GoogleCloudAiplatformV1beta1ReasoningEngineSpec", "properties": { "classMethods": { - "description": "Optional. Declarations for object class methods.", + "description": "Optional. Declarations for object class methods in OpenAPI specification format.", "items": { "additionalProperties": { "description": "Properties of the object.", @@ -41793,6 +41996,14 @@ }, "type": "array" }, + "infillPrefix": { + "description": "Preamble: For infill prompt, the prefix before expected model response.", + "type": "string" + }, + "infillSuffix": { + "description": "Preamble: For infill prompt, the suffix after expected model response.", + "type": "string" + }, "inputPrefixes": { "description": "Preamble: The input prefixes before each example input.", "items": { @@ -41807,6 +42018,13 @@ }, "type": "array" }, + "predictionInputs": { + "description": "Preamble: The input test data for prediction. Each PartList in this field represents one text-only input set for a single model request.", + "items": { + "$ref": "GoogleCloudAiplatformV1beta1SchemaPromptSpecPartList" + }, + "type": "array" + }, "promptMessage": { "$ref": "GoogleCloudAiplatformV1beta1SchemaPromptSpecPromptMessage", "description": "The prompt message." @@ -44404,6 +44622,12 @@ "properties": {}, "type": "object" }, + "GoogleCloudAiplatformV1beta1StopNotebookRuntimeRequest": { + "description": "Request message for NotebookService.StopNotebookRuntime.", + "id": "GoogleCloudAiplatformV1beta1StopNotebookRuntimeRequest", + "properties": {}, + "type": "object" + }, "GoogleCloudAiplatformV1beta1StopTrialRequest": { "description": "Request message for VizierService.StopTrial.", "id": "GoogleCloudAiplatformV1beta1StopTrialRequest", @@ -46266,6 +46490,10 @@ "description": "Tool details that the model may use to generate response. A `Tool` is a piece of code that enables the system to interact with external systems to perform an action, or set of actions, outside of knowledge and scope of the model. A Tool object should contain exactly one type of Tool (e.g FunctionDeclaration, Retrieval or GoogleSearchRetrieval).", "id": "GoogleCloudAiplatformV1beta1Tool", "properties": { + "codeExecution": { + "$ref": "GoogleCloudAiplatformV1beta1ToolCodeExecution", + "description": "Optional. CodeExecution tool type. Enables the model to execute code as part of generation. This field is only used by the Gemini Developer API services." + }, "functionDeclarations": { "description": "Optional. Function tool type. One or more function declarations to be passed to the model along with the current user query. Model may decide to call a subset of these functions by populating FunctionCall in the response. User should provide a FunctionResponse for each function call in the next turn. Based on the function responses, Model will generate the final response back to the user. Maximum 128 function declarations can be provided.", "items": { @@ -46351,6 +46579,12 @@ "properties": {}, "type": "object" }, + "GoogleCloudAiplatformV1beta1ToolCodeExecution": { + "description": "Tool that executes code generated by the model, and automatically returns the result to the model. See also [ExecutableCode]and [CodeExecutionResult] which are input and output to this tool.", + "id": "GoogleCloudAiplatformV1beta1ToolCodeExecution", + "properties": {}, + "type": "object" + }, "GoogleCloudAiplatformV1beta1ToolConfig": { "description": "Tool config. This config is shared for all tools provided in the request.", "id": "GoogleCloudAiplatformV1beta1ToolConfig", @@ -47164,6 +47398,17 @@ }, "type": "object" }, + "GoogleCloudAiplatformV1beta1UpdateEndpointLongRunningRequest": { + "description": "Request message for EndpointService.UpdateEndpointLongRunning.", + "id": "GoogleCloudAiplatformV1beta1UpdateEndpointLongRunningRequest", + "properties": { + "endpoint": { + "$ref": "GoogleCloudAiplatformV1beta1Endpoint", + "description": "Required. The Endpoint which replaces the resource on the server. Currently we only support updating the `client_connection_config` field, all the other fields' update will be blocked." + } + }, + "type": "object" + }, "GoogleCloudAiplatformV1beta1UpdateExplanationDatasetOperationMetadata": { "description": "Runtime operation information for ModelService.UpdateExplanationDataset.", "id": "GoogleCloudAiplatformV1beta1UpdateExplanationDatasetOperationMetadata", @@ -47403,6 +47648,7 @@ "properties": { "ragFileChunkingConfig": { "$ref": "GoogleCloudAiplatformV1beta1RagFileChunkingConfig", + "deprecated": true, "description": "Specifies the size and overlap of chunks after uploading RagFile." } }, @@ -47534,6 +47780,7 @@ "type": "array" }, "similarityTopK": { + "deprecated": true, "description": "Optional. Number of top k results to return from the selected corpora.", "format": "int32", "type": "integer" diff --git a/aiplatform/v1beta1/aiplatform-gen.go b/aiplatform/v1beta1/aiplatform-gen.go index 4f437fcc387..aaaadb3da27 100644 --- a/aiplatform/v1beta1/aiplatform-gen.go +++ b/aiplatform/v1beta1/aiplatform-gen.go @@ -4865,6 +4865,63 @@ func (s *GoogleCloudAiplatformV1beta1Claim) UnmarshalJSON(data []byte) error { return nil } +// GoogleCloudAiplatformV1beta1ClientConnectionConfig: Configurations (e.g. +// inference timeout) that are applied on your endpoints. +type GoogleCloudAiplatformV1beta1ClientConnectionConfig struct { + // InferenceTimeout: Customizable online prediction request timeout. + InferenceTimeout string `json:"inferenceTimeout,omitempty"` + // ForceSendFields is a list of field names (e.g. "InferenceTimeout") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "InferenceTimeout") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAiplatformV1beta1ClientConnectionConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1ClientConnectionConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudAiplatformV1beta1CodeExecutionResult: Result of executing the +// [ExecutableCode]. Always follows a `part` containing the [ExecutableCode]. +type GoogleCloudAiplatformV1beta1CodeExecutionResult struct { + // Outcome: Required. Outcome of the code execution. + // + // Possible values: + // "OUTCOME_UNSPECIFIED" - Unspecified status. This value should not be used. + // "OUTCOME_OK" - Code execution completed successfully. + // "OUTCOME_FAILED" - Code execution finished but with a failure. `stderr` + // should contain the reason. + // "OUTCOME_DEADLINE_EXCEEDED" - Code execution ran for too long, and was + // cancelled. There may or may not be a partial output present. + Outcome string `json:"outcome,omitempty"` + // Output: Optional. Contains stdout when code execution is successful, stderr + // or other description otherwise. + Output string `json:"output,omitempty"` + // ForceSendFields is a list of field names (e.g. "Outcome") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Outcome") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAiplatformV1beta1CodeExecutionResult) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1CodeExecutionResult + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAiplatformV1beta1CoherenceInput: Input for coherence metric. type GoogleCloudAiplatformV1beta1CoherenceInput struct { // Instance: Required. Coherence instance. @@ -7760,6 +7817,9 @@ type GoogleCloudAiplatformV1beta1DeployedModel struct { // `projects/{project}/locations/{location}/deploymentResourcePools/{deployment_ // resource_pool}` SharedResources string `json:"sharedResources,omitempty"` + // SystemLabels: System labels to apply to Model Garden deployments. System + // labels are managed by Google for internal use only. + SystemLabels map[string]string `json:"systemLabels,omitempty"` // ForceSendFields is a list of field names (e.g. "AutomaticResources") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -8251,6 +8311,9 @@ func (s GoogleCloudAiplatformV1beta1EncryptionSpec) MarshalJSON() ([]byte, error // GoogleCloudAiplatformV1beta1Endpoint: Models are deployed into it, and // afterwards Endpoint is called to obtain predictions and explanations. type GoogleCloudAiplatformV1beta1Endpoint struct { + // ClientConnectionConfig: Configurations that are applied to the endpoint for + // online prediction. + ClientConnectionConfig *GoogleCloudAiplatformV1beta1ClientConnectionConfig `json:"clientConnectionConfig,omitempty"` // CreateTime: Output only. Timestamp when this Endpoint was created. CreateTime string `json:"createTime,omitempty"` // DedicatedEndpointDns: Output only. DNS of the dedicated endpoint. Will only @@ -8329,15 +8392,15 @@ type GoogleCloudAiplatformV1beta1Endpoint struct { // 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 + // ForceSendFields is a list of field names (e.g. "ClientConnectionConfig") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://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 + // NullFields is a list of field names (e.g. "ClientConnectionConfig") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -9113,6 +9176,38 @@ func (s GoogleCloudAiplatformV1beta1ExamplesRestrictionsNamespace) MarshalJSON() return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudAiplatformV1beta1ExecutableCode: Code generated by the model that +// is meant to be executed, and the result returned to the model. Generated +// when using the [FunctionDeclaration] tool and [FunctionCallingConfig] mode +// is set to [Mode.CODE]. +type GoogleCloudAiplatformV1beta1ExecutableCode struct { + // Code: Required. The code to be executed. + Code string `json:"code,omitempty"` + // Language: Required. Programming language of the `code`. + // + // Possible values: + // "LANGUAGE_UNSPECIFIED" - Unspecified language. This value should not be + // used. + // "PYTHON" - Python >= 3.10, with numpy and simpy available. + Language string `json:"language,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 GoogleCloudAiplatformV1beta1ExecutableCode) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1ExecutableCode + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAiplatformV1beta1ExecuteExtensionRequest: Request message for // ExtensionExecutionService.ExecuteExtension. type GoogleCloudAiplatformV1beta1ExecuteExtensionRequest struct { @@ -13882,19 +13977,21 @@ func (s GoogleCloudAiplatformV1beta1GroundingChunk) MarshalJSON() ([]byte, error // GoogleCloudAiplatformV1beta1GroundingChunkRetrievedContext: Chunk from // context retrieved by the retrieval tools. type GoogleCloudAiplatformV1beta1GroundingChunkRetrievedContext struct { + // Text: Text of the attribution. + Text string `json:"text,omitempty"` // Title: Title of the attribution. Title string `json:"title,omitempty"` // Uri: URI reference of the attribution. Uri string `json:"uri,omitempty"` - // ForceSendFields is a list of field names (e.g. "Title") to unconditionally + // 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. "Title") 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. "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:"-"` } @@ -14456,12 +14553,13 @@ type GoogleCloudAiplatformV1beta1ImportRagFilesConfig struct { MaxEmbeddingRequestsPerMin int64 `json:"maxEmbeddingRequestsPerMin,omitempty"` // PartialFailureBigquerySink: The BigQuery destination to write partial // failures to. It should be a bigquery table resource name (e.g. - // "bq://projectId.bqDatasetId.bqTableId"). If the dataset id does not exist, - // it will be created. If the table does not exist, it will be created with the - // expected schema. If the table exists, the schema will be validated and data - // will be added to this existing table. + // "bq://projectId.bqDatasetId.bqTableId"). The dataset must exist. If the + // table does not exist, it will be created with the expected schema. If the + // table exists, the schema will be validated and data will be added to this + // existing table. Deprecated. Prefer to use `import_result_bq_sink`. PartialFailureBigquerySink *GoogleCloudAiplatformV1beta1BigQueryDestination `json:"partialFailureBigquerySink,omitempty"` // PartialFailureGcsSink: The Cloud Storage path to write partial failures to. + // Deprecated. Prefer to use `import_result_gcs_sink`. PartialFailureGcsSink *GoogleCloudAiplatformV1beta1GcsDestination `json:"partialFailureGcsSink,omitempty"` // RagFileChunkingConfig: Specifies the size and overlap of chunks after // importing RagFiles. @@ -15197,7 +15295,7 @@ func (s GoogleCloudAiplatformV1beta1JiraSource) MarshalJSON() ([]byte, error) { type GoogleCloudAiplatformV1beta1JiraSourceJiraQueries struct { // ApiKeyConfig: Required. The SecretManager secret version resource name (e.g. // projects/{project}/secrets/{secret}/versions/{version}) storing the Jira API - // key + // key. See Manage API tokens for your Atlassian account // (https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/). ApiKeyConfig *GoogleCloudAiplatformV1beta1ApiAuthApiKeyConfig `json:"apiKeyConfig,omitempty"` // CustomQueries: A list of custom Jira queries to import. For information @@ -22325,6 +22423,11 @@ func (s GoogleCloudAiplatformV1beta1PairwiseSummarizationQualitySpec) MarshalJSO // and subtype of the media if `inline_data` or `file_data` field is filled // with raw bytes. type GoogleCloudAiplatformV1beta1Part struct { + // CodeExecutionResult: Optional. Result of executing the [ExecutableCode]. + CodeExecutionResult *GoogleCloudAiplatformV1beta1CodeExecutionResult `json:"codeExecutionResult,omitempty"` + // ExecutableCode: Optional. Code generated by the model that is meant to be + // executed. + ExecutableCode *GoogleCloudAiplatformV1beta1ExecutableCode `json:"executableCode,omitempty"` // FileData: Optional. URI based data. FileData *GoogleCloudAiplatformV1beta1FileData `json:"fileData,omitempty"` // FunctionCall: Optional. A predicted [FunctionCall] returned from the model @@ -22343,15 +22446,15 @@ type GoogleCloudAiplatformV1beta1Part struct { // VideoMetadata: Optional. Video metadata. The metadata should only be // specified while the video data is presented in inline_data or file_data. VideoMetadata *GoogleCloudAiplatformV1beta1VideoMetadata `json:"videoMetadata,omitempty"` - // ForceSendFields is a list of field names (e.g. "FileData") to + // ForceSendFields is a list of field names (e.g. "CodeExecutionResult") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "FileData") 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. "CodeExecutionResult") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -22696,6 +22799,11 @@ func (s GoogleCloudAiplatformV1beta1PipelineJobDetail) MarshalJSON() ([]byte, er // GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfig: The runtime config of // a PipelineJob. type GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfig struct { + // DefaultRuntime: Optional. The default runtime for the PipelineJob. If not + // provided, Vertex Custom Job(on demand) is used as the runtime. For Vertex + // Custom Job, please refer to + // https://cloud.google.com/vertex-ai/docs/training/overview. + DefaultRuntime *GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfigDefaultRuntime `json:"defaultRuntime,omitempty"` // FailurePolicy: Represents the failure policy of a pipeline. Currently, the // default of a pipeline is that the pipeline will continue to run until no // more tasks can be executed, also known as PIPELINE_FAILURE_POLICY_FAIL_SLOW. @@ -22735,15 +22843,15 @@ type GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfig struct { // 2.0.0 or lower, such as pipelines built using Kubeflow Pipelines SDK 1.8 or // lower. Parameters map[string]GoogleCloudAiplatformV1beta1Value `json:"parameters,omitempty"` - // ForceSendFields is a list of field names (e.g. "FailurePolicy") to + // ForceSendFields is a list of field names (e.g. "DefaultRuntime") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "FailurePolicy") 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. "DefaultRuntime") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -22753,6 +22861,30 @@ func (s GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfig) MarshalJSON() ([]b return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfigDefaultRuntime: The +// default runtime for the PipelineJob. +type GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfigDefaultRuntime struct { + // PersistentResourceRuntimeDetail: Persistent resource based runtime detail. + PersistentResourceRuntimeDetail *GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfigPersistentResourceRuntimeDetail `json:"persistentResourceRuntimeDetail,omitempty"` + // ForceSendFields is a list of field names (e.g. + // "PersistentResourceRuntimeDetail") to unconditionally include in API + // requests. By default, fields with empty or default values are omitted from + // API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "PersistentResourceRuntimeDetail") + // to include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfigDefaultRuntime) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfigDefaultRuntime + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfigInputArtifact: The type // of an input artifact. type GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfigInputArtifact struct { @@ -22780,6 +22912,47 @@ func (s GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfigInputArtifact) Marsh return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfigPersistentResourceRuntime +// Detail: Persistent resource based runtime detail. For more information, +// refer to +// https://cloud.google.com/vertex-ai/docs/training/persistent-resource-overview +type GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfigPersistentResourceRuntimeDetail struct { + // PersistentResourceName: Persistent resource name. Format: + // `projects/{project}/locations/{location}/persistentResources/{persistent_reso + // urce}` + PersistentResourceName string `json:"persistentResourceName,omitempty"` + // TaskResourceUnavailableTimeoutBehavior: Specifies the behavior to take if + // the timeout is reached. + // + // Possible values: + // "TASK_RESOURCE_UNAVAILABLE_TIMEOUT_BEHAVIOR_UNSPECIFIED" - Unspecified. + // Behavior is same as `FAIL`. + // "FAIL" - Fail the task if the timeout is reached. + // "FALL_BACK_TO_ON_DEMAND" - Fall back to on-demand execution if the timeout + // is reached. + TaskResourceUnavailableTimeoutBehavior string `json:"taskResourceUnavailableTimeoutBehavior,omitempty"` + // TaskResourceUnavailableWaitTimeMs: The max time a pipeline task waits for + // the required CPU, memory, or accelerator resource to become available from + // the specified persistent resource. Default wait time is 0. + TaskResourceUnavailableWaitTimeMs int64 `json:"taskResourceUnavailableWaitTimeMs,omitempty,string"` + // ForceSendFields is a list of field names (e.g. "PersistentResourceName") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "PersistentResourceName") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfigPersistentResourceRuntimeDetail) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfigPersistentResourceRuntimeDetail + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAiplatformV1beta1PipelineTaskDetail: The runtime detail of a task // execution. type GoogleCloudAiplatformV1beta1PipelineTaskDetail struct { @@ -23680,14 +23853,10 @@ func (s GoogleCloudAiplatformV1beta1PscAutomatedEndpoints) MarshalJSON() ([]byte // GoogleCloudAiplatformV1beta1PscInterfaceConfig: Configuration for PSC-I. type GoogleCloudAiplatformV1beta1PscInterfaceConfig struct { - // NetworkAttachment: Optional. The full name of the Compute Engine network + // NetworkAttachment: Optional. The name of the Compute Engine network // attachment (https://cloud.google.com/vpc/docs/about-network-attachments) to - // attach to the resource. For example, - // `projects/12345/regions/us-central1/networkAttachments/myNA`. is of the form - // `projects/{project}/regions/{region}/networkAttachments/{networkAttachment}`. - // Where {project} is a project number, as in `12345`, and {networkAttachment} - // is a network attachment name. To specify this field, you must have already - // [created a network attachment] + // attach to the resource within the region and user project. To specify this + // field, you must have already [created a network attachment] // (https://cloud.google.com/vpc/docs/create-manage-network-attachments#create-network-attachments). // This field is only used for resources using PSC-I. NetworkAttachment string `json:"networkAttachment,omitempty"` @@ -23904,8 +24073,8 @@ func (s GoogleCloudAiplatformV1beta1PublisherModelCallToActionDeploy) MarshalJSO // GoogleCloudAiplatformV1beta1PublisherModelCallToActionDeployDeployMetadata: // Metadata information about the deployment for managing deployment config. type GoogleCloudAiplatformV1beta1PublisherModelCallToActionDeployDeployMetadata struct { - // Labels: Optional. Labels for the deployment. For managing deployment config - // like verifying, source of deployment config, etc. + // Labels: Optional. Labels for the deployment config. For managing deployment + // config like verifying, source of deployment config, etc. Labels map[string]string `json:"labels,omitempty"` // SampleRequest: Optional. Sample request for deployed endpoint. SampleRequest string `json:"sampleRequest,omitempty"` @@ -25767,6 +25936,8 @@ type GoogleCloudAiplatformV1beta1RaySpec struct { // need all the resource pools to have the same Ray image. Otherwise, use the // {@code resource_pool_images} field. ImageUri string `json:"imageUri,omitempty"` + // NfsMounts: Optional. Use if you want to mount to any NFS storages. + NfsMounts []*GoogleCloudAiplatformV1beta1NfsMount `json:"nfsMounts,omitempty"` // RayLogsSpec: Optional. OSS Ray logging configurations. RayLogsSpec *GoogleCloudAiplatformV1beta1RayLogsSpec `json:"rayLogsSpec,omitempty"` // RayMetricSpec: Optional. Ray metrics configurations. @@ -26212,7 +26383,8 @@ func (s GoogleCloudAiplatformV1beta1ReasoningEngine) MarshalJSON() ([]byte, erro // GoogleCloudAiplatformV1beta1ReasoningEngineSpec: ReasoningEngine // configurations type GoogleCloudAiplatformV1beta1ReasoningEngineSpec struct { - // ClassMethods: Optional. Declarations for object class methods. + // ClassMethods: Optional. Declarations for object class methods in OpenAPI + // specification format. ClassMethods []googleapi.RawMessage `json:"classMethods,omitempty"` // PackageSpec: Required. User provided package spec of the ReasoningEngine. PackageSpec *GoogleCloudAiplatformV1beta1ReasoningEngineSpecPackageSpec `json:"packageSpec,omitempty"` @@ -31123,10 +31295,20 @@ type GoogleCloudAiplatformV1beta1SchemaPromptSpecStructuredPrompt struct { Context *GoogleCloudAiplatformV1beta1Content `json:"context,omitempty"` // Examples: Preamble: A set of examples for expected model response. Examples []*GoogleCloudAiplatformV1beta1SchemaPromptSpecPartList `json:"examples,omitempty"` + // InfillPrefix: Preamble: For infill prompt, the prefix before expected model + // response. + InfillPrefix string `json:"infillPrefix,omitempty"` + // InfillSuffix: Preamble: For infill prompt, the suffix after expected model + // response. + InfillSuffix string `json:"infillSuffix,omitempty"` // InputPrefixes: Preamble: The input prefixes before each example input. InputPrefixes []string `json:"inputPrefixes,omitempty"` // OutputPrefixes: Preamble: The output prefixes before each example output. OutputPrefixes []string `json:"outputPrefixes,omitempty"` + // PredictionInputs: Preamble: The input test data for prediction. Each + // PartList in this field represents one text-only input set for a single model + // request. + PredictionInputs []*GoogleCloudAiplatformV1beta1SchemaPromptSpecPartList `json:"predictionInputs,omitempty"` // PromptMessage: The prompt message. PromptMessage *GoogleCloudAiplatformV1beta1SchemaPromptSpecPromptMessage `json:"promptMessage,omitempty"` // ForceSendFields is a list of field names (e.g. "Context") to unconditionally @@ -35307,6 +35489,11 @@ func (s GoogleCloudAiplatformV1beta1StartNotebookRuntimeOperationMetadata) Marsh type GoogleCloudAiplatformV1beta1StartNotebookRuntimeRequest struct { } +// GoogleCloudAiplatformV1beta1StopNotebookRuntimeRequest: Request message for +// NotebookService.StopNotebookRuntime. +type GoogleCloudAiplatformV1beta1StopNotebookRuntimeRequest struct { +} + // GoogleCloudAiplatformV1beta1StopTrialRequest: Request message for // VizierService.StopTrial. type GoogleCloudAiplatformV1beta1StopTrialRequest struct { @@ -37882,6 +38069,10 @@ func (s GoogleCloudAiplatformV1beta1TokensInfo) MarshalJSON() ([]byte, error) { // exactly one type of Tool (e.g FunctionDeclaration, Retrieval or // GoogleSearchRetrieval). type GoogleCloudAiplatformV1beta1Tool struct { + // CodeExecution: Optional. CodeExecution tool type. Enables the model to + // execute code as part of generation. This field is only used by the Gemini + // Developer API services. + CodeExecution *GoogleCloudAiplatformV1beta1ToolCodeExecution `json:"codeExecution,omitempty"` // FunctionDeclarations: Optional. Function tool type. One or more function // declarations to be passed to the model along with the current user query. // Model may decide to call a subset of these functions by populating @@ -37897,15 +38088,15 @@ type GoogleCloudAiplatformV1beta1Tool struct { // provided retrieval tool(s) to get external knowledge to answer the prompt. // Retrieval results are presented to the model for generation. Retrieval *GoogleCloudAiplatformV1beta1Retrieval `json:"retrieval,omitempty"` - // ForceSendFields is a list of field names (e.g. "FunctionDeclarations") to + // ForceSendFields is a list of field names (e.g. "CodeExecution") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "FunctionDeclarations") 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. "CodeExecution") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -38030,6 +38221,13 @@ func (s GoogleCloudAiplatformV1beta1ToolCallValidResults) MarshalJSON() ([]byte, type GoogleCloudAiplatformV1beta1ToolCallValidSpec struct { } +// GoogleCloudAiplatformV1beta1ToolCodeExecution: Tool that executes code +// generated by the model, and automatically returns the result to the model. +// See also [ExecutableCode]and [CodeExecutionResult] which are input and +// output to this tool. +type GoogleCloudAiplatformV1beta1ToolCodeExecution struct { +} + // GoogleCloudAiplatformV1beta1ToolConfig: Tool config. This config is shared // for all tools provided in the request. type GoogleCloudAiplatformV1beta1ToolConfig struct { @@ -39143,6 +39341,31 @@ func (s GoogleCloudAiplatformV1beta1UpdateDeploymentResourcePoolOperationMetadat return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudAiplatformV1beta1UpdateEndpointLongRunningRequest: Request +// message for EndpointService.UpdateEndpointLongRunning. +type GoogleCloudAiplatformV1beta1UpdateEndpointLongRunningRequest struct { + // Endpoint: Required. The Endpoint which replaces the resource on the server. + // Currently we only support updating the `client_connection_config` field, all + // the other fields' update will be blocked. + Endpoint *GoogleCloudAiplatformV1beta1Endpoint `json:"endpoint,omitempty"` + // ForceSendFields is a list of field names (e.g. "Endpoint") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Endpoint") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAiplatformV1beta1UpdateEndpointLongRunningRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1UpdateEndpointLongRunningRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAiplatformV1beta1UpdateExplanationDatasetOperationMetadata: // Runtime operation information for ModelService.UpdateExplanationDataset. type GoogleCloudAiplatformV1beta1UpdateExplanationDatasetOperationMetadata struct { @@ -57899,6 +58122,108 @@ func (c *ProjectsLocationsEndpointsUndeployModelCall) Do(opts ...googleapi.CallO return ret, nil } +type ProjectsLocationsEndpointsUpdateCall struct { + s *Service + name string + googlecloudaiplatformv1beta1updateendpointlongrunningrequest *GoogleCloudAiplatformV1beta1UpdateEndpointLongRunningRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Update: Updates an Endpoint with a long running operation. +// +// - name: Output only. The resource name of the Endpoint. +func (r *ProjectsLocationsEndpointsService) Update(name string, googlecloudaiplatformv1beta1updateendpointlongrunningrequest *GoogleCloudAiplatformV1beta1UpdateEndpointLongRunningRequest) *ProjectsLocationsEndpointsUpdateCall { + c := &ProjectsLocationsEndpointsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googlecloudaiplatformv1beta1updateendpointlongrunningrequest = googlecloudaiplatformv1beta1updateendpointlongrunningrequest + 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 *ProjectsLocationsEndpointsUpdateCall) Fields(s ...googleapi.Field) *ProjectsLocationsEndpointsUpdateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsEndpointsUpdateCall) Context(ctx context.Context) *ProjectsLocationsEndpointsUpdateCall { + 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 *ProjectsLocationsEndpointsUpdateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsEndpointsUpdateCall) 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.googlecloudaiplatformv1beta1updateendpointlongrunningrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}:update") + 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 "aiplatform.projects.locations.endpoints.update" 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 *ProjectsLocationsEndpointsUpdateCall) 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 ProjectsLocationsEndpointsChatCompletionsCall struct { s *Service endpoint string @@ -65587,7 +65912,7 @@ func (r *ProjectsLocationsFeatureOnlineStoresFeatureViewsService) Patch(name str // `big_query_source` * `big_query_source.uri` * // `big_query_source.entity_id_columns` * `feature_registry_source` * // `feature_registry_source.feature_groups` * `sync_config` * -// `sync_config.cron` +// `sync_config.cron` * `optimized_config.automatic_resources` func (c *ProjectsLocationsFeatureOnlineStoresFeatureViewsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsFeatureOnlineStoresFeatureViewsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -95447,6 +95772,111 @@ func (c *ProjectsLocationsNotebookRuntimesStartCall) Do(opts ...googleapi.CallOp return ret, nil } +type ProjectsLocationsNotebookRuntimesStopCall struct { + s *Service + name string + googlecloudaiplatformv1beta1stopnotebookruntimerequest *GoogleCloudAiplatformV1beta1StopNotebookRuntimeRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Stop: Stops a NotebookRuntime. +// +// - name: The name of the NotebookRuntime resource to be stopped. Instead of +// checking whether the name is in valid NotebookRuntime resource name +// format, directly throw NotFound exception if there is no such +// NotebookRuntime in spanner. +func (r *ProjectsLocationsNotebookRuntimesService) Stop(name string, googlecloudaiplatformv1beta1stopnotebookruntimerequest *GoogleCloudAiplatformV1beta1StopNotebookRuntimeRequest) *ProjectsLocationsNotebookRuntimesStopCall { + c := &ProjectsLocationsNotebookRuntimesStopCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googlecloudaiplatformv1beta1stopnotebookruntimerequest = googlecloudaiplatformv1beta1stopnotebookruntimerequest + 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 *ProjectsLocationsNotebookRuntimesStopCall) Fields(s ...googleapi.Field) *ProjectsLocationsNotebookRuntimesStopCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsNotebookRuntimesStopCall) Context(ctx context.Context) *ProjectsLocationsNotebookRuntimesStopCall { + 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 *ProjectsLocationsNotebookRuntimesStopCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsNotebookRuntimesStopCall) 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.googlecloudaiplatformv1beta1stopnotebookruntimerequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}:stop") + 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 "aiplatform.projects.locations.notebookRuntimes.stop" 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 *ProjectsLocationsNotebookRuntimesStopCall) 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 ProjectsLocationsNotebookRuntimesUpgradeCall struct { s *Service name string diff --git a/alertcenter/v1beta1/alertcenter-api.json b/alertcenter/v1beta1/alertcenter-api.json index 511ab9c897e..1c9ffb8698d 100644 --- a/alertcenter/v1beta1/alertcenter-api.json +++ b/alertcenter/v1beta1/alertcenter-api.json @@ -423,7 +423,7 @@ } } }, - "revision": "20240415", + "revision": "20241028", "rootUrl": "https://alertcenter.googleapis.com/", "schemas": { "AbuseDetected": { @@ -856,7 +856,7 @@ "type": "object" }, "AppSettingsChanged": { - "description": "Alerts from AppSettingsChanged bucket Rules configured by Admin which contain the below rules. Calendar settings changed Drive settings changed Email settings changed Mobile settings changed", + "description": "* Alerts from AppSettingsChanged bucket Rules configured by Admin which contain the below rules. Calendar settings changed Drive settings changed Email settings changed Mobile settings changed", "id": "AppSettingsChanged", "properties": { "alertDetails": { @@ -1577,7 +1577,7 @@ "type": "object" }, "PrimaryAdminChangedEvent": { - "description": "Event occurred when primary admin changed in customer's account. The event are being received from insight forwarder", + "description": "* Event occurred when primary admin changed in customer's account. The event are being received from insight forwarder", "id": "PrimaryAdminChangedEvent", "properties": { "domain": { @@ -1888,7 +1888,7 @@ "type": "object" }, "SSOProfileCreatedEvent": { - "description": "Event occurred when SSO Profile created in customer's account. The event are being received from insight forwarder", + "description": "* Event occurred when SSO Profile created in customer's account. The event are being received from insight forwarder", "id": "SSOProfileCreatedEvent", "properties": { "inboundSsoProfileName": { @@ -1899,7 +1899,7 @@ "type": "object" }, "SSOProfileDeletedEvent": { - "description": "Event occurred when SSO Profile deleted in customer's account. The event are being received from insight forwarder", + "description": "* Event occurred when SSO Profile deleted in customer's account. The event are being received from insight forwarder", "id": "SSOProfileDeletedEvent", "properties": { "inboundSsoProfileName": { @@ -1910,7 +1910,7 @@ "type": "object" }, "SSOProfileUpdatedEvent": { - "description": "Event occurred when SSO Profile updated in customer's account. The event are being received from insight forwarder", + "description": "* Event occurred when SSO Profile updated in customer's account. The event are being received from insight forwarder", "id": "SSOProfileUpdatedEvent", "properties": { "inboundSsoProfileChanges": { @@ -2013,7 +2013,7 @@ "type": "object" }, "SuperAdminPasswordResetEvent": { - "description": "Event occurred when password was reset for super admin in customer's account. The event are being received from insight forwarder", + "description": "* Event occurred when password was reset for super admin in customer's account. The event are being received from insight forwarder", "id": "SuperAdminPasswordResetEvent", "properties": { "userEmail": { @@ -2193,7 +2193,7 @@ "type": "object" }, "UserChanges": { - "description": "Alerts from UserChanges bucket Rules for predefined rules which contain the below rules. Suspended user made active New user Added User suspended (by admin) User granted admin privileges User admin privileges revoked User deleted Users password changed", + "description": "* Alerts from UserChanges bucket Rules for predefined rules which contain the below rules. Suspended user made active New user Added User suspended (by admin) User granted admin privileges User admin privileges revoked User deleted Users password changed", "id": "UserChanges", "properties": { "name": { diff --git a/alertcenter/v1beta1/alertcenter-gen.go b/alertcenter/v1beta1/alertcenter-gen.go index 5509774984e..07983c2fa60 100644 --- a/alertcenter/v1beta1/alertcenter-gen.go +++ b/alertcenter/v1beta1/alertcenter-gen.go @@ -653,7 +653,7 @@ func (s AppMakerSqlSetupNotification) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// AppSettingsChanged: Alerts from AppSettingsChanged bucket Rules configured +// AppSettingsChanged: * Alerts from AppSettingsChanged bucket Rules configured // by Admin which contain the below rules. Calendar settings changed Drive // settings changed Email settings changed Mobile settings changed type AppSettingsChanged struct { @@ -1589,7 +1589,7 @@ func (s PredefinedDetectorInfo) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// PrimaryAdminChangedEvent: Event occurred when primary admin changed in +// PrimaryAdminChangedEvent: * Event occurred when primary admin changed in // customer's account. The event are being received from insight forwarder type PrimaryAdminChangedEvent struct { // Domain: domain in which actioned occurred @@ -1860,7 +1860,7 @@ func (s RuleViolationInfo) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// SSOProfileCreatedEvent: Event occurred when SSO Profile created in +// SSOProfileCreatedEvent: * Event occurred when SSO Profile created in // customer's account. The event are being received from insight forwarder type SSOProfileCreatedEvent struct { // InboundSsoProfileName: sso profile name which got created @@ -1883,7 +1883,7 @@ func (s SSOProfileCreatedEvent) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// SSOProfileDeletedEvent: Event occurred when SSO Profile deleted in +// SSOProfileDeletedEvent: * Event occurred when SSO Profile deleted in // customer's account. The event are being received from insight forwarder type SSOProfileDeletedEvent struct { // InboundSsoProfileName: sso profile name which got deleted @@ -1906,7 +1906,7 @@ func (s SSOProfileDeletedEvent) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// SSOProfileUpdatedEvent: Event occurred when SSO Profile updated in +// SSOProfileUpdatedEvent: * Event occurred when SSO Profile updated in // customer's account. The event are being received from insight forwarder type SSOProfileUpdatedEvent struct { // InboundSsoProfileChanges: changes made to sso profile @@ -2053,7 +2053,7 @@ func (s Status) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// SuperAdminPasswordResetEvent: Event occurred when password was reset for +// SuperAdminPasswordResetEvent: * Event occurred when password was reset for // super admin in customer's account. The event are being received from insight // forwarder type SuperAdminPasswordResetEvent struct { @@ -2287,10 +2287,10 @@ func (s User) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// UserChanges: Alerts from UserChanges bucket Rules for predefined rules which -// contain the below rules. Suspended user made active New user Added User -// suspended (by admin) User granted admin privileges User admin privileges -// revoked User deleted Users password changed +// UserChanges: * Alerts from UserChanges bucket Rules for predefined rules +// which contain the below rules. Suspended user made active New user Added +// User suspended (by admin) User granted admin privileges User admin +// privileges revoked User deleted Users password changed type UserChanges struct { // Name: Rule name Name string `json:"name,omitempty"` diff --git a/alloydb/v1/alloydb-api.json b/alloydb/v1/alloydb-api.json index 7252e0299ee..6591cf1d2e4 100644 --- a/alloydb/v1/alloydb-api.json +++ b/alloydb/v1/alloydb-api.json @@ -1517,7 +1517,7 @@ } } }, - "revision": "20241002", + "revision": "20241015", "rootUrl": "https://alloydb.googleapis.com/", "schemas": { "AuthorizedNetwork": { @@ -4635,6 +4635,7 @@ "type": "integer" }, "retentionUnit": { + "deprecated": true, "description": "The unit that 'retained_backups' represents.", "enum": [ "RETENTION_UNIT_UNSPECIFIED", @@ -4655,6 +4656,11 @@ "timeBasedRetention": { "format": "google-duration", "type": "string" + }, + "timestampBasedRetentionTime": { + "description": "Timestamp based retention period i.e. 2024-05-01T00:00:00Z", + "format": "google-datetime", + "type": "string" } }, "type": "object" diff --git a/alloydb/v1/alloydb-gen.go b/alloydb/v1/alloydb-gen.go index 31cfcc31b3a..21418acd849 100644 --- a/alloydb/v1/alloydb-gen.go +++ b/alloydb/v1/alloydb-gen.go @@ -3469,6 +3469,9 @@ type StorageDatabasecenterPartnerapiV1mainRetentionSettings struct { // "RETENTION_UNIT_OTHER" - For rest of the other category RetentionUnit string `json:"retentionUnit,omitempty"` TimeBasedRetention string `json:"timeBasedRetention,omitempty"` + // TimestampBasedRetentionTime: Timestamp based retention period i.e. + // 2024-05-01T00:00:00Z + TimestampBasedRetentionTime string `json:"timestampBasedRetentionTime,omitempty"` // ForceSendFields is a list of field names (e.g. "DurationBasedRetention") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See diff --git a/alloydb/v1alpha/alloydb-api.json b/alloydb/v1alpha/alloydb-api.json index 5c75343a7df..95a3a3ae8b0 100644 --- a/alloydb/v1alpha/alloydb-api.json +++ b/alloydb/v1alpha/alloydb-api.json @@ -1517,7 +1517,7 @@ } } }, - "revision": "20241002", + "revision": "20241015", "rootUrl": "https://alloydb.googleapis.com/", "schemas": { "AuthorizedNetwork": { @@ -4799,6 +4799,7 @@ "type": "integer" }, "retentionUnit": { + "deprecated": true, "description": "The unit that 'retained_backups' represents.", "enum": [ "RETENTION_UNIT_UNSPECIFIED", @@ -4819,6 +4820,11 @@ "timeBasedRetention": { "format": "google-duration", "type": "string" + }, + "timestampBasedRetentionTime": { + "description": "Timestamp based retention period i.e. 2024-05-01T00:00:00Z", + "format": "google-datetime", + "type": "string" } }, "type": "object" diff --git a/alloydb/v1alpha/alloydb-gen.go b/alloydb/v1alpha/alloydb-gen.go index aa7f3617ebf..3f613af8c25 100644 --- a/alloydb/v1alpha/alloydb-gen.go +++ b/alloydb/v1alpha/alloydb-gen.go @@ -3662,6 +3662,9 @@ type StorageDatabasecenterPartnerapiV1mainRetentionSettings struct { // "RETENTION_UNIT_OTHER" - For rest of the other category RetentionUnit string `json:"retentionUnit,omitempty"` TimeBasedRetention string `json:"timeBasedRetention,omitempty"` + // TimestampBasedRetentionTime: Timestamp based retention period i.e. + // 2024-05-01T00:00:00Z + TimestampBasedRetentionTime string `json:"timestampBasedRetentionTime,omitempty"` // ForceSendFields is a list of field names (e.g. "DurationBasedRetention") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See diff --git a/alloydb/v1beta/alloydb-api.json b/alloydb/v1beta/alloydb-api.json index a826cd9b1dd..bdc0d8e5d03 100644 --- a/alloydb/v1beta/alloydb-api.json +++ b/alloydb/v1beta/alloydb-api.json @@ -1514,7 +1514,7 @@ } } }, - "revision": "20241002", + "revision": "20241015", "rootUrl": "https://alloydb.googleapis.com/", "schemas": { "AuthorizedNetwork": { @@ -4751,6 +4751,7 @@ "type": "integer" }, "retentionUnit": { + "deprecated": true, "description": "The unit that 'retained_backups' represents.", "enum": [ "RETENTION_UNIT_UNSPECIFIED", @@ -4771,6 +4772,11 @@ "timeBasedRetention": { "format": "google-duration", "type": "string" + }, + "timestampBasedRetentionTime": { + "description": "Timestamp based retention period i.e. 2024-05-01T00:00:00Z", + "format": "google-datetime", + "type": "string" } }, "type": "object" diff --git a/alloydb/v1beta/alloydb-gen.go b/alloydb/v1beta/alloydb-gen.go index d5526a6ed4d..56a93192d4c 100644 --- a/alloydb/v1beta/alloydb-gen.go +++ b/alloydb/v1beta/alloydb-gen.go @@ -3616,6 +3616,9 @@ type StorageDatabasecenterPartnerapiV1mainRetentionSettings struct { // "RETENTION_UNIT_OTHER" - For rest of the other category RetentionUnit string `json:"retentionUnit,omitempty"` TimeBasedRetention string `json:"timeBasedRetention,omitempty"` + // TimestampBasedRetentionTime: Timestamp based retention period i.e. + // 2024-05-01T00:00:00Z + TimestampBasedRetentionTime string `json:"timestampBasedRetentionTime,omitempty"` // ForceSendFields is a list of field names (e.g. "DurationBasedRetention") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See diff --git a/androidenterprise/v1/androidenterprise-api.json b/androidenterprise/v1/androidenterprise-api.json index 70f79a3f99c..789a1c803e7 100644 --- a/androidenterprise/v1/androidenterprise-api.json +++ b/androidenterprise/v1/androidenterprise-api.json @@ -2654,7 +2654,7 @@ } } }, - "revision": "20241021", + "revision": "20241028", "rootUrl": "https://androidenterprise.googleapis.com/", "schemas": { "Administrator": { @@ -4015,7 +4015,7 @@ "properties": { "autoUpdatePolicy": { "deprecated": true, - "description": "Controls when automatic app updates on the device can be applied. Recommended alternative: autoUpdateMode which is set per app, provides greater flexibility around update frequency. When autoUpdateMode is set to AUTO_UPDATE_POSTPONED or AUTO_UPDATE_HIGH_PRIORITY, autoUpdatePolicy has no effect. \"choiceToTheUser\" allows the device's user to configure the app update policy. \"always\" enables auto updates. \"never\" disables auto updates. \"wifiOnly\" enables auto updates only when the device is connected to wifi.", + "description": "Controls when automatic app updates on the device can be applied. Recommended alternative: autoUpdateMode which is set per app, provides greater flexibility around update frequency. When autoUpdateMode is set to AUTO_UPDATE_POSTPONED or AUTO_UPDATE_HIGH_PRIORITY, autoUpdatePolicy has no effect. - choiceToTheUser allows the device's user to configure the app update policy. - always enables auto updates. - never disables auto updates. - wifiOnly enables auto updates only when the device is connected to wifi. *Important:* Changes to app update policies don't affect updates that are in progress. Any policy changes will apply to subsequent app updates. ", "enum": [ "autoUpdatePolicyUnspecified", "choiceToTheUser", diff --git a/androidenterprise/v1/androidenterprise-gen.go b/androidenterprise/v1/androidenterprise-gen.go index 98b9cad5a4e..f3fb89e2b02 100644 --- a/androidenterprise/v1/androidenterprise-gen.go +++ b/androidenterprise/v1/androidenterprise-gen.go @@ -2208,10 +2208,12 @@ type Policy struct { // applied. Recommended alternative: autoUpdateMode which is set per app, // provides greater flexibility around update frequency. When autoUpdateMode is // set to AUTO_UPDATE_POSTPONED or AUTO_UPDATE_HIGH_PRIORITY, autoUpdatePolicy - // has no effect. "choiceToTheUser" allows the device's user to configure the - // app update policy. "always" enables auto updates. "never" disables auto - // updates. "wifiOnly" enables auto updates only when the device is connected - // to wifi. + // has no effect. - choiceToTheUser allows the device's user to configure the + // app update policy. - always enables auto updates. - never disables auto + // updates. - wifiOnly enables auto updates only when the device is connected + // to wifi. *Important:* Changes to app update policies don't affect updates + // that are in progress. Any policy changes will apply to subsequent app + // updates. // // Possible values: // "autoUpdatePolicyUnspecified" - The auto update policy is not set. diff --git a/backupdr/v1/backupdr-api.json b/backupdr/v1/backupdr-api.json index 01447031b30..51bab4a82a4 100644 --- a/backupdr/v1/backupdr-api.json +++ b/backupdr/v1/backupdr-api.json @@ -1663,7 +1663,7 @@ } } }, - "revision": "20241009", + "revision": "20241017", "rootUrl": "https://backupdr.googleapis.com/", "schemas": { "AbandonBackupRequest": { @@ -1827,42 +1827,6 @@ }, "type": "object" }, - "AssetLocation": { - "description": "Provides the mapping of a cloud asset to a direct physical location or to a proxy that defines the location on its behalf.", - "id": "AssetLocation", - "properties": { - "ccfeRmsPath": { - "description": "Spanner path of the CCFE RMS database. It is only applicable for CCFE tenants that use CCFE RMS for storing resource metadata.", - "type": "string" - }, - "expected": { - "$ref": "IsolationExpectations", - "description": "Defines the customer expectation around ZI/ZS for this asset and ZI/ZS state of the region at the time of asset creation." - }, - "extraParameters": { - "description": "Defines extra parameters required for specific asset types.", - "items": { - "$ref": "ExtraParameter" - }, - "type": "array" - }, - "locationData": { - "description": "Contains all kinds of physical location definitions for this asset.", - "items": { - "$ref": "LocationData" - }, - "type": "array" - }, - "parentAsset": { - "description": "Defines parents assets if any in order to allow later generation of child_asset_location data via child assets.", - "items": { - "$ref": "CloudAsset" - }, - "type": "array" - } - }, - "type": "object" - }, "AttachedDisk": { "description": "An instance-attached disk resource.", "id": "AttachedDisk", @@ -2389,7 +2353,7 @@ "type": "string" }, "resourceType": { - "description": "Required. The resource type to which the `BackupPlan` will be applied. Examples include, \"compute.googleapis.com/Instance\" and \"storage.googleapis.com/Bucket\".", + "description": "Required. The resource type to which the `BackupPlan` will be applied. Examples include, \"compute.googleapis.com/Instance\", \"sqladmin.googleapis.com/Instance\" and \"storage.googleapis.com/Bucket\".", "type": "string" }, "state": { @@ -2520,13 +2484,15 @@ "ACCESS_RESTRICTION_UNSPECIFIED", "WITHIN_PROJECT", "WITHIN_ORGANIZATION", - "UNRESTRICTED" + "UNRESTRICTED", + "WITHIN_ORG_BUT_UNRESTRICTED_FOR_BA" ], "enumDescriptions": [ - "Access restriction not set.", + "Access restriction not set. If user does not provide any value or pass this value, it will be changed to WITHIN_ORGANIZATION.", "Access to or from resources outside your current project will be denied.", "Access to or from resources outside your current organization will be denied.", - "No access restriction." + "No access restriction.", + "Access to or from resources outside your current organization will be denied except for backup appliance." ], "type": "string" }, @@ -2667,49 +2633,12 @@ }, "type": "object" }, - "BlobstoreLocation": { - "description": "Policy ID that identified data placement in Blobstore as per go/blobstore-user-guide#data-metadata-placement-and-failure-domains", - "id": "BlobstoreLocation", - "properties": { - "policyId": { - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "CancelOperationRequest": { "description": "The request message for Operations.CancelOperation.", "id": "CancelOperationRequest", "properties": {}, "type": "object" }, - "CloudAsset": { - "id": "CloudAsset", - "properties": { - "assetName": { - "type": "string" - }, - "assetType": { - "type": "string" - } - }, - "type": "object" - }, - "CloudAssetComposition": { - "id": "CloudAssetComposition", - "properties": { - "childAsset": { - "items": { - "$ref": "CloudAsset" - }, - "type": "array" - } - }, - "type": "object" - }, "ComputeInstanceBackupProperties": { "description": "ComputeInstanceBackupProperties represents Compute Engine instance backup properties.", "id": "ComputeInstanceBackupProperties", @@ -3177,18 +3106,6 @@ }, "type": "object" }, - "DirectLocationAssignment": { - "id": "DirectLocationAssignment", - "properties": { - "location": { - "items": { - "$ref": "LocationAssignment" - }, - "type": "array" - } - }, - "type": "object" - }, "DisplayDevice": { "description": "A set of Display Device options", "id": "DisplayDevice", @@ -3244,17 +3161,6 @@ }, "type": "object" }, - "ExtraParameter": { - "description": "Defines parameters that should only be used for specific asset types.", - "id": "ExtraParameter", - "properties": { - "regionalMigDistributionPolicy": { - "$ref": "RegionalMigDistributionPolicy", - "description": "Details about zones used by regional compute.googleapis.com/InstanceGroupManager to create instances." - } - }, - "type": "object" - }, "FetchAccessTokenRequest": { "description": "Request message for FetchAccessToken.", "id": "FetchAccessTokenRequest", @@ -3528,131 +3434,6 @@ }, "type": "object" }, - "IsolationExpectations": { - "id": "IsolationExpectations", - "properties": { - "requirementOverride": { - "$ref": "RequirementOverride", - "description": "Explicit overrides for ZI and ZS requirements to be used for resources that should be excluded from ZI/ZS verification logic." - }, - "ziOrgPolicy": { - "enum": [ - "ZI_UNSPECIFIED", - "ZI_UNKNOWN", - "ZI_NOT_REQUIRED", - "ZI_PREFERRED", - "ZI_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "", - "" - ], - "type": "string" - }, - "ziRegionPolicy": { - "enum": [ - "ZI_REGION_POLICY_UNSPECIFIED", - "ZI_REGION_POLICY_UNKNOWN", - "ZI_REGION_POLICY_NOT_SET", - "ZI_REGION_POLICY_FAIL_OPEN", - "ZI_REGION_POLICY_FAIL_CLOSED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "", - "" - ], - "type": "string" - }, - "ziRegionState": { - "enum": [ - "ZI_REGION_UNSPECIFIED", - "ZI_REGION_UNKNOWN", - "ZI_REGION_NOT_ENABLED", - "ZI_REGION_ENABLED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "" - ], - "type": "string" - }, - "zoneIsolation": { - "deprecated": true, - "description": "Deprecated: use zi_org_policy, zi_region_policy and zi_region_state instead for setting ZI expectations as per go/zicy-publish-physical-location.", - "enum": [ - "ZI_UNSPECIFIED", - "ZI_UNKNOWN", - "ZI_NOT_REQUIRED", - "ZI_PREFERRED", - "ZI_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "", - "" - ], - "type": "string" - }, - "zoneSeparation": { - "deprecated": true, - "description": "Deprecated: use zs_org_policy, and zs_region_stateinstead for setting Zs expectations as per go/zicy-publish-physical-location.", - "enum": [ - "ZS_UNSPECIFIED", - "ZS_UNKNOWN", - "ZS_NOT_REQUIRED", - "ZS_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "" - ], - "type": "string" - }, - "zsOrgPolicy": { - "enum": [ - "ZS_UNSPECIFIED", - "ZS_UNKNOWN", - "ZS_NOT_REQUIRED", - "ZS_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "" - ], - "type": "string" - }, - "zsRegionState": { - "enum": [ - "ZS_REGION_UNSPECIFIED", - "ZS_REGION_UNKNOWN", - "ZS_REGION_NOT_ENABLED", - "ZS_REGION_ENABLED" - ], - "enumDescriptions": [ - "", - "To be used if tracking of the asset ZS-bit is not available", - "", - "" - ], - "type": "string" - } - }, - "type": "object" - }, "ListBackupPlanAssociationsResponse": { "description": "Response message for List BackupPlanAssociation", "id": "ListBackupPlanAssociationsResponse", @@ -3873,64 +3654,6 @@ }, "type": "object" }, - "LocationAssignment": { - "id": "LocationAssignment", - "properties": { - "location": { - "type": "string" - }, - "locationType": { - "enum": [ - "UNSPECIFIED", - "CLUSTER", - "POP", - "CLOUD_ZONE", - "CLOUD_REGION", - "MULTI_REGION_GEO", - "MULTI_REGION_JURISDICTION", - "GLOBAL", - "OTHER" - ], - "enumDescriptions": [ - "", - "1-10: Physical failure domains.", - "", - "11-20: Logical failure domains.", - "", - "", - "", - "", - "" - ], - "type": "string" - } - }, - "type": "object" - }, - "LocationData": { - "id": "LocationData", - "properties": { - "blobstoreLocation": { - "$ref": "BlobstoreLocation" - }, - "childAssetLocation": { - "$ref": "CloudAssetComposition" - }, - "directLocation": { - "$ref": "DirectLocationAssignment" - }, - "gcpProjectProxy": { - "$ref": "TenantProjectProxy" - }, - "placerLocation": { - "$ref": "PlacerLocation" - }, - "spannerLocation": { - "$ref": "SpannerLocation" - } - }, - "type": "object" - }, "ManagementServer": { "description": "ManagementServer describes a single BackupDR ManagementServer instance.", "id": "ManagementServer", @@ -4351,17 +4074,6 @@ }, "type": "object" }, - "PlacerLocation": { - "description": "Message describing that the location of the customer resource is tied to placer allocations", - "id": "PlacerLocation", - "properties": { - "placerConfig": { - "description": "Directory with a config related to it in placer (e.g. \"/placer/prod/home/my-root/my-dir\")", - "type": "string" - } - }, - "type": "object" - }, "Policy": { "description": "An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { \"bindings\": [ { \"role\": \"roles/resourcemanager.organizationAdmin\", \"members\": [ \"user:mike@example.com\", \"group:admins@example.com\", \"domain:google.com\", \"serviceAccount:my-project-id@appspot.gserviceaccount.com\" ] }, { \"role\": \"roles/resourcemanager.organizationViewer\", \"members\": [ \"user:eve@example.com\" ], \"condition\": { \"title\": \"expirable access\", \"description\": \"Does not grant access after Sep 2020\", \"expression\": \"request.time \u003c timestamp('2020-10-01T00:00:00.000Z')\", } } ], \"etag\": \"BwWWja0YfJA=\", \"version\": 3 } ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time \u003c timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/).", "id": "Policy", @@ -4393,25 +4105,6 @@ }, "type": "object" }, - "RegionalMigDistributionPolicy": { - "description": "To be used for specifying the intended distribution of regional compute.googleapis.com/InstanceGroupManager instances", - "id": "RegionalMigDistributionPolicy", - "properties": { - "targetShape": { - "description": "The shape in which the group converges around distribution of resources. Instance of proto2 enum", - "format": "int32", - "type": "integer" - }, - "zones": { - "description": "Cloud zones used by regional MIG to create instances.", - "items": { - "$ref": "ZoneConfiguration" - }, - "type": "array" - } - }, - "type": "object" - }, "RemoveDataSourceRequest": { "description": "Message for deleting a DataSource.", "id": "RemoveDataSourceRequest", @@ -4423,44 +4116,6 @@ }, "type": "object" }, - "RequirementOverride": { - "id": "RequirementOverride", - "properties": { - "ziOverride": { - "enum": [ - "ZI_UNSPECIFIED", - "ZI_UNKNOWN", - "ZI_NOT_REQUIRED", - "ZI_PREFERRED", - "ZI_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "", - "" - ], - "type": "string" - }, - "zsOverride": { - "enum": [ - "ZS_UNSPECIFIED", - "ZS_UNKNOWN", - "ZS_NOT_REQUIRED", - "ZS_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "" - ], - "type": "string" - } - }, - "type": "object" - }, "RestoreBackupRequest": { "description": "Request message for restoring from a Backup.", "id": "RestoreBackupRequest", @@ -4706,26 +4361,6 @@ "properties": {}, "type": "object" }, - "SpannerLocation": { - "id": "SpannerLocation", - "properties": { - "backupName": { - "description": "Set of backups used by the resource with name in the same format as what is available at http://table/spanner_automon.backup_metadata", - "items": { - "type": "string" - }, - "type": "array" - }, - "dbName": { - "description": "Set of databases used by the resource in format /span//", - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "StandardSchedule": { "description": "`StandardSchedule` defines a schedule that run within the confines of a defined window of days. We can define recurrence type for schedule as HOURLY, DAILY, WEEKLY, MONTHLY or YEARLY.", "id": "StandardSchedule", @@ -4894,18 +4529,6 @@ }, "type": "object" }, - "TenantProjectProxy": { - "id": "TenantProjectProxy", - "properties": { - "projectNumbers": { - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "TestIamPermissionsRequest": { "description": "Request message for `TestIamPermissions` method.", "id": "TestIamPermissionsRequest", @@ -5033,15 +4656,6 @@ } }, "type": "object" - }, - "ZoneConfiguration": { - "id": "ZoneConfiguration", - "properties": { - "zone": { - "type": "string" - } - }, - "type": "object" } }, "servicePath": "", diff --git a/backupdr/v1/backupdr-gen.go b/backupdr/v1/backupdr-gen.go index 600ea47eb1d..545a4fd0548 100644 --- a/backupdr/v1/backupdr-gen.go +++ b/backupdr/v1/backupdr-gen.go @@ -474,41 +474,6 @@ func (s AllocationAffinity) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// AssetLocation: Provides the mapping of a cloud asset to a direct physical -// location or to a proxy that defines the location on its behalf. -type AssetLocation struct { - // CcfeRmsPath: Spanner path of the CCFE RMS database. It is only applicable - // for CCFE tenants that use CCFE RMS for storing resource metadata. - CcfeRmsPath string `json:"ccfeRmsPath,omitempty"` - // Expected: Defines the customer expectation around ZI/ZS for this asset and - // ZI/ZS state of the region at the time of asset creation. - Expected *IsolationExpectations `json:"expected,omitempty"` - // ExtraParameters: Defines extra parameters required for specific asset types. - ExtraParameters []*ExtraParameter `json:"extraParameters,omitempty"` - // LocationData: Contains all kinds of physical location definitions for this - // asset. - LocationData []*LocationData `json:"locationData,omitempty"` - // ParentAsset: Defines parents assets if any in order to allow later - // generation of child_asset_location data via child assets. - ParentAsset []*CloudAsset `json:"parentAsset,omitempty"` - // ForceSendFields is a list of field names (e.g. "CcfeRmsPath") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "CcfeRmsPath") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s AssetLocation) MarshalJSON() ([]byte, error) { - type NoMethod AssetLocation - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // AttachedDisk: An instance-attached disk resource. type AttachedDisk struct { // AutoDelete: Optional. Specifies whether the disk will be auto-deleted when @@ -982,8 +947,8 @@ type BackupPlan struct { // Format: `projects/{project}/locations/{location}/backupPlans/{backup_plan}` Name string `json:"name,omitempty"` // ResourceType: Required. The resource type to which the `BackupPlan` will be - // applied. Examples include, "compute.googleapis.com/Instance" and - // "storage.googleapis.com/Bucket". + // applied. Examples include, "compute.googleapis.com/Instance", + // "sqladmin.googleapis.com/Instance" and "storage.googleapis.com/Bucket". ResourceType string `json:"resourceType,omitempty"` // State: Output only. The `State` for the `BackupPlan`. // @@ -1117,12 +1082,16 @@ type BackupVault struct { // not provided during creation. // // Possible values: - // "ACCESS_RESTRICTION_UNSPECIFIED" - Access restriction not set. + // "ACCESS_RESTRICTION_UNSPECIFIED" - Access restriction not set. If user + // does not provide any value or pass this value, it will be changed to + // WITHIN_ORGANIZATION. // "WITHIN_PROJECT" - Access to or from resources outside your current // project will be denied. // "WITHIN_ORGANIZATION" - Access to or from resources outside your current // organization will be denied. // "UNRESTRICTED" - No access restriction. + // "WITHIN_ORG_BUT_UNRESTRICTED_FOR_BA" - Access to or from resources outside + // your current organization will be denied except for backup appliance. AccessRestriction string `json:"accessRestriction,omitempty"` // Annotations: Optional. User annotations. See // https://google.aip.dev/128#annotations Stores small amounts of arbitrary @@ -1331,73 +1300,10 @@ func (s Binding) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// BlobstoreLocation: Policy ID that identified data placement in Blobstore as -// per go/blobstore-user-guide#data-metadata-placement-and-failure-domains -type BlobstoreLocation struct { - PolicyId []string `json:"policyId,omitempty"` - // ForceSendFields is a list of field names (e.g. "PolicyId") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "PolicyId") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s BlobstoreLocation) MarshalJSON() ([]byte, error) { - type NoMethod BlobstoreLocation - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // CancelOperationRequest: The request message for Operations.CancelOperation. type CancelOperationRequest struct { } -type CloudAsset struct { - AssetName string `json:"assetName,omitempty"` - AssetType string `json:"assetType,omitempty"` - // ForceSendFields is a list of field names (e.g. "AssetName") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "AssetName") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s CloudAsset) MarshalJSON() ([]byte, error) { - type NoMethod CloudAsset - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -type CloudAssetComposition struct { - ChildAsset []*CloudAsset `json:"childAsset,omitempty"` - // ForceSendFields is a list of field names (e.g. "ChildAsset") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ChildAsset") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s CloudAssetComposition) MarshalJSON() ([]byte, error) { - type NoMethod CloudAssetComposition - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // ComputeInstanceBackupProperties: ComputeInstanceBackupProperties represents // Compute Engine instance backup properties. type ComputeInstanceBackupProperties struct { @@ -1861,26 +1767,6 @@ func (s DataSourceGcpResource) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type DirectLocationAssignment struct { - Location []*LocationAssignment `json:"location,omitempty"` - // ForceSendFields is a list of field names (e.g. "Location") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Location") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s DirectLocationAssignment) MarshalJSON() ([]byte, error) { - type NoMethod DirectLocationAssignment - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // DisplayDevice: A set of Display Device options type DisplayDevice struct { // EnableDisplay: Optional. Enables display for the Compute Engine VM @@ -1987,30 +1873,6 @@ func (s Expr) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// ExtraParameter: Defines parameters that should only be used for specific -// asset types. -type ExtraParameter struct { - // RegionalMigDistributionPolicy: Details about zones used by regional - // compute.googleapis.com/InstanceGroupManager to create instances. - RegionalMigDistributionPolicy *RegionalMigDistributionPolicy `json:"regionalMigDistributionPolicy,omitempty"` - // ForceSendFields is a list of field names (e.g. - // "RegionalMigDistributionPolicy") to unconditionally include in API requests. - // By default, fields with empty or default values are omitted from API - // requests. See https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields - // for more details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "RegionalMigDistributionPolicy") - // to include in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s ExtraParameter) MarshalJSON() ([]byte, error) { - type NoMethod ExtraParameter - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // FetchAccessTokenRequest: Request message for FetchAccessToken. type FetchAccessTokenRequest struct { // GenerationId: Required. The generation of the backup to update. @@ -2391,81 +2253,6 @@ func (s InstanceParams) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type IsolationExpectations struct { - // RequirementOverride: Explicit overrides for ZI and ZS requirements to be - // used for resources that should be excluded from ZI/ZS verification logic. - RequirementOverride *RequirementOverride `json:"requirementOverride,omitempty"` - // Possible values: - // "ZI_UNSPECIFIED" - // "ZI_UNKNOWN" - To be used if tracking is not available - // "ZI_NOT_REQUIRED" - // "ZI_PREFERRED" - // "ZI_REQUIRED" - ZiOrgPolicy string `json:"ziOrgPolicy,omitempty"` - // Possible values: - // "ZI_REGION_POLICY_UNSPECIFIED" - // "ZI_REGION_POLICY_UNKNOWN" - To be used if tracking is not available - // "ZI_REGION_POLICY_NOT_SET" - // "ZI_REGION_POLICY_FAIL_OPEN" - // "ZI_REGION_POLICY_FAIL_CLOSED" - ZiRegionPolicy string `json:"ziRegionPolicy,omitempty"` - // Possible values: - // "ZI_REGION_UNSPECIFIED" - // "ZI_REGION_UNKNOWN" - To be used if tracking is not available - // "ZI_REGION_NOT_ENABLED" - // "ZI_REGION_ENABLED" - ZiRegionState string `json:"ziRegionState,omitempty"` - // ZoneIsolation: Deprecated: use zi_org_policy, zi_region_policy and - // zi_region_state instead for setting ZI expectations as per - // go/zicy-publish-physical-location. - // - // Possible values: - // "ZI_UNSPECIFIED" - // "ZI_UNKNOWN" - To be used if tracking is not available - // "ZI_NOT_REQUIRED" - // "ZI_PREFERRED" - // "ZI_REQUIRED" - ZoneIsolation string `json:"zoneIsolation,omitempty"` - // ZoneSeparation: Deprecated: use zs_org_policy, and zs_region_stateinstead - // for setting Zs expectations as per go/zicy-publish-physical-location. - // - // Possible values: - // "ZS_UNSPECIFIED" - // "ZS_UNKNOWN" - To be used if tracking is not available - // "ZS_NOT_REQUIRED" - // "ZS_REQUIRED" - ZoneSeparation string `json:"zoneSeparation,omitempty"` - // Possible values: - // "ZS_UNSPECIFIED" - // "ZS_UNKNOWN" - To be used if tracking is not available - // "ZS_NOT_REQUIRED" - // "ZS_REQUIRED" - ZsOrgPolicy string `json:"zsOrgPolicy,omitempty"` - // Possible values: - // "ZS_REGION_UNSPECIFIED" - // "ZS_REGION_UNKNOWN" - To be used if tracking of the asset ZS-bit is not - // available - // "ZS_REGION_NOT_ENABLED" - // "ZS_REGION_ENABLED" - ZsRegionState string `json:"zsRegionState,omitempty"` - // ForceSendFields is a list of field names (e.g. "RequirementOverride") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "RequirementOverride") to include - // in API requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s IsolationExpectations) MarshalJSON() ([]byte, error) { - type NoMethod IsolationExpectations - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // ListBackupPlanAssociationsResponse: Response message for List // BackupPlanAssociation type ListBackupPlanAssociationsResponse struct { @@ -2774,62 +2561,6 @@ func (s Location) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type LocationAssignment struct { - Location string `json:"location,omitempty"` - // Possible values: - // "UNSPECIFIED" - // "CLUSTER" - 1-10: Physical failure domains. - // "POP" - // "CLOUD_ZONE" - 11-20: Logical failure domains. - // "CLOUD_REGION" - // "MULTI_REGION_GEO" - // "MULTI_REGION_JURISDICTION" - // "GLOBAL" - // "OTHER" - LocationType string `json:"locationType,omitempty"` - // ForceSendFields is a list of field names (e.g. "Location") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Location") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s LocationAssignment) MarshalJSON() ([]byte, error) { - type NoMethod LocationAssignment - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -type LocationData struct { - BlobstoreLocation *BlobstoreLocation `json:"blobstoreLocation,omitempty"` - ChildAssetLocation *CloudAssetComposition `json:"childAssetLocation,omitempty"` - DirectLocation *DirectLocationAssignment `json:"directLocation,omitempty"` - GcpProjectProxy *TenantProjectProxy `json:"gcpProjectProxy,omitempty"` - PlacerLocation *PlacerLocation `json:"placerLocation,omitempty"` - SpannerLocation *SpannerLocation `json:"spannerLocation,omitempty"` - // ForceSendFields is a list of field names (e.g. "BlobstoreLocation") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "BlobstoreLocation") to include in - // API requests with the JSON null value. By default, fields with empty values - // are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s LocationData) MarshalJSON() ([]byte, error) { - type NoMethod LocationData - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // ManagementServer: ManagementServer describes a single BackupDR // ManagementServer instance. type ManagementServer struct { @@ -3232,30 +2963,6 @@ func (s OperationMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// PlacerLocation: Message describing that the location of the customer -// resource is tied to placer allocations -type PlacerLocation struct { - // PlacerConfig: Directory with a config related to it in placer (e.g. - // "/placer/prod/home/my-root/my-dir") - PlacerConfig string `json:"placerConfig,omitempty"` - // ForceSendFields is a list of field names (e.g. "PlacerConfig") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "PlacerConfig") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s PlacerLocation) MarshalJSON() ([]byte, error) { - type NoMethod PlacerLocation - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // Policy: An Identity and Access Management (IAM) policy, which specifies // access controls for Google Cloud resources. A `Policy` is a collection of // `bindings`. A `binding` binds one or more `members`, or principals, to a @@ -3348,33 +3055,6 @@ func (s Policy) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// RegionalMigDistributionPolicy: To be used for specifying the intended -// distribution of regional compute.googleapis.com/InstanceGroupManager -// instances -type RegionalMigDistributionPolicy struct { - // TargetShape: The shape in which the group converges around distribution of - // resources. Instance of proto2 enum - TargetShape int64 `json:"targetShape,omitempty"` - // Zones: Cloud zones used by regional MIG to create instances. - Zones []*ZoneConfiguration `json:"zones,omitempty"` - // ForceSendFields is a list of field names (e.g. "TargetShape") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "TargetShape") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s RegionalMigDistributionPolicy) MarshalJSON() ([]byte, error) { - type NoMethod RegionalMigDistributionPolicy - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // RemoveDataSourceRequest: Message for deleting a DataSource. type RemoveDataSourceRequest struct { // RequestId: Optional. An optional request ID to identify requests. Specify a @@ -3407,38 +3087,6 @@ func (s RemoveDataSourceRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type RequirementOverride struct { - // Possible values: - // "ZI_UNSPECIFIED" - // "ZI_UNKNOWN" - To be used if tracking is not available - // "ZI_NOT_REQUIRED" - // "ZI_PREFERRED" - // "ZI_REQUIRED" - ZiOverride string `json:"ziOverride,omitempty"` - // Possible values: - // "ZS_UNSPECIFIED" - // "ZS_UNKNOWN" - To be used if tracking is not available - // "ZS_NOT_REQUIRED" - // "ZS_REQUIRED" - ZsOverride string `json:"zsOverride,omitempty"` - // ForceSendFields is a list of field names (e.g. "ZiOverride") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ZiOverride") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s RequirementOverride) MarshalJSON() ([]byte, error) { - type NoMethod RequirementOverride - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // RestoreBackupRequest: Request message for restoring from a Backup. type RestoreBackupRequest struct { // ComputeInstanceRestoreProperties: Compute Engine instance properties to be @@ -3760,30 +3408,6 @@ func (s SetInternalStatusRequest) MarshalJSON() ([]byte, error) { type SetInternalStatusResponse struct { } -type SpannerLocation struct { - // BackupName: Set of backups used by the resource with name in the same format - // as what is available at http://table/spanner_automon.backup_metadata - BackupName []string `json:"backupName,omitempty"` - // DbName: Set of databases used by the resource in format /span// - DbName []string `json:"dbName,omitempty"` - // ForceSendFields is a list of field names (e.g. "BackupName") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "BackupName") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s SpannerLocation) MarshalJSON() ([]byte, error) { - type NoMethod SpannerLocation - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // StandardSchedule: `StandardSchedule` defines a schedule that run within the // confines of a defined window of days. We can define recurrence type for // schedule as HOURLY, DAILY, WEEKLY, MONTHLY or YEARLY. @@ -3965,26 +3589,6 @@ func (s TargetResource) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type TenantProjectProxy struct { - ProjectNumbers []string `json:"projectNumbers,omitempty"` - // ForceSendFields is a list of field names (e.g. "ProjectNumbers") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ProjectNumbers") to include in - // API requests with the JSON null value. By default, fields with empty values - // are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s TenantProjectProxy) MarshalJSON() ([]byte, error) { - type NoMethod TenantProjectProxy - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // TestIamPermissionsRequest: Request message for `TestIamPermissions` method. type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. Permissions @@ -4169,26 +3773,6 @@ func (s WorkforceIdentityBasedOAuth2ClientID) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type ZoneConfiguration struct { - Zone string `json:"zone,omitempty"` - // ForceSendFields is a list of field names (e.g. "Zone") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Zone") to include in API requests - // with the JSON null value. By default, fields with empty values are omitted - // from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s ZoneConfiguration) MarshalJSON() ([]byte, error) { - type NoMethod ZoneConfiguration - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - type ProjectsLocationsGetCall struct { s *Service name string diff --git a/bigqueryreservation/v1/bigqueryreservation-api.json b/bigqueryreservation/v1/bigqueryreservation-api.json index 69bfbe1e8b6..c26ae88f259 100644 --- a/bigqueryreservation/v1/bigqueryreservation-api.json +++ b/bigqueryreservation/v1/bigqueryreservation-api.json @@ -935,7 +935,7 @@ } } }, - "revision": "20240921", + "revision": "20241023", "rootUrl": "https://bigqueryreservation.googleapis.com/", "schemas": { "Assignment": { @@ -946,6 +946,10 @@ "description": "The resource which will use the reservation. E.g. `projects/myproject`, `folders/123`, or `organizations/456`.", "type": "string" }, + "enableGeminiInBigquery": { + "description": "Optional. This field controls if \"Gemini in BigQuery\" (https://cloud.google.com/gemini/docs/bigquery/overview) features should be enabled for this reservation assignment, which is not on by default. \"Gemini in BigQuery\" has a distinct compliance posture from BigQuery. If this field is set to true, the assignment job type is QUERY, and the parent reservation edition is ENTERPRISE_PLUS, then the assignment will give the grantee project/organization access to \"Gemini in BigQuery\" features.", + "type": "boolean" + }, "jobType": { "description": "Which type of jobs will use the reservation.", "enum": [ @@ -994,7 +998,7 @@ "id": "Autoscale", "properties": { "currentSlots": { - "description": "Output only. The slot capacity added to this reservation when autoscale happens. Will be between [0, max_slots].", + "description": "Output only. The slot capacity added to this reservation when autoscale happens. Will be between [0, max_slots]. Note: after users reduce max_slots, it may take a while before it can be propagated, so current_slots may stay in the original value and could be larger than max_slots for that brief period (less than one minute)", "format": "int64", "readOnly": true, "type": "string" @@ -1326,6 +1330,13 @@ "description": "If false, any query or pipeline job using this reservation will use idle slots from other reservations within the same admin project. If true, a query or pipeline job using this reservation will execute with the slot capacity specified in the slot_capacity field at most.", "type": "boolean" }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. The labels associated with this reservation. You can use these to organize and group your reservations. You can set this property when inserting or updating a reservation.", + "type": "object" + }, "multiRegionAuxiliary": { "description": "Applicable only for reservations located within one of the BigQuery multi-regions (US or EU). If set to true, this reservation is placed in the organization's secondary region which is designated for disaster recovery purposes. If false, this reservation is placed in the organization's default region. NOTE: this is a preview feature. Project must be allow-listed in order to set this field.", "type": "boolean" diff --git a/bigqueryreservation/v1/bigqueryreservation-gen.go b/bigqueryreservation/v1/bigqueryreservation-gen.go index 412078f3b9b..3da3debaf59 100644 --- a/bigqueryreservation/v1/bigqueryreservation-gen.go +++ b/bigqueryreservation/v1/bigqueryreservation-gen.go @@ -227,6 +227,15 @@ type Assignment struct { // Assignee: The resource which will use the reservation. E.g. // `projects/myproject`, `folders/123`, or `organizations/456`. Assignee string `json:"assignee,omitempty"` + // EnableGeminiInBigquery: Optional. This field controls if "Gemini in + // BigQuery" (https://cloud.google.com/gemini/docs/bigquery/overview) features + // should be enabled for this reservation assignment, which is not on by + // default. "Gemini in BigQuery" has a distinct compliance posture from + // BigQuery. If this field is set to true, the assignment job type is QUERY, + // and the parent reservation edition is ENTERPRISE_PLUS, then the assignment + // will give the grantee project/organization access to "Gemini in BigQuery" + // features. + EnableGeminiInBigquery bool `json:"enableGeminiInBigquery,omitempty"` // JobType: Which type of jobs will use the reservation. // // Possible values: @@ -280,7 +289,10 @@ func (s Assignment) MarshalJSON() ([]byte, error) { // Autoscale: Auto scaling settings. type Autoscale struct { // CurrentSlots: Output only. The slot capacity added to this reservation when - // autoscale happens. Will be between [0, max_slots]. + // autoscale happens. Will be between [0, max_slots]. Note: after users reduce + // max_slots, it may take a while before it can be propagated, so current_slots + // may stay in the original value and could be larger than max_slots for that + // brief period (less than one minute) CurrentSlots int64 `json:"currentSlots,omitempty,string"` // MaxSlots: Number of slots to be scaled when needed. MaxSlots int64 `json:"maxSlots,omitempty,string"` @@ -670,6 +682,10 @@ type Reservation struct { // If true, a query or pipeline job using this reservation will execute with // the slot capacity specified in the slot_capacity field at most. IgnoreIdleSlots bool `json:"ignoreIdleSlots,omitempty"` + // Labels: Optional. The labels associated with this reservation. You can use + // these to organize and group your reservations. You can set this property + // when inserting or updating a reservation. + Labels map[string]string `json:"labels,omitempty"` // MultiRegionAuxiliary: Applicable only for reservations located within one of // the BigQuery multi-regions (US or EU). If set to true, this reservation is // placed in the organization's secondary region which is designated for diff --git a/chat/v1/chat-api.json b/chat/v1/chat-api.json index f6a4b60eb8f..f6a3cee4867 100644 --- a/chat/v1/chat-api.json +++ b/chat/v1/chat-api.json @@ -1344,7 +1344,7 @@ } } }, - "revision": "20241008", + "revision": "20241020", "rootUrl": "https://chat.googleapis.com/", "schemas": { "AccessSettings": { @@ -1999,7 +1999,7 @@ "Default value. Unspecified.", "A user opens a dialog.", "A user clicks an interactive element of a dialog. For example, a user fills out information in a dialog and clicks a button to submit the information.", - "A user closes a dialog without submitting information, or the dialog is canceled." + "A user closes a dialog without submitting information. The Chat app only receives this interaction event when users click the close icon in the top right corner of the dialog. When the user closes the dialog by other means (such as refreshing the browser, clicking outside the dialog box, or pressing the escape key), no event is sent. ." ], "type": "string" }, @@ -2281,6 +2281,24 @@ "text": { "description": "The text displayed inside the button.", "type": "string" + }, + "type": { + "description": "Optional. The type of a button. If unset, button type defaults to `OUTLINED`. If the `color` field is set, the button type is forced to `FILLED` and any value set for this field is ignored. [Google Chat apps](https://developers.google.com/workspace/chat):", + "enum": [ + "TYPE_UNSPECIFIED", + "OUTLINED", + "FILLED", + "FILLED_TONAL", + "BORDERLESS" + ], + "enumDescriptions": [ + "Don't use. Unspecified.", + "Outlined buttons are medium-emphasis buttons. They usually contain actions that are important, but aren’t the primary action in a Chat app or an add-on.", + "A filled button has a container with a solid color. It has the most visual impact and is recommended for the important and primary action in a Chat app or an add-on.", + "A filled tonal button is an alternative middle ground between filled and outlined buttons. They’re useful in contexts where a lower-priority button requires slightly more emphasis than an outline button would give.", + "A button does not have an invisible container in its default state. It is often used for the lowest priority actions, especially when presenting multiple options." + ], + "type": "string" } }, "type": "object" @@ -2429,6 +2447,97 @@ }, "type": "object" }, + "GoogleAppsCardV1Chip": { + "description": "A text, icon, or text and icon chip that users can click. [Google Chat apps](https://developers.google.com/workspace/chat):", + "id": "GoogleAppsCardV1Chip", + "properties": { + "altText": { + "description": "The alternative text that's used for accessibility. Set descriptive text that lets users know what the chip does. For example, if a chip opens a hyperlink, write: \"Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/workspace/chat\".", + "type": "string" + }, + "disabled": { + "description": "Whether the chip is in an inactive state and ignores user actions. Defaults to `false`.", + "type": "boolean" + }, + "enabled": { + "deprecated": true, + "description": "Whether the chip is in an active state and responds to user actions. Defaults to `true`. Deprecated. Use `disabled` instead.", + "type": "boolean" + }, + "icon": { + "$ref": "GoogleAppsCardV1Icon", + "description": "The icon image. If both `icon` and `text` are set, then the icon appears before the text." + }, + "label": { + "description": "The text displayed inside the chip.", + "type": "string" + }, + "onClick": { + "$ref": "GoogleAppsCardV1OnClick", + "description": "Optional. The action to perform when a user clicks the chip, such as opening a hyperlink or running a custom function." + } + }, + "type": "object" + }, + "GoogleAppsCardV1ChipList": { + "description": "A list of chips layed out horizontally, which can either scroll horizontally or wrap to the next line. [Google Chat apps](https://developers.google.com/workspace/chat):", + "id": "GoogleAppsCardV1ChipList", + "properties": { + "chips": { + "description": "An array of chips.", + "items": { + "$ref": "GoogleAppsCardV1Chip" + }, + "type": "array" + }, + "layout": { + "description": "Specified chip list layout.", + "enum": [ + "LAYOUT_UNSPECIFIED", + "WRAPPED", + "HORIZONTAL_SCROLLABLE" + ], + "enumDescriptions": [ + "Don't use. Unspecified.", + "Default value. The chip list wraps to the next line if there isn't enough horizontal space.", + "The chips scroll horizontally if they don't fit in the available space." + ], + "type": "string" + } + }, + "type": "object" + }, + "GoogleAppsCardV1CollapseControl": { + "description": "Represent an expand and collapse control. [Google Chat apps](https://developers.google.com/workspace/chat):", + "id": "GoogleAppsCardV1CollapseControl", + "properties": { + "collapseButton": { + "$ref": "GoogleAppsCardV1Button", + "description": "Optional. Define a customizable button to collapse the section. Both expand_button and collapse_button field must be set. Only one field set will not take into effect. If this field isn't set, the default button is used." + }, + "expandButton": { + "$ref": "GoogleAppsCardV1Button", + "description": "Optional. Define a customizable button to expand the section. Both expand_button and collapse_button field must be set. Only one field set will not take into effect. If this field isn't set, the default button is used." + }, + "horizontalAlignment": { + "description": "The horizontal alignment of the expand and collapse button.", + "enum": [ + "HORIZONTAL_ALIGNMENT_UNSPECIFIED", + "START", + "CENTER", + "END" + ], + "enumDescriptions": [ + "Don't use. Unspecified.", + "Default value. Aligns widgets to the start position of the column. For left-to-right layouts, aligns to the left. For right-to-left layouts, aligns to the right.", + "Aligns widgets to the center of the column.", + "Aligns widgets to the end position of the column. For left-to-right layouts, aligns widgets to the right. For right-to-left layouts, aligns widgets to the left." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleAppsCardV1Column": { "description": "A column. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend)", "id": "GoogleAppsCardV1Column", @@ -2819,6 +2928,10 @@ "openLink": { "$ref": "GoogleAppsCardV1OpenLink", "description": "If specified, this `onClick` triggers an open link action." + }, + "overflowMenu": { + "$ref": "GoogleAppsCardV1OverflowMenu", + "description": "If specified, this `onClick` opens an overflow menu. [Google Chat apps](https://developers.google.com/workspace/chat):" } }, "type": "object" @@ -2858,6 +2971,43 @@ }, "type": "object" }, + "GoogleAppsCardV1OverflowMenu": { + "description": "A widget that presents a pop-up menu with one or more actions that users can invoke. For example, showing non-primary actions in a card. You can use this widget when actions don't fit in the available space. To use, specify this widget in the `OnClick` action of widgets that support it. For example, in a `Button`. [Google Chat apps](https://developers.google.com/workspace/chat):", + "id": "GoogleAppsCardV1OverflowMenu", + "properties": { + "items": { + "description": "Required. The list of menu options.", + "items": { + "$ref": "GoogleAppsCardV1OverflowMenuItem" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleAppsCardV1OverflowMenuItem": { + "description": "An option that users can invoke in an overflow menu. [Google Chat apps](https://developers.google.com/workspace/chat):", + "id": "GoogleAppsCardV1OverflowMenuItem", + "properties": { + "disabled": { + "description": "Whether the menu option is disabled. Defaults to false.", + "type": "boolean" + }, + "onClick": { + "$ref": "GoogleAppsCardV1OnClick", + "description": "Required. The action invoked when a menu option is selected. This `OnClick` cannot contain an `OverflowMenu`, any specified `OverflowMenu` is dropped and the menu item disabled." + }, + "startIcon": { + "$ref": "GoogleAppsCardV1Icon", + "description": "The icon displayed in front of the text." + }, + "text": { + "description": "Required. The text that identifies or describes the item to users.", + "type": "string" + } + }, + "type": "object" + }, "GoogleAppsCardV1PlatformDataSource": { "description": "For a `SelectionInput` widget that uses a multiselect menu, a data source from Google Workspace. Used to populate items in a multiselect menu. [Google Chat apps](https://developers.google.com/workspace/chat):", "id": "GoogleAppsCardV1PlatformDataSource", @@ -2885,6 +3035,10 @@ "description": "A section contains a collection of widgets that are rendered vertically in the order that they're specified. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", "id": "GoogleAppsCardV1Section", "properties": { + "collapseControl": { + "$ref": "GoogleAppsCardV1CollapseControl", + "description": "Optional. Define the expand and collapse button of the section. This button will be shown only if the section is collapsible. If this field isn't set, the default button is used. [Google Chat apps](https://developers.google.com/workspace/chat):" + }, "collapsible": { "description": "Indicates whether this section is collapsible. Collapsible sections hide some or all widgets, but users can expand the section to reveal the hidden widgets by clicking **Show more**. Users can hide the widgets again by clicking **Show less**. To determine which widgets are hidden, specify `uncollapsibleWidgetsCount`.", "type": "boolean" @@ -3114,6 +3268,11 @@ "description": "A paragraph of text that supports formatting. For an example in Google Chat apps, see [Add a paragraph of formatted text](https://developers.google.com/workspace/chat/add-text-image-card-dialog#add_a_paragraph_of_formatted_text). For more information about formatting text, see [Formatting text in Google Chat apps](https://developers.google.com/workspace/chat/format-messages#card-formatting) and [Formatting text in Google Workspace Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting). [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", "id": "GoogleAppsCardV1TextParagraph", "properties": { + "maxLines": { + "description": "The maximum number of lines of text that are displayed in the widget. If the text exceeds the specified maximum number of lines, the excess content is concealed behind a **show more** button. If the text is equal or shorter than the specified maximum number of lines, a **show more** button isn't displayed. The default value is 0, in which case all context is displayed. Negative values are ignored. [Google Chat apps](https://developers.google.com/workspace/chat):", + "format": "int32", + "type": "integer" + }, "text": { "description": "The text that's shown in the widget.", "type": "string" @@ -3129,6 +3288,10 @@ "$ref": "GoogleAppsCardV1ButtonList", "description": "A list of buttons. For example, the following JSON creates two buttons. The first is a blue text button and the second is an image button that opens a link: ``` \"buttonList\": { \"buttons\": [ { \"text\": \"Edit\", \"color\": { \"red\": 0, \"green\": 0, \"blue\": 1, }, \"disabled\": true, }, { \"icon\": { \"knownIcon\": \"INVITE\", \"altText\": \"check calendar\" }, \"onClick\": { \"openLink\": { \"url\": \"https://example.com/calendar\" } } } ] } ```" }, + "chipList": { + "$ref": "GoogleAppsCardV1ChipList", + "description": "A list of chips. For example, the following JSON creates two chips. The first is a text chip and the second is an icon chip that opens a link: ``` \"chipList\": { \"chips\": [ { \"text\": \"Edit\", \"disabled\": true, }, { \"icon\": { \"knownIcon\": \"INVITE\", \"altText\": \"check calendar\" }, \"onClick\": { \"openLink\": { \"url\": \"https://example.com/calendar\" } } } ] } ``` [Google Chat apps](https://developers.google.com/workspace/chat):" + }, "columns": { "$ref": "GoogleAppsCardV1Columns", "description": "Displays up to 2 columns. To include more than 2 columns, or to use rows, use the `Grid` widget. For example, the following JSON creates 2 columns that each contain text paragraphs: ``` \"columns\": { \"columnItems\": [ { \"horizontalSizeStyle\": \"FILL_AVAILABLE_SPACE\", \"horizontalAlignment\": \"CENTER\", \"verticalAlignment\": \"CENTER\", \"widgets\": [ { \"textParagraph\": { \"text\": \"First column text paragraph\" } } ] }, { \"horizontalSizeStyle\": \"FILL_AVAILABLE_SPACE\", \"horizontalAlignment\": \"CENTER\", \"verticalAlignment\": \"CENTER\", \"widgets\": [ { \"textParagraph\": { \"text\": \"Second column text paragraph\" } } ] } ] } ```" @@ -3192,6 +3355,10 @@ "$ref": "GoogleAppsCardV1ButtonList", "description": "ButtonList widget." }, + "chipList": { + "$ref": "GoogleAppsCardV1ChipList", + "description": "ChipList widget. [Google Chat apps](https://developers.google.com/workspace/chat):" + }, "dateTimePicker": { "$ref": "GoogleAppsCardV1DateTimePicker", "description": "DateTimePicker widget." diff --git a/chat/v1/chat-gen.go b/chat/v1/chat-gen.go index 2f85b344acd..639de7841df 100644 --- a/chat/v1/chat-gen.go +++ b/chat/v1/chat-gen.go @@ -1374,8 +1374,11 @@ type DeprecatedEvent struct { // "SUBMIT_DIALOG" - A user clicks an interactive element of a dialog. For // example, a user fills out information in a dialog and clicks a button to // submit the information. - // "CANCEL_DIALOG" - A user closes a dialog without submitting information, - // or the dialog is canceled. + // "CANCEL_DIALOG" - A user closes a dialog without submitting information. + // The Chat app only receives this interaction event when users click the close + // icon in the top right corner of the dialog. When the user closes the dialog + // by other means (such as refreshing the browser, clicking outside the dialog + // box, or pressing the escape key), no event is sent. . DialogEventType string `json:"dialogEventType,omitempty"` // EventTime: The timestamp indicating when the interaction event occurred. EventTime string `json:"eventTime,omitempty"` @@ -1835,6 +1838,27 @@ type GoogleAppsCardV1Button struct { OnClick *GoogleAppsCardV1OnClick `json:"onClick,omitempty"` // Text: The text displayed inside the button. Text string `json:"text,omitempty"` + // Type: Optional. The type of a button. If unset, button type defaults to + // `OUTLINED`. If the `color` field is set, the button type is forced to + // `FILLED` and any value set for this field is ignored. Google Chat apps + // (https://developers.google.com/workspace/chat): + // + // Possible values: + // "TYPE_UNSPECIFIED" - Don't use. Unspecified. + // "OUTLINED" - Outlined buttons are medium-emphasis buttons. They usually + // contain actions that are important, but aren’t the primary action in a + // Chat app or an add-on. + // "FILLED" - A filled button has a container with a solid color. It has the + // most visual impact and is recommended for the important and primary action + // in a Chat app or an add-on. + // "FILLED_TONAL" - A filled tonal button is an alternative middle ground + // between filled and outlined buttons. They’re useful in contexts where a + // lower-priority button requires slightly more emphasis than an outline button + // would give. + // "BORDERLESS" - A button does not have an invisible container in its + // default state. It is often used for the lowest priority actions, especially + // when presenting multiple options. + Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "AltText") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See @@ -2092,6 +2116,123 @@ func (s GoogleAppsCardV1CardHeader) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleAppsCardV1Chip: A text, icon, or text and icon chip that users can +// click. Google Chat apps (https://developers.google.com/workspace/chat): +type GoogleAppsCardV1Chip struct { + // AltText: The alternative text that's used for accessibility. Set descriptive + // text that lets users know what the chip does. For example, if a chip opens a + // hyperlink, write: "Opens a new browser tab and navigates to the Google Chat + // developer documentation at https://developers.google.com/workspace/chat". + AltText string `json:"altText,omitempty"` + // Disabled: Whether the chip is in an inactive state and ignores user actions. + // Defaults to `false`. + Disabled bool `json:"disabled,omitempty"` + // Enabled: Whether the chip is in an active state and responds to user + // actions. Defaults to `true`. Deprecated. Use `disabled` instead. + Enabled bool `json:"enabled,omitempty"` + // Icon: The icon image. If both `icon` and `text` are set, then the icon + // appears before the text. + Icon *GoogleAppsCardV1Icon `json:"icon,omitempty"` + // Label: The text displayed inside the chip. + Label string `json:"label,omitempty"` + // OnClick: Optional. The action to perform when a user clicks the chip, such + // as opening a hyperlink or running a custom function. + OnClick *GoogleAppsCardV1OnClick `json:"onClick,omitempty"` + // ForceSendFields is a list of field names (e.g. "AltText") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AltText") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleAppsCardV1Chip) MarshalJSON() ([]byte, error) { + type NoMethod GoogleAppsCardV1Chip + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleAppsCardV1ChipList: A list of chips layed out horizontally, which can +// either scroll horizontally or wrap to the next line. Google Chat apps +// (https://developers.google.com/workspace/chat): +type GoogleAppsCardV1ChipList struct { + // Chips: An array of chips. + Chips []*GoogleAppsCardV1Chip `json:"chips,omitempty"` + // Layout: Specified chip list layout. + // + // Possible values: + // "LAYOUT_UNSPECIFIED" - Don't use. Unspecified. + // "WRAPPED" - Default value. The chip list wraps to the next line if there + // isn't enough horizontal space. + // "HORIZONTAL_SCROLLABLE" - The chips scroll horizontally if they don't fit + // in the available space. + Layout string `json:"layout,omitempty"` + // ForceSendFields is a list of field names (e.g. "Chips") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Chips") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleAppsCardV1ChipList) MarshalJSON() ([]byte, error) { + type NoMethod GoogleAppsCardV1ChipList + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleAppsCardV1CollapseControl: Represent an expand and collapse control. +// Google Chat apps (https://developers.google.com/workspace/chat): +type GoogleAppsCardV1CollapseControl struct { + // CollapseButton: Optional. Define a customizable button to collapse the + // section. Both expand_button and collapse_button field must be set. Only one + // field set will not take into effect. If this field isn't set, the default + // button is used. + CollapseButton *GoogleAppsCardV1Button `json:"collapseButton,omitempty"` + // ExpandButton: Optional. Define a customizable button to expand the section. + // Both expand_button and collapse_button field must be set. Only one field set + // will not take into effect. If this field isn't set, the default button is + // used. + ExpandButton *GoogleAppsCardV1Button `json:"expandButton,omitempty"` + // HorizontalAlignment: The horizontal alignment of the expand and collapse + // button. + // + // Possible values: + // "HORIZONTAL_ALIGNMENT_UNSPECIFIED" - Don't use. Unspecified. + // "START" - Default value. Aligns widgets to the start position of the + // column. For left-to-right layouts, aligns to the left. For right-to-left + // layouts, aligns to the right. + // "CENTER" - Aligns widgets to the center of the column. + // "END" - Aligns widgets to the end position of the column. For + // left-to-right layouts, aligns widgets to the right. For right-to-left + // layouts, aligns widgets to the left. + HorizontalAlignment string `json:"horizontalAlignment,omitempty"` + // ForceSendFields is a list of field names (e.g. "CollapseButton") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CollapseButton") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleAppsCardV1CollapseControl) MarshalJSON() ([]byte, error) { + type NoMethod GoogleAppsCardV1CollapseControl + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleAppsCardV1Column: A column. Google Workspace Add-ons and Chat apps // (https://developers.google.com/workspace/extend) type GoogleAppsCardV1Column struct { @@ -2650,6 +2791,9 @@ type GoogleAppsCardV1OnClick struct { OpenDynamicLinkAction *GoogleAppsCardV1Action `json:"openDynamicLinkAction,omitempty"` // OpenLink: If specified, this `onClick` triggers an open link action. OpenLink *GoogleAppsCardV1OpenLink `json:"openLink,omitempty"` + // OverflowMenu: If specified, this `onClick` opens an overflow menu. Google + // Chat apps (https://developers.google.com/workspace/chat): + OverflowMenu *GoogleAppsCardV1OverflowMenu `json:"overflowMenu,omitempty"` // ForceSendFields is a list of field names (e.g. "Action") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See @@ -2712,6 +2856,65 @@ func (s GoogleAppsCardV1OpenLink) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleAppsCardV1OverflowMenu: A widget that presents a pop-up menu with one +// or more actions that users can invoke. For example, showing non-primary +// actions in a card. You can use this widget when actions don't fit in the +// available space. To use, specify this widget in the `OnClick` action of +// widgets that support it. For example, in a `Button`. Google Chat apps +// (https://developers.google.com/workspace/chat): +type GoogleAppsCardV1OverflowMenu struct { + // Items: Required. The list of menu options. + Items []*GoogleAppsCardV1OverflowMenuItem `json:"items,omitempty"` + // ForceSendFields is a list of field names (e.g. "Items") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Items") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleAppsCardV1OverflowMenu) MarshalJSON() ([]byte, error) { + type NoMethod GoogleAppsCardV1OverflowMenu + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleAppsCardV1OverflowMenuItem: An option that users can invoke in an +// overflow menu. Google Chat apps +// (https://developers.google.com/workspace/chat): +type GoogleAppsCardV1OverflowMenuItem struct { + // Disabled: Whether the menu option is disabled. Defaults to false. + Disabled bool `json:"disabled,omitempty"` + // OnClick: Required. The action invoked when a menu option is selected. This + // `OnClick` cannot contain an `OverflowMenu`, any specified `OverflowMenu` is + // dropped and the menu item disabled. + OnClick *GoogleAppsCardV1OnClick `json:"onClick,omitempty"` + // StartIcon: The icon displayed in front of the text. + StartIcon *GoogleAppsCardV1Icon `json:"startIcon,omitempty"` + // Text: Required. The text that identifies or describes the item to users. + Text string `json:"text,omitempty"` + // ForceSendFields is a list of field names (e.g. "Disabled") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Disabled") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleAppsCardV1OverflowMenuItem) MarshalJSON() ([]byte, error) { + type NoMethod GoogleAppsCardV1OverflowMenuItem + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleAppsCardV1PlatformDataSource: For a `SelectionInput` widget that uses // a multiselect menu, a data source from Google Workspace. Used to populate // items in a multiselect menu. Google Chat apps @@ -2753,6 +2956,11 @@ func (s GoogleAppsCardV1PlatformDataSource) MarshalJSON() ([]byte, error) { // rendered vertically in the order that they're specified. Google Workspace // Add-ons and Chat apps (https://developers.google.com/workspace/extend): type GoogleAppsCardV1Section struct { + // CollapseControl: Optional. Define the expand and collapse button of the + // section. This button will be shown only if the section is collapsible. If + // this field isn't set, the default button is used. Google Chat apps + // (https://developers.google.com/workspace/chat): + CollapseControl *GoogleAppsCardV1CollapseControl `json:"collapseControl,omitempty"` // Collapsible: Indicates whether this section is collapsible. Collapsible // sections hide some or all widgets, but users can expand the section to // reveal the hidden widgets by clicking **Show more**. Users can hide the @@ -2775,15 +2983,15 @@ type GoogleAppsCardV1Section struct { UncollapsibleWidgetsCount int64 `json:"uncollapsibleWidgetsCount,omitempty"` // Widgets: All the widgets in the section. Must contain at least one widget. Widgets []*GoogleAppsCardV1Widget `json:"widgets,omitempty"` - // ForceSendFields is a list of field names (e.g. "Collapsible") to + // ForceSendFields is a list of field names (e.g. "CollapseControl") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Collapsible") 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. "CollapseControl") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -3122,17 +3330,25 @@ func (s GoogleAppsCardV1TextInput) MarshalJSON() ([]byte, error) { // Google Workspace Add-ons and Chat apps // (https://developers.google.com/workspace/extend): type GoogleAppsCardV1TextParagraph struct { + // MaxLines: The maximum number of lines of text that are displayed in the + // widget. If the text exceeds the specified maximum number of lines, the + // excess content is concealed behind a **show more** button. If the text is + // equal or shorter than the specified maximum number of lines, a **show more** + // button isn't displayed. The default value is 0, in which case all context is + // displayed. Negative values are ignored. Google Chat apps + // (https://developers.google.com/workspace/chat): + MaxLines int64 `json:"maxLines,omitempty"` // Text: The text that's shown in the widget. 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 + // ForceSendFields is a list of field names (e.g. "MaxLines") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See // https://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 + // NullFields is a list of field names (e.g. "MaxLines") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -3153,6 +3369,13 @@ type GoogleAppsCardV1Widget struct { // "icon": { "knownIcon": "INVITE", "altText": "check calendar" }, "onClick": { // "openLink": { "url": "https://example.com/calendar" } } } ] } ``` ButtonList *GoogleAppsCardV1ButtonList `json:"buttonList,omitempty"` + // ChipList: A list of chips. For example, the following JSON creates two + // chips. The first is a text chip and the second is an icon chip that opens a + // link: ``` "chipList": { "chips": [ { "text": "Edit", "disabled": true, }, { + // "icon": { "knownIcon": "INVITE", "altText": "check calendar" }, "onClick": { + // "openLink": { "url": "https://example.com/calendar" } } } ] } ``` Google + // Chat apps (https://developers.google.com/workspace/chat): + ChipList *GoogleAppsCardV1ChipList `json:"chipList,omitempty"` // Columns: Displays up to 2 columns. To include more than 2 columns, or to use // rows, use the `Grid` widget. For example, the following JSON creates 2 // columns that each contain text paragraphs: ``` "columns": { "columnItems": [ @@ -3262,6 +3485,9 @@ func (s GoogleAppsCardV1Widget) MarshalJSON() ([]byte, error) { type GoogleAppsCardV1Widgets struct { // ButtonList: ButtonList widget. ButtonList *GoogleAppsCardV1ButtonList `json:"buttonList,omitempty"` + // ChipList: ChipList widget. Google Chat apps + // (https://developers.google.com/workspace/chat): + ChipList *GoogleAppsCardV1ChipList `json:"chipList,omitempty"` // DateTimePicker: DateTimePicker widget. DateTimePicker *GoogleAppsCardV1DateTimePicker `json:"dateTimePicker,omitempty"` // DecoratedText: DecoratedText widget. diff --git a/checks/v1alpha/checks-api.json b/checks/v1alpha/checks-api.json index b247584e9b6..09fac11c422 100644 --- a/checks/v1alpha/checks-api.json +++ b/checks/v1alpha/checks-api.json @@ -401,6 +401,25 @@ } } }, + "aisafety": { + "methods": { + "classifyContent": { + "description": "Analyze a piece of content with the provided set of policies.", + "flatPath": "v1alpha/aisafety:classifyContent", + "httpMethod": "POST", + "id": "checks.aisafety.classifyContent", + "parameterOrder": [], + "parameters": {}, + "path": "v1alpha/aisafety:classifyContent", + "request": { + "$ref": "GoogleChecksAisafetyV1alphaClassifyContentRequest" + }, + "response": { + "$ref": "GoogleChecksAisafetyV1alphaClassifyContentResponse" + } + } + } + }, "media": { "methods": { "upload": { @@ -444,7 +463,7 @@ } } }, - "revision": "20241013", + "revision": "20241029", "rootUrl": "https://checks.googleapis.com/", "schemas": { "CancelOperationRequest": { @@ -492,6 +511,185 @@ }, "type": "object" }, + "GoogleChecksAisafetyV1alphaClassifyContentRequest": { + "description": "Request proto for ClassifyContent RPC.", + "id": "GoogleChecksAisafetyV1alphaClassifyContentRequest", + "properties": { + "classifierVersion": { + "description": "Optional. Version of the classifier to use. If not specified, the latest version will be used.", + "enum": [ + "CLASSIFIER_VERSION_UNSPECIFIED", + "STABLE", + "LATEST" + ], + "enumDescriptions": [ + "Unspecified version.", + "Stable version.", + "Latest version." + ], + "type": "string" + }, + "context": { + "$ref": "GoogleChecksAisafetyV1alphaClassifyContentRequestContext", + "description": "Optional. Context about the input that will be used to help on the classification." + }, + "input": { + "$ref": "GoogleChecksAisafetyV1alphaClassifyContentRequestInputContent", + "description": "Required. Content to be classified." + }, + "policies": { + "description": "Required. List of policies to classify against.", + "items": { + "$ref": "GoogleChecksAisafetyV1alphaClassifyContentRequestPolicyConfig" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleChecksAisafetyV1alphaClassifyContentRequestContext": { + "description": "Context about the input that will be used to help on the classification.", + "id": "GoogleChecksAisafetyV1alphaClassifyContentRequestContext", + "properties": { + "prompt": { + "description": "Optional. Prompt that generated the model response.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleChecksAisafetyV1alphaClassifyContentRequestInputContent": { + "description": "Content to be classified.", + "id": "GoogleChecksAisafetyV1alphaClassifyContentRequestInputContent", + "properties": { + "textInput": { + "$ref": "GoogleChecksAisafetyV1alphaTextInput", + "description": "Content in text format." + } + }, + "type": "object" + }, + "GoogleChecksAisafetyV1alphaClassifyContentRequestPolicyConfig": { + "description": "List of policies to classify against.", + "id": "GoogleChecksAisafetyV1alphaClassifyContentRequestPolicyConfig", + "properties": { + "policyType": { + "description": "Required. Type of the policy.", + "enum": [ + "POLICY_TYPE_UNSPECIFIED", + "DANGEROUS_CONTENT", + "PII_SOLICITING_RECITING", + "HARASSMENT", + "SEXUALLY_EXPLICIT", + "HATE_SPEECH", + "MEDICAL_INFO", + "VIOLENCE_AND_GORE", + "OBSCENITY_AND_PROFANITY" + ], + "enumDescriptions": [ + "Default.", + "The model facilitates, promotes or enables access to harmful goods, services, and activities.", + "The model reveals an individual’s personal information and data.", + "The model generates content that is malicious, intimidating, bullying, or abusive towards another individual.", + "The model generates content that is sexually explicit in nature.", + "The model promotes violence, hatred, discrimination on the basis of race, religion, etc.", + "The model facilitates harm by providing health advice or guidance.", + "The model generates content that contains gratuitous, realistic descriptions of violence or gore.", + "" + ], + "type": "string" + }, + "threshold": { + "description": "Optional. Score threshold to use when deciding if the content is violative or non-violative. If not specified, the default 0.5 threshold for the policy will be used.", + "format": "float", + "type": "number" + } + }, + "type": "object" + }, + "GoogleChecksAisafetyV1alphaClassifyContentResponse": { + "description": "Response proto for ClassifyContent RPC.", + "id": "GoogleChecksAisafetyV1alphaClassifyContentResponse", + "properties": { + "policyResults": { + "description": "Results of the classification for each policy.", + "items": { + "$ref": "GoogleChecksAisafetyV1alphaClassifyContentResponsePolicyResult" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleChecksAisafetyV1alphaClassifyContentResponsePolicyResult": { + "description": "Result for one policy against the corresponding input.", + "id": "GoogleChecksAisafetyV1alphaClassifyContentResponsePolicyResult", + "properties": { + "policyType": { + "description": "Type of the policy.", + "enum": [ + "POLICY_TYPE_UNSPECIFIED", + "DANGEROUS_CONTENT", + "PII_SOLICITING_RECITING", + "HARASSMENT", + "SEXUALLY_EXPLICIT", + "HATE_SPEECH", + "MEDICAL_INFO", + "VIOLENCE_AND_GORE", + "OBSCENITY_AND_PROFANITY" + ], + "enumDescriptions": [ + "Default.", + "The model facilitates, promotes or enables access to harmful goods, services, and activities.", + "The model reveals an individual’s personal information and data.", + "The model generates content that is malicious, intimidating, bullying, or abusive towards another individual.", + "The model generates content that is sexually explicit in nature.", + "The model promotes violence, hatred, discrimination on the basis of race, religion, etc.", + "The model facilitates harm by providing health advice or guidance.", + "The model generates content that contains gratuitous, realistic descriptions of violence or gore.", + "" + ], + "type": "string" + }, + "score": { + "description": "Final score for the results of this policy.", + "format": "float", + "type": "number" + }, + "violationResult": { + "description": "Result of the classification for the policy.", + "enum": [ + "VIOLATION_RESULT_UNSPECIFIED", + "VIOLATIVE", + "NON_VIOLATIVE", + "CLASSIFICATION_ERROR" + ], + "enumDescriptions": [ + "Unspecified result.", + "The final score is greater or equal the input score threshold.", + "The final score is smaller than the input score threshold.", + "There was an error and the violation result could not be determined." + ], + "type": "string" + } + }, + "type": "object" + }, + "GoogleChecksAisafetyV1alphaTextInput": { + "description": "Text input to be classified.", + "id": "GoogleChecksAisafetyV1alphaTextInput", + "properties": { + "content": { + "description": "Actual piece of text to be classified.", + "type": "string" + }, + "languageCode": { + "description": "Optional. Language of the text in ISO 639-1 format. If the language is invalid or not specified, the system will try to detect it.", + "type": "string" + } + }, + "type": "object" + }, "GoogleChecksReportV1alphaAnalyzeUploadRequest": { "description": "The request message for ReportService.AnalyzeUpload.", "id": "GoogleChecksReportV1alphaAnalyzeUploadRequest", @@ -930,6 +1128,7 @@ "DATA_TYPE_FITNESS_INFO", "DATA_TYPE_EMAILS", "DATA_TYPE_TEXT_MESSAGES", + "DATA_TYPE_OTHER_IN_APP_MESSAGES", "DATA_TYPE_PHOTOS", "DATA_TYPE_VIDEOS", "DATA_TYPE_VOICE_OR_SOUND_RECORDINGS", @@ -970,6 +1169,7 @@ "Information about a user's fitness, such as exercise or other physical activity.", "A user's emails including the email subject line, sender, recipients, and the content of the email.", "A user's text messages including the sender, recipients, and the content of the message.", + "Any other types of messages. For example, instant messages or chat content.", "A user's photos.", "A user's videos.", "A user's voice such as a voicemail or a sound recording.", @@ -1304,6 +1504,7 @@ "DATA_TYPE_FITNESS_INFO", "DATA_TYPE_EMAILS", "DATA_TYPE_TEXT_MESSAGES", + "DATA_TYPE_OTHER_IN_APP_MESSAGES", "DATA_TYPE_PHOTOS", "DATA_TYPE_VIDEOS", "DATA_TYPE_VOICE_OR_SOUND_RECORDINGS", @@ -1344,6 +1545,7 @@ "Information about a user's fitness, such as exercise or other physical activity.", "A user's emails including the email subject line, sender, recipients, and the content of the email.", "A user's text messages including the sender, recipients, and the content of the message.", + "Any other types of messages. For example, instant messages or chat content.", "A user's photos.", "A user's videos.", "A user's voice such as a voicemail or a sound recording.", diff --git a/checks/v1alpha/checks-gen.go b/checks/v1alpha/checks-gen.go index abc6d8ead99..8926ca52ff6 100644 --- a/checks/v1alpha/checks-gen.go +++ b/checks/v1alpha/checks-gen.go @@ -124,6 +124,7 @@ func New(client *http.Client) (*Service, error) { } s := &Service{client: client, BasePath: basePath} s.Accounts = NewAccountsService(s) + s.Aisafety = NewAisafetyService(s) s.Media = NewMediaService(s) return s, nil } @@ -135,6 +136,8 @@ type Service struct { Accounts *AccountsService + Aisafety *AisafetyService + Media *MediaService } @@ -214,6 +217,15 @@ type AccountsReposOperationsService struct { s *Service } +func NewAisafetyService(s *Service) *AisafetyService { + rs := &AisafetyService{s: s} + return rs +} + +type AisafetyService struct { + s *Service +} + func NewMediaService(s *Service) *MediaService { rs := &MediaService{s: s} return rs @@ -292,6 +304,266 @@ func (s GoogleChecksAccountV1alphaListAppsResponse) MarshalJSON() ([]byte, error return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleChecksAisafetyV1alphaClassifyContentRequest: Request proto for +// ClassifyContent RPC. +type GoogleChecksAisafetyV1alphaClassifyContentRequest struct { + // ClassifierVersion: Optional. Version of the classifier to use. If not + // specified, the latest version will be used. + // + // Possible values: + // "CLASSIFIER_VERSION_UNSPECIFIED" - Unspecified version. + // "STABLE" - Stable version. + // "LATEST" - Latest version. + ClassifierVersion string `json:"classifierVersion,omitempty"` + // Context: Optional. Context about the input that will be used to help on the + // classification. + Context *GoogleChecksAisafetyV1alphaClassifyContentRequestContext `json:"context,omitempty"` + // Input: Required. Content to be classified. + Input *GoogleChecksAisafetyV1alphaClassifyContentRequestInputContent `json:"input,omitempty"` + // Policies: Required. List of policies to classify against. + Policies []*GoogleChecksAisafetyV1alphaClassifyContentRequestPolicyConfig `json:"policies,omitempty"` + // ForceSendFields is a list of field names (e.g. "ClassifierVersion") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ClassifierVersion") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleChecksAisafetyV1alphaClassifyContentRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleChecksAisafetyV1alphaClassifyContentRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleChecksAisafetyV1alphaClassifyContentRequestContext: Context about the +// input that will be used to help on the classification. +type GoogleChecksAisafetyV1alphaClassifyContentRequestContext struct { + // Prompt: Optional. Prompt that generated the model response. + Prompt string `json:"prompt,omitempty"` + // ForceSendFields is a list of field names (e.g. "Prompt") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Prompt") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleChecksAisafetyV1alphaClassifyContentRequestContext) MarshalJSON() ([]byte, error) { + type NoMethod GoogleChecksAisafetyV1alphaClassifyContentRequestContext + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleChecksAisafetyV1alphaClassifyContentRequestInputContent: Content to be +// classified. +type GoogleChecksAisafetyV1alphaClassifyContentRequestInputContent struct { + // TextInput: Content in text format. + TextInput *GoogleChecksAisafetyV1alphaTextInput `json:"textInput,omitempty"` + // ForceSendFields is a list of field names (e.g. "TextInput") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "TextInput") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleChecksAisafetyV1alphaClassifyContentRequestInputContent) MarshalJSON() ([]byte, error) { + type NoMethod GoogleChecksAisafetyV1alphaClassifyContentRequestInputContent + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleChecksAisafetyV1alphaClassifyContentRequestPolicyConfig: List of +// policies to classify against. +type GoogleChecksAisafetyV1alphaClassifyContentRequestPolicyConfig struct { + // PolicyType: Required. Type of the policy. + // + // Possible values: + // "POLICY_TYPE_UNSPECIFIED" - Default. + // "DANGEROUS_CONTENT" - The model facilitates, promotes or enables access to + // harmful goods, services, and activities. + // "PII_SOLICITING_RECITING" - The model reveals an individual’s personal + // information and data. + // "HARASSMENT" - The model generates content that is malicious, + // intimidating, bullying, or abusive towards another individual. + // "SEXUALLY_EXPLICIT" - The model generates content that is sexually + // explicit in nature. + // "HATE_SPEECH" - The model promotes violence, hatred, discrimination on the + // basis of race, religion, etc. + // "MEDICAL_INFO" - The model facilitates harm by providing health advice or + // guidance. + // "VIOLENCE_AND_GORE" - The model generates content that contains + // gratuitous, realistic descriptions of violence or gore. + // "OBSCENITY_AND_PROFANITY" + PolicyType string `json:"policyType,omitempty"` + // Threshold: Optional. Score threshold to use when deciding if the content is + // violative or non-violative. If not specified, the default 0.5 threshold for + // the policy will be used. + Threshold float64 `json:"threshold,omitempty"` + // ForceSendFields is a list of field names (e.g. "PolicyType") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "PolicyType") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleChecksAisafetyV1alphaClassifyContentRequestPolicyConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleChecksAisafetyV1alphaClassifyContentRequestPolicyConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleChecksAisafetyV1alphaClassifyContentRequestPolicyConfig) UnmarshalJSON(data []byte) error { + type NoMethod GoogleChecksAisafetyV1alphaClassifyContentRequestPolicyConfig + var s1 struct { + Threshold gensupport.JSONFloat64 `json:"threshold"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Threshold = float64(s1.Threshold) + return nil +} + +// GoogleChecksAisafetyV1alphaClassifyContentResponse: Response proto for +// ClassifyContent RPC. +type GoogleChecksAisafetyV1alphaClassifyContentResponse struct { + // PolicyResults: Results of the classification for each policy. + PolicyResults []*GoogleChecksAisafetyV1alphaClassifyContentResponsePolicyResult `json:"policyResults,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "PolicyResults") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "PolicyResults") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleChecksAisafetyV1alphaClassifyContentResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleChecksAisafetyV1alphaClassifyContentResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleChecksAisafetyV1alphaClassifyContentResponsePolicyResult: Result for +// one policy against the corresponding input. +type GoogleChecksAisafetyV1alphaClassifyContentResponsePolicyResult struct { + // PolicyType: Type of the policy. + // + // Possible values: + // "POLICY_TYPE_UNSPECIFIED" - Default. + // "DANGEROUS_CONTENT" - The model facilitates, promotes or enables access to + // harmful goods, services, and activities. + // "PII_SOLICITING_RECITING" - The model reveals an individual’s personal + // information and data. + // "HARASSMENT" - The model generates content that is malicious, + // intimidating, bullying, or abusive towards another individual. + // "SEXUALLY_EXPLICIT" - The model generates content that is sexually + // explicit in nature. + // "HATE_SPEECH" - The model promotes violence, hatred, discrimination on the + // basis of race, religion, etc. + // "MEDICAL_INFO" - The model facilitates harm by providing health advice or + // guidance. + // "VIOLENCE_AND_GORE" - The model generates content that contains + // gratuitous, realistic descriptions of violence or gore. + // "OBSCENITY_AND_PROFANITY" + PolicyType string `json:"policyType,omitempty"` + // Score: Final score for the results of this policy. + Score float64 `json:"score,omitempty"` + // ViolationResult: Result of the classification for the policy. + // + // Possible values: + // "VIOLATION_RESULT_UNSPECIFIED" - Unspecified result. + // "VIOLATIVE" - The final score is greater or equal the input score + // threshold. + // "NON_VIOLATIVE" - The final score is smaller than the input score + // threshold. + // "CLASSIFICATION_ERROR" - There was an error and the violation result could + // not be determined. + ViolationResult string `json:"violationResult,omitempty"` + // ForceSendFields is a list of field names (e.g. "PolicyType") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "PolicyType") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleChecksAisafetyV1alphaClassifyContentResponsePolicyResult) MarshalJSON() ([]byte, error) { + type NoMethod GoogleChecksAisafetyV1alphaClassifyContentResponsePolicyResult + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleChecksAisafetyV1alphaClassifyContentResponsePolicyResult) UnmarshalJSON(data []byte) error { + type NoMethod GoogleChecksAisafetyV1alphaClassifyContentResponsePolicyResult + 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 +} + +// GoogleChecksAisafetyV1alphaTextInput: Text input to be classified. +type GoogleChecksAisafetyV1alphaTextInput struct { + // Content: Actual piece of text to be classified. + Content string `json:"content,omitempty"` + // LanguageCode: Optional. Language of the text in ISO 639-1 format. If the + // language is invalid or not specified, the system will try to detect it. + LanguageCode string `json:"languageCode,omitempty"` + // ForceSendFields is a list of field names (e.g. "Content") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Content") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleChecksAisafetyV1alphaTextInput) MarshalJSON() ([]byte, error) { + type NoMethod GoogleChecksAisafetyV1alphaTextInput + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleChecksReportV1alphaAnalyzeUploadRequest: The request message for // ReportService.AnalyzeUpload. type GoogleChecksReportV1alphaAnalyzeUploadRequest struct { @@ -797,6 +1069,8 @@ type GoogleChecksReportV1alphaCheckDataTypeEvidence struct { // sender, recipients, and the content of the email. // "DATA_TYPE_TEXT_MESSAGES" - A user's text messages including the sender, // recipients, and the content of the message. + // "DATA_TYPE_OTHER_IN_APP_MESSAGES" - Any other types of messages. For + // example, instant messages or chat content. // "DATA_TYPE_PHOTOS" - A user's photos. // "DATA_TYPE_VIDEOS" - A user's videos. // "DATA_TYPE_VOICE_OR_SOUND_RECORDINGS" - A user's voice such as a voicemail @@ -1263,6 +1537,8 @@ type GoogleChecksReportV1alphaDataMonitoringDataTypeResult struct { // sender, recipients, and the content of the email. // "DATA_TYPE_TEXT_MESSAGES" - A user's text messages including the sender, // recipients, and the content of the message. + // "DATA_TYPE_OTHER_IN_APP_MESSAGES" - Any other types of messages. For + // example, instant messages or chat content. // "DATA_TYPE_PHOTOS" - A user's photos. // "DATA_TYPE_VIDEOS" - A user's videos. // "DATA_TYPE_VOICE_OR_SOUND_RECORDINGS" - A user's voice such as a voicemail @@ -3130,6 +3406,102 @@ func (c *AccountsReposOperationsGetCall) Do(opts ...googleapi.CallOption) (*Oper return ret, nil } +type AisafetyClassifyContentCall struct { + s *Service + googlechecksaisafetyv1alphaclassifycontentrequest *GoogleChecksAisafetyV1alphaClassifyContentRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// ClassifyContent: Analyze a piece of content with the provided set of +// policies. +func (r *AisafetyService) ClassifyContent(googlechecksaisafetyv1alphaclassifycontentrequest *GoogleChecksAisafetyV1alphaClassifyContentRequest) *AisafetyClassifyContentCall { + c := &AisafetyClassifyContentCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.googlechecksaisafetyv1alphaclassifycontentrequest = googlechecksaisafetyv1alphaclassifycontentrequest + 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 *AisafetyClassifyContentCall) Fields(s ...googleapi.Field) *AisafetyClassifyContentCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *AisafetyClassifyContentCall) Context(ctx context.Context) *AisafetyClassifyContentCall { + 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 *AisafetyClassifyContentCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AisafetyClassifyContentCall) 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.googlechecksaisafetyv1alphaclassifycontentrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/aisafety:classifyContent") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "checks.aisafety.classifyContent" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleChecksAisafetyV1alphaClassifyContentResponse.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 *AisafetyClassifyContentCall) Do(opts ...googleapi.CallOption) (*GoogleChecksAisafetyV1alphaClassifyContentResponse, 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 := &GoogleChecksAisafetyV1alphaClassifyContentResponse{ + 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 MediaUploadCall struct { s *Service parent string diff --git a/chromemanagement/v1/chromemanagement-api.json b/chromemanagement/v1/chromemanagement-api.json index aadd4724366..f14b432f781 100644 --- a/chromemanagement/v1/chromemanagement-api.json +++ b/chromemanagement/v1/chromemanagement-api.json @@ -591,12 +591,12 @@ "type": "string" }, "filter": { - "description": "Query string to filter results, AND-separated fields in EBNF syntax. Note: OR operations are not supported in this filter. Supported filter fields: * app_name * app_type * install_type * number_of_permissions * total_install_count * latest_profile_active_date * permission_name * app_id * manifest_versions", + "description": "Query string to filter results, AND-separated fields in EBNF syntax. Note: OR operations are not supported in this filter. Supported filter fields: * app_name * app_type * install_type * number_of_permissions * total_install_count * latest_profile_active_date * permission_name * app_id * manifest_versions * risk_score", "location": "query", "type": "string" }, "orderBy": { - "description": "Field used to order results. Supported order by fields: * app_name * app_type * install_type * number_of_permissions * total_install_count * app_id * manifest_versions", + "description": "Field used to order results. Supported order by fields: * app_name * app_type * install_type * number_of_permissions * total_install_count * app_id * manifest_versions * risk_score", "location": "query", "type": "string" }, @@ -1172,7 +1172,7 @@ } } }, - "revision": "20241003", + "revision": "20241023", "rootUrl": "https://chromemanagement.googleapis.com/", "schemas": { "GoogleChromeManagementV1AndroidAppInfo": { @@ -2849,6 +2849,11 @@ }, "readOnly": true, "type": "array" + }, + "riskAssessment": { + "$ref": "GoogleChromeManagementV1RiskAssessmentData", + "description": "Output only. If available, the risk assessment data about this extension.", + "readOnly": true } }, "type": "object" @@ -3419,6 +3424,96 @@ }, "type": "object" }, + "GoogleChromeManagementV1RiskAssessment": { + "description": "Risk assessment for a Chrome extension.", + "id": "GoogleChromeManagementV1RiskAssessment", + "properties": { + "assessment": { + "description": "Risk assessment for the extension. Currently, this is a numerical value, and its interpretation is specific to each risk assessment provider.", + "type": "string" + }, + "detailsUrl": { + "description": "A URL that a user can navigate to for more information about the risk assessment.", + "type": "string" + }, + "version": { + "description": "The version of the extension that this assessment applies to.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleChromeManagementV1RiskAssessmentData": { + "description": "Risk assessment data about an extension/app.", + "id": "GoogleChromeManagementV1RiskAssessmentData", + "properties": { + "entries": { + "description": "Individual risk assessments.", + "items": { + "$ref": "GoogleChromeManagementV1RiskAssessmentEntry" + }, + "type": "array" + }, + "overallRiskLevel": { + "description": "Overall assessed risk level across all entries. This will be the highest risk level from all entries.", + "enum": [ + "RISK_LEVEL_UNSPECIFIED", + "RISK_LEVEL_LOW", + "RISK_LEVEL_MEDIUM", + "RISK_LEVEL_HIGH" + ], + "enumDescriptions": [ + "Risk level not specified.", + "Extension that represents a low risk.", + "Extension that represents a medium risk.", + "Extension that represents a high risk." + ], + "type": "string" + } + }, + "type": "object" + }, + "GoogleChromeManagementV1RiskAssessmentEntry": { + "description": "One risk assessment entry.", + "id": "GoogleChromeManagementV1RiskAssessmentEntry", + "properties": { + "provider": { + "description": "The risk assessment provider from which this entry comes from.", + "enum": [ + "RISK_ASSESSMENT_PROVIDER_UNSPECIFIED", + "RISK_ASSESSMENT_PROVIDER_CRXCAVATOR", + "RISK_ASSESSMENT_PROVIDER_SPIN_AI" + ], + "enumDescriptions": [ + "Default value when no provider is specified.", + "CRXcavator.", + "Spin.Ai." + ], + "type": "string" + }, + "riskAssessment": { + "$ref": "GoogleChromeManagementV1RiskAssessment", + "description": "The details of the provider's risk assessment." + }, + "riskLevel": { + "description": "The bucketed risk level for the risk assessment.", + "enum": [ + "RISK_LEVEL_UNSPECIFIED", + "RISK_LEVEL_LOW", + "RISK_LEVEL_MEDIUM", + "RISK_LEVEL_HIGH" + ], + "enumDescriptions": [ + "Risk level not specified.", + "Extension that represents a low risk.", + "Extension that represents a medium risk.", + "Extension that represents a high risk." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleChromeManagementV1RuntimeCountersReport": { "description": "Runtime counters retrieved from CPU. Currently the runtime counters telemetry is only supported by Intel vPro PSR on Gen 14+.", "id": "GoogleChromeManagementV1RuntimeCountersReport", diff --git a/chromemanagement/v1/chromemanagement-gen.go b/chromemanagement/v1/chromemanagement-gen.go index d10adf7ff5d..651a881e535 100644 --- a/chromemanagement/v1/chromemanagement-gen.go +++ b/chromemanagement/v1/chromemanagement-gen.go @@ -2038,6 +2038,9 @@ type GoogleChromeManagementV1InstalledApp struct { OsUserCount int64 `json:"osUserCount,omitempty,string"` // Permissions: Output only. Permissions of the installed app. Permissions []string `json:"permissions,omitempty"` + // RiskAssessment: Output only. If available, the risk assessment data about + // this extension. + RiskAssessment *GoogleChromeManagementV1RiskAssessmentData `json:"riskAssessment,omitempty"` // ForceSendFields is a list of field names (e.g. "AppId") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See @@ -2675,6 +2678,106 @@ func (s GoogleChromeManagementV1PrinterReport) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleChromeManagementV1RiskAssessment: Risk assessment for a Chrome +// extension. +type GoogleChromeManagementV1RiskAssessment struct { + // Assessment: Risk assessment for the extension. Currently, this is a + // numerical value, and its interpretation is specific to each risk assessment + // provider. + Assessment string `json:"assessment,omitempty"` + // DetailsUrl: A URL that a user can navigate to for more information about the + // risk assessment. + DetailsUrl string `json:"detailsUrl,omitempty"` + // Version: The version of the extension that this assessment applies to. + Version string `json:"version,omitempty"` + // ForceSendFields is a list of field names (e.g. "Assessment") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Assessment") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleChromeManagementV1RiskAssessment) MarshalJSON() ([]byte, error) { + type NoMethod GoogleChromeManagementV1RiskAssessment + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleChromeManagementV1RiskAssessmentData: Risk assessment data about an +// extension/app. +type GoogleChromeManagementV1RiskAssessmentData struct { + // Entries: Individual risk assessments. + Entries []*GoogleChromeManagementV1RiskAssessmentEntry `json:"entries,omitempty"` + // OverallRiskLevel: Overall assessed risk level across all entries. This will + // be the highest risk level from all entries. + // + // Possible values: + // "RISK_LEVEL_UNSPECIFIED" - Risk level not specified. + // "RISK_LEVEL_LOW" - Extension that represents a low risk. + // "RISK_LEVEL_MEDIUM" - Extension that represents a medium risk. + // "RISK_LEVEL_HIGH" - Extension that represents a high risk. + OverallRiskLevel string `json:"overallRiskLevel,omitempty"` + // ForceSendFields is a list of field names (e.g. "Entries") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Entries") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleChromeManagementV1RiskAssessmentData) MarshalJSON() ([]byte, error) { + type NoMethod GoogleChromeManagementV1RiskAssessmentData + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleChromeManagementV1RiskAssessmentEntry: One risk assessment entry. +type GoogleChromeManagementV1RiskAssessmentEntry struct { + // Provider: The risk assessment provider from which this entry comes from. + // + // Possible values: + // "RISK_ASSESSMENT_PROVIDER_UNSPECIFIED" - Default value when no provider is + // specified. + // "RISK_ASSESSMENT_PROVIDER_CRXCAVATOR" - CRXcavator. + // "RISK_ASSESSMENT_PROVIDER_SPIN_AI" - Spin.Ai. + Provider string `json:"provider,omitempty"` + // RiskAssessment: The details of the provider's risk assessment. + RiskAssessment *GoogleChromeManagementV1RiskAssessment `json:"riskAssessment,omitempty"` + // RiskLevel: The bucketed risk level for the risk assessment. + // + // Possible values: + // "RISK_LEVEL_UNSPECIFIED" - Risk level not specified. + // "RISK_LEVEL_LOW" - Extension that represents a low risk. + // "RISK_LEVEL_MEDIUM" - Extension that represents a medium risk. + // "RISK_LEVEL_HIGH" - Extension that represents a high risk. + RiskLevel string `json:"riskLevel,omitempty"` + // ForceSendFields is a list of field names (e.g. "Provider") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Provider") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleChromeManagementV1RiskAssessmentEntry) MarshalJSON() ([]byte, error) { + type NoMethod GoogleChromeManagementV1RiskAssessmentEntry + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleChromeManagementV1RuntimeCountersReport: Runtime counters retrieved // from CPU. Currently the runtime counters telemetry is only supported by // Intel vPro PSR on Gen 14+. @@ -5615,7 +5718,8 @@ func (r *CustomersReportsService) CountInstalledApps(customer string) *Customers // AND-separated fields in EBNF syntax. Note: OR operations are not supported // in this filter. Supported filter fields: * app_name * app_type * // install_type * number_of_permissions * total_install_count * -// latest_profile_active_date * permission_name * app_id * manifest_versions +// latest_profile_active_date * permission_name * app_id * manifest_versions * +// risk_score func (c *CustomersReportsCountInstalledAppsCall) Filter(filter string) *CustomersReportsCountInstalledAppsCall { c.urlParams_.Set("filter", filter) return c @@ -5623,7 +5727,8 @@ func (c *CustomersReportsCountInstalledAppsCall) Filter(filter string) *Customer // OrderBy sets the optional parameter "orderBy": Field used to order results. // Supported order by fields: * app_name * app_type * install_type * -// number_of_permissions * total_install_count * app_id * manifest_versions +// number_of_permissions * total_install_count * app_id * manifest_versions * +// risk_score func (c *CustomersReportsCountInstalledAppsCall) OrderBy(orderBy string) *CustomersReportsCountInstalledAppsCall { c.urlParams_.Set("orderBy", orderBy) return c diff --git a/cloudbuild/v1/cloudbuild-api.json b/cloudbuild/v1/cloudbuild-api.json index 46b1e8beb5c..49b196172b8 100644 --- a/cloudbuild/v1/cloudbuild-api.json +++ b/cloudbuild/v1/cloudbuild-api.json @@ -2346,7 +2346,7 @@ } } }, - "revision": "20240923", + "revision": "20241025", "rootUrl": "https://cloudbuild.googleapis.com/", "schemas": { "ApprovalConfig": { @@ -4631,6 +4631,10 @@ "$ref": "NetworkConfig", "description": "Network configuration for the pool." }, + "privateServiceConnect": { + "$ref": "PrivateServiceConnect", + "description": "Immutable. Private Service Connect(PSC) Network configuration for the pool." + }, "workerConfig": { "$ref": "WorkerConfig", "description": "Machine configuration for the workers in the pool." @@ -4638,6 +4642,25 @@ }, "type": "object" }, + "PrivateServiceConnect": { + "description": "Defines the Private Service Connect network configuration for the pool.", + "id": "PrivateServiceConnect", + "properties": { + "networkAttachment": { + "description": "Required. Immutable. The network attachment that the worker network interface is peered to. Must be in the format `projects/{project}/regions/{region}/networkAttachments/{networkAttachment}`. The region of network attachment must be the same as the worker pool. See [Network Attachments](https://cloud.google.com/vpc/docs/about-network-attachments)", + "type": "string" + }, + "publicIpAddressDisabled": { + "description": "Required. Immutable. Disable public IP on the primary network interface. If true, workers are created without any public address, which prevents network egress to public IPs unless a network proxy is configured. If false, workers are created with a public address which allows for public internet egress. The public address only applies to traffic through the primary network interface. If `route_all_traffic` is set to true, all traffic will go through the non-primary network interface, this boolean has no effect.", + "type": "boolean" + }, + "routeAllTraffic": { + "description": "Immutable. Route all traffic through PSC interface. Enable this if you want full control of traffic in the private pool. Configure Cloud NAT for the subnet of network attachment if you need to access public Internet. If false, Only route private IPs, e.g. 10.0.0.0/8, 172.16.0.0/12, and 192.168.0.0/16 through PSC interface.", + "type": "boolean" + } + }, + "type": "object" + }, "ProcessAppManifestCallbackOperationMetadata": { "description": "Metadata for `ProcessAppManifestCallback` operation.", "id": "ProcessAppManifestCallbackOperationMetadata", diff --git a/cloudbuild/v1/cloudbuild-gen.go b/cloudbuild/v1/cloudbuild-gen.go index 845c0e05df2..0caceaf83d5 100644 --- a/cloudbuild/v1/cloudbuild-gen.go +++ b/cloudbuild/v1/cloudbuild-gen.go @@ -3174,6 +3174,9 @@ func (s PoolOption) MarshalJSON() ([]byte, error) { type PrivatePoolV1Config struct { // NetworkConfig: Network configuration for the pool. NetworkConfig *NetworkConfig `json:"networkConfig,omitempty"` + // PrivateServiceConnect: Immutable. Private Service Connect(PSC) Network + // configuration for the pool. + PrivateServiceConnect *PrivateServiceConnect `json:"privateServiceConnect,omitempty"` // WorkerConfig: Machine configuration for the workers in the pool. WorkerConfig *WorkerConfig `json:"workerConfig,omitempty"` // ForceSendFields is a list of field names (e.g. "NetworkConfig") to @@ -3194,6 +3197,49 @@ func (s PrivatePoolV1Config) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// PrivateServiceConnect: Defines the Private Service Connect network +// configuration for the pool. +type PrivateServiceConnect struct { + // NetworkAttachment: Required. Immutable. The network attachment that the + // worker network interface is peered to. Must be in the format + // `projects/{project}/regions/{region}/networkAttachments/{networkAttachment}`. + // The region of network attachment must be the same as the worker pool. See + // Network Attachments + // (https://cloud.google.com/vpc/docs/about-network-attachments) + NetworkAttachment string `json:"networkAttachment,omitempty"` + // PublicIpAddressDisabled: Required. Immutable. Disable public IP on the + // primary network interface. If true, workers are created without any public + // address, which prevents network egress to public IPs unless a network proxy + // is configured. If false, workers are created with a public address which + // allows for public internet egress. The public address only applies to + // traffic through the primary network interface. If `route_all_traffic` is set + // to true, all traffic will go through the non-primary network interface, this + // boolean has no effect. + PublicIpAddressDisabled bool `json:"publicIpAddressDisabled,omitempty"` + // RouteAllTraffic: Immutable. Route all traffic through PSC interface. Enable + // this if you want full control of traffic in the private pool. Configure + // Cloud NAT for the subnet of network attachment if you need to access public + // Internet. If false, Only route private IPs, e.g. 10.0.0.0/8, 172.16.0.0/12, + // and 192.168.0.0/16 through PSC interface. + RouteAllTraffic bool `json:"routeAllTraffic,omitempty"` + // ForceSendFields is a list of field names (e.g. "NetworkAttachment") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "NetworkAttachment") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s PrivateServiceConnect) MarshalJSON() ([]byte, error) { + type NoMethod PrivateServiceConnect + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ProcessAppManifestCallbackOperationMetadata: Metadata for // `ProcessAppManifestCallback` operation. type ProcessAppManifestCallbackOperationMetadata struct { diff --git a/cloudchannel/v1/cloudchannel-api.json b/cloudchannel/v1/cloudchannel-api.json index a33f1e7156d..6ca03c1f02f 100644 --- a/cloudchannel/v1/cloudchannel-api.json +++ b/cloudchannel/v1/cloudchannel-api.json @@ -139,7 +139,7 @@ ] }, "listSubscribers": { - "description": "Lists service accounts with subscriber privileges on the Cloud Pub/Sub topic created for this Channel Services account. Possible error codes: * PERMISSION_DENIED: The reseller account making the request and the provided reseller account are different, or the impersonated user is not a super admin. * INVALID_ARGUMENT: Required request parameters are missing or invalid. * NOT_FOUND: The topic resource doesn't exist. * INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. * UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. Return value: A list of service email addresses.", + "description": "Lists service accounts with subscriber privileges on the Pub/Sub topic created for this Channel Services account or integrator. Possible error codes: * PERMISSION_DENIED: The reseller account making the request and the provided reseller account are different, or the impersonated user is not a super admin. * INVALID_ARGUMENT: Required request parameters are missing or invalid. * NOT_FOUND: The topic resource doesn't exist. * INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. * UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. Return value: A list of service email addresses.", "flatPath": "v1/accounts/{accountsId}:listSubscribers", "httpMethod": "GET", "id": "cloudchannel.accounts.listSubscribers", @@ -148,12 +148,17 @@ ], "parameters": { "account": { - "description": "Optional. Resource name of the account.", + "description": "Optional. Resource name of the account. Required if integrator is not provided. Otherwise, leave this field empty/unset.", "location": "path", "pattern": "^accounts/[^/]+$", "required": true, "type": "string" }, + "integrator": { + "description": "Optional. Resource name of the integrator. Required if account is not provided. Otherwise, leave this field empty/unset.", + "location": "query", + "type": "string" + }, "pageSize": { "description": "Optional. The maximum number of service accounts to return. The service may return fewer than this value. If unspecified, returns at most 100 service accounts. The maximum value is 1000; the server will coerce values above 1000.", "format": "int32", @@ -231,7 +236,7 @@ ] }, "register": { - "description": "Registers a service account with subscriber privileges on the Cloud Pub/Sub topic for this Channel Services account. After you create a subscriber, you get the events through SubscriberEvent Possible error codes: * PERMISSION_DENIED: The reseller account making the request and the provided reseller account are different, or the impersonated user is not a super admin. * INVALID_ARGUMENT: Required request parameters are missing or invalid. * INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. * UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. Return value: The topic name with the registered service email address.", + "description": "Registers a service account with subscriber privileges on the Pub/Sub topic for this Channel Services account or integrator. After you create a subscriber, you get the events through SubscriberEvent Possible error codes: * PERMISSION_DENIED: The reseller account making the request and the provided reseller account are different, or the impersonated user is not a super admin. * INVALID_ARGUMENT: Required request parameters are missing or invalid. * INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. * UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. Return value: The topic name with the registered service email address.", "flatPath": "v1/accounts/{accountsId}:register", "httpMethod": "POST", "id": "cloudchannel.accounts.register", @@ -240,7 +245,7 @@ ], "parameters": { "account": { - "description": "Optional. Resource name of the account.", + "description": "Optional. Resource name of the account. Required if integrator is not provided. Otherwise, leave this field empty/unset.", "location": "path", "pattern": "^accounts/[^/]+$", "required": true, @@ -259,7 +264,7 @@ ] }, "unregister": { - "description": "Unregisters a service account with subscriber privileges on the Cloud Pub/Sub topic created for this Channel Services account. If there are no service accounts left with subscriber privileges, this deletes the topic. You can call ListSubscribers to check for these accounts. Possible error codes: * PERMISSION_DENIED: The reseller account making the request and the provided reseller account are different, or the impersonated user is not a super admin. * INVALID_ARGUMENT: Required request parameters are missing or invalid. * NOT_FOUND: The topic resource doesn't exist. * INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. * UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. Return value: The topic name that unregistered the service email address. Returns a success response if the service email address wasn't registered with the topic.", + "description": "Unregisters a service account with subscriber privileges on the Pub/Sub topic created for this Channel Services account or integrator. If there are no service accounts left with subscriber privileges, this deletes the topic. You can call ListSubscribers to check for these accounts. Possible error codes: * PERMISSION_DENIED: The reseller account making the request and the provided reseller account are different, or the impersonated user is not a super admin. * INVALID_ARGUMENT: Required request parameters are missing or invalid. * NOT_FOUND: The topic resource doesn't exist. * INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. * UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. Return value: The topic name that unregistered the service email address. Returns a success response if the service email address wasn't registered with the topic.", "flatPath": "v1/accounts/{accountsId}:unregister", "httpMethod": "POST", "id": "cloudchannel.accounts.unregister", @@ -268,7 +273,7 @@ ], "parameters": { "account": { - "description": "Optional. Resource name of the account.", + "description": "Optional. Resource name of the account. Required if integrator is not provided. Otherwise, leave this field empty/unset.", "location": "path", "pattern": "^accounts/[^/]+$", "required": true, @@ -1900,7 +1905,7 @@ "type": "integer" }, "pageToken": { - "description": "Optional. A token identifying a page of results beyond the first page. Obtained through ListSkuGroups.next_page_token of the previous CloudChannelService.ListSkuGroups call.", + "description": "Optional. A token identifying a page of results beyond the first page. Obtained through ListSkuGroupsResponse.next_page_token of the previous CloudChannelService.ListSkuGroups call.", "location": "query", "type": "string" }, @@ -1940,7 +1945,7 @@ "type": "integer" }, "pageToken": { - "description": "Optional. A token identifying a page of results beyond the first page. Obtained through ListSkuGroupBillableSkus.next_page_token of the previous CloudChannelService.ListSkuGroupBillableSkus call.", + "description": "Optional. A token identifying a page of results beyond the first page. Obtained through ListSkuGroupBillableSkusResponse.next_page_token of the previous CloudChannelService.ListSkuGroupBillableSkus call.", "location": "query", "type": "string" }, @@ -1966,6 +1971,107 @@ } } }, + "integrators": { + "methods": { + "listSubscribers": { + "description": "Lists service accounts with subscriber privileges on the Pub/Sub topic created for this Channel Services account or integrator. Possible error codes: * PERMISSION_DENIED: The reseller account making the request and the provided reseller account are different, or the impersonated user is not a super admin. * INVALID_ARGUMENT: Required request parameters are missing or invalid. * NOT_FOUND: The topic resource doesn't exist. * INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. * UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. Return value: A list of service email addresses.", + "flatPath": "v1/integrators/{integratorsId}:listSubscribers", + "httpMethod": "GET", + "id": "cloudchannel.integrators.listSubscribers", + "parameterOrder": [ + "integrator" + ], + "parameters": { + "account": { + "description": "Optional. Resource name of the account. Required if integrator is not provided. Otherwise, leave this field empty/unset.", + "location": "query", + "type": "string" + }, + "integrator": { + "description": "Optional. Resource name of the integrator. Required if account is not provided. Otherwise, leave this field empty/unset.", + "location": "path", + "pattern": "^integrators/[^/]+$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "Optional. The maximum number of service accounts to return. The service may return fewer than this value. If unspecified, returns at most 100 service accounts. The maximum value is 1000; the server will coerce values above 1000.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. A page token, received from a previous `ListSubscribers` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListSubscribers` must match the call that provided the page token.", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+integrator}:listSubscribers", + "response": { + "$ref": "GoogleCloudChannelV1ListSubscribersResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/apps.order" + ] + }, + "registerSubscriber": { + "description": "Registers a service account with subscriber privileges on the Pub/Sub topic for this Channel Services account or integrator. After you create a subscriber, you get the events through SubscriberEvent Possible error codes: * PERMISSION_DENIED: The reseller account making the request and the provided reseller account are different, or the impersonated user is not a super admin. * INVALID_ARGUMENT: Required request parameters are missing or invalid. * INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. * UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. Return value: The topic name with the registered service email address.", + "flatPath": "v1/integrators/{integratorsId}:registerSubscriber", + "httpMethod": "POST", + "id": "cloudchannel.integrators.registerSubscriber", + "parameterOrder": [ + "integrator" + ], + "parameters": { + "integrator": { + "description": "Optional. Resource name of the integrator. Required if account is not provided. Otherwise, leave this field empty/unset.", + "location": "path", + "pattern": "^integrators/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+integrator}:registerSubscriber", + "request": { + "$ref": "GoogleCloudChannelV1RegisterSubscriberRequest" + }, + "response": { + "$ref": "GoogleCloudChannelV1RegisterSubscriberResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/apps.order" + ] + }, + "unregisterSubscriber": { + "description": "Unregisters a service account with subscriber privileges on the Pub/Sub topic created for this Channel Services account or integrator. If there are no service accounts left with subscriber privileges, this deletes the topic. You can call ListSubscribers to check for these accounts. Possible error codes: * PERMISSION_DENIED: The reseller account making the request and the provided reseller account are different, or the impersonated user is not a super admin. * INVALID_ARGUMENT: Required request parameters are missing or invalid. * NOT_FOUND: The topic resource doesn't exist. * INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. * UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. Return value: The topic name that unregistered the service email address. Returns a success response if the service email address wasn't registered with the topic.", + "flatPath": "v1/integrators/{integratorsId}:unregisterSubscriber", + "httpMethod": "POST", + "id": "cloudchannel.integrators.unregisterSubscriber", + "parameterOrder": [ + "integrator" + ], + "parameters": { + "integrator": { + "description": "Optional. Resource name of the integrator. Required if account is not provided. Otherwise, leave this field empty/unset.", + "location": "path", + "pattern": "^integrators/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+integrator}:unregisterSubscriber", + "request": { + "$ref": "GoogleCloudChannelV1UnregisterSubscriberRequest" + }, + "response": { + "$ref": "GoogleCloudChannelV1UnregisterSubscriberResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/apps.order" + ] + } + } + }, "operations": { "methods": { "cancel": { @@ -2183,7 +2289,7 @@ } } }, - "revision": "20241020", + "revision": "20241024", "rootUrl": "https://cloudchannel.googleapis.com/", "schemas": { "GoogleCloudChannelV1ActivateEntitlementRequest": { @@ -2335,7 +2441,7 @@ "type": "object" }, "GoogleCloudChannelV1ChangeParametersRequest": { - "description": "Request message for CloudChannelService.ChangeParametersRequest.", + "description": "Request message for CloudChannelService.ChangeParameters.", "id": "GoogleCloudChannelV1ChangeParametersRequest", "properties": { "parameters": { @@ -3547,7 +3653,7 @@ "type": "array" }, "nextPageToken": { - "description": "A token to retrieve the next page of results. Pass to ListSkuGroupBillableSkus.page_token to obtain that page.", + "description": "A token to retrieve the next page of results. Pass to ListSkuGroupBillableSkusRequest.page_token to obtain that page.", "type": "string" } }, @@ -3558,7 +3664,7 @@ "id": "GoogleCloudChannelV1ListSkuGroupsResponse", "properties": { "nextPageToken": { - "description": "A token to retrieve the next page of results. Pass to ListSkuGroups.page_token to obtain that page.", + "description": "A token to retrieve the next page of results. Pass to ListSkuGroupsRequest.page_token to obtain that page.", "type": "string" }, "skuGroups": { @@ -4243,6 +4349,14 @@ "description": "Request Message for RegisterSubscriber.", "id": "GoogleCloudChannelV1RegisterSubscriberRequest", "properties": { + "account": { + "description": "Optional. Resource name of the account. Required if integrator is not provided. Otherwise, leave this field empty/unset.", + "type": "string" + }, + "integrator": { + "description": "Optional. Resource name of the integrator. Required if account is not provided. Otherwise, leave this field empty/unset.", + "type": "string" + }, "serviceAccount": { "description": "Required. Service account that provides subscriber access to the registered topic.", "type": "string" @@ -4817,6 +4931,14 @@ "description": "Request Message for UnregisterSubscriber.", "id": "GoogleCloudChannelV1UnregisterSubscriberRequest", "properties": { + "account": { + "description": "Optional. Resource name of the account. Required if integrator is not provided. Otherwise, leave this field empty/unset.", + "type": "string" + }, + "integrator": { + "description": "Optional. Resource name of the integrator. Required if account is not provided. Otherwise, leave this field empty/unset.", + "type": "string" + }, "serviceAccount": { "description": "Required. Service account to unregister from subscriber access to the topic.", "type": "string" diff --git a/cloudchannel/v1/cloudchannel-gen.go b/cloudchannel/v1/cloudchannel-gen.go index d75c65b609a..c3f65697780 100644 --- a/cloudchannel/v1/cloudchannel-gen.go +++ b/cloudchannel/v1/cloudchannel-gen.go @@ -144,6 +144,7 @@ func New(client *http.Client) (*Service, error) { } s := &Service{client: client, BasePath: basePath} s.Accounts = NewAccountsService(s) + s.Integrators = NewIntegratorsService(s) s.Operations = NewOperationsService(s) s.Products = NewProductsService(s) return s, nil @@ -156,6 +157,8 @@ type Service struct { Accounts *AccountsService + Integrators *IntegratorsService + Operations *OperationsService Products *ProductsService @@ -309,6 +312,15 @@ type AccountsSkuGroupsBillableSkusService struct { s *Service } +func NewIntegratorsService(s *Service) *IntegratorsService { + rs := &IntegratorsService{s: s} + return rs +} + +type IntegratorsService struct { + s *Service +} + func NewOperationsService(s *Service) *OperationsService { rs := &OperationsService{s: s} return rs @@ -578,7 +590,7 @@ func (s GoogleCloudChannelV1ChangeOfferRequest) MarshalJSON() ([]byte, error) { } // GoogleCloudChannelV1ChangeParametersRequest: Request message for -// CloudChannelService.ChangeParametersRequest. +// CloudChannelService.ChangeParameters. type GoogleCloudChannelV1ChangeParametersRequest struct { // Parameters: Required. Entitlement parameters to update. You can only change // editable parameters. To view the available Parameters for a request, refer @@ -2011,7 +2023,7 @@ type GoogleCloudChannelV1ListSkuGroupBillableSkusResponse struct { // BillableSkus: The list of billable SKUs in the requested SKU group. BillableSkus []*GoogleCloudChannelV1BillableSku `json:"billableSkus,omitempty"` // NextPageToken: A token to retrieve the next page of results. Pass to - // ListSkuGroupBillableSkus.page_token to obtain that page. + // ListSkuGroupBillableSkusRequest.page_token to obtain that page. NextPageToken string `json:"nextPageToken,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -2038,7 +2050,7 @@ func (s GoogleCloudChannelV1ListSkuGroupBillableSkusResponse) MarshalJSON() ([]b // ListSkuGroups. type GoogleCloudChannelV1ListSkuGroupsResponse struct { // NextPageToken: A token to retrieve the next page of results. Pass to - // ListSkuGroups.page_token to obtain that page. + // ListSkuGroupsRequest.page_token to obtain that page. NextPageToken string `json:"nextPageToken,omitempty"` // SkuGroups: The list of SKU groups requested. SkuGroups []*GoogleCloudChannelV1SkuGroup `json:"skuGroups,omitempty"` @@ -2914,18 +2926,24 @@ func (s GoogleCloudChannelV1QueryEligibleBillingAccountsResponse) MarshalJSON() // GoogleCloudChannelV1RegisterSubscriberRequest: Request Message for // RegisterSubscriber. type GoogleCloudChannelV1RegisterSubscriberRequest struct { + // Account: Optional. Resource name of the account. Required if integrator is + // not provided. Otherwise, leave this field empty/unset. + Account string `json:"account,omitempty"` + // Integrator: Optional. Resource name of the integrator. Required if account + // is not provided. Otherwise, leave this field empty/unset. + Integrator string `json:"integrator,omitempty"` // ServiceAccount: Required. Service account that provides subscriber access to // the registered topic. ServiceAccount string `json:"serviceAccount,omitempty"` - // ForceSendFields is a list of field names (e.g. "ServiceAccount") 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. "Account") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ServiceAccount") 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. "Account") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -3793,18 +3811,24 @@ func (s GoogleCloudChannelV1TrialSettings) MarshalJSON() ([]byte, error) { // GoogleCloudChannelV1UnregisterSubscriberRequest: Request Message for // UnregisterSubscriber. type GoogleCloudChannelV1UnregisterSubscriberRequest struct { + // Account: Optional. Resource name of the account. Required if integrator is + // not provided. Otherwise, leave this field empty/unset. + Account string `json:"account,omitempty"` + // Integrator: Optional. Resource name of the integrator. Required if account + // is not provided. Otherwise, leave this field empty/unset. + Integrator string `json:"integrator,omitempty"` // ServiceAccount: Required. Service account to unregister from subscriber // access to the topic. ServiceAccount string `json:"serviceAccount,omitempty"` - // ForceSendFields is a list of field names (e.g. "ServiceAccount") 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. "Account") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ServiceAccount") 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. "Account") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -5315,23 +5339,32 @@ type AccountsListSubscribersCall struct { } // ListSubscribers: Lists service accounts with subscriber privileges on the -// Cloud Pub/Sub topic created for this Channel Services account. Possible -// error codes: * PERMISSION_DENIED: The reseller account making the request -// and the provided reseller account are different, or the impersonated user is -// not a super admin. * INVALID_ARGUMENT: Required request parameters are -// missing or invalid. * NOT_FOUND: The topic resource doesn't exist. * +// Pub/Sub topic created for this Channel Services account or integrator. +// Possible error codes: * PERMISSION_DENIED: The reseller account making the +// request and the provided reseller account are different, or the impersonated +// user is not a super admin. * INVALID_ARGUMENT: Required request parameters +// are missing or invalid. * NOT_FOUND: The topic resource doesn't exist. * // INTERNAL: Any non-user error related to a technical issue in the backend. // Contact Cloud Channel support. * UNKNOWN: Any non-user error related to a // technical issue in the backend. Contact Cloud Channel support. Return value: // A list of service email addresses. // -// - account: Optional. Resource name of the account. +// - account: Optional. Resource name of the account. Required if integrator is +// not provided. Otherwise, leave this field empty/unset. func (r *AccountsService) ListSubscribers(account string) *AccountsListSubscribersCall { c := &AccountsListSubscribersCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.account = account return c } +// Integrator sets the optional parameter "integrator": Resource name of the +// integrator. Required if account is not provided. Otherwise, leave this field +// empty/unset. +func (c *AccountsListSubscribersCall) Integrator(integrator string) *AccountsListSubscribersCall { + c.urlParams_.Set("integrator", integrator) + return c +} + // PageSize sets the optional parameter "pageSize": The maximum number of // service accounts to return. The service may return fewer than this value. If // unspecified, returns at most 100 service accounts. The maximum value is @@ -5737,17 +5770,19 @@ type AccountsRegisterCall struct { } // Register: Registers a service account with subscriber privileges on the -// Cloud Pub/Sub topic for this Channel Services account. After you create a -// subscriber, you get the events through SubscriberEvent Possible error codes: -// * PERMISSION_DENIED: The reseller account making the request and the -// provided reseller account are different, or the impersonated user is not a -// super admin. * INVALID_ARGUMENT: Required request parameters are missing or -// invalid. * INTERNAL: Any non-user error related to a technical issue in the -// backend. Contact Cloud Channel support. * UNKNOWN: Any non-user error -// related to a technical issue in the backend. Contact Cloud Channel support. -// Return value: The topic name with the registered service email address. +// Pub/Sub topic for this Channel Services account or integrator. After you +// create a subscriber, you get the events through SubscriberEvent Possible +// error codes: * PERMISSION_DENIED: The reseller account making the request +// and the provided reseller account are different, or the impersonated user is +// not a super admin. * INVALID_ARGUMENT: Required request parameters are +// missing or invalid. * INTERNAL: Any non-user error related to a technical +// issue in the backend. Contact Cloud Channel support. * UNKNOWN: Any non-user +// error related to a technical issue in the backend. Contact Cloud Channel +// support. Return value: The topic name with the registered service email +// address. // -// - account: Optional. Resource name of the account. +// - account: Optional. Resource name of the account. Required if integrator is +// not provided. Otherwise, leave this field empty/unset. func (r *AccountsService) Register(account string, googlecloudchannelv1registersubscriberrequest *GoogleCloudChannelV1RegisterSubscriberRequest) *AccountsRegisterCall { c := &AccountsRegisterCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.account = account @@ -5848,20 +5883,22 @@ type AccountsUnregisterCall struct { } // Unregister: Unregisters a service account with subscriber privileges on the -// Cloud Pub/Sub topic created for this Channel Services account. If there are -// no service accounts left with subscriber privileges, this deletes the topic. -// You can call ListSubscribers to check for these accounts. Possible error -// codes: * PERMISSION_DENIED: The reseller account making the request and the -// provided reseller account are different, or the impersonated user is not a -// super admin. * INVALID_ARGUMENT: Required request parameters are missing or -// invalid. * NOT_FOUND: The topic resource doesn't exist. * INTERNAL: Any -// non-user error related to a technical issue in the backend. Contact Cloud -// Channel support. * UNKNOWN: Any non-user error related to a technical issue -// in the backend. Contact Cloud Channel support. Return value: The topic name -// that unregistered the service email address. Returns a success response if -// the service email address wasn't registered with the topic. +// Pub/Sub topic created for this Channel Services account or integrator. If +// there are no service accounts left with subscriber privileges, this deletes +// the topic. You can call ListSubscribers to check for these accounts. +// Possible error codes: * PERMISSION_DENIED: The reseller account making the +// request and the provided reseller account are different, or the impersonated +// user is not a super admin. * INVALID_ARGUMENT: Required request parameters +// are missing or invalid. * NOT_FOUND: The topic resource doesn't exist. * +// INTERNAL: Any non-user error related to a technical issue in the backend. +// Contact Cloud Channel support. * UNKNOWN: Any non-user error related to a +// technical issue in the backend. Contact Cloud Channel support. Return value: +// The topic name that unregistered the service email address. Returns a +// success response if the service email address wasn't registered with the +// topic. // -// - account: Optional. Resource name of the account. +// - account: Optional. Resource name of the account. Required if integrator is +// not provided. Otherwise, leave this field empty/unset. func (r *AccountsService) Unregister(account string, googlecloudchannelv1unregistersubscriberrequest *GoogleCloudChannelV1UnregisterSubscriberRequest) *AccountsUnregisterCall { c := &AccountsUnregisterCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.account = account @@ -12180,7 +12217,7 @@ func (c *AccountsSkuGroupsListCall) PageSize(pageSize int64) *AccountsSkuGroupsL // PageToken sets the optional parameter "pageToken": A token identifying a // page of results beyond the first page. Obtained through -// ListSkuGroups.next_page_token of the previous +// ListSkuGroupsResponse.next_page_token of the previous // CloudChannelService.ListSkuGroups call. func (c *AccountsSkuGroupsListCall) PageToken(pageToken string) *AccountsSkuGroupsListCall { c.urlParams_.Set("pageToken", pageToken) @@ -12336,7 +12373,7 @@ func (c *AccountsSkuGroupsBillableSkusListCall) PageSize(pageSize int64) *Accoun // PageToken sets the optional parameter "pageToken": A token identifying a // page of results beyond the first page. Obtained through -// ListSkuGroupBillableSkus.next_page_token of the previous +// ListSkuGroupBillableSkusResponse.next_page_token of the previous // CloudChannelService.ListSkuGroupBillableSkus call. func (c *AccountsSkuGroupsBillableSkusListCall) PageToken(pageToken string) *AccountsSkuGroupsBillableSkusListCall { c.urlParams_.Set("pageToken", pageToken) @@ -12454,6 +12491,400 @@ func (c *AccountsSkuGroupsBillableSkusListCall) Pages(ctx context.Context, f fun } } +type IntegratorsListSubscribersCall struct { + s *Service + integrator string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// ListSubscribers: Lists service accounts with subscriber privileges on the +// Pub/Sub topic created for this Channel Services account or integrator. +// Possible error codes: * PERMISSION_DENIED: The reseller account making the +// request and the provided reseller account are different, or the impersonated +// user is not a super admin. * INVALID_ARGUMENT: Required request parameters +// are missing or invalid. * NOT_FOUND: The topic resource doesn't exist. * +// INTERNAL: Any non-user error related to a technical issue in the backend. +// Contact Cloud Channel support. * UNKNOWN: Any non-user error related to a +// technical issue in the backend. Contact Cloud Channel support. Return value: +// A list of service email addresses. +// +// - integrator: Optional. Resource name of the integrator. Required if account +// is not provided. Otherwise, leave this field empty/unset. +func (r *IntegratorsService) ListSubscribers(integrator string) *IntegratorsListSubscribersCall { + c := &IntegratorsListSubscribersCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.integrator = integrator + return c +} + +// Account sets the optional parameter "account": Resource name of the account. +// Required if integrator is not provided. Otherwise, leave this field +// empty/unset. +func (c *IntegratorsListSubscribersCall) Account(account string) *IntegratorsListSubscribersCall { + c.urlParams_.Set("account", account) + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number of +// service accounts to return. The service may return fewer than this value. If +// unspecified, returns at most 100 service accounts. The maximum value is +// 1000; the server will coerce values above 1000. +func (c *IntegratorsListSubscribersCall) PageSize(pageSize int64) *IntegratorsListSubscribersCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A page token, received +// from a previous `ListSubscribers` call. Provide this to retrieve the +// subsequent page. When paginating, all other parameters provided to +// `ListSubscribers` must match the call that provided the page token. +func (c *IntegratorsListSubscribersCall) PageToken(pageToken string) *IntegratorsListSubscribersCall { + 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 *IntegratorsListSubscribersCall) Fields(s ...googleapi.Field) *IntegratorsListSubscribersCall { + 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 *IntegratorsListSubscribersCall) IfNoneMatch(entityTag string) *IntegratorsListSubscribersCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *IntegratorsListSubscribersCall) Context(ctx context.Context) *IntegratorsListSubscribersCall { + 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 *IntegratorsListSubscribersCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *IntegratorsListSubscribersCall) 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/{+integrator}:listSubscribers") + 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{ + "integrator": c.integrator, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "cloudchannel.integrators.listSubscribers" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudChannelV1ListSubscribersResponse.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 *IntegratorsListSubscribersCall) Do(opts ...googleapi.CallOption) (*GoogleCloudChannelV1ListSubscribersResponse, 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 := &GoogleCloudChannelV1ListSubscribersResponse{ + 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 *IntegratorsListSubscribersCall) Pages(ctx context.Context, f func(*GoogleCloudChannelV1ListSubscribersResponse) 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 IntegratorsRegisterSubscriberCall struct { + s *Service + integrator string + googlecloudchannelv1registersubscriberrequest *GoogleCloudChannelV1RegisterSubscriberRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// RegisterSubscriber: Registers a service account with subscriber privileges +// on the Pub/Sub topic for this Channel Services account or integrator. After +// you create a subscriber, you get the events through SubscriberEvent Possible +// error codes: * PERMISSION_DENIED: The reseller account making the request +// and the provided reseller account are different, or the impersonated user is +// not a super admin. * INVALID_ARGUMENT: Required request parameters are +// missing or invalid. * INTERNAL: Any non-user error related to a technical +// issue in the backend. Contact Cloud Channel support. * UNKNOWN: Any non-user +// error related to a technical issue in the backend. Contact Cloud Channel +// support. Return value: The topic name with the registered service email +// address. +// +// - integrator: Optional. Resource name of the integrator. Required if account +// is not provided. Otherwise, leave this field empty/unset. +func (r *IntegratorsService) RegisterSubscriber(integrator string, googlecloudchannelv1registersubscriberrequest *GoogleCloudChannelV1RegisterSubscriberRequest) *IntegratorsRegisterSubscriberCall { + c := &IntegratorsRegisterSubscriberCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.integrator = integrator + c.googlecloudchannelv1registersubscriberrequest = googlecloudchannelv1registersubscriberrequest + 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 *IntegratorsRegisterSubscriberCall) Fields(s ...googleapi.Field) *IntegratorsRegisterSubscriberCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *IntegratorsRegisterSubscriberCall) Context(ctx context.Context) *IntegratorsRegisterSubscriberCall { + 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 *IntegratorsRegisterSubscriberCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *IntegratorsRegisterSubscriberCall) 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.googlecloudchannelv1registersubscriberrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+integrator}:registerSubscriber") + 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{ + "integrator": c.integrator, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "cloudchannel.integrators.registerSubscriber" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudChannelV1RegisterSubscriberResponse.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 *IntegratorsRegisterSubscriberCall) Do(opts ...googleapi.CallOption) (*GoogleCloudChannelV1RegisterSubscriberResponse, 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 := &GoogleCloudChannelV1RegisterSubscriberResponse{ + 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 IntegratorsUnregisterSubscriberCall struct { + s *Service + integrator string + googlecloudchannelv1unregistersubscriberrequest *GoogleCloudChannelV1UnregisterSubscriberRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// UnregisterSubscriber: Unregisters a service account with subscriber +// privileges on the Pub/Sub topic created for this Channel Services account or +// integrator. If there are no service accounts left with subscriber +// privileges, this deletes the topic. You can call ListSubscribers to check +// for these accounts. Possible error codes: * PERMISSION_DENIED: The reseller +// account making the request and the provided reseller account are different, +// or the impersonated user is not a super admin. * INVALID_ARGUMENT: Required +// request parameters are missing or invalid. * NOT_FOUND: The topic resource +// doesn't exist. * INTERNAL: Any non-user error related to a technical issue +// in the backend. Contact Cloud Channel support. * UNKNOWN: Any non-user error +// related to a technical issue in the backend. Contact Cloud Channel support. +// Return value: The topic name that unregistered the service email address. +// Returns a success response if the service email address wasn't registered +// with the topic. +// +// - integrator: Optional. Resource name of the integrator. Required if account +// is not provided. Otherwise, leave this field empty/unset. +func (r *IntegratorsService) UnregisterSubscriber(integrator string, googlecloudchannelv1unregistersubscriberrequest *GoogleCloudChannelV1UnregisterSubscriberRequest) *IntegratorsUnregisterSubscriberCall { + c := &IntegratorsUnregisterSubscriberCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.integrator = integrator + c.googlecloudchannelv1unregistersubscriberrequest = googlecloudchannelv1unregistersubscriberrequest + 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 *IntegratorsUnregisterSubscriberCall) Fields(s ...googleapi.Field) *IntegratorsUnregisterSubscriberCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *IntegratorsUnregisterSubscriberCall) Context(ctx context.Context) *IntegratorsUnregisterSubscriberCall { + 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 *IntegratorsUnregisterSubscriberCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *IntegratorsUnregisterSubscriberCall) 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.googlecloudchannelv1unregistersubscriberrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+integrator}:unregisterSubscriber") + 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{ + "integrator": c.integrator, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "cloudchannel.integrators.unregisterSubscriber" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudChannelV1UnregisterSubscriberResponse.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 *IntegratorsUnregisterSubscriberCall) Do(opts ...googleapi.CallOption) (*GoogleCloudChannelV1UnregisterSubscriberResponse, 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 := &GoogleCloudChannelV1UnregisterSubscriberResponse{ + 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 OperationsCancelCall struct { s *Service name string diff --git a/cloudcontrolspartner/v1/cloudcontrolspartner-api.json b/cloudcontrolspartner/v1/cloudcontrolspartner-api.json index 4bf7ac73f0d..4cf024c5602 100644 --- a/cloudcontrolspartner/v1/cloudcontrolspartner-api.json +++ b/cloudcontrolspartner/v1/cloudcontrolspartner-api.json @@ -138,6 +138,64 @@ "resources": { "customers": { "methods": { + "create": { + "description": "Creates a new customer.", + "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/customers", + "httpMethod": "POST", + "id": "cloudcontrolspartner.organizations.locations.customers.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "customerId": { + "description": "Required. The customer id to use for the customer, which will become the final component of the customer's resource name. The specified value must be a valid Google cloud organization id.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. Parent resource Format: `organizations/{organization}/locations/{location}`", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/customers", + "request": { + "$ref": "Customer" + }, + "response": { + "$ref": "Customer" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Delete details of a single customer", + "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/customers/{customersId}", + "httpMethod": "DELETE", + "id": "cloudcontrolspartner.organizations.locations.customers.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. name of the resource to be deleted format: name=organizations/*/locations/*/customers/*", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+/customers/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "get": { "description": "Gets details of a single customer", "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/customers/{customersId}", @@ -208,6 +266,40 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "patch": { + "description": "Update details of a single customer", + "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/customers/{customersId}", + "httpMethod": "PATCH", + "id": "cloudcontrolspartner.organizations.locations.customers.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Identifier. Format: `organizations/{organization}/locations/{location}/customers/{customer}`", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+/customers/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Optional. The list of fields to update", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "Customer" + }, + "response": { + "$ref": "Customer" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } }, "resources": { @@ -484,7 +576,7 @@ } } }, - "revision": "20240904", + "revision": "20241024", "rootUrl": "https://cloudcontrolspartner.googleapis.com/", "schemas": { "AccessApprovalRequest": { @@ -609,6 +701,11 @@ "name": { "description": "Identifier. Format: `organizations/{organization}/locations/{location}/customers/{customer}`", "type": "string" + }, + "organizationDomain": { + "description": "Output only. The customer organization domain, extracted from CRM Organization’s display_name field. e.g. \"google.com\"", + "readOnly": true, + "type": "string" } }, "type": "object" @@ -758,6 +855,12 @@ }, "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" + }, "Gcloud": { "description": "Remediation instructions to resolve violation via gcloud cli", "id": "Gcloud", diff --git a/cloudcontrolspartner/v1/cloudcontrolspartner-gen.go b/cloudcontrolspartner/v1/cloudcontrolspartner-gen.go index 0b3fdd87741..3a439d01c7d 100644 --- a/cloudcontrolspartner/v1/cloudcontrolspartner-gen.go +++ b/cloudcontrolspartner/v1/cloudcontrolspartner-gen.go @@ -367,6 +367,9 @@ type Customer struct { // Name: Identifier. Format: // `organizations/{organization}/locations/{location}/customers/{customer}` Name string `json:"name,omitempty"` + // OrganizationDomain: Output only. The customer organization domain, extracted + // from CRM Organization’s display_name field. e.g. "google.com" + OrganizationDomain string `json:"organizationDomain,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` @@ -546,6 +549,15 @@ func (s EkmMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// Empty: A generic empty message that you can re-use to avoid defining +// duplicated empty messages in your APIs. A typical example is to use it as +// the request or the response type of an API method. For instance: service Foo +// { 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:"-"` +} + // Gcloud: Remediation instructions to resolve violation via gcloud cli type Gcloud struct { // AdditionalLinks: Additional urls for more information about steps @@ -1204,6 +1216,213 @@ func (c *OrganizationsLocationsGetPartnerCall) Do(opts ...googleapi.CallOption) return ret, nil } +type OrganizationsLocationsCustomersCreateCall struct { + s *Service + parent string + customer *Customer + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a new customer. +// +// - parent: Parent resource Format: +// `organizations/{organization}/locations/{location}`. +func (r *OrganizationsLocationsCustomersService) Create(parent string, customer *Customer) *OrganizationsLocationsCustomersCreateCall { + c := &OrganizationsLocationsCustomersCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.customer = customer + return c +} + +// CustomerId sets the optional parameter "customerId": Required. The customer +// id to use for the customer, which will become the final component of the +// customer's resource name. The specified value must be a valid Google cloud +// organization id. +func (c *OrganizationsLocationsCustomersCreateCall) CustomerId(customerId string) *OrganizationsLocationsCustomersCreateCall { + c.urlParams_.Set("customerId", customerId) + 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 *OrganizationsLocationsCustomersCreateCall) Fields(s ...googleapi.Field) *OrganizationsLocationsCustomersCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsLocationsCustomersCreateCall) Context(ctx context.Context) *OrganizationsLocationsCustomersCreateCall { + 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 *OrganizationsLocationsCustomersCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsCustomersCreateCall) 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.customer) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/customers") + 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 "cloudcontrolspartner.organizations.locations.customers.create" call. +// Any non-2xx status code is an error. Response headers are in either +// *Customer.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 *OrganizationsLocationsCustomersCreateCall) Do(opts ...googleapi.CallOption) (*Customer, 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 := &Customer{ + 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 OrganizationsLocationsCustomersDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Delete details of a single customer +// +// - name: name of the resource to be deleted format: +// name=organizations/*/locations/*/customers/*. +func (r *OrganizationsLocationsCustomersService) Delete(name string) *OrganizationsLocationsCustomersDeleteCall { + c := &OrganizationsLocationsCustomersDeleteCall{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 *OrganizationsLocationsCustomersDeleteCall) Fields(s ...googleapi.Field) *OrganizationsLocationsCustomersDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsLocationsCustomersDeleteCall) Context(ctx context.Context) *OrganizationsLocationsCustomersDeleteCall { + 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 *OrganizationsLocationsCustomersDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsCustomersDeleteCall) 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, "v1/{+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 "cloudcontrolspartner.organizations.locations.customers.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 *OrganizationsLocationsCustomersDeleteCall) 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 OrganizationsLocationsCustomersGetCall struct { s *Service name string @@ -1472,6 +1691,115 @@ func (c *OrganizationsLocationsCustomersListCall) Pages(ctx context.Context, f f } } +type OrganizationsLocationsCustomersPatchCall struct { + s *Service + name string + customer *Customer + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Update details of a single customer +// +// - name: Identifier. Format: +// `organizations/{organization}/locations/{location}/customers/{customer}`. +func (r *OrganizationsLocationsCustomersService) Patch(name string, customer *Customer) *OrganizationsLocationsCustomersPatchCall { + c := &OrganizationsLocationsCustomersPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.customer = customer + return c +} + +// UpdateMask sets the optional parameter "updateMask": The list of fields to +// update +func (c *OrganizationsLocationsCustomersPatchCall) UpdateMask(updateMask string) *OrganizationsLocationsCustomersPatchCall { + 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 *OrganizationsLocationsCustomersPatchCall) Fields(s ...googleapi.Field) *OrganizationsLocationsCustomersPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsLocationsCustomersPatchCall) Context(ctx context.Context) *OrganizationsLocationsCustomersPatchCall { + 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 *OrganizationsLocationsCustomersPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsCustomersPatchCall) 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.customer) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "cloudcontrolspartner.organizations.locations.customers.patch" call. +// Any non-2xx status code is an error. Response headers are in either +// *Customer.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 *OrganizationsLocationsCustomersPatchCall) Do(opts ...googleapi.CallOption) (*Customer, 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 := &Customer{ + 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 OrganizationsLocationsCustomersWorkloadsGetCall struct { s *Service name string diff --git a/cloudcontrolspartner/v1beta/cloudcontrolspartner-api.json b/cloudcontrolspartner/v1beta/cloudcontrolspartner-api.json index f923949d306..459581fd713 100644 --- a/cloudcontrolspartner/v1beta/cloudcontrolspartner-api.json +++ b/cloudcontrolspartner/v1beta/cloudcontrolspartner-api.json @@ -138,6 +138,64 @@ "resources": { "customers": { "methods": { + "create": { + "description": "Creates a new customer.", + "flatPath": "v1beta/organizations/{organizationsId}/locations/{locationsId}/customers", + "httpMethod": "POST", + "id": "cloudcontrolspartner.organizations.locations.customers.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "customerId": { + "description": "Required. The customer id to use for the customer, which will become the final component of the customer's resource name. The specified value must be a valid Google cloud organization id.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. Parent resource Format: `organizations/{organization}/locations/{location}`", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+parent}/customers", + "request": { + "$ref": "Customer" + }, + "response": { + "$ref": "Customer" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Delete details of a single customer", + "flatPath": "v1beta/organizations/{organizationsId}/locations/{locationsId}/customers/{customersId}", + "httpMethod": "DELETE", + "id": "cloudcontrolspartner.organizations.locations.customers.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. name of the resource to be deleted format: name=organizations/*/locations/*/customers/*", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+/customers/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+name}", + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "get": { "description": "Gets details of a single customer", "flatPath": "v1beta/organizations/{organizationsId}/locations/{locationsId}/customers/{customersId}", @@ -208,6 +266,40 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "patch": { + "description": "Update details of a single customer", + "flatPath": "v1beta/organizations/{organizationsId}/locations/{locationsId}/customers/{customersId}", + "httpMethod": "PATCH", + "id": "cloudcontrolspartner.organizations.locations.customers.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Identifier. Format: `organizations/{organization}/locations/{location}/customers/{customer}`", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+/customers/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Optional. The list of fields to update", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1beta/{+name}", + "request": { + "$ref": "Customer" + }, + "response": { + "$ref": "Customer" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } }, "resources": { @@ -484,7 +576,7 @@ } } }, - "revision": "20240904", + "revision": "20241024", "rootUrl": "https://cloudcontrolspartner.googleapis.com/", "schemas": { "AccessApprovalRequest": { @@ -609,6 +701,11 @@ "name": { "description": "Identifier. Format: `organizations/{organization}/locations/{location}/customers/{customer}`", "type": "string" + }, + "organizationDomain": { + "description": "Output only. The customer organization domain, extracted from CRM Organization’s display_name field. e.g. \"google.com\"", + "readOnly": true, + "type": "string" } }, "type": "object" @@ -758,6 +855,12 @@ }, "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" + }, "Gcloud": { "description": "Remediation instructions to resolve violation via gcloud cli", "id": "Gcloud", diff --git a/cloudcontrolspartner/v1beta/cloudcontrolspartner-gen.go b/cloudcontrolspartner/v1beta/cloudcontrolspartner-gen.go index dad889bbf9d..4eb0f730ad0 100644 --- a/cloudcontrolspartner/v1beta/cloudcontrolspartner-gen.go +++ b/cloudcontrolspartner/v1beta/cloudcontrolspartner-gen.go @@ -367,6 +367,9 @@ type Customer struct { // Name: Identifier. Format: // `organizations/{organization}/locations/{location}/customers/{customer}` Name string `json:"name,omitempty"` + // OrganizationDomain: Output only. The customer organization domain, extracted + // from CRM Organization’s display_name field. e.g. "google.com" + OrganizationDomain string `json:"organizationDomain,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` @@ -546,6 +549,15 @@ func (s EkmMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// Empty: A generic empty message that you can re-use to avoid defining +// duplicated empty messages in your APIs. A typical example is to use it as +// the request or the response type of an API method. For instance: service Foo +// { 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:"-"` +} + // Gcloud: Remediation instructions to resolve violation via gcloud cli type Gcloud struct { // AdditionalLinks: Additional urls for more information about steps @@ -1204,6 +1216,213 @@ func (c *OrganizationsLocationsGetPartnerCall) Do(opts ...googleapi.CallOption) return ret, nil } +type OrganizationsLocationsCustomersCreateCall struct { + s *Service + parent string + customer *Customer + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a new customer. +// +// - parent: Parent resource Format: +// `organizations/{organization}/locations/{location}`. +func (r *OrganizationsLocationsCustomersService) Create(parent string, customer *Customer) *OrganizationsLocationsCustomersCreateCall { + c := &OrganizationsLocationsCustomersCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.customer = customer + return c +} + +// CustomerId sets the optional parameter "customerId": Required. The customer +// id to use for the customer, which will become the final component of the +// customer's resource name. The specified value must be a valid Google cloud +// organization id. +func (c *OrganizationsLocationsCustomersCreateCall) CustomerId(customerId string) *OrganizationsLocationsCustomersCreateCall { + c.urlParams_.Set("customerId", customerId) + 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 *OrganizationsLocationsCustomersCreateCall) Fields(s ...googleapi.Field) *OrganizationsLocationsCustomersCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsLocationsCustomersCreateCall) Context(ctx context.Context) *OrganizationsLocationsCustomersCreateCall { + 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 *OrganizationsLocationsCustomersCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsCustomersCreateCall) 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.customer) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta/{+parent}/customers") + 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 "cloudcontrolspartner.organizations.locations.customers.create" call. +// Any non-2xx status code is an error. Response headers are in either +// *Customer.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 *OrganizationsLocationsCustomersCreateCall) Do(opts ...googleapi.CallOption) (*Customer, 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 := &Customer{ + 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 OrganizationsLocationsCustomersDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Delete details of a single customer +// +// - name: name of the resource to be deleted format: +// name=organizations/*/locations/*/customers/*. +func (r *OrganizationsLocationsCustomersService) Delete(name string) *OrganizationsLocationsCustomersDeleteCall { + c := &OrganizationsLocationsCustomersDeleteCall{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 *OrganizationsLocationsCustomersDeleteCall) Fields(s ...googleapi.Field) *OrganizationsLocationsCustomersDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsLocationsCustomersDeleteCall) Context(ctx context.Context) *OrganizationsLocationsCustomersDeleteCall { + 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 *OrganizationsLocationsCustomersDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsCustomersDeleteCall) 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, "v1beta/{+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 "cloudcontrolspartner.organizations.locations.customers.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 *OrganizationsLocationsCustomersDeleteCall) 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 OrganizationsLocationsCustomersGetCall struct { s *Service name string @@ -1472,6 +1691,115 @@ func (c *OrganizationsLocationsCustomersListCall) Pages(ctx context.Context, f f } } +type OrganizationsLocationsCustomersPatchCall struct { + s *Service + name string + customer *Customer + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Update details of a single customer +// +// - name: Identifier. Format: +// `organizations/{organization}/locations/{location}/customers/{customer}`. +func (r *OrganizationsLocationsCustomersService) Patch(name string, customer *Customer) *OrganizationsLocationsCustomersPatchCall { + c := &OrganizationsLocationsCustomersPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.customer = customer + return c +} + +// UpdateMask sets the optional parameter "updateMask": The list of fields to +// update +func (c *OrganizationsLocationsCustomersPatchCall) UpdateMask(updateMask string) *OrganizationsLocationsCustomersPatchCall { + 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 *OrganizationsLocationsCustomersPatchCall) Fields(s ...googleapi.Field) *OrganizationsLocationsCustomersPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsLocationsCustomersPatchCall) Context(ctx context.Context) *OrganizationsLocationsCustomersPatchCall { + 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 *OrganizationsLocationsCustomersPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsCustomersPatchCall) 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.customer) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta/{+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 "cloudcontrolspartner.organizations.locations.customers.patch" call. +// Any non-2xx status code is an error. Response headers are in either +// *Customer.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 *OrganizationsLocationsCustomersPatchCall) Do(opts ...googleapi.CallOption) (*Customer, 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 := &Customer{ + 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 OrganizationsLocationsCustomersWorkloadsGetCall struct { s *Service name string diff --git a/compute/v0.alpha/compute-api.json b/compute/v0.alpha/compute-api.json index 9e14d2ce5be..5160c0bea16 100644 --- a/compute/v0.alpha/compute-api.json +++ b/compute/v0.alpha/compute-api.json @@ -11621,7 +11621,7 @@ ] }, "addNetworkInterface": { - "description": "Adds a network interface to an instance.", + "description": "Adds one dynamic network interface to an active instance.", "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/addNetworkInterface", "httpMethod": "POST", "id": "compute.instances.addNetworkInterface", @@ -11996,7 +11996,7 @@ ] }, "deleteNetworkInterface": { - "description": "Deletes one network interface from an active instance. InstancesDeleteNetworkInterfaceRequest indicates: - instance from which to delete, using project+zone+resource_id fields; - network interface to be deleted, using network_interface_name field; Only VLAN interface deletion is supported for now.", + "description": "Deletes one dynamic network interface from an active instance. InstancesDeleteNetworkInterfaceRequest indicates: - instance from which to delete, using project+zone+resource_id fields; - dynamic network interface to be deleted, using network_interface_name field;", "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/deleteNetworkInterface", "httpMethod": "POST", "id": "compute.instances.deleteNetworkInterface", @@ -12014,7 +12014,7 @@ "type": "string" }, "networkInterfaceName": { - "description": "The name of the network interface to be deleted from the instance. Only VLAN network interface deletion is supported.", + "description": "The name of the dynamic network interface to be deleted from the instance.", "location": "query", "required": true, "type": "string" @@ -12438,7 +12438,7 @@ "type": "string" }, "start": { - "description": "Specifies the starting byte position of the output to return. To start with the first byte of output to the specified port, omit this field or set it to `0`. If the output for that byte position is available, this field matches the `start` parameter sent with the request. If the amount of serial console output exceeds the size of the buffer (1 MB), the oldest output is discarded and is no longer available. If the requested start position refers to discarded output, the start position is adjusted to the oldest output still available, and the adjusted start position is returned as the `start` property value. You can also provide a negative start position, which translates to the most recent number of bytes written to the serial port. For example, -3 is interpreted as the most recent 3 bytes written to the serial console.", + "description": "Specifies the starting byte position of the output to return. To start with the first byte of output to the specified port, omit this field or set it to `0`. If the output for that byte position is available, this field matches the `start` parameter sent with the request. If the amount of serial console output exceeds the size of the buffer (1 MB), the oldest output is discarded and is no longer available. If the requested start position refers to discarded output, the start position is adjusted to the oldest output still available, and the adjusted start position is returned as the `start` property value. You can also provide a negative start position, which translates to the most recent number of bytes written to the serial port. For example, -3 is interpreted as the most recent 3 bytes written to the serial console. Note that the negative start is bounded by the retained buffer size, and the returned serial console output will not exceed the max buffer size.", "format": "int64", "location": "query", "type": "string" @@ -22676,6 +22676,56 @@ "https://www.googleapis.com/auth/compute.readonly" ] }, + "listPreconfiguredExpressionSets": { + "description": "Gets the current list of preconfigured Web Application Firewall (WAF) expressions.", + "flatPath": "locations/global/securityPolicies/listPreconfiguredExpressionSets", + "httpMethod": "GET", + "id": "compute.organizationSecurityPolicies.listPreconfiguredExpressionSets", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the 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" + }, + "parentId": { + "description": "Parent ID for this request.", + "location": "query", + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial 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": "locations/global/securityPolicies/listPreconfiguredExpressionSets", + "response": { + "$ref": "SecurityPoliciesListPreconfiguredExpressionSetsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, "move": { "description": "Moves the specified security policy.", "flatPath": "locations/global/securityPolicies/{securityPolicy}/move", @@ -47129,7 +47179,7 @@ } } }, - "revision": "20241008", + "revision": "20241021", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -49002,7 +49052,7 @@ "type": "object" }, "AuditConfig": { - "description": "Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { \"audit_configs\": [ { \"service\": \"allServices\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\", \"exempted_members\": [ \"user:jose@example.com\" ] }, { \"log_type\": \"DATA_WRITE\" }, { \"log_type\": \"ADMIN_READ\" } ] }, { \"service\": \"sampleservice.googleapis.com\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\" }, { \"log_type\": \"DATA_WRITE\", \"exempted_members\": [ \"user:aliya@example.com\" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts jose@example.com from DATA_READ logging, and aliya@example.com from DATA_WRITE logging.", + "description": "Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { \"audit_configs\": [ { \"service\": \"allServices\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\", \"exempted_members\": [ \"user:jose@example.com\" ] }, { \"log_type\": \"DATA_WRITE\" }, { \"log_type\": \"ADMIN_READ\" } ] }, { \"service\": \"sampleservice.googleapis.com\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\" }, { \"log_type\": \"DATA_WRITE\", \"exempted_members\": [ \"user:aliya@example.com\" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts `jose@example.com` from DATA_READ logging, and `aliya@example.com` from DATA_WRITE logging.", "id": "AuditConfig", "properties": { "auditLogConfigs": { @@ -50111,7 +50161,7 @@ "description": "The CacheKeyPolicy for this CdnPolicy." }, "cacheMode": { - "description": "Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached.", + "description": "Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached. If no value is provided for cdnPolicy.cacheMode, it defaults to CACHE_ALL_STATIC.", "enum": [ "CACHE_ALL_STATIC", "FORCE_CACHE_ALL", @@ -51102,7 +51152,7 @@ "description": "The CacheKeyPolicy for this CdnPolicy." }, "cacheMode": { - "description": "Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached.", + "description": "Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached. If no value is provided for cdnPolicy.cacheMode, it defaults to CACHE_ALL_STATIC.", "enum": [ "CACHE_ALL_STATIC", "FORCE_CACHE_ALL", @@ -52406,10 +52456,6 @@ "description": "Associates `members`, or principals, with a `role`.", "id": "Binding", "properties": { - "bindingId": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string" - }, "condition": { "$ref": "Expr", "description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)." @@ -53431,86 +53477,6 @@ }, "type": "object" }, - "Condition": { - "description": "This is deprecated and has no effect. Do not use.", - "id": "Condition", - "properties": { - "iam": { - "description": "This is deprecated and has no effect. Do not use.", - "enum": [ - "APPROVER", - "ATTRIBUTION", - "AUTHORITY", - "CREDENTIALS_TYPE", - "CREDS_ASSERTION", - "JUSTIFICATION_TYPE", - "NO_ATTR", - "SECURITY_REALM" - ], - "enumDescriptions": [ - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use." - ], - "type": "string" - }, - "op": { - "description": "This is deprecated and has no effect. Do not use.", - "enum": [ - "DISCHARGED", - "EQUALS", - "IN", - "NOT_EQUALS", - "NOT_IN", - "NO_OP" - ], - "enumDescriptions": [ - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use." - ], - "type": "string" - }, - "svc": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string" - }, - "sys": { - "description": "This is deprecated and has no effect. Do not use.", - "enum": [ - "IP", - "NAME", - "NO_ATTR", - "REGION", - "SERVICE" - ], - "enumDescriptions": [ - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use." - ], - "type": "string" - }, - "values": { - "description": "This is deprecated and has no effect. Do not use.", - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "ConfidentialInstanceConfig": { "description": "A set of Confidential Instance options.", "id": "ConfidentialInstanceConfig", @@ -62816,7 +62782,7 @@ "type": "string" }, "namedPorts": { - "description": "Named ports configured for the Instance Groups complementary to this Instance Group Manager.", + "description": "[Output Only] Named ports configured on the Instance Groups complementary to this Instance Group Manager.", "items": { "$ref": "NamedPort" }, @@ -71764,102 +71730,6 @@ }, "type": "object" }, - "LogConfig": { - "description": "This is deprecated and has no effect. Do not use.", - "id": "LogConfig", - "properties": { - "cloudAudit": { - "$ref": "LogConfigCloudAuditOptions", - "description": "This is deprecated and has no effect. Do not use." - }, - "counter": { - "$ref": "LogConfigCounterOptions", - "description": "This is deprecated and has no effect. Do not use." - }, - "dataAccess": { - "$ref": "LogConfigDataAccessOptions", - "description": "This is deprecated and has no effect. Do not use." - } - }, - "type": "object" - }, - "LogConfigCloudAuditOptions": { - "description": "This is deprecated and has no effect. Do not use.", - "id": "LogConfigCloudAuditOptions", - "properties": { - "logName": { - "description": "This is deprecated and has no effect. Do not use.", - "enum": [ - "ADMIN_ACTIVITY", - "DATA_ACCESS", - "UNSPECIFIED_LOG_NAME" - ], - "enumDescriptions": [ - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use." - ], - "type": "string" - } - }, - "type": "object" - }, - "LogConfigCounterOptions": { - "description": "This is deprecated and has no effect. Do not use.", - "id": "LogConfigCounterOptions", - "properties": { - "customFields": { - "description": "This is deprecated and has no effect. Do not use.", - "items": { - "$ref": "LogConfigCounterOptionsCustomField" - }, - "type": "array" - }, - "field": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string" - }, - "metric": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string" - } - }, - "type": "object" - }, - "LogConfigCounterOptionsCustomField": { - "description": "This is deprecated and has no effect. Do not use.", - "id": "LogConfigCounterOptionsCustomField", - "properties": { - "name": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string" - }, - "value": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string" - } - }, - "type": "object" - }, - "LogConfigDataAccessOptions": { - "description": "This is deprecated and has no effect. Do not use.", - "id": "LogConfigDataAccessOptions", - "properties": { - "logMode": { - "description": "This is deprecated and has no effect. Do not use.", - "enum": [ - "LOG_FAIL_CLOSED", - "LOG_MODE_UNSPECIFIED" - ], - "enumDescriptions": [ - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use." - ], - "type": "string" - } - }, - "type": "object" - }, "MachineImage": { "description": "Represents a machine image resource. A machine image is a Compute Engine resource that stores all the configuration, metadata, permissions, and data from one or more disks required to create a Virtual machine (VM) instance. For more information, see Machine images.", "id": "MachineImage", @@ -75725,19 +75595,23 @@ "enum": [ "GVNIC", "IDPF", + "IRDMA", + "MRDMA", "UNSPECIFIED_NIC_TYPE", "VIRTIO_NET" ], "enumDescriptions": [ "GVNIC", "IDPF", + "IRDMA", + "MRDMA", "No type specified.", "VIRTIO" ], "type": "string" }, "parentNicName": { - "description": "Name of the parent network interface of a VLAN based nic. If this field is specified, vlan must be set.", + "description": "Name of the parent network interface of a dynamic network interface.", "type": "string" }, "queueCount": { @@ -75771,7 +75645,7 @@ "type": "string" }, "vlan": { - "description": "VLAN tag of a VLAN based network interface, must be in range from 2 to 4094 inclusively. This field is mandatory if the parent network interface name is set.", + "description": "VLAN tag of a dynamic network interface, must be in range from 2 to 4094 inclusively.", "format": "int32", "type": "integer" } @@ -76092,6 +75966,10 @@ "description": "[Output Only] Type of the resource. Always compute#networkProfile for network profiles.", "type": "string" }, + "location": { + "$ref": "NetworkProfileLocation", + "description": "[Output Only] Location to which the network is restricted." + }, "name": { "description": "[Output Only] Name of the resource.", "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", @@ -76112,6 +75990,26 @@ }, "type": "object" }, + "NetworkProfileLocation": { + "id": "NetworkProfileLocation", + "properties": { + "name": { + "type": "string" + }, + "scope": { + "enum": [ + "REGION", + "ZONE" + ], + "enumDescriptions": [ + "", + "" + ], + "type": "string" + } + }, + "type": "object" + }, "NetworkProfileNetworkFeatures": { "id": "NetworkProfileNetworkFeatures", "properties": { @@ -76348,7 +76246,30 @@ ], "type": "string" }, - "allowedSubnetPurposes": { + "interfaceTypes": { + "description": "If set, limits the interface types that the network supports. If empty, all interface types are supported.", + "items": { + "enum": [ + "GVNIC", + "IDPF", + "IRDMA", + "MRDMA", + "UNSPECIFIED_NIC_TYPE", + "VIRTIO_NET" + ], + "enumDescriptions": [ + "GVNIC", + "IDPF", + "IRDMA", + "MRDMA", + "No type specified.", + "VIRTIO" + ], + "type": "string" + }, + "type": "array" + }, + "subnetPurposes": { "description": "Specifies which subnetwork purposes are supported.", "items": { "enum": [ @@ -76363,7 +76284,7 @@ }, "type": "array" }, - "allowedSubnetStackTypes": { + "subnetStackTypes": { "description": "Specifies which subnetwork stack types are supported.", "items": { "enum": [ @@ -76380,25 +76301,6 @@ }, "type": "array" }, - "interfaceTypes": { - "description": "If set, limits the interface types that the network supports. If empty, all interface types are supported.", - "items": { - "enum": [ - "GVNIC", - "IDPF", - "UNSPECIFIED_NIC_TYPE", - "VIRTIO_NET" - ], - "enumDescriptions": [ - "GVNIC", - "IDPF", - "No type specified.", - "VIRTIO" - ], - "type": "string" - }, - "type": "array" - }, "unicast": { "description": "Specifies which type of unicast is supported.", "enum": [ @@ -81076,13 +80978,6 @@ "format": "byte", "type": "string" }, - "rules": { - "description": "This is deprecated and has no effect. Do not use.", - "items": { - "$ref": "Rule" - }, - "type": "array" - }, "version": { "description": "Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", "format": "int32", @@ -85963,7 +85858,7 @@ "description": "[Output Only] The name of this reservation block generated by Google Compute Engine. The name must be 1-63 characters long, and comply with RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "type": "string" }, - "physicalHostTopology": { + "physicalTopology": { "$ref": "ReservationBlockPhysicalTopology", "description": "[Output Only] The physical topology of the reservation block." }, @@ -87453,6 +87348,10 @@ "description": "[Output Only] An opaque ID of the host on which the VM is running.", "type": "string" }, + "physicalHostTopology": { + "$ref": "ResourceStatusPhysicalHostTopology", + "description": "[Output Only] The physical host topology of the host on which the VM is running." + }, "scheduling": { "$ref": "ResourceStatusScheduling" }, @@ -87579,6 +87478,25 @@ }, "type": "object" }, + "ResourceStatusPhysicalHostTopology": { + "description": "Represents the physical host topology of the host on which the VM is running.", + "id": "ResourceStatusPhysicalHostTopology", + "properties": { + "block": { + "type": "string" + }, + "cluster": { + "type": "string" + }, + "host": { + "type": "string" + }, + "subblock": { + "type": "string" + } + }, + "type": "object" + }, "ResourceStatusScheduling": { "id": "ResourceStatusScheduling", "properties": { @@ -90285,72 +90203,6 @@ }, "type": "object" }, - "Rule": { - "description": "This is deprecated and has no effect. Do not use.", - "id": "Rule", - "properties": { - "action": { - "description": "This is deprecated and has no effect. Do not use.", - "enum": [ - "ALLOW", - "ALLOW_WITH_LOG", - "DENY", - "DENY_WITH_LOG", - "LOG", - "NO_ACTION" - ], - "enumDescriptions": [ - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use." - ], - "type": "string" - }, - "conditions": { - "description": "This is deprecated and has no effect. Do not use.", - "items": { - "$ref": "Condition" - }, - "type": "array" - }, - "description": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string" - }, - "ins": { - "description": "This is deprecated and has no effect. Do not use.", - "items": { - "type": "string" - }, - "type": "array" - }, - "logConfigs": { - "description": "This is deprecated and has no effect. Do not use.", - "items": { - "$ref": "LogConfig" - }, - "type": "array" - }, - "notIns": { - "description": "This is deprecated and has no effect. Do not use.", - "items": { - "type": "string" - }, - "type": "array" - }, - "permissions": { - "description": "This is deprecated and has no effect. Do not use.", - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "SSLHealthCheck": { "id": "SSLHealthCheck", "properties": { @@ -90715,6 +90567,10 @@ ], "type": "string" }, + "shutdownTimeout": { + "$ref": "Duration", + "description": "Timeout between GCE ACPI G2 Soft Off and ACPI G3 Mechanical Off during shutdown operation of VM. For Standard VMs values between 0s and 120s are allowed. For Spot and Preemptible VMs supported values are between 0s and 30s. If no value is specified for shutdownDuration, default values are 90s for Standard VMs and 30s for Spot/Preemptible VMs." + }, "terminationTime": { "description": "Specifies the timestamp, when the instance will be terminated, in RFC3339 text format. If specified, the instance termination action will be performed at the termination time.", "type": "string" @@ -97442,7 +97298,7 @@ "type": "string" }, "purpose": { - "description": "The purpose of the resource. This field can be either PRIVATE, GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, PRIVATE_SERVICE_CONNECT, or PRIVATE is the default purpose for user-created subnets or subnets that are automatically created in auto mode networks. Subnets with purpose set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks that are reserved for Envoy-based load balancers. A subnet with purpose set to PRIVATE_SERVICE_CONNECT is used to publish services using Private Service Connect. If unspecified, the subnet purpose defaults to PRIVATE. The enableFlowLogs field isn't supported if the subnet purpose field is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY.", + "description": "The purpose of the resource. This field can be either PRIVATE, GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, or PRIVATE_SERVICE_CONNECT. PRIVATE is the default purpose for user-created subnets or subnets that are automatically created in auto mode networks. Subnets with purpose set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks that are reserved for Envoy-based load balancers. A subnet with purpose set to PRIVATE_SERVICE_CONNECT is used to publish services using Private Service Connect. If unspecified, the subnet purpose defaults to PRIVATE. The enableFlowLogs field isn't supported if the subnet purpose field is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY.", "enum": [ "AGGREGATE", "CLOUD_EXTENSION", @@ -103099,7 +102955,7 @@ "type": "string" }, "purpose": { - "description": "The purpose of the resource. This field can be either PRIVATE, GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, PRIVATE_SERVICE_CONNECT, or PRIVATE is the default purpose for user-created subnets or subnets that are automatically created in auto mode networks. Subnets with purpose set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks that are reserved for Envoy-based load balancers. A subnet with purpose set to PRIVATE_SERVICE_CONNECT is used to publish services using Private Service Connect. If unspecified, the subnet purpose defaults to PRIVATE. The enableFlowLogs field isn't supported if the subnet purpose field is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY.", + "description": "The purpose of the resource. This field can be either PRIVATE, GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, or PRIVATE_SERVICE_CONNECT. PRIVATE is the default purpose for user-created subnets or subnets that are automatically created in auto mode networks. Subnets with purpose set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks that are reserved for Envoy-based load balancers. A subnet with purpose set to PRIVATE_SERVICE_CONNECT is used to publish services using Private Service Connect. If unspecified, the subnet purpose defaults to PRIVATE. The enableFlowLogs field isn't supported if the subnet purpose field is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY.", "enum": [ "AGGREGATE", "CLOUD_EXTENSION", diff --git a/compute/v0.alpha/compute-gen.go b/compute/v0.alpha/compute-gen.go index 3c8696be279..b24bc015741 100644 --- a/compute/v0.alpha/compute-gen.go +++ b/compute/v0.alpha/compute-gen.go @@ -3603,8 +3603,8 @@ func (s AttachedDiskInitializeParams) MarshalJSON() ([]byte, error) { // "audit_log_configs": [ { "log_type": "DATA_READ" }, { "log_type": // "DATA_WRITE", "exempted_members": [ "user:aliya@example.com" ] } ] } ] } For // sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ -// logging. It also exempts jose@example.com from DATA_READ logging, and -// aliya@example.com from DATA_WRITE logging. +// logging. It also exempts `jose@example.com` from DATA_READ logging, and +// `aliya@example.com` from DATA_WRITE logging. type AuditConfig struct { // AuditLogConfigs: The configuration for logging of each type of permission. AuditLogConfigs []*AuditLogConfig `json:"auditLogConfigs,omitempty"` @@ -5000,7 +5000,8 @@ type BackendBucketCdnPolicy struct { // identifiable) content. CACHE_ALL_STATIC Automatically cache static content, // including common image formats, media (video and audio), and web assets // (JavaScript and CSS). Requests and responses that are marked as uncacheable, - // as well as dynamic content (including HTML), will not be cached. + // as well as dynamic content (including HTML), will not be cached. If no value + // is provided for cdnPolicy.cacheMode, it defaults to CACHE_ALL_STATIC. // // Possible values: // "CACHE_ALL_STATIC" - Automatically cache static content, including common @@ -6231,7 +6232,8 @@ type BackendServiceCdnPolicy struct { // identifiable) content. CACHE_ALL_STATIC Automatically cache static content, // including common image formats, media (video and audio), and web assets // (JavaScript and CSS). Requests and responses that are marked as uncacheable, - // as well as dynamic content (including HTML), will not be cached. + // as well as dynamic content (including HTML), will not be cached. If no value + // is provided for cdnPolicy.cacheMode, it defaults to CACHE_ALL_STATIC. // // Possible values: // "CACHE_ALL_STATIC" - Automatically cache static content, including common @@ -7895,8 +7897,6 @@ func (s BgpRouteNetworkLayerReachabilityInformation) MarshalJSON() ([]byte, erro // Binding: Associates `members`, or principals, with a `role`. type Binding struct { - // BindingId: This is deprecated and has no effect. Do not use. - BindingId string `json:"bindingId,omitempty"` // Condition: The condition that is associated with this binding. If the // condition evaluates to `true`, then this binding applies to the current // request. If the condition evaluates to `false`, then this binding does not @@ -7976,13 +7976,13 @@ type Binding struct { // available pre-defined roles, see here // (https://cloud.google.com/iam/docs/understanding-roles). Role string `json:"role,omitempty"` - // ForceSendFields is a list of field names (e.g. "BindingId") to + // ForceSendFields is a list of field names (e.g. "Condition") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "BindingId") to include in API + // NullFields is a list of field names (e.g. "Condition") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. @@ -9075,61 +9075,6 @@ func (s CommitmentsScopedListWarningData) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Condition: This is deprecated and has no effect. Do not use. -type Condition struct { - // Iam: This is deprecated and has no effect. Do not use. - // - // Possible values: - // "APPROVER" - This is deprecated and has no effect. Do not use. - // "ATTRIBUTION" - This is deprecated and has no effect. Do not use. - // "AUTHORITY" - This is deprecated and has no effect. Do not use. - // "CREDENTIALS_TYPE" - This is deprecated and has no effect. Do not use. - // "CREDS_ASSERTION" - This is deprecated and has no effect. Do not use. - // "JUSTIFICATION_TYPE" - This is deprecated and has no effect. Do not use. - // "NO_ATTR" - This is deprecated and has no effect. Do not use. - // "SECURITY_REALM" - This is deprecated and has no effect. Do not use. - Iam string `json:"iam,omitempty"` - // Op: This is deprecated and has no effect. Do not use. - // - // Possible values: - // "DISCHARGED" - This is deprecated and has no effect. Do not use. - // "EQUALS" - This is deprecated and has no effect. Do not use. - // "IN" - This is deprecated and has no effect. Do not use. - // "NOT_EQUALS" - This is deprecated and has no effect. Do not use. - // "NOT_IN" - This is deprecated and has no effect. Do not use. - // "NO_OP" - This is deprecated and has no effect. Do not use. - Op string `json:"op,omitempty"` - // Svc: This is deprecated and has no effect. Do not use. - Svc string `json:"svc,omitempty"` - // Sys: This is deprecated and has no effect. Do not use. - // - // Possible values: - // "IP" - This is deprecated and has no effect. Do not use. - // "NAME" - This is deprecated and has no effect. Do not use. - // "NO_ATTR" - This is deprecated and has no effect. Do not use. - // "REGION" - This is deprecated and has no effect. Do not use. - // "SERVICE" - This is deprecated and has no effect. Do not use. - Sys string `json:"sys,omitempty"` - // Values: This is deprecated and has no effect. Do not use. - Values []string `json:"values,omitempty"` - // ForceSendFields is a list of field names (e.g. "Iam") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Iam") to include in API requests - // with the JSON null value. By default, fields with empty values are omitted - // from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s Condition) MarshalJSON() ([]byte, error) { - type NoMethod Condition - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // ConfidentialInstanceConfig: A set of Confidential Instance options. type ConfidentialInstanceConfig struct { // ConfidentialInstanceType: Defines the type of technology used by the @@ -19817,8 +19762,8 @@ type InstanceGroupManager struct { // Name: The name of the managed instance group. The name must be 1-63 // characters long, and comply with RFC1035. Name string `json:"name,omitempty"` - // NamedPorts: Named ports configured for the Instance Groups complementary to - // this Instance Group Manager. + // NamedPorts: [Output Only] Named ports configured on the Instance Groups + // complementary to this Instance Group Manager. NamedPorts []*NamedPort `json:"namedPorts,omitempty"` // Params: Input only. Additional params passed with the request, but not // persisted as part of resource payload. @@ -30099,138 +30044,6 @@ func (s LocationPolicyLocationConstraints) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// LogConfig: This is deprecated and has no effect. Do not use. -type LogConfig struct { - // CloudAudit: This is deprecated and has no effect. Do not use. - CloudAudit *LogConfigCloudAuditOptions `json:"cloudAudit,omitempty"` - // Counter: This is deprecated and has no effect. Do not use. - Counter *LogConfigCounterOptions `json:"counter,omitempty"` - // DataAccess: This is deprecated and has no effect. Do not use. - DataAccess *LogConfigDataAccessOptions `json:"dataAccess,omitempty"` - // ForceSendFields is a list of field names (e.g. "CloudAudit") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "CloudAudit") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s LogConfig) MarshalJSON() ([]byte, error) { - type NoMethod LogConfig - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// LogConfigCloudAuditOptions: This is deprecated and has no effect. Do not -// use. -type LogConfigCloudAuditOptions struct { - // LogName: This is deprecated and has no effect. Do not use. - // - // Possible values: - // "ADMIN_ACTIVITY" - This is deprecated and has no effect. Do not use. - // "DATA_ACCESS" - This is deprecated and has no effect. Do not use. - // "UNSPECIFIED_LOG_NAME" - This is deprecated and has no effect. Do not use. - LogName string `json:"logName,omitempty"` - // ForceSendFields is a list of field names (e.g. "LogName") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "LogName") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s LogConfigCloudAuditOptions) MarshalJSON() ([]byte, error) { - type NoMethod LogConfigCloudAuditOptions - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// LogConfigCounterOptions: This is deprecated and has no effect. Do not use. -type LogConfigCounterOptions struct { - // CustomFields: This is deprecated and has no effect. Do not use. - CustomFields []*LogConfigCounterOptionsCustomField `json:"customFields,omitempty"` - // Field: This is deprecated and has no effect. Do not use. - Field string `json:"field,omitempty"` - // Metric: This is deprecated and has no effect. Do not use. - Metric string `json:"metric,omitempty"` - // ForceSendFields is a list of field names (e.g. "CustomFields") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "CustomFields") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s LogConfigCounterOptions) MarshalJSON() ([]byte, error) { - type NoMethod LogConfigCounterOptions - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// LogConfigCounterOptionsCustomField: This is deprecated and has no effect. Do -// not use. -type LogConfigCounterOptionsCustomField struct { - // Name: This is deprecated and has no effect. Do not use. - Name string `json:"name,omitempty"` - // Value: This is deprecated and has no effect. Do not use. - Value string `json:"value,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 LogConfigCounterOptionsCustomField) MarshalJSON() ([]byte, error) { - type NoMethod LogConfigCounterOptionsCustomField - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// LogConfigDataAccessOptions: This is deprecated and has no effect. Do not -// use. -type LogConfigDataAccessOptions struct { - // LogMode: This is deprecated and has no effect. Do not use. - // - // Possible values: - // "LOG_FAIL_CLOSED" - This is deprecated and has no effect. Do not use. - // "LOG_MODE_UNSPECIFIED" - This is deprecated and has no effect. Do not use. - LogMode string `json:"logMode,omitempty"` - // ForceSendFields is a list of field names (e.g. "LogMode") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "LogMode") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s LogConfigDataAccessOptions) MarshalJSON() ([]byte, error) { - type NoMethod LogConfigDataAccessOptions - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // MachineImage: Represents a machine image resource. A machine image is a // Compute Engine resource that stores all the configuration, metadata, // permissions, and data from one or more disks required to create a Virtual @@ -34509,11 +34322,13 @@ type NetworkInterface struct { // Possible values: // "GVNIC" - GVNIC // "IDPF" - IDPF + // "IRDMA" - IRDMA + // "MRDMA" - MRDMA // "UNSPECIFIED_NIC_TYPE" - No type specified. // "VIRTIO_NET" - VIRTIO NicType string `json:"nicType,omitempty"` - // ParentNicName: Name of the parent network interface of a VLAN based nic. If - // this field is specified, vlan must be set. + // ParentNicName: Name of the parent network interface of a dynamic network + // interface. ParentNicName string `json:"parentNicName,omitempty"` // QueueCount: The networking queue count that's specified by users for the // network interface. Both Rx and Tx queues will be set to this number. It'll @@ -34543,9 +34358,8 @@ type NetworkInterface struct { // https://www.googleapis.com/compute/v1/projects/project/regions/region // /subnetworks/subnetwork - regions/region/subnetworks/subnetwork Subnetwork string `json:"subnetwork,omitempty"` - // Vlan: VLAN tag of a VLAN based network interface, must be in range from 2 to - // 4094 inclusively. This field is mandatory if the parent network interface - // name is set. + // Vlan: VLAN tag of a dynamic network interface, must be in range from 2 to + // 4094 inclusively. Vlan int64 `json:"vlan,omitempty"` // ForceSendFields is a list of field names (e.g. "AccessConfigs") to // unconditionally include in API requests. By default, fields with empty or @@ -34890,6 +34704,8 @@ type NetworkProfile struct { // Kind: [Output Only] Type of the resource. Always compute#networkProfile for // network profiles. Kind string `json:"kind,omitempty"` + // Location: [Output Only] Location to which the network is restricted. + Location *NetworkProfileLocation `json:"location,omitempty"` // Name: [Output Only] Name of the resource. Name string `json:"name,omitempty"` // SelfLink: [Output Only] Server-defined URL for the resource. @@ -34920,6 +34736,30 @@ func (s NetworkProfile) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type NetworkProfileLocation struct { + Name string `json:"name,omitempty"` + // Possible values: + // "REGION" + // "ZONE" + Scope string `json:"scope,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 NetworkProfileLocation) MarshalJSON() ([]byte, error) { + type NoMethod NetworkProfileLocation + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type NetworkProfileNetworkFeatures struct { // AddressPurposes: Specifies what address purposes are supported. If empty, // all address purposes are supported. @@ -35055,29 +34895,30 @@ type NetworkProfileNetworkFeatures struct { // "VPN_ALLOWED" // "VPN_BLOCKED" AllowVpn string `json:"allowVpn,omitempty"` - // AllowedSubnetPurposes: Specifies which subnetwork purposes are supported. - // - // Possible values: - // "SUBNET_PURPOSE_CUSTOM_HARDWARE" - // "SUBNET_PURPOSE_PRIVATE" - AllowedSubnetPurposes []string `json:"allowedSubnetPurposes,omitempty"` - // AllowedSubnetStackTypes: Specifies which subnetwork stack types are - // supported. - // - // Possible values: - // "SUBNET_STACK_TYPE_IPV4_IPV6" - // "SUBNET_STACK_TYPE_IPV4_ONLY" - // "SUBNET_STACK_TYPE_IPV6_ONLY" - AllowedSubnetStackTypes []string `json:"allowedSubnetStackTypes,omitempty"` // InterfaceTypes: If set, limits the interface types that the network // supports. If empty, all interface types are supported. // // Possible values: // "GVNIC" - GVNIC // "IDPF" - IDPF + // "IRDMA" - IRDMA + // "MRDMA" - MRDMA // "UNSPECIFIED_NIC_TYPE" - No type specified. // "VIRTIO_NET" - VIRTIO InterfaceTypes []string `json:"interfaceTypes,omitempty"` + // SubnetPurposes: Specifies which subnetwork purposes are supported. + // + // Possible values: + // "SUBNET_PURPOSE_CUSTOM_HARDWARE" + // "SUBNET_PURPOSE_PRIVATE" + SubnetPurposes []string `json:"subnetPurposes,omitempty"` + // SubnetStackTypes: Specifies which subnetwork stack types are supported. + // + // Possible values: + // "SUBNET_STACK_TYPE_IPV4_IPV6" + // "SUBNET_STACK_TYPE_IPV4_ONLY" + // "SUBNET_STACK_TYPE_IPV6_ONLY" + SubnetStackTypes []string `json:"subnetStackTypes,omitempty"` // Unicast: Specifies which type of unicast is supported. // // Possible values: @@ -40122,8 +39963,6 @@ type Policy struct { // you to overwrite a version `3` policy with a version `1` policy, and all of // the conditions in the version `3` policy are lost. Etag string `json:"etag,omitempty"` - // Rules: This is deprecated and has no effect. Do not use. - Rules []*Rule `json:"rules,omitempty"` // Version: Specifies the format of the policy. Valid values are `0`, `1`, and // `3`. Requests that specify an invalid value are rejected. Any operation that // affects conditional role bindings must specify version `3`. This requirement @@ -45379,9 +45218,9 @@ type ReservationBlock struct { // Compute Engine. The name must be 1-63 characters long, and comply with // RFC1035 @pattern a-z (?:[-a-z0-9]{0,61}[a-z0-9])? Name string `json:"name,omitempty"` - // PhysicalHostTopology: [Output Only] The physical topology of the reservation + // PhysicalTopology: [Output Only] The physical topology of the reservation // block. - PhysicalHostTopology *ReservationBlockPhysicalTopology `json:"physicalHostTopology,omitempty"` + PhysicalTopology *ReservationBlockPhysicalTopology `json:"physicalTopology,omitempty"` // ReservationMaintenance: [Output Only] Maintenance information for this // reservation block. ReservationMaintenance *GroupMaintenanceInfo `json:"reservationMaintenance,omitempty"` @@ -47047,8 +46886,11 @@ type ResourceStatus struct { LastInstanceTerminationDetails *ResourceStatusLastInstanceTerminationDetails `json:"lastInstanceTerminationDetails,omitempty"` // PhysicalHost: [Output Only] An opaque ID of the host on which the VM is // running. - PhysicalHost string `json:"physicalHost,omitempty"` - Scheduling *ResourceStatusScheduling `json:"scheduling,omitempty"` + PhysicalHost string `json:"physicalHost,omitempty"` + // PhysicalHostTopology: [Output Only] The physical host topology of the host + // on which the VM is running. + PhysicalHostTopology *ResourceStatusPhysicalHostTopology `json:"physicalHostTopology,omitempty"` + Scheduling *ResourceStatusScheduling `json:"scheduling,omitempty"` // ServiceIntegrationStatuses: [Output Only] Represents the status of the // service integration specs defined by the user in // instance.serviceIntegrationSpecs. @@ -47189,6 +47031,31 @@ func (s ResourceStatusLastInstanceTerminationDetails) MarshalJSON() ([]byte, err return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ResourceStatusPhysicalHostTopology: Represents the physical host topology of +// the host on which the VM is running. +type ResourceStatusPhysicalHostTopology struct { + Block string `json:"block,omitempty"` + Cluster string `json:"cluster,omitempty"` + Host string `json:"host,omitempty"` + Subblock string `json:"subblock,omitempty"` + // ForceSendFields is a list of field names (e.g. "Block") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Block") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ResourceStatusPhysicalHostTopology) MarshalJSON() ([]byte, error) { + type NoMethod ResourceStatusPhysicalHostTopology + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type ResourceStatusScheduling struct { // AvailabilityDomain: Specifies the availability domain to place the instance // in. The value must be a number between 1 and the number of availability @@ -49969,48 +49836,6 @@ func (s RoutersScopedListWarningData) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Rule: This is deprecated and has no effect. Do not use. -type Rule struct { - // Action: This is deprecated and has no effect. Do not use. - // - // Possible values: - // "ALLOW" - This is deprecated and has no effect. Do not use. - // "ALLOW_WITH_LOG" - This is deprecated and has no effect. Do not use. - // "DENY" - This is deprecated and has no effect. Do not use. - // "DENY_WITH_LOG" - This is deprecated and has no effect. Do not use. - // "LOG" - This is deprecated and has no effect. Do not use. - // "NO_ACTION" - This is deprecated and has no effect. Do not use. - Action string `json:"action,omitempty"` - // Conditions: This is deprecated and has no effect. Do not use. - Conditions []*Condition `json:"conditions,omitempty"` - // Description: This is deprecated and has no effect. Do not use. - Description string `json:"description,omitempty"` - // Ins: This is deprecated and has no effect. Do not use. - Ins []string `json:"ins,omitempty"` - // LogConfigs: This is deprecated and has no effect. Do not use. - LogConfigs []*LogConfig `json:"logConfigs,omitempty"` - // NotIns: This is deprecated and has no effect. Do not use. - NotIns []string `json:"notIns,omitempty"` - // Permissions: This is deprecated and has no effect. Do not use. - Permissions []string `json:"permissions,omitempty"` - // ForceSendFields is a list of field names (e.g. "Action") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Action") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s Rule) MarshalJSON() ([]byte, error) { - type NoMethod Rule - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - type SSLHealthCheck struct { // Port: The TCP port number to which the health check prober sends packets. // The default value is 443. Valid values are 1 through 65535. @@ -50361,6 +50186,12 @@ type Scheduling struct { // "STANDARD" - Standard provisioning with user controlled runtime, no // discounts. ProvisioningModel string `json:"provisioningModel,omitempty"` + // ShutdownTimeout: Timeout between GCE ACPI G2 Soft Off and ACPI G3 Mechanical + // Off during shutdown operation of VM. For Standard VMs values between 0s and + // 120s are allowed. For Spot and Preemptible VMs supported values are between + // 0s and 30s. If no value is specified for shutdownDuration, default values + // are 90s for Standard VMs and 30s for Spot/Preemptible VMs. + ShutdownTimeout *Duration `json:"shutdownTimeout,omitempty"` // TerminationTime: Specifies the timestamp, when the instance will be // terminated, in RFC3339 text format. If specified, the instance termination // action will be performed at the termination time. @@ -57667,7 +57498,7 @@ type Subnetwork struct { // VMs in this subnet to Google services. PrivateIpv6GoogleAccess string `json:"privateIpv6GoogleAccess,omitempty"` // Purpose: The purpose of the resource. This field can be either PRIVATE, - // GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, PRIVATE_SERVICE_CONNECT, or + // GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, or PRIVATE_SERVICE_CONNECT. // PRIVATE is the default purpose for user-created subnets or subnets that are // automatically created in auto mode networks. Subnets with purpose set to // GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks @@ -64043,7 +63874,7 @@ type UsableSubnetwork struct { // Network: Network URL. Network string `json:"network,omitempty"` // Purpose: The purpose of the resource. This field can be either PRIVATE, - // GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, PRIVATE_SERVICE_CONNECT, or + // GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, or PRIVATE_SERVICE_CONNECT. // PRIVATE is the default purpose for user-created subnets or subnets that are // automatically created in auto mode networks. Subnets with purpose set to // GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks diff --git a/compute/v0.alpha/compute2-gen.go b/compute/v0.alpha/compute2-gen.go index a9156504f76..790d9f67b34 100644 --- a/compute/v0.alpha/compute2-gen.go +++ b/compute/v0.alpha/compute2-gen.go @@ -34543,7 +34543,8 @@ type InstancesAddNetworkInterfaceCall struct { header_ http.Header } -// AddNetworkInterface: Adds a network interface to an instance. +// AddNetworkInterface: Adds one dynamic network interface to an active +// instance. // // - instance: The instance name for this request stored as resource_id. Name // should conform to RFC1035 or be an unsigned long integer. @@ -35531,16 +35532,15 @@ type InstancesDeleteNetworkInterfaceCall struct { header_ http.Header } -// DeleteNetworkInterface: Deletes one network interface from an active +// DeleteNetworkInterface: Deletes one dynamic network interface from an active // instance. InstancesDeleteNetworkInterfaceRequest indicates: - instance from -// which to delete, using project+zone+resource_id fields; - network interface -// to be deleted, using network_interface_name field; Only VLAN interface -// deletion is supported for now. +// which to delete, using project+zone+resource_id fields; - dynamic network +// interface to be deleted, using network_interface_name field; // // - instance: The instance name for this request stored as resource_id. Name // should conform to RFC1035 or be an unsigned long integer. -// - networkInterfaceName: The name of the network interface to be deleted from -// the instance. Only VLAN network interface deletion is supported. +// - networkInterfaceName: The name of the dynamic network interface to be +// deleted from the instance. // - project: Project ID for this request. // - zone: The name of the zone for this request. func (r *InstancesService) DeleteNetworkInterface(project string, zone string, instance string, networkInterfaceName string) *InstancesDeleteNetworkInterfaceCall { @@ -36552,7 +36552,9 @@ func (c *InstancesGetSerialPortOutputCall) Port(port int64) *InstancesGetSerialP // adjusted start position is returned as the `start` property value. You can // also provide a negative start position, which translates to the most recent // number of bytes written to the serial port. For example, -3 is interpreted -// as the most recent 3 bytes written to the serial console. +// as the most recent 3 bytes written to the serial console. Note that the +// negative start is bounded by the retained buffer size, and the returned +// serial console output will not exceed the max buffer size. func (c *InstancesGetSerialPortOutputCall) Start(start int64) *InstancesGetSerialPortOutputCall { c.urlParams_.Set("start", fmt.Sprint(start)) return c @@ -65766,6 +65768,192 @@ func (c *OrganizationSecurityPoliciesListAssociationsCall) Do(opts ...googleapi. return ret, nil } +type OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall struct { + s *Service + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// ListPreconfiguredExpressionSets: Gets the current list of preconfigured Web +// Application Firewall (WAF) expressions. +func (r *OrganizationSecurityPoliciesService) ListPreconfiguredExpressionSets() *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall { + c := &OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + 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 *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall) Filter(filter string) *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall { + 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 *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall) MaxResults(maxResults int64) *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall { + 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 *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall) OrderBy(orderBy string) *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall { + 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 *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall) PageToken(pageToken string) *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// ParentId sets the optional parameter "parentId": Parent ID for this request. +func (c *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall) ParentId(parentId string) *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall { + c.urlParams_.Set("parentId", parentId) + 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 *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall) ReturnPartialSuccess(returnPartialSuccess bool) *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall { + 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 *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall) Fields(s ...googleapi.Field) *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall { + 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 *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall) IfNoneMatch(entityTag string) *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall) Context(ctx context.Context) *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall { + 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 *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall) 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, "locations/global/securityPolicies/listPreconfiguredExpressionSets") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.organizationSecurityPolicies.listPreconfiguredExpressionSets" call. +// Any non-2xx status code is an error. Response headers are in either +// *SecurityPoliciesListPreconfiguredExpressionSetsResponse.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 *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall) Do(opts ...googleapi.CallOption) (*SecurityPoliciesListPreconfiguredExpressionSetsResponse, 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 := &SecurityPoliciesListPreconfiguredExpressionSetsResponse{ + 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 OrganizationSecurityPoliciesMoveCall struct { s *Service securityPolicy string diff --git a/compute/v0.beta/compute-api.json b/compute/v0.beta/compute-api.json index 522b717b3f6..d90fc1ab638 100644 --- a/compute/v0.beta/compute-api.json +++ b/compute/v0.beta/compute-api.json @@ -11842,7 +11842,7 @@ "type": "string" }, "start": { - "description": "Specifies the starting byte position of the output to return. To start with the first byte of output to the specified port, omit this field or set it to `0`. If the output for that byte position is available, this field matches the `start` parameter sent with the request. If the amount of serial console output exceeds the size of the buffer (1 MB), the oldest output is discarded and is no longer available. If the requested start position refers to discarded output, the start position is adjusted to the oldest output still available, and the adjusted start position is returned as the `start` property value. You can also provide a negative start position, which translates to the most recent number of bytes written to the serial port. For example, -3 is interpreted as the most recent 3 bytes written to the serial console.", + "description": "Specifies the starting byte position of the output to return. To start with the first byte of output to the specified port, omit this field or set it to `0`. If the output for that byte position is available, this field matches the `start` parameter sent with the request. If the amount of serial console output exceeds the size of the buffer (1 MB), the oldest output is discarded and is no longer available. If the requested start position refers to discarded output, the start position is adjusted to the oldest output still available, and the adjusted start position is returned as the `start` property value. You can also provide a negative start position, which translates to the most recent number of bytes written to the serial port. For example, -3 is interpreted as the most recent 3 bytes written to the serial console. Note that the negative start is bounded by the retained buffer size, and the returned serial console output will not exceed the max buffer size.", "format": "int64", "location": "query", "type": "string" @@ -20482,6 +20482,56 @@ "https://www.googleapis.com/auth/compute.readonly" ] }, + "listPreconfiguredExpressionSets": { + "description": "Gets the current list of preconfigured Web Application Firewall (WAF) expressions.", + "flatPath": "locations/global/securityPolicies/listPreconfiguredExpressionSets", + "httpMethod": "GET", + "id": "compute.organizationSecurityPolicies.listPreconfiguredExpressionSets", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the 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" + }, + "parentId": { + "description": "Parent ID for this request.", + "location": "query", + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial 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": "locations/global/securityPolicies/listPreconfiguredExpressionSets", + "response": { + "$ref": "SecurityPoliciesListPreconfiguredExpressionSetsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, "move": { "description": "Moves the specified security policy.", "flatPath": "locations/global/securityPolicies/{securityPolicy}/move", @@ -32172,6 +32222,125 @@ } } }, + "reservationBlocks": { + "methods": { + "get": { + "description": "Retrieves information about the specified reservation block.", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservation}/reservationBlocks/{reservationBlock}", + "httpMethod": "GET", + "id": "compute.reservationBlocks.get", + "parameterOrder": [ + "project", + "zone", + "reservation", + "reservationBlock" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "required": true, + "type": "string" + }, + "reservation": { + "description": "The name of the reservation. Name should conform to RFC1035 or be a resource ID.", + "location": "path", + "required": true, + "type": "string" + }, + "reservationBlock": { + "description": "The name of the reservation block. Name should conform to RFC1035 or be a resource ID.", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request. Zone name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/reservations/{reservation}/reservationBlocks/{reservationBlock}", + "response": { + "$ref": "ReservationBlocksGetResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "list": { + "description": "Retrieves a list of reservation blocks under a single reservation.", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservation}/reservationBlocks", + "httpMethod": "GET", + "id": "compute.reservationBlocks.list", + "parameterOrder": [ + "project", + "zone", + "reservation" + ], + "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", + "required": true, + "type": "string" + }, + "reservation": { + "description": "The name of the reservation. Name should conform to RFC1035 or be a resource ID.", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "Name of the zone for this request. Zone name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/reservations/{reservation}/reservationBlocks", + "response": { + "$ref": "ReservationBlocksListResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + } + } + }, "reservations": { "methods": { "aggregatedList": { @@ -42526,7 +42695,7 @@ } } }, - "revision": "20241008", + "revision": "20241021", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -43909,6 +44078,15 @@ "description": "[Output Only] Contains output only fields.", "id": "AllocationResourceStatus", "properties": { + "reservationBlockCount": { + "description": "The number of reservation blocks associated with this reservation.", + "format": "int32", + "type": "integer" + }, + "reservationMaintenance": { + "$ref": "GroupMaintenanceInfo", + "description": "Maintenance information for this reservation" + }, "specificSkuAllocation": { "$ref": "AllocationResourceStatusSpecificSKUAllocation", "description": "Allocation Properties of this reservation." @@ -44318,7 +44496,7 @@ "type": "object" }, "AuditConfig": { - "description": "Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { \"audit_configs\": [ { \"service\": \"allServices\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\", \"exempted_members\": [ \"user:jose@example.com\" ] }, { \"log_type\": \"DATA_WRITE\" }, { \"log_type\": \"ADMIN_READ\" } ] }, { \"service\": \"sampleservice.googleapis.com\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\" }, { \"log_type\": \"DATA_WRITE\", \"exempted_members\": [ \"user:aliya@example.com\" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts jose@example.com from DATA_READ logging, and aliya@example.com from DATA_WRITE logging.", + "description": "Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { \"audit_configs\": [ { \"service\": \"allServices\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\", \"exempted_members\": [ \"user:jose@example.com\" ] }, { \"log_type\": \"DATA_WRITE\" }, { \"log_type\": \"ADMIN_READ\" } ] }, { \"service\": \"sampleservice.googleapis.com\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\" }, { \"log_type\": \"DATA_WRITE\", \"exempted_members\": [ \"user:aliya@example.com\" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts `jose@example.com` from DATA_READ logging, and `aliya@example.com` from DATA_WRITE logging.", "id": "AuditConfig", "properties": { "auditLogConfigs": { @@ -45364,7 +45542,7 @@ "description": "The CacheKeyPolicy for this CdnPolicy." }, "cacheMode": { - "description": "Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached.", + "description": "Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached. If no value is provided for cdnPolicy.cacheMode, it defaults to CACHE_ALL_STATIC.", "enum": [ "CACHE_ALL_STATIC", "FORCE_CACHE_ALL", @@ -46174,7 +46352,7 @@ "description": "The CacheKeyPolicy for this CdnPolicy." }, "cacheMode": { - "description": "Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached.", + "description": "Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached. If no value is provided for cdnPolicy.cacheMode, it defaults to CACHE_ALL_STATIC.", "enum": [ "CACHE_ALL_STATIC", "FORCE_CACHE_ALL", @@ -47300,10 +47478,6 @@ "description": "Associates `members`, or principals, with a `role`.", "id": "Binding", "properties": { - "bindingId": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string" - }, "condition": { "$ref": "Expr", "description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)." @@ -48189,86 +48363,6 @@ }, "type": "object" }, - "Condition": { - "description": "This is deprecated and has no effect. Do not use.", - "id": "Condition", - "properties": { - "iam": { - "description": "This is deprecated and has no effect. Do not use.", - "enum": [ - "APPROVER", - "ATTRIBUTION", - "AUTHORITY", - "CREDENTIALS_TYPE", - "CREDS_ASSERTION", - "JUSTIFICATION_TYPE", - "NO_ATTR", - "SECURITY_REALM" - ], - "enumDescriptions": [ - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use." - ], - "type": "string" - }, - "op": { - "description": "This is deprecated and has no effect. Do not use.", - "enum": [ - "DISCHARGED", - "EQUALS", - "IN", - "NOT_EQUALS", - "NOT_IN", - "NO_OP" - ], - "enumDescriptions": [ - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use." - ], - "type": "string" - }, - "svc": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string" - }, - "sys": { - "description": "This is deprecated and has no effect. Do not use.", - "enum": [ - "IP", - "NAME", - "NO_ATTR", - "REGION", - "SERVICE" - ], - "enumDescriptions": [ - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use." - ], - "type": "string" - }, - "values": { - "description": "This is deprecated and has no effect. Do not use.", - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "ConfidentialInstanceConfig": { "description": "A set of Confidential Instance options.", "id": "ConfidentialInstanceConfig", @@ -52224,15 +52318,47 @@ "description": "[Output Only] The creation timestamp for this future reservation in RFC3339 text format.", "type": "string" }, + "deploymentType": { + "description": "Type of the deployment requested as part of future reservation.", + "enum": [ + "DENSE", + "DEPLOYMENT_TYPE_UNSPECIFIED", + "FLEXIBLE" + ], + "enumDescriptions": [ + "The reserved capacity is made up of densely deployed reservation blocks.", + "", + "The reserved capacity is made up of highly flexible, logical reservation blocks." + ], + "type": "string" + }, "description": { "description": "An optional description of this resource. Provide this property when you create the future reservation.", "type": "string" }, + "enableOpportunisticMaintenance": { + "description": "Indicates if this group of VMs have opportunistic maintenance enabled. This will be set on the FR by customers, and will be used for reservation and reservation block maintenance .", + "type": "boolean" + }, "id": { "description": "[Output Only] A unique identifier for this future reservation. The server defines this identifier.", "format": "uint64", "type": "string" }, + "instanceTerminationAction": { + "description": "Action to take during reservation termination.", + "enum": [ + "DELETE", + "INSTANCE_TERMINATION_ACTION_UNSPECIFIED", + "STOP" + ], + "enumDescriptions": [ + "Delete the VM.", + "Default value. This value is unused.", + "Stop the VM without storing in-memory content. default action." + ], + "type": "string" + }, "kind": { "default": "compute#futureReservation", "description": "[Output Only] Type of the resource. Always compute#futureReservation for future reservations.", @@ -52266,6 +52392,24 @@ ], "type": "string" }, + "reservationName": { + "description": "Name of reservations where the capacity is provisioned at the time of delivery of future reservations. If the reservation with the given name does not exist already, it is created automatically at the time of Approval with INACTIVE state till specified start-time. Either provide the reservation_name or a name_prefix.", + "type": "string" + }, + "schedulingType": { + "description": "Maintenance information for this reservation", + "enum": [ + "GROUPED", + "GROUP_MAINTENANCE_TYPE_UNSPECIFIED", + "INDEPENDENT" + ], + "enumDescriptions": [ + "Maintenance on all reserved instances in the reservation is synchronized.", + "Unknown maintenance type.", + "Maintenance is not synchronized for this reservation. Instead, each instance has its own maintenance window." + ], + "type": "string" + }, "selfLink": { "description": "[Output Only] Server-defined fully-qualified URL for this resource.", "type": "string" @@ -52278,6 +52422,10 @@ "$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.", + "type": "boolean" + }, "specificSkuProperties": { "$ref": "FutureReservationSpecificSKUProperties", "description": "Future Reservation configuration to indicate instance properties and total count." @@ -53115,6 +53263,45 @@ }, "type": "object" }, + "GroupMaintenanceInfo": { + "description": "Maintenance Info for ReservationBlocks.", + "id": "GroupMaintenanceInfo", + "properties": { + "enableOpportunisticMaintenance": { + "description": "This setting enables or disables opportunistic maintenance. If enabled, maintenance is performed on unused reservations whenever possible.", + "type": "boolean" + }, + "maintenanceOngoingCount": { + "description": "Progress for ongoing maintenance for this group of VMs/hosts. Describes number of hosts in the block that have ongoing maintenance.", + "format": "int32", + "type": "integer" + }, + "maintenancePendingCount": { + "description": "Progress for ongoing maintenance for this group of VMs/hosts. Describes number of hosts in the block that have pending maintenance.", + "format": "int32", + "type": "integer" + }, + "schedulingType": { + "description": "The type of maintenance for the reservation.", + "enum": [ + "GROUPED", + "GROUP_MAINTENANCE_TYPE_UNSPECIFIED", + "INDEPENDENT" + ], + "enumDescriptions": [ + "Maintenance on all reserved instances in the reservation is synchronized.", + "Unknown maintenance type.", + "Maintenance is not synchronized for this reservation. Instead, each instance has its own maintenance window." + ], + "type": "string" + }, + "upcomingGroupMaintenance": { + "$ref": "UpcomingMaintenance", + "description": "Maintenance information on this group of VMs." + } + }, + "type": "object" + }, "GuestAttributes": { "description": "A guest attributes entry.", "id": "GuestAttributes", @@ -56634,7 +56821,7 @@ "type": "string" }, "namedPorts": { - "description": "Named ports configured for the Instance Groups complementary to this Instance Group Manager.", + "description": "[Output Only] Named ports configured on the Instance Groups complementary to this Instance Group Manager.", "items": { "$ref": "NamedPort" }, @@ -63584,102 +63771,6 @@ }, "type": "object" }, - "LogConfig": { - "description": "This is deprecated and has no effect. Do not use.", - "id": "LogConfig", - "properties": { - "cloudAudit": { - "$ref": "LogConfigCloudAuditOptions", - "description": "This is deprecated and has no effect. Do not use." - }, - "counter": { - "$ref": "LogConfigCounterOptions", - "description": "This is deprecated and has no effect. Do not use." - }, - "dataAccess": { - "$ref": "LogConfigDataAccessOptions", - "description": "This is deprecated and has no effect. Do not use." - } - }, - "type": "object" - }, - "LogConfigCloudAuditOptions": { - "description": "This is deprecated and has no effect. Do not use.", - "id": "LogConfigCloudAuditOptions", - "properties": { - "logName": { - "description": "This is deprecated and has no effect. Do not use.", - "enum": [ - "ADMIN_ACTIVITY", - "DATA_ACCESS", - "UNSPECIFIED_LOG_NAME" - ], - "enumDescriptions": [ - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use." - ], - "type": "string" - } - }, - "type": "object" - }, - "LogConfigCounterOptions": { - "description": "This is deprecated and has no effect. Do not use.", - "id": "LogConfigCounterOptions", - "properties": { - "customFields": { - "description": "This is deprecated and has no effect. Do not use.", - "items": { - "$ref": "LogConfigCounterOptionsCustomField" - }, - "type": "array" - }, - "field": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string" - }, - "metric": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string" - } - }, - "type": "object" - }, - "LogConfigCounterOptionsCustomField": { - "description": "This is deprecated and has no effect. Do not use.", - "id": "LogConfigCounterOptionsCustomField", - "properties": { - "name": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string" - }, - "value": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string" - } - }, - "type": "object" - }, - "LogConfigDataAccessOptions": { - "description": "This is deprecated and has no effect. Do not use.", - "id": "LogConfigDataAccessOptions", - "properties": { - "logMode": { - "description": "This is deprecated and has no effect. Do not use.", - "enum": [ - "LOG_FAIL_CLOSED", - "LOG_MODE_UNSPECIFIED" - ], - "enumDescriptions": [ - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use." - ], - "type": "string" - } - }, - "type": "object" - }, "MachineImage": { "description": "Represents a machine image resource. A machine image is a Compute Engine resource that stores all the configuration, metadata, permissions, and data from one or more disks required to create a Virtual machine (VM) instance. For more information, see Machine images.", "id": "MachineImage", @@ -67226,12 +67317,16 @@ "enum": [ "GVNIC", "IDPF", + "IRDMA", + "MRDMA", "UNSPECIFIED_NIC_TYPE", "VIRTIO_NET" ], "enumDescriptions": [ "GVNIC", "IDPF", + "IRDMA", + "MRDMA", "No type specified.", "VIRTIO" ], @@ -67530,6 +67625,10 @@ "description": "[Output Only] Type of the resource. Always compute#networkProfile for network profiles.", "type": "string" }, + "location": { + "$ref": "NetworkProfileLocation", + "description": "[Output Only] Location to which the network is restricted." + }, "name": { "description": "[Output Only] Name of the resource.", "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", @@ -67550,6 +67649,26 @@ }, "type": "object" }, + "NetworkProfileLocation": { + "id": "NetworkProfileLocation", + "properties": { + "name": { + "type": "string" + }, + "scope": { + "enum": [ + "REGION", + "ZONE" + ], + "enumDescriptions": [ + "", + "" + ], + "type": "string" + } + }, + "type": "object" + }, "NetworkProfileNetworkFeatures": { "id": "NetworkProfileNetworkFeatures", "properties": { @@ -67784,7 +67903,30 @@ ], "type": "string" }, - "allowedSubnetPurposes": { + "interfaceTypes": { + "description": "If set, limits the interface types that the network supports. If empty, all interface types are supported.", + "items": { + "enum": [ + "GVNIC", + "IDPF", + "IRDMA", + "MRDMA", + "UNSPECIFIED_NIC_TYPE", + "VIRTIO_NET" + ], + "enumDescriptions": [ + "GVNIC", + "IDPF", + "IRDMA", + "MRDMA", + "No type specified.", + "VIRTIO" + ], + "type": "string" + }, + "type": "array" + }, + "subnetPurposes": { "description": "Specifies which subnetwork purposes are supported.", "items": { "enum": [ @@ -67799,7 +67941,7 @@ }, "type": "array" }, - "allowedSubnetStackTypes": { + "subnetStackTypes": { "description": "Specifies which subnetwork stack types are supported.", "items": { "enum": [ @@ -67816,25 +67958,6 @@ }, "type": "array" }, - "interfaceTypes": { - "description": "If set, limits the interface types that the network supports. If empty, all interface types are supported.", - "items": { - "enum": [ - "GVNIC", - "IDPF", - "UNSPECIFIED_NIC_TYPE", - "VIRTIO_NET" - ], - "enumDescriptions": [ - "GVNIC", - "IDPF", - "No type specified.", - "VIRTIO" - ], - "type": "string" - }, - "type": "array" - }, "unicast": { "description": "Specifies which type of unicast is supported.", "enum": [ @@ -72076,13 +72199,6 @@ "format": "byte", "type": "string" }, - "rules": { - "description": "This is deprecated and has no effect. Do not use.", - "items": { - "$ref": "Rule" - }, - "type": "array" - }, "version": { "description": "Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", "format": "int32", @@ -75799,6 +75915,20 @@ "description": "Absolute time in future when the reservation will be auto-deleted by Compute Engine. Timestamp is represented in RFC3339 text format.", "type": "string" }, + "deploymentType": { + "description": "Specifies the deployment strategy for this reservation.", + "enum": [ + "DENSE", + "DEPLOYMENT_TYPE_UNSPECIFIED", + "FLEXIBLE" + ], + "enumDescriptions": [ + "The reserved capacity is made up of densely deployed reservation blocks.", + "", + "The reserved capacity is made up of highly flexible, logical reservation blocks." + ], + "type": "string" + }, "description": { "description": "An optional description of this resource. Provide this property when you create the resource.", "type": "string" @@ -75808,6 +75938,20 @@ "format": "uint64", "type": "string" }, + "instanceTerminationAction": { + "description": "Instance termination action is invoked when the reservation is deleted. This only applies to reservations with a Deployment type.", + "enum": [ + "DELETE", + "INSTANCE_TERMINATION_ACTION_UNSPECIFIED", + "STOP" + ], + "enumDescriptions": [ + "Delete the VM.", + "Default value. This value is unused.", + "Stop the VM without storing in-memory content. default action." + ], + "type": "string" + }, "kind": { "default": "compute#reservation", "description": "[Output Only] Type of the resource. Always compute#reservations for reservations.", @@ -76081,6 +76225,252 @@ }, "type": "object" }, + "ReservationBlock": { + "description": "Represents a reservation block resource.", + "id": "ReservationBlock", + "properties": { + "count": { + "description": "[Output Only] The number of resources that are allocated in this reservation block.", + "format": "int32", + "type": "integer" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "format": "uint64", + "type": "string" + }, + "inUseCount": { + "description": "[Output Only] The number of instances that are currently in use on this reservation block.", + "format": "int32", + "type": "integer" + }, + "kind": { + "default": "compute#reservationBlock", + "description": "[Output Only] Type of the resource. Always compute#reservationBlock for reservation blocks.", + "type": "string" + }, + "name": { + "description": "[Output Only] The name of this reservation block generated by Google Compute Engine. The name must be 1-63 characters long, and comply with RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "physicalTopology": { + "$ref": "ReservationBlockPhysicalTopology", + "description": "[Output Only] The physical topology of the reservation block." + }, + "reservationMaintenance": { + "$ref": "GroupMaintenanceInfo", + "description": "[Output Only] Maintenance information for this reservation block." + }, + "selfLink": { + "description": "[Output Only] Server-defined fully-qualified URL for this resource.", + "type": "string" + }, + "selfLinkWithId": { + "description": "[Output Only] Server-defined URL for this resource with the resource id.", + "type": "string" + }, + "status": { + "description": "[Output Only] Status of the reservation block.", + "enum": [ + "CREATING", + "DELETING", + "INVALID", + "READY" + ], + "enumDescriptions": [ + "Resources are being allocated for the reservation block.", + "Reservation block is currently being deleted.", + "", + "Reservation block has allocated all its resources." + ], + "type": "string" + }, + "zone": { + "description": "[Output Only] Zone in which the reservation block resides.", + "type": "string" + } + }, + "type": "object" + }, + "ReservationBlockPhysicalTopology": { + "id": "ReservationBlockPhysicalTopology", + "properties": { + "block": { + "description": "The hash of the capacity block within the cluster.", + "type": "string" + }, + "cluster": { + "description": "The cluster name of the reservation block.", + "type": "string" + } + }, + "type": "object" + }, + "ReservationBlocksGetResponse": { + "id": "ReservationBlocksGetResponse", + "properties": { + "resource": { + "$ref": "ReservationBlock" + } + }, + "type": "object" + }, + "ReservationBlocksListResponse": { + "description": "A list of reservation blocks under a single reservation.", + "id": "ReservationBlocksListResponse", + "properties": { + "id": { + "description": "Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of reservation block resources.", + "items": { + "$ref": "ReservationBlock" + }, + "type": "array" + }, + "kind": { + "default": "compute#reservationBlock", + "description": "Type of the resource. Always compute#reservationBlock for a list of reservation blocks.", + "type": "string" + }, + "nextPageToken": { + "description": "This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "Informational warning message.", + "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" + }, "ReservationList": { "id": "ReservationList", "properties": { @@ -77274,6 +77664,10 @@ "description": "[Output Only] An opaque ID of the host on which the VM is running.", "type": "string" }, + "physicalHostTopology": { + "$ref": "ResourceStatusPhysicalHostTopology", + "description": "[Output Only] The physical host topology of the host on which the VM is running." + }, "scheduling": { "$ref": "ResourceStatusScheduling" }, @@ -77283,6 +77677,25 @@ }, "type": "object" }, + "ResourceStatusPhysicalHostTopology": { + "description": "Represents the physical host topology of the host on which the VM is running.", + "id": "ResourceStatusPhysicalHostTopology", + "properties": { + "block": { + "type": "string" + }, + "cluster": { + "type": "string" + }, + "host": { + "type": "string" + }, + "subblock": { + "type": "string" + } + }, + "type": "object" + }, "ResourceStatusScheduling": { "id": "ResourceStatusScheduling", "properties": { @@ -79632,72 +80045,6 @@ }, "type": "object" }, - "Rule": { - "description": "This is deprecated and has no effect. Do not use.", - "id": "Rule", - "properties": { - "action": { - "description": "This is deprecated and has no effect. Do not use.", - "enum": [ - "ALLOW", - "ALLOW_WITH_LOG", - "DENY", - "DENY_WITH_LOG", - "LOG", - "NO_ACTION" - ], - "enumDescriptions": [ - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use." - ], - "type": "string" - }, - "conditions": { - "description": "This is deprecated and has no effect. Do not use.", - "items": { - "$ref": "Condition" - }, - "type": "array" - }, - "description": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string" - }, - "ins": { - "description": "This is deprecated and has no effect. Do not use.", - "items": { - "type": "string" - }, - "type": "array" - }, - "logConfigs": { - "description": "This is deprecated and has no effect. Do not use.", - "items": { - "$ref": "LogConfig" - }, - "type": "array" - }, - "notIns": { - "description": "This is deprecated and has no effect. Do not use.", - "items": { - "type": "string" - }, - "type": "array" - }, - "permissions": { - "description": "This is deprecated and has no effect. Do not use.", - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "SSLHealthCheck": { "id": "SSLHealthCheck", "properties": { @@ -86061,7 +86408,7 @@ "type": "string" }, "purpose": { - "description": "The purpose of the resource. This field can be either PRIVATE, GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, PRIVATE_SERVICE_CONNECT, or PRIVATE is the default purpose for user-created subnets or subnets that are automatically created in auto mode networks. Subnets with purpose set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks that are reserved for Envoy-based load balancers. A subnet with purpose set to PRIVATE_SERVICE_CONNECT is used to publish services using Private Service Connect. If unspecified, the subnet purpose defaults to PRIVATE. The enableFlowLogs field isn't supported if the subnet purpose field is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY.", + "description": "The purpose of the resource. This field can be either PRIVATE, GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, or PRIVATE_SERVICE_CONNECT. PRIVATE is the default purpose for user-created subnets or subnets that are automatically created in auto mode networks. Subnets with purpose set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks that are reserved for Envoy-based load balancers. A subnet with purpose set to PRIVATE_SERVICE_CONNECT is used to publish services using Private Service Connect. If unspecified, the subnet purpose defaults to PRIVATE. The enableFlowLogs field isn't supported if the subnet purpose field is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY.", "enum": [ "GLOBAL_MANAGED_PROXY", "INTERNAL_HTTPS_LOAD_BALANCER", @@ -91406,7 +91753,7 @@ "type": "string" }, "purpose": { - "description": "The purpose of the resource. This field can be either PRIVATE, GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, PRIVATE_SERVICE_CONNECT, or PRIVATE is the default purpose for user-created subnets or subnets that are automatically created in auto mode networks. Subnets with purpose set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks that are reserved for Envoy-based load balancers. A subnet with purpose set to PRIVATE_SERVICE_CONNECT is used to publish services using Private Service Connect. If unspecified, the subnet purpose defaults to PRIVATE. The enableFlowLogs field isn't supported if the subnet purpose field is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY.", + "description": "The purpose of the resource. This field can be either PRIVATE, GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, or PRIVATE_SERVICE_CONNECT. PRIVATE is the default purpose for user-created subnets or subnets that are automatically created in auto mode networks. Subnets with purpose set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks that are reserved for Envoy-based load balancers. A subnet with purpose set to PRIVATE_SERVICE_CONNECT is used to publish services using Private Service Connect. If unspecified, the subnet purpose defaults to PRIVATE. The enableFlowLogs field isn't supported if the subnet purpose field is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY.", "enum": [ "GLOBAL_MANAGED_PROXY", "INTERNAL_HTTPS_LOAD_BALANCER", diff --git a/compute/v0.beta/compute-gen.go b/compute/v0.beta/compute-gen.go index da9b04a7ed3..19c85218be3 100644 --- a/compute/v0.beta/compute-gen.go +++ b/compute/v0.beta/compute-gen.go @@ -241,6 +241,7 @@ func New(client *http.Client) (*Service, error) { s.RegionUrlMaps = NewRegionUrlMapsService(s) s.RegionZones = NewRegionZonesService(s) s.Regions = NewRegionsService(s) + s.ReservationBlocks = NewReservationBlocksService(s) s.Reservations = NewReservationsService(s) s.ResourcePolicies = NewResourcePoliciesService(s) s.Routers = NewRoutersService(s) @@ -433,6 +434,8 @@ type Service struct { Regions *RegionsService + ReservationBlocks *ReservationBlocksService + Reservations *ReservationsService ResourcePolicies *ResourcePoliciesService @@ -1204,6 +1207,15 @@ type RegionsService struct { s *Service } +func NewReservationBlocksService(s *Service) *ReservationBlocksService { + rs := &ReservationBlocksService{s: s} + return rs +} + +type ReservationBlocksService struct { + s *Service +} + func NewReservationsService(s *Service) *ReservationsService { rs := &ReservationsService{s: s} return rs @@ -2911,15 +2923,20 @@ func (s AllocationReservationSharingPolicy) MarshalJSON() ([]byte, error) { // AllocationResourceStatus: [Output Only] Contains output only fields. type AllocationResourceStatus struct { + // ReservationBlockCount: The number of reservation blocks associated with this + // reservation. + ReservationBlockCount int64 `json:"reservationBlockCount,omitempty"` + // ReservationMaintenance: Maintenance information for this reservation + ReservationMaintenance *GroupMaintenanceInfo `json:"reservationMaintenance,omitempty"` // SpecificSkuAllocation: Allocation Properties of this reservation. SpecificSkuAllocation *AllocationResourceStatusSpecificSKUAllocation `json:"specificSkuAllocation,omitempty"` - // ForceSendFields is a list of field names (e.g. "SpecificSkuAllocation") to + // ForceSendFields is a list of field names (e.g. "ReservationBlockCount") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "SpecificSkuAllocation") to + // NullFields is a list of field names (e.g. "ReservationBlockCount") to // include in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. @@ -3397,8 +3414,8 @@ func (s AttachedDiskInitializeParams) MarshalJSON() ([]byte, error) { // "audit_log_configs": [ { "log_type": "DATA_READ" }, { "log_type": // "DATA_WRITE", "exempted_members": [ "user:aliya@example.com" ] } ] } ] } For // sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ -// logging. It also exempts jose@example.com from DATA_READ logging, and -// aliya@example.com from DATA_WRITE logging. +// logging. It also exempts `jose@example.com` from DATA_READ logging, and +// `aliya@example.com` from DATA_WRITE logging. type AuditConfig struct { // AuditLogConfigs: The configuration for logging of each type of permission. AuditLogConfigs []*AuditLogConfig `json:"auditLogConfigs,omitempty"` @@ -4708,7 +4725,8 @@ type BackendBucketCdnPolicy struct { // identifiable) content. CACHE_ALL_STATIC Automatically cache static content, // including common image formats, media (video and audio), and web assets // (JavaScript and CSS). Requests and responses that are marked as uncacheable, - // as well as dynamic content (including HTML), will not be cached. + // as well as dynamic content (including HTML), will not be cached. If no value + // is provided for cdnPolicy.cacheMode, it defaults to CACHE_ALL_STATIC. // // Possible values: // "CACHE_ALL_STATIC" - Automatically cache static content, including common @@ -5758,7 +5776,8 @@ type BackendServiceCdnPolicy struct { // identifiable) content. CACHE_ALL_STATIC Automatically cache static content, // including common image formats, media (video and audio), and web assets // (JavaScript and CSS). Requests and responses that are marked as uncacheable, - // as well as dynamic content (including HTML), will not be cached. + // as well as dynamic content (including HTML), will not be cached. If no value + // is provided for cdnPolicy.cacheMode, it defaults to CACHE_ALL_STATIC. // // Possible values: // "CACHE_ALL_STATIC" - Automatically cache static content, including common @@ -7147,8 +7166,6 @@ func (s BgpRouteNetworkLayerReachabilityInformation) MarshalJSON() ([]byte, erro // Binding: Associates `members`, or principals, with a `role`. type Binding struct { - // BindingId: This is deprecated and has no effect. Do not use. - BindingId string `json:"bindingId,omitempty"` // Condition: The condition that is associated with this binding. If the // condition evaluates to `true`, then this binding applies to the current // request. If the condition evaluates to `false`, then this binding does not @@ -7228,13 +7245,13 @@ type Binding struct { // available pre-defined roles, see here // (https://cloud.google.com/iam/docs/understanding-roles). Role string `json:"role,omitempty"` - // ForceSendFields is a list of field names (e.g. "BindingId") to + // ForceSendFields is a list of field names (e.g. "Condition") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "BindingId") to include in API + // NullFields is a list of field names (e.g. "Condition") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. @@ -8166,61 +8183,6 @@ func (s CommitmentsScopedListWarningData) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Condition: This is deprecated and has no effect. Do not use. -type Condition struct { - // Iam: This is deprecated and has no effect. Do not use. - // - // Possible values: - // "APPROVER" - This is deprecated and has no effect. Do not use. - // "ATTRIBUTION" - This is deprecated and has no effect. Do not use. - // "AUTHORITY" - This is deprecated and has no effect. Do not use. - // "CREDENTIALS_TYPE" - This is deprecated and has no effect. Do not use. - // "CREDS_ASSERTION" - This is deprecated and has no effect. Do not use. - // "JUSTIFICATION_TYPE" - This is deprecated and has no effect. Do not use. - // "NO_ATTR" - This is deprecated and has no effect. Do not use. - // "SECURITY_REALM" - This is deprecated and has no effect. Do not use. - Iam string `json:"iam,omitempty"` - // Op: This is deprecated and has no effect. Do not use. - // - // Possible values: - // "DISCHARGED" - This is deprecated and has no effect. Do not use. - // "EQUALS" - This is deprecated and has no effect. Do not use. - // "IN" - This is deprecated and has no effect. Do not use. - // "NOT_EQUALS" - This is deprecated and has no effect. Do not use. - // "NOT_IN" - This is deprecated and has no effect. Do not use. - // "NO_OP" - This is deprecated and has no effect. Do not use. - Op string `json:"op,omitempty"` - // Svc: This is deprecated and has no effect. Do not use. - Svc string `json:"svc,omitempty"` - // Sys: This is deprecated and has no effect. Do not use. - // - // Possible values: - // "IP" - This is deprecated and has no effect. Do not use. - // "NAME" - This is deprecated and has no effect. Do not use. - // "NO_ATTR" - This is deprecated and has no effect. Do not use. - // "REGION" - This is deprecated and has no effect. Do not use. - // "SERVICE" - This is deprecated and has no effect. Do not use. - Sys string `json:"sys,omitempty"` - // Values: This is deprecated and has no effect. Do not use. - Values []string `json:"values,omitempty"` - // ForceSendFields is a list of field names (e.g. "Iam") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Iam") to include in API requests - // with the JSON null value. By default, fields with empty values are omitted - // from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s Condition) MarshalJSON() ([]byte, error) { - type NoMethod Condition - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // ConfidentialInstanceConfig: A set of Confidential Instance options. type ConfidentialInstanceConfig struct { // ConfidentialInstanceType: Defines the type of technology used by the @@ -12827,12 +12789,34 @@ type FutureReservation struct { // CreationTimestamp: [Output Only] The creation timestamp for this future // reservation in RFC3339 text format. CreationTimestamp string `json:"creationTimestamp,omitempty"` + // DeploymentType: Type of the deployment requested as part of future + // reservation. + // + // Possible values: + // "DENSE" - The reserved capacity is made up of densely deployed reservation + // blocks. + // "DEPLOYMENT_TYPE_UNSPECIFIED" + // "FLEXIBLE" - The reserved capacity is made up of highly flexible, logical + // reservation blocks. + DeploymentType string `json:"deploymentType,omitempty"` // Description: An optional description of this resource. Provide this property // when you create the future reservation. Description string `json:"description,omitempty"` + // EnableOpportunisticMaintenance: Indicates if this group of VMs have + // opportunistic maintenance enabled. This will be set on the FR by customers, + // and will be used for reservation and reservation block maintenance . + EnableOpportunisticMaintenance bool `json:"enableOpportunisticMaintenance,omitempty"` // Id: [Output Only] A unique identifier for this future reservation. The // server defines this identifier. Id uint64 `json:"id,omitempty,string"` + // InstanceTerminationAction: Action to take during reservation termination. + // + // Possible values: + // "DELETE" - Delete the VM. + // "INSTANCE_TERMINATION_ACTION_UNSPECIFIED" - Default value. This value is + // unused. + // "STOP" - Stop the VM without storing in-memory content. default action. + InstanceTerminationAction string `json:"instanceTerminationAction,omitempty"` // Kind: [Output Only] Type of the resource. Always compute#futureReservation // for future reservations. Kind string `json:"kind,omitempty"` @@ -12856,6 +12840,21 @@ type FutureReservation struct { // "PLANNING_STATUS_UNSPECIFIED" // "SUBMITTED" - Future Reservation has been submitted for evaluation by GCP. PlanningStatus string `json:"planningStatus,omitempty"` + // ReservationName: Name of reservations where the capacity is provisioned at + // the time of delivery of future reservations. If the reservation with the + // given name does not exist already, it is created automatically at the time + // of Approval with INACTIVE state till specified start-time. Either provide + // the reservation_name or a name_prefix. + ReservationName string `json:"reservationName,omitempty"` + // SchedulingType: Maintenance information for this reservation + // + // Possible values: + // "GROUPED" - Maintenance on all reserved instances in the reservation is + // synchronized. + // "GROUP_MAINTENANCE_TYPE_UNSPECIFIED" - Unknown maintenance type. + // "INDEPENDENT" - Maintenance is not synchronized for this reservation. + // Instead, each instance has its own maintenance window. + SchedulingType string `json:"schedulingType,omitempty"` // SelfLink: [Output Only] Server-defined fully-qualified URL for this // resource. SelfLink string `json:"selfLink,omitempty"` @@ -12864,6 +12863,11 @@ 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. + SpecificReservationRequired bool `json:"specificReservationRequired,omitempty"` // SpecificSkuProperties: Future Reservation configuration to indicate instance // properties and total count. SpecificSkuProperties *FutureReservationSpecificSKUProperties `json:"specificSkuProperties,omitempty"` @@ -13854,6 +13858,50 @@ func (s GlobalSetPolicyRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GroupMaintenanceInfo: Maintenance Info for ReservationBlocks. +type GroupMaintenanceInfo struct { + // EnableOpportunisticMaintenance: This setting enables or disables + // opportunistic maintenance. If enabled, maintenance is performed on unused + // reservations whenever possible. + EnableOpportunisticMaintenance bool `json:"enableOpportunisticMaintenance,omitempty"` + // MaintenanceOngoingCount: Progress for ongoing maintenance for this group of + // VMs/hosts. Describes number of hosts in the block that have ongoing + // maintenance. + MaintenanceOngoingCount int64 `json:"maintenanceOngoingCount,omitempty"` + // MaintenancePendingCount: Progress for ongoing maintenance for this group of + // VMs/hosts. Describes number of hosts in the block that have pending + // maintenance. + MaintenancePendingCount int64 `json:"maintenancePendingCount,omitempty"` + // SchedulingType: The type of maintenance for the reservation. + // + // Possible values: + // "GROUPED" - Maintenance on all reserved instances in the reservation is + // synchronized. + // "GROUP_MAINTENANCE_TYPE_UNSPECIFIED" - Unknown maintenance type. + // "INDEPENDENT" - Maintenance is not synchronized for this reservation. + // Instead, each instance has its own maintenance window. + SchedulingType string `json:"schedulingType,omitempty"` + // UpcomingGroupMaintenance: Maintenance information on this group of VMs. + UpcomingGroupMaintenance *UpcomingMaintenance `json:"upcomingGroupMaintenance,omitempty"` + // ForceSendFields is a list of field names (e.g. + // "EnableOpportunisticMaintenance") to unconditionally include in API + // requests. By default, fields with empty or default values are omitted from + // API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "EnableOpportunisticMaintenance") + // to include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GroupMaintenanceInfo) MarshalJSON() ([]byte, error) { + type NoMethod GroupMaintenanceInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GuestAttributes: A guest attributes entry. type GuestAttributes struct { // Kind: [Output Only] Type of the resource. Always compute#guestAttributes for @@ -17848,8 +17896,8 @@ type InstanceGroupManager struct { // Name: The name of the managed instance group. The name must be 1-63 // characters long, and comply with RFC1035. Name string `json:"name,omitempty"` - // NamedPorts: Named ports configured for the Instance Groups complementary to - // this Instance Group Manager. + // NamedPorts: [Output Only] Named ports configured on the Instance Groups + // complementary to this Instance Group Manager. NamedPorts []*NamedPort `json:"namedPorts,omitempty"` // Params: Input only. Additional params passed with the request, but not // persisted as part of resource payload. @@ -25934,138 +25982,6 @@ func (s LocationPolicyLocationConstraints) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// LogConfig: This is deprecated and has no effect. Do not use. -type LogConfig struct { - // CloudAudit: This is deprecated and has no effect. Do not use. - CloudAudit *LogConfigCloudAuditOptions `json:"cloudAudit,omitempty"` - // Counter: This is deprecated and has no effect. Do not use. - Counter *LogConfigCounterOptions `json:"counter,omitempty"` - // DataAccess: This is deprecated and has no effect. Do not use. - DataAccess *LogConfigDataAccessOptions `json:"dataAccess,omitempty"` - // ForceSendFields is a list of field names (e.g. "CloudAudit") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "CloudAudit") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s LogConfig) MarshalJSON() ([]byte, error) { - type NoMethod LogConfig - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// LogConfigCloudAuditOptions: This is deprecated and has no effect. Do not -// use. -type LogConfigCloudAuditOptions struct { - // LogName: This is deprecated and has no effect. Do not use. - // - // Possible values: - // "ADMIN_ACTIVITY" - This is deprecated and has no effect. Do not use. - // "DATA_ACCESS" - This is deprecated and has no effect. Do not use. - // "UNSPECIFIED_LOG_NAME" - This is deprecated and has no effect. Do not use. - LogName string `json:"logName,omitempty"` - // ForceSendFields is a list of field names (e.g. "LogName") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "LogName") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s LogConfigCloudAuditOptions) MarshalJSON() ([]byte, error) { - type NoMethod LogConfigCloudAuditOptions - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// LogConfigCounterOptions: This is deprecated and has no effect. Do not use. -type LogConfigCounterOptions struct { - // CustomFields: This is deprecated and has no effect. Do not use. - CustomFields []*LogConfigCounterOptionsCustomField `json:"customFields,omitempty"` - // Field: This is deprecated and has no effect. Do not use. - Field string `json:"field,omitempty"` - // Metric: This is deprecated and has no effect. Do not use. - Metric string `json:"metric,omitempty"` - // ForceSendFields is a list of field names (e.g. "CustomFields") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "CustomFields") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s LogConfigCounterOptions) MarshalJSON() ([]byte, error) { - type NoMethod LogConfigCounterOptions - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// LogConfigCounterOptionsCustomField: This is deprecated and has no effect. Do -// not use. -type LogConfigCounterOptionsCustomField struct { - // Name: This is deprecated and has no effect. Do not use. - Name string `json:"name,omitempty"` - // Value: This is deprecated and has no effect. Do not use. - Value string `json:"value,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 LogConfigCounterOptionsCustomField) MarshalJSON() ([]byte, error) { - type NoMethod LogConfigCounterOptionsCustomField - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// LogConfigDataAccessOptions: This is deprecated and has no effect. Do not -// use. -type LogConfigDataAccessOptions struct { - // LogMode: This is deprecated and has no effect. Do not use. - // - // Possible values: - // "LOG_FAIL_CLOSED" - This is deprecated and has no effect. Do not use. - // "LOG_MODE_UNSPECIFIED" - This is deprecated and has no effect. Do not use. - LogMode string `json:"logMode,omitempty"` - // ForceSendFields is a list of field names (e.g. "LogMode") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "LogMode") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s LogConfigDataAccessOptions) MarshalJSON() ([]byte, error) { - type NoMethod LogConfigDataAccessOptions - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // MachineImage: Represents a machine image resource. A machine image is a // Compute Engine resource that stores all the configuration, metadata, // permissions, and data from one or more disks required to create a Virtual @@ -29933,6 +29849,8 @@ type NetworkInterface struct { // Possible values: // "GVNIC" - GVNIC // "IDPF" - IDPF + // "IRDMA" - IRDMA + // "MRDMA" - MRDMA // "UNSPECIFIED_NIC_TYPE" - No type specified. // "VIRTIO_NET" - VIRTIO NicType string `json:"nicType,omitempty"` @@ -30255,6 +30173,8 @@ type NetworkProfile struct { // Kind: [Output Only] Type of the resource. Always compute#networkProfile for // network profiles. Kind string `json:"kind,omitempty"` + // Location: [Output Only] Location to which the network is restricted. + Location *NetworkProfileLocation `json:"location,omitempty"` // Name: [Output Only] Name of the resource. Name string `json:"name,omitempty"` // SelfLink: [Output Only] Server-defined URL for the resource. @@ -30285,6 +30205,30 @@ func (s NetworkProfile) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type NetworkProfileLocation struct { + Name string `json:"name,omitempty"` + // Possible values: + // "REGION" + // "ZONE" + Scope string `json:"scope,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 NetworkProfileLocation) MarshalJSON() ([]byte, error) { + type NoMethod NetworkProfileLocation + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type NetworkProfileNetworkFeatures struct { // AddressPurposes: Specifies what address purposes are supported. If empty, // all address purposes are supported. @@ -30417,29 +30361,30 @@ type NetworkProfileNetworkFeatures struct { // "VPN_ALLOWED" // "VPN_BLOCKED" AllowVpn string `json:"allowVpn,omitempty"` - // AllowedSubnetPurposes: Specifies which subnetwork purposes are supported. - // - // Possible values: - // "SUBNET_PURPOSE_CUSTOM_HARDWARE" - // "SUBNET_PURPOSE_PRIVATE" - AllowedSubnetPurposes []string `json:"allowedSubnetPurposes,omitempty"` - // AllowedSubnetStackTypes: Specifies which subnetwork stack types are - // supported. - // - // Possible values: - // "SUBNET_STACK_TYPE_IPV4_IPV6" - // "SUBNET_STACK_TYPE_IPV4_ONLY" - // "SUBNET_STACK_TYPE_IPV6_ONLY" - AllowedSubnetStackTypes []string `json:"allowedSubnetStackTypes,omitempty"` // InterfaceTypes: If set, limits the interface types that the network // supports. If empty, all interface types are supported. // // Possible values: // "GVNIC" - GVNIC // "IDPF" - IDPF + // "IRDMA" - IRDMA + // "MRDMA" - MRDMA // "UNSPECIFIED_NIC_TYPE" - No type specified. // "VIRTIO_NET" - VIRTIO InterfaceTypes []string `json:"interfaceTypes,omitempty"` + // SubnetPurposes: Specifies which subnetwork purposes are supported. + // + // Possible values: + // "SUBNET_PURPOSE_CUSTOM_HARDWARE" + // "SUBNET_PURPOSE_PRIVATE" + SubnetPurposes []string `json:"subnetPurposes,omitempty"` + // SubnetStackTypes: Specifies which subnetwork stack types are supported. + // + // Possible values: + // "SUBNET_STACK_TYPE_IPV4_IPV6" + // "SUBNET_STACK_TYPE_IPV4_ONLY" + // "SUBNET_STACK_TYPE_IPV6_ONLY" + SubnetStackTypes []string `json:"subnetStackTypes,omitempty"` // Unicast: Specifies which type of unicast is supported. // // Possible values: @@ -35051,8 +34996,6 @@ type Policy struct { // you to overwrite a version `3` policy with a version `1` policy, and all of // the conditions in the version `3` policy are lost. Etag string `json:"etag,omitempty"` - // Rules: This is deprecated and has no effect. Do not use. - Rules []*Rule `json:"rules,omitempty"` // Version: Specifies the format of the policy. Valid values are `0`, `1`, and // `3`. Requests that specify an invalid value are rejected. Any operation that // affects conditional role bindings must specify version `3`. This requirement @@ -39111,12 +39054,31 @@ type Reservation struct { // auto-deleted by Compute Engine. Timestamp is represented in RFC3339 text // format. DeleteAtTime string `json:"deleteAtTime,omitempty"` + // DeploymentType: Specifies the deployment strategy for this reservation. + // + // Possible values: + // "DENSE" - The reserved capacity is made up of densely deployed reservation + // blocks. + // "DEPLOYMENT_TYPE_UNSPECIFIED" + // "FLEXIBLE" - The reserved capacity is made up of highly flexible, logical + // reservation blocks. + DeploymentType string `json:"deploymentType,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"` + // InstanceTerminationAction: Instance termination action is invoked when the + // reservation is deleted. This only applies to reservations with a Deployment + // type. + // + // Possible values: + // "DELETE" - Delete the VM. + // "INSTANCE_TERMINATION_ACTION_UNSPECIFIED" - Default value. This value is + // unused. + // "STOP" - Stop the VM without storing in-memory content. default action. + InstanceTerminationAction string `json:"instanceTerminationAction,omitempty"` // Kind: [Output Only] Type of the resource. Always compute#reservations for // reservations. Kind string `json:"kind,omitempty"` @@ -39398,6 +39360,267 @@ func (s ReservationAggregatedListWarningData) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ReservationBlock: Represents a reservation block resource. +type ReservationBlock struct { + // Count: [Output Only] The number of resources that are allocated in this + // reservation block. + Count int64 `json:"count,omitempty"` + // CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text format. + CreationTimestamp string `json:"creationTimestamp,omitempty"` + // Id: [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + Id uint64 `json:"id,omitempty,string"` + // InUseCount: [Output Only] The number of instances that are currently in use + // on this reservation block. + InUseCount int64 `json:"inUseCount,omitempty"` + // Kind: [Output Only] Type of the resource. Always compute#reservationBlock + // for reservation blocks. + Kind string `json:"kind,omitempty"` + // Name: [Output Only] The name of this reservation block generated by Google + // Compute Engine. The name must be 1-63 characters long, and comply with + // RFC1035 @pattern a-z (?:[-a-z0-9]{0,61}[a-z0-9])? + Name string `json:"name,omitempty"` + // PhysicalTopology: [Output Only] The physical topology of the reservation + // block. + PhysicalTopology *ReservationBlockPhysicalTopology `json:"physicalTopology,omitempty"` + // ReservationMaintenance: [Output Only] Maintenance information for this + // reservation block. + ReservationMaintenance *GroupMaintenanceInfo `json:"reservationMaintenance,omitempty"` + // SelfLink: [Output Only] Server-defined fully-qualified URL for this + // 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: [Output Only] Status of the reservation block. + // + // Possible values: + // "CREATING" - Resources are being allocated for the reservation block. + // "DELETING" - Reservation block is currently being deleted. + // "INVALID" + // "READY" - Reservation block has allocated all its resources. + Status string `json:"status,omitempty"` + // Zone: [Output Only] Zone in which the reservation block resides. + Zone string `json:"zone,omitempty"` + // ForceSendFields is a list of field names (e.g. "Count") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Count") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ReservationBlock) MarshalJSON() ([]byte, error) { + type NoMethod ReservationBlock + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type ReservationBlockPhysicalTopology struct { + // Block: The hash of the capacity block within the cluster. + Block string `json:"block,omitempty"` + // Cluster: The cluster name of the reservation block. + Cluster string `json:"cluster,omitempty"` + // ForceSendFields is a list of field names (e.g. "Block") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Block") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ReservationBlockPhysicalTopology) MarshalJSON() ([]byte, error) { + type NoMethod ReservationBlockPhysicalTopology + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type ReservationBlocksGetResponse struct { + Resource *ReservationBlock `json:"resource,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Resource") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Resource") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ReservationBlocksGetResponse) MarshalJSON() ([]byte, error) { + type NoMethod ReservationBlocksGetResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ReservationBlocksListResponse: A list of reservation blocks under a single +// reservation. +type ReservationBlocksListResponse struct { + // Id: Unique identifier for the resource; defined by the server. + Id string `json:"id,omitempty"` + // Items: A list of reservation block resources. + Items []*ReservationBlock `json:"items,omitempty"` + // Kind: Type of the resource. Always compute#reservationBlock for a list of + // reservation blocks. + Kind string `json:"kind,omitempty"` + // NextPageToken: This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value 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: Server-defined URL for this resource. + SelfLink string `json:"selfLink,omitempty"` + // Warning: Informational warning message. + Warning *ReservationBlocksListResponseWarning `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. "Id") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Id") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ReservationBlocksListResponse) MarshalJSON() ([]byte, error) { + type NoMethod ReservationBlocksListResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ReservationBlocksListResponseWarning: Informational warning message. +type ReservationBlocksListResponseWarning 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 []*ReservationBlocksListResponseWarningData `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 ReservationBlocksListResponseWarning) MarshalJSON() ([]byte, error) { + type NoMethod ReservationBlocksListResponseWarning + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type ReservationBlocksListResponseWarningData 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 ReservationBlocksListResponseWarningData) MarshalJSON() ([]byte, error) { + type NoMethod ReservationBlocksListResponseWarningData + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type ReservationList struct { // Id: [Output Only] The unique identifier for the resource. This identifier is // defined by the server. @@ -40722,9 +40945,12 @@ func (s ResourcePolicyWorkloadPolicy) MarshalJSON() ([]byte, error) { type ResourceStatus struct { // PhysicalHost: [Output Only] An opaque ID of the host on which the VM is // running. - PhysicalHost string `json:"physicalHost,omitempty"` - Scheduling *ResourceStatusScheduling `json:"scheduling,omitempty"` - UpcomingMaintenance *UpcomingMaintenance `json:"upcomingMaintenance,omitempty"` + PhysicalHost string `json:"physicalHost,omitempty"` + // PhysicalHostTopology: [Output Only] The physical host topology of the host + // on which the VM is running. + PhysicalHostTopology *ResourceStatusPhysicalHostTopology `json:"physicalHostTopology,omitempty"` + Scheduling *ResourceStatusScheduling `json:"scheduling,omitempty"` + UpcomingMaintenance *UpcomingMaintenance `json:"upcomingMaintenance,omitempty"` // ForceSendFields is a list of field names (e.g. "PhysicalHost") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -40743,6 +40969,31 @@ func (s ResourceStatus) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ResourceStatusPhysicalHostTopology: Represents the physical host topology of +// the host on which the VM is running. +type ResourceStatusPhysicalHostTopology struct { + Block string `json:"block,omitempty"` + Cluster string `json:"cluster,omitempty"` + Host string `json:"host,omitempty"` + Subblock string `json:"subblock,omitempty"` + // ForceSendFields is a list of field names (e.g. "Block") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Block") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ResourceStatusPhysicalHostTopology) MarshalJSON() ([]byte, error) { + type NoMethod ResourceStatusPhysicalHostTopology + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type ResourceStatusScheduling struct { // AvailabilityDomain: Specifies the availability domain to place the instance // in. The value must be a number between 1 and the number of availability @@ -43126,48 +43377,6 @@ func (s RoutersScopedListWarningData) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Rule: This is deprecated and has no effect. Do not use. -type Rule struct { - // Action: This is deprecated and has no effect. Do not use. - // - // Possible values: - // "ALLOW" - This is deprecated and has no effect. Do not use. - // "ALLOW_WITH_LOG" - This is deprecated and has no effect. Do not use. - // "DENY" - This is deprecated and has no effect. Do not use. - // "DENY_WITH_LOG" - This is deprecated and has no effect. Do not use. - // "LOG" - This is deprecated and has no effect. Do not use. - // "NO_ACTION" - This is deprecated and has no effect. Do not use. - Action string `json:"action,omitempty"` - // Conditions: This is deprecated and has no effect. Do not use. - Conditions []*Condition `json:"conditions,omitempty"` - // Description: This is deprecated and has no effect. Do not use. - Description string `json:"description,omitempty"` - // Ins: This is deprecated and has no effect. Do not use. - Ins []string `json:"ins,omitempty"` - // LogConfigs: This is deprecated and has no effect. Do not use. - LogConfigs []*LogConfig `json:"logConfigs,omitempty"` - // NotIns: This is deprecated and has no effect. Do not use. - NotIns []string `json:"notIns,omitempty"` - // Permissions: This is deprecated and has no effect. Do not use. - Permissions []string `json:"permissions,omitempty"` - // ForceSendFields is a list of field names (e.g. "Action") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Action") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s Rule) MarshalJSON() ([]byte, error) { - type NoMethod Rule - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - type SSLHealthCheck struct { // Port: The TCP port number to which the health check prober sends packets. // The default value is 443. Valid values are 1 through 65535. @@ -50044,7 +50253,7 @@ type Subnetwork struct { // VMs in this subnet to Google services. PrivateIpv6GoogleAccess string `json:"privateIpv6GoogleAccess,omitempty"` // Purpose: The purpose of the resource. This field can be either PRIVATE, - // GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, PRIVATE_SERVICE_CONNECT, or + // GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, or PRIVATE_SERVICE_CONNECT. // PRIVATE is the default purpose for user-created subnets or subnets that are // automatically created in auto mode networks. Subnets with purpose set to // GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks @@ -56042,7 +56251,7 @@ type UsableSubnetwork struct { // Network: Network URL. Network string `json:"network,omitempty"` // Purpose: The purpose of the resource. This field can be either PRIVATE, - // GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, PRIVATE_SERVICE_CONNECT, or + // GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, or PRIVATE_SERVICE_CONNECT. // PRIVATE is the default purpose for user-created subnets or subnets that are // automatically created in auto mode networks. Subnets with purpose set to // GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks diff --git a/compute/v0.beta/compute2-gen.go b/compute/v0.beta/compute2-gen.go index 26a7118ba97..4a33ffd2493 100644 --- a/compute/v0.beta/compute2-gen.go +++ b/compute/v0.beta/compute2-gen.go @@ -34793,7 +34793,9 @@ func (c *InstancesGetSerialPortOutputCall) Port(port int64) *InstancesGetSerialP // adjusted start position is returned as the `start` property value. You can // also provide a negative start position, which translates to the most recent // number of bytes written to the serial port. For example, -3 is interpreted -// as the most recent 3 bytes written to the serial console. +// as the most recent 3 bytes written to the serial console. Note that the +// negative start is bounded by the retained buffer size, and the returned +// serial console output will not exceed the max buffer size. func (c *InstancesGetSerialPortOutputCall) Start(start int64) *InstancesGetSerialPortOutputCall { c.urlParams_.Set("start", fmt.Sprint(start)) return c @@ -59423,6 +59425,192 @@ func (c *OrganizationSecurityPoliciesListAssociationsCall) Do(opts ...googleapi. return ret, nil } +type OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall struct { + s *Service + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// ListPreconfiguredExpressionSets: Gets the current list of preconfigured Web +// Application Firewall (WAF) expressions. +func (r *OrganizationSecurityPoliciesService) ListPreconfiguredExpressionSets() *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall { + c := &OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + 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 *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall) Filter(filter string) *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall { + 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 *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall) MaxResults(maxResults int64) *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall { + 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 *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall) OrderBy(orderBy string) *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall { + 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 *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall) PageToken(pageToken string) *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// ParentId sets the optional parameter "parentId": Parent ID for this request. +func (c *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall) ParentId(parentId string) *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall { + c.urlParams_.Set("parentId", parentId) + 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 *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall) ReturnPartialSuccess(returnPartialSuccess bool) *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall { + 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 *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall) Fields(s ...googleapi.Field) *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall { + 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 *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall) IfNoneMatch(entityTag string) *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall) Context(ctx context.Context) *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall { + 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 *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall) 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, "locations/global/securityPolicies/listPreconfiguredExpressionSets") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.organizationSecurityPolicies.listPreconfiguredExpressionSets" call. +// Any non-2xx status code is an error. Response headers are in either +// *SecurityPoliciesListPreconfiguredExpressionSetsResponse.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 *OrganizationSecurityPoliciesListPreconfiguredExpressionSetsCall) Do(opts ...googleapi.CallOption) (*SecurityPoliciesListPreconfiguredExpressionSetsResponse, 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 := &SecurityPoliciesListPreconfiguredExpressionSetsResponse{ + 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 OrganizationSecurityPoliciesMoveCall struct { s *Service securityPolicy string @@ -65031,3 +65219,936 @@ func (c *PublicDelegatedPrefixesWithdrawCall) Do(opts ...googleapi.CallOption) ( } return ret, nil } + +type RegionAutoscalersDeleteCall struct { + s *Service + project string + region string + autoscaler string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes the specified autoscaler. +// +// - autoscaler: Name of the autoscaler to delete. +// - project: Project ID for this request. +// - region: Name of the region scoping this request. +func (r *RegionAutoscalersService) Delete(project string, region string, autoscaler string) *RegionAutoscalersDeleteCall { + c := &RegionAutoscalersDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.region = region + c.autoscaler = autoscaler + 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 *RegionAutoscalersDeleteCall) RequestId(requestId string) *RegionAutoscalersDeleteCall { + 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 *RegionAutoscalersDeleteCall) Fields(s ...googleapi.Field) *RegionAutoscalersDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *RegionAutoscalersDeleteCall) Context(ctx context.Context) *RegionAutoscalersDeleteCall { + 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 *RegionAutoscalersDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *RegionAutoscalersDeleteCall) 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}/autoscalers/{autoscaler}") + 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, + "autoscaler": c.autoscaler, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.regionAutoscalers.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 *RegionAutoscalersDeleteCall) 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 RegionAutoscalersGetCall struct { + s *Service + project string + region string + autoscaler string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Returns the specified autoscaler. +// +// - autoscaler: Name of the autoscaler to return. +// - project: Project ID for this request. +// - region: Name of the region scoping this request. +func (r *RegionAutoscalersService) Get(project string, region string, autoscaler string) *RegionAutoscalersGetCall { + c := &RegionAutoscalersGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.region = region + c.autoscaler = autoscaler + 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 *RegionAutoscalersGetCall) Fields(s ...googleapi.Field) *RegionAutoscalersGetCall { + 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 *RegionAutoscalersGetCall) IfNoneMatch(entityTag string) *RegionAutoscalersGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *RegionAutoscalersGetCall) Context(ctx context.Context) *RegionAutoscalersGetCall { + 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 *RegionAutoscalersGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *RegionAutoscalersGetCall) 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}/autoscalers/{autoscaler}") + 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, + "autoscaler": c.autoscaler, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.regionAutoscalers.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *Autoscaler.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 *RegionAutoscalersGetCall) Do(opts ...googleapi.CallOption) (*Autoscaler, 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 := &Autoscaler{ + 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 RegionAutoscalersInsertCall struct { + s *Service + project string + region string + autoscaler *Autoscaler + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Insert: Creates an autoscaler in the specified project using the data +// included in the request. +// +// - project: Project ID for this request. +// - region: Name of the region scoping this request. +func (r *RegionAutoscalersService) Insert(project string, region string, autoscaler *Autoscaler) *RegionAutoscalersInsertCall { + c := &RegionAutoscalersInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.region = region + c.autoscaler = autoscaler + 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 *RegionAutoscalersInsertCall) RequestId(requestId string) *RegionAutoscalersInsertCall { + 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 *RegionAutoscalersInsertCall) Fields(s ...googleapi.Field) *RegionAutoscalersInsertCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *RegionAutoscalersInsertCall) Context(ctx context.Context) *RegionAutoscalersInsertCall { + 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 *RegionAutoscalersInsertCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *RegionAutoscalersInsertCall) 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.autoscaler) + 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}/autoscalers") + 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.regionAutoscalers.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 *RegionAutoscalersInsertCall) 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 RegionAutoscalersListCall struct { + s *Service + project string + region string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Retrieves a list of autoscalers contained within the specified region. +// +// - project: Project ID for this request. +// - region: Name of the region scoping this request. +func (r *RegionAutoscalersService) List(project string, region string) *RegionAutoscalersListCall { + c := &RegionAutoscalersListCall{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 *RegionAutoscalersListCall) Filter(filter string) *RegionAutoscalersListCall { + 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 *RegionAutoscalersListCall) MaxResults(maxResults int64) *RegionAutoscalersListCall { + 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 *RegionAutoscalersListCall) OrderBy(orderBy string) *RegionAutoscalersListCall { + 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 *RegionAutoscalersListCall) PageToken(pageToken string) *RegionAutoscalersListCall { + 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 *RegionAutoscalersListCall) ReturnPartialSuccess(returnPartialSuccess bool) *RegionAutoscalersListCall { + 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 *RegionAutoscalersListCall) Fields(s ...googleapi.Field) *RegionAutoscalersListCall { + 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 *RegionAutoscalersListCall) IfNoneMatch(entityTag string) *RegionAutoscalersListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *RegionAutoscalersListCall) Context(ctx context.Context) *RegionAutoscalersListCall { + 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 *RegionAutoscalersListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *RegionAutoscalersListCall) 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}/autoscalers") + 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.regionAutoscalers.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *RegionAutoscalerList.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 *RegionAutoscalersListCall) Do(opts ...googleapi.CallOption) (*RegionAutoscalerList, 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 := &RegionAutoscalerList{ + 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 *RegionAutoscalersListCall) Pages(ctx context.Context, f func(*RegionAutoscalerList) 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 RegionAutoscalersPatchCall struct { + s *Service + project string + region string + autoscaler *Autoscaler + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates an autoscaler in the specified project using the data +// included in the request. This method supports PATCH semantics and uses the +// JSON merge patch format and processing rules. +// +// - project: Project ID for this request. +// - region: Name of the region scoping this request. +func (r *RegionAutoscalersService) Patch(project string, region string, autoscaler *Autoscaler) *RegionAutoscalersPatchCall { + c := &RegionAutoscalersPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.region = region + c.autoscaler = autoscaler + return c +} + +// Autoscaler sets the optional parameter "autoscaler": Name of the autoscaler +// to patch. +func (c *RegionAutoscalersPatchCall) Autoscaler(autoscaler string) *RegionAutoscalersPatchCall { + c.urlParams_.Set("autoscaler", autoscaler) + 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 *RegionAutoscalersPatchCall) RequestId(requestId string) *RegionAutoscalersPatchCall { + 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 *RegionAutoscalersPatchCall) Fields(s ...googleapi.Field) *RegionAutoscalersPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *RegionAutoscalersPatchCall) Context(ctx context.Context) *RegionAutoscalersPatchCall { + 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 *RegionAutoscalersPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *RegionAutoscalersPatchCall) 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.autoscaler) + 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}/autoscalers") + 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{ + "project": c.project, + "region": c.region, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.regionAutoscalers.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 *RegionAutoscalersPatchCall) 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 RegionAutoscalersTestIamPermissionsCall struct { + s *Service + project string + region string + resource string + testpermissionsrequest *TestPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// TestIamPermissions: Returns permissions that a caller has on the specified +// resource. +// +// - project: Project ID for this request. +// - region: The name of the region for this request. +// - resource: Name or id of the resource for this request. +func (r *RegionAutoscalersService) TestIamPermissions(project string, region string, resource string, testpermissionsrequest *TestPermissionsRequest) *RegionAutoscalersTestIamPermissionsCall { + c := &RegionAutoscalersTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.region = region + c.resource = resource + c.testpermissionsrequest = testpermissionsrequest + 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 *RegionAutoscalersTestIamPermissionsCall) Fields(s ...googleapi.Field) *RegionAutoscalersTestIamPermissionsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *RegionAutoscalersTestIamPermissionsCall) Context(ctx context.Context) *RegionAutoscalersTestIamPermissionsCall { + 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 *RegionAutoscalersTestIamPermissionsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *RegionAutoscalersTestIamPermissionsCall) 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.testpermissionsrequest) + 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}/autoscalers/{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{ + "project": c.project, + "region": c.region, + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.regionAutoscalers.testIamPermissions" call. +// Any non-2xx status code is an error. Response headers are in either +// *TestPermissionsResponse.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 *RegionAutoscalersTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestPermissionsResponse, 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 := &TestPermissionsResponse{ + 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 RegionAutoscalersUpdateCall struct { + s *Service + project string + region string + autoscaler *Autoscaler + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Update: Updates an autoscaler in the specified project using the data +// included in the request. +// +// - project: Project ID for this request. +// - region: Name of the region scoping this request. +func (r *RegionAutoscalersService) Update(project string, region string, autoscaler *Autoscaler) *RegionAutoscalersUpdateCall { + c := &RegionAutoscalersUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.region = region + c.autoscaler = autoscaler + return c +} + +// Autoscaler sets the optional parameter "autoscaler": Name of the autoscaler +// to update. +func (c *RegionAutoscalersUpdateCall) Autoscaler(autoscaler string) *RegionAutoscalersUpdateCall { + c.urlParams_.Set("autoscaler", autoscaler) + 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 *RegionAutoscalersUpdateCall) RequestId(requestId string) *RegionAutoscalersUpdateCall { + 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 *RegionAutoscalersUpdateCall) Fields(s ...googleapi.Field) *RegionAutoscalersUpdateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *RegionAutoscalersUpdateCall) Context(ctx context.Context) *RegionAutoscalersUpdateCall { + 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 *RegionAutoscalersUpdateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *RegionAutoscalersUpdateCall) 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.autoscaler) + 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}/autoscalers") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PUT", 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.regionAutoscalers.update" 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 *RegionAutoscalersUpdateCall) 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/compute/v0.beta/compute3-gen.go b/compute/v0.beta/compute3-gen.go index 589e366445a..72c3d901b74 100644 --- a/compute/v0.beta/compute3-gen.go +++ b/compute/v0.beta/compute3-gen.go @@ -16,26 +16,26 @@ import ( gensupport "google.golang.org/api/internal/gensupport" ) -type RegionAutoscalersDeleteCall struct { - s *Service - project string - region string - autoscaler string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type RegionBackendServicesDeleteCall struct { + s *Service + project string + region string + backendService string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Delete: Deletes the specified autoscaler. +// Delete: Deletes the specified regional BackendService resource. // -// - autoscaler: Name of the autoscaler to delete. +// - backendService: Name of the BackendService resource to delete. // - project: Project ID for this request. // - region: Name of the region scoping this request. -func (r *RegionAutoscalersService) Delete(project string, region string, autoscaler string) *RegionAutoscalersDeleteCall { - c := &RegionAutoscalersDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *RegionBackendServicesService) Delete(project string, region string, backendService string) *RegionBackendServicesDeleteCall { + c := &RegionBackendServicesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project c.region = region - c.autoscaler = autoscaler + c.backendService = backendService return c } @@ -49,7 +49,7 @@ func (r *RegionAutoscalersService) Delete(project string, region string, autosca // prevents clients from accidentally creating 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 *RegionAutoscalersDeleteCall) RequestId(requestId string) *RegionAutoscalersDeleteCall { +func (c *RegionBackendServicesDeleteCall) RequestId(requestId string) *RegionBackendServicesDeleteCall { c.urlParams_.Set("requestId", requestId) return c } @@ -57,32 +57,32 @@ func (c *RegionAutoscalersDeleteCall) RequestId(requestId string) *RegionAutosca // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *RegionAutoscalersDeleteCall) Fields(s ...googleapi.Field) *RegionAutoscalersDeleteCall { +func (c *RegionBackendServicesDeleteCall) Fields(s ...googleapi.Field) *RegionBackendServicesDeleteCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *RegionAutoscalersDeleteCall) Context(ctx context.Context) *RegionAutoscalersDeleteCall { +func (c *RegionBackendServicesDeleteCall) Context(ctx context.Context) *RegionBackendServicesDeleteCall { 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 *RegionAutoscalersDeleteCall) Header() http.Header { +func (c *RegionBackendServicesDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *RegionAutoscalersDeleteCall) doRequest(alt string) (*http.Response, error) { +func (c *RegionBackendServicesDeleteCall) 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}/autoscalers/{autoscaler}") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/backendServices/{backendService}") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("DELETE", urls, body) if err != nil { @@ -90,19 +90,19 @@ func (c *RegionAutoscalersDeleteCall) doRequest(alt string) (*http.Response, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "project": c.project, - "region": c.region, - "autoscaler": c.autoscaler, + "project": c.project, + "region": c.region, + "backendService": c.backendService, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "compute.regionAutoscalers.delete" call. +// Do executes the "compute.regionBackendServices.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 *RegionAutoscalersDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error) { +func (c *RegionBackendServicesDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -134,34 +134,34 @@ func (c *RegionAutoscalersDeleteCall) Do(opts ...googleapi.CallOption) (*Operati return ret, nil } -type RegionAutoscalersGetCall struct { - s *Service - project string - region string - autoscaler string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type RegionBackendServicesGetCall struct { + s *Service + project string + region string + backendService string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Get: Returns the specified autoscaler. +// Get: Returns the specified regional BackendService resource. // -// - autoscaler: Name of the autoscaler to return. +// - backendService: Name of the BackendService resource to return. // - project: Project ID for this request. // - region: Name of the region scoping this request. -func (r *RegionAutoscalersService) Get(project string, region string, autoscaler string) *RegionAutoscalersGetCall { - c := &RegionAutoscalersGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *RegionBackendServicesService) Get(project string, region string, backendService string) *RegionBackendServicesGetCall { + c := &RegionBackendServicesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project c.region = region - c.autoscaler = autoscaler + c.backendService = backendService 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 *RegionAutoscalersGetCall) Fields(s ...googleapi.Field) *RegionAutoscalersGetCall { +func (c *RegionBackendServicesGetCall) Fields(s ...googleapi.Field) *RegionBackendServicesGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -169,27 +169,27 @@ func (c *RegionAutoscalersGetCall) Fields(s ...googleapi.Field) *RegionAutoscale // 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 *RegionAutoscalersGetCall) IfNoneMatch(entityTag string) *RegionAutoscalersGetCall { +func (c *RegionBackendServicesGetCall) IfNoneMatch(entityTag string) *RegionBackendServicesGetCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *RegionAutoscalersGetCall) Context(ctx context.Context) *RegionAutoscalersGetCall { +func (c *RegionBackendServicesGetCall) Context(ctx context.Context) *RegionBackendServicesGetCall { 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 *RegionAutoscalersGetCall) Header() http.Header { +func (c *RegionBackendServicesGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *RegionAutoscalersGetCall) doRequest(alt string) (*http.Response, error) { +func (c *RegionBackendServicesGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) @@ -197,7 +197,7 @@ func (c *RegionAutoscalersGetCall) doRequest(alt string) (*http.Response, error) 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}/autoscalers/{autoscaler}") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/backendServices/{backendService}") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, body) if err != nil { @@ -205,19 +205,19 @@ func (c *RegionAutoscalersGetCall) doRequest(alt string) (*http.Response, error) } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "project": c.project, - "region": c.region, - "autoscaler": c.autoscaler, + "project": c.project, + "region": c.region, + "backendService": c.backendService, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "compute.regionAutoscalers.get" call. +// Do executes the "compute.regionBackendServices.get" call. // Any non-2xx status code is an error. Response headers are in either -// *Autoscaler.ServerResponse.Header or (if a response was returned at all) in -// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// *BackendService.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 *RegionAutoscalersGetCall) Do(opts ...googleapi.CallOption) (*Autoscaler, error) { +func (c *RegionBackendServicesGetCall) Do(opts ...googleapi.CallOption) (*BackendService, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -236,7 +236,7 @@ func (c *RegionAutoscalersGetCall) Do(opts ...googleapi.CallOption) (*Autoscaler if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Autoscaler{ + ret := &BackendService{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -249,77 +249,66 @@ func (c *RegionAutoscalersGetCall) Do(opts ...googleapi.CallOption) (*Autoscaler return ret, nil } -type RegionAutoscalersInsertCall struct { - s *Service - project string - region string - autoscaler *Autoscaler - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type RegionBackendServicesGetHealthCall struct { + s *Service + project string + region string + backendService string + resourcegroupreference *ResourceGroupReference + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Insert: Creates an autoscaler in the specified project using the data -// included in the request. +// GetHealth: Gets the most recent health check results for this regional +// BackendService. // -// - project: Project ID for this request. -// - region: Name of the region scoping this request. -func (r *RegionAutoscalersService) Insert(project string, region string, autoscaler *Autoscaler) *RegionAutoscalersInsertCall { - c := &RegionAutoscalersInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - backendService: Name of the BackendService resource for which to get +// health. +// - project: . +// - region: Name of the region scoping this request. +func (r *RegionBackendServicesService) GetHealth(project string, region string, backendService string, resourcegroupreference *ResourceGroupReference) *RegionBackendServicesGetHealthCall { + c := &RegionBackendServicesGetHealthCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project c.region = region - c.autoscaler = autoscaler - 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 *RegionAutoscalersInsertCall) RequestId(requestId string) *RegionAutoscalersInsertCall { - c.urlParams_.Set("requestId", requestId) + c.backendService = backendService + c.resourcegroupreference = resourcegroupreference 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 *RegionAutoscalersInsertCall) Fields(s ...googleapi.Field) *RegionAutoscalersInsertCall { +func (c *RegionBackendServicesGetHealthCall) Fields(s ...googleapi.Field) *RegionBackendServicesGetHealthCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *RegionAutoscalersInsertCall) Context(ctx context.Context) *RegionAutoscalersInsertCall { +func (c *RegionBackendServicesGetHealthCall) Context(ctx context.Context) *RegionBackendServicesGetHealthCall { 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 *RegionAutoscalersInsertCall) Header() http.Header { +func (c *RegionBackendServicesGetHealthCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *RegionAutoscalersInsertCall) doRequest(alt string) (*http.Response, error) { +func (c *RegionBackendServicesGetHealthCall) 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.autoscaler) + body, err := googleapi.WithoutDataWrapper.JSONReader(c.resourcegroupreference) 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}/autoscalers") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/backendServices/{backendService}/getHealth") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -327,18 +316,20 @@ func (c *RegionAutoscalersInsertCall) doRequest(alt string) (*http.Response, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "project": c.project, - "region": c.region, + "project": c.project, + "region": c.region, + "backendService": c.backendService, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "compute.regionAutoscalers.insert" call. +// Do executes the "compute.regionBackendServices.getHealth" 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 *RegionAutoscalersInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error) { +// *BackendServiceGroupHealth.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 *RegionBackendServicesGetHealthCall) Do(opts ...googleapi.CallOption) (*BackendServiceGroupHealth, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -357,7 +348,7 @@ func (c *RegionAutoscalersInsertCall) Do(opts ...googleapi.CallOption) (*Operati if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Operation{ + ret := &BackendServiceGroupHealth{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -370,109 +361,42 @@ func (c *RegionAutoscalersInsertCall) Do(opts ...googleapi.CallOption) (*Operati return ret, nil } -type RegionAutoscalersListCall struct { +type RegionBackendServicesGetIamPolicyCall struct { s *Service project string region string + resource string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } -// List: Retrieves a list of autoscalers contained within the specified region. +// GetIamPolicy: Gets the access control policy for a resource. May be empty if +// no such policy or resource exists. // // - project: Project ID for this request. -// - region: Name of the region scoping this request. -func (r *RegionAutoscalersService) List(project string, region string) *RegionAutoscalersListCall { - c := &RegionAutoscalersListCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - region: The name of the region for this request. +// - resource: Name or id of the resource for this request. +func (r *RegionBackendServicesService) GetIamPolicy(project string, region string, resource string) *RegionBackendServicesGetIamPolicyCall { + c := &RegionBackendServicesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project c.region = region + c.resource = resource 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 *RegionAutoscalersListCall) Filter(filter string) *RegionAutoscalersListCall { - 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 *RegionAutoscalersListCall) MaxResults(maxResults int64) *RegionAutoscalersListCall { - 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 *RegionAutoscalersListCall) OrderBy(orderBy string) *RegionAutoscalersListCall { - 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 *RegionAutoscalersListCall) PageToken(pageToken string) *RegionAutoscalersListCall { - 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 *RegionAutoscalersListCall) ReturnPartialSuccess(returnPartialSuccess bool) *RegionAutoscalersListCall { - c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) +// OptionsRequestedPolicyVersion sets the optional parameter +// "optionsRequestedPolicyVersion": Requested IAM Policy version. +func (c *RegionBackendServicesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *RegionBackendServicesGetIamPolicyCall { + c.urlParams_.Set("optionsRequestedPolicyVersion", 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 *RegionAutoscalersListCall) Fields(s ...googleapi.Field) *RegionAutoscalersListCall { +func (c *RegionBackendServicesGetIamPolicyCall) Fields(s ...googleapi.Field) *RegionBackendServicesGetIamPolicyCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -480,27 +404,27 @@ func (c *RegionAutoscalersListCall) Fields(s ...googleapi.Field) *RegionAutoscal // 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 *RegionAutoscalersListCall) IfNoneMatch(entityTag string) *RegionAutoscalersListCall { +func (c *RegionBackendServicesGetIamPolicyCall) IfNoneMatch(entityTag string) *RegionBackendServicesGetIamPolicyCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *RegionAutoscalersListCall) Context(ctx context.Context) *RegionAutoscalersListCall { +func (c *RegionBackendServicesGetIamPolicyCall) Context(ctx context.Context) *RegionBackendServicesGetIamPolicyCall { 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 *RegionAutoscalersListCall) Header() http.Header { +func (c *RegionBackendServicesGetIamPolicyCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *RegionAutoscalersListCall) doRequest(alt string) (*http.Response, error) { +func (c *RegionBackendServicesGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) @@ -508,7 +432,7 @@ func (c *RegionAutoscalersListCall) doRequest(alt string) (*http.Response, error 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}/autoscalers") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/backendServices/{resource}/getIamPolicy") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, body) if err != nil { @@ -516,19 +440,19 @@ func (c *RegionAutoscalersListCall) doRequest(alt string) (*http.Response, error } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "project": c.project, - "region": c.region, + "project": c.project, + "region": c.region, + "resource": c.resource, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "compute.regionAutoscalers.list" call. +// Do executes the "compute.regionBackendServices.getIamPolicy" call. // Any non-2xx status code is an error. Response headers are in either -// *RegionAutoscalerList.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 *RegionAutoscalersListCall) Do(opts ...googleapi.CallOption) (*RegionAutoscalerList, error) { +// *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 *RegionBackendServicesGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -547,864 +471,7 @@ func (c *RegionAutoscalersListCall) Do(opts ...googleapi.CallOption) (*RegionAut if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &RegionAutoscalerList{ - 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 *RegionAutoscalersListCall) Pages(ctx context.Context, f func(*RegionAutoscalerList) 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 RegionAutoscalersPatchCall struct { - s *Service - project string - region string - autoscaler *Autoscaler - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Patch: Updates an autoscaler in the specified project using the data -// included in the request. This method supports PATCH semantics and uses the -// JSON merge patch format and processing rules. -// -// - project: Project ID for this request. -// - region: Name of the region scoping this request. -func (r *RegionAutoscalersService) Patch(project string, region string, autoscaler *Autoscaler) *RegionAutoscalersPatchCall { - c := &RegionAutoscalersPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.project = project - c.region = region - c.autoscaler = autoscaler - return c -} - -// Autoscaler sets the optional parameter "autoscaler": Name of the autoscaler -// to patch. -func (c *RegionAutoscalersPatchCall) Autoscaler(autoscaler string) *RegionAutoscalersPatchCall { - c.urlParams_.Set("autoscaler", autoscaler) - 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 *RegionAutoscalersPatchCall) RequestId(requestId string) *RegionAutoscalersPatchCall { - 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 *RegionAutoscalersPatchCall) Fields(s ...googleapi.Field) *RegionAutoscalersPatchCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *RegionAutoscalersPatchCall) Context(ctx context.Context) *RegionAutoscalersPatchCall { - 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 *RegionAutoscalersPatchCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *RegionAutoscalersPatchCall) 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.autoscaler) - 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}/autoscalers") - 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{ - "project": c.project, - "region": c.region, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "compute.regionAutoscalers.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 *RegionAutoscalersPatchCall) 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 RegionAutoscalersTestIamPermissionsCall struct { - s *Service - project string - region string - resource string - testpermissionsrequest *TestPermissionsRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// TestIamPermissions: Returns permissions that a caller has on the specified -// resource. -// -// - project: Project ID for this request. -// - region: The name of the region for this request. -// - resource: Name or id of the resource for this request. -func (r *RegionAutoscalersService) TestIamPermissions(project string, region string, resource string, testpermissionsrequest *TestPermissionsRequest) *RegionAutoscalersTestIamPermissionsCall { - c := &RegionAutoscalersTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.project = project - c.region = region - c.resource = resource - c.testpermissionsrequest = testpermissionsrequest - 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 *RegionAutoscalersTestIamPermissionsCall) Fields(s ...googleapi.Field) *RegionAutoscalersTestIamPermissionsCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *RegionAutoscalersTestIamPermissionsCall) Context(ctx context.Context) *RegionAutoscalersTestIamPermissionsCall { - 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 *RegionAutoscalersTestIamPermissionsCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *RegionAutoscalersTestIamPermissionsCall) 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.testpermissionsrequest) - 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}/autoscalers/{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{ - "project": c.project, - "region": c.region, - "resource": c.resource, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "compute.regionAutoscalers.testIamPermissions" call. -// Any non-2xx status code is an error. Response headers are in either -// *TestPermissionsResponse.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 *RegionAutoscalersTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestPermissionsResponse, 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 := &TestPermissionsResponse{ - 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 RegionAutoscalersUpdateCall struct { - s *Service - project string - region string - autoscaler *Autoscaler - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Update: Updates an autoscaler in the specified project using the data -// included in the request. -// -// - project: Project ID for this request. -// - region: Name of the region scoping this request. -func (r *RegionAutoscalersService) Update(project string, region string, autoscaler *Autoscaler) *RegionAutoscalersUpdateCall { - c := &RegionAutoscalersUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.project = project - c.region = region - c.autoscaler = autoscaler - return c -} - -// Autoscaler sets the optional parameter "autoscaler": Name of the autoscaler -// to update. -func (c *RegionAutoscalersUpdateCall) Autoscaler(autoscaler string) *RegionAutoscalersUpdateCall { - c.urlParams_.Set("autoscaler", autoscaler) - 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 *RegionAutoscalersUpdateCall) RequestId(requestId string) *RegionAutoscalersUpdateCall { - 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 *RegionAutoscalersUpdateCall) Fields(s ...googleapi.Field) *RegionAutoscalersUpdateCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *RegionAutoscalersUpdateCall) Context(ctx context.Context) *RegionAutoscalersUpdateCall { - 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 *RegionAutoscalersUpdateCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *RegionAutoscalersUpdateCall) 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.autoscaler) - 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}/autoscalers") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("PUT", 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.regionAutoscalers.update" 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 *RegionAutoscalersUpdateCall) 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 RegionBackendServicesDeleteCall struct { - s *Service - project string - region string - backendService string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Delete: Deletes the specified regional BackendService resource. -// -// - backendService: Name of the BackendService resource to delete. -// - project: Project ID for this request. -// - region: Name of the region scoping this request. -func (r *RegionBackendServicesService) Delete(project string, region string, backendService string) *RegionBackendServicesDeleteCall { - c := &RegionBackendServicesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.project = project - c.region = region - c.backendService = backendService - 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 *RegionBackendServicesDeleteCall) RequestId(requestId string) *RegionBackendServicesDeleteCall { - 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 *RegionBackendServicesDeleteCall) Fields(s ...googleapi.Field) *RegionBackendServicesDeleteCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *RegionBackendServicesDeleteCall) Context(ctx context.Context) *RegionBackendServicesDeleteCall { - 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 *RegionBackendServicesDeleteCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *RegionBackendServicesDeleteCall) 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}/backendServices/{backendService}") - 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, - "backendService": c.backendService, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "compute.regionBackendServices.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 *RegionBackendServicesDeleteCall) 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 RegionBackendServicesGetCall struct { - s *Service - project string - region string - backendService string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// Get: Returns the specified regional BackendService resource. -// -// - backendService: Name of the BackendService resource to return. -// - project: Project ID for this request. -// - region: Name of the region scoping this request. -func (r *RegionBackendServicesService) Get(project string, region string, backendService string) *RegionBackendServicesGetCall { - c := &RegionBackendServicesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.project = project - c.region = region - c.backendService = backendService - 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 *RegionBackendServicesGetCall) Fields(s ...googleapi.Field) *RegionBackendServicesGetCall { - 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 *RegionBackendServicesGetCall) IfNoneMatch(entityTag string) *RegionBackendServicesGetCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *RegionBackendServicesGetCall) Context(ctx context.Context) *RegionBackendServicesGetCall { - 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 *RegionBackendServicesGetCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *RegionBackendServicesGetCall) 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}/backendServices/{backendService}") - 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, - "backendService": c.backendService, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "compute.regionBackendServices.get" call. -// Any non-2xx status code is an error. Response headers are in either -// *BackendService.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 *RegionBackendServicesGetCall) Do(opts ...googleapi.CallOption) (*BackendService, 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 := &BackendService{ - 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 RegionBackendServicesGetHealthCall struct { - s *Service - project string - region string - backendService string - resourcegroupreference *ResourceGroupReference - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// GetHealth: Gets the most recent health check results for this regional -// BackendService. -// -// - backendService: Name of the BackendService resource for which to get -// health. -// - project: . -// - region: Name of the region scoping this request. -func (r *RegionBackendServicesService) GetHealth(project string, region string, backendService string, resourcegroupreference *ResourceGroupReference) *RegionBackendServicesGetHealthCall { - c := &RegionBackendServicesGetHealthCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.project = project - c.region = region - c.backendService = backendService - c.resourcegroupreference = resourcegroupreference - 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 *RegionBackendServicesGetHealthCall) Fields(s ...googleapi.Field) *RegionBackendServicesGetHealthCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *RegionBackendServicesGetHealthCall) Context(ctx context.Context) *RegionBackendServicesGetHealthCall { - 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 *RegionBackendServicesGetHealthCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *RegionBackendServicesGetHealthCall) 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.resourcegroupreference) - 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}/backendServices/{backendService}/getHealth") - 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, - "backendService": c.backendService, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "compute.regionBackendServices.getHealth" call. -// Any non-2xx status code is an error. Response headers are in either -// *BackendServiceGroupHealth.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 *RegionBackendServicesGetHealthCall) Do(opts ...googleapi.CallOption) (*BackendServiceGroupHealth, 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 := &BackendServiceGroupHealth{ - 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 RegionBackendServicesGetIamPolicyCall struct { - s *Service - project string - region string - resource string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// GetIamPolicy: Gets the access control policy for a resource. May be empty if -// no such policy or resource exists. -// -// - project: Project ID for this request. -// - region: The name of the region for this request. -// - resource: Name or id of the resource for this request. -func (r *RegionBackendServicesService) GetIamPolicy(project string, region string, resource string) *RegionBackendServicesGetIamPolicyCall { - c := &RegionBackendServicesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.project = project - c.region = region - c.resource = resource - return c -} - -// OptionsRequestedPolicyVersion sets the optional parameter -// "optionsRequestedPolicyVersion": Requested IAM Policy version. -func (c *RegionBackendServicesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *RegionBackendServicesGetIamPolicyCall { - c.urlParams_.Set("optionsRequestedPolicyVersion", 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 *RegionBackendServicesGetIamPolicyCall) Fields(s ...googleapi.Field) *RegionBackendServicesGetIamPolicyCall { - 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 *RegionBackendServicesGetIamPolicyCall) IfNoneMatch(entityTag string) *RegionBackendServicesGetIamPolicyCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *RegionBackendServicesGetIamPolicyCall) Context(ctx context.Context) *RegionBackendServicesGetIamPolicyCall { - 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 *RegionBackendServicesGetIamPolicyCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *RegionBackendServicesGetIamPolicyCall) 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}/backendServices/{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{ - "project": c.project, - "region": c.region, - "resource": c.resource, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "compute.regionBackendServices.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 *RegionBackendServicesGetIamPolicyCall) 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{ + ret := &Policy{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -25940,7 +25007,236 @@ func (c *RegionUrlMapsListCall) Pages(ctx context.Context, f func(*UrlMapList) e } } -type RegionUrlMapsPatchCall struct { +type RegionUrlMapsPatchCall struct { + s *Service + project string + region string + urlMap string + urlmap *UrlMap + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Patches the specified UrlMap resource with the data included in the +// request. This method supports PATCH semantics and uses JSON merge patch +// format and processing rules. +// +// - project: Project ID for this request. +// - region: Name of the region scoping this request. +// - urlMap: Name of the UrlMap resource to patch. +func (r *RegionUrlMapsService) Patch(project string, region string, urlMap string, urlmap *UrlMap) *RegionUrlMapsPatchCall { + c := &RegionUrlMapsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.region = region + c.urlMap = urlMap + c.urlmap = urlmap + return c +} + +// RequestId sets the optional parameter "requestId": begin_interface: +// MixerMutationRequestBuilder Request ID to support idempotency. +func (c *RegionUrlMapsPatchCall) RequestId(requestId string) *RegionUrlMapsPatchCall { + 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 *RegionUrlMapsPatchCall) Fields(s ...googleapi.Field) *RegionUrlMapsPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *RegionUrlMapsPatchCall) Context(ctx context.Context) *RegionUrlMapsPatchCall { + 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 *RegionUrlMapsPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *RegionUrlMapsPatchCall) 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.urlmap) + 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}/urlMaps/{urlMap}") + 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{ + "project": c.project, + "region": c.region, + "urlMap": c.urlMap, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.regionUrlMaps.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 *RegionUrlMapsPatchCall) 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 RegionUrlMapsTestIamPermissionsCall struct { + s *Service + project string + region string + resource string + testpermissionsrequest *TestPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// TestIamPermissions: Returns permissions that a caller has on the specified +// resource. +// +// - project: Project ID for this request. +// - region: The name of the region for this request. +// - resource: Name or id of the resource for this request. +func (r *RegionUrlMapsService) TestIamPermissions(project string, region string, resource string, testpermissionsrequest *TestPermissionsRequest) *RegionUrlMapsTestIamPermissionsCall { + c := &RegionUrlMapsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.region = region + c.resource = resource + c.testpermissionsrequest = testpermissionsrequest + 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 *RegionUrlMapsTestIamPermissionsCall) Fields(s ...googleapi.Field) *RegionUrlMapsTestIamPermissionsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *RegionUrlMapsTestIamPermissionsCall) Context(ctx context.Context) *RegionUrlMapsTestIamPermissionsCall { + 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 *RegionUrlMapsTestIamPermissionsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *RegionUrlMapsTestIamPermissionsCall) 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.testpermissionsrequest) + 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}/urlMaps/{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{ + "project": c.project, + "region": c.region, + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.regionUrlMaps.testIamPermissions" call. +// Any non-2xx status code is an error. Response headers are in either +// *TestPermissionsResponse.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 *RegionUrlMapsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestPermissionsResponse, 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 := &TestPermissionsResponse{ + 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 RegionUrlMapsUpdateCall struct { s *Service project string region string @@ -25951,15 +25247,14 @@ type RegionUrlMapsPatchCall struct { header_ http.Header } -// Patch: Patches the specified UrlMap resource with the data included in the -// request. This method supports PATCH semantics and uses JSON merge patch -// format and processing rules. +// Update: Updates the specified UrlMap resource with the data included in the +// request. // // - project: Project ID for this request. // - region: Name of the region scoping this request. -// - urlMap: Name of the UrlMap resource to patch. -func (r *RegionUrlMapsService) Patch(project string, region string, urlMap string, urlmap *UrlMap) *RegionUrlMapsPatchCall { - c := &RegionUrlMapsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - urlMap: Name of the UrlMap resource to update. +func (r *RegionUrlMapsService) Update(project string, region string, urlMap string, urlmap *UrlMap) *RegionUrlMapsUpdateCall { + c := &RegionUrlMapsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project c.region = region c.urlMap = urlMap @@ -25969,7 +25264,7 @@ func (r *RegionUrlMapsService) Patch(project string, region string, urlMap strin // RequestId sets the optional parameter "requestId": begin_interface: // MixerMutationRequestBuilder Request ID to support idempotency. -func (c *RegionUrlMapsPatchCall) RequestId(requestId string) *RegionUrlMapsPatchCall { +func (c *RegionUrlMapsUpdateCall) RequestId(requestId string) *RegionUrlMapsUpdateCall { c.urlParams_.Set("requestId", requestId) return c } @@ -25977,27 +25272,27 @@ func (c *RegionUrlMapsPatchCall) RequestId(requestId string) *RegionUrlMapsPatch // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *RegionUrlMapsPatchCall) Fields(s ...googleapi.Field) *RegionUrlMapsPatchCall { +func (c *RegionUrlMapsUpdateCall) Fields(s ...googleapi.Field) *RegionUrlMapsUpdateCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *RegionUrlMapsPatchCall) Context(ctx context.Context) *RegionUrlMapsPatchCall { +func (c *RegionUrlMapsUpdateCall) Context(ctx context.Context) *RegionUrlMapsUpdateCall { 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 *RegionUrlMapsPatchCall) Header() http.Header { +func (c *RegionUrlMapsUpdateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *RegionUrlMapsPatchCall) doRequest(alt string) (*http.Response, error) { +func (c *RegionUrlMapsUpdateCall) 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.urlmap) @@ -26008,7 +25303,7 @@ func (c *RegionUrlMapsPatchCall) doRequest(alt string) (*http.Response, error) { c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/urlMaps/{urlMap}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("PATCH", urls, body) + req, err := http.NewRequest("PUT", urls, body) if err != nil { return nil, err } @@ -26021,12 +25316,12 @@ func (c *RegionUrlMapsPatchCall) doRequest(alt string) (*http.Response, error) { return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "compute.regionUrlMaps.patch" call. +// Do executes the "compute.regionUrlMaps.update" 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 *RegionUrlMapsPatchCall) Do(opts ...googleapi.CallOption) (*Operation, error) { +func (c *RegionUrlMapsUpdateCall) Do(opts ...googleapi.CallOption) (*Operation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -26058,65 +25353,66 @@ func (c *RegionUrlMapsPatchCall) Do(opts ...googleapi.CallOption) (*Operation, e return ret, nil } -type RegionUrlMapsTestIamPermissionsCall struct { - s *Service - project string - region string - resource string - testpermissionsrequest *TestPermissionsRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type RegionUrlMapsValidateCall struct { + s *Service + project string + region string + urlMap string + regionurlmapsvalidaterequest *RegionUrlMapsValidateRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// TestIamPermissions: Returns permissions that a caller has on the specified -// resource. +// Validate: Runs static validation for the UrlMap. In particular, the tests of +// the provided UrlMap will be run. Calling this method does NOT create the +// UrlMap. // // - project: Project ID for this request. -// - region: The name of the region for this request. -// - resource: Name or id of the resource for this request. -func (r *RegionUrlMapsService) TestIamPermissions(project string, region string, resource string, testpermissionsrequest *TestPermissionsRequest) *RegionUrlMapsTestIamPermissionsCall { - c := &RegionUrlMapsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - region: Name of the region scoping this request. +// - urlMap: Name of the UrlMap resource to be validated as. +func (r *RegionUrlMapsService) Validate(project string, region string, urlMap string, regionurlmapsvalidaterequest *RegionUrlMapsValidateRequest) *RegionUrlMapsValidateCall { + c := &RegionUrlMapsValidateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project c.region = region - c.resource = resource - c.testpermissionsrequest = testpermissionsrequest + c.urlMap = urlMap + c.regionurlmapsvalidaterequest = regionurlmapsvalidaterequest 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 *RegionUrlMapsTestIamPermissionsCall) Fields(s ...googleapi.Field) *RegionUrlMapsTestIamPermissionsCall { +func (c *RegionUrlMapsValidateCall) Fields(s ...googleapi.Field) *RegionUrlMapsValidateCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *RegionUrlMapsTestIamPermissionsCall) Context(ctx context.Context) *RegionUrlMapsTestIamPermissionsCall { +func (c *RegionUrlMapsValidateCall) Context(ctx context.Context) *RegionUrlMapsValidateCall { 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 *RegionUrlMapsTestIamPermissionsCall) Header() http.Header { +func (c *RegionUrlMapsValidateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *RegionUrlMapsTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { +func (c *RegionUrlMapsValidateCall) 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.testpermissionsrequest) + body, err := googleapi.WithoutDataWrapper.JSONReader(c.regionurlmapsvalidaterequest) 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}/urlMaps/{resource}/testIamPermissions") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/urlMaps/{urlMap}/validate") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -26124,20 +25420,20 @@ func (c *RegionUrlMapsTestIamPermissionsCall) doRequest(alt string) (*http.Respo } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "project": c.project, - "region": c.region, - "resource": c.resource, + "project": c.project, + "region": c.region, + "urlMap": c.urlMap, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "compute.regionUrlMaps.testIamPermissions" call. +// Do executes the "compute.regionUrlMaps.validate" call. // Any non-2xx status code is an error. Response headers are in either -// *TestPermissionsResponse.ServerResponse.Header or (if a response was +// *UrlMapsValidateResponse.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 *RegionUrlMapsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestPermissionsResponse, error) { +func (c *RegionUrlMapsValidateCall) Do(opts ...googleapi.CallOption) (*UrlMapsValidateResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -26156,7 +25452,7 @@ func (c *RegionUrlMapsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) ( if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &TestPermissionsResponse{ + ret := &UrlMapsValidateResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -26169,74 +25465,148 @@ func (c *RegionUrlMapsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) ( return ret, nil } -type RegionUrlMapsUpdateCall struct { - s *Service - project string - region string - urlMap string - urlmap *UrlMap - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type RegionZonesListCall struct { + s *Service + project string + region string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Update: Updates the specified UrlMap resource with the data included in the -// request. +// List: Retrieves the list of Zone resources under the specific region +// available to the specified project. // // - project: Project ID for this request. -// - region: Name of the region scoping this request. -// - urlMap: Name of the UrlMap resource to update. -func (r *RegionUrlMapsService) Update(project string, region string, urlMap string, urlmap *UrlMap) *RegionUrlMapsUpdateCall { - c := &RegionUrlMapsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - region: Region for this request. +func (r *RegionZonesService) List(project string, region string) *RegionZonesListCall { + c := &RegionZonesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project c.region = region - c.urlMap = urlMap - c.urlmap = urlmap return c } -// RequestId sets the optional parameter "requestId": begin_interface: -// MixerMutationRequestBuilder Request ID to support idempotency. -func (c *RegionUrlMapsUpdateCall) RequestId(requestId string) *RegionUrlMapsUpdateCall { - c.urlParams_.Set("requestId", requestId) +// 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 *RegionZonesListCall) Filter(filter string) *RegionZonesListCall { + 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 *RegionZonesListCall) MaxResults(maxResults int64) *RegionZonesListCall { + 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 *RegionZonesListCall) OrderBy(orderBy string) *RegionZonesListCall { + 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 *RegionZonesListCall) PageToken(pageToken string) *RegionZonesListCall { + 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 *RegionZonesListCall) ReturnPartialSuccess(returnPartialSuccess bool) *RegionZonesListCall { + 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 *RegionUrlMapsUpdateCall) Fields(s ...googleapi.Field) *RegionUrlMapsUpdateCall { +func (c *RegionZonesListCall) Fields(s ...googleapi.Field) *RegionZonesListCall { 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 *RegionZonesListCall) IfNoneMatch(entityTag string) *RegionZonesListCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *RegionUrlMapsUpdateCall) Context(ctx context.Context) *RegionUrlMapsUpdateCall { +func (c *RegionZonesListCall) Context(ctx context.Context) *RegionZonesListCall { 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 *RegionUrlMapsUpdateCall) Header() http.Header { +func (c *RegionZonesListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *RegionUrlMapsUpdateCall) 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.urlmap) - if err != nil { - return nil, err +func (c *RegionZonesListCall) 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}/urlMaps/{urlMap}") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/zones") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("PUT", urls, body) + req, err := http.NewRequest("GET", urls, body) if err != nil { return nil, err } @@ -26244,17 +25614,16 @@ func (c *RegionUrlMapsUpdateCall) doRequest(alt string) (*http.Response, error) googleapi.Expand(req.URL, map[string]string{ "project": c.project, "region": c.region, - "urlMap": c.urlMap, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "compute.regionUrlMaps.update" call. +// Do executes the "compute.regionZones.list" 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 +// *ZoneList.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 *RegionUrlMapsUpdateCall) Do(opts ...googleapi.CallOption) (*Operation, error) { +func (c *RegionZonesListCall) Do(opts ...googleapi.CallOption) (*ZoneList, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -26273,7 +25642,7 @@ func (c *RegionUrlMapsUpdateCall) Do(opts ...googleapi.CallOption) (*Operation, if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Operation{ + ret := &ZoneList{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -26283,71 +25652,105 @@ func (c *RegionUrlMapsUpdateCall) Do(opts ...googleapi.CallOption) (*Operation, if err := gensupport.DecodeResponse(target, res); err != nil { return nil, err } - return ret, nil + 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 *RegionZonesListCall) Pages(ctx context.Context, f func(*ZoneList) 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 RegionUrlMapsValidateCall struct { - s *Service - project string - region string - urlMap string - regionurlmapsvalidaterequest *RegionUrlMapsValidateRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type RegionsGetCall struct { + s *Service + project string + region string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Validate: Runs static validation for the UrlMap. In particular, the tests of -// the provided UrlMap will be run. Calling this method does NOT create the -// UrlMap. +// Get: Returns the specified Region resource. To decrease latency for this +// method, you can optionally omit any unneeded information from the response +// by using a field mask. This practice is especially recommended for unused +// quota information (the `quotas` field). To exclude one or more fields, set +// your request's `fields` query parameter to only include the fields you need. +// For example, to only include the `id` and `selfLink` fields, add the query +// parameter `?fields=id,selfLink` to your request. This method fails if the +// quota information is unavailable for the region and if the organization +// policy constraint compute.requireBasicQuotaInResponse is enforced. This +// constraint, when enforced, disables the fail-open behaviour when quota +// information (the `items.quotas` field) is unavailable for the region. It is +// recommended to use the default setting for the constraint unless your +// application requires the fail-closed behaviour for this method. // // - project: Project ID for this request. -// - region: Name of the region scoping this request. -// - urlMap: Name of the UrlMap resource to be validated as. -func (r *RegionUrlMapsService) Validate(project string, region string, urlMap string, regionurlmapsvalidaterequest *RegionUrlMapsValidateRequest) *RegionUrlMapsValidateCall { - c := &RegionUrlMapsValidateCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - region: Name of the region resource to return. +func (r *RegionsService) Get(project string, region string) *RegionsGetCall { + c := &RegionsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project c.region = region - c.urlMap = urlMap - c.regionurlmapsvalidaterequest = regionurlmapsvalidaterequest 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 *RegionUrlMapsValidateCall) Fields(s ...googleapi.Field) *RegionUrlMapsValidateCall { +func (c *RegionsGetCall) Fields(s ...googleapi.Field) *RegionsGetCall { 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 *RegionsGetCall) IfNoneMatch(entityTag string) *RegionsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *RegionUrlMapsValidateCall) Context(ctx context.Context) *RegionUrlMapsValidateCall { +func (c *RegionsGetCall) Context(ctx context.Context) *RegionsGetCall { 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 *RegionUrlMapsValidateCall) Header() http.Header { +func (c *RegionsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *RegionUrlMapsValidateCall) 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.regionurlmapsvalidaterequest) - if err != nil { - return nil, err +func (c *RegionsGetCall) 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}/urlMaps/{urlMap}/validate") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("GET", urls, body) if err != nil { return nil, err } @@ -26355,18 +25758,16 @@ func (c *RegionUrlMapsValidateCall) doRequest(alt string) (*http.Response, error googleapi.Expand(req.URL, map[string]string{ "project": c.project, "region": c.region, - "urlMap": c.urlMap, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "compute.regionUrlMaps.validate" call. +// Do executes the "compute.regions.get" call. // Any non-2xx status code is an error. Response headers are in either -// *UrlMapsValidateResponse.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 *RegionUrlMapsValidateCall) Do(opts ...googleapi.CallOption) (*UrlMapsValidateResponse, error) { +// *Region.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 *RegionsGetCall) Do(opts ...googleapi.CallOption) (*Region, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -26385,7 +25786,7 @@ func (c *RegionUrlMapsValidateCall) Do(opts ...googleapi.CallOption) (*UrlMapsVa if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &UrlMapsValidateResponse{ + ret := &Region{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -26398,25 +25799,34 @@ func (c *RegionUrlMapsValidateCall) Do(opts ...googleapi.CallOption) (*UrlMapsVa return ret, nil } -type RegionZonesListCall struct { +type RegionsListCall struct { s *Service project string - region string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } -// List: Retrieves the list of Zone resources under the specific region -// available to the specified project. +// List: Retrieves the list of region resources available to the specified +// project. To decrease latency for this method, you can optionally omit any +// unneeded information from the response by using a field mask. This practice +// is especially recommended for unused quota information (the `items.quotas` +// field). To exclude one or more fields, set your request's `fields` query +// parameter to only include the fields you need. For example, to only include +// the `id` and `selfLink` fields, add the query parameter +// `?fields=id,selfLink` to your request. This method fails if the quota +// information is unavailable for the region and if the organization policy +// constraint compute.requireBasicQuotaInResponse is enforced. This constraint, +// when enforced, disables the fail-open behaviour when quota information (the +// `items.quotas` field) is unavailable for the region. It is recommended to +// use the default setting for the constraint unless your application requires +// the fail-closed behaviour for this method. // // - project: Project ID for this request. -// - region: Region for this request. -func (r *RegionZonesService) List(project string, region string) *RegionZonesListCall { - c := &RegionZonesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *RegionsService) List(project string) *RegionsListCall { + c := &RegionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project - c.region = region return c } @@ -26452,7 +25862,7 @@ func (r *RegionZonesService) List(project string, region string) *RegionZonesLis // filter for 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 *RegionZonesListCall) Filter(filter string) *RegionZonesListCall { +func (c *RegionsListCall) Filter(filter string) *RegionsListCall { c.urlParams_.Set("filter", filter) return c } @@ -26462,7 +25872,7 @@ func (c *RegionZonesListCall) Filter(filter string) *RegionZonesListCall { // is larger than `maxResults`, Compute Engine returns a `nextPageToken` 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 *RegionZonesListCall) MaxResults(maxResults int64) *RegionZonesListCall { +func (c *RegionsListCall) MaxResults(maxResults int64) *RegionsListCall { c.urlParams_.Set("maxResults", fmt.Sprint(maxResults)) return c } @@ -26475,7 +25885,7 @@ func (c *RegionZonesListCall) MaxResults(maxResults int64) *RegionZonesListCall // chronological order (newest result first). Use 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 *RegionZonesListCall) OrderBy(orderBy string) *RegionZonesListCall { +func (c *RegionsListCall) OrderBy(orderBy string) *RegionsListCall { c.urlParams_.Set("orderBy", orderBy) return c } @@ -26483,7 +25893,7 @@ func (c *RegionZonesListCall) OrderBy(orderBy string) *RegionZonesListCall { // 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 *RegionZonesListCall) PageToken(pageToken string) *RegionZonesListCall { +func (c *RegionsListCall) PageToken(pageToken string) *RegionsListCall { c.urlParams_.Set("pageToken", pageToken) return c } @@ -26493,7 +25903,7 @@ func (c *RegionZonesListCall) PageToken(pageToken string) *RegionZonesListCall { // of failure. The default value is false. For example, when partial 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 *RegionZonesListCall) ReturnPartialSuccess(returnPartialSuccess bool) *RegionZonesListCall { +func (c *RegionsListCall) ReturnPartialSuccess(returnPartialSuccess bool) *RegionsListCall { c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) return c } @@ -26501,7 +25911,7 @@ func (c *RegionZonesListCall) ReturnPartialSuccess(returnPartialSuccess bool) *R // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *RegionZonesListCall) Fields(s ...googleapi.Field) *RegionZonesListCall { +func (c *RegionsListCall) Fields(s ...googleapi.Field) *RegionsListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -26509,27 +25919,27 @@ func (c *RegionZonesListCall) Fields(s ...googleapi.Field) *RegionZonesListCall // 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 *RegionZonesListCall) IfNoneMatch(entityTag string) *RegionZonesListCall { +func (c *RegionsListCall) IfNoneMatch(entityTag string) *RegionsListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *RegionZonesListCall) Context(ctx context.Context) *RegionZonesListCall { +func (c *RegionsListCall) Context(ctx context.Context) *RegionsListCall { 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 *RegionZonesListCall) Header() http.Header { +func (c *RegionsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *RegionZonesListCall) doRequest(alt string) (*http.Response, error) { +func (c *RegionsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) @@ -26537,7 +25947,7 @@ func (c *RegionZonesListCall) doRequest(alt string) (*http.Response, error) { 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}/zones") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, body) if err != nil { @@ -26546,17 +25956,16 @@ func (c *RegionZonesListCall) doRequest(alt string) (*http.Response, error) { 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.regionZones.list" call. +// Do executes the "compute.regions.list" call. // Any non-2xx status code is an error. Response headers are in either -// *ZoneList.ServerResponse.Header or (if a response was returned at all) in +// *RegionList.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 *RegionZonesListCall) Do(opts ...googleapi.CallOption) (*ZoneList, error) { +func (c *RegionsListCall) Do(opts ...googleapi.CallOption) (*RegionList, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -26575,7 +25984,7 @@ func (c *RegionZonesListCall) Do(opts ...googleapi.CallOption) (*ZoneList, error if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &ZoneList{ + ret := &RegionList{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -26591,7 +26000,7 @@ func (c *RegionZonesListCall) Do(opts ...googleapi.CallOption) (*ZoneList, error // 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 *RegionZonesListCall) Pages(ctx context.Context, f func(*ZoneList) error) error { +func (c *RegionsListCall) Pages(ctx context.Context, f func(*RegionList) error) error { c.ctx_ = ctx defer c.PageToken(c.urlParams_.Get("pageToken")) for { @@ -26609,43 +26018,40 @@ func (c *RegionZonesListCall) Pages(ctx context.Context, f func(*ZoneList) error } } -type RegionsGetCall struct { - s *Service - project string - region string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ReservationBlocksGetCall struct { + s *Service + project string + zone string + reservation string + reservationBlock string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Get: Returns the specified Region resource. To decrease latency for this -// method, you can optionally omit any unneeded information from the response -// by using a field mask. This practice is especially recommended for unused -// quota information (the `quotas` field). To exclude one or more fields, set -// your request's `fields` query parameter to only include the fields you need. -// For example, to only include the `id` and `selfLink` fields, add the query -// parameter `?fields=id,selfLink` to your request. This method fails if the -// quota information is unavailable for the region and if the organization -// policy constraint compute.requireBasicQuotaInResponse is enforced. This -// constraint, when enforced, disables the fail-open behaviour when quota -// information (the `items.quotas` field) is unavailable for the region. It is -// recommended to use the default setting for the constraint unless your -// application requires the fail-closed behaviour for this method. +// Get: Retrieves information about the specified reservation block. // -// - project: Project ID for this request. -// - region: Name of the region resource to return. -func (r *RegionsService) Get(project string, region string) *RegionsGetCall { - c := &RegionsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - project: Project ID for this request. +// - reservation: The name of the reservation. Name should conform to RFC1035 +// or be a resource ID. +// - reservationBlock: The name of the reservation block. Name should conform +// to RFC1035 or be a resource ID. +// - zone: Name of the zone for this request. Zone name should conform to +// RFC1035. +func (r *ReservationBlocksService) Get(project string, zone string, reservation string, reservationBlock string) *ReservationBlocksGetCall { + c := &ReservationBlocksGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project - c.region = region + c.zone = zone + c.reservation = reservation + c.reservationBlock = reservationBlock 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 *RegionsGetCall) Fields(s ...googleapi.Field) *RegionsGetCall { +func (c *ReservationBlocksGetCall) Fields(s ...googleapi.Field) *ReservationBlocksGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -26653,27 +26059,27 @@ func (c *RegionsGetCall) Fields(s ...googleapi.Field) *RegionsGetCall { // 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 *RegionsGetCall) IfNoneMatch(entityTag string) *RegionsGetCall { +func (c *ReservationBlocksGetCall) IfNoneMatch(entityTag string) *ReservationBlocksGetCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *RegionsGetCall) Context(ctx context.Context) *RegionsGetCall { +func (c *ReservationBlocksGetCall) Context(ctx context.Context) *ReservationBlocksGetCall { 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 *RegionsGetCall) Header() http.Header { +func (c *ReservationBlocksGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *RegionsGetCall) doRequest(alt string) (*http.Response, error) { +func (c *ReservationBlocksGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) @@ -26681,7 +26087,7 @@ func (c *RegionsGetCall) doRequest(alt string) (*http.Response, error) { 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}") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/reservations/{reservation}/reservationBlocks/{reservationBlock}") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, body) if err != nil { @@ -26689,18 +26095,21 @@ func (c *RegionsGetCall) doRequest(alt string) (*http.Response, error) { } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "project": c.project, - "region": c.region, + "project": c.project, + "zone": c.zone, + "reservation": c.reservation, + "reservationBlock": c.reservationBlock, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "compute.regions.get" call. +// Do executes the "compute.reservationBlocks.get" call. // Any non-2xx status code is an error. Response headers are in either -// *Region.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 *RegionsGetCall) Do(opts ...googleapi.CallOption) (*Region, error) { +// *ReservationBlocksGetResponse.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 *ReservationBlocksGetCall) Do(opts ...googleapi.CallOption) (*ReservationBlocksGetResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -26719,7 +26128,7 @@ func (c *RegionsGetCall) Do(opts ...googleapi.CallOption) (*Region, error) { if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Region{ + ret := &ReservationBlocksGetResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -26732,34 +26141,29 @@ func (c *RegionsGetCall) Do(opts ...googleapi.CallOption) (*Region, error) { return ret, nil } -type RegionsListCall struct { +type ReservationBlocksListCall struct { s *Service project string + zone string + reservation string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } -// List: Retrieves the list of region resources available to the specified -// project. To decrease latency for this method, you can optionally omit any -// unneeded information from the response by using a field mask. This practice -// is especially recommended for unused quota information (the `items.quotas` -// field). To exclude one or more fields, set your request's `fields` query -// parameter to only include the fields you need. For example, to only include -// the `id` and `selfLink` fields, add the query parameter -// `?fields=id,selfLink` to your request. This method fails if the quota -// information is unavailable for the region and if the organization policy -// constraint compute.requireBasicQuotaInResponse is enforced. This constraint, -// when enforced, disables the fail-open behaviour when quota information (the -// `items.quotas` field) is unavailable for the region. It is recommended to -// use the default setting for the constraint unless your application requires -// the fail-closed behaviour for this method. +// List: Retrieves a list of reservation blocks under a single reservation. // -// - project: Project ID for this request. -func (r *RegionsService) List(project string) *RegionsListCall { - c := &RegionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - project: Project ID for this request. +// - reservation: The name of the reservation. Name should conform to RFC1035 +// or be a resource ID. +// - zone: Name of the zone for this request. Zone name should conform to +// RFC1035. +func (r *ReservationBlocksService) List(project string, zone string, reservation string) *ReservationBlocksListCall { + c := &ReservationBlocksListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.project = project + c.zone = zone + c.reservation = reservation return c } @@ -26795,7 +26199,7 @@ func (r *RegionsService) List(project string) *RegionsListCall { // filter for 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 *RegionsListCall) Filter(filter string) *RegionsListCall { +func (c *ReservationBlocksListCall) Filter(filter string) *ReservationBlocksListCall { c.urlParams_.Set("filter", filter) return c } @@ -26805,7 +26209,7 @@ func (c *RegionsListCall) Filter(filter string) *RegionsListCall { // is larger than `maxResults`, Compute Engine returns a `nextPageToken` 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 *RegionsListCall) MaxResults(maxResults int64) *RegionsListCall { +func (c *ReservationBlocksListCall) MaxResults(maxResults int64) *ReservationBlocksListCall { c.urlParams_.Set("maxResults", fmt.Sprint(maxResults)) return c } @@ -26818,7 +26222,7 @@ func (c *RegionsListCall) MaxResults(maxResults int64) *RegionsListCall { // chronological order (newest result first). Use 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 *RegionsListCall) OrderBy(orderBy string) *RegionsListCall { +func (c *ReservationBlocksListCall) OrderBy(orderBy string) *ReservationBlocksListCall { c.urlParams_.Set("orderBy", orderBy) return c } @@ -26826,7 +26230,7 @@ func (c *RegionsListCall) OrderBy(orderBy string) *RegionsListCall { // 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 *RegionsListCall) PageToken(pageToken string) *RegionsListCall { +func (c *ReservationBlocksListCall) PageToken(pageToken string) *ReservationBlocksListCall { c.urlParams_.Set("pageToken", pageToken) return c } @@ -26836,7 +26240,7 @@ func (c *RegionsListCall) PageToken(pageToken string) *RegionsListCall { // of failure. The default value is false. For example, when partial 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 *RegionsListCall) ReturnPartialSuccess(returnPartialSuccess bool) *RegionsListCall { +func (c *ReservationBlocksListCall) ReturnPartialSuccess(returnPartialSuccess bool) *ReservationBlocksListCall { c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) return c } @@ -26844,7 +26248,7 @@ func (c *RegionsListCall) ReturnPartialSuccess(returnPartialSuccess bool) *Regio // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *RegionsListCall) Fields(s ...googleapi.Field) *RegionsListCall { +func (c *ReservationBlocksListCall) Fields(s ...googleapi.Field) *ReservationBlocksListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -26852,27 +26256,27 @@ func (c *RegionsListCall) Fields(s ...googleapi.Field) *RegionsListCall { // 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 *RegionsListCall) IfNoneMatch(entityTag string) *RegionsListCall { +func (c *ReservationBlocksListCall) IfNoneMatch(entityTag string) *ReservationBlocksListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *RegionsListCall) Context(ctx context.Context) *RegionsListCall { +func (c *ReservationBlocksListCall) Context(ctx context.Context) *ReservationBlocksListCall { 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 *RegionsListCall) Header() http.Header { +func (c *ReservationBlocksListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *RegionsListCall) doRequest(alt string) (*http.Response, error) { +func (c *ReservationBlocksListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) @@ -26880,7 +26284,7 @@ func (c *RegionsListCall) doRequest(alt string) (*http.Response, error) { var body io.Reader = nil c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/zones/{zone}/reservations/{reservation}/reservationBlocks") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, body) if err != nil { @@ -26888,17 +26292,20 @@ func (c *RegionsListCall) doRequest(alt string) (*http.Response, error) { } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "project": c.project, + "project": c.project, + "zone": c.zone, + "reservation": c.reservation, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "compute.regions.list" call. +// Do executes the "compute.reservationBlocks.list" call. // Any non-2xx status code is an error. Response headers are in either -// *RegionList.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 *RegionsListCall) Do(opts ...googleapi.CallOption) (*RegionList, error) { +// *ReservationBlocksListResponse.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 *ReservationBlocksListCall) Do(opts ...googleapi.CallOption) (*ReservationBlocksListResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -26917,7 +26324,7 @@ func (c *RegionsListCall) Do(opts ...googleapi.CallOption) (*RegionList, error) if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &RegionList{ + ret := &ReservationBlocksListResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -26933,7 +26340,7 @@ func (c *RegionsListCall) Do(opts ...googleapi.CallOption) (*RegionList, error) // 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 *RegionsListCall) Pages(ctx context.Context, f func(*RegionList) error) error { +func (c *ReservationBlocksListCall) Pages(ctx context.Context, f func(*ReservationBlocksListResponse) error) error { c.ctx_ = ctx defer c.PageToken(c.urlParams_.Get("pageToken")) for { diff --git a/compute/v1/compute-api.json b/compute/v1/compute-api.json index 2c94b4bc795..dfd842b6d9d 100644 --- a/compute/v1/compute-api.json +++ b/compute/v1/compute-api.json @@ -37421,7 +37421,7 @@ } } }, - "revision": "20241008", + "revision": "20241015", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -39140,7 +39140,7 @@ "type": "object" }, "AuditConfig": { - "description": "Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { \"audit_configs\": [ { \"service\": \"allServices\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\", \"exempted_members\": [ \"user:jose@example.com\" ] }, { \"log_type\": \"DATA_WRITE\" }, { \"log_type\": \"ADMIN_READ\" } ] }, { \"service\": \"sampleservice.googleapis.com\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\" }, { \"log_type\": \"DATA_WRITE\", \"exempted_members\": [ \"user:aliya@example.com\" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts jose@example.com from DATA_READ logging, and aliya@example.com from DATA_WRITE logging.", + "description": "Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { \"audit_configs\": [ { \"service\": \"allServices\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\", \"exempted_members\": [ \"user:jose@example.com\" ] }, { \"log_type\": \"DATA_WRITE\" }, { \"log_type\": \"ADMIN_READ\" } ] }, { \"service\": \"sampleservice.googleapis.com\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\" }, { \"log_type\": \"DATA_WRITE\", \"exempted_members\": [ \"user:aliya@example.com\" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts `jose@example.com` from DATA_READ logging, and `aliya@example.com` from DATA_WRITE logging.", "id": "AuditConfig", "properties": { "auditLogConfigs": { @@ -41932,10 +41932,6 @@ "description": "Associates `members`, or principals, with a `role`.", "id": "Binding", "properties": { - "bindingId": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string" - }, "condition": { "$ref": "Expr", "description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)." @@ -42802,86 +42798,6 @@ }, "type": "object" }, - "Condition": { - "description": "This is deprecated and has no effect. Do not use.", - "id": "Condition", - "properties": { - "iam": { - "description": "This is deprecated and has no effect. Do not use.", - "enum": [ - "APPROVER", - "ATTRIBUTION", - "AUTHORITY", - "CREDENTIALS_TYPE", - "CREDS_ASSERTION", - "JUSTIFICATION_TYPE", - "NO_ATTR", - "SECURITY_REALM" - ], - "enumDescriptions": [ - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use." - ], - "type": "string" - }, - "op": { - "description": "This is deprecated and has no effect. Do not use.", - "enum": [ - "DISCHARGED", - "EQUALS", - "IN", - "NOT_EQUALS", - "NOT_IN", - "NO_OP" - ], - "enumDescriptions": [ - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use." - ], - "type": "string" - }, - "svc": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string" - }, - "sys": { - "description": "This is deprecated and has no effect. Do not use.", - "enum": [ - "IP", - "NAME", - "NO_ATTR", - "REGION", - "SERVICE" - ], - "enumDescriptions": [ - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use." - ], - "type": "string" - }, - "values": { - "description": "This is deprecated and has no effect. Do not use.", - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "ConfidentialInstanceConfig": { "description": "A set of Confidential Instance options.", "id": "ConfidentialInstanceConfig", @@ -50188,6 +50104,10 @@ "format": "uint64", "type": "string" }, + "instanceFlexibilityPolicy": { + "$ref": "InstanceGroupManagerInstanceFlexibilityPolicy", + "description": "Instance flexibility allowing MIG to create VMs from multiple types of machines. Instance flexibility configuration on MIG overrides instance template configuration." + }, "instanceGroup": { "description": "[Output Only] The URL of the Instance Group resource.", "type": "string" @@ -50229,7 +50149,7 @@ "type": "string" }, "namedPorts": { - "description": "Named ports configured for the Instance Groups complementary to this Instance Group Manager.", + "description": "[Output Only] Named ports configured on the Instance Groups complementary to this Instance Group Manager.", "items": { "$ref": "NamedPort" }, @@ -50550,6 +50470,37 @@ }, "type": "object" }, + "InstanceGroupManagerInstanceFlexibilityPolicy": { + "id": "InstanceGroupManagerInstanceFlexibilityPolicy", + "properties": { + "instanceSelections": { + "additionalProperties": { + "$ref": "InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection" + }, + "description": "Named instance selections configuring properties that the group will use when creating new VMs.", + "type": "object" + } + }, + "type": "object" + }, + "InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection": { + "id": "InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection", + "properties": { + "machineTypes": { + "description": "Full machine-type names, e.g. \"n1-standard-16\".", + "items": { + "type": "string" + }, + "type": "array" + }, + "rank": { + "description": "Preference of this instance selection. Lower number means higher preference. MIG will first try to create a VM based on the machine-type with lowest rank and fallback to next rank based on availability. Machine types and instance selections with the same rank have the same preference.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, "InstanceGroupManagerInstanceLifecyclePolicy": { "id": "InstanceGroupManagerInstanceLifecyclePolicy", "properties": { @@ -56780,102 +56731,6 @@ }, "type": "object" }, - "LogConfig": { - "description": "This is deprecated and has no effect. Do not use.", - "id": "LogConfig", - "properties": { - "cloudAudit": { - "$ref": "LogConfigCloudAuditOptions", - "description": "This is deprecated and has no effect. Do not use." - }, - "counter": { - "$ref": "LogConfigCounterOptions", - "description": "This is deprecated and has no effect. Do not use." - }, - "dataAccess": { - "$ref": "LogConfigDataAccessOptions", - "description": "This is deprecated and has no effect. Do not use." - } - }, - "type": "object" - }, - "LogConfigCloudAuditOptions": { - "description": "This is deprecated and has no effect. Do not use.", - "id": "LogConfigCloudAuditOptions", - "properties": { - "logName": { - "description": "This is deprecated and has no effect. Do not use.", - "enum": [ - "ADMIN_ACTIVITY", - "DATA_ACCESS", - "UNSPECIFIED_LOG_NAME" - ], - "enumDescriptions": [ - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use." - ], - "type": "string" - } - }, - "type": "object" - }, - "LogConfigCounterOptions": { - "description": "This is deprecated and has no effect. Do not use.", - "id": "LogConfigCounterOptions", - "properties": { - "customFields": { - "description": "This is deprecated and has no effect. Do not use.", - "items": { - "$ref": "LogConfigCounterOptionsCustomField" - }, - "type": "array" - }, - "field": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string" - }, - "metric": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string" - } - }, - "type": "object" - }, - "LogConfigCounterOptionsCustomField": { - "description": "This is deprecated and has no effect. Do not use.", - "id": "LogConfigCounterOptionsCustomField", - "properties": { - "name": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string" - }, - "value": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string" - } - }, - "type": "object" - }, - "LogConfigDataAccessOptions": { - "description": "This is deprecated and has no effect. Do not use.", - "id": "LogConfigDataAccessOptions", - "properties": { - "logMode": { - "description": "This is deprecated and has no effect. Do not use.", - "enum": [ - "LOG_FAIL_CLOSED", - "LOG_MODE_UNSPECIFIED" - ], - "enumDescriptions": [ - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use." - ], - "type": "string" - } - }, - "type": "object" - }, "MachineImage": { "description": "Represents a machine image resource. A machine image is a Compute Engine resource that stores all the configuration, metadata, permissions, and data from one or more disks required to create a Virtual machine (VM) instance. For more information, see Machine images.", "id": "MachineImage", @@ -57800,6 +57655,10 @@ "$ref": "PreservedState", "description": "[Output Only] Preserved state generated based on stateful policy for this instance." }, + "propertiesFromFlexibilityPolicy": { + "$ref": "ManagedInstancePropertiesFromFlexibilityPolicy", + "description": "[Output Only] Instance properties selected for this instance resulting from InstanceFlexibilityPolicy." + }, "version": { "$ref": "ManagedInstanceVersion", "description": "[Output Only] Intended version of this instance." @@ -57889,6 +57748,16 @@ }, "type": "object" }, + "ManagedInstancePropertiesFromFlexibilityPolicy": { + "id": "ManagedInstancePropertiesFromFlexibilityPolicy", + "properties": { + "machineType": { + "description": "The machine type to be used for this instance.", + "type": "string" + } + }, + "type": "object" + }, "ManagedInstanceVersion": { "id": "ManagedInstanceVersion", "properties": { @@ -64336,13 +64205,6 @@ "format": "byte", "type": "string" }, - "rules": { - "description": "This is deprecated and has no effect. Do not use.", - "items": { - "$ref": "Rule" - }, - "type": "array" - }, "version": { "description": "Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", "format": "int32", @@ -71090,72 +70952,6 @@ }, "type": "object" }, - "Rule": { - "description": "This is deprecated and has no effect. Do not use.", - "id": "Rule", - "properties": { - "action": { - "description": "This is deprecated and has no effect. Do not use.", - "enum": [ - "ALLOW", - "ALLOW_WITH_LOG", - "DENY", - "DENY_WITH_LOG", - "LOG", - "NO_ACTION" - ], - "enumDescriptions": [ - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use." - ], - "type": "string" - }, - "conditions": { - "description": "This is deprecated and has no effect. Do not use.", - "items": { - "$ref": "Condition" - }, - "type": "array" - }, - "description": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string" - }, - "ins": { - "description": "This is deprecated and has no effect. Do not use.", - "items": { - "type": "string" - }, - "type": "array" - }, - "logConfigs": { - "description": "This is deprecated and has no effect. Do not use.", - "items": { - "$ref": "LogConfig" - }, - "type": "array" - }, - "notIns": { - "description": "This is deprecated and has no effect. Do not use.", - "items": { - "type": "string" - }, - "type": "array" - }, - "permissions": { - "description": "This is deprecated and has no effect. Do not use.", - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "SSLHealthCheck": { "id": "SSLHealthCheck", "properties": { diff --git a/compute/v1/compute-gen.go b/compute/v1/compute-gen.go index c60e16b369b..e5dff1873e5 100644 --- a/compute/v1/compute-gen.go +++ b/compute/v1/compute-gen.go @@ -3255,8 +3255,8 @@ func (s AttachedDiskInitializeParams) MarshalJSON() ([]byte, error) { // "audit_log_configs": [ { "log_type": "DATA_READ" }, { "log_type": // "DATA_WRITE", "exempted_members": [ "user:aliya@example.com" ] } ] } ] } For // sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ -// logging. It also exempts jose@example.com from DATA_READ logging, and -// aliya@example.com from DATA_WRITE logging. +// logging. It also exempts `jose@example.com` from DATA_READ logging, and +// `aliya@example.com` from DATA_WRITE logging. type AuditConfig struct { // AuditLogConfigs: The configuration for logging of each type of permission. AuditLogConfigs []*AuditLogConfig `json:"auditLogConfigs,omitempty"` @@ -6732,8 +6732,6 @@ func (s BfdStatusPacketCounts) MarshalJSON() ([]byte, error) { // Binding: Associates `members`, or principals, with a `role`. type Binding struct { - // BindingId: This is deprecated and has no effect. Do not use. - BindingId string `json:"bindingId,omitempty"` // Condition: The condition that is associated with this binding. If the // condition evaluates to `true`, then this binding applies to the current // request. If the condition evaluates to `false`, then this binding does not @@ -6813,13 +6811,13 @@ type Binding struct { // available pre-defined roles, see here // (https://cloud.google.com/iam/docs/understanding-roles). Role string `json:"role,omitempty"` - // ForceSendFields is a list of field names (e.g. "BindingId") to + // ForceSendFields is a list of field names (e.g. "Condition") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "BindingId") to include in API + // NullFields is a list of field names (e.g. "Condition") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. @@ -7725,61 +7723,6 @@ func (s CommitmentsScopedListWarningData) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Condition: This is deprecated and has no effect. Do not use. -type Condition struct { - // Iam: This is deprecated and has no effect. Do not use. - // - // Possible values: - // "APPROVER" - This is deprecated and has no effect. Do not use. - // "ATTRIBUTION" - This is deprecated and has no effect. Do not use. - // "AUTHORITY" - This is deprecated and has no effect. Do not use. - // "CREDENTIALS_TYPE" - This is deprecated and has no effect. Do not use. - // "CREDS_ASSERTION" - This is deprecated and has no effect. Do not use. - // "JUSTIFICATION_TYPE" - This is deprecated and has no effect. Do not use. - // "NO_ATTR" - This is deprecated and has no effect. Do not use. - // "SECURITY_REALM" - This is deprecated and has no effect. Do not use. - Iam string `json:"iam,omitempty"` - // Op: This is deprecated and has no effect. Do not use. - // - // Possible values: - // "DISCHARGED" - This is deprecated and has no effect. Do not use. - // "EQUALS" - This is deprecated and has no effect. Do not use. - // "IN" - This is deprecated and has no effect. Do not use. - // "NOT_EQUALS" - This is deprecated and has no effect. Do not use. - // "NOT_IN" - This is deprecated and has no effect. Do not use. - // "NO_OP" - This is deprecated and has no effect. Do not use. - Op string `json:"op,omitempty"` - // Svc: This is deprecated and has no effect. Do not use. - Svc string `json:"svc,omitempty"` - // Sys: This is deprecated and has no effect. Do not use. - // - // Possible values: - // "IP" - This is deprecated and has no effect. Do not use. - // "NAME" - This is deprecated and has no effect. Do not use. - // "NO_ATTR" - This is deprecated and has no effect. Do not use. - // "REGION" - This is deprecated and has no effect. Do not use. - // "SERVICE" - This is deprecated and has no effect. Do not use. - Sys string `json:"sys,omitempty"` - // Values: This is deprecated and has no effect. Do not use. - Values []string `json:"values,omitempty"` - // ForceSendFields is a list of field names (e.g. "Iam") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Iam") to include in API requests - // with the JSON null value. By default, fields with empty values are omitted - // from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s Condition) MarshalJSON() ([]byte, error) { - type NoMethod Condition - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // ConfidentialInstanceConfig: A set of Confidential Instance options. type ConfidentialInstanceConfig struct { // ConfidentialInstanceType: Defines the type of technology used by the @@ -16300,6 +16243,10 @@ type InstanceGroupManager struct { // Id: [Output Only] A unique identifier for this resource type. The server // generates this identifier. Id uint64 `json:"id,omitempty,string"` + // InstanceFlexibilityPolicy: Instance flexibility allowing MIG to create VMs + // from multiple types of machines. Instance flexibility configuration on MIG + // overrides instance template configuration. + InstanceFlexibilityPolicy *InstanceGroupManagerInstanceFlexibilityPolicy `json:"instanceFlexibilityPolicy,omitempty"` // InstanceGroup: [Output Only] The URL of the Instance Group resource. InstanceGroup string `json:"instanceGroup,omitempty"` // InstanceLifecyclePolicy: The repair policy for this managed instance group. @@ -16326,8 +16273,8 @@ type InstanceGroupManager struct { // Name: The name of the managed instance group. The name must be 1-63 // characters long, and comply with RFC1035. Name string `json:"name,omitempty"` - // NamedPorts: Named ports configured for the Instance Groups complementary to - // this Instance Group Manager. + // NamedPorts: [Output Only] Named ports configured on the Instance Groups + // complementary to this Instance Group Manager. NamedPorts []*NamedPort `json:"namedPorts,omitempty"` // Region: [Output Only] The URL of the region where the managed instance group // resides (for regional resources). @@ -16670,6 +16617,54 @@ func (s InstanceGroupManagerAutoHealingPolicy) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type InstanceGroupManagerInstanceFlexibilityPolicy struct { + // InstanceSelections: Named instance selections configuring properties that + // the group will use when creating new VMs. + InstanceSelections map[string]InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection `json:"instanceSelections,omitempty"` + // ForceSendFields is a list of field names (e.g. "InstanceSelections") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "InstanceSelections") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s InstanceGroupManagerInstanceFlexibilityPolicy) MarshalJSON() ([]byte, error) { + type NoMethod InstanceGroupManagerInstanceFlexibilityPolicy + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection struct { + // MachineTypes: Full machine-type names, e.g. "n1-standard-16". + MachineTypes []string `json:"machineTypes,omitempty"` + // Rank: Preference of this instance selection. Lower number means higher + // preference. MIG will first try to create a VM based on the machine-type with + // lowest rank and fallback to next rank based on availability. Machine types + // and instance selections with the same rank have the same preference. + Rank int64 `json:"rank,omitempty"` + // ForceSendFields is a list of field names (e.g. "MachineTypes") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "MachineTypes") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection) MarshalJSON() ([]byte, error) { + type NoMethod InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type InstanceGroupManagerInstanceLifecyclePolicy struct { // DefaultActionOnFailure: The action that a MIG performs on a failed or an // unhealthy VM. A VM is marked as unhealthy when the application running on @@ -23872,138 +23867,6 @@ func (s LocationPolicyLocationConstraints) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// LogConfig: This is deprecated and has no effect. Do not use. -type LogConfig struct { - // CloudAudit: This is deprecated and has no effect. Do not use. - CloudAudit *LogConfigCloudAuditOptions `json:"cloudAudit,omitempty"` - // Counter: This is deprecated and has no effect. Do not use. - Counter *LogConfigCounterOptions `json:"counter,omitempty"` - // DataAccess: This is deprecated and has no effect. Do not use. - DataAccess *LogConfigDataAccessOptions `json:"dataAccess,omitempty"` - // ForceSendFields is a list of field names (e.g. "CloudAudit") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "CloudAudit") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s LogConfig) MarshalJSON() ([]byte, error) { - type NoMethod LogConfig - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// LogConfigCloudAuditOptions: This is deprecated and has no effect. Do not -// use. -type LogConfigCloudAuditOptions struct { - // LogName: This is deprecated and has no effect. Do not use. - // - // Possible values: - // "ADMIN_ACTIVITY" - This is deprecated and has no effect. Do not use. - // "DATA_ACCESS" - This is deprecated and has no effect. Do not use. - // "UNSPECIFIED_LOG_NAME" - This is deprecated and has no effect. Do not use. - LogName string `json:"logName,omitempty"` - // ForceSendFields is a list of field names (e.g. "LogName") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "LogName") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s LogConfigCloudAuditOptions) MarshalJSON() ([]byte, error) { - type NoMethod LogConfigCloudAuditOptions - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// LogConfigCounterOptions: This is deprecated and has no effect. Do not use. -type LogConfigCounterOptions struct { - // CustomFields: This is deprecated and has no effect. Do not use. - CustomFields []*LogConfigCounterOptionsCustomField `json:"customFields,omitempty"` - // Field: This is deprecated and has no effect. Do not use. - Field string `json:"field,omitempty"` - // Metric: This is deprecated and has no effect. Do not use. - Metric string `json:"metric,omitempty"` - // ForceSendFields is a list of field names (e.g. "CustomFields") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "CustomFields") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s LogConfigCounterOptions) MarshalJSON() ([]byte, error) { - type NoMethod LogConfigCounterOptions - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// LogConfigCounterOptionsCustomField: This is deprecated and has no effect. Do -// not use. -type LogConfigCounterOptionsCustomField struct { - // Name: This is deprecated and has no effect. Do not use. - Name string `json:"name,omitempty"` - // Value: This is deprecated and has no effect. Do not use. - Value string `json:"value,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 LogConfigCounterOptionsCustomField) MarshalJSON() ([]byte, error) { - type NoMethod LogConfigCounterOptionsCustomField - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// LogConfigDataAccessOptions: This is deprecated and has no effect. Do not -// use. -type LogConfigDataAccessOptions struct { - // LogMode: This is deprecated and has no effect. Do not use. - // - // Possible values: - // "LOG_FAIL_CLOSED" - This is deprecated and has no effect. Do not use. - // "LOG_MODE_UNSPECIFIED" - This is deprecated and has no effect. Do not use. - LogMode string `json:"logMode,omitempty"` - // ForceSendFields is a list of field names (e.g. "LogMode") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "LogMode") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s LogConfigDataAccessOptions) MarshalJSON() ([]byte, error) { - type NoMethod LogConfigDataAccessOptions - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // MachineImage: Represents a machine image resource. A machine image is a // Compute Engine resource that stores all the configuration, metadata, // permissions, and data from one or more disks required to create a Virtual @@ -24922,6 +24785,9 @@ type ManagedInstance struct { // PreservedStateFromPolicy: [Output Only] Preserved state generated based on // stateful policy for this instance. PreservedStateFromPolicy *PreservedState `json:"preservedStateFromPolicy,omitempty"` + // PropertiesFromFlexibilityPolicy: [Output Only] Instance properties selected + // for this instance resulting from InstanceFlexibilityPolicy. + PropertiesFromFlexibilityPolicy *ManagedInstancePropertiesFromFlexibilityPolicy `json:"propertiesFromFlexibilityPolicy,omitempty"` // Version: [Output Only] Intended version of this instance. Version *ManagedInstanceVersion `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "CurrentAction") to @@ -25081,6 +24947,27 @@ func (s ManagedInstanceLastAttemptErrorsErrorsErrorDetails) MarshalJSON() ([]byt return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type ManagedInstancePropertiesFromFlexibilityPolicy struct { + // MachineType: The machine type to be used for this instance. + MachineType string `json:"machineType,omitempty"` + // ForceSendFields is a list of field names (e.g. "MachineType") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "MachineType") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ManagedInstancePropertiesFromFlexibilityPolicy) MarshalJSON() ([]byte, error) { + type NoMethod ManagedInstancePropertiesFromFlexibilityPolicy + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type ManagedInstanceVersion struct { // InstanceTemplate: [Output Only] The intended template of the instance. This // field is empty when current_action is one of { DELETING, ABANDONING }. @@ -32106,8 +31993,6 @@ type Policy struct { // you to overwrite a version `3` policy with a version `1` policy, and all of // the conditions in the version `3` policy are lost. Etag string `json:"etag,omitempty"` - // Rules: This is deprecated and has no effect. Do not use. - Rules []*Rule `json:"rules,omitempty"` // Version: Specifies the format of the policy. Valid values are `0`, `1`, and // `3`. Requests that specify an invalid value are rejected. Any operation that // affects conditional role bindings must specify version `3`. This requirement @@ -39279,48 +39164,6 @@ func (s RoutersScopedListWarningData) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Rule: This is deprecated and has no effect. Do not use. -type Rule struct { - // Action: This is deprecated and has no effect. Do not use. - // - // Possible values: - // "ALLOW" - This is deprecated and has no effect. Do not use. - // "ALLOW_WITH_LOG" - This is deprecated and has no effect. Do not use. - // "DENY" - This is deprecated and has no effect. Do not use. - // "DENY_WITH_LOG" - This is deprecated and has no effect. Do not use. - // "LOG" - This is deprecated and has no effect. Do not use. - // "NO_ACTION" - This is deprecated and has no effect. Do not use. - Action string `json:"action,omitempty"` - // Conditions: This is deprecated and has no effect. Do not use. - Conditions []*Condition `json:"conditions,omitempty"` - // Description: This is deprecated and has no effect. Do not use. - Description string `json:"description,omitempty"` - // Ins: This is deprecated and has no effect. Do not use. - Ins []string `json:"ins,omitempty"` - // LogConfigs: This is deprecated and has no effect. Do not use. - LogConfigs []*LogConfig `json:"logConfigs,omitempty"` - // NotIns: This is deprecated and has no effect. Do not use. - NotIns []string `json:"notIns,omitempty"` - // Permissions: This is deprecated and has no effect. Do not use. - Permissions []string `json:"permissions,omitempty"` - // ForceSendFields is a list of field names (e.g. "Action") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Action") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s Rule) MarshalJSON() ([]byte, error) { - type NoMethod Rule - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - type SSLHealthCheck struct { // Port: The TCP port number to which the health check prober sends packets. // The default value is 443. Valid values are 1 through 65535. diff --git a/connectors/v1/connectors-api.json b/connectors/v1/connectors-api.json index 3a7a6c5cced..c0053724182 100644 --- a/connectors/v1/connectors-api.json +++ b/connectors/v1/connectors-api.json @@ -1095,6 +1095,11 @@ "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+$", "required": true, "type": "string" + }, + "schemaAsString": { + "description": "Optional. Flag to indicate if schema should be returned as string or not", + "location": "query", + "type": "boolean" } }, "path": "v1/{+parent}/runtimeActionSchemas", @@ -2497,7 +2502,7 @@ } } }, - "revision": "20240924", + "revision": "20241015", "rootUrl": "https://connectors.googleapis.com/", "schemas": { "AuditConfig": { @@ -3463,6 +3468,10 @@ "format": "int64", "type": "string" }, + "connectorVersioningEnabled": { + "description": "Indicate whether connector versioning is enabled.", + "type": "boolean" + }, "deploymentModel": { "description": "Indicate whether connector is deployed on GKE/CloudRun", "enum": [ @@ -7036,6 +7045,11 @@ "readOnly": true, "type": "array" }, + "inputSchemaAsString": { + "description": "Output only. Input schema as string.", + "readOnly": true, + "type": "string" + }, "resultJsonSchema": { "$ref": "JsonSchema", "description": "Output only. JsonSchema representation of this action's result metadata", @@ -7048,6 +7062,11 @@ }, "readOnly": true, "type": "array" + }, + "resultSchemaAsString": { + "description": "Output only. Result schema as string.", + "readOnly": true, + "type": "string" } }, "type": "object" @@ -7671,22 +7690,22 @@ "id": "TimeOfDay", "properties": { "hours": { - "description": "Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to allow the value \"24:00:00\" for scenarios like business closing time.", + "description": "Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or equal to 23. An API may choose to allow the value \"24:00:00\" for scenarios like business closing time.", "format": "int32", "type": "integer" }, "minutes": { - "description": "Minutes of hour of day. Must be from 0 to 59.", + "description": "Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59.", "format": "int32", "type": "integer" }, "nanos": { - "description": "Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.", + "description": "Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999.", "format": "int32", "type": "integer" }, "seconds": { - "description": "Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.", + "description": "Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An API may allow the value 60 if it allows leap-seconds.", "format": "int32", "type": "integer" } diff --git a/connectors/v1/connectors-gen.go b/connectors/v1/connectors-gen.go index f1bc0db1b75..34df551c87c 100644 --- a/connectors/v1/connectors-gen.go +++ b/connectors/v1/connectors-gen.go @@ -1273,6 +1273,9 @@ type ConnectorInfraConfig struct { // ConnectionRatelimitWindowSeconds: The window used for ratelimiting runtime // requests to connections. ConnectionRatelimitWindowSeconds int64 `json:"connectionRatelimitWindowSeconds,omitempty,string"` + // ConnectorVersioningEnabled: Indicate whether connector versioning is + // enabled. + ConnectorVersioningEnabled bool `json:"connectorVersioningEnabled,omitempty"` // DeploymentModel: Indicate whether connector is deployed on GKE/CloudRun // // Possible values: @@ -4746,11 +4749,15 @@ type RuntimeActionSchema struct { // InputParameters: Output only. List of input parameter metadata for the // action. InputParameters []*InputParameter `json:"inputParameters,omitempty"` + // InputSchemaAsString: Output only. Input schema as string. + InputSchemaAsString string `json:"inputSchemaAsString,omitempty"` // ResultJsonSchema: Output only. JsonSchema representation of this action's // result metadata ResultJsonSchema *JsonSchema `json:"resultJsonSchema,omitempty"` // ResultMetadata: Output only. List of result field metadata. ResultMetadata []*ResultMetadata `json:"resultMetadata,omitempty"` + // ResultSchemaAsString: Output only. Result schema as string. + ResultSchemaAsString string `json:"resultSchemaAsString,omitempty"` // ForceSendFields is a list of field names (e.g. "Action") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See @@ -5456,16 +5463,19 @@ func (s TestIamPermissionsResponse) MarshalJSON() ([]byte, error) { // significant or are specified elsewhere. An API may choose to allow leap // seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. type TimeOfDay struct { - // Hours: Hours of day in 24 hour format. Should be from 0 to 23. An API may - // choose to allow the value "24:00:00" for scenarios like business closing - // time. + // Hours: Hours of a day in 24 hour format. Must be greater than or equal to 0 + // and typically must be less than or equal to 23. An API may choose to allow + // the value "24:00:00" for scenarios like business closing time. Hours int64 `json:"hours,omitempty"` - // Minutes: Minutes of hour of day. Must be from 0 to 59. + // Minutes: Minutes of an hour. Must be greater than or equal to 0 and less + // than or equal to 59. Minutes int64 `json:"minutes,omitempty"` - // Nanos: Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999. + // Nanos: Fractions of seconds, in nanoseconds. Must be greater than or equal + // to 0 and less than or equal to 999,999,999. Nanos int64 `json:"nanos,omitempty"` - // Seconds: Seconds of minutes of the time. Must normally be from 0 to 59. An - // API may allow the value 60 if it allows leap-seconds. + // Seconds: Seconds of a minute. Must be greater than or equal to 0 and + // typically must be less than or equal to 59. An API may allow the value 60 if + // it allows leap-seconds. Seconds int64 `json:"seconds,omitempty"` // ForceSendFields is a list of field names (e.g. "Hours") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -9056,6 +9066,13 @@ func (c *ProjectsLocationsConnectionsRuntimeActionSchemasListCall) PageToken(pag return c } +// SchemaAsString sets the optional parameter "schemaAsString": Flag to +// indicate if schema should be returned as string or not +func (c *ProjectsLocationsConnectionsRuntimeActionSchemasListCall) SchemaAsString(schemaAsString bool) *ProjectsLocationsConnectionsRuntimeActionSchemasListCall { + c.urlParams_.Set("schemaAsString", fmt.Sprint(schemaAsString)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. diff --git a/connectors/v2/connectors-api.json b/connectors/v2/connectors-api.json index 080f2b678a2..dbdc7540aaa 100644 --- a/connectors/v2/connectors-api.json +++ b/connectors/v2/connectors-api.json @@ -660,7 +660,7 @@ } } }, - "revision": "20240729", + "revision": "20241015", "rootUrl": "https://connectors.googleapis.com/", "schemas": { "AccessCredentials": { @@ -2403,22 +2403,22 @@ "id": "TimeOfDay", "properties": { "hours": { - "description": "Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to allow the value \"24:00:00\" for scenarios like business closing time.", + "description": "Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or equal to 23. An API may choose to allow the value \"24:00:00\" for scenarios like business closing time.", "format": "int32", "type": "integer" }, "minutes": { - "description": "Minutes of hour of day. Must be from 0 to 59.", + "description": "Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59.", "format": "int32", "type": "integer" }, "nanos": { - "description": "Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.", + "description": "Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999.", "format": "int32", "type": "integer" }, "seconds": { - "description": "Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.", + "description": "Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An API may allow the value 60 if it allows leap-seconds.", "format": "int32", "type": "integer" } diff --git a/connectors/v2/connectors-gen.go b/connectors/v2/connectors-gen.go index 550eaa66093..083d25a5523 100644 --- a/connectors/v2/connectors-gen.go +++ b/connectors/v2/connectors-gen.go @@ -1814,16 +1814,19 @@ func (s SloMetadata) MarshalJSON() ([]byte, error) { // significant or are specified elsewhere. An API may choose to allow leap // seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. type TimeOfDay struct { - // Hours: Hours of day in 24 hour format. Should be from 0 to 23. An API may - // choose to allow the value "24:00:00" for scenarios like business closing - // time. + // Hours: Hours of a day in 24 hour format. Must be greater than or equal to 0 + // and typically must be less than or equal to 23. An API may choose to allow + // the value "24:00:00" for scenarios like business closing time. Hours int64 `json:"hours,omitempty"` - // Minutes: Minutes of hour of day. Must be from 0 to 59. + // Minutes: Minutes of an hour. Must be greater than or equal to 0 and less + // than or equal to 59. Minutes int64 `json:"minutes,omitempty"` - // Nanos: Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999. + // Nanos: Fractions of seconds, in nanoseconds. Must be greater than or equal + // to 0 and less than or equal to 999,999,999. Nanos int64 `json:"nanos,omitempty"` - // Seconds: Seconds of minutes of the time. Must normally be from 0 to 59. An - // API may allow the value 60 if it allows leap-seconds. + // Seconds: Seconds of a minute. Must be greater than or equal to 0 and + // typically must be less than or equal to 59. An API may allow the value 60 if + // it allows leap-seconds. Seconds int64 `json:"seconds,omitempty"` // ForceSendFields is a list of field names (e.g. "Hours") to unconditionally // include in API requests. By default, fields with empty or default values are diff --git a/contactcenterinsights/v1/contactcenterinsights-api.json b/contactcenterinsights/v1/contactcenterinsights-api.json index dd47ff7d985..a7d87254b77 100644 --- a/contactcenterinsights/v1/contactcenterinsights-api.json +++ b/contactcenterinsights/v1/contactcenterinsights-api.json @@ -3312,7 +3312,7 @@ } } }, - "revision": "20241015", + "revision": "20241021", "rootUrl": "https://contactcenterinsights.googleapis.com/", "schemas": { "GoogleCloudContactcenterinsightsV1Analysis": { @@ -6214,7 +6214,8 @@ "type": "string" }, "potentialScore": { - "description": "The maximum potential score of the question. If the question was answered using `na_value`, this field will be zero.", + "deprecated": true, + "description": "The maximum potential score of the question. If the question was answered using `na_value`, this field will be zero. Deprecated: Use AnswerValue.potential_score instead.", "format": "double", "type": "number" }, @@ -6277,14 +6278,27 @@ "description": "A value of \"Not Applicable (N/A)\".", "type": "boolean" }, + "normalizedScore": { + "description": "Output only. Normalized score of the questions. Calculated as score / potential_score iff potential_score != 0 else 0", + "format": "double", + "readOnly": true, + "type": "number" + }, "numValue": { "description": "Numerical value.", "format": "double", "type": "number" }, + "potentialScore": { + "description": "Output only. The maximum potential score of the question.", + "format": "double", + "readOnly": true, + "type": "number" + }, "score": { - "description": "Numerical score of the answer.", + "description": "Output only. Numerical score of the answer.", "format": "double", + "readOnly": true, "type": "number" }, "strValue": { @@ -9451,7 +9465,8 @@ "type": "string" }, "potentialScore": { - "description": "The maximum potential score of the question. If the question was answered using `na_value`, this field will be zero.", + "deprecated": true, + "description": "The maximum potential score of the question. If the question was answered using `na_value`, this field will be zero. Deprecated: Use AnswerValue.potential_score instead.", "format": "double", "type": "number" }, @@ -9514,14 +9529,27 @@ "description": "A value of \"Not Applicable (N/A)\".", "type": "boolean" }, + "normalizedScore": { + "description": "Output only. Normalized score of the questions. Calculated as score / potential_score iff potential_score != 0 else 0", + "format": "double", + "readOnly": true, + "type": "number" + }, "numValue": { "description": "Numerical value.", "format": "double", "type": "number" }, + "potentialScore": { + "description": "Output only. The maximum potential score of the question.", + "format": "double", + "readOnly": true, + "type": "number" + }, "score": { - "description": "Numerical score of the answer.", + "description": "Output only. Numerical score of the answer.", "format": "double", + "readOnly": true, "type": "number" }, "strValue": { diff --git a/contactcenterinsights/v1/contactcenterinsights-gen.go b/contactcenterinsights/v1/contactcenterinsights-gen.go index ddae4756f9e..4b0fdaa068d 100644 --- a/contactcenterinsights/v1/contactcenterinsights-gen.go +++ b/contactcenterinsights/v1/contactcenterinsights-gen.go @@ -4163,7 +4163,8 @@ type GoogleCloudContactcenterinsightsV1QaAnswer struct { // Conversation: The conversation the answer applies to. Conversation string `json:"conversation,omitempty"` // PotentialScore: The maximum potential score of the question. If the question - // was answered using `na_value`, this field will be zero. + // was answered using `na_value`, this field will be zero. Deprecated: Use + // AnswerValue.potential_score instead. PotentialScore float64 `json:"potentialScore,omitempty"` // QaQuestion: The QaQuestion answered by this answer. QaQuestion string `json:"qaQuestion,omitempty"` @@ -4248,9 +4249,14 @@ type GoogleCloudContactcenterinsightsV1QaAnswerAnswerValue struct { Key string `json:"key,omitempty"` // NaValue: A value of "Not Applicable (N/A)". NaValue bool `json:"naValue,omitempty"` + // NormalizedScore: Output only. Normalized score of the questions. Calculated + // as score / potential_score iff potential_score != 0 else 0 + NormalizedScore float64 `json:"normalizedScore,omitempty"` // NumValue: Numerical value. NumValue float64 `json:"numValue,omitempty"` - // Score: Numerical score of the answer. + // PotentialScore: Output only. The maximum potential score of the question. + PotentialScore float64 `json:"potentialScore,omitempty"` + // Score: Output only. Numerical score of the answer. Score float64 `json:"score,omitempty"` // StrValue: String value. StrValue string `json:"strValue,omitempty"` @@ -4275,15 +4281,19 @@ func (s GoogleCloudContactcenterinsightsV1QaAnswerAnswerValue) MarshalJSON() ([] func (s *GoogleCloudContactcenterinsightsV1QaAnswerAnswerValue) UnmarshalJSON(data []byte) error { type NoMethod GoogleCloudContactcenterinsightsV1QaAnswerAnswerValue var s1 struct { - NumValue gensupport.JSONFloat64 `json:"numValue"` - Score gensupport.JSONFloat64 `json:"score"` + NormalizedScore gensupport.JSONFloat64 `json:"normalizedScore"` + NumValue gensupport.JSONFloat64 `json:"numValue"` + PotentialScore gensupport.JSONFloat64 `json:"potentialScore"` + Score gensupport.JSONFloat64 `json:"score"` *NoMethod } s1.NoMethod = (*NoMethod)(s) if err := json.Unmarshal(data, &s1); err != nil { return err } + s.NormalizedScore = float64(s1.NormalizedScore) s.NumValue = float64(s1.NumValue) + s.PotentialScore = float64(s1.PotentialScore) s.Score = float64(s1.Score) return nil } @@ -8388,7 +8398,8 @@ type GoogleCloudContactcenterinsightsV1alpha1QaAnswer struct { // Conversation: The conversation the answer applies to. Conversation string `json:"conversation,omitempty"` // PotentialScore: The maximum potential score of the question. If the question - // was answered using `na_value`, this field will be zero. + // was answered using `na_value`, this field will be zero. Deprecated: Use + // AnswerValue.potential_score instead. PotentialScore float64 `json:"potentialScore,omitempty"` // QaQuestion: The QaQuestion answered by this answer. QaQuestion string `json:"qaQuestion,omitempty"` @@ -8473,9 +8484,14 @@ type GoogleCloudContactcenterinsightsV1alpha1QaAnswerAnswerValue struct { Key string `json:"key,omitempty"` // NaValue: A value of "Not Applicable (N/A)". NaValue bool `json:"naValue,omitempty"` + // NormalizedScore: Output only. Normalized score of the questions. Calculated + // as score / potential_score iff potential_score != 0 else 0 + NormalizedScore float64 `json:"normalizedScore,omitempty"` // NumValue: Numerical value. NumValue float64 `json:"numValue,omitempty"` - // Score: Numerical score of the answer. + // PotentialScore: Output only. The maximum potential score of the question. + PotentialScore float64 `json:"potentialScore,omitempty"` + // Score: Output only. Numerical score of the answer. Score float64 `json:"score,omitempty"` // StrValue: String value. StrValue string `json:"strValue,omitempty"` @@ -8500,15 +8516,19 @@ func (s GoogleCloudContactcenterinsightsV1alpha1QaAnswerAnswerValue) MarshalJSON func (s *GoogleCloudContactcenterinsightsV1alpha1QaAnswerAnswerValue) UnmarshalJSON(data []byte) error { type NoMethod GoogleCloudContactcenterinsightsV1alpha1QaAnswerAnswerValue var s1 struct { - NumValue gensupport.JSONFloat64 `json:"numValue"` - Score gensupport.JSONFloat64 `json:"score"` + NormalizedScore gensupport.JSONFloat64 `json:"normalizedScore"` + NumValue gensupport.JSONFloat64 `json:"numValue"` + PotentialScore gensupport.JSONFloat64 `json:"potentialScore"` + Score gensupport.JSONFloat64 `json:"score"` *NoMethod } s1.NoMethod = (*NoMethod)(s) if err := json.Unmarshal(data, &s1); err != nil { return err } + s.NormalizedScore = float64(s1.NormalizedScore) s.NumValue = float64(s1.NumValue) + s.PotentialScore = float64(s1.PotentialScore) s.Score = float64(s1.Score) return nil } diff --git a/container/v1/container-api.json b/container/v1/container-api.json index 7ee6dded1d1..9c16cd53c47 100644 --- a/container/v1/container-api.json +++ b/container/v1/container-api.json @@ -2540,7 +2540,7 @@ } } }, - "revision": "20241008", + "revision": "20241017", "rootUrl": "https://container.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -3649,6 +3649,10 @@ "description": "Enable/Disable private endpoint for the cluster's master. Deprecated: Use desired_control_plane_endpoints_config.ip_endpoints_config.enable_public_endpoint instead. Note that the value of enable_public_endpoint is reversed: if enable_private_endpoint is false, then enable_public_endpoint will be true.", "type": "boolean" }, + "desiredEnterpriseConfig": { + "$ref": "DesiredEnterpriseConfig", + "description": "The desired enterprise configuration for the cluster." + }, "desiredFleet": { "$ref": "Fleet", "description": "The desired fleet configuration for the cluster." @@ -4213,6 +4217,27 @@ }, "type": "object" }, + "DesiredEnterpriseConfig": { + "description": "DesiredEnterpriseConfig is a wrapper used for updating enterprise_config.", + "id": "DesiredEnterpriseConfig", + "properties": { + "desiredTier": { + "description": "desired_tier specifies the desired tier of the cluster.", + "enum": [ + "CLUSTER_TIER_UNSPECIFIED", + "STANDARD", + "ENTERPRISE" + ], + "enumDescriptions": [ + "CLUSTER_TIER_UNSPECIFIED is when cluster_tier is not set.", + "STANDARD indicates a standard GKE cluster.", + "ENTERPRISE indicates a GKE Enterprise cluster." + ], + "type": "string" + } + }, + "type": "object" + }, "DnsCacheConfig": { "description": "Configuration for NodeLocal DNSCache", "id": "DnsCacheConfig", @@ -4248,6 +4273,20 @@ ], "readOnly": true, "type": "string" + }, + "desiredTier": { + "description": "desired_tier specifies the desired tier of the cluster.", + "enum": [ + "CLUSTER_TIER_UNSPECIFIED", + "STANDARD", + "ENTERPRISE" + ], + "enumDescriptions": [ + "CLUSTER_TIER_UNSPECIFIED is when cluster_tier is not set.", + "STANDARD indicates a standard GKE cluster.", + "ENTERPRISE indicates a GKE Enterprise cluster." + ], + "type": "string" } }, "type": "object" diff --git a/container/v1/container-gen.go b/container/v1/container-gen.go index 511ccae9424..15ff073bb8d 100644 --- a/container/v1/container-gen.go +++ b/container/v1/container-gen.go @@ -1509,6 +1509,9 @@ type ClusterUpdate struct { // oint instead. Note that the value of enable_public_endpoint is reversed: if // enable_private_endpoint is false, then enable_public_endpoint will be true. DesiredEnablePrivateEndpoint bool `json:"desiredEnablePrivateEndpoint,omitempty"` + // DesiredEnterpriseConfig: The desired enterprise configuration for the + // cluster. + DesiredEnterpriseConfig *DesiredEnterpriseConfig `json:"desiredEnterpriseConfig,omitempty"` // DesiredFleet: The desired fleet configuration for the cluster. DesiredFleet *Fleet `json:"desiredFleet,omitempty"` // DesiredGatewayApiConfig: The desired config of Gateway API on this cluster. @@ -2198,6 +2201,35 @@ func (s DefaultSnatStatus) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// DesiredEnterpriseConfig: DesiredEnterpriseConfig is a wrapper used for +// updating enterprise_config. +type DesiredEnterpriseConfig struct { + // DesiredTier: desired_tier specifies the desired tier of the cluster. + // + // Possible values: + // "CLUSTER_TIER_UNSPECIFIED" - CLUSTER_TIER_UNSPECIFIED is when cluster_tier + // is not set. + // "STANDARD" - STANDARD indicates a standard GKE cluster. + // "ENTERPRISE" - ENTERPRISE indicates a GKE Enterprise cluster. + DesiredTier string `json:"desiredTier,omitempty"` + // ForceSendFields is a list of field names (e.g. "DesiredTier") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "DesiredTier") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s DesiredEnterpriseConfig) MarshalJSON() ([]byte, error) { + type NoMethod DesiredEnterpriseConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // DnsCacheConfig: Configuration for NodeLocal DNSCache type DnsCacheConfig struct { // Enabled: Whether NodeLocal DNSCache is enabled for this cluster. @@ -2240,6 +2272,14 @@ type EnterpriseConfig struct { // "STANDARD" - STANDARD indicates a standard GKE cluster. // "ENTERPRISE" - ENTERPRISE indicates a GKE Enterprise cluster. ClusterTier string `json:"clusterTier,omitempty"` + // DesiredTier: desired_tier specifies the desired tier of the cluster. + // + // Possible values: + // "CLUSTER_TIER_UNSPECIFIED" - CLUSTER_TIER_UNSPECIFIED is when cluster_tier + // is not set. + // "STANDARD" - STANDARD indicates a standard GKE cluster. + // "ENTERPRISE" - ENTERPRISE indicates a GKE Enterprise cluster. + DesiredTier string `json:"desiredTier,omitempty"` // ForceSendFields is a list of field names (e.g. "ClusterTier") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See diff --git a/content/v2.1/content-api.json b/content/v2.1/content-api.json index c30637a8b95..02998b3002f 100644 --- a/content/v2.1/content-api.json +++ b/content/v2.1/content-api.json @@ -1457,7 +1457,7 @@ "type": "string" }, "updateMask": { - "description": "Required. List of fields being updated.", + "description": "Optional. List of fields being updated.", "format": "google-fieldmask", "location": "query", "type": "string" @@ -4313,141 +4313,6 @@ } } }, - "settlementreports": { - "methods": { - "get": { - "description": "Retrieves a settlement report from your Merchant Center account.", - "flatPath": "{merchantId}/settlementreports/{settlementId}", - "httpMethod": "GET", - "id": "content.settlementreports.get", - "parameterOrder": [ - "merchantId", - "settlementId" - ], - "parameters": { - "merchantId": { - "description": "The Merchant Center account of the settlement report.", - "format": "uint64", - "location": "path", - "required": true, - "type": "string" - }, - "settlementId": { - "description": "The Google-provided ID of the settlement.", - "location": "path", - "required": true, - "type": "string" - } - }, - "path": "{merchantId}/settlementreports/{settlementId}", - "response": { - "$ref": "SettlementReport" - }, - "scopes": [ - "https://www.googleapis.com/auth/content" - ] - }, - "list": { - "description": "Retrieves a list of settlement reports from your Merchant Center account.", - "flatPath": "{merchantId}/settlementreports", - "httpMethod": "GET", - "id": "content.settlementreports.list", - "parameterOrder": [ - "merchantId" - ], - "parameters": { - "maxResults": { - "description": "The maximum number of settlements to return in the response, used for paging. The default value is 200 returns per page, and the maximum allowed value is 5000 returns per page.", - "format": "uint32", - "location": "query", - "type": "integer" - }, - "merchantId": { - "description": "The Merchant Center account to list settlements for.", - "format": "uint64", - "location": "path", - "required": true, - "type": "string" - }, - "pageToken": { - "description": "The token returned by the previous request.", - "location": "query", - "type": "string" - }, - "transferEndDate": { - "description": "Obtains settlements which have transactions before this date (inclusively), in ISO 8601 format.", - "location": "query", - "type": "string" - }, - "transferStartDate": { - "description": "Obtains settlements which have transactions after this date (inclusively), in ISO 8601 format.", - "location": "query", - "type": "string" - } - }, - "path": "{merchantId}/settlementreports", - "response": { - "$ref": "SettlementreportsListResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/content" - ] - } - } - }, - "settlementtransactions": { - "methods": { - "list": { - "description": "Retrieves a list of transactions for the settlement.", - "flatPath": "{merchantId}/settlementreports/{settlementId}/transactions", - "httpMethod": "GET", - "id": "content.settlementtransactions.list", - "parameterOrder": [ - "merchantId", - "settlementId" - ], - "parameters": { - "maxResults": { - "description": "The maximum number of transactions to return in the response, used for paging. The default value is 200 transactions per page, and the maximum allowed value is 5000 transactions per page.", - "format": "uint32", - "location": "query", - "type": "integer" - }, - "merchantId": { - "description": "The Merchant Center account to list transactions for.", - "format": "uint64", - "location": "path", - "required": true, - "type": "string" - }, - "pageToken": { - "description": "The token returned by the previous request.", - "location": "query", - "type": "string" - }, - "settlementId": { - "description": "The Google-provided ID of the settlement.", - "location": "path", - "required": true, - "type": "string" - }, - "transactionIds": { - "description": "The list of transactions to return. If not set, all transactions will be returned.", - "location": "query", - "repeated": true, - "type": "string" - } - }, - "path": "{merchantId}/settlementreports/{settlementId}/transactions", - "response": { - "$ref": "SettlementtransactionsListResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/content" - ] - } - } - }, "shippingsettings": { "methods": { "custombatch": { @@ -4705,7 +4570,7 @@ } } }, - "revision": "20241015", + "revision": "20241023", "rootUrl": "https://shoppingcontent.googleapis.com/", "schemas": { "Account": { @@ -13624,193 +13489,6 @@ }, "type": "object" }, - "SettlementReport": { - "description": " Settlement reports detail order-level and item-level credits and debits between you and Google.", - "id": "SettlementReport", - "properties": { - "endDate": { - "description": "The end date on which all transactions are included in the report, in ISO 8601 format.", - "type": "string" - }, - "kind": { - "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#settlementReport`\"", - "type": "string" - }, - "previousBalance": { - "$ref": "Price", - "description": "The residual amount from the previous invoice. This is set only if the previous invoices are not paid because of negative balance." - }, - "settlementId": { - "description": "The ID of the settlement report.", - "type": "string" - }, - "startDate": { - "description": "The start date on which all transactions are included in the report, in ISO 8601 format.", - "type": "string" - }, - "transferAmount": { - "$ref": "Price", - "description": "The money due to the merchant." - }, - "transferDate": { - "description": "Date on which transfer for this payment was initiated by Google, in ISO 8601 format.", - "type": "string" - }, - "transferIds": { - "description": "The list of bank identifiers used for the transfer. For example, Trace ID for Federal Automated Clearing House (ACH). This may also be known as the Wire ID.", - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, - "SettlementTransaction": { - "description": "Settlement transactions give a detailed breakdown of the settlement report.", - "id": "SettlementTransaction", - "properties": { - "amount": { - "$ref": "SettlementTransactionAmount", - "description": "The amount for the transaction." - }, - "identifiers": { - "$ref": "SettlementTransactionIdentifiers", - "description": "Identifiers of the transaction." - }, - "kind": { - "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#settlementTransaction`\"", - "type": "string" - }, - "transaction": { - "$ref": "SettlementTransactionTransaction", - "description": "Details of the transaction." - } - }, - "type": "object" - }, - "SettlementTransactionAmount": { - "id": "SettlementTransactionAmount", - "properties": { - "commission": { - "$ref": "SettlementTransactionAmountCommission" - }, - "description": { - "description": "The description of the event. Acceptable values are: - \"`taxWithhold`\" - \"`principal`\" - \"`principalAdjustment`\" - \"`shippingFee`\" - \"`merchantRemittedSalesTax`\" - \"`googleRemittedSalesTax`\" - \"`merchantCoupon`\" - \"`merchantCouponTax`\" - \"`merchantRemittedDisposalTax`\" - \"`googleRemittedDisposalTax`\" - \"`merchantRemittedRedemptionFee`\" - \"`googleRemittedRedemptionFee`\" - \"`eeeEcoFee`\" - \"`furnitureEcoFee`\" - \"`copyPrivateFee`\" - \"`eeeEcoFeeCommission`\" - \"`furnitureEcoFeeCommission`\" - \"`copyPrivateFeeCommission`\" - \"`principalRefund`\" - \"`principalRefundTax`\" - \"`itemCommission`\" - \"`adjustmentCommission`\" - \"`shippingFeeCommission`\" - \"`commissionRefund`\" - \"`damaged`\" - \"`damagedOrDefectiveItem`\" - \"`expiredItem`\" - \"`faultyItem`\" - \"`incorrectItemReceived`\" - \"`itemMissing`\" - \"`qualityNotExpected`\" - \"`receivedTooLate`\" - \"`storePackageMissing`\" - \"`transitPackageMissing`\" - \"`unsuccessfulDeliveryUndeliverable`\" - \"`wrongChargeInStore`\" - \"`wrongItem`\" - \"`returns`\" - \"`undeliverable`\" - \"`issueRelatedRefundAndReplacementAmountDescription`\" - \"`refundFromMerchant`\" - \"`returnLabelShippingFee`\" - \"`lumpSumCorrection`\" - \"`pspFee`\" - \"`principalRefundDoesNotFit`\" - \"`principalRefundOrderedWrongItem`\" - \"`principalRefundQualityNotExpected`\" - \"`principalRefundBetterPriceFound`\" - \"`principalRefundNoLongerNeeded`\" - \"`principalRefundChangedMind`\" - \"`principalRefundReceivedTooLate`\" - \"`principalRefundIncorrectItemReceived`\" - \"`principalRefundDamagedOrDefectiveItem`\" - \"`principalRefundDidNotMatchDescription`\" - \"`principalRefundExpiredItem`\" ", - "type": "string" - }, - "transactionAmount": { - "$ref": "Price", - "description": "The amount that contributes to the line item price." - }, - "type": { - "description": "The type of the amount. Acceptable values are: - \"`itemPrice`\" - \"`orderPrice`\" - \"`refund`\" - \"`earlyRefund`\" - \"`courtesyRefund`\" - \"`returnRefund`\" - \"`returnLabelShippingFeeAmount`\" - \"`lumpSumCorrectionAmount`\" ", - "type": "string" - } - }, - "type": "object" - }, - "SettlementTransactionAmountCommission": { - "id": "SettlementTransactionAmountCommission", - "properties": { - "category": { - "description": "The category of the commission. Acceptable values are: - \"`animalsAndPetSupplies`\" - \"`dogCatFoodAndCatLitter`\" - \"`apparelAndAccessories`\" - \"`shoesHandbagsAndSunglasses`\" - \"`costumesAndAccessories`\" - \"`jewelry`\" - \"`watches`\" - \"`hobbiesArtsAndCrafts`\" - \"`homeAndGarden`\" - \"`entertainmentCollectibles`\" - \"`collectibleCoins`\" - \"`sportsCollectibles`\" - \"`sportingGoods`\" - \"`toysAndGames`\" - \"`musicalInstruments`\" - \"`giftCards`\" - \"`babyAndToddler`\" - \"`babyFoodWipesAndDiapers`\" - \"`businessAndIndustrial`\" - \"`camerasOpticsAndPhotography`\" - \"`consumerElectronics`\" - \"`electronicsAccessories`\" - \"`personalComputers`\" - \"`videoGameConsoles`\" - \"`foodAndGrocery`\" - \"`beverages`\" - \"`tobaccoProducts`\" - \"`furniture`\" - \"`hardware`\" - \"`buildingMaterials`\" - \"`tools`\" - \"`healthAndPersonalCare`\" - \"`beauty`\" - \"`householdSupplies`\" - \"`kitchenAndDining`\" - \"`majorAppliances`\" - \"`luggageAndBags`\" - \"`media`\" - \"`officeSupplies`\" - \"`softwareAndVideoGames`\" - \"`vehiclePartsAndAccessories`\" - \"`vehicleTiresAndWheels`\" - \"`vehicles`\" - \"`everythingElse`\" ", - "type": "string" - }, - "rate": { - "description": "Rate of the commission in percentage.", - "type": "string" - } - }, - "type": "object" - }, - "SettlementTransactionIdentifiers": { - "id": "SettlementTransactionIdentifiers", - "properties": { - "adjustmentId": { - "description": "The identifier of the adjustments, if it's available.", - "type": "string" - }, - "merchantOrderId": { - "description": "The merchant provided order ID.", - "type": "string" - }, - "orderItemId": { - "description": "The identifier of the item.", - "type": "string" - }, - "settlementEntryId": { - "description": "The unique ID of the settlement transaction entry.", - "type": "string" - }, - "shipmentIds": { - "description": "The shipment ids for the item.", - "items": { - "type": "string" - }, - "type": "array" - }, - "transactionId": { - "description": "The Google transaction ID.", - "type": "string" - } - }, - "type": "object" - }, - "SettlementTransactionTransaction": { - "id": "SettlementTransactionTransaction", - "properties": { - "postDate": { - "description": "The time on which the event occurred in ISO 8601 format.", - "type": "string" - }, - "type": { - "description": "The type of the transaction that occurred. Acceptable values are: - \"`order`\" - \"`reversal`\" - \"`orderRefund`\" - \"`reversalRefund`\" - \"`issueRelatedRefundAndReplacement`\" - \"`returnLabelShippingFeeTransaction`\" - \"`reversalIssueRelatedRefundAndReplacement`\" - \"`reversalReturnLabelShippingFeeTransaction`\" - \"`lumpSumCorrectionTransaction`\" ", - "type": "string" - } - }, - "type": "object" - }, - "SettlementreportsListResponse": { - "id": "SettlementreportsListResponse", - "properties": { - "kind": { - "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#settlementreportsListResponse`\".", - "type": "string" - }, - "nextPageToken": { - "description": "The token for the retrieval of the next page of returns.", - "type": "string" - }, - "resources": { - "items": { - "$ref": "SettlementReport" - }, - "type": "array" - } - }, - "type": "object" - }, - "SettlementtransactionsListResponse": { - "id": "SettlementtransactionsListResponse", - "properties": { - "kind": { - "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#settlementtransactionsListResponse`\".", - "type": "string" - }, - "nextPageToken": { - "description": "The token for the retrieval of the next page of returns.", - "type": "string" - }, - "resources": { - "items": { - "$ref": "SettlementTransaction" - }, - "type": "array" - } - }, - "type": "object" - }, "ShippingSettings": { "description": "The merchant account's shipping settings. All methods except getsupportedcarriers and getsupportedholidays require the admin role.", "id": "ShippingSettings", diff --git a/content/v2.1/content-gen.go b/content/v2.1/content-gen.go index c9eeecb7d3c..49c6d74a123 100644 --- a/content/v2.1/content-gen.go +++ b/content/v2.1/content-gen.go @@ -162,8 +162,6 @@ func New(client *http.Client) (*APIService, error) { s.Returnaddress = NewReturnaddressService(s) s.Returnpolicy = NewReturnpolicyService(s) s.Returnpolicyonline = NewReturnpolicyonlineService(s) - s.Settlementreports = NewSettlementreportsService(s) - s.Settlementtransactions = NewSettlementtransactionsService(s) s.Shippingsettings = NewShippingsettingsService(s) s.Shoppingadsprogram = NewShoppingadsprogramService(s) return s, nil @@ -230,10 +228,6 @@ type APIService struct { Returnpolicyonline *ReturnpolicyonlineService - Settlementreports *SettlementreportsService - - Settlementtransactions *SettlementtransactionsService - Shippingsettings *ShippingsettingsService Shoppingadsprogram *ShoppingadsprogramService @@ -546,24 +540,6 @@ type ReturnpolicyonlineService struct { s *APIService } -func NewSettlementreportsService(s *APIService) *SettlementreportsService { - rs := &SettlementreportsService{s: s} - return rs -} - -type SettlementreportsService struct { - s *APIService -} - -func NewSettlementtransactionsService(s *APIService) *SettlementtransactionsService { - rs := &SettlementtransactionsService{s: s} - return rs -} - -type SettlementtransactionsService struct { - s *APIService -} - func NewShippingsettingsService(s *APIService) *ShippingsettingsService { rs := &ShippingsettingsService{s: s} return rs @@ -11864,288 +11840,6 @@ func (s ServiceStoreConfigCutoffConfigLocalCutoffTime) MarshalJSON() ([]byte, er return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// SettlementReport: Settlement reports detail order-level and item-level -// credits and debits between you and Google. -type SettlementReport struct { - // EndDate: The end date on which all transactions are included in the report, - // in ISO 8601 format. - EndDate string `json:"endDate,omitempty"` - // Kind: Identifies what kind of resource this is. Value: the fixed string - // "content#settlementReport" - Kind string `json:"kind,omitempty"` - // PreviousBalance: The residual amount from the previous invoice. This is set - // only if the previous invoices are not paid because of negative balance. - PreviousBalance *Price `json:"previousBalance,omitempty"` - // SettlementId: The ID of the settlement report. - SettlementId string `json:"settlementId,omitempty"` - // StartDate: The start date on which all transactions are included in the - // report, in ISO 8601 format. - StartDate string `json:"startDate,omitempty"` - // TransferAmount: The money due to the merchant. - TransferAmount *Price `json:"transferAmount,omitempty"` - // TransferDate: Date on which transfer for this payment was initiated by - // Google, in ISO 8601 format. - TransferDate string `json:"transferDate,omitempty"` - // TransferIds: The list of bank identifiers used for the transfer. For - // example, Trace ID for Federal Automated Clearing House (ACH). This may also - // be known as the Wire ID. - TransferIds []string `json:"transferIds,omitempty"` - - // ServerResponse contains the HTTP response code and headers from the server. - googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "EndDate") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "EndDate") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s SettlementReport) MarshalJSON() ([]byte, error) { - type NoMethod SettlementReport - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// SettlementTransaction: Settlement transactions give a detailed breakdown of -// the settlement report. -type SettlementTransaction struct { - // Amount: The amount for the transaction. - Amount *SettlementTransactionAmount `json:"amount,omitempty"` - // Identifiers: Identifiers of the transaction. - Identifiers *SettlementTransactionIdentifiers `json:"identifiers,omitempty"` - // Kind: Identifies what kind of resource this is. Value: the fixed string - // "content#settlementTransaction" - Kind string `json:"kind,omitempty"` - // Transaction: Details of the transaction. - Transaction *SettlementTransactionTransaction `json:"transaction,omitempty"` - // ForceSendFields is a list of field names (e.g. "Amount") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Amount") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s SettlementTransaction) MarshalJSON() ([]byte, error) { - type NoMethod SettlementTransaction - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -type SettlementTransactionAmount struct { - Commission *SettlementTransactionAmountCommission `json:"commission,omitempty"` - // Description: The description of the event. Acceptable values are: - - // "taxWithhold" - "principal" - "principalAdjustment" - "shippingFee" - // - "merchantRemittedSalesTax" - "googleRemittedSalesTax" - - // "merchantCoupon" - "merchantCouponTax" - "merchantRemittedDisposalTax" - // - "googleRemittedDisposalTax" - "merchantRemittedRedemptionFee" - - // "googleRemittedRedemptionFee" - "eeeEcoFee" - "furnitureEcoFee" - - // "copyPrivateFee" - "eeeEcoFeeCommission" - "furnitureEcoFeeCommission" - // - "copyPrivateFeeCommission" - "principalRefund" - - // "principalRefundTax" - "itemCommission" - "adjustmentCommission" - - // "shippingFeeCommission" - "commissionRefund" - "damaged" - - // "damagedOrDefectiveItem" - "expiredItem" - "faultyItem" - - // "incorrectItemReceived" - "itemMissing" - "qualityNotExpected" - - // "receivedTooLate" - "storePackageMissing" - "transitPackageMissing" - - // "unsuccessfulDeliveryUndeliverable" - "wrongChargeInStore" - - // "wrongItem" - "returns" - "undeliverable" - - // "issueRelatedRefundAndReplacementAmountDescription" - - // "refundFromMerchant" - "returnLabelShippingFee" - "lumpSumCorrection" - // - "pspFee" - "principalRefundDoesNotFit" - - // "principalRefundOrderedWrongItem" - "principalRefundQualityNotExpected" - // - "principalRefundBetterPriceFound" - "principalRefundNoLongerNeeded" - - // "principalRefundChangedMind" - "principalRefundReceivedTooLate" - - // "principalRefundIncorrectItemReceived" - - // "principalRefundDamagedOrDefectiveItem" - - // "principalRefundDidNotMatchDescription" - "principalRefundExpiredItem" - Description string `json:"description,omitempty"` - // TransactionAmount: The amount that contributes to the line item price. - TransactionAmount *Price `json:"transactionAmount,omitempty"` - // Type: The type of the amount. Acceptable values are: - "itemPrice" - - // "orderPrice" - "refund" - "earlyRefund" - "courtesyRefund" - - // "returnRefund" - "returnLabelShippingFeeAmount" - - // "lumpSumCorrectionAmount" - Type string `json:"type,omitempty"` - // ForceSendFields is a list of field names (e.g. "Commission") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Commission") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s SettlementTransactionAmount) MarshalJSON() ([]byte, error) { - type NoMethod SettlementTransactionAmount - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -type SettlementTransactionAmountCommission struct { - // Category: The category of the commission. Acceptable values are: - - // "animalsAndPetSupplies" - "dogCatFoodAndCatLitter" - - // "apparelAndAccessories" - "shoesHandbagsAndSunglasses" - - // "costumesAndAccessories" - "jewelry" - "watches" - - // "hobbiesArtsAndCrafts" - "homeAndGarden" - "entertainmentCollectibles" - // - "collectibleCoins" - "sportsCollectibles" - "sportingGoods" - - // "toysAndGames" - "musicalInstruments" - "giftCards" - - // "babyAndToddler" - "babyFoodWipesAndDiapers" - "businessAndIndustrial" - // - "camerasOpticsAndPhotography" - "consumerElectronics" - - // "electronicsAccessories" - "personalComputers" - "videoGameConsoles" - - // "foodAndGrocery" - "beverages" - "tobaccoProducts" - "furniture" - - // "hardware" - "buildingMaterials" - "tools" - "healthAndPersonalCare" - // - "beauty" - "householdSupplies" - "kitchenAndDining" - - // "majorAppliances" - "luggageAndBags" - "media" - "officeSupplies" - - // "softwareAndVideoGames" - "vehiclePartsAndAccessories" - - // "vehicleTiresAndWheels" - "vehicles" - "everythingElse" - Category string `json:"category,omitempty"` - // Rate: Rate of the commission in percentage. - Rate string `json:"rate,omitempty"` - // ForceSendFields is a list of field names (e.g. "Category") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Category") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s SettlementTransactionAmountCommission) MarshalJSON() ([]byte, error) { - type NoMethod SettlementTransactionAmountCommission - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -type SettlementTransactionIdentifiers struct { - // AdjustmentId: The identifier of the adjustments, if it's available. - AdjustmentId string `json:"adjustmentId,omitempty"` - // MerchantOrderId: The merchant provided order ID. - MerchantOrderId string `json:"merchantOrderId,omitempty"` - // OrderItemId: The identifier of the item. - OrderItemId string `json:"orderItemId,omitempty"` - // SettlementEntryId: The unique ID of the settlement transaction entry. - SettlementEntryId string `json:"settlementEntryId,omitempty"` - // ShipmentIds: The shipment ids for the item. - ShipmentIds []string `json:"shipmentIds,omitempty"` - // TransactionId: The Google transaction ID. - TransactionId string `json:"transactionId,omitempty"` - // ForceSendFields is a list of field names (e.g. "AdjustmentId") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "AdjustmentId") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s SettlementTransactionIdentifiers) MarshalJSON() ([]byte, error) { - type NoMethod SettlementTransactionIdentifiers - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -type SettlementTransactionTransaction struct { - // PostDate: The time on which the event occurred in ISO 8601 format. - PostDate string `json:"postDate,omitempty"` - // Type: The type of the transaction that occurred. Acceptable values are: - - // "order" - "reversal" - "orderRefund" - "reversalRefund" - - // "issueRelatedRefundAndReplacement" - "returnLabelShippingFeeTransaction" - // - "reversalIssueRelatedRefundAndReplacement" - - // "reversalReturnLabelShippingFeeTransaction" - - // "lumpSumCorrectionTransaction" - Type string `json:"type,omitempty"` - // ForceSendFields is a list of field names (e.g. "PostDate") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "PostDate") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s SettlementTransactionTransaction) MarshalJSON() ([]byte, error) { - type NoMethod SettlementTransactionTransaction - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -type SettlementreportsListResponse struct { - // Kind: Identifies what kind of resource this is. Value: the fixed string - // "content#settlementreportsListResponse". - Kind string `json:"kind,omitempty"` - // NextPageToken: The token for the retrieval of the next page of returns. - NextPageToken string `json:"nextPageToken,omitempty"` - Resources []*SettlementReport `json:"resources,omitempty"` - - // ServerResponse contains the HTTP response code and headers from the server. - googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "Kind") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Kind") to include in API requests - // with the JSON null value. By default, fields with empty values are omitted - // from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s SettlementreportsListResponse) MarshalJSON() ([]byte, error) { - type NoMethod SettlementreportsListResponse - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -type SettlementtransactionsListResponse struct { - // Kind: Identifies what kind of resource this is. Value: the fixed string - // "content#settlementtransactionsListResponse". - Kind string `json:"kind,omitempty"` - // NextPageToken: The token for the retrieval of the next page of returns. - NextPageToken string `json:"nextPageToken,omitempty"` - Resources []*SettlementTransaction `json:"resources,omitempty"` - - // ServerResponse contains the HTTP response code and headers from the server. - googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "Kind") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Kind") to include in API requests - // with the JSON null value. By default, fields with empty values are omitted - // from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s SettlementtransactionsListResponse) MarshalJSON() ([]byte, error) { - type NoMethod SettlementtransactionsListResponse - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // ShippingSettings: The merchant account's shipping settings. All methods // except getsupportedcarriers and getsupportedholidays require the admin role. type ShippingSettings struct { @@ -17572,8 +17266,8 @@ func (r *ConversionsourcesService) Patch(merchantId int64, conversionSourceId st return c } -// UpdateMask sets the optional parameter "updateMask": Required. List of -// fields being updated. +// UpdateMask sets the optional parameter "updateMask": List of fields being +// updated. func (c *ConversionsourcesPatchCall) UpdateMask(updateMask string) *ConversionsourcesPatchCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -27063,436 +26757,6 @@ func (c *ReturnpolicyonlinePatchCall) Do(opts ...googleapi.CallOption) (*ReturnP return ret, nil } -type SettlementreportsGetCall struct { - s *APIService - merchantId uint64 - settlementId string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// Get: Retrieves a settlement report from your Merchant Center account. -// -// - merchantId: The Merchant Center account of the settlement report. -// - settlementId: The Google-provided ID of the settlement. -func (r *SettlementreportsService) Get(merchantId uint64, settlementId string) *SettlementreportsGetCall { - c := &SettlementreportsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.merchantId = merchantId - c.settlementId = settlementId - 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 *SettlementreportsGetCall) Fields(s ...googleapi.Field) *SettlementreportsGetCall { - 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 *SettlementreportsGetCall) IfNoneMatch(entityTag string) *SettlementreportsGetCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *SettlementreportsGetCall) Context(ctx context.Context) *SettlementreportsGetCall { - 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 *SettlementreportsGetCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *SettlementreportsGetCall) 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, "{merchantId}/settlementreports/{settlementId}") - 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{ - "merchantId": strconv.FormatUint(c.merchantId, 10), - "settlementId": c.settlementId, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "content.settlementreports.get" call. -// Any non-2xx status code is an error. Response headers are in either -// *SettlementReport.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 *SettlementreportsGetCall) Do(opts ...googleapi.CallOption) (*SettlementReport, 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 := &SettlementReport{ - 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 SettlementreportsListCall struct { - s *APIService - merchantId uint64 - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// List: Retrieves a list of settlement reports from your Merchant Center -// account. -// -// - merchantId: The Merchant Center account to list settlements for. -func (r *SettlementreportsService) List(merchantId uint64) *SettlementreportsListCall { - c := &SettlementreportsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.merchantId = merchantId - return c -} - -// MaxResults sets the optional parameter "maxResults": The maximum number of -// settlements to return in the response, used for paging. The default value is -// 200 returns per page, and the maximum allowed value is 5000 returns per -// page. -func (c *SettlementreportsListCall) MaxResults(maxResults int64) *SettlementreportsListCall { - c.urlParams_.Set("maxResults", fmt.Sprint(maxResults)) - return c -} - -// PageToken sets the optional parameter "pageToken": The token returned by the -// previous request. -func (c *SettlementreportsListCall) PageToken(pageToken string) *SettlementreportsListCall { - c.urlParams_.Set("pageToken", pageToken) - return c -} - -// TransferEndDate sets the optional parameter "transferEndDate": Obtains -// settlements which have transactions before this date (inclusively), in ISO -// 8601 format. -func (c *SettlementreportsListCall) TransferEndDate(transferEndDate string) *SettlementreportsListCall { - c.urlParams_.Set("transferEndDate", transferEndDate) - return c -} - -// TransferStartDate sets the optional parameter "transferStartDate": Obtains -// settlements which have transactions after this date (inclusively), in ISO -// 8601 format. -func (c *SettlementreportsListCall) TransferStartDate(transferStartDate string) *SettlementreportsListCall { - c.urlParams_.Set("transferStartDate", transferStartDate) - 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 *SettlementreportsListCall) Fields(s ...googleapi.Field) *SettlementreportsListCall { - 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 *SettlementreportsListCall) IfNoneMatch(entityTag string) *SettlementreportsListCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *SettlementreportsListCall) Context(ctx context.Context) *SettlementreportsListCall { - 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 *SettlementreportsListCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *SettlementreportsListCall) 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, "{merchantId}/settlementreports") - 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{ - "merchantId": strconv.FormatUint(c.merchantId, 10), - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "content.settlementreports.list" call. -// Any non-2xx status code is an error. Response headers are in either -// *SettlementreportsListResponse.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 *SettlementreportsListCall) Do(opts ...googleapi.CallOption) (*SettlementreportsListResponse, 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 := &SettlementreportsListResponse{ - 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 *SettlementreportsListCall) Pages(ctx context.Context, f func(*SettlementreportsListResponse) 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 SettlementtransactionsListCall struct { - s *APIService - merchantId uint64 - settlementId string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// List: Retrieves a list of transactions for the settlement. -// -// - merchantId: The Merchant Center account to list transactions for. -// - settlementId: The Google-provided ID of the settlement. -func (r *SettlementtransactionsService) List(merchantId uint64, settlementId string) *SettlementtransactionsListCall { - c := &SettlementtransactionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.merchantId = merchantId - c.settlementId = settlementId - return c -} - -// MaxResults sets the optional parameter "maxResults": The maximum number of -// transactions to return in the response, used for paging. The default value -// is 200 transactions per page, and the maximum allowed value is 5000 -// transactions per page. -func (c *SettlementtransactionsListCall) MaxResults(maxResults int64) *SettlementtransactionsListCall { - c.urlParams_.Set("maxResults", fmt.Sprint(maxResults)) - return c -} - -// PageToken sets the optional parameter "pageToken": The token returned by the -// previous request. -func (c *SettlementtransactionsListCall) PageToken(pageToken string) *SettlementtransactionsListCall { - c.urlParams_.Set("pageToken", pageToken) - return c -} - -// TransactionIds sets the optional parameter "transactionIds": The list of -// transactions to return. If not set, all transactions will be returned. -func (c *SettlementtransactionsListCall) TransactionIds(transactionIds ...string) *SettlementtransactionsListCall { - c.urlParams_.SetMulti("transactionIds", append([]string{}, transactionIds...)) - 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 *SettlementtransactionsListCall) Fields(s ...googleapi.Field) *SettlementtransactionsListCall { - 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 *SettlementtransactionsListCall) IfNoneMatch(entityTag string) *SettlementtransactionsListCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *SettlementtransactionsListCall) Context(ctx context.Context) *SettlementtransactionsListCall { - 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 *SettlementtransactionsListCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *SettlementtransactionsListCall) 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, "{merchantId}/settlementreports/{settlementId}/transactions") - 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{ - "merchantId": strconv.FormatUint(c.merchantId, 10), - "settlementId": c.settlementId, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "content.settlementtransactions.list" call. -// Any non-2xx status code is an error. Response headers are in either -// *SettlementtransactionsListResponse.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 *SettlementtransactionsListCall) Do(opts ...googleapi.CallOption) (*SettlementtransactionsListResponse, 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 := &SettlementtransactionsListResponse{ - 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 *SettlementtransactionsListCall) Pages(ctx context.Context, f func(*SettlementtransactionsListResponse) 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 ShippingsettingsCustombatchCall struct { s *APIService shippingsettingscustombatchrequest *ShippingsettingsCustomBatchRequest diff --git a/datacatalog/v1/datacatalog-api.json b/datacatalog/v1/datacatalog-api.json index 699fae1ce80..dc2ca82ebe4 100644 --- a/datacatalog/v1/datacatalog-api.json +++ b/datacatalog/v1/datacatalog-api.json @@ -172,9 +172,150 @@ } } }, + "organizations": { + "resources": { + "locations": { + "methods": { + "retrieveConfig": { + "description": "Retrieves the configuration related to the migration from Data Catalog to Dataplex for a specific organization, including all the projects under it which have a separate configuration set.", + "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}:retrieveConfig", + "httpMethod": "GET", + "id": "datacatalog.organizations.locations.retrieveConfig", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The organization whose config is being retrieved.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}:retrieveConfig", + "response": { + "$ref": "GoogleCloudDatacatalogV1OrganizationConfig" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "retrieveEffectiveConfig": { + "description": "Retrieves the effective configuration related to the migration from Data Catalog to Dataplex for a specific organization or project. If there is no specific configuration set for the resource, the setting is checked hierarchicahlly through the ancestors of the resource, starting from the resource itself.", + "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}:retrieveEffectiveConfig", + "httpMethod": "GET", + "id": "datacatalog.organizations.locations.retrieveEffectiveConfig", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource whose effective config is being retrieved.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}:retrieveEffectiveConfig", + "response": { + "$ref": "GoogleCloudDatacatalogV1MigrationConfig" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "setConfig": { + "description": "Sets the configuration related to the migration to Dataplex for an organization or project.", + "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}:setConfig", + "httpMethod": "POST", + "id": "datacatalog.organizations.locations.setConfig", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The organization or project whose config is being specified.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}:setConfig", + "request": { + "$ref": "GoogleCloudDatacatalogV1SetConfigRequest" + }, + "response": { + "$ref": "GoogleCloudDatacatalogV1MigrationConfig" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + }, "projects": { "resources": { "locations": { + "methods": { + "retrieveEffectiveConfig": { + "description": "Retrieves the effective configuration related to the migration from Data Catalog to Dataplex for a specific organization or project. If there is no specific configuration set for the resource, the setting is checked hierarchicahlly through the ancestors of the resource, starting from the resource itself.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}:retrieveEffectiveConfig", + "httpMethod": "GET", + "id": "datacatalog.projects.locations.retrieveEffectiveConfig", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource whose effective config is being retrieved.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}:retrieveEffectiveConfig", + "response": { + "$ref": "GoogleCloudDatacatalogV1MigrationConfig" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "setConfig": { + "description": "Sets the configuration related to the migration to Dataplex for an organization or project.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}:setConfig", + "httpMethod": "POST", + "id": "datacatalog.projects.locations.setConfig", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The organization or project whose config is being specified.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}:setConfig", + "request": { + "$ref": "GoogleCloudDatacatalogV1SetConfigRequest" + }, + "response": { + "$ref": "GoogleCloudDatacatalogV1MigrationConfig" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, "resources": { "entryGroups": { "methods": { @@ -2144,7 +2285,7 @@ } } }, - "revision": "20240614", + "revision": "20241021", "rootUrl": "https://datacatalog.googleapis.com/", "schemas": { "Binding": { @@ -3024,6 +3165,10 @@ "name": { "description": "Identifier. The resource name of the entry group in URL format. Note: The entry group itself and its child resources might not be stored in the location specified in its name.", "type": "string" + }, + "transferredToDataplex": { + "description": "Optional. When set to [true], it means DataCatalog EntryGroup was transferred to Dataplex Catalog Service. It makes EntryGroup and its Entries to be read-only in DataCatalog. However, new Tags on EntryGroup and its Entries can be created. After setting the flag to [true] it cannot be unset.", + "type": "boolean" } }, "type": "object" @@ -3411,6 +3556,41 @@ }, "type": "object" }, + "GoogleCloudDatacatalogV1MigrationConfig": { + "description": "The configuration related to the migration to Dataplex applied to an organization or project. It is the response message for SetConfig and RetrieveEffectiveConfig.", + "id": "GoogleCloudDatacatalogV1MigrationConfig", + "properties": { + "catalogUiExperience": { + "description": "Opt-in status for the UI switch to Dataplex.", + "enum": [ + "CATALOG_UI_EXPERIENCE_UNSPECIFIED", + "CATALOG_UI_EXPERIENCE_ENABLED", + "CATALOG_UI_EXPERIENCE_DISABLED" + ], + "enumDescriptions": [ + "Default value. The default UI is Dataplex.", + "The UI is Dataplex.", + "The UI is Data Catalog." + ], + "type": "string" + }, + "tagTemplateMigration": { + "description": "Opt-in status for the migration of Tag Templates to Dataplex.", + "enum": [ + "TAG_TEMPLATE_MIGRATION_UNSPECIFIED", + "TAG_TEMPLATE_MIGRATION_ENABLED", + "TAG_TEMPLATE_MIGRATION_DISABLED" + ], + "enumDescriptions": [ + "Default value. Migration of Tag Templates from Data Catalog to Dataplex is not performed.", + "Migration of Tag Templates from Data Catalog to Dataplex is enabled.", + "Migration of Tag Templates from Data Catalog to Dataplex is disabled." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDatacatalogV1ModelSpec": { "description": "Specification that applies to a model. Valid only for entries with the `MODEL` type.", "id": "GoogleCloudDatacatalogV1ModelSpec", @@ -3444,6 +3624,20 @@ }, "type": "object" }, + "GoogleCloudDatacatalogV1OrganizationConfig": { + "description": "The configuration related to the migration from Data Catalog to Dataplex that has been applied to an organization and any projects under it. It is the response message for RetrieveConfig.", + "id": "GoogleCloudDatacatalogV1OrganizationConfig", + "properties": { + "config": { + "additionalProperties": { + "$ref": "GoogleCloudDatacatalogV1MigrationConfig" + }, + "description": "Map of organizations and project resource names and their configuration. The format for the map keys is `organizations/{organizationId}` or `projects/{projectId}`.", + "type": "object" + } + }, + "type": "object" + }, "GoogleCloudDatacatalogV1PersonalDetails": { "description": "Entry metadata relevant only to the user and private to them.", "id": "GoogleCloudDatacatalogV1PersonalDetails", @@ -4031,6 +4225,41 @@ }, "type": "object" }, + "GoogleCloudDatacatalogV1SetConfigRequest": { + "description": "Request message for SetConfig.", + "id": "GoogleCloudDatacatalogV1SetConfigRequest", + "properties": { + "catalogUiExperience": { + "description": "Opt-in status for the UI switch to Dataplex.", + "enum": [ + "CATALOG_UI_EXPERIENCE_UNSPECIFIED", + "CATALOG_UI_EXPERIENCE_ENABLED", + "CATALOG_UI_EXPERIENCE_DISABLED" + ], + "enumDescriptions": [ + "Default value. The default UI is Dataplex.", + "The UI is Dataplex.", + "The UI is Data Catalog." + ], + "type": "string" + }, + "tagTemplateMigration": { + "description": "Opt-in status for the migration of Tag Templates to Dataplex.", + "enum": [ + "TAG_TEMPLATE_MIGRATION_UNSPECIFIED", + "TAG_TEMPLATE_MIGRATION_ENABLED", + "TAG_TEMPLATE_MIGRATION_DISABLED" + ], + "enumDescriptions": [ + "Default value. Migration of Tag Templates from Data Catalog to Dataplex is not performed.", + "Migration of Tag Templates from Data Catalog to Dataplex is enabled.", + "Migration of Tag Templates from Data Catalog to Dataplex is disabled." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDatacatalogV1SqlDatabaseSystemSpec": { "description": "Specification that applies to entries that are part `SQL_DATABASE` system (user_specified_type)", "id": "GoogleCloudDatacatalogV1SqlDatabaseSystemSpec", @@ -4123,6 +4352,26 @@ "description": "Resources like entry can have schemas associated with them. This scope allows you to attach tags to an individual column based on that schema. To attach a tag to a nested column, separate column names with a dot (`.`). Example: `column.nested_column`.", "type": "string" }, + "dataplexTransferStatus": { + "description": "Output only. Denotes the transfer status of the Tag Template.", + "enum": [ + "DATAPLEX_TRANSFER_STATUS_UNSPECIFIED", + "MIGRATED", + "TRANSFERRED" + ], + "enumDeprecated": [ + false, + true, + false + ], + "enumDescriptions": [ + "Default value. TagTemplate and its tags are only visible and editable in DataCatalog.", + "TagTemplate and its tags are auto-copied to Dataplex service. Visible in both services. Editable in DataCatalog, read-only in Dataplex. Deprecated: Individual TagTemplate migration is deprecated in favor of organization or project wide TagTemplate migration opt-in.", + "TagTemplate and its tags are auto-copied to Dataplex service. Visible in both services. Editable in Dataplex, read-only in DataCatalog." + ], + "readOnly": true, + "type": "string" + }, "fields": { "additionalProperties": { "$ref": "GoogleCloudDatacatalogV1TagField" @@ -4209,15 +4458,18 @@ "description": "Optional. Transfer status of the TagTemplate", "enum": [ "DATAPLEX_TRANSFER_STATUS_UNSPECIFIED", - "MIGRATED" + "MIGRATED", + "TRANSFERRED" ], "enumDeprecated": [ false, - true + true, + false ], "enumDescriptions": [ "Default value. TagTemplate and its tags are only visible and editable in DataCatalog.", - "TagTemplate and its tags are auto-copied to Dataplex service. Visible in both services. Editable in DataCatalog, read-only in Dataplex. Deprecated: Individual TagTemplate migration is deprecated in favor of organization or project wide TagTemplate migration opt-in." + "TagTemplate and its tags are auto-copied to Dataplex service. Visible in both services. Editable in DataCatalog, read-only in Dataplex. Deprecated: Individual TagTemplate migration is deprecated in favor of organization or project wide TagTemplate migration opt-in.", + "TagTemplate and its tags are auto-copied to Dataplex service. Visible in both services. Editable in Dataplex, read-only in DataCatalog." ], "type": "string" }, diff --git a/datacatalog/v1/datacatalog-gen.go b/datacatalog/v1/datacatalog-gen.go index 31e31543338..f15f336768e 100644 --- a/datacatalog/v1/datacatalog-gen.go +++ b/datacatalog/v1/datacatalog-gen.go @@ -137,6 +137,7 @@ func New(client *http.Client) (*Service, error) { s := &Service{client: client, BasePath: basePath} s.Catalog = NewCatalogService(s) s.Entries = NewEntriesService(s) + s.Organizations = NewOrganizationsService(s) s.Projects = NewProjectsService(s) return s, nil } @@ -150,6 +151,8 @@ type Service struct { Entries *EntriesService + Organizations *OrganizationsService + Projects *ProjectsService } @@ -178,6 +181,27 @@ type EntriesService struct { s *Service } +func NewOrganizationsService(s *Service) *OrganizationsService { + rs := &OrganizationsService{s: s} + rs.Locations = NewOrganizationsLocationsService(s) + return rs +} + +type OrganizationsService struct { + s *Service + + Locations *OrganizationsLocationsService +} + +func NewOrganizationsLocationsService(s *Service) *OrganizationsLocationsService { + rs := &OrganizationsLocationsService{s: s} + return rs +} + +type OrganizationsLocationsService struct { + s *Service +} + func NewProjectsService(s *Service) *ProjectsService { rs := &ProjectsService{s: s} rs.Locations = NewProjectsLocationsService(s) @@ -1509,6 +1533,12 @@ type GoogleCloudDatacatalogV1EntryGroup struct { // The entry group itself and its child resources might not be stored in the // location specified in its name. Name string `json:"name,omitempty"` + // TransferredToDataplex: Optional. When set to [true], it means DataCatalog + // EntryGroup was transferred to Dataplex Catalog Service. It makes EntryGroup + // and its Entries to be read-only in DataCatalog. However, new Tags on + // EntryGroup and its Entries can be created. After setting the flag to [true] + // it cannot be unset. + TransferredToDataplex bool `json:"transferredToDataplex,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` @@ -2133,6 +2163,50 @@ func (s GoogleCloudDatacatalogV1LookerSystemSpec) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDatacatalogV1MigrationConfig: The configuration related to the +// migration to Dataplex applied to an organization or project. It is the +// response message for SetConfig and RetrieveEffectiveConfig. +type GoogleCloudDatacatalogV1MigrationConfig struct { + // CatalogUiExperience: Opt-in status for the UI switch to Dataplex. + // + // Possible values: + // "CATALOG_UI_EXPERIENCE_UNSPECIFIED" - Default value. The default UI is + // Dataplex. + // "CATALOG_UI_EXPERIENCE_ENABLED" - The UI is Dataplex. + // "CATALOG_UI_EXPERIENCE_DISABLED" - The UI is Data Catalog. + CatalogUiExperience string `json:"catalogUiExperience,omitempty"` + // TagTemplateMigration: Opt-in status for the migration of Tag Templates to + // Dataplex. + // + // Possible values: + // "TAG_TEMPLATE_MIGRATION_UNSPECIFIED" - Default value. Migration of Tag + // Templates from Data Catalog to Dataplex is not performed. + // "TAG_TEMPLATE_MIGRATION_ENABLED" - Migration of Tag Templates from Data + // Catalog to Dataplex is enabled. + // "TAG_TEMPLATE_MIGRATION_DISABLED" - Migration of Tag Templates from Data + // Catalog to Dataplex is disabled. + TagTemplateMigration string `json:"tagTemplateMigration,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "CatalogUiExperience") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CatalogUiExperience") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDatacatalogV1MigrationConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDatacatalogV1MigrationConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDatacatalogV1ModelSpec: Specification that applies to a model. // Valid only for entries with the `MODEL` type. type GoogleCloudDatacatalogV1ModelSpec struct { @@ -2202,6 +2276,36 @@ func (s GoogleCloudDatacatalogV1ModifyEntryOverviewRequest) MarshalJSON() ([]byt return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDatacatalogV1OrganizationConfig: The configuration related to the +// migration from Data Catalog to Dataplex that has been applied to an +// organization and any projects under it. It is the response message for +// RetrieveConfig. +type GoogleCloudDatacatalogV1OrganizationConfig struct { + // Config: Map of organizations and project resource names and their + // configuration. The format for the map keys is + // `organizations/{organizationId}` or `projects/{projectId}`. + Config map[string]GoogleCloudDatacatalogV1MigrationConfig `json:"config,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Config") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Config") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDatacatalogV1OrganizationConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDatacatalogV1OrganizationConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDatacatalogV1PersonalDetails: Entry metadata relevant only to the // user and private to them. type GoogleCloudDatacatalogV1PersonalDetails struct { @@ -2976,6 +3080,45 @@ func (s GoogleCloudDatacatalogV1ServiceSpec) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDatacatalogV1SetConfigRequest: Request message for SetConfig. +type GoogleCloudDatacatalogV1SetConfigRequest struct { + // CatalogUiExperience: Opt-in status for the UI switch to Dataplex. + // + // Possible values: + // "CATALOG_UI_EXPERIENCE_UNSPECIFIED" - Default value. The default UI is + // Dataplex. + // "CATALOG_UI_EXPERIENCE_ENABLED" - The UI is Dataplex. + // "CATALOG_UI_EXPERIENCE_DISABLED" - The UI is Data Catalog. + CatalogUiExperience string `json:"catalogUiExperience,omitempty"` + // TagTemplateMigration: Opt-in status for the migration of Tag Templates to + // Dataplex. + // + // Possible values: + // "TAG_TEMPLATE_MIGRATION_UNSPECIFIED" - Default value. Migration of Tag + // Templates from Data Catalog to Dataplex is not performed. + // "TAG_TEMPLATE_MIGRATION_ENABLED" - Migration of Tag Templates from Data + // Catalog to Dataplex is enabled. + // "TAG_TEMPLATE_MIGRATION_DISABLED" - Migration of Tag Templates from Data + // Catalog to Dataplex is disabled. + TagTemplateMigration string `json:"tagTemplateMigration,omitempty"` + // ForceSendFields is a list of field names (e.g. "CatalogUiExperience") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CatalogUiExperience") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDatacatalogV1SetConfigRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDatacatalogV1SetConfigRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDatacatalogV1SqlDatabaseSystemSpec: Specification that applies to // entries that are part `SQL_DATABASE` system (user_specified_type) type GoogleCloudDatacatalogV1SqlDatabaseSystemSpec struct { @@ -3122,6 +3265,20 @@ type GoogleCloudDatacatalogV1Tag struct { // schema. To attach a tag to a nested column, separate column names with a dot // (`.`). Example: `column.nested_column`. Column string `json:"column,omitempty"` + // DataplexTransferStatus: Output only. Denotes the transfer status of the Tag + // Template. + // + // Possible values: + // "DATAPLEX_TRANSFER_STATUS_UNSPECIFIED" - Default value. TagTemplate and + // its tags are only visible and editable in DataCatalog. + // "MIGRATED" - TagTemplate and its tags are auto-copied to Dataplex service. + // Visible in both services. Editable in DataCatalog, read-only in Dataplex. + // Deprecated: Individual TagTemplate migration is deprecated in favor of + // organization or project wide TagTemplate migration opt-in. + // "TRANSFERRED" - TagTemplate and its tags are auto-copied to Dataplex + // service. Visible in both services. Editable in Dataplex, read-only in + // DataCatalog. + DataplexTransferStatus string `json:"dataplexTransferStatus,omitempty"` // Fields: Required. Maps the ID of a tag field to its value and additional // information about that field. Tag template defines valid field IDs. A tag // must have at least 1 field and at most 500 fields. @@ -3256,6 +3413,9 @@ type GoogleCloudDatacatalogV1TagTemplate struct { // Visible in both services. Editable in DataCatalog, read-only in Dataplex. // Deprecated: Individual TagTemplate migration is deprecated in favor of // organization or project wide TagTemplate migration opt-in. + // "TRANSFERRED" - TagTemplate and its tags are auto-copied to Dataplex + // service. Visible in both services. Editable in Dataplex, read-only in + // DataCatalog. DataplexTransferStatus string `json:"dataplexTransferStatus,omitempty"` // DisplayName: Display name for this template. Defaults to an empty string. // The name must contain only Unicode letters, numbers (0-9), underscores (_), @@ -4267,6 +4427,546 @@ func (c *EntriesLookupCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDataca return ret, nil } +type OrganizationsLocationsRetrieveConfigCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// RetrieveConfig: Retrieves the configuration related to the migration from +// Data Catalog to Dataplex for a specific organization, including all the +// projects under it which have a separate configuration set. +// +// - name: The organization whose config is being retrieved. +func (r *OrganizationsLocationsService) RetrieveConfig(name string) *OrganizationsLocationsRetrieveConfigCall { + c := &OrganizationsLocationsRetrieveConfigCall{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 *OrganizationsLocationsRetrieveConfigCall) Fields(s ...googleapi.Field) *OrganizationsLocationsRetrieveConfigCall { + 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 *OrganizationsLocationsRetrieveConfigCall) IfNoneMatch(entityTag string) *OrganizationsLocationsRetrieveConfigCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsLocationsRetrieveConfigCall) Context(ctx context.Context) *OrganizationsLocationsRetrieveConfigCall { + 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 *OrganizationsLocationsRetrieveConfigCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsRetrieveConfigCall) 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/{+name}:retrieveConfig") + 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 "datacatalog.organizations.locations.retrieveConfig" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDatacatalogV1OrganizationConfig.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 *OrganizationsLocationsRetrieveConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDatacatalogV1OrganizationConfig, 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 := &GoogleCloudDatacatalogV1OrganizationConfig{ + 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 OrganizationsLocationsRetrieveEffectiveConfigCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// RetrieveEffectiveConfig: Retrieves the effective configuration related to +// the migration from Data Catalog to Dataplex for a specific organization or +// project. If there is no specific configuration set for the resource, the +// setting is checked hierarchicahlly through the ancestors of the resource, +// starting from the resource itself. +// +// - name: The resource whose effective config is being retrieved. +func (r *OrganizationsLocationsService) RetrieveEffectiveConfig(name string) *OrganizationsLocationsRetrieveEffectiveConfigCall { + c := &OrganizationsLocationsRetrieveEffectiveConfigCall{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 *OrganizationsLocationsRetrieveEffectiveConfigCall) Fields(s ...googleapi.Field) *OrganizationsLocationsRetrieveEffectiveConfigCall { + 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 *OrganizationsLocationsRetrieveEffectiveConfigCall) IfNoneMatch(entityTag string) *OrganizationsLocationsRetrieveEffectiveConfigCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsLocationsRetrieveEffectiveConfigCall) Context(ctx context.Context) *OrganizationsLocationsRetrieveEffectiveConfigCall { + 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 *OrganizationsLocationsRetrieveEffectiveConfigCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsRetrieveEffectiveConfigCall) 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/{+name}:retrieveEffectiveConfig") + 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 "datacatalog.organizations.locations.retrieveEffectiveConfig" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDatacatalogV1MigrationConfig.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 *OrganizationsLocationsRetrieveEffectiveConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDatacatalogV1MigrationConfig, 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 := &GoogleCloudDatacatalogV1MigrationConfig{ + 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 OrganizationsLocationsSetConfigCall struct { + s *Service + name string + googleclouddatacatalogv1setconfigrequest *GoogleCloudDatacatalogV1SetConfigRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetConfig: Sets the configuration related to the migration to Dataplex for +// an organization or project. +// +// - name: The organization or project whose config is being specified. +func (r *OrganizationsLocationsService) SetConfig(name string, googleclouddatacatalogv1setconfigrequest *GoogleCloudDatacatalogV1SetConfigRequest) *OrganizationsLocationsSetConfigCall { + c := &OrganizationsLocationsSetConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googleclouddatacatalogv1setconfigrequest = googleclouddatacatalogv1setconfigrequest + 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 *OrganizationsLocationsSetConfigCall) Fields(s ...googleapi.Field) *OrganizationsLocationsSetConfigCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsLocationsSetConfigCall) Context(ctx context.Context) *OrganizationsLocationsSetConfigCall { + 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 *OrganizationsLocationsSetConfigCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsSetConfigCall) 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.googleclouddatacatalogv1setconfigrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:setConfig") + 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 "datacatalog.organizations.locations.setConfig" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDatacatalogV1MigrationConfig.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 *OrganizationsLocationsSetConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDatacatalogV1MigrationConfig, 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 := &GoogleCloudDatacatalogV1MigrationConfig{ + 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 ProjectsLocationsRetrieveEffectiveConfigCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// RetrieveEffectiveConfig: Retrieves the effective configuration related to +// the migration from Data Catalog to Dataplex for a specific organization or +// project. If there is no specific configuration set for the resource, the +// setting is checked hierarchicahlly through the ancestors of the resource, +// starting from the resource itself. +// +// - name: The resource whose effective config is being retrieved. +func (r *ProjectsLocationsService) RetrieveEffectiveConfig(name string) *ProjectsLocationsRetrieveEffectiveConfigCall { + c := &ProjectsLocationsRetrieveEffectiveConfigCall{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 *ProjectsLocationsRetrieveEffectiveConfigCall) Fields(s ...googleapi.Field) *ProjectsLocationsRetrieveEffectiveConfigCall { + 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 *ProjectsLocationsRetrieveEffectiveConfigCall) IfNoneMatch(entityTag string) *ProjectsLocationsRetrieveEffectiveConfigCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsRetrieveEffectiveConfigCall) Context(ctx context.Context) *ProjectsLocationsRetrieveEffectiveConfigCall { + 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 *ProjectsLocationsRetrieveEffectiveConfigCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsRetrieveEffectiveConfigCall) 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/{+name}:retrieveEffectiveConfig") + 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 "datacatalog.projects.locations.retrieveEffectiveConfig" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDatacatalogV1MigrationConfig.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 *ProjectsLocationsRetrieveEffectiveConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDatacatalogV1MigrationConfig, 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 := &GoogleCloudDatacatalogV1MigrationConfig{ + 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 ProjectsLocationsSetConfigCall struct { + s *Service + name string + googleclouddatacatalogv1setconfigrequest *GoogleCloudDatacatalogV1SetConfigRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetConfig: Sets the configuration related to the migration to Dataplex for +// an organization or project. +// +// - name: The organization or project whose config is being specified. +func (r *ProjectsLocationsService) SetConfig(name string, googleclouddatacatalogv1setconfigrequest *GoogleCloudDatacatalogV1SetConfigRequest) *ProjectsLocationsSetConfigCall { + c := &ProjectsLocationsSetConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googleclouddatacatalogv1setconfigrequest = googleclouddatacatalogv1setconfigrequest + 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 *ProjectsLocationsSetConfigCall) Fields(s ...googleapi.Field) *ProjectsLocationsSetConfigCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsSetConfigCall) Context(ctx context.Context) *ProjectsLocationsSetConfigCall { + 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 *ProjectsLocationsSetConfigCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsSetConfigCall) 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.googleclouddatacatalogv1setconfigrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:setConfig") + 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 "datacatalog.projects.locations.setConfig" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDatacatalogV1MigrationConfig.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 *ProjectsLocationsSetConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDatacatalogV1MigrationConfig, 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 := &GoogleCloudDatacatalogV1MigrationConfig{ + 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 ProjectsLocationsEntryGroupsCreateCall struct { s *Service parent string diff --git a/datacatalog/v1beta1/datacatalog-api.json b/datacatalog/v1beta1/datacatalog-api.json index dbcc48e9eab..379e783521a 100644 --- a/datacatalog/v1beta1/datacatalog-api.json +++ b/datacatalog/v1beta1/datacatalog-api.json @@ -1813,7 +1813,7 @@ } } }, - "revision": "20240614", + "revision": "20241021", "rootUrl": "https://datacatalog.googleapis.com/", "schemas": { "Binding": { @@ -3171,6 +3171,26 @@ "description": "Resources like entry can have schemas associated with them. This scope allows you to attach tags to an individual column based on that schema. To attach a tag to a nested column, separate column names with a dot (`.`). Example: `column.nested_column`.", "type": "string" }, + "dataplexTransferStatus": { + "description": "Output only. Denotes the transfer status of the Tag Template.", + "enum": [ + "DATAPLEX_TRANSFER_STATUS_UNSPECIFIED", + "MIGRATED", + "TRANSFERRED" + ], + "enumDeprecated": [ + false, + true, + false + ], + "enumDescriptions": [ + "Default value. TagTemplate and its tags are only visible and editable in DataCatalog.", + "TagTemplate and its tags are auto-copied to Dataplex service. Visible in both services. Editable in DataCatalog, read-only in Dataplex. Deprecated: Individual TagTemplate migration is deprecated in favor of organization or project wide TagTemplate migration opt-in.", + "TagTemplate and its tags are auto-copied to Dataplex service. Visible in both services. Editable in Dataplex, read-only in DataCatalog." + ], + "readOnly": true, + "type": "string" + }, "fields": { "additionalProperties": { "$ref": "GoogleCloudDatacatalogV1TagField" diff --git a/datacatalog/v1beta1/datacatalog-gen.go b/datacatalog/v1beta1/datacatalog-gen.go index f2dbc65c59a..463a900736e 100644 --- a/datacatalog/v1beta1/datacatalog-gen.go +++ b/datacatalog/v1beta1/datacatalog-gen.go @@ -2183,6 +2183,20 @@ type GoogleCloudDatacatalogV1Tag struct { // schema. To attach a tag to a nested column, separate column names with a dot // (`.`). Example: `column.nested_column`. Column string `json:"column,omitempty"` + // DataplexTransferStatus: Output only. Denotes the transfer status of the Tag + // Template. + // + // Possible values: + // "DATAPLEX_TRANSFER_STATUS_UNSPECIFIED" - Default value. TagTemplate and + // its tags are only visible and editable in DataCatalog. + // "MIGRATED" - TagTemplate and its tags are auto-copied to Dataplex service. + // Visible in both services. Editable in DataCatalog, read-only in Dataplex. + // Deprecated: Individual TagTemplate migration is deprecated in favor of + // organization or project wide TagTemplate migration opt-in. + // "TRANSFERRED" - TagTemplate and its tags are auto-copied to Dataplex + // service. Visible in both services. Editable in Dataplex, read-only in + // DataCatalog. + DataplexTransferStatus string `json:"dataplexTransferStatus,omitempty"` // Fields: Required. Maps the ID of a tag field to its value and additional // information about that field. Tag template defines valid field IDs. A tag // must have at least 1 field and at most 500 fields. diff --git a/dataform/v1beta1/dataform-api.json b/dataform/v1beta1/dataform-api.json index 2907ae28d5c..4e941d7cefa 100644 --- a/dataform/v1beta1/dataform-api.json +++ b/dataform/v1beta1/dataform-api.json @@ -467,7 +467,7 @@ "type": "integer" }, "pageToken": { - "description": "Optional. Page token received from a previous `FetchRepositoryHistory` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `FetchRepositoryHistory` must match the call that provided the page token.", + "description": "Optional. Page token received from a previous `FetchRepositoryHistory` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `FetchRepositoryHistory`, with the exception of `page_size`, must match the call that provided the page token.", "location": "query", "type": "string" } @@ -587,7 +587,7 @@ "type": "integer" }, "pageToken": { - "description": "Optional. Page token received from a previous `ListRepositories` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListRepositories` must match the call that provided the page token.", + "description": "Optional. Page token received from a previous `ListRepositories` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListRepositories`, with the exception of `page_size`, must match the call that provided the page token.", "location": "query", "type": "string" }, @@ -669,7 +669,7 @@ "type": "integer" }, "pageToken": { - "description": "Optional. Page token received from a previous `QueryRepositoryDirectoryContents` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `QueryRepositoryDirectoryContents` must match the call that provided the page token.", + "description": "Optional. Page token received from a previous `QueryRepositoryDirectoryContents` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `QueryRepositoryDirectoryContents`, with the exception of `page_size`, must match the call that provided the page token.", "location": "query", "type": "string" }, @@ -989,7 +989,7 @@ "type": "integer" }, "pageToken": { - "description": "Optional. Page token received from a previous `ListCompilationResults` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListCompilationResults` must match the call that provided the page token.", + "description": "Optional. Page token received from a previous `ListCompilationResults` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListCompilationResults`, with the exception of `page_size`, must match the call that provided the page token.", "location": "query", "type": "string" }, @@ -1037,7 +1037,7 @@ "type": "integer" }, "pageToken": { - "description": "Optional. Page token received from a previous `QueryCompilationResultActions` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `QueryCompilationResultActions` must match the call that provided the page token.", + "description": "Optional. Page token received from a previous `QueryCompilationResultActions` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `QueryCompilationResultActions`, with the exception of `page_size`, must match the call that provided the page token.", "location": "query", "type": "string" } @@ -1153,7 +1153,7 @@ "type": "integer" }, "pageToken": { - "description": "Optional. Page token received from a previous `ListReleaseConfigs` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListReleaseConfigs` must match the call that provided the page token.", + "description": "Optional. Page token received from a previous `ListReleaseConfigs` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListReleaseConfigs`, with the exception of `page_size`, must match the call that provided the page token.", "location": "query", "type": "string" }, @@ -1310,7 +1310,7 @@ "type": "integer" }, "pageToken": { - "description": "Optional. Page token received from a previous `ListWorkflowConfigs` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListWorkflowConfigs` must match the call that provided the page token.", + "description": "Optional. Page token received from a previous `ListWorkflowConfigs` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListWorkflowConfigs`, with the exception of `page_size`, must match the call that provided the page token.", "location": "query", "type": "string" }, @@ -1500,7 +1500,7 @@ "type": "integer" }, "pageToken": { - "description": "Optional. Page token received from a previous `ListWorkflowInvocations` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListWorkflowInvocations` must match the call that provided the page token.", + "description": "Optional. Page token received from a previous `ListWorkflowInvocations` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListWorkflowInvocations`, with the exception of `page_size`, must match the call that provided the page token.", "location": "query", "type": "string" }, @@ -1543,7 +1543,7 @@ "type": "integer" }, "pageToken": { - "description": "Optional. Page token received from a previous `QueryWorkflowInvocationActions` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `QueryWorkflowInvocationActions` must match the call that provided the page token.", + "description": "Optional. Page token received from a previous `QueryWorkflowInvocationActions` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `QueryWorkflowInvocationActions`, with the exception of `page_size`, must match the call that provided the page token.", "location": "query", "type": "string" } @@ -1841,7 +1841,7 @@ "type": "integer" }, "pageToken": { - "description": "Optional. Page token received from a previous `ListWorkspaces` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListWorkspaces` must match the call that provided the page token.", + "description": "Optional. Page token received from a previous `ListWorkspaces` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListWorkspaces`, with the exception of `page_size`, must match the call that provided the page token.", "location": "query", "type": "string" }, @@ -2017,7 +2017,7 @@ "type": "integer" }, "pageToken": { - "description": "Optional. Page token received from a previous `QueryDirectoryContents` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `QueryDirectoryContents` must match the call that provided the page token.", + "description": "Optional. Page token received from a previous `QueryDirectoryContents` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `QueryDirectoryContents`, with the exception of `page_size`, must match the call that provided the page token.", "location": "query", "type": "string" }, @@ -2182,7 +2182,7 @@ "type": "integer" }, "pageToken": { - "description": "Optional. Page token received from a previous `SearchFilesRequest` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `SearchFilesRequest` must match the call that provided the page token.", + "description": "Optional. Page token received from a previous `SearchFilesRequest` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `SearchFilesRequest`, with the exception of `page_size`, must match the call that provided the page token.", "location": "query", "type": "string" }, @@ -2295,7 +2295,7 @@ } } }, - "revision": "20240824", + "revision": "20241020", "rootUrl": "https://dataform.googleapis.com/", "schemas": { "Assertion": { @@ -2655,10 +2655,6 @@ "$ref": "Target", "description": "The action's identifier if the project had been compiled without any overrides configured. Unique within the compilation result." }, - "dataPreparation": { - "$ref": "DataPreparation", - "description": "The data preparation executed by this action." - }, "declaration": { "$ref": "Declaration", "description": "The declaration declared by this action." @@ -2735,36 +2731,6 @@ }, "type": "object" }, - "DataPreparation": { - "description": "Defines a compiled Data Preparation entity", - "id": "DataPreparation", - "properties": { - "contents": { - "description": "The data preparation definition, stored as a binary encoded proto.", - "format": "byte", - "type": "string" - }, - "dependencyTargets": { - "description": "A list of actions that this action depends on.", - "items": { - "$ref": "Target" - }, - "type": "array" - }, - "disabled": { - "description": "Whether this action is disabled (i.e. should not be run).", - "type": "boolean" - }, - "tags": { - "description": "Arbitrary, user-defined tags on this action.", - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "Declaration": { "description": "Represents a relation which is not managed by Dataform but which may be referenced by Dataform actions.", "id": "Declaration", @@ -3776,7 +3742,7 @@ "type": "string" }, "recentScheduledReleaseRecords": { - "description": "Output only. Records of the 10 most recent scheduled release attempts, ordered in in descending order of `release_time`. Updated whenever automatic creation of a compilation result is triggered by cron_schedule.", + "description": "Output only. Records of the 10 most recent scheduled release attempts, ordered in descending order of `release_time`. Updated whenever automatic creation of a compilation result is triggered by cron_schedule.", "items": { "$ref": "ScheduledReleaseRecord" }, @@ -3840,7 +3806,7 @@ "description": "Optional. If set, configures this repository to be linked to a Git remote." }, "kmsKeyName": { - "description": "Optional. The reference to a KMS encryption key. If provided, it will be used to encrypt user data in the repository and all child resources. It is not possible to add or update the encryption key after the repository is created. Example: `projects/[kms_project_id]/locations/[region]/keyRings/[key_region]/cryptoKeys/[key]`", + "description": "Optional. The reference to a KMS encryption key. If provided, it will be used to encrypt user data in the repository and all child resources. It is not possible to add or update the encryption key after the repository is created. Example: `projects/{kms_project}/locations/{location}/keyRings/{key_location}/cryptoKeys/{key}`", "type": "string" }, "labels": { @@ -4116,7 +4082,7 @@ "type": "string" }, "recentScheduledExecutionRecords": { - "description": "Output only. Records of the 10 most recent scheduled execution attempts, ordered in in descending order of `execution_time`. Updated whenever automatic creation of a workflow invocation is triggered by cron_schedule.", + "description": "Output only. Records of the 10 most recent scheduled execution attempts, ordered in descending order of `execution_time`. Updated whenever automatic creation of a workflow invocation is triggered by cron_schedule.", "items": { "$ref": "ScheduledExecutionRecord" }, @@ -4264,6 +4230,12 @@ "description": "Represents a Dataform Git workspace.", "id": "Workspace", "properties": { + "createTime": { + "description": "Output only. The timestamp of when the workspace was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, "dataEncryptionState": { "$ref": "DataEncryptionState", "description": "Output only. A data encryption state of a Git repository if this Workspace is protected by a KMS key.", diff --git a/dataform/v1beta1/dataform-gen.go b/dataform/v1beta1/dataform-gen.go index 607db32ffe3..700a52c871a 100644 --- a/dataform/v1beta1/dataform-gen.go +++ b/dataform/v1beta1/dataform-gen.go @@ -772,8 +772,6 @@ type CompilationResultAction struct { // CanonicalTarget: The action's identifier if the project had been compiled // without any overrides configured. Unique within the compilation result. CanonicalTarget *Target `json:"canonicalTarget,omitempty"` - // DataPreparation: The data preparation executed by this action. - DataPreparation *DataPreparation `json:"dataPreparation,omitempty"` // Declaration: The declaration declared by this action. Declaration *Declaration `json:"declaration,omitempty"` // FilePath: The full path including filename in which this action is located, @@ -891,34 +889,6 @@ func (s DataEncryptionState) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// DataPreparation: Defines a compiled Data Preparation entity -type DataPreparation struct { - // Contents: The data preparation definition, stored as a binary encoded proto. - Contents string `json:"contents,omitempty"` - // DependencyTargets: A list of actions that this action depends on. - DependencyTargets []*Target `json:"dependencyTargets,omitempty"` - // Disabled: Whether this action is disabled (i.e. should not be run). - Disabled bool `json:"disabled,omitempty"` - // Tags: Arbitrary, user-defined tags on this action. - Tags []string `json:"tags,omitempty"` - // ForceSendFields is a list of field names (e.g. "Contents") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Contents") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s DataPreparation) MarshalJSON() ([]byte, error) { - type NoMethod DataPreparation - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // Declaration: Represents a relation which is not managed by Dataform but // which may be referenced by Dataform actions. type Declaration struct { @@ -2301,9 +2271,9 @@ type ReleaseConfig struct { // Name: Identifier. The release config's name. Name string `json:"name,omitempty"` // RecentScheduledReleaseRecords: Output only. Records of the 10 most recent - // scheduled release attempts, ordered in in descending order of - // `release_time`. Updated whenever automatic creation of a compilation result - // is triggered by cron_schedule. + // scheduled release attempts, ordered in descending order of `release_time`. + // Updated whenever automatic creation of a compilation result is triggered by + // cron_schedule. RecentScheduledReleaseRecords []*ScheduledReleaseRecord `json:"recentScheduledReleaseRecords,omitempty"` // ReleaseCompilationResult: Optional. The name of the currently released // compilation result for this release config. This value is updated when a @@ -2401,8 +2371,8 @@ type Repository struct { // will be used to encrypt user data in the repository and all child resources. // It is not possible to add or update the encryption key after the repository // is created. Example: - // `projects/[kms_project_id]/locations/[region]/keyRings/[key_region]/cryptoKey - // s/[key]` + // `projects/{kms_project}/locations/{location}/keyRings/{key_location}/cryptoKe + // ys/{key}` KmsKeyName string `json:"kmsKeyName,omitempty"` // Labels: Optional. Repository user labels. Labels map[string]string `json:"labels,omitempty"` @@ -2801,7 +2771,7 @@ type WorkflowConfig struct { // Name: Identifier. The workflow config's name. Name string `json:"name,omitempty"` // RecentScheduledExecutionRecords: Output only. Records of the 10 most recent - // scheduled execution attempts, ordered in in descending order of + // scheduled execution attempts, ordered in descending order of // `execution_time`. Updated whenever automatic creation of a workflow // invocation is triggered by cron_schedule. RecentScheduledExecutionRecords []*ScheduledExecutionRecord `json:"recentScheduledExecutionRecords,omitempty"` @@ -2947,6 +2917,8 @@ func (s WorkflowInvocationAction) MarshalJSON() ([]byte, error) { // Workspace: Represents a Dataform Git workspace. type Workspace struct { + // CreateTime: Output only. The timestamp of when the workspace was created. + CreateTime string `json:"createTime,omitempty"` // DataEncryptionState: Output only. A data encryption state of a Git // repository if this Workspace is protected by a KMS key. DataEncryptionState *DataEncryptionState `json:"dataEncryptionState,omitempty"` @@ -2955,15 +2927,15 @@ type Workspace struct { // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "DataEncryptionState") to + // 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. "DataEncryptionState") 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. "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:"-"` } @@ -4332,7 +4304,8 @@ func (c *ProjectsLocationsRepositoriesFetchHistoryCall) PageSize(pageSize int64) // PageToken sets the optional parameter "pageToken": Page token received from // a previous `FetchRepositoryHistory` call. Provide this to retrieve the // subsequent page. When paginating, all other parameters provided to -// `FetchRepositoryHistory` must match the call that provided the page token. +// `FetchRepositoryHistory`, with the exception of `page_size`, must match the +// call that provided the page token. func (c *ProjectsLocationsRepositoriesFetchHistoryCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesFetchHistoryCall { c.urlParams_.Set("pageToken", pageToken) return c @@ -4834,8 +4807,9 @@ func (c *ProjectsLocationsRepositoriesListCall) PageSize(pageSize int64) *Projec // PageToken sets the optional parameter "pageToken": Page token received from // a previous `ListRepositories` call. Provide this to retrieve the subsequent -// page. When paginating, all other parameters provided to `ListRepositories` -// must match the call that provided the page token. +// page. When paginating, all other parameters provided to `ListRepositories`, +// with the exception of `page_size`, must match the call that provided the +// page token. func (c *ProjectsLocationsRepositoriesListCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesListCall { c.urlParams_.Set("pageToken", pageToken) return c @@ -5098,8 +5072,8 @@ func (c *ProjectsLocationsRepositoriesQueryDirectoryContentsCall) PageSize(pageS // PageToken sets the optional parameter "pageToken": Page token received from // a previous `QueryRepositoryDirectoryContents` call. Provide this to retrieve // the subsequent page. When paginating, all other parameters provided to -// `QueryRepositoryDirectoryContents` must match the call that provided the -// page token. +// `QueryRepositoryDirectoryContents`, with the exception of `page_size`, must +// match the call that provided the page token. func (c *ProjectsLocationsRepositoriesQueryDirectoryContentsCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesQueryDirectoryContentsCall { c.urlParams_.Set("pageToken", pageToken) return c @@ -6280,7 +6254,8 @@ func (c *ProjectsLocationsRepositoriesCompilationResultsListCall) PageSize(pageS // PageToken sets the optional parameter "pageToken": Page token received from // a previous `ListCompilationResults` call. Provide this to retrieve the // subsequent page. When paginating, all other parameters provided to -// `ListCompilationResults` must match the call that provided the page token. +// `ListCompilationResults`, with the exception of `page_size`, must match the +// call that provided the page token. func (c *ProjectsLocationsRepositoriesCompilationResultsListCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesCompilationResultsListCall { c.urlParams_.Set("pageToken", pageToken) return c @@ -6434,8 +6409,8 @@ func (c *ProjectsLocationsRepositoriesCompilationResultsQueryCall) PageSize(page // PageToken sets the optional parameter "pageToken": Page token received from // a previous `QueryCompilationResultActions` call. Provide this to retrieve // the subsequent page. When paginating, all other parameters provided to -// `QueryCompilationResultActions` must match the call that provided the page -// token. +// `QueryCompilationResultActions`, with the exception of `page_size`, must +// match the call that provided the page token. func (c *ProjectsLocationsRepositoriesCompilationResultsQueryCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesCompilationResultsQueryCall { c.urlParams_.Set("pageToken", pageToken) return c @@ -6894,7 +6869,8 @@ func (c *ProjectsLocationsRepositoriesReleaseConfigsListCall) PageSize(pageSize // PageToken sets the optional parameter "pageToken": Page token received from // a previous `ListReleaseConfigs` call. Provide this to retrieve the // subsequent page. When paginating, all other parameters provided to -// `ListReleaseConfigs` must match the call that provided the page token. +// `ListReleaseConfigs`, with the exception of `page_size`, must match the call +// that provided the page token. func (c *ProjectsLocationsRepositoriesReleaseConfigsListCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesReleaseConfigsListCall { c.urlParams_.Set("pageToken", pageToken) return c @@ -7461,7 +7437,8 @@ func (c *ProjectsLocationsRepositoriesWorkflowConfigsListCall) PageSize(pageSize // PageToken sets the optional parameter "pageToken": Page token received from // a previous `ListWorkflowConfigs` call. Provide this to retrieve the // subsequent page. When paginating, all other parameters provided to -// `ListWorkflowConfigs` must match the call that provided the page token. +// `ListWorkflowConfigs`, with the exception of `page_size`, must match the +// call that provided the page token. func (c *ProjectsLocationsRepositoriesWorkflowConfigsListCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesWorkflowConfigsListCall { c.urlParams_.Set("pageToken", pageToken) return c @@ -8138,7 +8115,8 @@ func (c *ProjectsLocationsRepositoriesWorkflowInvocationsListCall) PageSize(page // PageToken sets the optional parameter "pageToken": Page token received from // a previous `ListWorkflowInvocations` call. Provide this to retrieve the // subsequent page. When paginating, all other parameters provided to -// `ListWorkflowInvocations` must match the call that provided the page token. +// `ListWorkflowInvocations`, with the exception of `page_size`, must match the +// call that provided the page token. func (c *ProjectsLocationsRepositoriesWorkflowInvocationsListCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesWorkflowInvocationsListCall { c.urlParams_.Set("pageToken", pageToken) return c @@ -8284,8 +8262,8 @@ func (c *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall) PageSize(pag // PageToken sets the optional parameter "pageToken": Page token received from // a previous `QueryWorkflowInvocationActions` call. Provide this to retrieve // the subsequent page. When paginating, all other parameters provided to -// `QueryWorkflowInvocationActions` must match the call that provided the page -// token. +// `QueryWorkflowInvocationActions`, with the exception of `page_size`, must +// match the call that provided the page token. func (c *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall { c.urlParams_.Set("pageToken", pageToken) return c @@ -9426,8 +9404,9 @@ func (c *ProjectsLocationsRepositoriesWorkspacesListCall) PageSize(pageSize int6 // PageToken sets the optional parameter "pageToken": Page token received from // a previous `ListWorkspaces` call. Provide this to retrieve the subsequent -// page. When paginating, all other parameters provided to `ListWorkspaces` -// must match the call that provided the page token. +// page. When paginating, all other parameters provided to `ListWorkspaces`, +// with the exception of `page_size`, must match the call that provided the +// page token. func (c *ProjectsLocationsRepositoriesWorkspacesListCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesWorkspacesListCall { c.urlParams_.Set("pageToken", pageToken) return c @@ -10082,7 +10061,8 @@ func (c *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall) Page // PageToken sets the optional parameter "pageToken": Page token received from // a previous `QueryDirectoryContents` call. Provide this to retrieve the // subsequent page. When paginating, all other parameters provided to -// `QueryDirectoryContents` must match the call that provided the page token. +// `QueryDirectoryContents`, with the exception of `page_size`, must match the +// call that provided the page token. func (c *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall { c.urlParams_.Set("pageToken", pageToken) return c @@ -10671,7 +10651,8 @@ func (c *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall) PageSize(pageSi // PageToken sets the optional parameter "pageToken": Page token received from // a previous `SearchFilesRequest` call. Provide this to retrieve the // subsequent page. When paginating, all other parameters provided to -// `SearchFilesRequest` must match the call that provided the page token. +// `SearchFilesRequest`, with the exception of `page_size`, must match the call +// that provided the page token. func (c *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall { c.urlParams_.Set("pageToken", pageToken) return c diff --git a/datamigration/v1/datamigration-api.json b/datamigration/v1/datamigration-api.json index ba8ec7012d3..79ceed6a13b 100644 --- a/datamigration/v1/datamigration-api.json +++ b/datamigration/v1/datamigration-api.json @@ -2218,7 +2218,7 @@ } } }, - "revision": "20241015", + "revision": "20241022", "rootUrl": "https://datamigration.googleapis.com/", "schemas": { "AlloyDbConnectionProfile": { @@ -6090,12 +6090,16 @@ "enum": [ "SSL_TYPE_UNSPECIFIED", "SERVER_ONLY", - "SERVER_CLIENT" + "SERVER_CLIENT", + "REQUIRED", + "NONE" ], "enumDescriptions": [ "Unspecified.", "Only 'ca_certificate' specified.", - "Both server ('ca_certificate'), and client ('client_key', 'client_certificate') specified." + "Both server ('ca_certificate'), and client ('client_key', 'client_certificate') specified.", + "Mandates SSL encryption for all connections. This doesn’t require certificate verification.", + "Connection is not encrypted." ], "type": "string" } diff --git a/datamigration/v1/datamigration-gen.go b/datamigration/v1/datamigration-gen.go index 5a184ba6c16..2a84320f726 100644 --- a/datamigration/v1/datamigration-gen.go +++ b/datamigration/v1/datamigration-gen.go @@ -4694,6 +4694,9 @@ type SslConfig struct { // "SERVER_ONLY" - Only 'ca_certificate' specified. // "SERVER_CLIENT" - Both server ('ca_certificate'), and client // ('client_key', 'client_certificate') specified. + // "REQUIRED" - Mandates SSL encryption for all connections. This doesn’t + // require certificate verification. + // "NONE" - Connection is not encrypted. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "CaCertificate") to // unconditionally include in API requests. By default, fields with empty or diff --git a/dataplex/v1/dataplex-api.json b/dataplex/v1/dataplex-api.json index 608cc596bb5..5a82a3c5422 100644 --- a/dataplex/v1/dataplex-api.json +++ b/dataplex/v1/dataplex-api.json @@ -15,6 +15,233 @@ "description": "Dataplex API is used to manage the lifecycle of data lakes.", "discoveryVersion": "v1", "documentationLink": "https://cloud.google.com/dataplex/docs", + "endpoints": [ + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.africa-south1.rep.googleapis.com/", + "location": "africa-south1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.asia-east1.rep.googleapis.com/", + "location": "asia-east1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.asia-east2.rep.googleapis.com/", + "location": "asia-east2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.asia-northeast1.rep.googleapis.com/", + "location": "asia-northeast1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.asia-northeast2.rep.googleapis.com/", + "location": "asia-northeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.asia-northeast3.rep.googleapis.com/", + "location": "asia-northeast3" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.asia-south1.rep.googleapis.com/", + "location": "asia-south1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.asia-south2.rep.googleapis.com/", + "location": "asia-south2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.asia-southeast1.rep.googleapis.com/", + "location": "asia-southeast1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.asia-southeast2.rep.googleapis.com/", + "location": "asia-southeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.australia-southeast1.rep.googleapis.com/", + "location": "australia-southeast1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.australia-southeast2.rep.googleapis.com/", + "location": "australia-southeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.europe-central2.rep.googleapis.com/", + "location": "europe-central2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.europe-north1.rep.googleapis.com/", + "location": "europe-north1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.europe-north2.rep.googleapis.com/", + "location": "europe-north2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.europe-southwest1.rep.googleapis.com/", + "location": "europe-southwest1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.europe-west1.rep.googleapis.com/", + "location": "europe-west1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.europe-west10.rep.googleapis.com/", + "location": "europe-west10" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.europe-west12.rep.googleapis.com/", + "location": "europe-west12" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.europe-west2.rep.googleapis.com/", + "location": "europe-west2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.europe-west3.rep.googleapis.com/", + "location": "europe-west3" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.europe-west4.rep.googleapis.com/", + "location": "europe-west4" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.europe-west6.rep.googleapis.com/", + "location": "europe-west6" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.europe-west8.rep.googleapis.com/", + "location": "europe-west8" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.europe-west9.rep.googleapis.com/", + "location": "europe-west9" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.me-central1.rep.googleapis.com/", + "location": "me-central1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.me-central2.rep.googleapis.com/", + "location": "me-central2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.me-west1.rep.googleapis.com/", + "location": "me-west1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.northamerica-northeast1.rep.googleapis.com/", + "location": "northamerica-northeast1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.northamerica-northeast2.rep.googleapis.com/", + "location": "northamerica-northeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.northamerica-south1.rep.googleapis.com/", + "location": "northamerica-south1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.southamerica-east1.rep.googleapis.com/", + "location": "southamerica-east1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.southamerica-west1.rep.googleapis.com/", + "location": "southamerica-west1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.us-central1.rep.googleapis.com/", + "location": "us-central1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.us-central2.rep.googleapis.com/", + "location": "us-central2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.us-east1.rep.googleapis.com/", + "location": "us-east1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.us-east4.rep.googleapis.com/", + "location": "us-east4" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.us-east5.rep.googleapis.com/", + "location": "us-east5" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.us-east7.rep.googleapis.com/", + "location": "us-east7" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.us-south1.rep.googleapis.com/", + "location": "us-south1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.us-west1.rep.googleapis.com/", + "location": "us-west1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.us-west2.rep.googleapis.com/", + "location": "us-west2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.us-west3.rep.googleapis.com/", + "location": "us-west3" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.us-west4.rep.googleapis.com/", + "location": "us-west4" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://dataplex.us-west8.rep.googleapis.com/", + "location": "us-west8" + } + ], "fullyEncodeReservedExpansion": true, "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", @@ -5997,7 +6224,7 @@ } } }, - "revision": "20241001", + "revision": "20241019", "rootUrl": "https://dataplex.googleapis.com/", "schemas": { "Empty": { @@ -7118,6 +7345,142 @@ }, "type": "object" }, + "GoogleCloudDataplexV1DataDiscoveryResult": { + "description": "The output of a data discovery scan.", + "id": "GoogleCloudDataplexV1DataDiscoveryResult", + "properties": { + "bigqueryPublishing": { + "$ref": "GoogleCloudDataplexV1DataDiscoveryResultBigQueryPublishing", + "description": "Output only. Configuration for metadata publishing.", + "readOnly": true + } + }, + "type": "object" + }, + "GoogleCloudDataplexV1DataDiscoveryResultBigQueryPublishing": { + "description": "Describes BigQuery publishing configurations.", + "id": "GoogleCloudDataplexV1DataDiscoveryResultBigQueryPublishing", + "properties": { + "dataset": { + "description": "Output only. The BigQuery dataset to publish to. It takes the form projects/{project_id}/datasets/{dataset_id}. If not set, the service creates a default publishing dataset.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDataplexV1DataDiscoverySpec": { + "description": "Spec for a data discovery scan.", + "id": "GoogleCloudDataplexV1DataDiscoverySpec", + "properties": { + "bigqueryPublishingConfig": { + "$ref": "GoogleCloudDataplexV1DataDiscoverySpecBigQueryPublishingConfig", + "description": "Optional. Configuration for metadata publishing." + }, + "storageConfig": { + "$ref": "GoogleCloudDataplexV1DataDiscoverySpecStorageConfig", + "description": "Cloud Storage related configurations." + } + }, + "type": "object" + }, + "GoogleCloudDataplexV1DataDiscoverySpecBigQueryPublishingConfig": { + "description": "Describes BigQuery publishing configurations.", + "id": "GoogleCloudDataplexV1DataDiscoverySpecBigQueryPublishingConfig", + "properties": { + "connection": { + "description": "Optional. The BigQuery connection used to create BigLake tables. Must be in the form projects/{project_id}/locations/{location_id}/connections/{connection_id}", + "type": "string" + }, + "tableType": { + "description": "Optional. Determines whether to publish discovered tables as BigLake external tables or non-BigLake external tables.", + "enum": [ + "TABLE_TYPE_UNSPECIFIED", + "EXTERNAL", + "BIGLAKE" + ], + "enumDescriptions": [ + "Table type unspecified.", + "Default. Discovered tables are published as BigQuery external tables whose data is accessed using the credentials of the user querying the table.", + "Discovered tables are published as BigLake external tables whose data is accessed using the credentials of the associated BigQuery connection." + ], + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDataplexV1DataDiscoverySpecStorageConfig": { + "description": "Configurations related to Cloud Storage as the data source.", + "id": "GoogleCloudDataplexV1DataDiscoverySpecStorageConfig", + "properties": { + "csvOptions": { + "$ref": "GoogleCloudDataplexV1DataDiscoverySpecStorageConfigCsvOptions", + "description": "Optional. Configuration for CSV data." + }, + "excludePatterns": { + "description": "Optional. Defines the data to exclude during discovery. Provide a list of patterns that identify the data to exclude. For Cloud Storage bucket assets, these patterns are interpreted as glob patterns used to match object names. For BigQuery dataset assets, these patterns are interpreted as patterns to match table names.", + "items": { + "type": "string" + }, + "type": "array" + }, + "includePatterns": { + "description": "Optional. Defines the data to include during discovery when only a subset of the data should be considered. Provide a list of patterns that identify the data to include. For Cloud Storage bucket assets, these patterns are interpreted as glob patterns used to match object names. For BigQuery dataset assets, these patterns are interpreted as patterns to match table names.", + "items": { + "type": "string" + }, + "type": "array" + }, + "jsonOptions": { + "$ref": "GoogleCloudDataplexV1DataDiscoverySpecStorageConfigJsonOptions", + "description": "Optional. Configuration for JSON data." + } + }, + "type": "object" + }, + "GoogleCloudDataplexV1DataDiscoverySpecStorageConfigCsvOptions": { + "description": "Describes CSV and similar semi-structured data formats.", + "id": "GoogleCloudDataplexV1DataDiscoverySpecStorageConfigCsvOptions", + "properties": { + "delimiter": { + "description": "Optional. The delimiter that is used to separate values. The default is , (comma).", + "type": "string" + }, + "encoding": { + "description": "Optional. The character encoding of the data. The default is UTF-8.", + "type": "string" + }, + "headerRows": { + "description": "Optional. The number of rows to interpret as header rows that should be skipped when reading data rows.", + "format": "int32", + "type": "integer" + }, + "quote": { + "description": "Optional. The character used to quote column values. Accepts \" (double quotation mark) or ' (single quotation mark). If unspecified, defaults to \" (double quotation mark).", + "type": "string" + }, + "typeInferenceDisabled": { + "description": "Optional. Whether to disable the inference of data types for CSV data. If true, all columns are registered as strings.", + "type": "boolean" + } + }, + "type": "object" + }, + "GoogleCloudDataplexV1DataDiscoverySpecStorageConfigJsonOptions": { + "description": "Describes JSON data format.", + "id": "GoogleCloudDataplexV1DataDiscoverySpecStorageConfigJsonOptions", + "properties": { + "encoding": { + "description": "Optional. The character encoding of the data. The default is UTF-8.", + "type": "string" + }, + "typeInferenceDisabled": { + "description": "Optional. Whether to disable the inference of data types for JSON data. If true, all columns are registered as their primitive types (strings, number, or boolean).", + "type": "boolean" + } + }, + "type": "object" + }, "GoogleCloudDataplexV1DataProfileResult": { "description": "DataProfileResult defines the output of DataProfileScan. Each field of the table will have field type specific profile result.", "id": "GoogleCloudDataplexV1DataProfileResult", @@ -8064,6 +8427,15 @@ "$ref": "GoogleCloudDataplexV1DataSource", "description": "Required. The data source for DataScan." }, + "dataDiscoveryResult": { + "$ref": "GoogleCloudDataplexV1DataDiscoveryResult", + "description": "Output only. The result of a data discovery scan.", + "readOnly": true + }, + "dataDiscoverySpec": { + "$ref": "GoogleCloudDataplexV1DataDiscoverySpec", + "description": "Settings for a data discovery scan." + }, "dataProfileResult": { "$ref": "GoogleCloudDataplexV1DataProfileResult", "description": "Output only. The result of a data profile scan.", @@ -8135,12 +8507,14 @@ "enum": [ "DATA_SCAN_TYPE_UNSPECIFIED", "DATA_QUALITY", - "DATA_PROFILE" + "DATA_PROFILE", + "DATA_DISCOVERY" ], "enumDescriptions": [ "The data scan type is unspecified.", "Data quality scan.", - "Data profile scan." + "Data profile scan.", + "Data discovery scan." ], "readOnly": true, "type": "string" @@ -8456,6 +8830,16 @@ "readOnly": true, "type": "string" }, + "dataDiscoveryResult": { + "$ref": "GoogleCloudDataplexV1DataDiscoveryResult", + "description": "Output only. The result of a data discovery scan.", + "readOnly": true + }, + "dataDiscoverySpec": { + "$ref": "GoogleCloudDataplexV1DataDiscoverySpec", + "description": "Output only. Settings for a data discovery scan.", + "readOnly": true + }, "dataProfileResult": { "$ref": "GoogleCloudDataplexV1DataProfileResult", "description": "Output only. The result of a data profile scan.", @@ -8526,12 +8910,14 @@ "enum": [ "DATA_SCAN_TYPE_UNSPECIFIED", "DATA_QUALITY", - "DATA_PROFILE" + "DATA_PROFILE", + "DATA_DISCOVERY" ], "enumDescriptions": [ "The data scan type is unspecified.", "Data quality scan.", - "Data profile scan." + "Data profile scan.", + "Data discovery scan." ], "readOnly": true, "type": "string" diff --git a/dataplex/v1/dataplex-gen.go b/dataplex/v1/dataplex-gen.go index 1b248ecb08e..5f5c01cb07f 100644 --- a/dataplex/v1/dataplex-gen.go +++ b/dataplex/v1/dataplex-gen.go @@ -1817,6 +1817,218 @@ func (s GoogleCloudDataplexV1DataAttributeBindingPath) MarshalJSON() ([]byte, er return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDataplexV1DataDiscoveryResult: The output of a data discovery +// scan. +type GoogleCloudDataplexV1DataDiscoveryResult struct { + // BigqueryPublishing: Output only. Configuration for metadata publishing. + BigqueryPublishing *GoogleCloudDataplexV1DataDiscoveryResultBigQueryPublishing `json:"bigqueryPublishing,omitempty"` + // ForceSendFields is a list of field names (e.g. "BigqueryPublishing") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BigqueryPublishing") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDataplexV1DataDiscoveryResult) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDataplexV1DataDiscoveryResult + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDataplexV1DataDiscoveryResultBigQueryPublishing: Describes +// BigQuery publishing configurations. +type GoogleCloudDataplexV1DataDiscoveryResultBigQueryPublishing struct { + // Dataset: Output only. The BigQuery dataset to publish to. It takes the form + // projects/{project_id}/datasets/{dataset_id}. If not set, the service creates + // a default publishing dataset. + Dataset string `json:"dataset,omitempty"` + // ForceSendFields is a list of field names (e.g. "Dataset") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Dataset") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDataplexV1DataDiscoveryResultBigQueryPublishing) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDataplexV1DataDiscoveryResultBigQueryPublishing + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDataplexV1DataDiscoverySpec: Spec for a data discovery scan. +type GoogleCloudDataplexV1DataDiscoverySpec struct { + // BigqueryPublishingConfig: Optional. Configuration for metadata publishing. + BigqueryPublishingConfig *GoogleCloudDataplexV1DataDiscoverySpecBigQueryPublishingConfig `json:"bigqueryPublishingConfig,omitempty"` + // StorageConfig: Cloud Storage related configurations. + StorageConfig *GoogleCloudDataplexV1DataDiscoverySpecStorageConfig `json:"storageConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. "BigqueryPublishingConfig") + // to unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BigqueryPublishingConfig") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDataplexV1DataDiscoverySpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDataplexV1DataDiscoverySpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDataplexV1DataDiscoverySpecBigQueryPublishingConfig: Describes +// BigQuery publishing configurations. +type GoogleCloudDataplexV1DataDiscoverySpecBigQueryPublishingConfig struct { + // Connection: Optional. The BigQuery connection used to create BigLake tables. + // Must be in the form + // projects/{project_id}/locations/{location_id}/connections/{connection_id} + Connection string `json:"connection,omitempty"` + // TableType: Optional. Determines whether to publish discovered tables as + // BigLake external tables or non-BigLake external tables. + // + // Possible values: + // "TABLE_TYPE_UNSPECIFIED" - Table type unspecified. + // "EXTERNAL" - Default. Discovered tables are published as BigQuery external + // tables whose data is accessed using the credentials of the user querying the + // table. + // "BIGLAKE" - Discovered tables are published as BigLake external tables + // whose data is accessed using the credentials of the associated BigQuery + // connection. + TableType string `json:"tableType,omitempty"` + // ForceSendFields is a list of field names (e.g. "Connection") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Connection") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDataplexV1DataDiscoverySpecBigQueryPublishingConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDataplexV1DataDiscoverySpecBigQueryPublishingConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDataplexV1DataDiscoverySpecStorageConfig: Configurations related +// to Cloud Storage as the data source. +type GoogleCloudDataplexV1DataDiscoverySpecStorageConfig struct { + // CsvOptions: Optional. Configuration for CSV data. + CsvOptions *GoogleCloudDataplexV1DataDiscoverySpecStorageConfigCsvOptions `json:"csvOptions,omitempty"` + // ExcludePatterns: Optional. Defines the data to exclude during discovery. + // Provide a list of patterns that identify the data to exclude. For Cloud + // Storage bucket assets, these patterns are interpreted as glob patterns used + // to match object names. For BigQuery dataset assets, these patterns are + // interpreted as patterns to match table names. + ExcludePatterns []string `json:"excludePatterns,omitempty"` + // IncludePatterns: Optional. Defines the data to include during discovery when + // only a subset of the data should be considered. Provide a list of patterns + // that identify the data to include. For Cloud Storage bucket assets, these + // patterns are interpreted as glob patterns used to match object names. For + // BigQuery dataset assets, these patterns are interpreted as patterns to match + // table names. + IncludePatterns []string `json:"includePatterns,omitempty"` + // JsonOptions: Optional. Configuration for JSON data. + JsonOptions *GoogleCloudDataplexV1DataDiscoverySpecStorageConfigJsonOptions `json:"jsonOptions,omitempty"` + // ForceSendFields is a list of field names (e.g. "CsvOptions") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CsvOptions") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDataplexV1DataDiscoverySpecStorageConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDataplexV1DataDiscoverySpecStorageConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDataplexV1DataDiscoverySpecStorageConfigCsvOptions: Describes CSV +// and similar semi-structured data formats. +type GoogleCloudDataplexV1DataDiscoverySpecStorageConfigCsvOptions struct { + // Delimiter: Optional. The delimiter that is used to separate values. The + // default is , (comma). + Delimiter string `json:"delimiter,omitempty"` + // Encoding: Optional. The character encoding of the data. The default is + // UTF-8. + Encoding string `json:"encoding,omitempty"` + // HeaderRows: Optional. The number of rows to interpret as header rows that + // should be skipped when reading data rows. + HeaderRows int64 `json:"headerRows,omitempty"` + // Quote: Optional. The character used to quote column values. Accepts " + // (double quotation mark) or ' (single quotation mark). If unspecified, + // defaults to " (double quotation mark). + Quote string `json:"quote,omitempty"` + // TypeInferenceDisabled: Optional. Whether to disable the inference of data + // types for CSV data. If true, all columns are registered as strings. + TypeInferenceDisabled bool `json:"typeInferenceDisabled,omitempty"` + // ForceSendFields is a list of field names (e.g. "Delimiter") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Delimiter") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDataplexV1DataDiscoverySpecStorageConfigCsvOptions) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDataplexV1DataDiscoverySpecStorageConfigCsvOptions + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDataplexV1DataDiscoverySpecStorageConfigJsonOptions: Describes +// JSON data format. +type GoogleCloudDataplexV1DataDiscoverySpecStorageConfigJsonOptions struct { + // Encoding: Optional. The character encoding of the data. The default is + // UTF-8. + Encoding string `json:"encoding,omitempty"` + // TypeInferenceDisabled: Optional. Whether to disable the inference of data + // types for JSON data. If true, all columns are registered as their primitive + // types (strings, number, or boolean). + TypeInferenceDisabled bool `json:"typeInferenceDisabled,omitempty"` + // ForceSendFields is a list of field names (e.g. "Encoding") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Encoding") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDataplexV1DataDiscoverySpecStorageConfigJsonOptions) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDataplexV1DataDiscoverySpecStorageConfigJsonOptions + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDataplexV1DataProfileResult: DataProfileResult defines the output // of DataProfileScan. Each field of the table will have field type specific // profile result. @@ -3253,6 +3465,10 @@ type GoogleCloudDataplexV1DataScan struct { CreateTime string `json:"createTime,omitempty"` // Data: Required. The data source for DataScan. Data *GoogleCloudDataplexV1DataSource `json:"data,omitempty"` + // DataDiscoveryResult: Output only. The result of a data discovery scan. + DataDiscoveryResult *GoogleCloudDataplexV1DataDiscoveryResult `json:"dataDiscoveryResult,omitempty"` + // DataDiscoverySpec: Settings for a data discovery scan. + DataDiscoverySpec *GoogleCloudDataplexV1DataDiscoverySpec `json:"dataDiscoverySpec,omitempty"` // DataProfileResult: Output only. The result of a data profile scan. DataProfileResult *GoogleCloudDataplexV1DataProfileResult `json:"dataProfileResult,omitempty"` // DataProfileSpec: Settings for a data profile scan. @@ -3294,6 +3510,7 @@ type GoogleCloudDataplexV1DataScan struct { // "DATA_SCAN_TYPE_UNSPECIFIED" - The data scan type is unspecified. // "DATA_QUALITY" - Data quality scan. // "DATA_PROFILE" - Data profile scan. + // "DATA_DISCOVERY" - Data discovery scan. Type string `json:"type,omitempty"` // Uid: Output only. System generated globally unique ID for the scan. This ID // will be different if the scan is deleted and re-created with the same name. @@ -3680,6 +3897,10 @@ func (s GoogleCloudDataplexV1DataScanExecutionStatus) MarshalJSON() ([]byte, err type GoogleCloudDataplexV1DataScanJob struct { // CreateTime: Output only. The time when the DataScanJob was created. CreateTime string `json:"createTime,omitempty"` + // DataDiscoveryResult: Output only. The result of a data discovery scan. + DataDiscoveryResult *GoogleCloudDataplexV1DataDiscoveryResult `json:"dataDiscoveryResult,omitempty"` + // DataDiscoverySpec: Output only. Settings for a data discovery scan. + DataDiscoverySpec *GoogleCloudDataplexV1DataDiscoverySpec `json:"dataDiscoverySpec,omitempty"` // DataProfileResult: Output only. The result of a data profile scan. DataProfileResult *GoogleCloudDataplexV1DataProfileResult `json:"dataProfileResult,omitempty"` // DataProfileSpec: Output only. Settings for a data profile scan. @@ -3717,6 +3938,7 @@ type GoogleCloudDataplexV1DataScanJob struct { // "DATA_SCAN_TYPE_UNSPECIFIED" - The data scan type is unspecified. // "DATA_QUALITY" - Data quality scan. // "DATA_PROFILE" - Data profile scan. + // "DATA_DISCOVERY" - Data discovery scan. Type string `json:"type,omitempty"` // Uid: Output only. System generated globally unique ID for the DataScanJob. Uid string `json:"uid,omitempty"` diff --git a/dataproc/v1/dataproc-api.json b/dataproc/v1/dataproc-api.json index 03af01be480..629383faccd 100644 --- a/dataproc/v1/dataproc-api.json +++ b/dataproc/v1/dataproc-api.json @@ -4978,7 +4978,7 @@ } } }, - "revision": "20240928", + "revision": "20241025", "rootUrl": "https://dataproc.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -9032,7 +9032,7 @@ "type": "object" }, "PySparkJob": { - "description": "A Dataproc job for running Apache PySpark (https://spark.apache.org/docs/0.9.0/python-programming-guide.html) applications on YARN.", + "description": "A Dataproc job for running Apache PySpark (https://spark.apache.org/docs/latest/api/python/index.html#pyspark-overview) applications on YARN.", "id": "PySparkJob", "properties": { "archiveUris": { @@ -10444,6 +10444,7 @@ "HBASE", "HIVE_WEBHCAT", "HUDI", + "ICEBERG", "JUPYTER", "PRESTO", "TRINO", @@ -10461,6 +10462,7 @@ "HBase. (beta)", "The Hive Web HCatalog (the REST service for accessing HCatalog).", "Hudi.", + "Iceberg.", "The Jupyter Notebook.", "The Presto query engine.", "The Trino query engine.", diff --git a/dataproc/v1/dataproc-gen.go b/dataproc/v1/dataproc-gen.go index 4df61dc2b2e..edf1b2abef7 100644 --- a/dataproc/v1/dataproc-gen.go +++ b/dataproc/v1/dataproc-gen.go @@ -5310,7 +5310,7 @@ func (s PySparkBatch) MarshalJSON() ([]byte, error) { } // PySparkJob: A Dataproc job for running Apache PySpark -// (https://spark.apache.org/docs/0.9.0/python-programming-guide.html) +// (https://spark.apache.org/docs/latest/api/python/index.html#pyspark-overview) // applications on YARN. type PySparkJob struct { // ArchiveUris: Optional. HCFS URIs of archives to be extracted into the @@ -6923,6 +6923,7 @@ type SoftwareConfig struct { // "HIVE_WEBHCAT" - The Hive Web HCatalog (the REST service for accessing // HCatalog). // "HUDI" - Hudi. + // "ICEBERG" - Iceberg. // "JUPYTER" - The Jupyter Notebook. // "PRESTO" - The Presto query engine. // "TRINO" - The Trino query engine. diff --git a/datastore/v1/datastore-api.json b/datastore/v1/datastore-api.json index b6500f27b2c..1312e1fb4fa 100644 --- a/datastore/v1/datastore-api.json +++ b/datastore/v1/datastore-api.json @@ -654,7 +654,7 @@ } } }, - "revision": "20241008", + "revision": "20241018", "rootUrl": "https://datastore.googleapis.com/", "schemas": { "Aggregation": { @@ -1064,6 +1064,51 @@ }, "type": "object" }, + "FindNearest": { + "description": "Nearest Neighbors search config. The ordering provided by FindNearest supersedes the order_by stage. If multiple documents have the same vector distance, the returned document order is not guaranteed to be stable between queries.", + "id": "FindNearest", + "properties": { + "distanceMeasure": { + "description": "Required. The Distance Measure to use, required.", + "enum": [ + "DISTANCE_MEASURE_UNSPECIFIED", + "EUCLIDEAN", + "COSINE", + "DOT_PRODUCT" + ], + "enumDescriptions": [ + "Should not be set.", + "Measures the EUCLIDEAN distance between the vectors. See [Euclidean](https://en.wikipedia.org/wiki/Euclidean_distance) to learn more. The resulting distance decreases the more similar two vectors are.", + "COSINE distance compares vectors based on the angle between them, which allows you to measure similarity that isn't based on the vectors magnitude. We recommend using DOT_PRODUCT with unit normalized vectors instead of COSINE distance, which is mathematically equivalent with better performance. See [Cosine Similarity](https://en.wikipedia.org/wiki/Cosine_similarity) to learn more about COSINE similarity and COSINE distance. The resulting COSINE distance decreases the more similar two vectors are.", + "Similar to cosine but is affected by the magnitude of the vectors. See [Dot Product](https://en.wikipedia.org/wiki/Dot_product) to learn more. The resulting distance increases the more similar two vectors are." + ], + "type": "string" + }, + "distanceResultProperty": { + "description": "Optional. Optional name of the field to output the result of the vector distance calculation. Must conform to entity property limitations.", + "type": "string" + }, + "distanceThreshold": { + "description": "Optional. Option to specify a threshold for which no less similar documents will be returned. The behavior of the specified `distance_measure` will affect the meaning of the distance threshold. Since DOT_PRODUCT distances increase when the vectors are more similar, the comparison is inverted. * For EUCLIDEAN, COSINE: WHERE distance \u003c= distance_threshold * For DOT_PRODUCT: WHERE distance \u003e= distance_threshold", + "format": "double", + "type": "number" + }, + "limit": { + "description": "Required. The number of nearest neighbors to return. Must be a positive integer of no more than 100.", + "format": "int32", + "type": "integer" + }, + "queryVector": { + "$ref": "Value", + "description": "Required. The query vector that we are searching on. Must be a vector of no more than 2048 dimensions." + }, + "vectorProperty": { + "$ref": "PropertyReference", + "description": "Required. An indexed vector property to search upon. Only documents which contain vectors whose dimensionality match the query_vector can be returned." + } + }, + "type": "object" + }, "GoogleDatastoreAdminV1CommonMetadata": { "description": "Metadata common to all Datastore Admin operations.", "id": "GoogleDatastoreAdminV1CommonMetadata", @@ -2228,7 +2273,7 @@ "type": "object" }, "Query": { - "description": "A query for entities.", + "description": "A query for entities. The query stages are executed in the following order: 1. kind 2. filter 3. projection 4. order + start_cursor + end_cursor 5. offset 6. limit 7. find_nearest", "id": "Query", "properties": { "distinctOn": { @@ -2247,6 +2292,10 @@ "$ref": "Filter", "description": "The filter to apply." }, + "findNearest": { + "$ref": "FindNearest", + "description": "Optional. A potential Nearest Neighbors Search. Applies after all other filters and ordering. Finds the closest vector embeddings to the given query vector." + }, "kind": { "description": "The kinds to query (if empty, returns entities of all kinds). Currently at most 1 kind may be specified.", "items": { diff --git a/datastore/v1/datastore-gen.go b/datastore/v1/datastore-gen.go index 395050bd3e7..4481d56be60 100644 --- a/datastore/v1/datastore-gen.go +++ b/datastore/v1/datastore-gen.go @@ -807,6 +807,84 @@ func (s Filter) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// FindNearest: Nearest Neighbors search config. The ordering provided by +// FindNearest supersedes the order_by stage. If multiple documents have the +// same vector distance, the returned document order is not guaranteed to be +// stable between queries. +type FindNearest struct { + // DistanceMeasure: Required. The Distance Measure to use, required. + // + // Possible values: + // "DISTANCE_MEASURE_UNSPECIFIED" - Should not be set. + // "EUCLIDEAN" - Measures the EUCLIDEAN distance between the vectors. See + // [Euclidean](https://en.wikipedia.org/wiki/Euclidean_distance) to learn more. + // The resulting distance decreases the more similar two vectors are. + // "COSINE" - COSINE distance compares vectors based on the angle between + // them, which allows you to measure similarity that isn't based on the vectors + // magnitude. We recommend using DOT_PRODUCT with unit normalized vectors + // instead of COSINE distance, which is mathematically equivalent with better + // performance. See [Cosine + // Similarity](https://en.wikipedia.org/wiki/Cosine_similarity) to learn more + // about COSINE similarity and COSINE distance. The resulting COSINE distance + // decreases the more similar two vectors are. + // "DOT_PRODUCT" - Similar to cosine but is affected by the magnitude of the + // vectors. See [Dot Product](https://en.wikipedia.org/wiki/Dot_product) to + // learn more. The resulting distance increases the more similar two vectors + // are. + DistanceMeasure string `json:"distanceMeasure,omitempty"` + // DistanceResultProperty: Optional. Optional name of the field to output the + // result of the vector distance calculation. Must conform to entity property + // limitations. + DistanceResultProperty string `json:"distanceResultProperty,omitempty"` + // DistanceThreshold: Optional. Option to specify a threshold for which no less + // similar documents will be returned. The behavior of the specified + // `distance_measure` will affect the meaning of the distance threshold. Since + // DOT_PRODUCT distances increase when the vectors are more similar, the + // comparison is inverted. * For EUCLIDEAN, COSINE: WHERE distance <= + // distance_threshold * For DOT_PRODUCT: WHERE distance >= distance_threshold + DistanceThreshold float64 `json:"distanceThreshold,omitempty"` + // Limit: Required. The number of nearest neighbors to return. Must be a + // positive integer of no more than 100. + Limit int64 `json:"limit,omitempty"` + // QueryVector: Required. The query vector that we are searching on. Must be a + // vector of no more than 2048 dimensions. + QueryVector *Value `json:"queryVector,omitempty"` + // VectorProperty: Required. An indexed vector property to search upon. Only + // documents which contain vectors whose dimensionality match the query_vector + // can be returned. + VectorProperty *PropertyReference `json:"vectorProperty,omitempty"` + // ForceSendFields is a list of field names (e.g. "DistanceMeasure") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "DistanceMeasure") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s FindNearest) MarshalJSON() ([]byte, error) { + type NoMethod FindNearest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *FindNearest) UnmarshalJSON(data []byte) error { + type NoMethod FindNearest + var s1 struct { + DistanceThreshold gensupport.JSONFloat64 `json:"distanceThreshold"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.DistanceThreshold = float64(s1.DistanceThreshold) + return nil +} + // GoogleDatastoreAdminV1CommonMetadata: Metadata common to all Datastore Admin // operations. type GoogleDatastoreAdminV1CommonMetadata struct { @@ -2395,7 +2473,9 @@ func (s PropertyTransform) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Query: A query for entities. +// Query: A query for entities. The query stages are executed in the following +// order: 1. kind 2. filter 3. projection 4. order + start_cursor + end_cursor +// 5. offset 6. limit 7. find_nearest type Query struct { // DistinctOn: The properties to make distinct. The query results will contain // the first result for each distinct combination of values for the given @@ -2409,6 +2489,10 @@ type Query struct { EndCursor string `json:"endCursor,omitempty"` // Filter: The filter to apply. Filter *Filter `json:"filter,omitempty"` + // FindNearest: Optional. A potential Nearest Neighbors Search. Applies after + // all other filters and ordering. Finds the closest vector embeddings to the + // given query vector. + FindNearest *FindNearest `json:"findNearest,omitempty"` // Kind: The kinds to query (if empty, returns entities of all kinds). // Currently at most 1 kind may be specified. Kind []*KindExpression `json:"kind,omitempty"` diff --git a/datastore/v1beta3/datastore-api.json b/datastore/v1beta3/datastore-api.json index f50b1329643..46f21e21e70 100644 --- a/datastore/v1beta3/datastore-api.json +++ b/datastore/v1beta3/datastore-api.json @@ -336,7 +336,7 @@ } } }, - "revision": "20241008", + "revision": "20241018", "rootUrl": "https://datastore.googleapis.com/", "schemas": { "Aggregation": { @@ -724,6 +724,51 @@ }, "type": "object" }, + "FindNearest": { + "description": "Nearest Neighbors search config. The ordering provided by FindNearest supersedes the order_by stage. If multiple documents have the same vector distance, the returned document order is not guaranteed to be stable between queries.", + "id": "FindNearest", + "properties": { + "distanceMeasure": { + "description": "Required. The Distance Measure to use, required.", + "enum": [ + "DISTANCE_MEASURE_UNSPECIFIED", + "EUCLIDEAN", + "COSINE", + "DOT_PRODUCT" + ], + "enumDescriptions": [ + "Should not be set.", + "Measures the EUCLIDEAN distance between the vectors. See [Euclidean](https://en.wikipedia.org/wiki/Euclidean_distance) to learn more. The resulting distance decreases the more similar two vectors are.", + "COSINE distance compares vectors based on the angle between them, which allows you to measure similarity that isn't based on the vectors magnitude. We recommend using DOT_PRODUCT with unit normalized vectors instead of COSINE distance, which is mathematically equivalent with better performance. See [Cosine Similarity](https://en.wikipedia.org/wiki/Cosine_similarity) to learn more about COSINE similarity and COSINE distance. The resulting COSINE distance decreases the more similar two vectors are.", + "Similar to cosine but is affected by the magnitude of the vectors. See [Dot Product](https://en.wikipedia.org/wiki/Dot_product) to learn more. The resulting distance increases the more similar two vectors are." + ], + "type": "string" + }, + "distanceResultProperty": { + "description": "Optional. Optional name of the field to output the result of the vector distance calculation. Must conform to entity property limitations.", + "type": "string" + }, + "distanceThreshold": { + "description": "Optional. Option to specify a threshold for which no less similar documents will be returned. The behavior of the specified `distance_measure` will affect the meaning of the distance threshold. Since DOT_PRODUCT distances increase when the vectors are more similar, the comparison is inverted. * For EUCLIDEAN, COSINE: WHERE distance \u003c= distance_threshold * For DOT_PRODUCT: WHERE distance \u003e= distance_threshold", + "format": "double", + "type": "number" + }, + "limit": { + "description": "Required. The number of nearest neighbors to return. Must be a positive integer of no more than 100.", + "format": "int32", + "type": "integer" + }, + "queryVector": { + "$ref": "Value", + "description": "Required. The query vector that we are searching on. Must be a vector of no more than 2048 dimensions." + }, + "vectorProperty": { + "$ref": "PropertyReference", + "description": "Required. An indexed vector property to search upon. Only documents which contain vectors whose dimensionality match the query_vector can be returned." + } + }, + "type": "object" + }, "GoogleDatastoreAdminV1CommonMetadata": { "description": "Metadata common to all Datastore Admin operations.", "id": "GoogleDatastoreAdminV1CommonMetadata", @@ -1674,7 +1719,7 @@ "type": "object" }, "Query": { - "description": "A query for entities.", + "description": "A query for entities. The query stages are executed in the following order: 1. kind 2. filter 3. projection 4. order + start_cursor + end_cursor 5. offset 6. limit 7. find_nearest", "id": "Query", "properties": { "distinctOn": { @@ -1693,6 +1738,10 @@ "$ref": "Filter", "description": "The filter to apply." }, + "findNearest": { + "$ref": "FindNearest", + "description": "Optional. A potential Nearest Neighbors Search. Applies after all other filters and ordering. Finds the closest vector embeddings to the given query vector." + }, "kind": { "description": "The kinds to query (if empty, returns entities of all kinds). Currently at most 1 kind may be specified.", "items": { diff --git a/datastore/v1beta3/datastore-gen.go b/datastore/v1beta3/datastore-gen.go index aa2aa4c50c5..5bd1a0f0917 100644 --- a/datastore/v1beta3/datastore-gen.go +++ b/datastore/v1beta3/datastore-gen.go @@ -758,6 +758,84 @@ func (s Filter) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// FindNearest: Nearest Neighbors search config. The ordering provided by +// FindNearest supersedes the order_by stage. If multiple documents have the +// same vector distance, the returned document order is not guaranteed to be +// stable between queries. +type FindNearest struct { + // DistanceMeasure: Required. The Distance Measure to use, required. + // + // Possible values: + // "DISTANCE_MEASURE_UNSPECIFIED" - Should not be set. + // "EUCLIDEAN" - Measures the EUCLIDEAN distance between the vectors. See + // [Euclidean](https://en.wikipedia.org/wiki/Euclidean_distance) to learn more. + // The resulting distance decreases the more similar two vectors are. + // "COSINE" - COSINE distance compares vectors based on the angle between + // them, which allows you to measure similarity that isn't based on the vectors + // magnitude. We recommend using DOT_PRODUCT with unit normalized vectors + // instead of COSINE distance, which is mathematically equivalent with better + // performance. See [Cosine + // Similarity](https://en.wikipedia.org/wiki/Cosine_similarity) to learn more + // about COSINE similarity and COSINE distance. The resulting COSINE distance + // decreases the more similar two vectors are. + // "DOT_PRODUCT" - Similar to cosine but is affected by the magnitude of the + // vectors. See [Dot Product](https://en.wikipedia.org/wiki/Dot_product) to + // learn more. The resulting distance increases the more similar two vectors + // are. + DistanceMeasure string `json:"distanceMeasure,omitempty"` + // DistanceResultProperty: Optional. Optional name of the field to output the + // result of the vector distance calculation. Must conform to entity property + // limitations. + DistanceResultProperty string `json:"distanceResultProperty,omitempty"` + // DistanceThreshold: Optional. Option to specify a threshold for which no less + // similar documents will be returned. The behavior of the specified + // `distance_measure` will affect the meaning of the distance threshold. Since + // DOT_PRODUCT distances increase when the vectors are more similar, the + // comparison is inverted. * For EUCLIDEAN, COSINE: WHERE distance <= + // distance_threshold * For DOT_PRODUCT: WHERE distance >= distance_threshold + DistanceThreshold float64 `json:"distanceThreshold,omitempty"` + // Limit: Required. The number of nearest neighbors to return. Must be a + // positive integer of no more than 100. + Limit int64 `json:"limit,omitempty"` + // QueryVector: Required. The query vector that we are searching on. Must be a + // vector of no more than 2048 dimensions. + QueryVector *Value `json:"queryVector,omitempty"` + // VectorProperty: Required. An indexed vector property to search upon. Only + // documents which contain vectors whose dimensionality match the query_vector + // can be returned. + VectorProperty *PropertyReference `json:"vectorProperty,omitempty"` + // ForceSendFields is a list of field names (e.g. "DistanceMeasure") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "DistanceMeasure") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s FindNearest) MarshalJSON() ([]byte, error) { + type NoMethod FindNearest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *FindNearest) UnmarshalJSON(data []byte) error { + type NoMethod FindNearest + var s1 struct { + DistanceThreshold gensupport.JSONFloat64 `json:"distanceThreshold"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.DistanceThreshold = float64(s1.DistanceThreshold) + return nil +} + // GoogleDatastoreAdminV1CommonMetadata: Metadata common to all Datastore Admin // operations. type GoogleDatastoreAdminV1CommonMetadata struct { @@ -2058,7 +2136,9 @@ func (s PropertyTransform) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Query: A query for entities. +// Query: A query for entities. The query stages are executed in the following +// order: 1. kind 2. filter 3. projection 4. order + start_cursor + end_cursor +// 5. offset 6. limit 7. find_nearest type Query struct { // DistinctOn: The properties to make distinct. The query results will contain // the first result for each distinct combination of values for the given @@ -2072,6 +2152,10 @@ type Query struct { EndCursor string `json:"endCursor,omitempty"` // Filter: The filter to apply. Filter *Filter `json:"filter,omitempty"` + // FindNearest: Optional. A potential Nearest Neighbors Search. Applies after + // all other filters and ordering. Finds the closest vector embeddings to the + // given query vector. + FindNearest *FindNearest `json:"findNearest,omitempty"` // Kind: The kinds to query (if empty, returns entities of all kinds). // Currently at most 1 kind may be specified. Kind []*KindExpression `json:"kind,omitempty"` diff --git a/dialogflow/v2/dialogflow-api.json b/dialogflow/v2/dialogflow-api.json index 49c096d5b80..a9a28c37d87 100644 --- a/dialogflow/v2/dialogflow-api.json +++ b/dialogflow/v2/dialogflow-api.json @@ -8714,7 +8714,7 @@ } } }, - "revision": "20241018", + "revision": "20241019", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AdvancedSettings": { @@ -15765,6 +15765,11 @@ "$ref": "GoogleCloudDialogflowV2HumanAgentAssistantConfigSuggestionQueryConfigContextFilterSettings", "description": "Determines how recent conversation context is filtered when generating suggestions. If unspecified, no messages will be dropped." }, + "contextSize": { + "description": "Optional. The number of recent messages to include in the context. Supported features: KNOWLEDGE_ASSIST.", + "format": "int32", + "type": "integer" + }, "dialogflowQuerySource": { "$ref": "GoogleCloudDialogflowV2HumanAgentAssistantConfigSuggestionQueryConfigDialogflowQuerySource", "description": "Query from Dialogflow agent. It is used by DIALOGFLOW_ASSIST." @@ -16246,6 +16251,13 @@ }, "type": "array" }, + "phraseSets": { + "description": "A collection of phrase set resources to use for speech adaptation.", + "items": { + "type": "string" + }, + "type": "array" + }, "sampleRateHertz": { "description": "Required. Sample rate (in Hertz) of the audio content sent in the query. Refer to [Cloud Speech API documentation](https://cloud.google.com/speech-to-text/docs/basics) for more details.", "format": "int32", @@ -17302,6 +17314,14 @@ "description": "Snippet Source for a Generative Prediction.", "id": "GoogleCloudDialogflowV2KnowledgeAssistAnswerKnowledgeAnswerGenerativeSourceSnippet", "properties": { + "metadata": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Metadata of the document.", + "type": "object" + }, "text": { "description": "Text taken from that URI.", "type": "string" @@ -18217,6 +18237,14 @@ "description": "The sources of the answers.", "id": "GoogleCloudDialogflowV2SearchKnowledgeAnswerAnswerSource", "properties": { + "metadata": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Metadata associated with the article.", + "type": "object" + }, "snippet": { "description": "The relevant snippet of the article.", "type": "string" @@ -18244,6 +18272,18 @@ "description": "Required. The conversation profile used to configure the search. Format: `projects//locations//conversationProfiles/`.", "type": "string" }, + "endUserMetadata": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Optional. Information about the end-user to improve the relevance and accuracy of generative answers. This will be interpreted and used by a language model, so, for good results, the data should be self-descriptive, and in a simple structure. Example: ```json { \"subscription plan\": \"Business Premium Plus\", \"devices owned\": [ {\"model\": \"Google Pixel 7\"}, {\"model\": \"Google Pixel Tablet\"} ] } ```", + "type": "object" + }, + "exactSearch": { + "description": "Optional. Whether to search the query exactly without query rewrite.", + "type": "boolean" + }, "latestMessage": { "description": "Optional. The name of the latest conversation message when the request is triggered. Format: `projects//locations//conversations//messages/`.", "type": "string" @@ -18256,6 +18296,24 @@ "$ref": "GoogleCloudDialogflowV2TextInput", "description": "Required. The natural language text query for knowledge search." }, + "querySource": { + "description": "Optional. The source of the query in the request.", + "enum": [ + "QUERY_SOURCE_UNSPECIFIED", + "AGENT_QUERY", + "SUGGESTED_QUERY" + ], + "enumDescriptions": [ + "Unknown query source.", + "The query is from agents.", + "The query is a suggested query from Participants.SuggestKnowledgeAssist." + ], + "type": "string" + }, + "searchConfig": { + "$ref": "GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfig", + "description": "Optional. Configuration specific to search queries with data stores." + }, "sessionId": { "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" @@ -18263,6 +18321,160 @@ }, "type": "object" }, + "GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfig": { + "description": "Configuration specific to search queries with data stores.", + "id": "GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfig", + "properties": { + "boostSpecs": { + "description": "Optional. Boost specifications for data stores.", + "items": { + "$ref": "GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecs" + }, + "type": "array" + }, + "filterSpecs": { + "description": "Optional. Filter specification for data store queries.", + "items": { + "$ref": "GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigFilterSpecs" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecs": { + "description": "Boost specifications for data stores.", + "id": "GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecs", + "properties": { + "dataStores": { + "description": "Optional. Data Stores where the boosting configuration is applied. The full names of the referenced data stores. Formats: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}` `projects/{project}/locations/{location}/dataStores/{data_store}", + "items": { + "type": "string" + }, + "type": "array" + }, + "spec": { + "description": "Optional. A list of boosting specifications.", + "items": { + "$ref": "GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpec" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpec": { + "description": "Boost specification to boost certain documents. A copy of google.cloud.discoveryengine.v1main.BoostSpec, field documentation is available at https://cloud.google.com/generative-ai-app-builder/docs/reference/rest/v1alpha/BoostSpec", + "id": "GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpec", + "properties": { + "conditionBoostSpecs": { + "description": "Optional. Condition boost specifications. If a document matches multiple conditions in the specifictions, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.", + "items": { + "$ref": "GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpec" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpec": { + "description": "Boost applies to documents which match a condition.", + "id": "GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpec", + "properties": { + "boost": { + "description": "Optional. Strength of the condition boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0. Setting to 1.0 gives the document a big promotion. However, it does not necessarily mean that the boosted document will be the top result at all times, nor that other documents will be excluded. Results could still be shown even when none of them matches the condition. And results that are significantly more relevant to the search query can still trump your heavily favored but irrelevant documents. Setting to -1.0 gives the document a big demotion. However, results that are deeply relevant might still be shown. The document will have an upstream battle to get a fairly high ranking, but it is not blocked out completely. Setting to 0.0 means no boost applied. The boosting condition is ignored.", + "format": "float", + "type": "number" + }, + "boostControlSpec": { + "$ref": "GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpecBoostControlSpec", + "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" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpecBoostControlSpec": { + "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": "GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpecBoostControlSpec", + "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": "GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpecBoostControlSpecControlPoint" + }, + "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" + }, + "GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpecBoostControlSpecControlPoint": { + "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": "GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpecBoostControlSpecControlPoint", + "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" + }, + "GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigFilterSpecs": { + "description": "Filter specification for data store queries.", + "id": "GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigFilterSpecs", + "properties": { + "dataStores": { + "description": "Optional. The data store where the filter configuration is applied. Full resource name of data store, such as projects/{project}/locations/{location}/collections/{collectionId}/ dataStores/{dataStoreId}.", + "items": { + "type": "string" + }, + "type": "array" + }, + "filter": { + "description": "Optional. The filter expression to be applied. Expression syntax is documented at https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata#filter-expression-syntax", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDialogflowV2SearchKnowledgeResponse": { "description": "The response message for Conversations.SearchKnowledge.", "id": "GoogleCloudDialogflowV2SearchKnowledgeResponse", @@ -18574,6 +18786,13 @@ "description": "Which Speech model to select. Select the model best suited to your domain to get best results. If a model is not explicitly specified, then Dialogflow auto-selects a model based on other parameters in the SpeechToTextConfig and Agent settings. If enhanced speech model is enabled for the agent and an enhanced version of the specified model for the language does not exist, then the speech is recognized using the standard version of the specified model. Refer to [Cloud Speech API documentation](https://cloud.google.com/speech-to-text/docs/basics#select-model) for more details. If you specify a model, the following models typically have the best performance: - phone_call (best for Agent Assist and telephony) - latest_short (best for Dialogflow non-telephony) - command_and_search Leave this field unspecified to use [Agent Speech settings](https://cloud.google.com/dialogflow/cx/docs/concept/agent#settings-speech) for model selection.", "type": "string" }, + "phraseSets": { + "description": "List of names of Cloud Speech phrase sets that are used for transcription.", + "items": { + "type": "string" + }, + "type": "array" + }, "sampleRateHertz": { "description": "Sample rate (in Hertz) of the audio content sent in the query. Refer to [Cloud Speech API documentation](https://cloud.google.com/speech-to-text/docs/basics) for more details.", "format": "int32", @@ -21141,6 +21360,14 @@ "description": "Snippet Source for a Generative Prediction.", "id": "GoogleCloudDialogflowV2beta1KnowledgeAssistAnswerKnowledgeAnswerGenerativeSourceSnippet", "properties": { + "metadata": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Metadata of the document.", + "type": "object" + }, "text": { "description": "Text taken from that URI.", "type": "string" diff --git a/dialogflow/v2/dialogflow-gen.go b/dialogflow/v2/dialogflow-gen.go index 5914b16adc4..ab4fa8546c6 100644 --- a/dialogflow/v2/dialogflow-gen.go +++ b/dialogflow/v2/dialogflow-gen.go @@ -10839,6 +10839,9 @@ type GoogleCloudDialogflowV2HumanAgentAssistantConfigSuggestionQueryConfig struc // filtered when generating suggestions. If unspecified, no messages will be // dropped. ContextFilterSettings *GoogleCloudDialogflowV2HumanAgentAssistantConfigSuggestionQueryConfigContextFilterSettings `json:"contextFilterSettings,omitempty"` + // ContextSize: Optional. The number of recent messages to include in the + // context. Supported features: KNOWLEDGE_ASSIST. + ContextSize int64 `json:"contextSize,omitempty"` // DialogflowQuerySource: Query from Dialogflow agent. It is used by // DIALOGFLOW_ASSIST. DialogflowQuerySource *GoogleCloudDialogflowV2HumanAgentAssistantConfigSuggestionQueryConfigDialogflowQuerySource `json:"dialogflowQuerySource,omitempty"` @@ -11627,6 +11630,9 @@ type GoogleCloudDialogflowV2InputAudioConfig struct { // If you specify both `phrase_hints` () and `speech_contexts` (), Dialogflow // will treat the `phrase_hints` () as a single additional `SpeechContext` (). PhraseHints []string `json:"phraseHints,omitempty"` + // PhraseSets: A collection of phrase set resources to use for speech + // adaptation. + PhraseSets []string `json:"phraseSets,omitempty"` // SampleRateHertz: Required. Sample rate (in Hertz) of the audio content sent // in the query. Refer to Cloud Speech API documentation // (https://cloud.google.com/speech-to-text/docs/basics) for more details. @@ -12985,21 +12991,23 @@ func (s GoogleCloudDialogflowV2KnowledgeAssistAnswerKnowledgeAnswerGenerativeSou // GoogleCloudDialogflowV2KnowledgeAssistAnswerKnowledgeAnswerGenerativeSourceSn // ippet: Snippet Source for a Generative Prediction. type GoogleCloudDialogflowV2KnowledgeAssistAnswerKnowledgeAnswerGenerativeSourceSnippet struct { + // Metadata: Metadata of the document. + Metadata googleapi.RawMessage `json:"metadata,omitempty"` // Text: Text taken from that URI. Text string `json:"text,omitempty"` // Title: Title of the document. Title string `json:"title,omitempty"` // Uri: URI the data is sourced from. Uri string `json:"uri,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 + // ForceSendFields is a list of field names (e.g. "Metadata") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See // https://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 + // NullFields is a list of field names (e.g. "Metadata") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -14312,19 +14320,21 @@ func (s GoogleCloudDialogflowV2SearchKnowledgeAnswer) MarshalJSON() ([]byte, err // GoogleCloudDialogflowV2SearchKnowledgeAnswerAnswerSource: The sources of the // answers. type GoogleCloudDialogflowV2SearchKnowledgeAnswerAnswerSource struct { + // Metadata: Metadata associated with the article. + Metadata googleapi.RawMessage `json:"metadata,omitempty"` // Snippet: The relevant snippet of the article. Snippet string `json:"snippet,omitempty"` // Title: The title of the article. Title string `json:"title,omitempty"` // Uri: The URI of the article. Uri string `json:"uri,omitempty"` - // ForceSendFields is a list of field names (e.g. "Snippet") 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. "Metadata") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Snippet") to include in API + // NullFields is a list of field names (e.g. "Metadata") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. @@ -14346,6 +14356,16 @@ type GoogleCloudDialogflowV2SearchKnowledgeRequest struct { // ConversationProfile: Required. The conversation profile used to configure // the search. Format: `projects//locations//conversationProfiles/`. ConversationProfile string `json:"conversationProfile,omitempty"` + // EndUserMetadata: Optional. Information about the end-user to improve the + // relevance and accuracy of generative answers. This will be interpreted and + // used by a language model, so, for good results, the data should be + // self-descriptive, and in a simple structure. Example: ```json { + // "subscription plan": "Business Premium Plus", "devices owned": [ {"model": + // "Google Pixel 7"}, {"model": "Google Pixel Tablet"} ] } ``` + EndUserMetadata googleapi.RawMessage `json:"endUserMetadata,omitempty"` + // ExactSearch: Optional. Whether to search the query exactly without query + // rewrite. + ExactSearch bool `json:"exactSearch,omitempty"` // LatestMessage: Optional. The name of the latest conversation message when // the request is triggered. Format: // `projects//locations//conversations//messages/`. @@ -14355,6 +14375,17 @@ type GoogleCloudDialogflowV2SearchKnowledgeRequest struct { Parent string `json:"parent,omitempty"` // Query: Required. The natural language text query for knowledge search. Query *GoogleCloudDialogflowV2TextInput `json:"query,omitempty"` + // QuerySource: Optional. The source of the query in the request. + // + // Possible values: + // "QUERY_SOURCE_UNSPECIFIED" - Unknown query source. + // "AGENT_QUERY" - The query is from agents. + // "SUGGESTED_QUERY" - The query is a suggested query from + // Participants.SuggestKnowledgeAssist. + QuerySource string `json:"querySource,omitempty"` + // SearchConfig: Optional. Configuration specific to search queries with data + // stores. + SearchConfig *GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfig `json:"searchConfig,omitempty"` // 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 @@ -14381,6 +14412,278 @@ func (s GoogleCloudDialogflowV2SearchKnowledgeRequest) MarshalJSON() ([]byte, er return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfig: Configuration +// specific to search queries with data stores. +type GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfig struct { + // BoostSpecs: Optional. Boost specifications for data stores. + BoostSpecs []*GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecs `json:"boostSpecs,omitempty"` + // FilterSpecs: Optional. Filter specification for data store queries. + FilterSpecs []*GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigFilterSpecs `json:"filterSpecs,omitempty"` + // ForceSendFields is a list of field names (e.g. "BoostSpecs") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BoostSpecs") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecs: Boost +// specifications for data stores. +type GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecs struct { + // DataStores: Optional. Data Stores where the boosting configuration is + // applied. The full names of the referenced data stores. Formats: + // `projects/{project}/locations/{location}/collections/{collection}/dataStores/ + // {data_store}` + // `projects/{project}/locations/{location}/dataStores/{data_store} + DataStores []string `json:"dataStores,omitempty"` + // Spec: Optional. A list of boosting specifications. + Spec []*GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpec `json:"spec,omitempty"` + // ForceSendFields is a list of field names (e.g. "DataStores") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "DataStores") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecs) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecs + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpec: +// +// Boost specification to boost certain documents. A copy of +// +// google.cloud.discoveryengine.v1main.BoostSpec, field documentation is +// available at +// https://cloud.google.com/generative-ai-app-builder/docs/reference/rest/v1alpha/BoostSpec +type GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpec struct { + // ConditionBoostSpecs: Optional. Condition boost specifications. If a document + // matches multiple conditions in the specifictions, boost scores from these + // specifications are all applied and combined in a non-linear way. Maximum + // number of specifications is 20. + ConditionBoostSpecs []*GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpec `json:"conditionBoostSpecs,omitempty"` + // ForceSendFields is a list of field names (e.g. "ConditionBoostSpecs") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ConditionBoostSpecs") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecC +// onditionBoostSpec: Boost applies to documents which match a condition. +type GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpec struct { + // Boost: Optional. Strength of the condition boost, which should be in [-1, + // 1]. Negative boost means demotion. Default is 0.0. Setting to 1.0 gives the + // document a big promotion. However, it does not necessarily mean that the + // boosted document will be the top result at all times, nor that other + // documents will be excluded. Results could still be shown even when none of + // them matches the condition. And results that are significantly more relevant + // to the search query can still trump your heavily favored but irrelevant + // documents. Setting to -1.0 gives the document a big demotion. However, + // results that are deeply relevant might still be shown. The document will + // have an upstream battle to get a fairly high ranking, but it is not blocked + // 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 *GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpecBoostControlSpec `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 + // "Blue": * (id: ANY("doc_1", "doc_2")) AND (color: ANY("Red","Blue")) + Condition string `json:"condition,omitempty"` + // ForceSendFields is a list of field names (e.g. "Boost") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Boost") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpec) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpec + var s1 struct { + Boost gensupport.JSONFloat64 `json:"boost"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Boost = float64(s1.Boost) + return nil +} + +// GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecC +// onditionBoostSpecBoostControlSpec: 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 GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpecBoostControlSpec 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 []*GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpecBoostControlSpecControlPoint `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 GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpecBoostControlSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpecBoostControlSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecC +// onditionBoostSpecBoostControlSpecControlPoint: 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 GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpecBoostControlSpecControlPoint 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 GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpecBoostControlSpecControlPoint) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpecBoostControlSpecControlPoint + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpecBoostControlSpecControlPoint) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpecBoostControlSpecControlPoint + 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 +} + +// GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigFilterSpecs: Filter +// specification for data store queries. +type GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigFilterSpecs struct { + // DataStores: Optional. The data store where the filter configuration is + // applied. Full resource name of data store, such as + // projects/{project}/locations/{location}/collections/{collectionId}/ + // dataStores/{dataStoreId}. + DataStores []string `json:"dataStores,omitempty"` + // Filter: Optional. The filter expression to be applied. Expression syntax is + // documented at + // https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata#filter-expression-syntax + Filter string `json:"filter,omitempty"` + // ForceSendFields is a list of field names (e.g. "DataStores") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "DataStores") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigFilterSpecs) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2SearchKnowledgeRequestSearchConfigFilterSpecs + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDialogflowV2SearchKnowledgeResponse: The response message for // Conversations.SearchKnowledge. type GoogleCloudDialogflowV2SearchKnowledgeResponse struct { @@ -14929,6 +15232,9 @@ type GoogleCloudDialogflowV2SpeechToTextConfig struct { // (https://cloud.google.com/dialogflow/cx/docs/concept/agent#settings-speech) // for model selection. Model string `json:"model,omitempty"` + // PhraseSets: List of names of Cloud Speech phrase sets that are used for + // transcription. + PhraseSets []string `json:"phraseSets,omitempty"` // SampleRateHertz: Sample rate (in Hertz) of the audio content sent in the // query. Refer to Cloud Speech API documentation // (https://cloud.google.com/speech-to-text/docs/basics) for more details. @@ -18532,21 +18838,23 @@ func (s GoogleCloudDialogflowV2beta1KnowledgeAssistAnswerKnowledgeAnswerGenerati // GoogleCloudDialogflowV2beta1KnowledgeAssistAnswerKnowledgeAnswerGenerativeSou // rceSnippet: Snippet Source for a Generative Prediction. type GoogleCloudDialogflowV2beta1KnowledgeAssistAnswerKnowledgeAnswerGenerativeSourceSnippet struct { + // Metadata: Metadata of the document. + Metadata googleapi.RawMessage `json:"metadata,omitempty"` // Text: Text taken from that URI. Text string `json:"text,omitempty"` // Title: Title of the document. Title string `json:"title,omitempty"` // Uri: URI the data is sourced from. Uri string `json:"uri,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 + // ForceSendFields is a list of field names (e.g. "Metadata") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See // https://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 + // NullFields is a list of field names (e.g. "Metadata") to include in API + // requests with the JSON null value. By default, fields with 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/dialogflow/v2beta1/dialogflow-api.json b/dialogflow/v2beta1/dialogflow-api.json index dfa13c901b6..fdd85c0877b 100644 --- a/dialogflow/v2beta1/dialogflow-api.json +++ b/dialogflow/v2beta1/dialogflow-api.json @@ -8082,7 +8082,7 @@ } } }, - "revision": "20241018", + "revision": "20241019", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AdvancedSettings": { @@ -14451,6 +14451,14 @@ "description": "Snippet Source for a Generative Prediction.", "id": "GoogleCloudDialogflowV2KnowledgeAssistAnswerKnowledgeAnswerGenerativeSourceSnippet", "properties": { + "metadata": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Metadata of the document.", + "type": "object" + }, "text": { "description": "Text taken from that URI.", "type": "string" @@ -17230,6 +17238,11 @@ "$ref": "GoogleCloudDialogflowV2beta1HumanAgentAssistantConfigSuggestionQueryConfigContextFilterSettings", "description": "Determines how recent conversation context is filtered when generating suggestions. If unspecified, no messages will be dropped." }, + "contextSize": { + "description": "Optional. The number of recent messages to include in the context. Supported features: KNOWLEDGE_ASSIST.", + "format": "int32", + "type": "integer" + }, "dialogflowQuerySource": { "$ref": "GoogleCloudDialogflowV2beta1HumanAgentAssistantConfigSuggestionQueryConfigDialogflowQuerySource", "description": "Query from Dialogflow agent. It is used by DIALOGFLOW_ASSIST, ENTITY_EXTRACTION." @@ -17672,6 +17685,13 @@ }, "type": "array" }, + "phraseSets": { + "description": "A collection of phrase set resources to use for speech adaptation.", + "items": { + "type": "string" + }, + "type": "array" + }, "sampleRateHertz": { "description": "Required. Sample rate (in Hertz) of the audio content sent in the query. Refer to [Cloud Speech API documentation](https://cloud.google.com/speech-to-text/docs/basics) for more details.", "format": "int32", @@ -19072,6 +19092,14 @@ "description": "Snippet Source for a Generative Prediction.", "id": "GoogleCloudDialogflowV2beta1KnowledgeAssistAnswerKnowledgeAnswerGenerativeSourceSnippet", "properties": { + "metadata": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Metadata of the document.", + "type": "object" + }, "text": { "description": "Text taken from that URI.", "type": "string" @@ -20092,6 +20120,14 @@ "description": "The sources of the answers.", "id": "GoogleCloudDialogflowV2beta1SearchKnowledgeAnswerAnswerSource", "properties": { + "metadata": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Metadata associated with the article.", + "type": "object" + }, "snippet": { "description": "The relevant snippet of the article.", "type": "string" @@ -20119,6 +20155,18 @@ "description": "Required. The conversation profile used to configure the search. Format: `projects//locations//conversationProfiles/`.", "type": "string" }, + "endUserMetadata": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Optional. Information about the end-user to improve the relevance and accuracy of generative answers. This will be interpreted and used by a language model, so, for good results, the data should be self-descriptive, and in a simple structure. Example: ```json { \"subscription plan\": \"Business Premium Plus\", \"devices owned\": [ {\"model\": \"Google Pixel 7\"}, {\"model\": \"Google Pixel Tablet\"} ] } ```", + "type": "object" + }, + "exactSearch": { + "description": "Optional. Whether to search the query exactly without query rewrite.", + "type": "boolean" + }, "latestMessage": { "description": "Optional. The name of the latest conversation message when the request is triggered. Format: `projects//locations//conversations//messages/`.", "type": "string" @@ -20131,6 +20179,24 @@ "$ref": "GoogleCloudDialogflowV2beta1TextInput", "description": "Required. The natural language text query for knowledge search." }, + "querySource": { + "description": "Optional. The source of the query in the request.", + "enum": [ + "QUERY_SOURCE_UNSPECIFIED", + "AGENT_QUERY", + "SUGGESTED_QUERY" + ], + "enumDescriptions": [ + "Unknown query source.", + "The query is from agents.", + "The query is a suggested query from Participants.SuggestKnowledgeAssist." + ], + "type": "string" + }, + "searchConfig": { + "$ref": "GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfig", + "description": "Optional. Configuration specific to search queries with data stores." + }, "sessionId": { "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" @@ -20138,6 +20204,160 @@ }, "type": "object" }, + "GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfig": { + "description": "Configuration specific to search queries with data stores.", + "id": "GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfig", + "properties": { + "boostSpecs": { + "description": "Optional. Boost specifications for data stores.", + "items": { + "$ref": "GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecs" + }, + "type": "array" + }, + "filterSpecs": { + "description": "Optional. Filter specification for data store queries.", + "items": { + "$ref": "GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigFilterSpecs" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecs": { + "description": "Boost specifications for data stores.", + "id": "GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecs", + "properties": { + "dataStores": { + "description": "Optional. Data Stores where the boosting configuration is applied. The full names of the referenced data stores. Formats: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}` `projects/{project}/locations/{location}/dataStores/{data_store}", + "items": { + "type": "string" + }, + "type": "array" + }, + "spec": { + "description": "Optional. A list of boosting specifications.", + "items": { + "$ref": "GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpec" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpec": { + "description": "Boost specification to boost certain documents. A copy of google.cloud.discoveryengine.v1main.BoostSpec, field documentation is available at https://cloud.google.com/generative-ai-app-builder/docs/reference/rest/v1alpha/BoostSpec", + "id": "GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpec", + "properties": { + "conditionBoostSpecs": { + "description": "Optional. Condition boost specifications. If a document matches multiple conditions in the specifictions, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.", + "items": { + "$ref": "GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpec" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpec": { + "description": "Boost applies to documents which match a condition.", + "id": "GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpec", + "properties": { + "boost": { + "description": "Optional. Strength of the condition boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0. Setting to 1.0 gives the document a big promotion. However, it does not necessarily mean that the boosted document will be the top result at all times, nor that other documents will be excluded. Results could still be shown even when none of them matches the condition. And results that are significantly more relevant to the search query can still trump your heavily favored but irrelevant documents. Setting to -1.0 gives the document a big demotion. However, results that are deeply relevant might still be shown. The document will have an upstream battle to get a fairly high ranking, but it is not blocked out completely. Setting to 0.0 means no boost applied. The boosting condition is ignored.", + "format": "float", + "type": "number" + }, + "boostControlSpec": { + "$ref": "GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpecBoostControlSpec", + "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" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpecBoostControlSpec": { + "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": "GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpecBoostControlSpec", + "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": "GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpecBoostControlSpecControlPoint" + }, + "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" + }, + "GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpecBoostControlSpecControlPoint": { + "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": "GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpecBoostControlSpecControlPoint", + "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" + }, + "GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigFilterSpecs": { + "description": "Filter specification for data store queries.", + "id": "GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigFilterSpecs", + "properties": { + "dataStores": { + "description": "Optional. The data store where the filter configuration is applied. Full resource name of data store, such as projects/{project}/locations/{location}/collections/{collectionId}/ dataStores/{dataStoreId}.", + "items": { + "type": "string" + }, + "type": "array" + }, + "filter": { + "description": "Optional. The filter expression to be applied. Expression syntax is documented at https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata#filter-expression-syntax", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDialogflowV2beta1SearchKnowledgeResponse": { "description": "The response message for Conversations.SearchKnowledge.", "id": "GoogleCloudDialogflowV2beta1SearchKnowledgeResponse", @@ -20391,6 +20611,13 @@ "description": "Which Speech model to select. Select the model best suited to your domain to get best results. If a model is not explicitly specified, then Dialogflow auto-selects a model based on other parameters in the SpeechToTextConfig and Agent settings. If enhanced speech model is enabled for the agent and an enhanced version of the specified model for the language does not exist, then the speech is recognized using the standard version of the specified model. Refer to [Cloud Speech API documentation](https://cloud.google.com/speech-to-text/docs/basics#select-model) for more details. If you specify a model, the following models typically have the best performance: - phone_call (best for Agent Assist and telephony) - latest_short (best for Dialogflow non-telephony) - command_and_search Leave this field unspecified to use [Agent Speech settings](https://cloud.google.com/dialogflow/cx/docs/concept/agent#settings-speech) for model selection.", "type": "string" }, + "phraseSets": { + "description": "List of names of Cloud Speech phrase sets that are used for transcription.", + "items": { + "type": "string" + }, + "type": "array" + }, "sampleRateHertz": { "description": "Sample rate (in Hertz) of the audio content sent in the query. Refer to [Cloud Speech API documentation](https://cloud.google.com/speech-to-text/docs/basics) for more details.", "format": "int32", diff --git a/dialogflow/v2beta1/dialogflow-gen.go b/dialogflow/v2beta1/dialogflow-gen.go index c7ad6f31271..4b2338543c8 100644 --- a/dialogflow/v2beta1/dialogflow-gen.go +++ b/dialogflow/v2beta1/dialogflow-gen.go @@ -9747,21 +9747,23 @@ func (s GoogleCloudDialogflowV2KnowledgeAssistAnswerKnowledgeAnswerGenerativeSou // GoogleCloudDialogflowV2KnowledgeAssistAnswerKnowledgeAnswerGenerativeSourceSn // ippet: Snippet Source for a Generative Prediction. type GoogleCloudDialogflowV2KnowledgeAssistAnswerKnowledgeAnswerGenerativeSourceSnippet struct { + // Metadata: Metadata of the document. + Metadata googleapi.RawMessage `json:"metadata,omitempty"` // Text: Text taken from that URI. Text string `json:"text,omitempty"` // Title: Title of the document. Title string `json:"title,omitempty"` // Uri: URI the data is sourced from. Uri string `json:"uri,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 + // ForceSendFields is a list of field names (e.g. "Metadata") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See // https://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 + // NullFields is a list of field names (e.g. "Metadata") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -13657,6 +13659,9 @@ type GoogleCloudDialogflowV2beta1HumanAgentAssistantConfigSuggestionQueryConfig // filtered when generating suggestions. If unspecified, no messages will be // dropped. ContextFilterSettings *GoogleCloudDialogflowV2beta1HumanAgentAssistantConfigSuggestionQueryConfigContextFilterSettings `json:"contextFilterSettings,omitempty"` + // ContextSize: Optional. The number of recent messages to include in the + // context. Supported features: KNOWLEDGE_ASSIST. + ContextSize int64 `json:"contextSize,omitempty"` // DialogflowQuerySource: Query from Dialogflow agent. It is used by // DIALOGFLOW_ASSIST, ENTITY_EXTRACTION. DialogflowQuerySource *GoogleCloudDialogflowV2beta1HumanAgentAssistantConfigSuggestionQueryConfigDialogflowQuerySource `json:"dialogflowQuerySource,omitempty"` @@ -14377,6 +14382,9 @@ type GoogleCloudDialogflowV2beta1InputAudioConfig struct { // If you specify both `phrase_hints` () and `speech_contexts` (), Dialogflow // will treat the `phrase_hints` () as a single additional `SpeechContext` (). PhraseHints []string `json:"phraseHints,omitempty"` + // PhraseSets: A collection of phrase set resources to use for speech + // adaptation. + PhraseSets []string `json:"phraseSets,omitempty"` // SampleRateHertz: Required. Sample rate (in Hertz) of the audio content sent // in the query. Refer to Cloud Speech API documentation // (https://cloud.google.com/speech-to-text/docs/basics) for more details. @@ -16246,21 +16254,23 @@ func (s GoogleCloudDialogflowV2beta1KnowledgeAssistAnswerKnowledgeAnswerGenerati // GoogleCloudDialogflowV2beta1KnowledgeAssistAnswerKnowledgeAnswerGenerativeSou // rceSnippet: Snippet Source for a Generative Prediction. type GoogleCloudDialogflowV2beta1KnowledgeAssistAnswerKnowledgeAnswerGenerativeSourceSnippet struct { + // Metadata: Metadata of the document. + Metadata googleapi.RawMessage `json:"metadata,omitempty"` // Text: Text taken from that URI. Text string `json:"text,omitempty"` // Title: Title of the document. Title string `json:"title,omitempty"` // Uri: URI the data is sourced from. Uri string `json:"uri,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 + // ForceSendFields is a list of field names (e.g. "Metadata") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See // https://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 + // NullFields is a list of field names (e.g. "Metadata") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -17705,19 +17715,21 @@ func (s GoogleCloudDialogflowV2beta1SearchKnowledgeAnswer) MarshalJSON() ([]byte // GoogleCloudDialogflowV2beta1SearchKnowledgeAnswerAnswerSource: The sources // of the answers. type GoogleCloudDialogflowV2beta1SearchKnowledgeAnswerAnswerSource struct { + // Metadata: Metadata associated with the article. + Metadata googleapi.RawMessage `json:"metadata,omitempty"` // Snippet: The relevant snippet of the article. Snippet string `json:"snippet,omitempty"` // Title: The title of the article. Title string `json:"title,omitempty"` // Uri: The URI of the article. Uri string `json:"uri,omitempty"` - // ForceSendFields is a list of field names (e.g. "Snippet") 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. "Metadata") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Snippet") to include in API + // NullFields is a list of field names (e.g. "Metadata") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. @@ -17739,6 +17751,16 @@ type GoogleCloudDialogflowV2beta1SearchKnowledgeRequest struct { // ConversationProfile: Required. The conversation profile used to configure // the search. Format: `projects//locations//conversationProfiles/`. ConversationProfile string `json:"conversationProfile,omitempty"` + // EndUserMetadata: Optional. Information about the end-user to improve the + // relevance and accuracy of generative answers. This will be interpreted and + // used by a language model, so, for good results, the data should be + // self-descriptive, and in a simple structure. Example: ```json { + // "subscription plan": "Business Premium Plus", "devices owned": [ {"model": + // "Google Pixel 7"}, {"model": "Google Pixel Tablet"} ] } ``` + EndUserMetadata googleapi.RawMessage `json:"endUserMetadata,omitempty"` + // ExactSearch: Optional. Whether to search the query exactly without query + // rewrite. + ExactSearch bool `json:"exactSearch,omitempty"` // LatestMessage: Optional. The name of the latest conversation message when // the request is triggered. Format: // `projects//locations//conversations//messages/`. @@ -17748,6 +17770,17 @@ type GoogleCloudDialogflowV2beta1SearchKnowledgeRequest struct { Parent string `json:"parent,omitempty"` // Query: Required. The natural language text query for knowledge search. Query *GoogleCloudDialogflowV2beta1TextInput `json:"query,omitempty"` + // QuerySource: Optional. The source of the query in the request. + // + // Possible values: + // "QUERY_SOURCE_UNSPECIFIED" - Unknown query source. + // "AGENT_QUERY" - The query is from agents. + // "SUGGESTED_QUERY" - The query is a suggested query from + // Participants.SuggestKnowledgeAssist. + QuerySource string `json:"querySource,omitempty"` + // SearchConfig: Optional. Configuration specific to search queries with data + // stores. + SearchConfig *GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfig `json:"searchConfig,omitempty"` // 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 @@ -17774,6 +17807,276 @@ func (s GoogleCloudDialogflowV2beta1SearchKnowledgeRequest) MarshalJSON() ([]byt return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfig: +// Configuration specific to search queries with data stores. +type GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfig struct { + // BoostSpecs: Optional. Boost specifications for data stores. + BoostSpecs []*GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecs `json:"boostSpecs,omitempty"` + // FilterSpecs: Optional. Filter specification for data store queries. + FilterSpecs []*GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigFilterSpecs `json:"filterSpecs,omitempty"` + // ForceSendFields is a list of field names (e.g. "BoostSpecs") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BoostSpecs") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecs: +// Boost specifications for data stores. +type GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecs struct { + // DataStores: Optional. Data Stores where the boosting configuration is + // applied. The full names of the referenced data stores. Formats: + // `projects/{project}/locations/{location}/collections/{collection}/dataStores/ + // {data_store}` + // `projects/{project}/locations/{location}/dataStores/{data_store} + DataStores []string `json:"dataStores,omitempty"` + // Spec: Optional. A list of boosting specifications. + Spec []*GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpec `json:"spec,omitempty"` + // ForceSendFields is a list of field names (e.g. "DataStores") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "DataStores") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecs) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecs + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoost +// Spec: Boost specification to boost certain documents. A copy of +// google.cloud.discoveryengine.v1main.BoostSpec, field documentation is +// available at +// https://cloud.google.com/generative-ai-app-builder/docs/reference/rest/v1alpha/BoostSpec +type GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpec struct { + // ConditionBoostSpecs: Optional. Condition boost specifications. If a document + // matches multiple conditions in the specifictions, boost scores from these + // specifications are all applied and combined in a non-linear way. Maximum + // number of specifications is 20. + ConditionBoostSpecs []*GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpec `json:"conditionBoostSpecs,omitempty"` + // ForceSendFields is a list of field names (e.g. "ConditionBoostSpecs") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ConditionBoostSpecs") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoost +// SpecConditionBoostSpec: Boost applies to documents which match a condition. +type GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpec struct { + // Boost: Optional. Strength of the condition boost, which should be in [-1, + // 1]. Negative boost means demotion. Default is 0.0. Setting to 1.0 gives the + // document a big promotion. However, it does not necessarily mean that the + // boosted document will be the top result at all times, nor that other + // documents will be excluded. Results could still be shown even when none of + // them matches the condition. And results that are significantly more relevant + // to the search query can still trump your heavily favored but irrelevant + // documents. Setting to -1.0 gives the document a big demotion. However, + // results that are deeply relevant might still be shown. The document will + // have an upstream battle to get a fairly high ranking, but it is not blocked + // 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 *GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpecBoostControlSpec `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 + // "Blue": * (id: ANY("doc_1", "doc_2")) AND (color: ANY("Red","Blue")) + Condition string `json:"condition,omitempty"` + // ForceSendFields is a list of field names (e.g. "Boost") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Boost") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpec) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpec + var s1 struct { + Boost gensupport.JSONFloat64 `json:"boost"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Boost = float64(s1.Boost) + return nil +} + +// GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoost +// SpecConditionBoostSpecBoostControlSpec: 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 GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpecBoostControlSpec 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 []*GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpecBoostControlSpecControlPoint `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 GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpecBoostControlSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpecBoostControlSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoost +// SpecConditionBoostSpecBoostControlSpecControlPoint: 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 GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpecBoostControlSpecControlPoint 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 GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpecBoostControlSpecControlPoint) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpecBoostControlSpecControlPoint + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpecBoostControlSpecControlPoint) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigBoostSpecsBoostSpecConditionBoostSpecBoostControlSpecControlPoint + 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 +} + +// GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigFilterSpecs: +// Filter specification for data store queries. +type GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigFilterSpecs struct { + // DataStores: Optional. The data store where the filter configuration is + // applied. Full resource name of data store, such as + // projects/{project}/locations/{location}/collections/{collectionId}/ + // dataStores/{dataStoreId}. + DataStores []string `json:"dataStores,omitempty"` + // Filter: Optional. The filter expression to be applied. Expression syntax is + // documented at + // https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata#filter-expression-syntax + Filter string `json:"filter,omitempty"` + // ForceSendFields is a list of field names (e.g. "DataStores") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "DataStores") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigFilterSpecs) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2beta1SearchKnowledgeRequestSearchConfigFilterSpecs + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDialogflowV2beta1SearchKnowledgeResponse: The response message // for Conversations.SearchKnowledge. type GoogleCloudDialogflowV2beta1SearchKnowledgeResponse struct { @@ -18213,6 +18516,9 @@ type GoogleCloudDialogflowV2beta1SpeechToTextConfig struct { // (https://cloud.google.com/dialogflow/cx/docs/concept/agent#settings-speech) // for model selection. Model string `json:"model,omitempty"` + // PhraseSets: List of names of Cloud Speech phrase sets that are used for + // transcription. + PhraseSets []string `json:"phraseSets,omitempty"` // SampleRateHertz: Sample rate (in Hertz) of the audio content sent in the // query. Refer to Cloud Speech API documentation // (https://cloud.google.com/speech-to-text/docs/basics) for more details. diff --git a/dialogflow/v3/dialogflow-api.json b/dialogflow/v3/dialogflow-api.json index bfc9f0af24d..d4a38b42b2d 100644 --- a/dialogflow/v3/dialogflow-api.json +++ b/dialogflow/v3/dialogflow-api.json @@ -4453,7 +4453,7 @@ } } }, - "revision": "20241018", + "revision": "20241019", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AdvancedSettings": { @@ -14282,6 +14282,14 @@ "description": "Snippet Source for a Generative Prediction.", "id": "GoogleCloudDialogflowV2KnowledgeAssistAnswerKnowledgeAnswerGenerativeSourceSnippet", "properties": { + "metadata": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Metadata of the document.", + "type": "object" + }, "text": { "description": "Text taken from that URI.", "type": "string" @@ -16704,6 +16712,14 @@ "description": "Snippet Source for a Generative Prediction.", "id": "GoogleCloudDialogflowV2beta1KnowledgeAssistAnswerKnowledgeAnswerGenerativeSourceSnippet", "properties": { + "metadata": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Metadata of the document.", + "type": "object" + }, "text": { "description": "Text taken from that URI.", "type": "string" diff --git a/dialogflow/v3/dialogflow-gen.go b/dialogflow/v3/dialogflow-gen.go index dc4c6870a7e..ee1de38db48 100644 --- a/dialogflow/v3/dialogflow-gen.go +++ b/dialogflow/v3/dialogflow-gen.go @@ -14332,21 +14332,23 @@ func (s GoogleCloudDialogflowV2KnowledgeAssistAnswerKnowledgeAnswerGenerativeSou // GoogleCloudDialogflowV2KnowledgeAssistAnswerKnowledgeAnswerGenerativeSourceSn // ippet: Snippet Source for a Generative Prediction. type GoogleCloudDialogflowV2KnowledgeAssistAnswerKnowledgeAnswerGenerativeSourceSnippet struct { + // Metadata: Metadata of the document. + Metadata googleapi.RawMessage `json:"metadata,omitempty"` // Text: Text taken from that URI. Text string `json:"text,omitempty"` // Title: Title of the document. Title string `json:"title,omitempty"` // Uri: URI the data is sourced from. Uri string `json:"uri,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 + // ForceSendFields is a list of field names (e.g. "Metadata") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See // https://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 + // NullFields is a list of field names (e.g. "Metadata") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -17678,21 +17680,23 @@ func (s GoogleCloudDialogflowV2beta1KnowledgeAssistAnswerKnowledgeAnswerGenerati // GoogleCloudDialogflowV2beta1KnowledgeAssistAnswerKnowledgeAnswerGenerativeSou // rceSnippet: Snippet Source for a Generative Prediction. type GoogleCloudDialogflowV2beta1KnowledgeAssistAnswerKnowledgeAnswerGenerativeSourceSnippet struct { + // Metadata: Metadata of the document. + Metadata googleapi.RawMessage `json:"metadata,omitempty"` // Text: Text taken from that URI. Text string `json:"text,omitempty"` // Title: Title of the document. Title string `json:"title,omitempty"` // Uri: URI the data is sourced from. Uri string `json:"uri,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 + // ForceSendFields is a list of field names (e.g. "Metadata") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See // https://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 + // NullFields is a list of field names (e.g. "Metadata") to include in API + // requests with the JSON null value. By default, fields with 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/dialogflow/v3beta1/dialogflow-api.json b/dialogflow/v3beta1/dialogflow-api.json index 992177564d0..7b24fcc7f5f 100644 --- a/dialogflow/v3beta1/dialogflow-api.json +++ b/dialogflow/v3beta1/dialogflow-api.json @@ -5185,7 +5185,7 @@ } } }, - "revision": "20241018", + "revision": "20241019", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AdvancedSettings": { @@ -16352,6 +16352,14 @@ "description": "Snippet Source for a Generative Prediction.", "id": "GoogleCloudDialogflowV2KnowledgeAssistAnswerKnowledgeAnswerGenerativeSourceSnippet", "properties": { + "metadata": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Metadata of the document.", + "type": "object" + }, "text": { "description": "Text taken from that URI.", "type": "string" @@ -18774,6 +18782,14 @@ "description": "Snippet Source for a Generative Prediction.", "id": "GoogleCloudDialogflowV2beta1KnowledgeAssistAnswerKnowledgeAnswerGenerativeSourceSnippet", "properties": { + "metadata": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Metadata of the document.", + "type": "object" + }, "text": { "description": "Text taken from that URI.", "type": "string" diff --git a/dialogflow/v3beta1/dialogflow-gen.go b/dialogflow/v3beta1/dialogflow-gen.go index 8d4a2c7ba0b..1fcd40b497f 100644 --- a/dialogflow/v3beta1/dialogflow-gen.go +++ b/dialogflow/v3beta1/dialogflow-gen.go @@ -16023,21 +16023,23 @@ func (s GoogleCloudDialogflowV2KnowledgeAssistAnswerKnowledgeAnswerGenerativeSou // GoogleCloudDialogflowV2KnowledgeAssistAnswerKnowledgeAnswerGenerativeSourceSn // ippet: Snippet Source for a Generative Prediction. type GoogleCloudDialogflowV2KnowledgeAssistAnswerKnowledgeAnswerGenerativeSourceSnippet struct { + // Metadata: Metadata of the document. + Metadata googleapi.RawMessage `json:"metadata,omitempty"` // Text: Text taken from that URI. Text string `json:"text,omitempty"` // Title: Title of the document. Title string `json:"title,omitempty"` // Uri: URI the data is sourced from. Uri string `json:"uri,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 + // ForceSendFields is a list of field names (e.g. "Metadata") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See // https://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 + // NullFields is a list of field names (e.g. "Metadata") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -19369,21 +19371,23 @@ func (s GoogleCloudDialogflowV2beta1KnowledgeAssistAnswerKnowledgeAnswerGenerati // GoogleCloudDialogflowV2beta1KnowledgeAssistAnswerKnowledgeAnswerGenerativeSou // rceSnippet: Snippet Source for a Generative Prediction. type GoogleCloudDialogflowV2beta1KnowledgeAssistAnswerKnowledgeAnswerGenerativeSourceSnippet struct { + // Metadata: Metadata of the document. + Metadata googleapi.RawMessage `json:"metadata,omitempty"` // Text: Text taken from that URI. Text string `json:"text,omitempty"` // Title: Title of the document. Title string `json:"title,omitempty"` // Uri: URI the data is sourced from. Uri string `json:"uri,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 + // ForceSendFields is a list of field names (e.g. "Metadata") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See // https://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 + // NullFields is a list of field names (e.g. "Metadata") to include in API + // requests with the JSON null value. By default, fields with 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/discoveryengine/v1/discoveryengine-api.json b/discoveryengine/v1/discoveryengine-api.json index 500912c3677..65193902d19 100644 --- a/discoveryengine/v1/discoveryengine-api.json +++ b/discoveryengine/v1/discoveryengine-api.json @@ -1752,6 +1752,34 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "searchLite": { + "description": "Performs a search. Similar to the SearchService.Search method, but a lite version that allows API key for authentication, where OAuth and IAM checks are not required. Only public website search is supported by this method. If data stores and engines not associated with public website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used for easy onboarding without having to implement an authentication backend. However, it is strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to provide better data security.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/servingConfigs/{servingConfigsId}:searchLite", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.collections.dataStores.servingConfigs.searchLite", + "parameterOrder": [ + "servingConfig" + ], + "parameters": { + "servingConfig": { + "description": "Required. The resource name of the Search serving config, such as `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, or `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. This field is used to identify the serving configuration name, set of models used to make the search.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/servingConfigs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+servingConfig}:searchLite", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1SearchRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1SearchResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } }, @@ -3283,6 +3311,34 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "searchLite": { + "description": "Performs a search. Similar to the SearchService.Search method, but a lite version that allows API key for authentication, where OAuth and IAM checks are not required. Only public website search is supported by this method. If data stores and engines not associated with public website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used for easy onboarding without having to implement an authentication backend. However, it is strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to provide better data security.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/servingConfigs/{servingConfigsId}:searchLite", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.collections.engines.servingConfigs.searchLite", + "parameterOrder": [ + "servingConfig" + ], + "parameters": { + "servingConfig": { + "description": "Required. The resource name of the Search serving config, such as `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, or `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. This field is used to identify the serving configuration name, set of models used to make the search.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/servingConfigs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+servingConfig}:searchLite", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1SearchRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1SearchResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } }, @@ -4961,6 +5017,34 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "searchLite": { + "description": "Performs a search. Similar to the SearchService.Search method, but a lite version that allows API key for authentication, where OAuth and IAM checks are not required. Only public website search is supported by this method. If data stores and engines not associated with public website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used for easy onboarding without having to implement an authentication backend. However, it is strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to provide better data security.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/servingConfigs/{servingConfigsId}:searchLite", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.dataStores.servingConfigs.searchLite", + "parameterOrder": [ + "servingConfig" + ], + "parameters": { + "servingConfig": { + "description": "Required. The resource name of the Search serving config, such as `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, or `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. This field is used to identify the serving configuration name, set of models used to make the search.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/servingConfigs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+servingConfig}:searchLite", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1SearchRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1SearchResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } }, @@ -6006,9 +6090,177 @@ } } }, - "revision": "20241020", + "revision": "20241025", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { + "GoogleApiDistribution": { + "description": "`Distribution` contains summary statistics for a population of values. It optionally contains a histogram representing the distribution of those values across a set of buckets. The summary statistics are the count, mean, sum of the squared deviation from the mean, the minimum, and the maximum of the set of population of values. The histogram is based on a sequence of buckets and gives a count of values that fall into each bucket. The boundaries of the buckets are given either explicitly or by formulas for buckets of fixed or exponentially increasing widths. Although it is not forbidden, it is generally a bad idea to include non-finite values (infinities or NaNs) in the population of values, as this will render the `mean` and `sum_of_squared_deviation` fields meaningless.", + "id": "GoogleApiDistribution", + "properties": { + "bucketCounts": { + "description": "The number of values in each bucket of the histogram, as described in `bucket_options`. If the distribution does not have a histogram, then omit this field. If there is a histogram, then the sum of the values in `bucket_counts` must equal the value in the `count` field of the distribution. If present, `bucket_counts` should contain N values, where N is the number of buckets specified in `bucket_options`. If you supply fewer than N values, the remaining values are assumed to be 0. The order of the values in `bucket_counts` follows the bucket numbering schemes described for the three bucket types. The first value must be the count for the underflow bucket (number 0). The next N-2 values are the counts for the finite buckets (number 1 through N-2). The N'th value in `bucket_counts` is the count for the overflow bucket (number N-1).", + "items": { + "format": "int64", + "type": "string" + }, + "type": "array" + }, + "bucketOptions": { + "$ref": "GoogleApiDistributionBucketOptions", + "description": "Defines the histogram bucket boundaries. If the distribution does not contain a histogram, then omit this field." + }, + "count": { + "description": "The number of values in the population. Must be non-negative. This value must equal the sum of the values in `bucket_counts` if a histogram is provided.", + "format": "int64", + "type": "string" + }, + "exemplars": { + "description": "Must be in increasing order of `value` field.", + "items": { + "$ref": "GoogleApiDistributionExemplar" + }, + "type": "array" + }, + "mean": { + "description": "The arithmetic mean of the values in the population. If `count` is zero then this field must be zero.", + "format": "double", + "type": "number" + }, + "range": { + "$ref": "GoogleApiDistributionRange", + "description": "If specified, contains the range of the population values. The field must not be present if the `count` is zero." + }, + "sumOfSquaredDeviation": { + "description": "The sum of squared deviations from the mean of the values in the population. For values x_i this is: Sum[i=1..n]((x_i - mean)^2) Knuth, \"The Art of Computer Programming\", Vol. 2, page 232, 3rd edition describes Welford's method for accumulating this sum in one pass. If `count` is zero then this field must be zero.", + "format": "double", + "type": "number" + } + }, + "type": "object" + }, + "GoogleApiDistributionBucketOptions": { + "description": "`BucketOptions` describes the bucket boundaries used to create a histogram for the distribution. The buckets can be in a linear sequence, an exponential sequence, or each bucket can be specified explicitly. `BucketOptions` does not include the number of values in each bucket. A bucket has an inclusive lower bound and exclusive upper bound for the values that are counted for that bucket. The upper bound of a bucket must be strictly greater than the lower bound. The sequence of N buckets for a distribution consists of an underflow bucket (number 0), zero or more finite buckets (number 1 through N - 2) and an overflow bucket (number N - 1). The buckets are contiguous: the lower bound of bucket i (i \u003e 0) is the same as the upper bound of bucket i - 1. The buckets span the whole range of finite values: lower bound of the underflow bucket is -infinity and the upper bound of the overflow bucket is +infinity. The finite buckets are so-called because both bounds are finite.", + "id": "GoogleApiDistributionBucketOptions", + "properties": { + "explicitBuckets": { + "$ref": "GoogleApiDistributionBucketOptionsExplicit", + "description": "The explicit buckets." + }, + "exponentialBuckets": { + "$ref": "GoogleApiDistributionBucketOptionsExponential", + "description": "The exponential buckets." + }, + "linearBuckets": { + "$ref": "GoogleApiDistributionBucketOptionsLinear", + "description": "The linear bucket." + } + }, + "type": "object" + }, + "GoogleApiDistributionBucketOptionsExplicit": { + "description": "Specifies a set of buckets with arbitrary widths. There are `size(bounds) + 1` (= N) buckets. Bucket `i` has the following boundaries: Upper bound (0 \u003c= i \u003c N-1): bounds[i] Lower bound (1 \u003c= i \u003c N); bounds[i - 1] The `bounds` field must contain at least one element. If `bounds` has only one element, then there are no finite buckets, and that single element is the common boundary of the overflow and underflow buckets.", + "id": "GoogleApiDistributionBucketOptionsExplicit", + "properties": { + "bounds": { + "description": "The values must be monotonically increasing.", + "items": { + "format": "double", + "type": "number" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleApiDistributionBucketOptionsExponential": { + "description": "Specifies an exponential sequence of buckets that have a width that is proportional to the value of the lower bound. Each bucket represents a constant relative uncertainty on a specific value in the bucket. There are `num_finite_buckets + 2` (= N) buckets. Bucket `i` has the following boundaries: Upper bound (0 \u003c= i \u003c N-1): scale * (growth_factor ^ i). Lower bound (1 \u003c= i \u003c N): scale * (growth_factor ^ (i - 1)).", + "id": "GoogleApiDistributionBucketOptionsExponential", + "properties": { + "growthFactor": { + "description": "Must be greater than 1.", + "format": "double", + "type": "number" + }, + "numFiniteBuckets": { + "description": "Must be greater than 0.", + "format": "int32", + "type": "integer" + }, + "scale": { + "description": "Must be greater than 0.", + "format": "double", + "type": "number" + } + }, + "type": "object" + }, + "GoogleApiDistributionBucketOptionsLinear": { + "description": "Specifies a linear sequence of buckets that all have the same width (except overflow and underflow). Each bucket represents a constant absolute uncertainty on the specific value in the bucket. There are `num_finite_buckets + 2` (= N) buckets. Bucket `i` has the following boundaries: Upper bound (0 \u003c= i \u003c N-1): offset + (width * i). Lower bound (1 \u003c= i \u003c N): offset + (width * (i - 1)).", + "id": "GoogleApiDistributionBucketOptionsLinear", + "properties": { + "numFiniteBuckets": { + "description": "Must be greater than 0.", + "format": "int32", + "type": "integer" + }, + "offset": { + "description": "Lower bound of the first bucket.", + "format": "double", + "type": "number" + }, + "width": { + "description": "Must be greater than 0.", + "format": "double", + "type": "number" + } + }, + "type": "object" + }, + "GoogleApiDistributionExemplar": { + "description": "Exemplars are example points that may be used to annotate aggregated distribution values. They are metadata that gives information about a particular value added to a Distribution bucket, such as a trace ID that was active when a value was added. They may contain further information, such as a example values and timestamps, origin, etc.", + "id": "GoogleApiDistributionExemplar", + "properties": { + "attachments": { + "description": "Contextual information about the example value. Examples are: Trace: type.googleapis.com/google.monitoring.v3.SpanContext Literal string: type.googleapis.com/google.protobuf.StringValue Labels dropped during aggregation: type.googleapis.com/google.monitoring.v3.DroppedLabels There may be only a single attachment of any given message type in a single exemplar, and this is enforced by the system.", + "items": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "type": "object" + }, + "type": "array" + }, + "timestamp": { + "description": "The observation (sampling) time of the above value.", + "format": "google-datetime", + "type": "string" + }, + "value": { + "description": "Value of the exemplar point. This value determines to which bucket the exemplar belongs.", + "format": "double", + "type": "number" + } + }, + "type": "object" + }, + "GoogleApiDistributionRange": { + "description": "The range of the population values.", + "id": "GoogleApiDistributionRange", + "properties": { + "max": { + "description": "The maximum of the population values.", + "format": "double", + "type": "number" + }, + "min": { + "description": "The minimum of the population values.", + "format": "double", + "type": "number" + } + }, + "type": "object" + }, "GoogleApiHttpBody": { "description": "Message that represents an arbitrary HTTP body. It should only be used for payload formats that can't be represented as JSON, such as raw binary or an HTML page. This message can be used both in streaming and non-streaming API methods in the request as well as the response. It can be used as a top-level request field, which is convenient if one wants to extract parameters from either the URL or HTTP template into the request fields and also want access to the raw HTTP body. Example: message GetResourceRequest { // A unique request id. string request_id = 1; // The raw HTTP body is bound to this field. google.api.HttpBody http_body = 2; } service ResourceService { rpc GetResource(GetResourceRequest) returns (google.api.HttpBody); rpc UpdateResource(google.api.HttpBody) returns (google.protobuf.Empty); } Example with streaming methods: service CaldavService { rpc GetCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); rpc UpdateCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); } Use of this type only changes how the request and response bodies are handled, all other features will continue to work unchanged.", "id": "GoogleApiHttpBody", @@ -6036,6 +6288,64 @@ }, "type": "object" }, + "GoogleApiMetric": { + "description": "A specific metric, identified by specifying values for all of the labels of a `MetricDescriptor`.", + "id": "GoogleApiMetric", + "properties": { + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "The set of label values that uniquely identify this metric. All labels listed in the `MetricDescriptor` must be assigned values.", + "type": "object" + }, + "type": { + "description": "An existing metric type, see google.api.MetricDescriptor. For example, `custom.googleapis.com/invoice/paid/amount`.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleApiMonitoredResource": { + "description": "An object representing a resource that can be used for monitoring, logging, billing, or other purposes. Examples include virtual machine instances, databases, and storage devices such as disks. The `type` field identifies a MonitoredResourceDescriptor object that describes the resource's schema. Information in the `labels` field identifies the actual resource and its attributes according to the schema. For example, a particular Compute Engine VM instance could be represented by the following object, because the MonitoredResourceDescriptor for `\"gce_instance\"` has labels `\"project_id\"`, `\"instance_id\"` and `\"zone\"`: { \"type\": \"gce_instance\", \"labels\": { \"project_id\": \"my-project\", \"instance_id\": \"12345678901234\", \"zone\": \"us-central1-a\" }}", + "id": "GoogleApiMonitoredResource", + "properties": { + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Required. Values for all of the labels listed in the associated monitored resource descriptor. For example, Compute Engine VM instances use the labels `\"project_id\"`, `\"instance_id\"`, and `\"zone\"`.", + "type": "object" + }, + "type": { + "description": "Required. The monitored resource type. This field must match the `type` field of a MonitoredResourceDescriptor object. For example, the type of a Compute Engine VM instance is `gce_instance`. Some descriptors include the service name in the type; for example, the type of a Datastream stream is `datastream.googleapis.com/Stream`.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleApiMonitoredResourceMetadata": { + "description": "Auxiliary metadata for a MonitoredResource object. MonitoredResource objects contain the minimum set of information to uniquely identify a monitored resource instance. There is some other useful auxiliary metadata. Monitoring and Logging use an ingestion pipeline to extract metadata for cloud resources of all types, and store the metadata in this message.", + "id": "GoogleApiMonitoredResourceMetadata", + "properties": { + "systemLabels": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Output only. Values for predefined system metadata labels. System labels are a kind of metadata extracted by Google, including \"machine_image\", \"vpc\", \"subnet_id\", \"security_group\", \"name\", etc. System label values can be only strings, Boolean values, or a list of strings. For example: { \"name\": \"my-test-instance\", \"security_group\": [\"a\", \"b\", \"c\"], \"spot_instance\": false }", + "type": "object" + }, + "userLabels": { + "additionalProperties": { + "type": "string" + }, + "description": "Output only. A map of user-defined metadata labels.", + "type": "object" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineLoggingErrorContext": { "description": "A description of the context in which an error occurred.", "id": "GoogleCloudDiscoveryengineLoggingErrorContext", @@ -6346,6 +6656,10 @@ "description": "Deprecated: This field is deprecated. Streaming Answer API will be supported. Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.", "type": "boolean" }, + "groundingSpec": { + "$ref": "GoogleCloudDiscoveryengineV1AnswerQueryRequestGroundingSpec", + "description": "Optional. Grounding specification." + }, "query": { "$ref": "GoogleCloudDiscoveryengineV1Query", "description": "Required. Current user query." @@ -6445,6 +6759,17 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1AnswerQueryRequestGroundingSpec": { + "description": "Grounding specification.", + "id": "GoogleCloudDiscoveryengineV1AnswerQueryRequestGroundingSpec", + "properties": { + "includeGroundingSupports": { + "description": "Optional. Specifies whether to include grounding_supports in the answer. The default value is `false`. When this field is set to `true`, returned answer will have `grounding_score` and will contain GroundingSupports for each claim.", + "type": "boolean" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1AnswerQueryRequestQueryUnderstandingSpec": { "description": "Query understanding specification.", "id": "GoogleCloudDiscoveryengineV1AnswerQueryRequestQueryUnderstandingSpec", @@ -11729,7 +12054,7 @@ "type": "string" }, "eventType": { - "description": "Required. User event type. Allowed values are: Generic values: * `search`: Search for Documents. * `view-item`: Detailed page view of a Document. * `view-item-list`: View of a panel or ordered list of Documents. * `view-home-page`: View of the home page. * `view-category-page`: View of a category page, e.g. Home \u003e Men \u003e Jeans Retail-related values: * `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping * `purchase`: Purchase an item(s) Media-related values: * `media-play`: Start/resume watching a video, playing a song, etc. * `media-complete`: Finished or stopped midway through a video, song, etc.", + "description": "Required. User event type. Allowed values are: Generic values: * `search`: Search for Documents. * `view-item`: Detailed page view of a Document. * `view-item-list`: View of a panel or ordered list of Documents. * `view-home-page`: View of the home page. * `view-category-page`: View of a category page, e.g. Home \u003e Men \u003e Jeans * `add-feedback`: Add a user feedback. Retail-related values: * `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping * `purchase`: Purchase an item(s) Media-related values: * `media-play`: Start/resume watching a video, playing a song, etc. * `media-complete`: Finished or stopped midway through a video, song, etc.", "type": "string" }, "filter": { @@ -12639,6 +12964,17 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries": { + "description": "The historical crawl rate timeseries data, used for monitoring.", + "id": "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries", + "properties": { + "qpsTimeSeries": { + "$ref": "GoogleMonitoringV3TimeSeries", + "description": "The QPS of the crawl rate." + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaCreateDataStoreMetadata": { "description": "Metadata related to the progress of the DataStoreService.CreateDataStore operation. This will be returned by the google.longrunning.Operation.metadata field.", "id": "GoogleCloudDiscoveryengineV1alphaCreateDataStoreMetadata", @@ -12971,6 +13307,21 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries": { + "description": "The historical dedicated crawl rate timeseries data, used for monitoring. Dedicated crawl is used by Vertex AI to crawl the user's website when dedicate crawl is set.", + "id": "GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries", + "properties": { + "autoRefreshCrawlRate": { + "$ref": "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries", + "description": "Vertex AI's dedicated crawl rate time series of auto-refresh, which is the crawl rate of Google-CloudVertexBot when dedicate crawl is set, and the crawl rate is for best effort use cases like refreshing urls periodically." + }, + "userTriggeredCrawlRate": { + "$ref": "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries", + "description": "Vertex AI's dedicated crawl rate time series of user triggered crawl, which is the crawl rate of Google-CloudVertexBot when dedicate crawl is set, and user triggered crawl rate is for deterministic use cases like crawling urls or sitemaps specified by users." + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaDeleteDataStoreMetadata": { "description": "Metadata related to the progress of the DataStoreService.DeleteDataStore operation. This will be returned by the google.longrunning.Operation.metadata field.", "id": "GoogleCloudDiscoveryengineV1alphaDeleteDataStoreMetadata", @@ -14161,6 +14512,55 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse": { + "description": "Response message for CrawlRateManagementService.ObtainCrawlRate method. The response contains organcic or dedicated crawl rate time series data for monitoring, depending on whether dedicated crawl rate is set.", + "id": "GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse", + "properties": { + "dedicatedCrawlRateTimeSeries": { + "$ref": "GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries", + "description": "The historical dedicated crawl rate timeseries data, used for monitoring." + }, + "error": { + "$ref": "GoogleRpcStatus", + "description": "Errors from service when handling the request." + }, + "organicCrawlRateTimeSeries": { + "$ref": "GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries", + "description": "The historical organic crawl rate timeseries data, used for monitoring." + }, + "state": { + "description": "Output only. The state of the response.", + "enum": [ + "STATE_UNSPECIFIED", + "SUCCEEDED", + "FAILED" + ], + "enumDescriptions": [ + "The state is unspecified.", + "The state is successful.", + "The state is failed." + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries": { + "description": "The historical organic crawl rate timeseries data, used for monitoring. Organic crawl is auto-determined by Google to crawl the user's website when dedicate crawl is not set. Crawl rate is the QPS of crawl request Google sends to the user's website.", + "id": "GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries", + "properties": { + "googleOrganicCrawlRate": { + "$ref": "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries", + "description": "Google's organic crawl rate time series, which is the sum of all googlebots' crawl rate. Please refer to https://developers.google.com/search/docs/crawling-indexing/overview-google-crawlers for more details about googlebots." + }, + "vertexAiOrganicCrawlRate": { + "$ref": "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries", + "description": "Vertex AI's organic crawl rate time series, which is the crawl rate of Google-CloudVertexBot when dedicate crawl is not set. Please refer to https://developers.google.com/search/docs/crawling-indexing/google-common-crawlers#google-cloudvertexbot for more details about Google-CloudVertexBot." + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaProject": { "description": "Metadata and configurations for a Google Cloud project in the service.", "id": "GoogleCloudDiscoveryengineV1alphaProject", @@ -18445,6 +18845,139 @@ }, "type": "object" }, + "GoogleMonitoringV3Point": { + "description": "A single data point in a time series.", + "id": "GoogleMonitoringV3Point", + "properties": { + "interval": { + "$ref": "GoogleMonitoringV3TimeInterval", + "description": "The time interval to which the data point applies. For `GAUGE` metrics, the start time is optional, but if it is supplied, it must equal the end time. For `DELTA` metrics, the start and end time should specify a non-zero interval, with subsequent points specifying contiguous and non-overlapping intervals. For `CUMULATIVE` metrics, the start and end time should specify a non-zero interval, with subsequent points specifying the same start time and increasing end times, until an event resets the cumulative value to zero and sets a new start time for the following points." + }, + "value": { + "$ref": "GoogleMonitoringV3TypedValue", + "description": "The value of the data point." + } + }, + "type": "object" + }, + "GoogleMonitoringV3TimeInterval": { + "description": "A time interval extending just after a start time through an end time. If the start time is the same as the end time, then the interval represents a single point in time.", + "id": "GoogleMonitoringV3TimeInterval", + "properties": { + "endTime": { + "description": "Required. The end of the time interval.", + "format": "google-datetime", + "type": "string" + }, + "startTime": { + "description": "Optional. The beginning of the time interval. The default value for the start time is the end time. The start time must not be later than the end time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleMonitoringV3TimeSeries": { + "description": "A collection of data points that describes the time-varying values of a metric. A time series is identified by a combination of a fully-specified monitored resource and a fully-specified metric. This type is used for both listing and creating time series.", + "id": "GoogleMonitoringV3TimeSeries", + "properties": { + "description": { + "description": "Input only. A detailed description of the time series that will be associated with the google.api.MetricDescriptor for the metric. Once set, this field cannot be changed through CreateTimeSeries.", + "type": "string" + }, + "metadata": { + "$ref": "GoogleApiMonitoredResourceMetadata", + "description": "Output only. The associated monitored resource metadata. When reading a time series, this field will include metadata labels that are explicitly named in the reduction. When creating a time series, this field is ignored." + }, + "metric": { + "$ref": "GoogleApiMetric", + "description": "The associated metric. A fully-specified metric used to identify the time series." + }, + "metricKind": { + "description": "The metric kind of the time series. When listing time series, this metric kind might be different from the metric kind of the associated metric if this time series is an alignment or reduction of other time series. When creating a time series, this field is optional. If present, it must be the same as the metric kind of the associated metric. If the associated metric's descriptor must be auto-created, then this field specifies the metric kind of the new descriptor and must be either `GAUGE` (the default) or `CUMULATIVE`.", + "enum": [ + "METRIC_KIND_UNSPECIFIED", + "GAUGE", + "DELTA", + "CUMULATIVE" + ], + "enumDescriptions": [ + "Do not use this default value.", + "An instantaneous measurement of a value.", + "The change in a value during a time interval.", + "A value accumulated over a time interval. Cumulative measurements in a time series should have the same start time and increasing end times, until an event resets the cumulative value to zero and sets a new start time for the following points." + ], + "type": "string" + }, + "points": { + "description": "The data points of this time series. When listing time series, points are returned in reverse time order. When creating a time series, this field must contain exactly one point and the point's type must be the same as the value type of the associated metric. If the associated metric's descriptor must be auto-created, then the value type of the descriptor is determined by the point's type, which must be `BOOL`, `INT64`, `DOUBLE`, or `DISTRIBUTION`.", + "items": { + "$ref": "GoogleMonitoringV3Point" + }, + "type": "array" + }, + "resource": { + "$ref": "GoogleApiMonitoredResource", + "description": "The associated monitored resource. Custom metrics can use only certain monitored resource types in their time series data. For more information, see [Monitored resources for custom metrics](https://cloud.google.com/monitoring/custom-metrics/creating-metrics#custom-metric-resources)." + }, + "unit": { + "description": "The units in which the metric value is reported. It is only applicable if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The `unit` defines the representation of the stored metric values. This field can only be changed through CreateTimeSeries when it is empty.", + "type": "string" + }, + "valueType": { + "description": "The value type of the time series. When listing time series, this value type might be different from the value type of the associated metric if this time series is an alignment or reduction of other time series. When creating a time series, this field is optional. If present, it must be the same as the type of the data in the `points` field.", + "enum": [ + "VALUE_TYPE_UNSPECIFIED", + "BOOL", + "INT64", + "DOUBLE", + "STRING", + "DISTRIBUTION", + "MONEY" + ], + "enumDescriptions": [ + "Do not use this default value.", + "The value is a boolean. This value type can be used only if the metric kind is `GAUGE`.", + "The value is a signed 64-bit integer.", + "The value is a double precision floating point number.", + "The value is a text string. This value type can be used only if the metric kind is `GAUGE`.", + "The value is a `Distribution`.", + "The value is money." + ], + "type": "string" + } + }, + "type": "object" + }, + "GoogleMonitoringV3TypedValue": { + "description": "A single strongly-typed value.", + "id": "GoogleMonitoringV3TypedValue", + "properties": { + "boolValue": { + "description": "A Boolean value: `true` or `false`.", + "type": "boolean" + }, + "distributionValue": { + "$ref": "GoogleApiDistribution", + "description": "A distribution value." + }, + "doubleValue": { + "description": "A 64-bit double-precision floating-point number. Its magnitude is approximately ±10±300 and it has 16 significant digits of precision.", + "format": "double", + "type": "number" + }, + "int64Value": { + "description": "A 64-bit integer. Its range is approximately ±9.2x1018.", + "format": "int64", + "type": "string" + }, + "stringValue": { + "description": "A variable-length string value.", + "type": "string" + } + }, + "type": "object" + }, "GoogleProtobufEmpty": { "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": "GoogleProtobufEmpty", diff --git a/discoveryengine/v1/discoveryengine-gen.go b/discoveryengine/v1/discoveryengine-gen.go index c9d2b55108c..db2cff1bc4f 100644 --- a/discoveryengine/v1/discoveryengine-gen.go +++ b/discoveryengine/v1/discoveryengine-gen.go @@ -871,6 +871,355 @@ type ProjectsOperationsService struct { s *Service } +// GoogleApiDistribution: `Distribution` contains summary statistics for a +// population of values. It optionally contains a histogram representing the +// distribution of those values across a set of buckets. The summary statistics +// are the count, mean, sum of the squared deviation from the mean, the +// minimum, and the maximum of the set of population of values. The histogram +// is based on a sequence of buckets and gives a count of values that fall into +// each bucket. The boundaries of the buckets are given either explicitly or by +// formulas for buckets of fixed or exponentially increasing widths. Although +// it is not forbidden, it is generally a bad idea to include non-finite values +// (infinities or NaNs) in the population of values, as this will render the +// `mean` and `sum_of_squared_deviation` fields meaningless. +type GoogleApiDistribution struct { + // BucketCounts: The number of values in each bucket of the histogram, as + // described in `bucket_options`. If the distribution does not have a + // histogram, then omit this field. If there is a histogram, then the sum of + // the values in `bucket_counts` must equal the value in the `count` field of + // the distribution. If present, `bucket_counts` should contain N values, where + // N is the number of buckets specified in `bucket_options`. If you supply + // fewer than N values, the remaining values are assumed to be 0. The order of + // the values in `bucket_counts` follows the bucket numbering schemes described + // for the three bucket types. The first value must be the count for the + // underflow bucket (number 0). The next N-2 values are the counts for the + // finite buckets (number 1 through N-2). The N'th value in `bucket_counts` is + // the count for the overflow bucket (number N-1). + BucketCounts googleapi.Int64s `json:"bucketCounts,omitempty"` + // BucketOptions: Defines the histogram bucket boundaries. If the distribution + // does not contain a histogram, then omit this field. + BucketOptions *GoogleApiDistributionBucketOptions `json:"bucketOptions,omitempty"` + // Count: The number of values in the population. Must be non-negative. This + // value must equal the sum of the values in `bucket_counts` if a histogram is + // provided. + Count int64 `json:"count,omitempty,string"` + // Exemplars: Must be in increasing order of `value` field. + Exemplars []*GoogleApiDistributionExemplar `json:"exemplars,omitempty"` + // Mean: The arithmetic mean of the values in the population. If `count` is + // zero then this field must be zero. + Mean float64 `json:"mean,omitempty"` + // Range: If specified, contains the range of the population values. The field + // must not be present if the `count` is zero. + Range *GoogleApiDistributionRange `json:"range,omitempty"` + // SumOfSquaredDeviation: The sum of squared deviations from the mean of the + // values in the population. For values x_i this is: Sumi=1..n ((x_i - mean)^2) + // Knuth, "The Art of Computer Programming", Vol. 2, page 232, 3rd edition + // describes Welford's method for accumulating this sum in one pass. If `count` + // is zero then this field must be zero. + SumOfSquaredDeviation float64 `json:"sumOfSquaredDeviation,omitempty"` + // ForceSendFields is a list of field names (e.g. "BucketCounts") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BucketCounts") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiDistribution) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiDistribution + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleApiDistribution) UnmarshalJSON(data []byte) error { + type NoMethod GoogleApiDistribution + var s1 struct { + Mean gensupport.JSONFloat64 `json:"mean"` + SumOfSquaredDeviation gensupport.JSONFloat64 `json:"sumOfSquaredDeviation"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Mean = float64(s1.Mean) + s.SumOfSquaredDeviation = float64(s1.SumOfSquaredDeviation) + return nil +} + +// GoogleApiDistributionBucketOptions: `BucketOptions` describes the bucket +// boundaries used to create a histogram for the distribution. The buckets can +// be in a linear sequence, an exponential sequence, or each bucket can be +// specified explicitly. `BucketOptions` does not include the number of values +// in each bucket. A bucket has an inclusive lower bound and exclusive upper +// bound for the values that are counted for that bucket. The upper bound of a +// bucket must be strictly greater than the lower bound. The sequence of N +// buckets for a distribution consists of an underflow bucket (number 0), zero +// or more finite buckets (number 1 through N - 2) and an overflow bucket +// (number N - 1). The buckets are contiguous: the lower bound of bucket i (i > +// 0) is the same as the upper bound of bucket i - 1. The buckets span the +// whole range of finite values: lower bound of the underflow bucket is +// -infinity and the upper bound of the overflow bucket is +infinity. The +// finite buckets are so-called because both bounds are finite. +type GoogleApiDistributionBucketOptions struct { + // ExplicitBuckets: The explicit buckets. + ExplicitBuckets *GoogleApiDistributionBucketOptionsExplicit `json:"explicitBuckets,omitempty"` + // ExponentialBuckets: The exponential buckets. + ExponentialBuckets *GoogleApiDistributionBucketOptionsExponential `json:"exponentialBuckets,omitempty"` + // LinearBuckets: The linear bucket. + LinearBuckets *GoogleApiDistributionBucketOptionsLinear `json:"linearBuckets,omitempty"` + // ForceSendFields is a list of field names (e.g. "ExplicitBuckets") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ExplicitBuckets") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiDistributionBucketOptions) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiDistributionBucketOptions + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleApiDistributionBucketOptionsExplicit: Specifies a set of buckets with +// arbitrary widths. There are `size(bounds) + 1` (= N) buckets. Bucket `i` has +// the following boundaries: Upper bound (0 <= i < N-1): bounds[i] Lower bound +// (1 <= i < N); bounds[i - 1] The `bounds` field must contain at least one +// element. If `bounds` has only one element, then there are no finite buckets, +// and that single element is the common boundary of the overflow and underflow +// buckets. +type GoogleApiDistributionBucketOptionsExplicit struct { + // Bounds: The values must be monotonically increasing. + Bounds []float64 `json:"bounds,omitempty"` + // ForceSendFields is a list of field names (e.g. "Bounds") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Bounds") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiDistributionBucketOptionsExplicit) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiDistributionBucketOptionsExplicit + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleApiDistributionBucketOptionsExplicit) UnmarshalJSON(data []byte) error { + type NoMethod GoogleApiDistributionBucketOptionsExplicit + var s1 struct { + Bounds []gensupport.JSONFloat64 `json:"bounds"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Bounds = make([]float64, len(s1.Bounds)) + for i := range s1.Bounds { + s.Bounds[i] = float64(s1.Bounds[i]) + } + return nil +} + +// GoogleApiDistributionBucketOptionsExponential: Specifies an exponential +// sequence of buckets that have a width that is proportional to the value of +// the lower bound. Each bucket represents a constant relative uncertainty on a +// specific value in the bucket. There are `num_finite_buckets + 2` (= N) +// buckets. Bucket `i` has the following boundaries: Upper bound (0 <= i < +// N-1): scale * (growth_factor ^ i). Lower bound (1 <= i < N): scale * +// (growth_factor ^ (i - 1)). +type GoogleApiDistributionBucketOptionsExponential struct { + // GrowthFactor: Must be greater than 1. + GrowthFactor float64 `json:"growthFactor,omitempty"` + // NumFiniteBuckets: Must be greater than 0. + NumFiniteBuckets int64 `json:"numFiniteBuckets,omitempty"` + // Scale: Must be greater than 0. + Scale float64 `json:"scale,omitempty"` + // ForceSendFields is a list of field names (e.g. "GrowthFactor") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "GrowthFactor") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiDistributionBucketOptionsExponential) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiDistributionBucketOptionsExponential + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleApiDistributionBucketOptionsExponential) UnmarshalJSON(data []byte) error { + type NoMethod GoogleApiDistributionBucketOptionsExponential + var s1 struct { + GrowthFactor gensupport.JSONFloat64 `json:"growthFactor"` + Scale gensupport.JSONFloat64 `json:"scale"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.GrowthFactor = float64(s1.GrowthFactor) + s.Scale = float64(s1.Scale) + return nil +} + +// GoogleApiDistributionBucketOptionsLinear: Specifies a linear sequence of +// buckets that all have the same width (except overflow and underflow). Each +// bucket represents a constant absolute uncertainty on the specific value in +// the bucket. There are `num_finite_buckets + 2` (= N) buckets. Bucket `i` has +// the following boundaries: Upper bound (0 <= i < N-1): offset + (width * i). +// Lower bound (1 <= i < N): offset + (width * (i - 1)). +type GoogleApiDistributionBucketOptionsLinear struct { + // NumFiniteBuckets: Must be greater than 0. + NumFiniteBuckets int64 `json:"numFiniteBuckets,omitempty"` + // Offset: Lower bound of the first bucket. + Offset float64 `json:"offset,omitempty"` + // Width: Must be greater than 0. + Width float64 `json:"width,omitempty"` + // ForceSendFields is a list of field names (e.g. "NumFiniteBuckets") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "NumFiniteBuckets") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiDistributionBucketOptionsLinear) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiDistributionBucketOptionsLinear + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleApiDistributionBucketOptionsLinear) UnmarshalJSON(data []byte) error { + type NoMethod GoogleApiDistributionBucketOptionsLinear + var s1 struct { + Offset gensupport.JSONFloat64 `json:"offset"` + Width gensupport.JSONFloat64 `json:"width"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Offset = float64(s1.Offset) + s.Width = float64(s1.Width) + return nil +} + +// GoogleApiDistributionExemplar: Exemplars are example points that may be used +// to annotate aggregated distribution values. They are metadata that gives +// information about a particular value added to a Distribution bucket, such as +// a trace ID that was active when a value was added. They may contain further +// information, such as a example values and timestamps, origin, etc. +type GoogleApiDistributionExemplar struct { + // Attachments: Contextual information about the example value. Examples are: + // Trace: type.googleapis.com/google.monitoring.v3.SpanContext Literal string: + // type.googleapis.com/google.protobuf.StringValue Labels dropped during + // aggregation: type.googleapis.com/google.monitoring.v3.DroppedLabels There + // may be only a single attachment of any given message type in a single + // exemplar, and this is enforced by the system. + Attachments []googleapi.RawMessage `json:"attachments,omitempty"` + // Timestamp: The observation (sampling) time of the above value. + Timestamp string `json:"timestamp,omitempty"` + // Value: Value of the exemplar point. This value determines to which bucket + // the exemplar belongs. + Value float64 `json:"value,omitempty"` + // ForceSendFields is a list of field names (e.g. "Attachments") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Attachments") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiDistributionExemplar) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiDistributionExemplar + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleApiDistributionExemplar) UnmarshalJSON(data []byte) error { + type NoMethod GoogleApiDistributionExemplar + var s1 struct { + Value gensupport.JSONFloat64 `json:"value"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Value = float64(s1.Value) + return nil +} + +// GoogleApiDistributionRange: The range of the population values. +type GoogleApiDistributionRange struct { + // Max: The maximum of the population values. + Max float64 `json:"max,omitempty"` + // Min: The minimum of the population values. + Min float64 `json:"min,omitempty"` + // ForceSendFields is a list of field names (e.g. "Max") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Max") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiDistributionRange) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiDistributionRange + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleApiDistributionRange) UnmarshalJSON(data []byte) error { + type NoMethod GoogleApiDistributionRange + var s1 struct { + Max gensupport.JSONFloat64 `json:"max"` + Min gensupport.JSONFloat64 `json:"min"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Max = float64(s1.Max) + s.Min = float64(s1.Min) + return nil +} + // GoogleApiHttpBody: Message that represents an arbitrary HTTP body. It should // only be used for payload formats that can't be represented as JSON, such as // raw binary or an HTML page. This message can be used both in streaming and @@ -918,6 +1267,107 @@ func (s GoogleApiHttpBody) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleApiMetric: A specific metric, identified by specifying values for all +// of the labels of a `MetricDescriptor`. +type GoogleApiMetric struct { + // Labels: The set of label values that uniquely identify this metric. All + // labels listed in the `MetricDescriptor` must be assigned values. + Labels map[string]string `json:"labels,omitempty"` + // Type: An existing metric type, see google.api.MetricDescriptor. For example, + // `custom.googleapis.com/invoice/paid/amount`. + Type string `json:"type,omitempty"` + // ForceSendFields is a list of field names (e.g. "Labels") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Labels") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiMetric) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiMetric + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleApiMonitoredResource: An object representing a resource that can be +// used for monitoring, logging, billing, or other purposes. Examples include +// virtual machine instances, databases, and storage devices such as disks. The +// `type` field identifies a MonitoredResourceDescriptor object that describes +// the resource's schema. Information in the `labels` field identifies the +// actual resource and its attributes according to the schema. For example, a +// particular Compute Engine VM instance could be represented by the following +// object, because the MonitoredResourceDescriptor for "gce_instance" has +// labels "project_id", "instance_id" and "zone": { "type": +// "gce_instance", "labels": { "project_id": "my-project", "instance_id": +// "12345678901234", "zone": "us-central1-a" }} +type GoogleApiMonitoredResource struct { + // Labels: Required. Values for all of the labels listed in the associated + // monitored resource descriptor. For example, Compute Engine VM instances use + // the labels "project_id", "instance_id", and "zone". + Labels map[string]string `json:"labels,omitempty"` + // Type: Required. The monitored resource type. This field must match the + // `type` field of a MonitoredResourceDescriptor object. For example, the type + // of a Compute Engine VM instance is `gce_instance`. Some descriptors include + // the service name in the type; for example, the type of a Datastream stream + // is `datastream.googleapis.com/Stream`. + Type string `json:"type,omitempty"` + // ForceSendFields is a list of field names (e.g. "Labels") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Labels") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiMonitoredResource) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiMonitoredResource + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleApiMonitoredResourceMetadata: Auxiliary metadata for a +// MonitoredResource object. MonitoredResource objects contain the minimum set +// of information to uniquely identify a monitored resource instance. There is +// some other useful auxiliary metadata. Monitoring and Logging use an +// ingestion pipeline to extract metadata for cloud resources of all types, and +// store the metadata in this message. +type GoogleApiMonitoredResourceMetadata struct { + // SystemLabels: Output only. Values for predefined system metadata labels. + // System labels are a kind of metadata extracted by Google, including + // "machine_image", "vpc", "subnet_id", "security_group", "name", etc. System + // label values can be only strings, Boolean values, or a list of strings. For + // example: { "name": "my-test-instance", "security_group": ["a", "b", "c"], + // "spot_instance": false } + SystemLabels googleapi.RawMessage `json:"systemLabels,omitempty"` + // UserLabels: Output only. A map of user-defined metadata labels. + UserLabels map[string]string `json:"userLabels,omitempty"` + // ForceSendFields is a list of field names (e.g. "SystemLabels") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "SystemLabels") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiMonitoredResourceMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiMonitoredResourceMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineLoggingErrorContext: A description of the context // in which an error occurred. type GoogleCloudDiscoveryengineLoggingErrorContext struct { @@ -1286,6 +1736,8 @@ type GoogleCloudDiscoveryengineV1AnswerQueryRequest struct { // calling ConversationalSearchService.GetAnswer or // ConversationalSearchService.GetSession method. AsynchronousMode bool `json:"asynchronousMode,omitempty"` + // GroundingSpec: Optional. Grounding specification. + GroundingSpec *GoogleCloudDiscoveryengineV1AnswerQueryRequestGroundingSpec `json:"groundingSpec,omitempty"` // Query: Required. Current user query. Query *GoogleCloudDiscoveryengineV1Query `json:"query,omitempty"` // QueryUnderstandingSpec: Query understanding specification. @@ -1451,6 +1903,32 @@ func (s GoogleCloudDiscoveryengineV1AnswerQueryRequestAnswerGenerationSpecPrompt return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1AnswerQueryRequestGroundingSpec: Grounding +// specification. +type GoogleCloudDiscoveryengineV1AnswerQueryRequestGroundingSpec struct { + // IncludeGroundingSupports: Optional. Specifies whether to include + // grounding_supports in the answer. The default value is `false`. When this + // field is set to `true`, returned answer will have `grounding_score` and will + // contain GroundingSupports for each claim. + IncludeGroundingSupports bool `json:"includeGroundingSupports,omitempty"` + // ForceSendFields is a list of field names (e.g. "IncludeGroundingSupports") + // to unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "IncludeGroundingSupports") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1AnswerQueryRequestGroundingSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1AnswerQueryRequestGroundingSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1AnswerQueryRequestQueryUnderstandingSpec: Query // understanding specification. type GoogleCloudDiscoveryengineV1AnswerQueryRequestQueryUnderstandingSpec struct { @@ -9122,11 +9600,12 @@ type GoogleCloudDiscoveryengineV1UserEvent struct { // `search`: Search for Documents. * `view-item`: Detailed page view of a // Document. * `view-item-list`: View of a panel or ordered list of Documents. // * `view-home-page`: View of the home page. * `view-category-page`: View of a - // category page, e.g. Home > Men > Jeans Retail-related values: * - // `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping * - // `purchase`: Purchase an item(s) Media-related values: * `media-play`: - // Start/resume watching a video, playing a song, etc. * `media-complete`: - // Finished or stopped midway through a video, song, etc. + // category page, e.g. Home > Men > Jeans * `add-feedback`: Add a user + // feedback. Retail-related values: * `add-to-cart`: Add an item(s) to cart, + // e.g. in Retail online shopping * `purchase`: Purchase an item(s) + // Media-related values: * `media-play`: Start/resume watching a video, playing + // a song, etc. * `media-complete`: Finished or stopped midway through a video, + // song, etc. EventType string `json:"eventType,omitempty"` // Filter: The filter syntax consists of an expression language for // constructing a predicate from one or more fields of the documents being @@ -10313,6 +10792,29 @@ func (s GoogleCloudDiscoveryengineV1alphaControlSynonymsAction) MarshalJSON() ([ return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries: The historical crawl +// rate timeseries data, used for monitoring. +type GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries struct { + // QpsTimeSeries: The QPS of the crawl rate. + QpsTimeSeries *GoogleMonitoringV3TimeSeries `json:"qpsTimeSeries,omitempty"` + // ForceSendFields is a list of field names (e.g. "QpsTimeSeries") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "QpsTimeSeries") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaCreateDataStoreMetadata: Metadata related // to the progress of the DataStoreService.CreateDataStore operation. This will // be returned by the google.longrunning.Operation.metadata field. @@ -10677,6 +11179,39 @@ func (s GoogleCloudDiscoveryengineV1alphaDataStoreServingConfigDataStore) Marsha return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries: The +// historical dedicated crawl rate timeseries data, used for monitoring. +// Dedicated crawl is used by Vertex AI to crawl the user's website when +// dedicate crawl is set. +type GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries struct { + // AutoRefreshCrawlRate: Vertex AI's dedicated crawl rate time series of + // auto-refresh, which is the crawl rate of Google-CloudVertexBot when dedicate + // crawl is set, and the crawl rate is for best effort use cases like + // refreshing urls periodically. + AutoRefreshCrawlRate *GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries `json:"autoRefreshCrawlRate,omitempty"` + // UserTriggeredCrawlRate: Vertex AI's dedicated crawl rate time series of user + // triggered crawl, which is the crawl rate of Google-CloudVertexBot when + // dedicate crawl is set, and user triggered crawl rate is for deterministic + // use cases like crawling urls or sitemaps specified by users. + UserTriggeredCrawlRate *GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries `json:"userTriggeredCrawlRate,omitempty"` + // ForceSendFields is a list of field names (e.g. "AutoRefreshCrawlRate") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AutoRefreshCrawlRate") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaDeleteDataStoreMetadata: Metadata related // to the progress of the DataStoreService.DeleteDataStore operation. This will // be returned by the google.longrunning.Operation.metadata field. @@ -12290,6 +12825,79 @@ func (s GoogleCloudDiscoveryengineV1alphaNaturalLanguageQueryUnderstandingConfig return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse: Response message +// for CrawlRateManagementService.ObtainCrawlRate method. The response contains +// organcic or dedicated crawl rate time series data for monitoring, depending +// on whether dedicated crawl rate is set. +type GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse struct { + // DedicatedCrawlRateTimeSeries: The historical dedicated crawl rate timeseries + // data, used for monitoring. + DedicatedCrawlRateTimeSeries *GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries `json:"dedicatedCrawlRateTimeSeries,omitempty"` + // Error: Errors from service when handling the request. + Error *GoogleRpcStatus `json:"error,omitempty"` + // OrganicCrawlRateTimeSeries: The historical organic crawl rate timeseries + // data, used for monitoring. + OrganicCrawlRateTimeSeries *GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries `json:"organicCrawlRateTimeSeries,omitempty"` + // State: Output only. The state of the response. + // + // Possible values: + // "STATE_UNSPECIFIED" - The state is unspecified. + // "SUCCEEDED" - The state is successful. + // "FAILED" - The state is failed. + State string `json:"state,omitempty"` + // ForceSendFields is a list of field names (e.g. + // "DedicatedCrawlRateTimeSeries") to unconditionally include in API requests. + // By default, fields with empty or default values are omitted from API + // requests. See https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields + // for more details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "DedicatedCrawlRateTimeSeries") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries: The historical +// organic crawl rate timeseries data, used for monitoring. Organic crawl is +// auto-determined by Google to crawl the user's website when dedicate crawl is +// not set. Crawl rate is the QPS of crawl request Google sends to the user's +// website. +type GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries struct { + // GoogleOrganicCrawlRate: Google's organic crawl rate time series, which is + // the sum of all googlebots' crawl rate. Please refer to + // https://developers.google.com/search/docs/crawling-indexing/overview-google-crawlers + // for more details about googlebots. + GoogleOrganicCrawlRate *GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries `json:"googleOrganicCrawlRate,omitempty"` + // VertexAiOrganicCrawlRate: Vertex AI's organic crawl rate time series, which + // is the crawl rate of Google-CloudVertexBot when dedicate crawl is not set. + // Please refer to + // https://developers.google.com/search/docs/crawling-indexing/google-common-crawlers#google-cloudvertexbot + // for more details about Google-CloudVertexBot. + VertexAiOrganicCrawlRate *GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries `json:"vertexAiOrganicCrawlRate,omitempty"` + // ForceSendFields is a list of field names (e.g. "GoogleOrganicCrawlRate") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "GoogleOrganicCrawlRate") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaProject: Metadata and configurations for a // Google Cloud project in the service. type GoogleCloudDiscoveryengineV1alphaProject struct { @@ -18400,6 +19008,198 @@ func (s GoogleLongrunningOperation) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleMonitoringV3Point: A single data point in a time series. +type GoogleMonitoringV3Point struct { + // Interval: The time interval to which the data point applies. For `GAUGE` + // metrics, the start time is optional, but if it is supplied, it must equal + // the end time. For `DELTA` metrics, the start and end time should specify a + // non-zero interval, with subsequent points specifying contiguous and + // non-overlapping intervals. For `CUMULATIVE` metrics, the start and end time + // should specify a non-zero interval, with subsequent points specifying the + // same start time and increasing end times, until an event resets the + // cumulative value to zero and sets a new start time for the following points. + Interval *GoogleMonitoringV3TimeInterval `json:"interval,omitempty"` + // Value: The value of the data point. + Value *GoogleMonitoringV3TypedValue `json:"value,omitempty"` + // ForceSendFields is a list of field names (e.g. "Interval") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Interval") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleMonitoringV3Point) MarshalJSON() ([]byte, error) { + type NoMethod GoogleMonitoringV3Point + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleMonitoringV3TimeInterval: A time interval extending just after a start +// time through an end time. If the start time is the same as the end time, +// then the interval represents a single point in time. +type GoogleMonitoringV3TimeInterval struct { + // EndTime: Required. The end of the time interval. + EndTime string `json:"endTime,omitempty"` + // StartTime: Optional. The beginning of the time interval. The default value + // for the start time is the end time. The start time must not be later than + // the end time. + StartTime string `json:"startTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "EndTime") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "EndTime") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleMonitoringV3TimeInterval) MarshalJSON() ([]byte, error) { + type NoMethod GoogleMonitoringV3TimeInterval + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleMonitoringV3TimeSeries: A collection of data points that describes the +// time-varying values of a metric. A time series is identified by a +// combination of a fully-specified monitored resource and a fully-specified +// metric. This type is used for both listing and creating time series. +type GoogleMonitoringV3TimeSeries struct { + // Description: Input only. A detailed description of the time series that will + // be associated with the google.api.MetricDescriptor for the metric. Once set, + // this field cannot be changed through CreateTimeSeries. + Description string `json:"description,omitempty"` + // Metadata: Output only. The associated monitored resource metadata. When + // reading a time series, this field will include metadata labels that are + // explicitly named in the reduction. When creating a time series, this field + // is ignored. + Metadata *GoogleApiMonitoredResourceMetadata `json:"metadata,omitempty"` + // Metric: The associated metric. A fully-specified metric used to identify the + // time series. + Metric *GoogleApiMetric `json:"metric,omitempty"` + // MetricKind: The metric kind of the time series. When listing time series, + // this metric kind might be different from the metric kind of the associated + // metric if this time series is an alignment or reduction of other time + // series. When creating a time series, this field is optional. If present, it + // must be the same as the metric kind of the associated metric. If the + // associated metric's descriptor must be auto-created, then this field + // specifies the metric kind of the new descriptor and must be either `GAUGE` + // (the default) or `CUMULATIVE`. + // + // Possible values: + // "METRIC_KIND_UNSPECIFIED" - Do not use this default value. + // "GAUGE" - An instantaneous measurement of a value. + // "DELTA" - The change in a value during a time interval. + // "CUMULATIVE" - A value accumulated over a time interval. Cumulative + // measurements in a time series should have the same start time and increasing + // end times, until an event resets the cumulative value to zero and sets a new + // start time for the following points. + MetricKind string `json:"metricKind,omitempty"` + // Points: The data points of this time series. When listing time series, + // points are returned in reverse time order. When creating a time series, this + // field must contain exactly one point and the point's type must be the same + // as the value type of the associated metric. If the associated metric's + // descriptor must be auto-created, then the value type of the descriptor is + // determined by the point's type, which must be `BOOL`, `INT64`, `DOUBLE`, or + // `DISTRIBUTION`. + Points []*GoogleMonitoringV3Point `json:"points,omitempty"` + // Resource: The associated monitored resource. Custom metrics can use only + // certain monitored resource types in their time series data. For more + // information, see Monitored resources for custom metrics + // (https://cloud.google.com/monitoring/custom-metrics/creating-metrics#custom-metric-resources). + Resource *GoogleApiMonitoredResource `json:"resource,omitempty"` + // Unit: The units in which the metric value is reported. It is only applicable + // if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The `unit` + // defines the representation of the stored metric values. This field can only + // be changed through CreateTimeSeries when it is empty. + Unit string `json:"unit,omitempty"` + // ValueType: The value type of the time series. When listing time series, this + // value type might be different from the value type of the associated metric + // if this time series is an alignment or reduction of other time series. When + // creating a time series, this field is optional. If present, it must be the + // same as the type of the data in the `points` field. + // + // Possible values: + // "VALUE_TYPE_UNSPECIFIED" - Do not use this default value. + // "BOOL" - The value is a boolean. This value type can be used only if the + // metric kind is `GAUGE`. + // "INT64" - The value is a signed 64-bit integer. + // "DOUBLE" - The value is a double precision floating point number. + // "STRING" - The value is a text string. This value type can be used only if + // the metric kind is `GAUGE`. + // "DISTRIBUTION" - The value is a `Distribution`. + // "MONEY" - The value is money. + ValueType string `json:"valueType,omitempty"` + // ForceSendFields is a list of field names (e.g. "Description") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Description") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleMonitoringV3TimeSeries) MarshalJSON() ([]byte, error) { + type NoMethod GoogleMonitoringV3TimeSeries + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleMonitoringV3TypedValue: A single strongly-typed value. +type GoogleMonitoringV3TypedValue struct { + // BoolValue: A Boolean value: `true` or `false`. + BoolValue bool `json:"boolValue,omitempty"` + // DistributionValue: A distribution value. + DistributionValue *GoogleApiDistribution `json:"distributionValue,omitempty"` + // DoubleValue: A 64-bit double-precision floating-point number. Its magnitude + // is approximately ±10±300 and it has 16 significant digits of precision. + DoubleValue float64 `json:"doubleValue,omitempty"` + // Int64Value: A 64-bit integer. Its range is approximately ±9.2x1018. + Int64Value int64 `json:"int64Value,omitempty,string"` + // StringValue: A variable-length string value. + StringValue string `json:"stringValue,omitempty"` + // ForceSendFields is a list of field names (e.g. "BoolValue") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BoolValue") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleMonitoringV3TypedValue) MarshalJSON() ([]byte, error) { + type NoMethod GoogleMonitoringV3TypedValue + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleMonitoringV3TypedValue) UnmarshalJSON(data []byte) error { + type NoMethod GoogleMonitoringV3TypedValue + var s1 struct { + DoubleValue gensupport.JSONFloat64 `json:"doubleValue"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.DoubleValue = float64(s1.DoubleValue) + return nil +} + // GoogleProtobufEmpty: 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: @@ -24504,6 +25304,142 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchCall) Pages(c } } +type ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall struct { + s *Service + servingConfig string + googleclouddiscoveryenginev1searchrequest *GoogleCloudDiscoveryengineV1SearchRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SearchLite: Performs a search. Similar to the SearchService.Search method, +// but a lite version that allows API key for authentication, where OAuth and +// IAM checks are not required. Only public website search is supported by this +// method. If data stores and engines not associated with public website search +// are specified, a `FAILED_PRECONDITION` error is returned. This method can be +// used for easy onboarding without having to implement an authentication +// backend. However, it is strongly recommended to use SearchService.Search +// instead with required OAuth and IAM checks to provide better data security. +// +// - servingConfig: The resource name of the Search serving config, such as +// `projects/*/locations/global/collections/default_collection/engines/*/servi +// ngConfigs/default_serving_config`, or +// `projects/*/locations/global/collections/default_collection/dataStores/defa +// ult_data_store/servingConfigs/default_serving_config`. This field is used +// to identify the serving configuration name, set of models used to make the +// search. +func (r *ProjectsLocationsCollectionsDataStoresServingConfigsService) SearchLite(servingConfig string, googleclouddiscoveryenginev1searchrequest *GoogleCloudDiscoveryengineV1SearchRequest) *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall { + c := &ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.servingConfig = servingConfig + c.googleclouddiscoveryenginev1searchrequest = googleclouddiscoveryenginev1searchrequest + 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 *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall { + 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 *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) 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.googleclouddiscoveryenginev1searchrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+servingConfig}:searchLite") + 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{ + "servingConfig": c.servingConfig, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.collections.dataStores.servingConfigs.searchLite" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1SearchResponse.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 *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1SearchResponse, 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 := &GoogleCloudDiscoveryengineV1SearchResponse{ + 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 *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1SearchResponse) error) error { + c.ctx_ = ctx + defer func(pt string) { c.googleclouddiscoveryenginev1searchrequest.PageToken = pt }(c.googleclouddiscoveryenginev1searchrequest.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.googleclouddiscoveryenginev1searchrequest.PageToken = x.NextPageToken + } +} + type ProjectsLocationsCollectionsDataStoresSessionsCreateCall struct { s *Service parent string @@ -30141,6 +31077,142 @@ func (c *ProjectsLocationsCollectionsEnginesServingConfigsSearchCall) Pages(ctx } } +type ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall struct { + s *Service + servingConfig string + googleclouddiscoveryenginev1searchrequest *GoogleCloudDiscoveryengineV1SearchRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SearchLite: Performs a search. Similar to the SearchService.Search method, +// but a lite version that allows API key for authentication, where OAuth and +// IAM checks are not required. Only public website search is supported by this +// method. If data stores and engines not associated with public website search +// are specified, a `FAILED_PRECONDITION` error is returned. This method can be +// used for easy onboarding without having to implement an authentication +// backend. However, it is strongly recommended to use SearchService.Search +// instead with required OAuth and IAM checks to provide better data security. +// +// - servingConfig: The resource name of the Search serving config, such as +// `projects/*/locations/global/collections/default_collection/engines/*/servi +// ngConfigs/default_serving_config`, or +// `projects/*/locations/global/collections/default_collection/dataStores/defa +// ult_data_store/servingConfigs/default_serving_config`. This field is used +// to identify the serving configuration name, set of models used to make the +// search. +func (r *ProjectsLocationsCollectionsEnginesServingConfigsService) SearchLite(servingConfig string, googleclouddiscoveryenginev1searchrequest *GoogleCloudDiscoveryengineV1SearchRequest) *ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall { + c := &ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.servingConfig = servingConfig + c.googleclouddiscoveryenginev1searchrequest = googleclouddiscoveryenginev1searchrequest + 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 *ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall { + 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 *ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall) 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.googleclouddiscoveryenginev1searchrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+servingConfig}:searchLite") + 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{ + "servingConfig": c.servingConfig, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.collections.engines.servingConfigs.searchLite" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1SearchResponse.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 *ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1SearchResponse, 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 := &GoogleCloudDiscoveryengineV1SearchResponse{ + 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 *ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1SearchResponse) error) error { + c.ctx_ = ctx + defer func(pt string) { c.googleclouddiscoveryenginev1searchrequest.PageToken = pt }(c.googleclouddiscoveryenginev1searchrequest.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.googleclouddiscoveryenginev1searchrequest.PageToken = x.NextPageToken + } +} + type ProjectsLocationsCollectionsEnginesSessionsCreateCall struct { s *Service parent string @@ -36281,6 +37353,142 @@ func (c *ProjectsLocationsDataStoresServingConfigsSearchCall) Pages(ctx context. } } +type ProjectsLocationsDataStoresServingConfigsSearchLiteCall struct { + s *Service + servingConfig string + googleclouddiscoveryenginev1searchrequest *GoogleCloudDiscoveryengineV1SearchRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SearchLite: Performs a search. Similar to the SearchService.Search method, +// but a lite version that allows API key for authentication, where OAuth and +// IAM checks are not required. Only public website search is supported by this +// method. If data stores and engines not associated with public website search +// are specified, a `FAILED_PRECONDITION` error is returned. This method can be +// used for easy onboarding without having to implement an authentication +// backend. However, it is strongly recommended to use SearchService.Search +// instead with required OAuth and IAM checks to provide better data security. +// +// - servingConfig: The resource name of the Search serving config, such as +// `projects/*/locations/global/collections/default_collection/engines/*/servi +// ngConfigs/default_serving_config`, or +// `projects/*/locations/global/collections/default_collection/dataStores/defa +// ult_data_store/servingConfigs/default_serving_config`. This field is used +// to identify the serving configuration name, set of models used to make the +// search. +func (r *ProjectsLocationsDataStoresServingConfigsService) SearchLite(servingConfig string, googleclouddiscoveryenginev1searchrequest *GoogleCloudDiscoveryengineV1SearchRequest) *ProjectsLocationsDataStoresServingConfigsSearchLiteCall { + c := &ProjectsLocationsDataStoresServingConfigsSearchLiteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.servingConfig = servingConfig + c.googleclouddiscoveryenginev1searchrequest = googleclouddiscoveryenginev1searchrequest + 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 *ProjectsLocationsDataStoresServingConfigsSearchLiteCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataStoresServingConfigsSearchLiteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsDataStoresServingConfigsSearchLiteCall) Context(ctx context.Context) *ProjectsLocationsDataStoresServingConfigsSearchLiteCall { + 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 *ProjectsLocationsDataStoresServingConfigsSearchLiteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsDataStoresServingConfigsSearchLiteCall) 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.googleclouddiscoveryenginev1searchrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+servingConfig}:searchLite") + 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{ + "servingConfig": c.servingConfig, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.dataStores.servingConfigs.searchLite" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1SearchResponse.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 *ProjectsLocationsDataStoresServingConfigsSearchLiteCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1SearchResponse, 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 := &GoogleCloudDiscoveryengineV1SearchResponse{ + 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 *ProjectsLocationsDataStoresServingConfigsSearchLiteCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1SearchResponse) error) error { + c.ctx_ = ctx + defer func(pt string) { c.googleclouddiscoveryenginev1searchrequest.PageToken = pt }(c.googleclouddiscoveryenginev1searchrequest.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.googleclouddiscoveryenginev1searchrequest.PageToken = x.NextPageToken + } +} + type ProjectsLocationsDataStoresSessionsCreateCall struct { s *Service parent string diff --git a/discoveryengine/v1alpha/discoveryengine-api.json b/discoveryengine/v1alpha/discoveryengine-api.json index 7b1bf6134fe..b633e0fde67 100644 --- a/discoveryengine/v1alpha/discoveryengine-api.json +++ b/discoveryengine/v1alpha/discoveryengine-api.json @@ -1316,6 +1316,38 @@ } } }, + "completionConfig": { + "methods": { + "completeQuery": { + "description": "Completes the user input with advanced keyword suggestions.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/completionConfig:completeQuery", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.collections.dataStores.completionConfig.completeQuery", + "parameterOrder": [ + "completionConfig" + ], + "parameters": { + "completionConfig": { + "description": "Required. The completion_config of the parent dataStore or engine resource name for which the completion is performed, such as `projects/*/locations/global/collections/default_collection/dataStores/*/completionConfig` `projects/*/locations/global/collections/default_collection/engines/*/completionConfig`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/completionConfig$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+completionConfig}:completeQuery", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "completionSuggestions": { "methods": { "import": { @@ -2309,6 +2341,34 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "searchLite": { + "description": "Performs a search. Similar to the SearchService.Search method, but a lite version that allows API key for authentication, where OAuth and IAM checks are not required. Only public website search is supported by this method. If data stores and engines not associated with public website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used for easy onboarding without having to implement an authentication backend. However, it is strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to provide better data security.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/servingConfigs/{servingConfigsId}:searchLite", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.collections.dataStores.servingConfigs.searchLite", + "parameterOrder": [ + "servingConfig" + ], + "parameters": { + "servingConfig": { + "description": "Required. The resource name of the Search serving config, such as `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, or `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. This field is used to identify the serving configuration name, set of models used to make the search.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/servingConfigs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+servingConfig}:searchLite", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1alphaSearchResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } }, @@ -3470,6 +3530,38 @@ } }, "resources": { + "completionConfig": { + "methods": { + "completeQuery": { + "description": "Completes the user input with advanced keyword suggestions.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/completionConfig:completeQuery", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.collections.engines.completionConfig.completeQuery", + "parameterOrder": [ + "completionConfig" + ], + "parameters": { + "completionConfig": { + "description": "Required. The completion_config of the parent dataStore or engine resource name for which the completion is performed, such as `projects/*/locations/global/collections/default_collection/dataStores/*/completionConfig` `projects/*/locations/global/collections/default_collection/engines/*/completionConfig`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/completionConfig$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+completionConfig}:completeQuery", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "controls": { "methods": { "create": { @@ -4072,6 +4164,34 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "searchLite": { + "description": "Performs a search. Similar to the SearchService.Search method, but a lite version that allows API key for authentication, where OAuth and IAM checks are not required. Only public website search is supported by this method. If data stores and engines not associated with public website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used for easy onboarding without having to implement an authentication backend. However, it is strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to provide better data security.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/servingConfigs/{servingConfigsId}:searchLite", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.collections.engines.servingConfigs.searchLite", + "parameterOrder": [ + "servingConfig" + ], + "parameters": { + "servingConfig": { + "description": "Required. The resource name of the Search serving config, such as `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, or `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. This field is used to identify the serving configuration name, set of models used to make the search.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/servingConfigs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+servingConfig}:searchLite", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1alphaSearchResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } }, @@ -5134,6 +5254,38 @@ } } }, + "completionConfig": { + "methods": { + "completeQuery": { + "description": "Completes the user input with advanced keyword suggestions.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/completionConfig:completeQuery", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.dataStores.completionConfig.completeQuery", + "parameterOrder": [ + "completionConfig" + ], + "parameters": { + "completionConfig": { + "description": "Required. The completion_config of the parent dataStore or engine resource name for which the completion is performed, such as `projects/*/locations/global/collections/default_collection/dataStores/*/completionConfig` `projects/*/locations/global/collections/default_collection/engines/*/completionConfig`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/completionConfig$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+completionConfig}:completeQuery", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "completionSuggestions": { "methods": { "import": { @@ -6026,6 +6178,34 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "searchLite": { + "description": "Performs a search. Similar to the SearchService.Search method, but a lite version that allows API key for authentication, where OAuth and IAM checks are not required. Only public website search is supported by this method. If data stores and engines not associated with public website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used for easy onboarding without having to implement an authentication backend. However, it is strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to provide better data security.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/servingConfigs/{servingConfigsId}:searchLite", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.dataStores.servingConfigs.searchLite", + "parameterOrder": [ + "servingConfig" + ], + "parameters": { + "servingConfig": { + "description": "Required. The resource name of the Search serving config, such as `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, or `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. This field is used to identify the serving configuration name, set of models used to make the search.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/servingConfigs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+servingConfig}:searchLite", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1alphaSearchResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } }, @@ -7682,7 +7862,7 @@ } } }, - "revision": "20241020", + "revision": "20241025", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiDistribution": { @@ -7880,6 +8060,24 @@ }, "type": "object" }, + "GoogleApiMetric": { + "description": "A specific metric, identified by specifying values for all of the labels of a `MetricDescriptor`.", + "id": "GoogleApiMetric", + "properties": { + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "The set of label values that uniquely identify this metric. All labels listed in the `MetricDescriptor` must be assigned values.", + "type": "object" + }, + "type": { + "description": "An existing metric type, see google.api.MetricDescriptor. For example, `custom.googleapis.com/invoice/paid/amount`.", + "type": "string" + } + }, + "type": "object" + }, "GoogleApiMonitoredResource": { "description": "An object representing a resource that can be used for monitoring, logging, billing, or other purposes. Examples include virtual machine instances, databases, and storage devices such as disks. The `type` field identifies a MonitoredResourceDescriptor object that describes the resource's schema. Information in the `labels` field identifies the actual resource and its attributes according to the schema. For example, a particular Compute Engine VM instance could be represented by the following object, because the MonitoredResourceDescriptor for `\"gce_instance\"` has labels `\"project_id\"`, `\"instance_id\"` and `\"zone\"`: { \"type\": \"gce_instance\", \"labels\": { \"project_id\": \"my-project\", \"instance_id\": \"12345678901234\", \"zone\": \"us-central1-a\" }}", "id": "GoogleApiMonitoredResource", @@ -7898,6 +8096,28 @@ }, "type": "object" }, + "GoogleApiMonitoredResourceMetadata": { + "description": "Auxiliary metadata for a MonitoredResource object. MonitoredResource objects contain the minimum set of information to uniquely identify a monitored resource instance. There is some other useful auxiliary metadata. Monitoring and Logging use an ingestion pipeline to extract metadata for cloud resources of all types, and store the metadata in this message.", + "id": "GoogleApiMonitoredResourceMetadata", + "properties": { + "systemLabels": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Output only. Values for predefined system metadata labels. System labels are a kind of metadata extracted by Google, including \"machine_image\", \"vpc\", \"subnet_id\", \"security_group\", \"name\", etc. System label values can be only strings, Boolean values, or a list of strings. For example: { \"name\": \"my-test-instance\", \"security_group\": [\"a\", \"b\", \"c\"], \"spot_instance\": false }", + "type": "object" + }, + "userLabels": { + "additionalProperties": { + "type": "string" + }, + "description": "Output only. A map of user-defined metadata labels.", + "type": "object" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineLoggingErrorContext": { "description": "A description of the context in which an error occurred.", "id": "GoogleCloudDiscoveryengineLoggingErrorContext", @@ -9654,6 +9874,236 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequest": { + "description": "Request message for CompletionService.AdvancedCompleteQuery method. .", + "id": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequest", + "properties": { + "boostSpec": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequestBoostSpec", + "description": "Optional. Specification to boost suggestions matching the condition." + }, + "includeTailSuggestions": { + "description": "Indicates if tail suggestions should be returned if there are no suggestions that match the full query. Even if set to true, if there are suggestions that match the full query, those are returned and no tail suggestions are returned.", + "type": "boolean" + }, + "query": { + "description": "Required. The typeahead input used to fetch suggestions. Maximum length is 128 characters. The query can not be empty for most of the suggestion types. If it is empty, an `INVALID_ARGUMENT` error is returned. The exception is when the suggestion_types contains only the type `RECENT_SEARCH`, the query can be an empty string. The is called \"zero prefix\" feature, which returns user's recently searched queries given the empty query.", + "type": "string" + }, + "queryModel": { + "description": "Specifies the autocomplete data model. This overrides any model specified in the Configuration \u003e Autocomplete section of the Cloud console. Currently supported values: * `document` - Using suggestions generated from user-imported documents. * `search-history` - Using suggestions generated from the past history of SearchService.Search API calls. Do not use it when there is no traffic for Search API. * `user-event` - Using suggestions generated from user-imported search events. * `document-completable` - Using suggestions taken directly from user-imported document fields marked as completable. Default values: * `document` is the default model for regular dataStores. * `search-history` is the default model for site search dataStores.", + "type": "string" + }, + "suggestionTypes": { + "description": "Optional. Suggestion types to return. If empty or unspecified, query suggestions are returned. Only one suggestion type is supported at the moment.", + "items": { + "enum": [ + "SUGGESTION_TYPE_UNSPECIFIED", + "QUERY", + "PEOPLE", + "CONTENT", + "RECENT_SEARCH", + "GOOGLE_WORKSPACE" + ], + "enumDescriptions": [ + "Default value.", + "Returns query suggestions.", + "Returns people suggestions.", + "Returns content suggestions.", + "Returns recent search suggestions.", + "Returns Google Workspace suggestions." + ], + "type": "string" + }, + "type": "array" + }, + "userInfo": { + "$ref": "GoogleCloudDiscoveryengineV1alphaUserInfo", + "description": "Optional. Information about the end user. This should be the same identifier information as UserEvent.user_info and SearchRequest.user_info." + }, + "userPseudoId": { + "description": "A unique identifier for tracking visitors. For example, this could be implemented with an HTTP cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor logs in or out of the website. This field should NOT have a fixed value such as `unknown_visitor`. This should be the same identifier as UserEvent.user_pseudo_id and SearchRequest.user_pseudo_id. The field must be a UTF-8 encoded string with a length limit of 128", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequestBoostSpec": { + "description": "Specification to boost suggestions based on the condtion of the suggestion.", + "id": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequestBoostSpec", + "properties": { + "conditionBoostSpecs": { + "description": "Condition boost specifications. If a suggestion matches multiple conditions in the specifictions, boost values from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20. Note: Currently only support language condition boost.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequestBoostSpecConditionBoostSpec" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequestBoostSpecConditionBoostSpec": { + "description": "Boost applies to suggestions which match a condition.", + "id": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequestBoostSpecConditionBoostSpec", + "properties": { + "boost": { + "description": "Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0. Setting to 1.0 gives the suggestions a big promotion. However, it does not necessarily mean that the top result will be a boosted suggestion. Setting to -1.0 gives the suggestions a big demotion. However, other suggestions that are relevant might still be shown. Setting to 0.0 means no boost applied. The boosting condition is ignored.", + "format": "float", + "type": "number" + }, + "condition": { + "description": "An expression which specifies a boost condition. The syntax is the same as [filter expression syntax](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata#filter-expression-syntax). Currently, the only supported condition is a list of BCP-47 lang codes. Example: * To boost suggestions in languages `en` or `fr`: `(lang_code: ANY(\"en\", \"fr\"))`", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponse": { + "description": "Response message for CompletionService.AdvancedCompleteQuery method.", + "id": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponse", + "properties": { + "contentSuggestions": { + "description": "Results of the matched content suggestions. The result list is ordered and the first result is the top suggestion.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseContentSuggestion" + }, + "type": "array" + }, + "peopleSuggestions": { + "description": "Results of the matched people suggestions. The result list is ordered and the first result is the top suggestion.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponsePersonSuggestion" + }, + "type": "array" + }, + "querySuggestions": { + "description": "Results of the matched query suggestions. The result list is ordered and the first result is a top suggestion.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseQuerySuggestion" + }, + "type": "array" + }, + "recentSearchSuggestions": { + "description": "Results of the matched \"recent search\" suggestions. The result list is ordered and the first result is the top suggestion.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseRecentSearchSuggestion" + }, + "type": "array" + }, + "tailMatchTriggered": { + "description": "True if the returned suggestions are all tail suggestions. For tail matching to be triggered, include_tail_suggestions in the request must be true and there must be no suggestions that match the full query.", + "type": "boolean" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseContentSuggestion": { + "description": "Suggestions as content.", + "id": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseContentSuggestion", + "properties": { + "contentType": { + "description": "The type of the content suggestion.", + "enum": [ + "CONTENT_TYPE_UNSPECIFIED", + "GOOGLE_WORKSPACE", + "THIRD_PARTY" + ], + "enumDescriptions": [ + "Default value.", + "The suggestion is from a Google Workspace source.", + "The suggestion is from a third party source." + ], + "type": "string" + }, + "dataStore": { + "description": "The name of the dataStore that this suggestion belongs to.", + "type": "string" + }, + "document": { + "$ref": "GoogleCloudDiscoveryengineV1alphaDocument", + "description": "The document data snippet in the suggestion. Only a subset of fields will be populated." + }, + "suggestion": { + "description": "The suggestion for the query.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponsePersonSuggestion": { + "description": "Suggestions as people.", + "id": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponsePersonSuggestion", + "properties": { + "dataStore": { + "description": "The name of the dataStore that this suggestion belongs to.", + "type": "string" + }, + "document": { + "$ref": "GoogleCloudDiscoveryengineV1alphaDocument", + "description": "The document data snippet in the suggestion. Only a subset of fields is populated." + }, + "personType": { + "description": "The type of the person.", + "enum": [ + "PERSON_TYPE_UNSPECIFIED", + "CLOUD_IDENTITY", + "THIRD_PARTY_IDENTITY" + ], + "enumDescriptions": [ + "Default value.", + "The suggestion is from a GOOGLE_IDENTITY source.", + "The suggestion is from a THIRD_PARTY_IDENTITY source." + ], + "type": "string" + }, + "suggestion": { + "description": "The suggestion for the query.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseQuerySuggestion": { + "description": "Suggestions as search queries.", + "id": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseQuerySuggestion", + "properties": { + "completableFieldPaths": { + "description": "The unique document field paths that serve as the source of this suggestion if it was generated from completable fields. This field is only populated for the document-completable model.", + "items": { + "type": "string" + }, + "type": "array" + }, + "dataStore": { + "description": "The name of the dataStore that this suggestion belongs to.", + "items": { + "type": "string" + }, + "type": "array" + }, + "suggestion": { + "description": "The suggestion for the query.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseRecentSearchSuggestion": { + "description": "Suggestions from recent search history.", + "id": "GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseRecentSearchSuggestion", + "properties": { + "recentSearchTime": { + "description": "The time when this recent rearch happened.", + "format": "google-datetime", + "type": "string" + }, + "suggestion": { + "description": "The suggestion for the query.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaAdvancedSiteSearchConfig": { "description": "Configuration data for advance site search.", "id": "GoogleCloudDiscoveryengineV1alphaAdvancedSiteSearchConfig", @@ -9854,6 +10304,10 @@ "description": "Deprecated: This field is deprecated. Streaming Answer API will be supported. Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.", "type": "boolean" }, + "groundingSpec": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestGroundingSpec", + "description": "Optional. Grounding specification." + }, "query": { "$ref": "GoogleCloudDiscoveryengineV1alphaQuery", "description": "Required. Current user query." @@ -9953,6 +10407,31 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestGroundingSpec": { + "description": "Grounding specification.", + "id": "GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestGroundingSpec", + "properties": { + "filteringLevel": { + "description": "Optional. Specifies whether to enable the filtering based on grounding score and at what level.", + "enum": [ + "FILTERING_LEVEL_UNSPECIFIED", + "FILTERING_LEVEL_LOW", + "FILTERING_LEVEL_HIGH" + ], + "enumDescriptions": [ + "Default is no filter", + "Filter answers based on a low threshold.", + "Filter answers based on a high threshold." + ], + "type": "string" + }, + "includeGroundingSupports": { + "description": "Optional. Specifies whether to include grounding_supports in the answer. The default value is `false`. When this field is set to `true`, returned answer will have `grounding_score` and will contain GroundingSupports for each claim.", + "type": "boolean" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestQueryUnderstandingSpec": { "description": "Query understanding specification.", "id": "GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestQueryUnderstandingSpec", @@ -11756,6 +12235,17 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries": { + "description": "The historical crawl rate timeseries data, used for monitoring.", + "id": "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries", + "properties": { + "qpsTimeSeries": { + "$ref": "GoogleMonitoringV3TimeSeries", + "description": "The QPS of the crawl rate." + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaCreateDataStoreMetadata": { "description": "Metadata related to the progress of the DataStoreService.CreateDataStore operation. This will be returned by the google.longrunning.Operation.metadata field.", "id": "GoogleCloudDiscoveryengineV1alphaCreateDataStoreMetadata", @@ -12125,6 +12615,21 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries": { + "description": "The historical dedicated crawl rate timeseries data, used for monitoring. Dedicated crawl is used by Vertex AI to crawl the user's website when dedicate crawl is set.", + "id": "GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries", + "properties": { + "autoRefreshCrawlRate": { + "$ref": "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries", + "description": "Vertex AI's dedicated crawl rate time series of auto-refresh, which is the crawl rate of Google-CloudVertexBot when dedicate crawl is set, and the crawl rate is for best effort use cases like refreshing urls periodically." + }, + "userTriggeredCrawlRate": { + "$ref": "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries", + "description": "Vertex AI's dedicated crawl rate time series of user triggered crawl, which is the crawl rate of Google-CloudVertexBot when dedicate crawl is set, and user triggered crawl rate is for deterministic use cases like crawling urls or sitemaps specified by users." + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaDeleteDataStoreMetadata": { "description": "Metadata related to the progress of the DataStoreService.DeleteDataStore operation. This will be returned by the google.longrunning.Operation.metadata field.", "id": "GoogleCloudDiscoveryengineV1alphaDeleteDataStoreMetadata", @@ -14243,6 +14748,55 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse": { + "description": "Response message for CrawlRateManagementService.ObtainCrawlRate method. The response contains organcic or dedicated crawl rate time series data for monitoring, depending on whether dedicated crawl rate is set.", + "id": "GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse", + "properties": { + "dedicatedCrawlRateTimeSeries": { + "$ref": "GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries", + "description": "The historical dedicated crawl rate timeseries data, used for monitoring." + }, + "error": { + "$ref": "GoogleRpcStatus", + "description": "Errors from service when handling the request." + }, + "organicCrawlRateTimeSeries": { + "$ref": "GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries", + "description": "The historical organic crawl rate timeseries data, used for monitoring." + }, + "state": { + "description": "Output only. The state of the response.", + "enum": [ + "STATE_UNSPECIFIED", + "SUCCEEDED", + "FAILED" + ], + "enumDescriptions": [ + "The state is unspecified.", + "The state is successful.", + "The state is failed." + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries": { + "description": "The historical organic crawl rate timeseries data, used for monitoring. Organic crawl is auto-determined by Google to crawl the user's website when dedicate crawl is not set. Crawl rate is the QPS of crawl request Google sends to the user's website.", + "id": "GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries", + "properties": { + "googleOrganicCrawlRate": { + "$ref": "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries", + "description": "Google's organic crawl rate time series, which is the sum of all googlebots' crawl rate. Please refer to https://developers.google.com/search/docs/crawling-indexing/overview-google-crawlers for more details about googlebots." + }, + "vertexAiOrganicCrawlRate": { + "$ref": "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries", + "description": "Vertex AI's organic crawl rate time series, which is the crawl rate of Google-CloudVertexBot when dedicate crawl is not set. Please refer to https://developers.google.com/search/docs/crawling-indexing/google-common-crawlers#google-cloudvertexbot for more details about Google-CloudVertexBot." + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaPageInfo": { "description": "Detailed page information.", "id": "GoogleCloudDiscoveryengineV1alphaPageInfo", @@ -17456,7 +18010,7 @@ "type": "string" }, "eventType": { - "description": "Required. User event type. Allowed values are: Generic values: * `search`: Search for Documents. * `view-item`: Detailed page view of a Document. * `view-item-list`: View of a panel or ordered list of Documents. * `view-home-page`: View of the home page. * `view-category-page`: View of a category page, e.g. Home \u003e Men \u003e Jeans Retail-related values: * `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping * `purchase`: Purchase an item(s) Media-related values: * `media-play`: Start/resume watching a video, playing a song, etc. * `media-complete`: Finished or stopped midway through a video, song, etc.", + "description": "Required. User event type. Allowed values are: Generic values: * `search`: Search for Documents. * `view-item`: Detailed page view of a Document. * `view-item-list`: View of a panel or ordered list of Documents. * `view-home-page`: View of the home page. * `view-category-page`: View of a category page, e.g. Home \u003e Men \u003e Jeans * `add-feedback`: Add a user feedback. Retail-related values: * `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping * `purchase`: Purchase an item(s) Media-related values: * `media-play`: Start/resume watching a video, playing a song, etc. * `media-complete`: Finished or stopped midway through a video, song, etc.", "type": "string" }, "filter": { @@ -20294,6 +20848,110 @@ }, "type": "object" }, + "GoogleMonitoringV3Point": { + "description": "A single data point in a time series.", + "id": "GoogleMonitoringV3Point", + "properties": { + "interval": { + "$ref": "GoogleMonitoringV3TimeInterval", + "description": "The time interval to which the data point applies. For `GAUGE` metrics, the start time is optional, but if it is supplied, it must equal the end time. For `DELTA` metrics, the start and end time should specify a non-zero interval, with subsequent points specifying contiguous and non-overlapping intervals. For `CUMULATIVE` metrics, the start and end time should specify a non-zero interval, with subsequent points specifying the same start time and increasing end times, until an event resets the cumulative value to zero and sets a new start time for the following points." + }, + "value": { + "$ref": "GoogleMonitoringV3TypedValue", + "description": "The value of the data point." + } + }, + "type": "object" + }, + "GoogleMonitoringV3TimeInterval": { + "description": "A time interval extending just after a start time through an end time. If the start time is the same as the end time, then the interval represents a single point in time.", + "id": "GoogleMonitoringV3TimeInterval", + "properties": { + "endTime": { + "description": "Required. The end of the time interval.", + "format": "google-datetime", + "type": "string" + }, + "startTime": { + "description": "Optional. The beginning of the time interval. The default value for the start time is the end time. The start time must not be later than the end time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleMonitoringV3TimeSeries": { + "description": "A collection of data points that describes the time-varying values of a metric. A time series is identified by a combination of a fully-specified monitored resource and a fully-specified metric. This type is used for both listing and creating time series.", + "id": "GoogleMonitoringV3TimeSeries", + "properties": { + "description": { + "description": "Input only. A detailed description of the time series that will be associated with the google.api.MetricDescriptor for the metric. Once set, this field cannot be changed through CreateTimeSeries.", + "type": "string" + }, + "metadata": { + "$ref": "GoogleApiMonitoredResourceMetadata", + "description": "Output only. The associated monitored resource metadata. When reading a time series, this field will include metadata labels that are explicitly named in the reduction. When creating a time series, this field is ignored." + }, + "metric": { + "$ref": "GoogleApiMetric", + "description": "The associated metric. A fully-specified metric used to identify the time series." + }, + "metricKind": { + "description": "The metric kind of the time series. When listing time series, this metric kind might be different from the metric kind of the associated metric if this time series is an alignment or reduction of other time series. When creating a time series, this field is optional. If present, it must be the same as the metric kind of the associated metric. If the associated metric's descriptor must be auto-created, then this field specifies the metric kind of the new descriptor and must be either `GAUGE` (the default) or `CUMULATIVE`.", + "enum": [ + "METRIC_KIND_UNSPECIFIED", + "GAUGE", + "DELTA", + "CUMULATIVE" + ], + "enumDescriptions": [ + "Do not use this default value.", + "An instantaneous measurement of a value.", + "The change in a value during a time interval.", + "A value accumulated over a time interval. Cumulative measurements in a time series should have the same start time and increasing end times, until an event resets the cumulative value to zero and sets a new start time for the following points." + ], + "type": "string" + }, + "points": { + "description": "The data points of this time series. When listing time series, points are returned in reverse time order. When creating a time series, this field must contain exactly one point and the point's type must be the same as the value type of the associated metric. If the associated metric's descriptor must be auto-created, then the value type of the descriptor is determined by the point's type, which must be `BOOL`, `INT64`, `DOUBLE`, or `DISTRIBUTION`.", + "items": { + "$ref": "GoogleMonitoringV3Point" + }, + "type": "array" + }, + "resource": { + "$ref": "GoogleApiMonitoredResource", + "description": "The associated monitored resource. Custom metrics can use only certain monitored resource types in their time series data. For more information, see [Monitored resources for custom metrics](https://cloud.google.com/monitoring/custom-metrics/creating-metrics#custom-metric-resources)." + }, + "unit": { + "description": "The units in which the metric value is reported. It is only applicable if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The `unit` defines the representation of the stored metric values. This field can only be changed through CreateTimeSeries when it is empty.", + "type": "string" + }, + "valueType": { + "description": "The value type of the time series. When listing time series, this value type might be different from the value type of the associated metric if this time series is an alignment or reduction of other time series. When creating a time series, this field is optional. If present, it must be the same as the type of the data in the `points` field.", + "enum": [ + "VALUE_TYPE_UNSPECIFIED", + "BOOL", + "INT64", + "DOUBLE", + "STRING", + "DISTRIBUTION", + "MONEY" + ], + "enumDescriptions": [ + "Do not use this default value.", + "The value is a boolean. This value type can be used only if the metric kind is `GAUGE`.", + "The value is a signed 64-bit integer.", + "The value is a double precision floating point number.", + "The value is a text string. This value type can be used only if the metric kind is `GAUGE`.", + "The value is a `Distribution`.", + "The value is money." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleMonitoringV3TypedValue": { "description": "A single strongly-typed value.", "id": "GoogleMonitoringV3TypedValue", diff --git a/discoveryengine/v1alpha/discoveryengine-gen.go b/discoveryengine/v1alpha/discoveryengine-gen.go index c74d8890be9..a66261ad647 100644 --- a/discoveryengine/v1alpha/discoveryengine-gen.go +++ b/discoveryengine/v1alpha/discoveryengine-gen.go @@ -268,6 +268,7 @@ type ProjectsLocationsCollectionsDataConnectorOperationsService struct { func NewProjectsLocationsCollectionsDataStoresService(s *Service) *ProjectsLocationsCollectionsDataStoresService { rs := &ProjectsLocationsCollectionsDataStoresService{s: s} rs.Branches = NewProjectsLocationsCollectionsDataStoresBranchesService(s) + rs.CompletionConfig = NewProjectsLocationsCollectionsDataStoresCompletionConfigService(s) rs.CompletionSuggestions = NewProjectsLocationsCollectionsDataStoresCompletionSuggestionsService(s) rs.Controls = NewProjectsLocationsCollectionsDataStoresControlsService(s) rs.Conversations = NewProjectsLocationsCollectionsDataStoresConversationsService(s) @@ -288,6 +289,8 @@ type ProjectsLocationsCollectionsDataStoresService struct { Branches *ProjectsLocationsCollectionsDataStoresBranchesService + CompletionConfig *ProjectsLocationsCollectionsDataStoresCompletionConfigService + CompletionSuggestions *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsService Controls *ProjectsLocationsCollectionsDataStoresControlsService @@ -358,6 +361,15 @@ type ProjectsLocationsCollectionsDataStoresBranchesOperationsService struct { s *Service } +func NewProjectsLocationsCollectionsDataStoresCompletionConfigService(s *Service) *ProjectsLocationsCollectionsDataStoresCompletionConfigService { + rs := &ProjectsLocationsCollectionsDataStoresCompletionConfigService{s: s} + return rs +} + +type ProjectsLocationsCollectionsDataStoresCompletionConfigService struct { + s *Service +} + func NewProjectsLocationsCollectionsDataStoresCompletionSuggestionsService(s *Service) *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsService { rs := &ProjectsLocationsCollectionsDataStoresCompletionSuggestionsService{s: s} return rs @@ -540,6 +552,7 @@ type ProjectsLocationsCollectionsDataStoresUserEventsService struct { func NewProjectsLocationsCollectionsEnginesService(s *Service) *ProjectsLocationsCollectionsEnginesService { rs := &ProjectsLocationsCollectionsEnginesService{s: s} + rs.CompletionConfig = NewProjectsLocationsCollectionsEnginesCompletionConfigService(s) rs.Controls = NewProjectsLocationsCollectionsEnginesControlsService(s) rs.Conversations = NewProjectsLocationsCollectionsEnginesConversationsService(s) rs.Operations = NewProjectsLocationsCollectionsEnginesOperationsService(s) @@ -551,6 +564,8 @@ func NewProjectsLocationsCollectionsEnginesService(s *Service) *ProjectsLocation type ProjectsLocationsCollectionsEnginesService struct { s *Service + CompletionConfig *ProjectsLocationsCollectionsEnginesCompletionConfigService + Controls *ProjectsLocationsCollectionsEnginesControlsService Conversations *ProjectsLocationsCollectionsEnginesConversationsService @@ -562,6 +577,15 @@ type ProjectsLocationsCollectionsEnginesService struct { Sessions *ProjectsLocationsCollectionsEnginesSessionsService } +func NewProjectsLocationsCollectionsEnginesCompletionConfigService(s *Service) *ProjectsLocationsCollectionsEnginesCompletionConfigService { + rs := &ProjectsLocationsCollectionsEnginesCompletionConfigService{s: s} + return rs +} + +type ProjectsLocationsCollectionsEnginesCompletionConfigService struct { + s *Service +} + func NewProjectsLocationsCollectionsEnginesControlsService(s *Service) *ProjectsLocationsCollectionsEnginesControlsService { rs := &ProjectsLocationsCollectionsEnginesControlsService{s: s} return rs @@ -631,6 +655,7 @@ type ProjectsLocationsCollectionsOperationsService struct { func NewProjectsLocationsDataStoresService(s *Service) *ProjectsLocationsDataStoresService { rs := &ProjectsLocationsDataStoresService{s: s} rs.Branches = NewProjectsLocationsDataStoresBranchesService(s) + rs.CompletionConfig = NewProjectsLocationsDataStoresCompletionConfigService(s) rs.CompletionSuggestions = NewProjectsLocationsDataStoresCompletionSuggestionsService(s) rs.Controls = NewProjectsLocationsDataStoresControlsService(s) rs.Conversations = NewProjectsLocationsDataStoresConversationsService(s) @@ -650,6 +675,8 @@ type ProjectsLocationsDataStoresService struct { Branches *ProjectsLocationsDataStoresBranchesService + CompletionConfig *ProjectsLocationsDataStoresCompletionConfigService + CompletionSuggestions *ProjectsLocationsDataStoresCompletionSuggestionsService Controls *ProjectsLocationsDataStoresControlsService @@ -718,6 +745,15 @@ type ProjectsLocationsDataStoresBranchesOperationsService struct { s *Service } +func NewProjectsLocationsDataStoresCompletionConfigService(s *Service) *ProjectsLocationsDataStoresCompletionConfigService { + rs := &ProjectsLocationsDataStoresCompletionConfigService{s: s} + return rs +} + +type ProjectsLocationsDataStoresCompletionConfigService struct { + s *Service +} + func NewProjectsLocationsDataStoresCompletionSuggestionsService(s *Service) *ProjectsLocationsDataStoresCompletionSuggestionsService { rs := &ProjectsLocationsDataStoresCompletionSuggestionsService{s: s} return rs @@ -1399,6 +1435,33 @@ func (s GoogleApiHttpBody) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleApiMetric: A specific metric, identified by specifying values for all +// of the labels of a `MetricDescriptor`. +type GoogleApiMetric struct { + // Labels: The set of label values that uniquely identify this metric. All + // labels listed in the `MetricDescriptor` must be assigned values. + Labels map[string]string `json:"labels,omitempty"` + // Type: An existing metric type, see google.api.MetricDescriptor. For example, + // `custom.googleapis.com/invoice/paid/amount`. + Type string `json:"type,omitempty"` + // ForceSendFields is a list of field names (e.g. "Labels") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Labels") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiMetric) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiMetric + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleApiMonitoredResource: An object representing a resource that can be // used for monitoring, logging, billing, or other purposes. Examples include // virtual machine instances, databases, and storage devices such as disks. The @@ -1439,6 +1502,40 @@ func (s GoogleApiMonitoredResource) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleApiMonitoredResourceMetadata: Auxiliary metadata for a +// MonitoredResource object. MonitoredResource objects contain the minimum set +// of information to uniquely identify a monitored resource instance. There is +// some other useful auxiliary metadata. Monitoring and Logging use an +// ingestion pipeline to extract metadata for cloud resources of all types, and +// store the metadata in this message. +type GoogleApiMonitoredResourceMetadata struct { + // SystemLabels: Output only. Values for predefined system metadata labels. + // System labels are a kind of metadata extracted by Google, including + // "machine_image", "vpc", "subnet_id", "security_group", "name", etc. System + // label values can be only strings, Boolean values, or a list of strings. For + // example: { "name": "my-test-instance", "security_group": ["a", "b", "c"], + // "spot_instance": false } + SystemLabels googleapi.RawMessage `json:"systemLabels,omitempty"` + // UserLabels: Output only. A map of user-defined metadata labels. + UserLabels map[string]string `json:"userLabels,omitempty"` + // ForceSendFields is a list of field names (e.g. "SystemLabels") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "SystemLabels") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiMonitoredResourceMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiMonitoredResourceMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineLoggingErrorContext: A description of the context // in which an error occurred. type GoogleCloudDiscoveryengineLoggingErrorContext struct { @@ -3772,6 +3869,320 @@ func (s GoogleCloudDiscoveryengineV1alphaAclConfig) MarshalJSON() ([]byte, error return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequest: Request +// message for CompletionService.AdvancedCompleteQuery method. . +type GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequest struct { + // BoostSpec: Optional. Specification to boost suggestions matching the + // condition. + BoostSpec *GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequestBoostSpec `json:"boostSpec,omitempty"` + // IncludeTailSuggestions: Indicates if tail suggestions should be returned if + // there are no suggestions that match the full query. Even if set to true, if + // there are suggestions that match the full query, those are returned and no + // tail suggestions are returned. + IncludeTailSuggestions bool `json:"includeTailSuggestions,omitempty"` + // Query: Required. The typeahead input used to fetch suggestions. Maximum + // length is 128 characters. The query can not be empty for most of the + // suggestion types. If it is empty, an `INVALID_ARGUMENT` error is returned. + // The exception is when the suggestion_types contains only the type + // `RECENT_SEARCH`, the query can be an empty string. The is called "zero + // prefix" feature, which returns user's recently searched queries given the + // empty query. + Query string `json:"query,omitempty"` + // QueryModel: Specifies the autocomplete data model. This overrides any model + // specified in the Configuration > Autocomplete section of the Cloud console. + // Currently supported values: * `document` - Using suggestions generated from + // user-imported documents. * `search-history` - Using suggestions generated + // from the past history of SearchService.Search API calls. Do not use it when + // there is no traffic for Search API. * `user-event` - Using suggestions + // generated from user-imported search events. * `document-completable` - Using + // suggestions taken directly from user-imported document fields marked as + // completable. Default values: * `document` is the default model for regular + // dataStores. * `search-history` is the default model for site search + // dataStores. + QueryModel string `json:"queryModel,omitempty"` + // SuggestionTypes: Optional. Suggestion types to return. If empty or + // unspecified, query suggestions are returned. Only one suggestion type is + // supported at the moment. + // + // Possible values: + // "SUGGESTION_TYPE_UNSPECIFIED" - Default value. + // "QUERY" - Returns query suggestions. + // "PEOPLE" - Returns people suggestions. + // "CONTENT" - Returns content suggestions. + // "RECENT_SEARCH" - Returns recent search suggestions. + // "GOOGLE_WORKSPACE" - Returns Google Workspace suggestions. + SuggestionTypes []string `json:"suggestionTypes,omitempty"` + // UserInfo: Optional. Information about the end user. This should be the same + // identifier information as UserEvent.user_info and SearchRequest.user_info. + UserInfo *GoogleCloudDiscoveryengineV1alphaUserInfo `json:"userInfo,omitempty"` + // UserPseudoId: A unique identifier for tracking visitors. For example, this + // could be implemented with an HTTP cookie, which should be able to uniquely + // identify a visitor on a single device. This unique identifier should not + // change if the visitor logs in or out of the website. This field should NOT + // have a fixed value such as `unknown_visitor`. This should be the same + // identifier as UserEvent.user_pseudo_id and SearchRequest.user_pseudo_id. The + // field must be a UTF-8 encoded string with a length limit of 128 + UserPseudoId string `json:"userPseudoId,omitempty"` + // ForceSendFields is a list of field names (e.g. "BoostSpec") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BoostSpec") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequestBoostSpec: +// Specification to boost suggestions based on the condtion of the suggestion. +type GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequestBoostSpec struct { + // ConditionBoostSpecs: Condition boost specifications. If a suggestion matches + // multiple conditions in the specifictions, boost values from these + // specifications are all applied and combined in a non-linear way. Maximum + // number of specifications is 20. Note: Currently only support language + // condition boost. + ConditionBoostSpecs []*GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequestBoostSpecConditionBoostSpec `json:"conditionBoostSpecs,omitempty"` + // ForceSendFields is a list of field names (e.g. "ConditionBoostSpecs") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ConditionBoostSpecs") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequestBoostSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequestBoostSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequestBoostSpecConditi +// onBoostSpec: Boost applies to suggestions which match a condition. +type GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequestBoostSpecConditionBoostSpec struct { + // Boost: Strength of the boost, which should be in [-1, 1]. Negative boost + // means demotion. Default is 0.0. Setting to 1.0 gives the suggestions a big + // promotion. However, it does not necessarily mean that the top result will be + // a boosted suggestion. Setting to -1.0 gives the suggestions a big demotion. + // However, other suggestions that are relevant might still be shown. Setting + // to 0.0 means no boost applied. The boosting condition is ignored. + Boost float64 `json:"boost,omitempty"` + // Condition: An expression which specifies a boost condition. The syntax is + // the same as filter expression syntax + // (https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata#filter-expression-syntax). + // Currently, the only supported condition is a list of BCP-47 lang codes. + // Example: * To boost suggestions in languages `en` or `fr`: `(lang_code: + // ANY("en", "fr"))` + Condition string `json:"condition,omitempty"` + // ForceSendFields is a list of field names (e.g. "Boost") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Boost") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequestBoostSpecConditionBoostSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequestBoostSpecConditionBoostSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequestBoostSpecConditionBoostSpec) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequestBoostSpecConditionBoostSpec + var s1 struct { + Boost gensupport.JSONFloat64 `json:"boost"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Boost = float64(s1.Boost) + return nil +} + +// GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponse: Response +// message for CompletionService.AdvancedCompleteQuery method. +type GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponse struct { + // ContentSuggestions: Results of the matched content suggestions. The result + // list is ordered and the first result is the top suggestion. + ContentSuggestions []*GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseContentSuggestion `json:"contentSuggestions,omitempty"` + // PeopleSuggestions: Results of the matched people suggestions. The result + // list is ordered and the first result is the top suggestion. + PeopleSuggestions []*GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponsePersonSuggestion `json:"peopleSuggestions,omitempty"` + // QuerySuggestions: Results of the matched query suggestions. The result list + // is ordered and the first result is a top suggestion. + QuerySuggestions []*GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseQuerySuggestion `json:"querySuggestions,omitempty"` + // RecentSearchSuggestions: Results of the matched "recent search" suggestions. + // The result list is ordered and the first result is the top suggestion. + RecentSearchSuggestions []*GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseRecentSearchSuggestion `json:"recentSearchSuggestions,omitempty"` + // TailMatchTriggered: True if the returned suggestions are all tail + // suggestions. For tail matching to be triggered, include_tail_suggestions in + // the request must be true and there must be no suggestions that match the + // full query. + TailMatchTriggered bool `json:"tailMatchTriggered,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "ContentSuggestions") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ContentSuggestions") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseContentSuggesti +// on: Suggestions as content. +type GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseContentSuggestion struct { + // ContentType: The type of the content suggestion. + // + // Possible values: + // "CONTENT_TYPE_UNSPECIFIED" - Default value. + // "GOOGLE_WORKSPACE" - The suggestion is from a Google Workspace source. + // "THIRD_PARTY" - The suggestion is from a third party source. + ContentType string `json:"contentType,omitempty"` + // DataStore: The name of the dataStore that this suggestion belongs to. + DataStore string `json:"dataStore,omitempty"` + // Document: The document data snippet in the suggestion. Only a subset of + // fields will be populated. + Document *GoogleCloudDiscoveryengineV1alphaDocument `json:"document,omitempty"` + // Suggestion: The suggestion for the query. + Suggestion string `json:"suggestion,omitempty"` + // ForceSendFields is a list of field names (e.g. "ContentType") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ContentType") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseContentSuggestion) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseContentSuggestion + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponsePersonSuggestio +// n: Suggestions as people. +type GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponsePersonSuggestion struct { + // DataStore: The name of the dataStore that this suggestion belongs to. + DataStore string `json:"dataStore,omitempty"` + // Document: The document data snippet in the suggestion. Only a subset of + // fields is populated. + Document *GoogleCloudDiscoveryengineV1alphaDocument `json:"document,omitempty"` + // PersonType: The type of the person. + // + // Possible values: + // "PERSON_TYPE_UNSPECIFIED" - Default value. + // "CLOUD_IDENTITY" - The suggestion is from a GOOGLE_IDENTITY source. + // "THIRD_PARTY_IDENTITY" - The suggestion is from a THIRD_PARTY_IDENTITY + // source. + PersonType string `json:"personType,omitempty"` + // Suggestion: The suggestion for the query. + Suggestion string `json:"suggestion,omitempty"` + // ForceSendFields is a list of field names (e.g. "DataStore") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "DataStore") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponsePersonSuggestion) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponsePersonSuggestion + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseQuerySuggestion +// : Suggestions as search queries. +type GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseQuerySuggestion struct { + // CompletableFieldPaths: The unique document field paths that serve as the + // source of this suggestion if it was generated from completable fields. This + // field is only populated for the document-completable model. + CompletableFieldPaths []string `json:"completableFieldPaths,omitempty"` + // DataStore: The name of the dataStore that this suggestion belongs to. + DataStore []string `json:"dataStore,omitempty"` + // Suggestion: The suggestion for the query. + Suggestion string `json:"suggestion,omitempty"` + // ForceSendFields is a list of field names (e.g. "CompletableFieldPaths") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CompletableFieldPaths") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseQuerySuggestion) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseQuerySuggestion + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseRecentSearchSug +// gestion: Suggestions from recent search history. +type GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseRecentSearchSuggestion struct { + // RecentSearchTime: The time when this recent rearch happened. + RecentSearchTime string `json:"recentSearchTime,omitempty"` + // Suggestion: The suggestion for the query. + Suggestion string `json:"suggestion,omitempty"` + // ForceSendFields is a list of field names (e.g. "RecentSearchTime") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "RecentSearchTime") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseRecentSearchSuggestion) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponseRecentSearchSuggestion + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaAdvancedSiteSearchConfig: Configuration // data for advance site search. type GoogleCloudDiscoveryengineV1alphaAdvancedSiteSearchConfig struct { @@ -3983,6 +4394,8 @@ type GoogleCloudDiscoveryengineV1alphaAnswerQueryRequest struct { // calling ConversationalSearchService.GetAnswer or // ConversationalSearchService.GetSession method. AsynchronousMode bool `json:"asynchronousMode,omitempty"` + // GroundingSpec: Optional. Grounding specification. + GroundingSpec *GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestGroundingSpec `json:"groundingSpec,omitempty"` // Query: Required. Current user query. Query *GoogleCloudDiscoveryengineV1alphaQuery `json:"query,omitempty"` // QueryUnderstandingSpec: Query understanding specification. @@ -4147,6 +4560,40 @@ func (s GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestAnswerGenerationSpecP return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestGroundingSpec: Grounding +// specification. +type GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestGroundingSpec struct { + // FilteringLevel: Optional. Specifies whether to enable the filtering based on + // grounding score and at what level. + // + // Possible values: + // "FILTERING_LEVEL_UNSPECIFIED" - Default is no filter + // "FILTERING_LEVEL_LOW" - Filter answers based on a low threshold. + // "FILTERING_LEVEL_HIGH" - Filter answers based on a high threshold. + FilteringLevel string `json:"filteringLevel,omitempty"` + // IncludeGroundingSupports: Optional. Specifies whether to include + // grounding_supports in the answer. The default value is `false`. When this + // field is set to `true`, returned answer will have `grounding_score` and will + // contain GroundingSupports for each claim. + IncludeGroundingSupports bool `json:"includeGroundingSupports,omitempty"` + // ForceSendFields is a list of field names (e.g. "FilteringLevel") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "FilteringLevel") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestGroundingSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestGroundingSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestQueryUnderstandingSpec: // Query understanding specification. type GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestQueryUnderstandingSpec struct { @@ -6670,6 +7117,29 @@ func (s GoogleCloudDiscoveryengineV1alphaConverseConversationResponse) MarshalJS return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries: The historical crawl +// rate timeseries data, used for monitoring. +type GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries struct { + // QpsTimeSeries: The QPS of the crawl rate. + QpsTimeSeries *GoogleMonitoringV3TimeSeries `json:"qpsTimeSeries,omitempty"` + // ForceSendFields is a list of field names (e.g. "QpsTimeSeries") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "QpsTimeSeries") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaCreateDataStoreMetadata: Metadata related // to the progress of the DataStoreService.CreateDataStore operation. This will // be returned by the google.longrunning.Operation.metadata field. @@ -7113,6 +7583,39 @@ func (s GoogleCloudDiscoveryengineV1alphaDataStoreServingConfigDataStore) Marsha return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries: The +// historical dedicated crawl rate timeseries data, used for monitoring. +// Dedicated crawl is used by Vertex AI to crawl the user's website when +// dedicate crawl is set. +type GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries struct { + // AutoRefreshCrawlRate: Vertex AI's dedicated crawl rate time series of + // auto-refresh, which is the crawl rate of Google-CloudVertexBot when dedicate + // crawl is set, and the crawl rate is for best effort use cases like + // refreshing urls periodically. + AutoRefreshCrawlRate *GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries `json:"autoRefreshCrawlRate,omitempty"` + // UserTriggeredCrawlRate: Vertex AI's dedicated crawl rate time series of user + // triggered crawl, which is the crawl rate of Google-CloudVertexBot when + // dedicate crawl is set, and user triggered crawl rate is for deterministic + // use cases like crawling urls or sitemaps specified by users. + UserTriggeredCrawlRate *GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries `json:"userTriggeredCrawlRate,omitempty"` + // ForceSendFields is a list of field names (e.g. "AutoRefreshCrawlRate") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AutoRefreshCrawlRate") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaDeleteDataStoreMetadata: Metadata related // to the progress of the DataStoreService.DeleteDataStore operation. This will // be returned by the google.longrunning.Operation.metadata field. @@ -10181,6 +10684,79 @@ func (s GoogleCloudDiscoveryengineV1alphaNaturalLanguageQueryUnderstandingConfig return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse: Response message +// for CrawlRateManagementService.ObtainCrawlRate method. The response contains +// organcic or dedicated crawl rate time series data for monitoring, depending +// on whether dedicated crawl rate is set. +type GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse struct { + // DedicatedCrawlRateTimeSeries: The historical dedicated crawl rate timeseries + // data, used for monitoring. + DedicatedCrawlRateTimeSeries *GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries `json:"dedicatedCrawlRateTimeSeries,omitempty"` + // Error: Errors from service when handling the request. + Error *GoogleRpcStatus `json:"error,omitempty"` + // OrganicCrawlRateTimeSeries: The historical organic crawl rate timeseries + // data, used for monitoring. + OrganicCrawlRateTimeSeries *GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries `json:"organicCrawlRateTimeSeries,omitempty"` + // State: Output only. The state of the response. + // + // Possible values: + // "STATE_UNSPECIFIED" - The state is unspecified. + // "SUCCEEDED" - The state is successful. + // "FAILED" - The state is failed. + State string `json:"state,omitempty"` + // ForceSendFields is a list of field names (e.g. + // "DedicatedCrawlRateTimeSeries") to unconditionally include in API requests. + // By default, fields with empty or default values are omitted from API + // requests. See https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields + // for more details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "DedicatedCrawlRateTimeSeries") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries: The historical +// organic crawl rate timeseries data, used for monitoring. Organic crawl is +// auto-determined by Google to crawl the user's website when dedicate crawl is +// not set. Crawl rate is the QPS of crawl request Google sends to the user's +// website. +type GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries struct { + // GoogleOrganicCrawlRate: Google's organic crawl rate time series, which is + // the sum of all googlebots' crawl rate. Please refer to + // https://developers.google.com/search/docs/crawling-indexing/overview-google-crawlers + // for more details about googlebots. + GoogleOrganicCrawlRate *GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries `json:"googleOrganicCrawlRate,omitempty"` + // VertexAiOrganicCrawlRate: Vertex AI's organic crawl rate time series, which + // is the crawl rate of Google-CloudVertexBot when dedicate crawl is not set. + // Please refer to + // https://developers.google.com/search/docs/crawling-indexing/google-common-crawlers#google-cloudvertexbot + // for more details about Google-CloudVertexBot. + VertexAiOrganicCrawlRate *GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries `json:"vertexAiOrganicCrawlRate,omitempty"` + // ForceSendFields is a list of field names (e.g. "GoogleOrganicCrawlRate") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "GoogleOrganicCrawlRate") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaPageInfo: Detailed page information. type GoogleCloudDiscoveryengineV1alphaPageInfo struct { // PageCategory: The most specific category associated with a category page. To @@ -14920,11 +15496,12 @@ type GoogleCloudDiscoveryengineV1alphaUserEvent struct { // `search`: Search for Documents. * `view-item`: Detailed page view of a // Document. * `view-item-list`: View of a panel or ordered list of Documents. // * `view-home-page`: View of the home page. * `view-category-page`: View of a - // category page, e.g. Home > Men > Jeans Retail-related values: * - // `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping * - // `purchase`: Purchase an item(s) Media-related values: * `media-play`: - // Start/resume watching a video, playing a song, etc. * `media-complete`: - // Finished or stopped midway through a video, song, etc. + // category page, e.g. Home > Men > Jeans * `add-feedback`: Add a user + // feedback. Retail-related values: * `add-to-cart`: Add an item(s) to cart, + // e.g. in Retail online shopping * `purchase`: Purchase an item(s) + // Media-related values: * `media-play`: Start/resume watching a video, playing + // a song, etc. * `media-complete`: Finished or stopped midway through a video, + // song, etc. EventType string `json:"eventType,omitempty"` // Filter: The filter syntax consists of an expression language for // constructing a predicate from one or more fields of the documents being @@ -18907,6 +19484,153 @@ func (s GoogleLongrunningOperation) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleMonitoringV3Point: A single data point in a time series. +type GoogleMonitoringV3Point struct { + // Interval: The time interval to which the data point applies. For `GAUGE` + // metrics, the start time is optional, but if it is supplied, it must equal + // the end time. For `DELTA` metrics, the start and end time should specify a + // non-zero interval, with subsequent points specifying contiguous and + // non-overlapping intervals. For `CUMULATIVE` metrics, the start and end time + // should specify a non-zero interval, with subsequent points specifying the + // same start time and increasing end times, until an event resets the + // cumulative value to zero and sets a new start time for the following points. + Interval *GoogleMonitoringV3TimeInterval `json:"interval,omitempty"` + // Value: The value of the data point. + Value *GoogleMonitoringV3TypedValue `json:"value,omitempty"` + // ForceSendFields is a list of field names (e.g. "Interval") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Interval") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleMonitoringV3Point) MarshalJSON() ([]byte, error) { + type NoMethod GoogleMonitoringV3Point + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleMonitoringV3TimeInterval: A time interval extending just after a start +// time through an end time. If the start time is the same as the end time, +// then the interval represents a single point in time. +type GoogleMonitoringV3TimeInterval struct { + // EndTime: Required. The end of the time interval. + EndTime string `json:"endTime,omitempty"` + // StartTime: Optional. The beginning of the time interval. The default value + // for the start time is the end time. The start time must not be later than + // the end time. + StartTime string `json:"startTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "EndTime") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "EndTime") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleMonitoringV3TimeInterval) MarshalJSON() ([]byte, error) { + type NoMethod GoogleMonitoringV3TimeInterval + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleMonitoringV3TimeSeries: A collection of data points that describes the +// time-varying values of a metric. A time series is identified by a +// combination of a fully-specified monitored resource and a fully-specified +// metric. This type is used for both listing and creating time series. +type GoogleMonitoringV3TimeSeries struct { + // Description: Input only. A detailed description of the time series that will + // be associated with the google.api.MetricDescriptor for the metric. Once set, + // this field cannot be changed through CreateTimeSeries. + Description string `json:"description,omitempty"` + // Metadata: Output only. The associated monitored resource metadata. When + // reading a time series, this field will include metadata labels that are + // explicitly named in the reduction. When creating a time series, this field + // is ignored. + Metadata *GoogleApiMonitoredResourceMetadata `json:"metadata,omitempty"` + // Metric: The associated metric. A fully-specified metric used to identify the + // time series. + Metric *GoogleApiMetric `json:"metric,omitempty"` + // MetricKind: The metric kind of the time series. When listing time series, + // this metric kind might be different from the metric kind of the associated + // metric if this time series is an alignment or reduction of other time + // series. When creating a time series, this field is optional. If present, it + // must be the same as the metric kind of the associated metric. If the + // associated metric's descriptor must be auto-created, then this field + // specifies the metric kind of the new descriptor and must be either `GAUGE` + // (the default) or `CUMULATIVE`. + // + // Possible values: + // "METRIC_KIND_UNSPECIFIED" - Do not use this default value. + // "GAUGE" - An instantaneous measurement of a value. + // "DELTA" - The change in a value during a time interval. + // "CUMULATIVE" - A value accumulated over a time interval. Cumulative + // measurements in a time series should have the same start time and increasing + // end times, until an event resets the cumulative value to zero and sets a new + // start time for the following points. + MetricKind string `json:"metricKind,omitempty"` + // Points: The data points of this time series. When listing time series, + // points are returned in reverse time order. When creating a time series, this + // field must contain exactly one point and the point's type must be the same + // as the value type of the associated metric. If the associated metric's + // descriptor must be auto-created, then the value type of the descriptor is + // determined by the point's type, which must be `BOOL`, `INT64`, `DOUBLE`, or + // `DISTRIBUTION`. + Points []*GoogleMonitoringV3Point `json:"points,omitempty"` + // Resource: The associated monitored resource. Custom metrics can use only + // certain monitored resource types in their time series data. For more + // information, see Monitored resources for custom metrics + // (https://cloud.google.com/monitoring/custom-metrics/creating-metrics#custom-metric-resources). + Resource *GoogleApiMonitoredResource `json:"resource,omitempty"` + // Unit: The units in which the metric value is reported. It is only applicable + // if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The `unit` + // defines the representation of the stored metric values. This field can only + // be changed through CreateTimeSeries when it is empty. + Unit string `json:"unit,omitempty"` + // ValueType: The value type of the time series. When listing time series, this + // value type might be different from the value type of the associated metric + // if this time series is an alignment or reduction of other time series. When + // creating a time series, this field is optional. If present, it must be the + // same as the type of the data in the `points` field. + // + // Possible values: + // "VALUE_TYPE_UNSPECIFIED" - Do not use this default value. + // "BOOL" - The value is a boolean. This value type can be used only if the + // metric kind is `GAUGE`. + // "INT64" - The value is a signed 64-bit integer. + // "DOUBLE" - The value is a double precision floating point number. + // "STRING" - The value is a text string. This value type can be used only if + // the metric kind is `GAUGE`. + // "DISTRIBUTION" - The value is a `Distribution`. + // "MONEY" - The value is money. + ValueType string `json:"valueType,omitempty"` + // ForceSendFields is a list of field names (e.g. "Description") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Description") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleMonitoringV3TimeSeries) MarshalJSON() ([]byte, error) { + type NoMethod GoogleMonitoringV3TimeSeries + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleMonitoringV3TypedValue: A single strongly-typed value. type GoogleMonitoringV3TypedValue struct { // BoolValue: A Boolean value: `true` or `false`. @@ -23524,6 +24248,113 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) Pages } } +type ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall struct { + s *Service + completionConfig string + googleclouddiscoveryenginev1alphaadvancedcompletequeryrequest *GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// CompleteQuery: Completes the user input with advanced keyword suggestions. +// +// - completionConfig: The completion_config of the parent dataStore or engine +// resource name for which the completion is performed, such as +// `projects/*/locations/global/collections/default_collection/dataStores/*/co +// mpletionConfig` +// `projects/*/locations/global/collections/default_collection/engines/*/compl +// etionConfig`. +func (r *ProjectsLocationsCollectionsDataStoresCompletionConfigService) CompleteQuery(completionConfig string, googleclouddiscoveryenginev1alphaadvancedcompletequeryrequest *GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequest) *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall { + c := &ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.completionConfig = completionConfig + c.googleclouddiscoveryenginev1alphaadvancedcompletequeryrequest = googleclouddiscoveryenginev1alphaadvancedcompletequeryrequest + 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 *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall { + 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 *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall) 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.googleclouddiscoveryenginev1alphaadvancedcompletequeryrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+completionConfig}:completeQuery") + 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{ + "completionConfig": c.completionConfig, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.collections.dataStores.completionConfig.completeQuery" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponse.ServerRespons +// e.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 *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponse, 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 := &GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponse{ + 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 ProjectsLocationsCollectionsDataStoresCompletionSuggestionsImportCall struct { s *Service parent string @@ -27218,6 +28049,142 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchCall) Pages(c } } +type ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall struct { + s *Service + servingConfig string + googleclouddiscoveryenginev1alphasearchrequest *GoogleCloudDiscoveryengineV1alphaSearchRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SearchLite: Performs a search. Similar to the SearchService.Search method, +// but a lite version that allows API key for authentication, where OAuth and +// IAM checks are not required. Only public website search is supported by this +// method. If data stores and engines not associated with public website search +// are specified, a `FAILED_PRECONDITION` error is returned. This method can be +// used for easy onboarding without having to implement an authentication +// backend. However, it is strongly recommended to use SearchService.Search +// instead with required OAuth and IAM checks to provide better data security. +// +// - servingConfig: The resource name of the Search serving config, such as +// `projects/*/locations/global/collections/default_collection/engines/*/servi +// ngConfigs/default_serving_config`, or +// `projects/*/locations/global/collections/default_collection/dataStores/defa +// ult_data_store/servingConfigs/default_serving_config`. This field is used +// to identify the serving configuration name, set of models used to make the +// search. +func (r *ProjectsLocationsCollectionsDataStoresServingConfigsService) SearchLite(servingConfig string, googleclouddiscoveryenginev1alphasearchrequest *GoogleCloudDiscoveryengineV1alphaSearchRequest) *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall { + c := &ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.servingConfig = servingConfig + c.googleclouddiscoveryenginev1alphasearchrequest = googleclouddiscoveryenginev1alphasearchrequest + 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 *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall { + 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 *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) 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.googleclouddiscoveryenginev1alphasearchrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+servingConfig}:searchLite") + 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{ + "servingConfig": c.servingConfig, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.collections.dataStores.servingConfigs.searchLite" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1alphaSearchResponse.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 *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1alphaSearchResponse, 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 := &GoogleCloudDiscoveryengineV1alphaSearchResponse{ + 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 *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1alphaSearchResponse) error) error { + c.ctx_ = ctx + defer func(pt string) { c.googleclouddiscoveryenginev1alphasearchrequest.PageToken = pt }(c.googleclouddiscoveryenginev1alphasearchrequest.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.googleclouddiscoveryenginev1alphasearchrequest.PageToken = x.NextPageToken + } +} + type ProjectsLocationsCollectionsDataStoresSessionsCreateCall struct { s *Service parent string @@ -31483,6 +32450,113 @@ func (c *ProjectsLocationsCollectionsEnginesTuneCall) Do(opts ...googleapi.CallO return ret, nil } +type ProjectsLocationsCollectionsEnginesCompletionConfigCompleteQueryCall struct { + s *Service + completionConfig string + googleclouddiscoveryenginev1alphaadvancedcompletequeryrequest *GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// CompleteQuery: Completes the user input with advanced keyword suggestions. +// +// - completionConfig: The completion_config of the parent dataStore or engine +// resource name for which the completion is performed, such as +// `projects/*/locations/global/collections/default_collection/dataStores/*/co +// mpletionConfig` +// `projects/*/locations/global/collections/default_collection/engines/*/compl +// etionConfig`. +func (r *ProjectsLocationsCollectionsEnginesCompletionConfigService) CompleteQuery(completionConfig string, googleclouddiscoveryenginev1alphaadvancedcompletequeryrequest *GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequest) *ProjectsLocationsCollectionsEnginesCompletionConfigCompleteQueryCall { + c := &ProjectsLocationsCollectionsEnginesCompletionConfigCompleteQueryCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.completionConfig = completionConfig + c.googleclouddiscoveryenginev1alphaadvancedcompletequeryrequest = googleclouddiscoveryenginev1alphaadvancedcompletequeryrequest + 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 *ProjectsLocationsCollectionsEnginesCompletionConfigCompleteQueryCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesCompletionConfigCompleteQueryCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsCollectionsEnginesCompletionConfigCompleteQueryCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesCompletionConfigCompleteQueryCall { + 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 *ProjectsLocationsCollectionsEnginesCompletionConfigCompleteQueryCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsEnginesCompletionConfigCompleteQueryCall) 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.googleclouddiscoveryenginev1alphaadvancedcompletequeryrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+completionConfig}:completeQuery") + 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{ + "completionConfig": c.completionConfig, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.collections.engines.completionConfig.completeQuery" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponse.ServerRespons +// e.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 *ProjectsLocationsCollectionsEnginesCompletionConfigCompleteQueryCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponse, 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 := &GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponse{ + 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 ProjectsLocationsCollectionsEnginesControlsCreateCall struct { s *Service parent string @@ -33755,6 +34829,142 @@ func (c *ProjectsLocationsCollectionsEnginesServingConfigsSearchCall) Pages(ctx } } +type ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall struct { + s *Service + servingConfig string + googleclouddiscoveryenginev1alphasearchrequest *GoogleCloudDiscoveryengineV1alphaSearchRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SearchLite: Performs a search. Similar to the SearchService.Search method, +// but a lite version that allows API key for authentication, where OAuth and +// IAM checks are not required. Only public website search is supported by this +// method. If data stores and engines not associated with public website search +// are specified, a `FAILED_PRECONDITION` error is returned. This method can be +// used for easy onboarding without having to implement an authentication +// backend. However, it is strongly recommended to use SearchService.Search +// instead with required OAuth and IAM checks to provide better data security. +// +// - servingConfig: The resource name of the Search serving config, such as +// `projects/*/locations/global/collections/default_collection/engines/*/servi +// ngConfigs/default_serving_config`, or +// `projects/*/locations/global/collections/default_collection/dataStores/defa +// ult_data_store/servingConfigs/default_serving_config`. This field is used +// to identify the serving configuration name, set of models used to make the +// search. +func (r *ProjectsLocationsCollectionsEnginesServingConfigsService) SearchLite(servingConfig string, googleclouddiscoveryenginev1alphasearchrequest *GoogleCloudDiscoveryengineV1alphaSearchRequest) *ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall { + c := &ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.servingConfig = servingConfig + c.googleclouddiscoveryenginev1alphasearchrequest = googleclouddiscoveryenginev1alphasearchrequest + 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 *ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall { + 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 *ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall) 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.googleclouddiscoveryenginev1alphasearchrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+servingConfig}:searchLite") + 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{ + "servingConfig": c.servingConfig, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.collections.engines.servingConfigs.searchLite" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1alphaSearchResponse.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 *ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1alphaSearchResponse, 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 := &GoogleCloudDiscoveryengineV1alphaSearchResponse{ + 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 *ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1alphaSearchResponse) error) error { + c.ctx_ = ctx + defer func(pt string) { c.googleclouddiscoveryenginev1alphasearchrequest.PageToken = pt }(c.googleclouddiscoveryenginev1alphasearchrequest.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.googleclouddiscoveryenginev1alphasearchrequest.PageToken = x.NextPageToken + } +} + type ProjectsLocationsCollectionsEnginesSessionsCreateCall struct { s *Service parent string @@ -37587,6 +38797,113 @@ func (c *ProjectsLocationsDataStoresBranchesOperationsListCall) Pages(ctx contex } } +type ProjectsLocationsDataStoresCompletionConfigCompleteQueryCall struct { + s *Service + completionConfig string + googleclouddiscoveryenginev1alphaadvancedcompletequeryrequest *GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// CompleteQuery: Completes the user input with advanced keyword suggestions. +// +// - completionConfig: The completion_config of the parent dataStore or engine +// resource name for which the completion is performed, such as +// `projects/*/locations/global/collections/default_collection/dataStores/*/co +// mpletionConfig` +// `projects/*/locations/global/collections/default_collection/engines/*/compl +// etionConfig`. +func (r *ProjectsLocationsDataStoresCompletionConfigService) CompleteQuery(completionConfig string, googleclouddiscoveryenginev1alphaadvancedcompletequeryrequest *GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryRequest) *ProjectsLocationsDataStoresCompletionConfigCompleteQueryCall { + c := &ProjectsLocationsDataStoresCompletionConfigCompleteQueryCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.completionConfig = completionConfig + c.googleclouddiscoveryenginev1alphaadvancedcompletequeryrequest = googleclouddiscoveryenginev1alphaadvancedcompletequeryrequest + 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 *ProjectsLocationsDataStoresCompletionConfigCompleteQueryCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataStoresCompletionConfigCompleteQueryCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsDataStoresCompletionConfigCompleteQueryCall) Context(ctx context.Context) *ProjectsLocationsDataStoresCompletionConfigCompleteQueryCall { + 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 *ProjectsLocationsDataStoresCompletionConfigCompleteQueryCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsDataStoresCompletionConfigCompleteQueryCall) 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.googleclouddiscoveryenginev1alphaadvancedcompletequeryrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+completionConfig}:completeQuery") + 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{ + "completionConfig": c.completionConfig, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.dataStores.completionConfig.completeQuery" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponse.ServerRespons +// e.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 *ProjectsLocationsDataStoresCompletionConfigCompleteQueryCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponse, 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 := &GoogleCloudDiscoveryengineV1alphaAdvancedCompleteQueryResponse{ + 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 ProjectsLocationsDataStoresCompletionSuggestionsImportCall struct { s *Service parent string @@ -40910,6 +42227,142 @@ func (c *ProjectsLocationsDataStoresServingConfigsSearchCall) Pages(ctx context. } } +type ProjectsLocationsDataStoresServingConfigsSearchLiteCall struct { + s *Service + servingConfig string + googleclouddiscoveryenginev1alphasearchrequest *GoogleCloudDiscoveryengineV1alphaSearchRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SearchLite: Performs a search. Similar to the SearchService.Search method, +// but a lite version that allows API key for authentication, where OAuth and +// IAM checks are not required. Only public website search is supported by this +// method. If data stores and engines not associated with public website search +// are specified, a `FAILED_PRECONDITION` error is returned. This method can be +// used for easy onboarding without having to implement an authentication +// backend. However, it is strongly recommended to use SearchService.Search +// instead with required OAuth and IAM checks to provide better data security. +// +// - servingConfig: The resource name of the Search serving config, such as +// `projects/*/locations/global/collections/default_collection/engines/*/servi +// ngConfigs/default_serving_config`, or +// `projects/*/locations/global/collections/default_collection/dataStores/defa +// ult_data_store/servingConfigs/default_serving_config`. This field is used +// to identify the serving configuration name, set of models used to make the +// search. +func (r *ProjectsLocationsDataStoresServingConfigsService) SearchLite(servingConfig string, googleclouddiscoveryenginev1alphasearchrequest *GoogleCloudDiscoveryengineV1alphaSearchRequest) *ProjectsLocationsDataStoresServingConfigsSearchLiteCall { + c := &ProjectsLocationsDataStoresServingConfigsSearchLiteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.servingConfig = servingConfig + c.googleclouddiscoveryenginev1alphasearchrequest = googleclouddiscoveryenginev1alphasearchrequest + 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 *ProjectsLocationsDataStoresServingConfigsSearchLiteCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataStoresServingConfigsSearchLiteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsDataStoresServingConfigsSearchLiteCall) Context(ctx context.Context) *ProjectsLocationsDataStoresServingConfigsSearchLiteCall { + 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 *ProjectsLocationsDataStoresServingConfigsSearchLiteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsDataStoresServingConfigsSearchLiteCall) 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.googleclouddiscoveryenginev1alphasearchrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+servingConfig}:searchLite") + 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{ + "servingConfig": c.servingConfig, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.dataStores.servingConfigs.searchLite" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1alphaSearchResponse.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 *ProjectsLocationsDataStoresServingConfigsSearchLiteCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1alphaSearchResponse, 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 := &GoogleCloudDiscoveryengineV1alphaSearchResponse{ + 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 *ProjectsLocationsDataStoresServingConfigsSearchLiteCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1alphaSearchResponse) error) error { + c.ctx_ = ctx + defer func(pt string) { c.googleclouddiscoveryenginev1alphasearchrequest.PageToken = pt }(c.googleclouddiscoveryenginev1alphasearchrequest.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.googleclouddiscoveryenginev1alphasearchrequest.PageToken = x.NextPageToken + } +} + type ProjectsLocationsDataStoresSessionsCreateCall struct { s *Service parent string diff --git a/discoveryengine/v1beta/discoveryengine-api.json b/discoveryengine/v1beta/discoveryengine-api.json index ed86018fef0..41fd937730e 100644 --- a/discoveryengine/v1beta/discoveryengine-api.json +++ b/discoveryengine/v1beta/discoveryengine-api.json @@ -854,6 +854,38 @@ } } }, + "completionConfig": { + "methods": { + "completeQuery": { + "description": "Completes the user input with advanced keyword suggestions.", + "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/completionConfig:completeQuery", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.collections.dataStores.completionConfig.completeQuery", + "parameterOrder": [ + "completionConfig" + ], + "parameters": { + "completionConfig": { + "description": "Required. The completion_config of the parent dataStore or engine resource name for which the completion is performed, such as `projects/*/locations/global/collections/default_collection/dataStores/*/completionConfig` `projects/*/locations/global/collections/default_collection/engines/*/completionConfig`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/completionConfig$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+completionConfig}:completeQuery", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "completionSuggestions": { "methods": { "import": { @@ -1847,6 +1879,34 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "searchLite": { + "description": "Performs a search. Similar to the SearchService.Search method, but a lite version that allows API key for authentication, where OAuth and IAM checks are not required. Only public website search is supported by this method. If data stores and engines not associated with public website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used for easy onboarding without having to implement an authentication backend. However, it is strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to provide better data security.", + "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/servingConfigs/{servingConfigsId}:searchLite", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.collections.dataStores.servingConfigs.searchLite", + "parameterOrder": [ + "servingConfig" + ], + "parameters": { + "servingConfig": { + "description": "Required. The resource name of the Search serving config, such as `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, or `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. This field is used to identify the serving configuration name, set of models used to make the search.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/servingConfigs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+servingConfig}:searchLite", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1betaSearchResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } }, @@ -2955,6 +3015,38 @@ } }, "resources": { + "completionConfig": { + "methods": { + "completeQuery": { + "description": "Completes the user input with advanced keyword suggestions.", + "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/completionConfig:completeQuery", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.collections.engines.completionConfig.completeQuery", + "parameterOrder": [ + "completionConfig" + ], + "parameters": { + "completionConfig": { + "description": "Required. The completion_config of the parent dataStore or engine resource name for which the completion is performed, such as `projects/*/locations/global/collections/default_collection/dataStores/*/completionConfig` `projects/*/locations/global/collections/default_collection/engines/*/completionConfig`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/completionConfig$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+completionConfig}:completeQuery", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "controls": { "methods": { "create": { @@ -3557,6 +3649,34 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "searchLite": { + "description": "Performs a search. Similar to the SearchService.Search method, but a lite version that allows API key for authentication, where OAuth and IAM checks are not required. Only public website search is supported by this method. If data stores and engines not associated with public website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used for easy onboarding without having to implement an authentication backend. However, it is strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to provide better data security.", + "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/servingConfigs/{servingConfigsId}:searchLite", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.collections.engines.servingConfigs.searchLite", + "parameterOrder": [ + "servingConfig" + ], + "parameters": { + "servingConfig": { + "description": "Required. The resource name of the Search serving config, such as `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, or `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. This field is used to identify the serving configuration name, set of models used to make the search.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/servingConfigs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+servingConfig}:searchLite", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1betaSearchResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } }, @@ -4438,6 +4558,38 @@ } } }, + "completionConfig": { + "methods": { + "completeQuery": { + "description": "Completes the user input with advanced keyword suggestions.", + "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/completionConfig:completeQuery", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.dataStores.completionConfig.completeQuery", + "parameterOrder": [ + "completionConfig" + ], + "parameters": { + "completionConfig": { + "description": "Required. The completion_config of the parent dataStore or engine resource name for which the completion is performed, such as `projects/*/locations/global/collections/default_collection/dataStores/*/completionConfig` `projects/*/locations/global/collections/default_collection/engines/*/completionConfig`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/completionConfig$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+completionConfig}:completeQuery", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "completionSuggestions": { "methods": { "import": { @@ -5330,6 +5482,34 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "searchLite": { + "description": "Performs a search. Similar to the SearchService.Search method, but a lite version that allows API key for authentication, where OAuth and IAM checks are not required. Only public website search is supported by this method. If data stores and engines not associated with public website search are specified, a `FAILED_PRECONDITION` error is returned. This method can be used for easy onboarding without having to implement an authentication backend. However, it is strongly recommended to use SearchService.Search instead with required OAuth and IAM checks to provide better data security.", + "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/servingConfigs/{servingConfigsId}:searchLite", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.dataStores.servingConfigs.searchLite", + "parameterOrder": [ + "servingConfig" + ], + "parameters": { + "servingConfig": { + "description": "Required. The resource name of the Search serving config, such as `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`, or `projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`. This field is used to identify the serving configuration name, set of models used to make the search.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/servingConfigs/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+servingConfig}:searchLite", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1betaSearchResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } }, @@ -6880,9 +7060,177 @@ } } }, - "revision": "20241020", + "revision": "20241025", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { + "GoogleApiDistribution": { + "description": "`Distribution` contains summary statistics for a population of values. It optionally contains a histogram representing the distribution of those values across a set of buckets. The summary statistics are the count, mean, sum of the squared deviation from the mean, the minimum, and the maximum of the set of population of values. The histogram is based on a sequence of buckets and gives a count of values that fall into each bucket. The boundaries of the buckets are given either explicitly or by formulas for buckets of fixed or exponentially increasing widths. Although it is not forbidden, it is generally a bad idea to include non-finite values (infinities or NaNs) in the population of values, as this will render the `mean` and `sum_of_squared_deviation` fields meaningless.", + "id": "GoogleApiDistribution", + "properties": { + "bucketCounts": { + "description": "The number of values in each bucket of the histogram, as described in `bucket_options`. If the distribution does not have a histogram, then omit this field. If there is a histogram, then the sum of the values in `bucket_counts` must equal the value in the `count` field of the distribution. If present, `bucket_counts` should contain N values, where N is the number of buckets specified in `bucket_options`. If you supply fewer than N values, the remaining values are assumed to be 0. The order of the values in `bucket_counts` follows the bucket numbering schemes described for the three bucket types. The first value must be the count for the underflow bucket (number 0). The next N-2 values are the counts for the finite buckets (number 1 through N-2). The N'th value in `bucket_counts` is the count for the overflow bucket (number N-1).", + "items": { + "format": "int64", + "type": "string" + }, + "type": "array" + }, + "bucketOptions": { + "$ref": "GoogleApiDistributionBucketOptions", + "description": "Defines the histogram bucket boundaries. If the distribution does not contain a histogram, then omit this field." + }, + "count": { + "description": "The number of values in the population. Must be non-negative. This value must equal the sum of the values in `bucket_counts` if a histogram is provided.", + "format": "int64", + "type": "string" + }, + "exemplars": { + "description": "Must be in increasing order of `value` field.", + "items": { + "$ref": "GoogleApiDistributionExemplar" + }, + "type": "array" + }, + "mean": { + "description": "The arithmetic mean of the values in the population. If `count` is zero then this field must be zero.", + "format": "double", + "type": "number" + }, + "range": { + "$ref": "GoogleApiDistributionRange", + "description": "If specified, contains the range of the population values. The field must not be present if the `count` is zero." + }, + "sumOfSquaredDeviation": { + "description": "The sum of squared deviations from the mean of the values in the population. For values x_i this is: Sum[i=1..n]((x_i - mean)^2) Knuth, \"The Art of Computer Programming\", Vol. 2, page 232, 3rd edition describes Welford's method for accumulating this sum in one pass. If `count` is zero then this field must be zero.", + "format": "double", + "type": "number" + } + }, + "type": "object" + }, + "GoogleApiDistributionBucketOptions": { + "description": "`BucketOptions` describes the bucket boundaries used to create a histogram for the distribution. The buckets can be in a linear sequence, an exponential sequence, or each bucket can be specified explicitly. `BucketOptions` does not include the number of values in each bucket. A bucket has an inclusive lower bound and exclusive upper bound for the values that are counted for that bucket. The upper bound of a bucket must be strictly greater than the lower bound. The sequence of N buckets for a distribution consists of an underflow bucket (number 0), zero or more finite buckets (number 1 through N - 2) and an overflow bucket (number N - 1). The buckets are contiguous: the lower bound of bucket i (i \u003e 0) is the same as the upper bound of bucket i - 1. The buckets span the whole range of finite values: lower bound of the underflow bucket is -infinity and the upper bound of the overflow bucket is +infinity. The finite buckets are so-called because both bounds are finite.", + "id": "GoogleApiDistributionBucketOptions", + "properties": { + "explicitBuckets": { + "$ref": "GoogleApiDistributionBucketOptionsExplicit", + "description": "The explicit buckets." + }, + "exponentialBuckets": { + "$ref": "GoogleApiDistributionBucketOptionsExponential", + "description": "The exponential buckets." + }, + "linearBuckets": { + "$ref": "GoogleApiDistributionBucketOptionsLinear", + "description": "The linear bucket." + } + }, + "type": "object" + }, + "GoogleApiDistributionBucketOptionsExplicit": { + "description": "Specifies a set of buckets with arbitrary widths. There are `size(bounds) + 1` (= N) buckets. Bucket `i` has the following boundaries: Upper bound (0 \u003c= i \u003c N-1): bounds[i] Lower bound (1 \u003c= i \u003c N); bounds[i - 1] The `bounds` field must contain at least one element. If `bounds` has only one element, then there are no finite buckets, and that single element is the common boundary of the overflow and underflow buckets.", + "id": "GoogleApiDistributionBucketOptionsExplicit", + "properties": { + "bounds": { + "description": "The values must be monotonically increasing.", + "items": { + "format": "double", + "type": "number" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleApiDistributionBucketOptionsExponential": { + "description": "Specifies an exponential sequence of buckets that have a width that is proportional to the value of the lower bound. Each bucket represents a constant relative uncertainty on a specific value in the bucket. There are `num_finite_buckets + 2` (= N) buckets. Bucket `i` has the following boundaries: Upper bound (0 \u003c= i \u003c N-1): scale * (growth_factor ^ i). Lower bound (1 \u003c= i \u003c N): scale * (growth_factor ^ (i - 1)).", + "id": "GoogleApiDistributionBucketOptionsExponential", + "properties": { + "growthFactor": { + "description": "Must be greater than 1.", + "format": "double", + "type": "number" + }, + "numFiniteBuckets": { + "description": "Must be greater than 0.", + "format": "int32", + "type": "integer" + }, + "scale": { + "description": "Must be greater than 0.", + "format": "double", + "type": "number" + } + }, + "type": "object" + }, + "GoogleApiDistributionBucketOptionsLinear": { + "description": "Specifies a linear sequence of buckets that all have the same width (except overflow and underflow). Each bucket represents a constant absolute uncertainty on the specific value in the bucket. There are `num_finite_buckets + 2` (= N) buckets. Bucket `i` has the following boundaries: Upper bound (0 \u003c= i \u003c N-1): offset + (width * i). Lower bound (1 \u003c= i \u003c N): offset + (width * (i - 1)).", + "id": "GoogleApiDistributionBucketOptionsLinear", + "properties": { + "numFiniteBuckets": { + "description": "Must be greater than 0.", + "format": "int32", + "type": "integer" + }, + "offset": { + "description": "Lower bound of the first bucket.", + "format": "double", + "type": "number" + }, + "width": { + "description": "Must be greater than 0.", + "format": "double", + "type": "number" + } + }, + "type": "object" + }, + "GoogleApiDistributionExemplar": { + "description": "Exemplars are example points that may be used to annotate aggregated distribution values. They are metadata that gives information about a particular value added to a Distribution bucket, such as a trace ID that was active when a value was added. They may contain further information, such as a example values and timestamps, origin, etc.", + "id": "GoogleApiDistributionExemplar", + "properties": { + "attachments": { + "description": "Contextual information about the example value. Examples are: Trace: type.googleapis.com/google.monitoring.v3.SpanContext Literal string: type.googleapis.com/google.protobuf.StringValue Labels dropped during aggregation: type.googleapis.com/google.monitoring.v3.DroppedLabels There may be only a single attachment of any given message type in a single exemplar, and this is enforced by the system.", + "items": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "type": "object" + }, + "type": "array" + }, + "timestamp": { + "description": "The observation (sampling) time of the above value.", + "format": "google-datetime", + "type": "string" + }, + "value": { + "description": "Value of the exemplar point. This value determines to which bucket the exemplar belongs.", + "format": "double", + "type": "number" + } + }, + "type": "object" + }, + "GoogleApiDistributionRange": { + "description": "The range of the population values.", + "id": "GoogleApiDistributionRange", + "properties": { + "max": { + "description": "The maximum of the population values.", + "format": "double", + "type": "number" + }, + "min": { + "description": "The minimum of the population values.", + "format": "double", + "type": "number" + } + }, + "type": "object" + }, "GoogleApiHttpBody": { "description": "Message that represents an arbitrary HTTP body. It should only be used for payload formats that can't be represented as JSON, such as raw binary or an HTML page. This message can be used both in streaming and non-streaming API methods in the request as well as the response. It can be used as a top-level request field, which is convenient if one wants to extract parameters from either the URL or HTTP template into the request fields and also want access to the raw HTTP body. Example: message GetResourceRequest { // A unique request id. string request_id = 1; // The raw HTTP body is bound to this field. google.api.HttpBody http_body = 2; } service ResourceService { rpc GetResource(GetResourceRequest) returns (google.api.HttpBody); rpc UpdateResource(google.api.HttpBody) returns (google.protobuf.Empty); } Example with streaming methods: service CaldavService { rpc GetCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); rpc UpdateCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); } Use of this type only changes how the request and response bodies are handled, all other features will continue to work unchanged.", "id": "GoogleApiHttpBody", @@ -6910,6 +7258,64 @@ }, "type": "object" }, + "GoogleApiMetric": { + "description": "A specific metric, identified by specifying values for all of the labels of a `MetricDescriptor`.", + "id": "GoogleApiMetric", + "properties": { + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "The set of label values that uniquely identify this metric. All labels listed in the `MetricDescriptor` must be assigned values.", + "type": "object" + }, + "type": { + "description": "An existing metric type, see google.api.MetricDescriptor. For example, `custom.googleapis.com/invoice/paid/amount`.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleApiMonitoredResource": { + "description": "An object representing a resource that can be used for monitoring, logging, billing, or other purposes. Examples include virtual machine instances, databases, and storage devices such as disks. The `type` field identifies a MonitoredResourceDescriptor object that describes the resource's schema. Information in the `labels` field identifies the actual resource and its attributes according to the schema. For example, a particular Compute Engine VM instance could be represented by the following object, because the MonitoredResourceDescriptor for `\"gce_instance\"` has labels `\"project_id\"`, `\"instance_id\"` and `\"zone\"`: { \"type\": \"gce_instance\", \"labels\": { \"project_id\": \"my-project\", \"instance_id\": \"12345678901234\", \"zone\": \"us-central1-a\" }}", + "id": "GoogleApiMonitoredResource", + "properties": { + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Required. Values for all of the labels listed in the associated monitored resource descriptor. For example, Compute Engine VM instances use the labels `\"project_id\"`, `\"instance_id\"`, and `\"zone\"`.", + "type": "object" + }, + "type": { + "description": "Required. The monitored resource type. This field must match the `type` field of a MonitoredResourceDescriptor object. For example, the type of a Compute Engine VM instance is `gce_instance`. Some descriptors include the service name in the type; for example, the type of a Datastream stream is `datastream.googleapis.com/Stream`.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleApiMonitoredResourceMetadata": { + "description": "Auxiliary metadata for a MonitoredResource object. MonitoredResource objects contain the minimum set of information to uniquely identify a monitored resource instance. There is some other useful auxiliary metadata. Monitoring and Logging use an ingestion pipeline to extract metadata for cloud resources of all types, and store the metadata in this message.", + "id": "GoogleApiMonitoredResourceMetadata", + "properties": { + "systemLabels": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Output only. Values for predefined system metadata labels. System labels are a kind of metadata extracted by Google, including \"machine_image\", \"vpc\", \"subnet_id\", \"security_group\", \"name\", etc. System label values can be only strings, Boolean values, or a list of strings. For example: { \"name\": \"my-test-instance\", \"security_group\": [\"a\", \"b\", \"c\"], \"spot_instance\": false }", + "type": "object" + }, + "userLabels": { + "additionalProperties": { + "type": "string" + }, + "description": "Output only. A map of user-defined metadata labels.", + "type": "object" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineLoggingErrorContext": { "description": "A description of the context in which an error occurred.", "id": "GoogleCloudDiscoveryengineLoggingErrorContext", @@ -9447,6 +9853,17 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries": { + "description": "The historical crawl rate timeseries data, used for monitoring.", + "id": "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries", + "properties": { + "qpsTimeSeries": { + "$ref": "GoogleMonitoringV3TimeSeries", + "description": "The QPS of the crawl rate." + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaCreateDataStoreMetadata": { "description": "Metadata related to the progress of the DataStoreService.CreateDataStore operation. This will be returned by the google.longrunning.Operation.metadata field.", "id": "GoogleCloudDiscoveryengineV1alphaCreateDataStoreMetadata", @@ -9779,6 +10196,21 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries": { + "description": "The historical dedicated crawl rate timeseries data, used for monitoring. Dedicated crawl is used by Vertex AI to crawl the user's website when dedicate crawl is set.", + "id": "GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries", + "properties": { + "autoRefreshCrawlRate": { + "$ref": "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries", + "description": "Vertex AI's dedicated crawl rate time series of auto-refresh, which is the crawl rate of Google-CloudVertexBot when dedicate crawl is set, and the crawl rate is for best effort use cases like refreshing urls periodically." + }, + "userTriggeredCrawlRate": { + "$ref": "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries", + "description": "Vertex AI's dedicated crawl rate time series of user triggered crawl, which is the crawl rate of Google-CloudVertexBot when dedicate crawl is set, and user triggered crawl rate is for deterministic use cases like crawling urls or sitemaps specified by users." + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaDeleteDataStoreMetadata": { "description": "Metadata related to the progress of the DataStoreService.DeleteDataStore operation. This will be returned by the google.longrunning.Operation.metadata field.", "id": "GoogleCloudDiscoveryengineV1alphaDeleteDataStoreMetadata", @@ -10952,23 +11384,72 @@ "description": "Configuration for Natural Language Query Understanding.", "id": "GoogleCloudDiscoveryengineV1alphaNaturalLanguageQueryUnderstandingConfig", "properties": { - "mode": { - "description": "Mode of Natural Language Query Understanding. If this field is unset, the behavior defaults to NaturalLanguageQueryUnderstandingConfig.Mode.DISABLED.", + "mode": { + "description": "Mode of Natural Language Query Understanding. If this field is unset, the behavior defaults to NaturalLanguageQueryUnderstandingConfig.Mode.DISABLED.", + "enum": [ + "MODE_UNSPECIFIED", + "DISABLED", + "ENABLED" + ], + "enumDescriptions": [ + "Default value.", + "Natural Language Query Understanding is disabled.", + "Natural Language Query Understanding is enabled." + ], + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse": { + "description": "Response message for CrawlRateManagementService.ObtainCrawlRate method. The response contains organcic or dedicated crawl rate time series data for monitoring, depending on whether dedicated crawl rate is set.", + "id": "GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse", + "properties": { + "dedicatedCrawlRateTimeSeries": { + "$ref": "GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries", + "description": "The historical dedicated crawl rate timeseries data, used for monitoring." + }, + "error": { + "$ref": "GoogleRpcStatus", + "description": "Errors from service when handling the request." + }, + "organicCrawlRateTimeSeries": { + "$ref": "GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries", + "description": "The historical organic crawl rate timeseries data, used for monitoring." + }, + "state": { + "description": "Output only. The state of the response.", "enum": [ - "MODE_UNSPECIFIED", - "DISABLED", - "ENABLED" + "STATE_UNSPECIFIED", + "SUCCEEDED", + "FAILED" ], "enumDescriptions": [ - "Default value.", - "Natural Language Query Understanding is disabled.", - "Natural Language Query Understanding is enabled." + "The state is unspecified.", + "The state is successful.", + "The state is failed." ], + "readOnly": true, "type": "string" } }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries": { + "description": "The historical organic crawl rate timeseries data, used for monitoring. Organic crawl is auto-determined by Google to crawl the user's website when dedicate crawl is not set. Crawl rate is the QPS of crawl request Google sends to the user's website.", + "id": "GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries", + "properties": { + "googleOrganicCrawlRate": { + "$ref": "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries", + "description": "Google's organic crawl rate time series, which is the sum of all googlebots' crawl rate. Please refer to https://developers.google.com/search/docs/crawling-indexing/overview-google-crawlers for more details about googlebots." + }, + "vertexAiOrganicCrawlRate": { + "$ref": "GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries", + "description": "Vertex AI's organic crawl rate time series, which is the crawl rate of Google-CloudVertexBot when dedicate crawl is not set. Please refer to https://developers.google.com/search/docs/crawling-indexing/google-common-crawlers#google-cloudvertexbot for more details about Google-CloudVertexBot." + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaProject": { "description": "Metadata and configurations for a Google Cloud project in the service.", "id": "GoogleCloudDiscoveryengineV1alphaProject", @@ -12529,6 +13010,236 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequest": { + "description": "Request message for CompletionService.AdvancedCompleteQuery method. .", + "id": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequest", + "properties": { + "boostSpec": { + "$ref": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequestBoostSpec", + "description": "Optional. Specification to boost suggestions matching the condition." + }, + "includeTailSuggestions": { + "description": "Indicates if tail suggestions should be returned if there are no suggestions that match the full query. Even if set to true, if there are suggestions that match the full query, those are returned and no tail suggestions are returned.", + "type": "boolean" + }, + "query": { + "description": "Required. The typeahead input used to fetch suggestions. Maximum length is 128 characters. The query can not be empty for most of the suggestion types. If it is empty, an `INVALID_ARGUMENT` error is returned. The exception is when the suggestion_types contains only the type `RECENT_SEARCH`, the query can be an empty string. The is called \"zero prefix\" feature, which returns user's recently searched queries given the empty query.", + "type": "string" + }, + "queryModel": { + "description": "Specifies the autocomplete data model. This overrides any model specified in the Configuration \u003e Autocomplete section of the Cloud console. Currently supported values: * `document` - Using suggestions generated from user-imported documents. * `search-history` - Using suggestions generated from the past history of SearchService.Search API calls. Do not use it when there is no traffic for Search API. * `user-event` - Using suggestions generated from user-imported search events. * `document-completable` - Using suggestions taken directly from user-imported document fields marked as completable. Default values: * `document` is the default model for regular dataStores. * `search-history` is the default model for site search dataStores.", + "type": "string" + }, + "suggestionTypes": { + "description": "Optional. Suggestion types to return. If empty or unspecified, query suggestions are returned. Only one suggestion type is supported at the moment.", + "items": { + "enum": [ + "SUGGESTION_TYPE_UNSPECIFIED", + "QUERY", + "PEOPLE", + "CONTENT", + "RECENT_SEARCH", + "GOOGLE_WORKSPACE" + ], + "enumDescriptions": [ + "Default value.", + "Returns query suggestions.", + "Returns people suggestions.", + "Returns content suggestions.", + "Returns recent search suggestions.", + "Returns Google Workspace suggestions." + ], + "type": "string" + }, + "type": "array" + }, + "userInfo": { + "$ref": "GoogleCloudDiscoveryengineV1betaUserInfo", + "description": "Optional. Information about the end user. This should be the same identifier information as UserEvent.user_info and SearchRequest.user_info." + }, + "userPseudoId": { + "description": "A unique identifier for tracking visitors. For example, this could be implemented with an HTTP cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor logs in or out of the website. This field should NOT have a fixed value such as `unknown_visitor`. This should be the same identifier as UserEvent.user_pseudo_id and SearchRequest.user_pseudo_id. The field must be a UTF-8 encoded string with a length limit of 128", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequestBoostSpec": { + "description": "Specification to boost suggestions based on the condtion of the suggestion.", + "id": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequestBoostSpec", + "properties": { + "conditionBoostSpecs": { + "description": "Condition boost specifications. If a suggestion matches multiple conditions in the specifictions, boost values from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20. Note: Currently only support language condition boost.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequestBoostSpecConditionBoostSpec" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequestBoostSpecConditionBoostSpec": { + "description": "Boost applies to suggestions which match a condition.", + "id": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequestBoostSpecConditionBoostSpec", + "properties": { + "boost": { + "description": "Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0. Setting to 1.0 gives the suggestions a big promotion. However, it does not necessarily mean that the top result will be a boosted suggestion. Setting to -1.0 gives the suggestions a big demotion. However, other suggestions that are relevant might still be shown. Setting to 0.0 means no boost applied. The boosting condition is ignored.", + "format": "float", + "type": "number" + }, + "condition": { + "description": "An expression which specifies a boost condition. The syntax is the same as [filter expression syntax](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata#filter-expression-syntax). Currently, the only supported condition is a list of BCP-47 lang codes. Example: * To boost suggestions in languages `en` or `fr`: `(lang_code: ANY(\"en\", \"fr\"))`", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponse": { + "description": "Response message for CompletionService.AdvancedCompleteQuery method.", + "id": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponse", + "properties": { + "contentSuggestions": { + "description": "Results of the matched content suggestions. The result list is ordered and the first result is the top suggestion.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseContentSuggestion" + }, + "type": "array" + }, + "peopleSuggestions": { + "description": "Results of the matched people suggestions. The result list is ordered and the first result is the top suggestion.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponsePersonSuggestion" + }, + "type": "array" + }, + "querySuggestions": { + "description": "Results of the matched query suggestions. The result list is ordered and the first result is a top suggestion.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseQuerySuggestion" + }, + "type": "array" + }, + "recentSearchSuggestions": { + "description": "Results of the matched \"recent search\" suggestions. The result list is ordered and the first result is the top suggestion.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseRecentSearchSuggestion" + }, + "type": "array" + }, + "tailMatchTriggered": { + "description": "True if the returned suggestions are all tail suggestions. For tail matching to be triggered, include_tail_suggestions in the request must be true and there must be no suggestions that match the full query.", + "type": "boolean" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseContentSuggestion": { + "description": "Suggestions as content.", + "id": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseContentSuggestion", + "properties": { + "contentType": { + "description": "The type of the content suggestion.", + "enum": [ + "CONTENT_TYPE_UNSPECIFIED", + "GOOGLE_WORKSPACE", + "THIRD_PARTY" + ], + "enumDescriptions": [ + "Default value.", + "The suggestion is from a Google Workspace source.", + "The suggestion is from a third party source." + ], + "type": "string" + }, + "dataStore": { + "description": "The name of the dataStore that this suggestion belongs to.", + "type": "string" + }, + "document": { + "$ref": "GoogleCloudDiscoveryengineV1betaDocument", + "description": "The document data snippet in the suggestion. Only a subset of fields will be populated." + }, + "suggestion": { + "description": "The suggestion for the query.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponsePersonSuggestion": { + "description": "Suggestions as people.", + "id": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponsePersonSuggestion", + "properties": { + "dataStore": { + "description": "The name of the dataStore that this suggestion belongs to.", + "type": "string" + }, + "document": { + "$ref": "GoogleCloudDiscoveryengineV1betaDocument", + "description": "The document data snippet in the suggestion. Only a subset of fields is populated." + }, + "personType": { + "description": "The type of the person.", + "enum": [ + "PERSON_TYPE_UNSPECIFIED", + "CLOUD_IDENTITY", + "THIRD_PARTY_IDENTITY" + ], + "enumDescriptions": [ + "Default value.", + "The suggestion is from a GOOGLE_IDENTITY source.", + "The suggestion is from a THIRD_PARTY_IDENTITY source." + ], + "type": "string" + }, + "suggestion": { + "description": "The suggestion for the query.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseQuerySuggestion": { + "description": "Suggestions as search queries.", + "id": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseQuerySuggestion", + "properties": { + "completableFieldPaths": { + "description": "The unique document field paths that serve as the source of this suggestion if it was generated from completable fields. This field is only populated for the document-completable model.", + "items": { + "type": "string" + }, + "type": "array" + }, + "dataStore": { + "description": "The name of the dataStore that this suggestion belongs to.", + "items": { + "type": "string" + }, + "type": "array" + }, + "suggestion": { + "description": "The suggestion for the query.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseRecentSearchSuggestion": { + "description": "Suggestions from recent search history.", + "id": "GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseRecentSearchSuggestion", + "properties": { + "recentSearchTime": { + "description": "The time when this recent rearch happened.", + "format": "google-datetime", + "type": "string" + }, + "suggestion": { + "description": "The suggestion for the query.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaAdvancedSiteSearchConfig": { "description": "Configuration data for advance site search.", "id": "GoogleCloudDiscoveryengineV1betaAdvancedSiteSearchConfig", @@ -12720,6 +13431,10 @@ "description": "Deprecated: This field is deprecated. Streaming Answer API will be supported. Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.", "type": "boolean" }, + "groundingSpec": { + "$ref": "GoogleCloudDiscoveryengineV1betaAnswerQueryRequestGroundingSpec", + "description": "Optional. Grounding specification." + }, "query": { "$ref": "GoogleCloudDiscoveryengineV1betaQuery", "description": "Required. Current user query." @@ -12819,6 +13534,31 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaAnswerQueryRequestGroundingSpec": { + "description": "Grounding specification.", + "id": "GoogleCloudDiscoveryengineV1betaAnswerQueryRequestGroundingSpec", + "properties": { + "filteringLevel": { + "description": "Optional. Specifies whether to enable the filtering based on grounding score and at what level.", + "enum": [ + "FILTERING_LEVEL_UNSPECIFIED", + "FILTERING_LEVEL_LOW", + "FILTERING_LEVEL_HIGH" + ], + "enumDescriptions": [ + "Default is no filter", + "Filter answers based on a low threshold.", + "Filter answers based on a high threshold." + ], + "type": "string" + }, + "includeGroundingSupports": { + "description": "Optional. Specifies whether to include grounding_supports in the answer. The default value is `false`. When this field is set to `true`, returned answer will have `grounding_score` and will contain GroundingSupports for each claim.", + "type": "boolean" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaAnswerQueryRequestQueryUnderstandingSpec": { "description": "Query understanding specification.", "id": "GoogleCloudDiscoveryengineV1betaAnswerQueryRequestQueryUnderstandingSpec", @@ -19239,7 +19979,7 @@ "type": "string" }, "eventType": { - "description": "Required. User event type. Allowed values are: Generic values: * `search`: Search for Documents. * `view-item`: Detailed page view of a Document. * `view-item-list`: View of a panel or ordered list of Documents. * `view-home-page`: View of the home page. * `view-category-page`: View of a category page, e.g. Home \u003e Men \u003e Jeans Retail-related values: * `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping * `purchase`: Purchase an item(s) Media-related values: * `media-play`: Start/resume watching a video, playing a song, etc. * `media-complete`: Finished or stopped midway through a video, song, etc.", + "description": "Required. User event type. Allowed values are: Generic values: * `search`: Search for Documents. * `view-item`: Detailed page view of a Document. * `view-item-list`: View of a panel or ordered list of Documents. * `view-home-page`: View of the home page. * `view-category-page`: View of a category page, e.g. Home \u003e Men \u003e Jeans * `add-feedback`: Add a user feedback. Retail-related values: * `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping * `purchase`: Purchase an item(s) Media-related values: * `media-play`: Start/resume watching a video, playing a song, etc. * `media-complete`: Finished or stopped midway through a video, song, etc.", "type": "string" }, "filter": { @@ -19412,6 +20152,139 @@ }, "type": "object" }, + "GoogleMonitoringV3Point": { + "description": "A single data point in a time series.", + "id": "GoogleMonitoringV3Point", + "properties": { + "interval": { + "$ref": "GoogleMonitoringV3TimeInterval", + "description": "The time interval to which the data point applies. For `GAUGE` metrics, the start time is optional, but if it is supplied, it must equal the end time. For `DELTA` metrics, the start and end time should specify a non-zero interval, with subsequent points specifying contiguous and non-overlapping intervals. For `CUMULATIVE` metrics, the start and end time should specify a non-zero interval, with subsequent points specifying the same start time and increasing end times, until an event resets the cumulative value to zero and sets a new start time for the following points." + }, + "value": { + "$ref": "GoogleMonitoringV3TypedValue", + "description": "The value of the data point." + } + }, + "type": "object" + }, + "GoogleMonitoringV3TimeInterval": { + "description": "A time interval extending just after a start time through an end time. If the start time is the same as the end time, then the interval represents a single point in time.", + "id": "GoogleMonitoringV3TimeInterval", + "properties": { + "endTime": { + "description": "Required. The end of the time interval.", + "format": "google-datetime", + "type": "string" + }, + "startTime": { + "description": "Optional. The beginning of the time interval. The default value for the start time is the end time. The start time must not be later than the end time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleMonitoringV3TimeSeries": { + "description": "A collection of data points that describes the time-varying values of a metric. A time series is identified by a combination of a fully-specified monitored resource and a fully-specified metric. This type is used for both listing and creating time series.", + "id": "GoogleMonitoringV3TimeSeries", + "properties": { + "description": { + "description": "Input only. A detailed description of the time series that will be associated with the google.api.MetricDescriptor for the metric. Once set, this field cannot be changed through CreateTimeSeries.", + "type": "string" + }, + "metadata": { + "$ref": "GoogleApiMonitoredResourceMetadata", + "description": "Output only. The associated monitored resource metadata. When reading a time series, this field will include metadata labels that are explicitly named in the reduction. When creating a time series, this field is ignored." + }, + "metric": { + "$ref": "GoogleApiMetric", + "description": "The associated metric. A fully-specified metric used to identify the time series." + }, + "metricKind": { + "description": "The metric kind of the time series. When listing time series, this metric kind might be different from the metric kind of the associated metric if this time series is an alignment or reduction of other time series. When creating a time series, this field is optional. If present, it must be the same as the metric kind of the associated metric. If the associated metric's descriptor must be auto-created, then this field specifies the metric kind of the new descriptor and must be either `GAUGE` (the default) or `CUMULATIVE`.", + "enum": [ + "METRIC_KIND_UNSPECIFIED", + "GAUGE", + "DELTA", + "CUMULATIVE" + ], + "enumDescriptions": [ + "Do not use this default value.", + "An instantaneous measurement of a value.", + "The change in a value during a time interval.", + "A value accumulated over a time interval. Cumulative measurements in a time series should have the same start time and increasing end times, until an event resets the cumulative value to zero and sets a new start time for the following points." + ], + "type": "string" + }, + "points": { + "description": "The data points of this time series. When listing time series, points are returned in reverse time order. When creating a time series, this field must contain exactly one point and the point's type must be the same as the value type of the associated metric. If the associated metric's descriptor must be auto-created, then the value type of the descriptor is determined by the point's type, which must be `BOOL`, `INT64`, `DOUBLE`, or `DISTRIBUTION`.", + "items": { + "$ref": "GoogleMonitoringV3Point" + }, + "type": "array" + }, + "resource": { + "$ref": "GoogleApiMonitoredResource", + "description": "The associated monitored resource. Custom metrics can use only certain monitored resource types in their time series data. For more information, see [Monitored resources for custom metrics](https://cloud.google.com/monitoring/custom-metrics/creating-metrics#custom-metric-resources)." + }, + "unit": { + "description": "The units in which the metric value is reported. It is only applicable if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The `unit` defines the representation of the stored metric values. This field can only be changed through CreateTimeSeries when it is empty.", + "type": "string" + }, + "valueType": { + "description": "The value type of the time series. When listing time series, this value type might be different from the value type of the associated metric if this time series is an alignment or reduction of other time series. When creating a time series, this field is optional. If present, it must be the same as the type of the data in the `points` field.", + "enum": [ + "VALUE_TYPE_UNSPECIFIED", + "BOOL", + "INT64", + "DOUBLE", + "STRING", + "DISTRIBUTION", + "MONEY" + ], + "enumDescriptions": [ + "Do not use this default value.", + "The value is a boolean. This value type can be used only if the metric kind is `GAUGE`.", + "The value is a signed 64-bit integer.", + "The value is a double precision floating point number.", + "The value is a text string. This value type can be used only if the metric kind is `GAUGE`.", + "The value is a `Distribution`.", + "The value is money." + ], + "type": "string" + } + }, + "type": "object" + }, + "GoogleMonitoringV3TypedValue": { + "description": "A single strongly-typed value.", + "id": "GoogleMonitoringV3TypedValue", + "properties": { + "boolValue": { + "description": "A Boolean value: `true` or `false`.", + "type": "boolean" + }, + "distributionValue": { + "$ref": "GoogleApiDistribution", + "description": "A distribution value." + }, + "doubleValue": { + "description": "A 64-bit double-precision floating-point number. Its magnitude is approximately ±10±300 and it has 16 significant digits of precision.", + "format": "double", + "type": "number" + }, + "int64Value": { + "description": "A 64-bit integer. Its range is approximately ±9.2x1018.", + "format": "int64", + "type": "string" + }, + "stringValue": { + "description": "A variable-length string value.", + "type": "string" + } + }, + "type": "object" + }, "GoogleProtobufEmpty": { "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": "GoogleProtobufEmpty", diff --git a/discoveryengine/v1beta/discoveryengine-gen.go b/discoveryengine/v1beta/discoveryengine-gen.go index c2c17693a11..0e2edf55e50 100644 --- a/discoveryengine/v1beta/discoveryengine-gen.go +++ b/discoveryengine/v1beta/discoveryengine-gen.go @@ -250,6 +250,7 @@ type ProjectsLocationsCollectionsDataConnectorOperationsService struct { func NewProjectsLocationsCollectionsDataStoresService(s *Service) *ProjectsLocationsCollectionsDataStoresService { rs := &ProjectsLocationsCollectionsDataStoresService{s: s} rs.Branches = NewProjectsLocationsCollectionsDataStoresBranchesService(s) + rs.CompletionConfig = NewProjectsLocationsCollectionsDataStoresCompletionConfigService(s) rs.CompletionSuggestions = NewProjectsLocationsCollectionsDataStoresCompletionSuggestionsService(s) rs.Controls = NewProjectsLocationsCollectionsDataStoresControlsService(s) rs.Conversations = NewProjectsLocationsCollectionsDataStoresConversationsService(s) @@ -270,6 +271,8 @@ type ProjectsLocationsCollectionsDataStoresService struct { Branches *ProjectsLocationsCollectionsDataStoresBranchesService + CompletionConfig *ProjectsLocationsCollectionsDataStoresCompletionConfigService + CompletionSuggestions *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsService Controls *ProjectsLocationsCollectionsDataStoresControlsService @@ -328,6 +331,15 @@ type ProjectsLocationsCollectionsDataStoresBranchesOperationsService struct { s *Service } +func NewProjectsLocationsCollectionsDataStoresCompletionConfigService(s *Service) *ProjectsLocationsCollectionsDataStoresCompletionConfigService { + rs := &ProjectsLocationsCollectionsDataStoresCompletionConfigService{s: s} + return rs +} + +type ProjectsLocationsCollectionsDataStoresCompletionConfigService struct { + s *Service +} + func NewProjectsLocationsCollectionsDataStoresCompletionSuggestionsService(s *Service) *ProjectsLocationsCollectionsDataStoresCompletionSuggestionsService { rs := &ProjectsLocationsCollectionsDataStoresCompletionSuggestionsService{s: s} return rs @@ -510,6 +522,7 @@ type ProjectsLocationsCollectionsDataStoresUserEventsService struct { func NewProjectsLocationsCollectionsEnginesService(s *Service) *ProjectsLocationsCollectionsEnginesService { rs := &ProjectsLocationsCollectionsEnginesService{s: s} + rs.CompletionConfig = NewProjectsLocationsCollectionsEnginesCompletionConfigService(s) rs.Controls = NewProjectsLocationsCollectionsEnginesControlsService(s) rs.Conversations = NewProjectsLocationsCollectionsEnginesConversationsService(s) rs.Operations = NewProjectsLocationsCollectionsEnginesOperationsService(s) @@ -521,6 +534,8 @@ func NewProjectsLocationsCollectionsEnginesService(s *Service) *ProjectsLocation type ProjectsLocationsCollectionsEnginesService struct { s *Service + CompletionConfig *ProjectsLocationsCollectionsEnginesCompletionConfigService + Controls *ProjectsLocationsCollectionsEnginesControlsService Conversations *ProjectsLocationsCollectionsEnginesConversationsService @@ -532,6 +547,15 @@ type ProjectsLocationsCollectionsEnginesService struct { Sessions *ProjectsLocationsCollectionsEnginesSessionsService } +func NewProjectsLocationsCollectionsEnginesCompletionConfigService(s *Service) *ProjectsLocationsCollectionsEnginesCompletionConfigService { + rs := &ProjectsLocationsCollectionsEnginesCompletionConfigService{s: s} + return rs +} + +type ProjectsLocationsCollectionsEnginesCompletionConfigService struct { + s *Service +} + func NewProjectsLocationsCollectionsEnginesControlsService(s *Service) *ProjectsLocationsCollectionsEnginesControlsService { rs := &ProjectsLocationsCollectionsEnginesControlsService{s: s} return rs @@ -601,6 +625,7 @@ type ProjectsLocationsCollectionsOperationsService struct { func NewProjectsLocationsDataStoresService(s *Service) *ProjectsLocationsDataStoresService { rs := &ProjectsLocationsDataStoresService{s: s} rs.Branches = NewProjectsLocationsDataStoresBranchesService(s) + rs.CompletionConfig = NewProjectsLocationsDataStoresCompletionConfigService(s) rs.CompletionSuggestions = NewProjectsLocationsDataStoresCompletionSuggestionsService(s) rs.Controls = NewProjectsLocationsDataStoresControlsService(s) rs.Conversations = NewProjectsLocationsDataStoresConversationsService(s) @@ -620,6 +645,8 @@ type ProjectsLocationsDataStoresService struct { Branches *ProjectsLocationsDataStoresBranchesService + CompletionConfig *ProjectsLocationsDataStoresCompletionConfigService + CompletionSuggestions *ProjectsLocationsDataStoresCompletionSuggestionsService Controls *ProjectsLocationsDataStoresControlsService @@ -676,6 +703,15 @@ type ProjectsLocationsDataStoresBranchesOperationsService struct { s *Service } +func NewProjectsLocationsDataStoresCompletionConfigService(s *Service) *ProjectsLocationsDataStoresCompletionConfigService { + rs := &ProjectsLocationsDataStoresCompletionConfigService{s: s} + return rs +} + +type ProjectsLocationsDataStoresCompletionConfigService struct { + s *Service +} + func NewProjectsLocationsDataStoresCompletionSuggestionsService(s *Service) *ProjectsLocationsDataStoresCompletionSuggestionsService { rs := &ProjectsLocationsDataStoresCompletionSuggestionsService{s: s} return rs @@ -931,6 +967,355 @@ type ProjectsOperationsService struct { s *Service } +// GoogleApiDistribution: `Distribution` contains summary statistics for a +// population of values. It optionally contains a histogram representing the +// distribution of those values across a set of buckets. The summary statistics +// are the count, mean, sum of the squared deviation from the mean, the +// minimum, and the maximum of the set of population of values. The histogram +// is based on a sequence of buckets and gives a count of values that fall into +// each bucket. The boundaries of the buckets are given either explicitly or by +// formulas for buckets of fixed or exponentially increasing widths. Although +// it is not forbidden, it is generally a bad idea to include non-finite values +// (infinities or NaNs) in the population of values, as this will render the +// `mean` and `sum_of_squared_deviation` fields meaningless. +type GoogleApiDistribution struct { + // BucketCounts: The number of values in each bucket of the histogram, as + // described in `bucket_options`. If the distribution does not have a + // histogram, then omit this field. If there is a histogram, then the sum of + // the values in `bucket_counts` must equal the value in the `count` field of + // the distribution. If present, `bucket_counts` should contain N values, where + // N is the number of buckets specified in `bucket_options`. If you supply + // fewer than N values, the remaining values are assumed to be 0. The order of + // the values in `bucket_counts` follows the bucket numbering schemes described + // for the three bucket types. The first value must be the count for the + // underflow bucket (number 0). The next N-2 values are the counts for the + // finite buckets (number 1 through N-2). The N'th value in `bucket_counts` is + // the count for the overflow bucket (number N-1). + BucketCounts googleapi.Int64s `json:"bucketCounts,omitempty"` + // BucketOptions: Defines the histogram bucket boundaries. If the distribution + // does not contain a histogram, then omit this field. + BucketOptions *GoogleApiDistributionBucketOptions `json:"bucketOptions,omitempty"` + // Count: The number of values in the population. Must be non-negative. This + // value must equal the sum of the values in `bucket_counts` if a histogram is + // provided. + Count int64 `json:"count,omitempty,string"` + // Exemplars: Must be in increasing order of `value` field. + Exemplars []*GoogleApiDistributionExemplar `json:"exemplars,omitempty"` + // Mean: The arithmetic mean of the values in the population. If `count` is + // zero then this field must be zero. + Mean float64 `json:"mean,omitempty"` + // Range: If specified, contains the range of the population values. The field + // must not be present if the `count` is zero. + Range *GoogleApiDistributionRange `json:"range,omitempty"` + // SumOfSquaredDeviation: The sum of squared deviations from the mean of the + // values in the population. For values x_i this is: Sumi=1..n ((x_i - mean)^2) + // Knuth, "The Art of Computer Programming", Vol. 2, page 232, 3rd edition + // describes Welford's method for accumulating this sum in one pass. If `count` + // is zero then this field must be zero. + SumOfSquaredDeviation float64 `json:"sumOfSquaredDeviation,omitempty"` + // ForceSendFields is a list of field names (e.g. "BucketCounts") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BucketCounts") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiDistribution) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiDistribution + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleApiDistribution) UnmarshalJSON(data []byte) error { + type NoMethod GoogleApiDistribution + var s1 struct { + Mean gensupport.JSONFloat64 `json:"mean"` + SumOfSquaredDeviation gensupport.JSONFloat64 `json:"sumOfSquaredDeviation"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Mean = float64(s1.Mean) + s.SumOfSquaredDeviation = float64(s1.SumOfSquaredDeviation) + return nil +} + +// GoogleApiDistributionBucketOptions: `BucketOptions` describes the bucket +// boundaries used to create a histogram for the distribution. The buckets can +// be in a linear sequence, an exponential sequence, or each bucket can be +// specified explicitly. `BucketOptions` does not include the number of values +// in each bucket. A bucket has an inclusive lower bound and exclusive upper +// bound for the values that are counted for that bucket. The upper bound of a +// bucket must be strictly greater than the lower bound. The sequence of N +// buckets for a distribution consists of an underflow bucket (number 0), zero +// or more finite buckets (number 1 through N - 2) and an overflow bucket +// (number N - 1). The buckets are contiguous: the lower bound of bucket i (i > +// 0) is the same as the upper bound of bucket i - 1. The buckets span the +// whole range of finite values: lower bound of the underflow bucket is +// -infinity and the upper bound of the overflow bucket is +infinity. The +// finite buckets are so-called because both bounds are finite. +type GoogleApiDistributionBucketOptions struct { + // ExplicitBuckets: The explicit buckets. + ExplicitBuckets *GoogleApiDistributionBucketOptionsExplicit `json:"explicitBuckets,omitempty"` + // ExponentialBuckets: The exponential buckets. + ExponentialBuckets *GoogleApiDistributionBucketOptionsExponential `json:"exponentialBuckets,omitempty"` + // LinearBuckets: The linear bucket. + LinearBuckets *GoogleApiDistributionBucketOptionsLinear `json:"linearBuckets,omitempty"` + // ForceSendFields is a list of field names (e.g. "ExplicitBuckets") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ExplicitBuckets") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiDistributionBucketOptions) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiDistributionBucketOptions + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleApiDistributionBucketOptionsExplicit: Specifies a set of buckets with +// arbitrary widths. There are `size(bounds) + 1` (= N) buckets. Bucket `i` has +// the following boundaries: Upper bound (0 <= i < N-1): bounds[i] Lower bound +// (1 <= i < N); bounds[i - 1] The `bounds` field must contain at least one +// element. If `bounds` has only one element, then there are no finite buckets, +// and that single element is the common boundary of the overflow and underflow +// buckets. +type GoogleApiDistributionBucketOptionsExplicit struct { + // Bounds: The values must be monotonically increasing. + Bounds []float64 `json:"bounds,omitempty"` + // ForceSendFields is a list of field names (e.g. "Bounds") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Bounds") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiDistributionBucketOptionsExplicit) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiDistributionBucketOptionsExplicit + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleApiDistributionBucketOptionsExplicit) UnmarshalJSON(data []byte) error { + type NoMethod GoogleApiDistributionBucketOptionsExplicit + var s1 struct { + Bounds []gensupport.JSONFloat64 `json:"bounds"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Bounds = make([]float64, len(s1.Bounds)) + for i := range s1.Bounds { + s.Bounds[i] = float64(s1.Bounds[i]) + } + return nil +} + +// GoogleApiDistributionBucketOptionsExponential: Specifies an exponential +// sequence of buckets that have a width that is proportional to the value of +// the lower bound. Each bucket represents a constant relative uncertainty on a +// specific value in the bucket. There are `num_finite_buckets + 2` (= N) +// buckets. Bucket `i` has the following boundaries: Upper bound (0 <= i < +// N-1): scale * (growth_factor ^ i). Lower bound (1 <= i < N): scale * +// (growth_factor ^ (i - 1)). +type GoogleApiDistributionBucketOptionsExponential struct { + // GrowthFactor: Must be greater than 1. + GrowthFactor float64 `json:"growthFactor,omitempty"` + // NumFiniteBuckets: Must be greater than 0. + NumFiniteBuckets int64 `json:"numFiniteBuckets,omitempty"` + // Scale: Must be greater than 0. + Scale float64 `json:"scale,omitempty"` + // ForceSendFields is a list of field names (e.g. "GrowthFactor") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "GrowthFactor") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiDistributionBucketOptionsExponential) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiDistributionBucketOptionsExponential + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleApiDistributionBucketOptionsExponential) UnmarshalJSON(data []byte) error { + type NoMethod GoogleApiDistributionBucketOptionsExponential + var s1 struct { + GrowthFactor gensupport.JSONFloat64 `json:"growthFactor"` + Scale gensupport.JSONFloat64 `json:"scale"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.GrowthFactor = float64(s1.GrowthFactor) + s.Scale = float64(s1.Scale) + return nil +} + +// GoogleApiDistributionBucketOptionsLinear: Specifies a linear sequence of +// buckets that all have the same width (except overflow and underflow). Each +// bucket represents a constant absolute uncertainty on the specific value in +// the bucket. There are `num_finite_buckets + 2` (= N) buckets. Bucket `i` has +// the following boundaries: Upper bound (0 <= i < N-1): offset + (width * i). +// Lower bound (1 <= i < N): offset + (width * (i - 1)). +type GoogleApiDistributionBucketOptionsLinear struct { + // NumFiniteBuckets: Must be greater than 0. + NumFiniteBuckets int64 `json:"numFiniteBuckets,omitempty"` + // Offset: Lower bound of the first bucket. + Offset float64 `json:"offset,omitempty"` + // Width: Must be greater than 0. + Width float64 `json:"width,omitempty"` + // ForceSendFields is a list of field names (e.g. "NumFiniteBuckets") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "NumFiniteBuckets") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiDistributionBucketOptionsLinear) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiDistributionBucketOptionsLinear + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleApiDistributionBucketOptionsLinear) UnmarshalJSON(data []byte) error { + type NoMethod GoogleApiDistributionBucketOptionsLinear + var s1 struct { + Offset gensupport.JSONFloat64 `json:"offset"` + Width gensupport.JSONFloat64 `json:"width"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Offset = float64(s1.Offset) + s.Width = float64(s1.Width) + return nil +} + +// GoogleApiDistributionExemplar: Exemplars are example points that may be used +// to annotate aggregated distribution values. They are metadata that gives +// information about a particular value added to a Distribution bucket, such as +// a trace ID that was active when a value was added. They may contain further +// information, such as a example values and timestamps, origin, etc. +type GoogleApiDistributionExemplar struct { + // Attachments: Contextual information about the example value. Examples are: + // Trace: type.googleapis.com/google.monitoring.v3.SpanContext Literal string: + // type.googleapis.com/google.protobuf.StringValue Labels dropped during + // aggregation: type.googleapis.com/google.monitoring.v3.DroppedLabels There + // may be only a single attachment of any given message type in a single + // exemplar, and this is enforced by the system. + Attachments []googleapi.RawMessage `json:"attachments,omitempty"` + // Timestamp: The observation (sampling) time of the above value. + Timestamp string `json:"timestamp,omitempty"` + // Value: Value of the exemplar point. This value determines to which bucket + // the exemplar belongs. + Value float64 `json:"value,omitempty"` + // ForceSendFields is a list of field names (e.g. "Attachments") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Attachments") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiDistributionExemplar) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiDistributionExemplar + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleApiDistributionExemplar) UnmarshalJSON(data []byte) error { + type NoMethod GoogleApiDistributionExemplar + var s1 struct { + Value gensupport.JSONFloat64 `json:"value"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Value = float64(s1.Value) + return nil +} + +// GoogleApiDistributionRange: The range of the population values. +type GoogleApiDistributionRange struct { + // Max: The maximum of the population values. + Max float64 `json:"max,omitempty"` + // Min: The minimum of the population values. + Min float64 `json:"min,omitempty"` + // ForceSendFields is a list of field names (e.g. "Max") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Max") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiDistributionRange) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiDistributionRange + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleApiDistributionRange) UnmarshalJSON(data []byte) error { + type NoMethod GoogleApiDistributionRange + var s1 struct { + Max gensupport.JSONFloat64 `json:"max"` + Min gensupport.JSONFloat64 `json:"min"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Max = float64(s1.Max) + s.Min = float64(s1.Min) + return nil +} + // GoogleApiHttpBody: Message that represents an arbitrary HTTP body. It should // only be used for payload formats that can't be represented as JSON, such as // raw binary or an HTML page. This message can be used both in streaming and @@ -978,6 +1363,107 @@ func (s GoogleApiHttpBody) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleApiMetric: A specific metric, identified by specifying values for all +// of the labels of a `MetricDescriptor`. +type GoogleApiMetric struct { + // Labels: The set of label values that uniquely identify this metric. All + // labels listed in the `MetricDescriptor` must be assigned values. + Labels map[string]string `json:"labels,omitempty"` + // Type: An existing metric type, see google.api.MetricDescriptor. For example, + // `custom.googleapis.com/invoice/paid/amount`. + Type string `json:"type,omitempty"` + // ForceSendFields is a list of field names (e.g. "Labels") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Labels") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiMetric) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiMetric + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleApiMonitoredResource: An object representing a resource that can be +// used for monitoring, logging, billing, or other purposes. Examples include +// virtual machine instances, databases, and storage devices such as disks. The +// `type` field identifies a MonitoredResourceDescriptor object that describes +// the resource's schema. Information in the `labels` field identifies the +// actual resource and its attributes according to the schema. For example, a +// particular Compute Engine VM instance could be represented by the following +// object, because the MonitoredResourceDescriptor for "gce_instance" has +// labels "project_id", "instance_id" and "zone": { "type": +// "gce_instance", "labels": { "project_id": "my-project", "instance_id": +// "12345678901234", "zone": "us-central1-a" }} +type GoogleApiMonitoredResource struct { + // Labels: Required. Values for all of the labels listed in the associated + // monitored resource descriptor. For example, Compute Engine VM instances use + // the labels "project_id", "instance_id", and "zone". + Labels map[string]string `json:"labels,omitempty"` + // Type: Required. The monitored resource type. This field must match the + // `type` field of a MonitoredResourceDescriptor object. For example, the type + // of a Compute Engine VM instance is `gce_instance`. Some descriptors include + // the service name in the type; for example, the type of a Datastream stream + // is `datastream.googleapis.com/Stream`. + Type string `json:"type,omitempty"` + // ForceSendFields is a list of field names (e.g. "Labels") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Labels") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiMonitoredResource) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiMonitoredResource + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleApiMonitoredResourceMetadata: Auxiliary metadata for a +// MonitoredResource object. MonitoredResource objects contain the minimum set +// of information to uniquely identify a monitored resource instance. There is +// some other useful auxiliary metadata. Monitoring and Logging use an +// ingestion pipeline to extract metadata for cloud resources of all types, and +// store the metadata in this message. +type GoogleApiMonitoredResourceMetadata struct { + // SystemLabels: Output only. Values for predefined system metadata labels. + // System labels are a kind of metadata extracted by Google, including + // "machine_image", "vpc", "subnet_id", "security_group", "name", etc. System + // label values can be only strings, Boolean values, or a list of strings. For + // example: { "name": "my-test-instance", "security_group": ["a", "b", "c"], + // "spot_instance": false } + SystemLabels googleapi.RawMessage `json:"systemLabels,omitempty"` + // UserLabels: Output only. A map of user-defined metadata labels. + UserLabels map[string]string `json:"userLabels,omitempty"` + // ForceSendFields is a list of field names (e.g. "SystemLabels") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "SystemLabels") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiMonitoredResourceMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiMonitoredResourceMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineLoggingErrorContext: A description of the context // in which an error occurred. type GoogleCloudDiscoveryengineLoggingErrorContext struct { @@ -4316,6 +4802,29 @@ func (s GoogleCloudDiscoveryengineV1alphaControlSynonymsAction) MarshalJSON() ([ return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries: The historical crawl +// rate timeseries data, used for monitoring. +type GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries struct { + // QpsTimeSeries: The QPS of the crawl rate. + QpsTimeSeries *GoogleMonitoringV3TimeSeries `json:"qpsTimeSeries,omitempty"` + // ForceSendFields is a list of field names (e.g. "QpsTimeSeries") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "QpsTimeSeries") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaCreateDataStoreMetadata: Metadata related // to the progress of the DataStoreService.CreateDataStore operation. This will // be returned by the google.longrunning.Operation.metadata field. @@ -4680,6 +5189,39 @@ func (s GoogleCloudDiscoveryengineV1alphaDataStoreServingConfigDataStore) Marsha return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries: The +// historical dedicated crawl rate timeseries data, used for monitoring. +// Dedicated crawl is used by Vertex AI to crawl the user's website when +// dedicate crawl is set. +type GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries struct { + // AutoRefreshCrawlRate: Vertex AI's dedicated crawl rate time series of + // auto-refresh, which is the crawl rate of Google-CloudVertexBot when dedicate + // crawl is set, and the crawl rate is for best effort use cases like + // refreshing urls periodically. + AutoRefreshCrawlRate *GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries `json:"autoRefreshCrawlRate,omitempty"` + // UserTriggeredCrawlRate: Vertex AI's dedicated crawl rate time series of user + // triggered crawl, which is the crawl rate of Google-CloudVertexBot when + // dedicate crawl is set, and user triggered crawl rate is for deterministic + // use cases like crawling urls or sitemaps specified by users. + UserTriggeredCrawlRate *GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries `json:"userTriggeredCrawlRate,omitempty"` + // ForceSendFields is a list of field names (e.g. "AutoRefreshCrawlRate") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AutoRefreshCrawlRate") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaDeleteDataStoreMetadata: Metadata related // to the progress of the DataStoreService.DeleteDataStore operation. This will // be returned by the google.longrunning.Operation.metadata field. @@ -6293,6 +6835,79 @@ func (s GoogleCloudDiscoveryengineV1alphaNaturalLanguageQueryUnderstandingConfig return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse: Response message +// for CrawlRateManagementService.ObtainCrawlRate method. The response contains +// organcic or dedicated crawl rate time series data for monitoring, depending +// on whether dedicated crawl rate is set. +type GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse struct { + // DedicatedCrawlRateTimeSeries: The historical dedicated crawl rate timeseries + // data, used for monitoring. + DedicatedCrawlRateTimeSeries *GoogleCloudDiscoveryengineV1alphaDedicatedCrawlRateTimeSeries `json:"dedicatedCrawlRateTimeSeries,omitempty"` + // Error: Errors from service when handling the request. + Error *GoogleRpcStatus `json:"error,omitempty"` + // OrganicCrawlRateTimeSeries: The historical organic crawl rate timeseries + // data, used for monitoring. + OrganicCrawlRateTimeSeries *GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries `json:"organicCrawlRateTimeSeries,omitempty"` + // State: Output only. The state of the response. + // + // Possible values: + // "STATE_UNSPECIFIED" - The state is unspecified. + // "SUCCEEDED" - The state is successful. + // "FAILED" - The state is failed. + State string `json:"state,omitempty"` + // ForceSendFields is a list of field names (e.g. + // "DedicatedCrawlRateTimeSeries") to unconditionally include in API requests. + // By default, fields with empty or default values are omitted from API + // requests. See https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields + // for more details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "DedicatedCrawlRateTimeSeries") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries: The historical +// organic crawl rate timeseries data, used for monitoring. Organic crawl is +// auto-determined by Google to crawl the user's website when dedicate crawl is +// not set. Crawl rate is the QPS of crawl request Google sends to the user's +// website. +type GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries struct { + // GoogleOrganicCrawlRate: Google's organic crawl rate time series, which is + // the sum of all googlebots' crawl rate. Please refer to + // https://developers.google.com/search/docs/crawling-indexing/overview-google-crawlers + // for more details about googlebots. + GoogleOrganicCrawlRate *GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries `json:"googleOrganicCrawlRate,omitempty"` + // VertexAiOrganicCrawlRate: Vertex AI's organic crawl rate time series, which + // is the crawl rate of Google-CloudVertexBot when dedicate crawl is not set. + // Please refer to + // https://developers.google.com/search/docs/crawling-indexing/google-common-crawlers#google-cloudvertexbot + // for more details about Google-CloudVertexBot. + VertexAiOrganicCrawlRate *GoogleCloudDiscoveryengineV1alphaCrawlRateTimeSeries `json:"vertexAiOrganicCrawlRate,omitempty"` + // ForceSendFields is a list of field names (e.g. "GoogleOrganicCrawlRate") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "GoogleOrganicCrawlRate") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaProject: Metadata and configurations for a // Google Cloud project in the service. type GoogleCloudDiscoveryengineV1alphaProject struct { @@ -8573,6 +9188,321 @@ func (s GoogleCloudDiscoveryengineV1alphaWorkspaceConfig) MarshalJSON() ([]byte, return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequest: Request +// message for CompletionService.AdvancedCompleteQuery method. . +type GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequest struct { + // BoostSpec: Optional. Specification to boost suggestions matching the + // condition. + BoostSpec *GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequestBoostSpec `json:"boostSpec,omitempty"` + // IncludeTailSuggestions: Indicates if tail suggestions should be returned if + // there are no suggestions that match the full query. Even if set to true, if + // there are suggestions that match the full query, those are returned and no + // tail suggestions are returned. + IncludeTailSuggestions bool `json:"includeTailSuggestions,omitempty"` + // Query: Required. The typeahead input used to fetch suggestions. Maximum + // length is 128 characters. The query can not be empty for most of the + // suggestion types. If it is empty, an `INVALID_ARGUMENT` error is returned. + // The exception is when the suggestion_types contains only the type + // `RECENT_SEARCH`, the query can be an empty string. The is called "zero + // prefix" feature, which returns user's recently searched queries given the + // empty query. + Query string `json:"query,omitempty"` + // QueryModel: Specifies the autocomplete data model. This overrides any model + // specified in the Configuration > Autocomplete section of the Cloud console. + // Currently supported values: * `document` - Using suggestions generated from + // user-imported documents. * `search-history` - Using suggestions generated + // from the past history of SearchService.Search API calls. Do not use it when + // there is no traffic for Search API. * `user-event` - Using suggestions + // generated from user-imported search events. * `document-completable` - Using + // suggestions taken directly from user-imported document fields marked as + // completable. Default values: * `document` is the default model for regular + // dataStores. * `search-history` is the default model for site search + // dataStores. + QueryModel string `json:"queryModel,omitempty"` + // SuggestionTypes: Optional. Suggestion types to return. If empty or + // unspecified, query suggestions are returned. Only one suggestion type is + // supported at the moment. + // + // Possible values: + // "SUGGESTION_TYPE_UNSPECIFIED" - Default value. + // "QUERY" - Returns query suggestions. + // "PEOPLE" - Returns people suggestions. + // "CONTENT" - Returns content suggestions. + // "RECENT_SEARCH" - Returns recent search suggestions. + // "GOOGLE_WORKSPACE" - Returns Google Workspace suggestions. + SuggestionTypes []string `json:"suggestionTypes,omitempty"` + // UserInfo: Optional. Information about the end user. This should be the same + // identifier information as UserEvent.user_info and SearchRequest.user_info. + UserInfo *GoogleCloudDiscoveryengineV1betaUserInfo `json:"userInfo,omitempty"` + // UserPseudoId: A unique identifier for tracking visitors. For example, this + // could be implemented with an HTTP cookie, which should be able to uniquely + // identify a visitor on a single device. This unique identifier should not + // change if the visitor logs in or out of the website. This field should NOT + // have a fixed value such as `unknown_visitor`. This should be the same + // identifier as UserEvent.user_pseudo_id and SearchRequest.user_pseudo_id. The + // field must be a UTF-8 encoded string with a length limit of 128 + UserPseudoId string `json:"userPseudoId,omitempty"` + // ForceSendFields is a list of field names (e.g. "BoostSpec") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BoostSpec") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequestBoostSpec: +// Specification to boost suggestions based on the condtion of the suggestion. +type GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequestBoostSpec struct { + // ConditionBoostSpecs: Condition boost specifications. If a suggestion matches + // multiple conditions in the specifictions, boost values from these + // specifications are all applied and combined in a non-linear way. Maximum + // number of specifications is 20. Note: Currently only support language + // condition boost. + ConditionBoostSpecs []*GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequestBoostSpecConditionBoostSpec `json:"conditionBoostSpecs,omitempty"` + // ForceSendFields is a list of field names (e.g. "ConditionBoostSpecs") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ConditionBoostSpecs") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequestBoostSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequestBoostSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequestBoostSpecConditio +// nBoostSpec: Boost applies to suggestions which match a condition. +type GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequestBoostSpecConditionBoostSpec struct { + // Boost: Strength of the boost, which should be in [-1, 1]. Negative boost + // means demotion. Default is 0.0. Setting to 1.0 gives the suggestions a big + // promotion. However, it does not necessarily mean that the top result will be + // a boosted suggestion. Setting to -1.0 gives the suggestions a big demotion. + // However, other suggestions that are relevant might still be shown. Setting + // to 0.0 means no boost applied. The boosting condition is ignored. + Boost float64 `json:"boost,omitempty"` + // Condition: An expression which specifies a boost condition. The syntax is + // the same as filter expression syntax + // (https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata#filter-expression-syntax). + // Currently, the only supported condition is a list of BCP-47 lang codes. + // Example: * To boost suggestions in languages `en` or `fr`: `(lang_code: + // ANY("en", "fr"))` + Condition string `json:"condition,omitempty"` + // ForceSendFields is a list of field names (e.g. "Boost") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Boost") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequestBoostSpecConditionBoostSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequestBoostSpecConditionBoostSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequestBoostSpecConditionBoostSpec) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequestBoostSpecConditionBoostSpec + var s1 struct { + Boost gensupport.JSONFloat64 `json:"boost"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Boost = float64(s1.Boost) + return nil +} + +// GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponse: Response +// message for CompletionService.AdvancedCompleteQuery method. +type GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponse struct { + // ContentSuggestions: Results of the matched content suggestions. The result + // list is ordered and the first result is the top suggestion. + ContentSuggestions []*GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseContentSuggestion `json:"contentSuggestions,omitempty"` + // PeopleSuggestions: Results of the matched people suggestions. The result + // list is ordered and the first result is the top suggestion. + PeopleSuggestions []*GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponsePersonSuggestion `json:"peopleSuggestions,omitempty"` + // QuerySuggestions: Results of the matched query suggestions. The result list + // is ordered and the first result is a top suggestion. + QuerySuggestions []*GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseQuerySuggestion `json:"querySuggestions,omitempty"` + // RecentSearchSuggestions: Results of the matched "recent search" suggestions. + // The result list is ordered and the first result is the top suggestion. + RecentSearchSuggestions []*GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseRecentSearchSuggestion `json:"recentSearchSuggestions,omitempty"` + // TailMatchTriggered: True if the returned suggestions are all tail + // suggestions. For tail matching to be triggered, include_tail_suggestions in + // the request must be true and there must be no suggestions that match the + // full query. + TailMatchTriggered bool `json:"tailMatchTriggered,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "ContentSuggestions") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ContentSuggestions") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseContentSuggestio +// n: Suggestions as content. +type GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseContentSuggestion struct { + // ContentType: The type of the content suggestion. + // + // Possible values: + // "CONTENT_TYPE_UNSPECIFIED" - Default value. + // "GOOGLE_WORKSPACE" - The suggestion is from a Google Workspace source. + // "THIRD_PARTY" - The suggestion is from a third party source. + ContentType string `json:"contentType,omitempty"` + // DataStore: The name of the dataStore that this suggestion belongs to. + DataStore string `json:"dataStore,omitempty"` + // Document: The document data snippet in the suggestion. Only a subset of + // fields will be populated. + Document *GoogleCloudDiscoveryengineV1betaDocument `json:"document,omitempty"` + // Suggestion: The suggestion for the query. + Suggestion string `json:"suggestion,omitempty"` + // ForceSendFields is a list of field names (e.g. "ContentType") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ContentType") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseContentSuggestion) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseContentSuggestion + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponsePersonSuggestion +// : Suggestions as people. +type GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponsePersonSuggestion struct { + // DataStore: The name of the dataStore that this suggestion belongs to. + DataStore string `json:"dataStore,omitempty"` + // Document: The document data snippet in the suggestion. Only a subset of + // fields is populated. + Document *GoogleCloudDiscoveryengineV1betaDocument `json:"document,omitempty"` + // PersonType: The type of the person. + // + // Possible values: + // "PERSON_TYPE_UNSPECIFIED" - Default value. + // "CLOUD_IDENTITY" - The suggestion is from a GOOGLE_IDENTITY source. + // "THIRD_PARTY_IDENTITY" - The suggestion is from a THIRD_PARTY_IDENTITY + // source. + PersonType string `json:"personType,omitempty"` + // Suggestion: The suggestion for the query. + Suggestion string `json:"suggestion,omitempty"` + // ForceSendFields is a list of field names (e.g. "DataStore") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "DataStore") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponsePersonSuggestion) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponsePersonSuggestion + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseQuerySuggestion: +// +// Suggestions as search queries. +type GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseQuerySuggestion struct { + // CompletableFieldPaths: The unique document field paths that serve as the + // source of this suggestion if it was generated from completable fields. This + // field is only populated for the document-completable model. + CompletableFieldPaths []string `json:"completableFieldPaths,omitempty"` + // DataStore: The name of the dataStore that this suggestion belongs to. + DataStore []string `json:"dataStore,omitempty"` + // Suggestion: The suggestion for the query. + Suggestion string `json:"suggestion,omitempty"` + // ForceSendFields is a list of field names (e.g. "CompletableFieldPaths") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CompletableFieldPaths") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseQuerySuggestion) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseQuerySuggestion + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseRecentSearchSugg +// estion: Suggestions from recent search history. +type GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseRecentSearchSuggestion struct { + // RecentSearchTime: The time when this recent rearch happened. + RecentSearchTime string `json:"recentSearchTime,omitempty"` + // Suggestion: The suggestion for the query. + Suggestion string `json:"suggestion,omitempty"` + // ForceSendFields is a list of field names (e.g. "RecentSearchTime") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "RecentSearchTime") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseRecentSearchSuggestion) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseRecentSearchSuggestion + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1betaAdvancedSiteSearchConfig: Configuration data // for advance site search. type GoogleCloudDiscoveryengineV1betaAdvancedSiteSearchConfig struct { @@ -8761,6 +9691,8 @@ type GoogleCloudDiscoveryengineV1betaAnswerQueryRequest struct { // calling ConversationalSearchService.GetAnswer or // ConversationalSearchService.GetSession method. AsynchronousMode bool `json:"asynchronousMode,omitempty"` + // GroundingSpec: Optional. Grounding specification. + GroundingSpec *GoogleCloudDiscoveryengineV1betaAnswerQueryRequestGroundingSpec `json:"groundingSpec,omitempty"` // Query: Required. Current user query. Query *GoogleCloudDiscoveryengineV1betaQuery `json:"query,omitempty"` // QueryUnderstandingSpec: Query understanding specification. @@ -8925,6 +9857,40 @@ func (s GoogleCloudDiscoveryengineV1betaAnswerQueryRequestAnswerGenerationSpecPr return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1betaAnswerQueryRequestGroundingSpec: Grounding +// specification. +type GoogleCloudDiscoveryengineV1betaAnswerQueryRequestGroundingSpec struct { + // FilteringLevel: Optional. Specifies whether to enable the filtering based on + // grounding score and at what level. + // + // Possible values: + // "FILTERING_LEVEL_UNSPECIFIED" - Default is no filter + // "FILTERING_LEVEL_LOW" - Filter answers based on a low threshold. + // "FILTERING_LEVEL_HIGH" - Filter answers based on a high threshold. + FilteringLevel string `json:"filteringLevel,omitempty"` + // IncludeGroundingSupports: Optional. Specifies whether to include + // grounding_supports in the answer. The default value is `false`. When this + // field is set to `true`, returned answer will have `grounding_score` and will + // contain GroundingSupports for each claim. + IncludeGroundingSupports bool `json:"includeGroundingSupports,omitempty"` + // ForceSendFields is a list of field names (e.g. "FilteringLevel") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "FilteringLevel") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1betaAnswerQueryRequestGroundingSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaAnswerQueryRequestGroundingSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1betaAnswerQueryRequestQueryUnderstandingSpec: // Query understanding specification. type GoogleCloudDiscoveryengineV1betaAnswerQueryRequestQueryUnderstandingSpec struct { @@ -18202,11 +19168,12 @@ type GoogleCloudDiscoveryengineV1betaUserEvent struct { // `search`: Search for Documents. * `view-item`: Detailed page view of a // Document. * `view-item-list`: View of a panel or ordered list of Documents. // * `view-home-page`: View of the home page. * `view-category-page`: View of a - // category page, e.g. Home > Men > Jeans Retail-related values: * - // `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping * - // `purchase`: Purchase an item(s) Media-related values: * `media-play`: - // Start/resume watching a video, playing a song, etc. * `media-complete`: - // Finished or stopped midway through a video, song, etc. + // category page, e.g. Home > Men > Jeans * `add-feedback`: Add a user + // feedback. Retail-related values: * `add-to-cart`: Add an item(s) to cart, + // e.g. in Retail online shopping * `purchase`: Purchase an item(s) + // Media-related values: * `media-play`: Start/resume watching a video, playing + // a song, etc. * `media-complete`: Finished or stopped midway through a video, + // song, etc. EventType string `json:"eventType,omitempty"` // Filter: The filter syntax consists of an expression language for // constructing a predicate from one or more fields of the documents being @@ -18440,6 +19407,198 @@ func (s GoogleLongrunningOperation) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleMonitoringV3Point: A single data point in a time series. +type GoogleMonitoringV3Point struct { + // Interval: The time interval to which the data point applies. For `GAUGE` + // metrics, the start time is optional, but if it is supplied, it must equal + // the end time. For `DELTA` metrics, the start and end time should specify a + // non-zero interval, with subsequent points specifying contiguous and + // non-overlapping intervals. For `CUMULATIVE` metrics, the start and end time + // should specify a non-zero interval, with subsequent points specifying the + // same start time and increasing end times, until an event resets the + // cumulative value to zero and sets a new start time for the following points. + Interval *GoogleMonitoringV3TimeInterval `json:"interval,omitempty"` + // Value: The value of the data point. + Value *GoogleMonitoringV3TypedValue `json:"value,omitempty"` + // ForceSendFields is a list of field names (e.g. "Interval") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Interval") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleMonitoringV3Point) MarshalJSON() ([]byte, error) { + type NoMethod GoogleMonitoringV3Point + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleMonitoringV3TimeInterval: A time interval extending just after a start +// time through an end time. If the start time is the same as the end time, +// then the interval represents a single point in time. +type GoogleMonitoringV3TimeInterval struct { + // EndTime: Required. The end of the time interval. + EndTime string `json:"endTime,omitempty"` + // StartTime: Optional. The beginning of the time interval. The default value + // for the start time is the end time. The start time must not be later than + // the end time. + StartTime string `json:"startTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "EndTime") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "EndTime") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleMonitoringV3TimeInterval) MarshalJSON() ([]byte, error) { + type NoMethod GoogleMonitoringV3TimeInterval + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleMonitoringV3TimeSeries: A collection of data points that describes the +// time-varying values of a metric. A time series is identified by a +// combination of a fully-specified monitored resource and a fully-specified +// metric. This type is used for both listing and creating time series. +type GoogleMonitoringV3TimeSeries struct { + // Description: Input only. A detailed description of the time series that will + // be associated with the google.api.MetricDescriptor for the metric. Once set, + // this field cannot be changed through CreateTimeSeries. + Description string `json:"description,omitempty"` + // Metadata: Output only. The associated monitored resource metadata. When + // reading a time series, this field will include metadata labels that are + // explicitly named in the reduction. When creating a time series, this field + // is ignored. + Metadata *GoogleApiMonitoredResourceMetadata `json:"metadata,omitempty"` + // Metric: The associated metric. A fully-specified metric used to identify the + // time series. + Metric *GoogleApiMetric `json:"metric,omitempty"` + // MetricKind: The metric kind of the time series. When listing time series, + // this metric kind might be different from the metric kind of the associated + // metric if this time series is an alignment or reduction of other time + // series. When creating a time series, this field is optional. If present, it + // must be the same as the metric kind of the associated metric. If the + // associated metric's descriptor must be auto-created, then this field + // specifies the metric kind of the new descriptor and must be either `GAUGE` + // (the default) or `CUMULATIVE`. + // + // Possible values: + // "METRIC_KIND_UNSPECIFIED" - Do not use this default value. + // "GAUGE" - An instantaneous measurement of a value. + // "DELTA" - The change in a value during a time interval. + // "CUMULATIVE" - A value accumulated over a time interval. Cumulative + // measurements in a time series should have the same start time and increasing + // end times, until an event resets the cumulative value to zero and sets a new + // start time for the following points. + MetricKind string `json:"metricKind,omitempty"` + // Points: The data points of this time series. When listing time series, + // points are returned in reverse time order. When creating a time series, this + // field must contain exactly one point and the point's type must be the same + // as the value type of the associated metric. If the associated metric's + // descriptor must be auto-created, then the value type of the descriptor is + // determined by the point's type, which must be `BOOL`, `INT64`, `DOUBLE`, or + // `DISTRIBUTION`. + Points []*GoogleMonitoringV3Point `json:"points,omitempty"` + // Resource: The associated monitored resource. Custom metrics can use only + // certain monitored resource types in their time series data. For more + // information, see Monitored resources for custom metrics + // (https://cloud.google.com/monitoring/custom-metrics/creating-metrics#custom-metric-resources). + Resource *GoogleApiMonitoredResource `json:"resource,omitempty"` + // Unit: The units in which the metric value is reported. It is only applicable + // if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The `unit` + // defines the representation of the stored metric values. This field can only + // be changed through CreateTimeSeries when it is empty. + Unit string `json:"unit,omitempty"` + // ValueType: The value type of the time series. When listing time series, this + // value type might be different from the value type of the associated metric + // if this time series is an alignment or reduction of other time series. When + // creating a time series, this field is optional. If present, it must be the + // same as the type of the data in the `points` field. + // + // Possible values: + // "VALUE_TYPE_UNSPECIFIED" - Do not use this default value. + // "BOOL" - The value is a boolean. This value type can be used only if the + // metric kind is `GAUGE`. + // "INT64" - The value is a signed 64-bit integer. + // "DOUBLE" - The value is a double precision floating point number. + // "STRING" - The value is a text string. This value type can be used only if + // the metric kind is `GAUGE`. + // "DISTRIBUTION" - The value is a `Distribution`. + // "MONEY" - The value is money. + ValueType string `json:"valueType,omitempty"` + // ForceSendFields is a list of field names (e.g. "Description") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Description") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleMonitoringV3TimeSeries) MarshalJSON() ([]byte, error) { + type NoMethod GoogleMonitoringV3TimeSeries + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleMonitoringV3TypedValue: A single strongly-typed value. +type GoogleMonitoringV3TypedValue struct { + // BoolValue: A Boolean value: `true` or `false`. + BoolValue bool `json:"boolValue,omitempty"` + // DistributionValue: A distribution value. + DistributionValue *GoogleApiDistribution `json:"distributionValue,omitempty"` + // DoubleValue: A 64-bit double-precision floating-point number. Its magnitude + // is approximately ±10±300 and it has 16 significant digits of precision. + DoubleValue float64 `json:"doubleValue,omitempty"` + // Int64Value: A 64-bit integer. Its range is approximately ±9.2x1018. + Int64Value int64 `json:"int64Value,omitempty,string"` + // StringValue: A variable-length string value. + StringValue string `json:"stringValue,omitempty"` + // ForceSendFields is a list of field names (e.g. "BoolValue") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BoolValue") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleMonitoringV3TypedValue) MarshalJSON() ([]byte, error) { + type NoMethod GoogleMonitoringV3TypedValue + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleMonitoringV3TypedValue) UnmarshalJSON(data []byte) error { + type NoMethod GoogleMonitoringV3TypedValue + var s1 struct { + DoubleValue gensupport.JSONFloat64 `json:"doubleValue"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.DoubleValue = float64(s1.DoubleValue) + return nil +} + // GoogleProtobufEmpty: 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: @@ -21223,6 +22382,113 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesOperationsListCall) Pages } } +type ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall struct { + s *Service + completionConfig string + googleclouddiscoveryenginev1betaadvancedcompletequeryrequest *GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// CompleteQuery: Completes the user input with advanced keyword suggestions. +// +// - completionConfig: The completion_config of the parent dataStore or engine +// resource name for which the completion is performed, such as +// `projects/*/locations/global/collections/default_collection/dataStores/*/co +// mpletionConfig` +// `projects/*/locations/global/collections/default_collection/engines/*/compl +// etionConfig`. +func (r *ProjectsLocationsCollectionsDataStoresCompletionConfigService) CompleteQuery(completionConfig string, googleclouddiscoveryenginev1betaadvancedcompletequeryrequest *GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequest) *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall { + c := &ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.completionConfig = completionConfig + c.googleclouddiscoveryenginev1betaadvancedcompletequeryrequest = googleclouddiscoveryenginev1betaadvancedcompletequeryrequest + 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 *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall { + 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 *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall) 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.googleclouddiscoveryenginev1betaadvancedcompletequeryrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta/{+completionConfig}:completeQuery") + 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{ + "completionConfig": c.completionConfig, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.collections.dataStores.completionConfig.completeQuery" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponse.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 *ProjectsLocationsCollectionsDataStoresCompletionConfigCompleteQueryCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponse, 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 := &GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponse{ + 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 ProjectsLocationsCollectionsDataStoresCompletionSuggestionsImportCall struct { s *Service parent string @@ -24917,6 +26183,142 @@ func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchCall) Pages(c } } +type ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall struct { + s *Service + servingConfig string + googleclouddiscoveryenginev1betasearchrequest *GoogleCloudDiscoveryengineV1betaSearchRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SearchLite: Performs a search. Similar to the SearchService.Search method, +// but a lite version that allows API key for authentication, where OAuth and +// IAM checks are not required. Only public website search is supported by this +// method. If data stores and engines not associated with public website search +// are specified, a `FAILED_PRECONDITION` error is returned. This method can be +// used for easy onboarding without having to implement an authentication +// backend. However, it is strongly recommended to use SearchService.Search +// instead with required OAuth and IAM checks to provide better data security. +// +// - servingConfig: The resource name of the Search serving config, such as +// `projects/*/locations/global/collections/default_collection/engines/*/servi +// ngConfigs/default_serving_config`, or +// `projects/*/locations/global/collections/default_collection/dataStores/defa +// ult_data_store/servingConfigs/default_serving_config`. This field is used +// to identify the serving configuration name, set of models used to make the +// search. +func (r *ProjectsLocationsCollectionsDataStoresServingConfigsService) SearchLite(servingConfig string, googleclouddiscoveryenginev1betasearchrequest *GoogleCloudDiscoveryengineV1betaSearchRequest) *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall { + c := &ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.servingConfig = servingConfig + c.googleclouddiscoveryenginev1betasearchrequest = googleclouddiscoveryenginev1betasearchrequest + 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 *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall { + 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 *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) 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.googleclouddiscoveryenginev1betasearchrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta/{+servingConfig}:searchLite") + 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{ + "servingConfig": c.servingConfig, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.collections.dataStores.servingConfigs.searchLite" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1betaSearchResponse.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 *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1betaSearchResponse, 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 := &GoogleCloudDiscoveryengineV1betaSearchResponse{ + 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 *ProjectsLocationsCollectionsDataStoresServingConfigsSearchLiteCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1betaSearchResponse) error) error { + c.ctx_ = ctx + defer func(pt string) { c.googleclouddiscoveryenginev1betasearchrequest.PageToken = pt }(c.googleclouddiscoveryenginev1betasearchrequest.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.googleclouddiscoveryenginev1betasearchrequest.PageToken = x.NextPageToken + } +} + type ProjectsLocationsCollectionsDataStoresSessionsCreateCall struct { s *Service parent string @@ -28968,6 +30370,113 @@ func (c *ProjectsLocationsCollectionsEnginesTuneCall) Do(opts ...googleapi.CallO return ret, nil } +type ProjectsLocationsCollectionsEnginesCompletionConfigCompleteQueryCall struct { + s *Service + completionConfig string + googleclouddiscoveryenginev1betaadvancedcompletequeryrequest *GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// CompleteQuery: Completes the user input with advanced keyword suggestions. +// +// - completionConfig: The completion_config of the parent dataStore or engine +// resource name for which the completion is performed, such as +// `projects/*/locations/global/collections/default_collection/dataStores/*/co +// mpletionConfig` +// `projects/*/locations/global/collections/default_collection/engines/*/compl +// etionConfig`. +func (r *ProjectsLocationsCollectionsEnginesCompletionConfigService) CompleteQuery(completionConfig string, googleclouddiscoveryenginev1betaadvancedcompletequeryrequest *GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequest) *ProjectsLocationsCollectionsEnginesCompletionConfigCompleteQueryCall { + c := &ProjectsLocationsCollectionsEnginesCompletionConfigCompleteQueryCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.completionConfig = completionConfig + c.googleclouddiscoveryenginev1betaadvancedcompletequeryrequest = googleclouddiscoveryenginev1betaadvancedcompletequeryrequest + 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 *ProjectsLocationsCollectionsEnginesCompletionConfigCompleteQueryCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesCompletionConfigCompleteQueryCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsCollectionsEnginesCompletionConfigCompleteQueryCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesCompletionConfigCompleteQueryCall { + 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 *ProjectsLocationsCollectionsEnginesCompletionConfigCompleteQueryCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsEnginesCompletionConfigCompleteQueryCall) 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.googleclouddiscoveryenginev1betaadvancedcompletequeryrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta/{+completionConfig}:completeQuery") + 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{ + "completionConfig": c.completionConfig, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.collections.engines.completionConfig.completeQuery" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponse.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 *ProjectsLocationsCollectionsEnginesCompletionConfigCompleteQueryCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponse, 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 := &GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponse{ + 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 ProjectsLocationsCollectionsEnginesControlsCreateCall struct { s *Service parent string @@ -31240,6 +32749,142 @@ func (c *ProjectsLocationsCollectionsEnginesServingConfigsSearchCall) Pages(ctx } } +type ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall struct { + s *Service + servingConfig string + googleclouddiscoveryenginev1betasearchrequest *GoogleCloudDiscoveryengineV1betaSearchRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SearchLite: Performs a search. Similar to the SearchService.Search method, +// but a lite version that allows API key for authentication, where OAuth and +// IAM checks are not required. Only public website search is supported by this +// method. If data stores and engines not associated with public website search +// are specified, a `FAILED_PRECONDITION` error is returned. This method can be +// used for easy onboarding without having to implement an authentication +// backend. However, it is strongly recommended to use SearchService.Search +// instead with required OAuth and IAM checks to provide better data security. +// +// - servingConfig: The resource name of the Search serving config, such as +// `projects/*/locations/global/collections/default_collection/engines/*/servi +// ngConfigs/default_serving_config`, or +// `projects/*/locations/global/collections/default_collection/dataStores/defa +// ult_data_store/servingConfigs/default_serving_config`. This field is used +// to identify the serving configuration name, set of models used to make the +// search. +func (r *ProjectsLocationsCollectionsEnginesServingConfigsService) SearchLite(servingConfig string, googleclouddiscoveryenginev1betasearchrequest *GoogleCloudDiscoveryengineV1betaSearchRequest) *ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall { + c := &ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.servingConfig = servingConfig + c.googleclouddiscoveryenginev1betasearchrequest = googleclouddiscoveryenginev1betasearchrequest + 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 *ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall { + 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 *ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall) 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.googleclouddiscoveryenginev1betasearchrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta/{+servingConfig}:searchLite") + 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{ + "servingConfig": c.servingConfig, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.collections.engines.servingConfigs.searchLite" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1betaSearchResponse.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 *ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1betaSearchResponse, 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 := &GoogleCloudDiscoveryengineV1betaSearchResponse{ + 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 *ProjectsLocationsCollectionsEnginesServingConfigsSearchLiteCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1betaSearchResponse) error) error { + c.ctx_ = ctx + defer func(pt string) { c.googleclouddiscoveryenginev1betasearchrequest.PageToken = pt }(c.googleclouddiscoveryenginev1betasearchrequest.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.googleclouddiscoveryenginev1betasearchrequest.PageToken = x.NextPageToken + } +} + type ProjectsLocationsCollectionsEnginesSessionsCreateCall struct { s *Service parent string @@ -34430,6 +36075,113 @@ func (c *ProjectsLocationsDataStoresBranchesOperationsListCall) Pages(ctx contex } } +type ProjectsLocationsDataStoresCompletionConfigCompleteQueryCall struct { + s *Service + completionConfig string + googleclouddiscoveryenginev1betaadvancedcompletequeryrequest *GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// CompleteQuery: Completes the user input with advanced keyword suggestions. +// +// - completionConfig: The completion_config of the parent dataStore or engine +// resource name for which the completion is performed, such as +// `projects/*/locations/global/collections/default_collection/dataStores/*/co +// mpletionConfig` +// `projects/*/locations/global/collections/default_collection/engines/*/compl +// etionConfig`. +func (r *ProjectsLocationsDataStoresCompletionConfigService) CompleteQuery(completionConfig string, googleclouddiscoveryenginev1betaadvancedcompletequeryrequest *GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryRequest) *ProjectsLocationsDataStoresCompletionConfigCompleteQueryCall { + c := &ProjectsLocationsDataStoresCompletionConfigCompleteQueryCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.completionConfig = completionConfig + c.googleclouddiscoveryenginev1betaadvancedcompletequeryrequest = googleclouddiscoveryenginev1betaadvancedcompletequeryrequest + 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 *ProjectsLocationsDataStoresCompletionConfigCompleteQueryCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataStoresCompletionConfigCompleteQueryCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsDataStoresCompletionConfigCompleteQueryCall) Context(ctx context.Context) *ProjectsLocationsDataStoresCompletionConfigCompleteQueryCall { + 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 *ProjectsLocationsDataStoresCompletionConfigCompleteQueryCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsDataStoresCompletionConfigCompleteQueryCall) 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.googleclouddiscoveryenginev1betaadvancedcompletequeryrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta/{+completionConfig}:completeQuery") + 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{ + "completionConfig": c.completionConfig, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.dataStores.completionConfig.completeQuery" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponse.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 *ProjectsLocationsDataStoresCompletionConfigCompleteQueryCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponse, 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 := &GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponse{ + 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 ProjectsLocationsDataStoresCompletionSuggestionsImportCall struct { s *Service parent string @@ -37753,6 +39505,142 @@ func (c *ProjectsLocationsDataStoresServingConfigsSearchCall) Pages(ctx context. } } +type ProjectsLocationsDataStoresServingConfigsSearchLiteCall struct { + s *Service + servingConfig string + googleclouddiscoveryenginev1betasearchrequest *GoogleCloudDiscoveryengineV1betaSearchRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SearchLite: Performs a search. Similar to the SearchService.Search method, +// but a lite version that allows API key for authentication, where OAuth and +// IAM checks are not required. Only public website search is supported by this +// method. If data stores and engines not associated with public website search +// are specified, a `FAILED_PRECONDITION` error is returned. This method can be +// used for easy onboarding without having to implement an authentication +// backend. However, it is strongly recommended to use SearchService.Search +// instead with required OAuth and IAM checks to provide better data security. +// +// - servingConfig: The resource name of the Search serving config, such as +// `projects/*/locations/global/collections/default_collection/engines/*/servi +// ngConfigs/default_serving_config`, or +// `projects/*/locations/global/collections/default_collection/dataStores/defa +// ult_data_store/servingConfigs/default_serving_config`. This field is used +// to identify the serving configuration name, set of models used to make the +// search. +func (r *ProjectsLocationsDataStoresServingConfigsService) SearchLite(servingConfig string, googleclouddiscoveryenginev1betasearchrequest *GoogleCloudDiscoveryengineV1betaSearchRequest) *ProjectsLocationsDataStoresServingConfigsSearchLiteCall { + c := &ProjectsLocationsDataStoresServingConfigsSearchLiteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.servingConfig = servingConfig + c.googleclouddiscoveryenginev1betasearchrequest = googleclouddiscoveryenginev1betasearchrequest + 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 *ProjectsLocationsDataStoresServingConfigsSearchLiteCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataStoresServingConfigsSearchLiteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsDataStoresServingConfigsSearchLiteCall) Context(ctx context.Context) *ProjectsLocationsDataStoresServingConfigsSearchLiteCall { + 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 *ProjectsLocationsDataStoresServingConfigsSearchLiteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsDataStoresServingConfigsSearchLiteCall) 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.googleclouddiscoveryenginev1betasearchrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta/{+servingConfig}:searchLite") + 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{ + "servingConfig": c.servingConfig, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.dataStores.servingConfigs.searchLite" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1betaSearchResponse.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 *ProjectsLocationsDataStoresServingConfigsSearchLiteCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1betaSearchResponse, 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 := &GoogleCloudDiscoveryengineV1betaSearchResponse{ + 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 *ProjectsLocationsDataStoresServingConfigsSearchLiteCall) Pages(ctx context.Context, f func(*GoogleCloudDiscoveryengineV1betaSearchResponse) error) error { + c.ctx_ = ctx + defer func(pt string) { c.googleclouddiscoveryenginev1betasearchrequest.PageToken = pt }(c.googleclouddiscoveryenginev1betasearchrequest.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.googleclouddiscoveryenginev1betasearchrequest.PageToken = x.NextPageToken + } +} + type ProjectsLocationsDataStoresSessionsCreateCall struct { s *Service parent string diff --git a/displayvideo/v2/displayvideo-api.json b/displayvideo/v2/displayvideo-api.json index cbda5ea7771..2d7918667fa 100644 --- a/displayvideo/v2/displayvideo-api.json +++ b/displayvideo/v2/displayvideo-api.json @@ -9267,7 +9267,7 @@ } } }, - "revision": "20241017", + "revision": "20241024", "rootUrl": "https://displayvideo.googleapis.com/", "schemas": { "ActivateManualTriggerRequest": { @@ -9421,11 +9421,11 @@ "type": "object" }, "Adloox": { - "description": "Details of Adloox settings.", + "description": "Details of Adloox brand safety settings.", "id": "Adloox", "properties": { "excludedAdlooxCategories": { - "description": "Adloox's brand safety settings.", + "description": "Adloox categories to exclude.", "items": { "enum": [ "ADLOOX_UNSPECIFIED", @@ -9439,7 +9439,7 @@ "FRAUD" ], "enumDescriptions": [ - "This enum is only a placeholder and it doesn't specify any Adloox option.", + "Default value when a Adloox category is not specified or is unknown in this version.", "Adult content (hard).", "Adult content (soft).", "Illegal content.", @@ -9472,7 +9472,7 @@ }, "billingConfig": { "$ref": "AdvertiserBillingConfig", - "description": "Optional. Required. Billing related settings of the advertiser." + "description": "Required. Billing related settings of the advertiser." }, "creativeConfig": { "$ref": "AdvertiserCreativeConfig", @@ -9561,7 +9561,7 @@ "id": "AdvertiserBillingConfig", "properties": { "billingProfileId": { - "description": "Optional. The ID of a billing profile assigned to the advertiser.", + "description": "Required. The ID of a billing profile assigned to the advertiser.", "format": "int64", "type": "string" } diff --git a/displayvideo/v2/displayvideo-gen.go b/displayvideo/v2/displayvideo-gen.go index 908ac9da552..eee83ddabd5 100644 --- a/displayvideo/v2/displayvideo-gen.go +++ b/displayvideo/v2/displayvideo-gen.go @@ -886,13 +886,13 @@ func (s AdUrl) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Adloox: Details of Adloox settings. +// Adloox: Details of Adloox brand safety settings. type Adloox struct { - // ExcludedAdlooxCategories: Adloox's brand safety settings. + // ExcludedAdlooxCategories: Adloox categories to exclude. // // Possible values: - // "ADLOOX_UNSPECIFIED" - This enum is only a placeholder and it doesn't - // specify any Adloox option. + // "ADLOOX_UNSPECIFIED" - Default value when a Adloox category is not + // specified or is unknown in this version. // "ADULT_CONTENT_HARD" - Adult content (hard). // "ADULT_CONTENT_SOFT" - Adult content (soft). // "ILLEGAL_CONTENT" - Illegal content. @@ -928,8 +928,7 @@ type Advertiser struct { // AdvertiserId: Output only. The unique ID of the advertiser. Assigned by the // system. AdvertiserId int64 `json:"advertiserId,omitempty,string"` - // BillingConfig: Optional. Required. Billing related settings of the - // advertiser. + // BillingConfig: Required. Billing related settings of the advertiser. BillingConfig *AdvertiserBillingConfig `json:"billingConfig,omitempty"` // CreativeConfig: Required. Creative related settings of the advertiser. CreativeConfig *AdvertiserCreativeConfig `json:"creativeConfig,omitempty"` @@ -1031,7 +1030,7 @@ func (s AdvertiserAdServerConfig) MarshalJSON() ([]byte, error) { // AdvertiserBillingConfig: Billing related settings of an advertiser. type AdvertiserBillingConfig struct { - // BillingProfileId: Optional. The ID of a billing profile assigned to the + // BillingProfileId: Required. The ID of a billing profile assigned to the // advertiser. BillingProfileId int64 `json:"billingProfileId,omitempty,string"` // ForceSendFields is a list of field names (e.g. "BillingProfileId") to diff --git a/displayvideo/v3/displayvideo-api.json b/displayvideo/v3/displayvideo-api.json index 8bf08c8e9f7..659db9df709 100644 --- a/displayvideo/v3/displayvideo-api.json +++ b/displayvideo/v3/displayvideo-api.json @@ -9222,7 +9222,7 @@ } } }, - "revision": "20241017", + "revision": "20241024", "rootUrl": "https://displayvideo.googleapis.com/", "schemas": { "ActiveViewVideoViewabilityMetricConfig": { @@ -9563,11 +9563,11 @@ "type": "object" }, "Adloox": { - "description": "Details of Adloox settings.", + "description": "Details of Adloox brand safety settings.", "id": "Adloox", "properties": { "adultExplicitSexualContent": { - "description": "Optional. Adult explicit sexual content.", + "description": "Optional. Adult and Explicit Sexual Content [GARM](https://wfanet.org/leadership/garm/about-garm) risk ranges to exclude.", "enum": [ "GARM_RISK_EXCLUSION_UNSPECIFIED", "GARM_RISK_EXCLUSION_FLOOR", @@ -9576,16 +9576,16 @@ "GARM_RISK_EXCLUSION_LOW" ], "enumDescriptions": [ - "This enum is only a placeholder and it doesn't specify any GARM risk level option.", + "This enum is only a placeholder and it doesn't specify any GARM risk exclusion option.", "Exclude floor risk.", "Exclude high and floor risk.", - "Exclude high, medium, and floor risk.", - "Exclude All Level of Risk (Low, Medium, High and Floor)." + "Exclude medium, high, and floor risk.", + "Exclude all levels of risk (low, medium, high and floor)." ], "type": "string" }, "armsAmmunitionContent": { - "description": "Optional. Arms ammunition content.", + "description": "Optional. Arms and Ammunition Content [GARM](https://wfanet.org/leadership/garm/about-garm) risk ranges to exclude.", "enum": [ "GARM_RISK_EXCLUSION_UNSPECIFIED", "GARM_RISK_EXCLUSION_FLOOR", @@ -9594,16 +9594,16 @@ "GARM_RISK_EXCLUSION_LOW" ], "enumDescriptions": [ - "This enum is only a placeholder and it doesn't specify any GARM risk level option.", + "This enum is only a placeholder and it doesn't specify any GARM risk exclusion option.", "Exclude floor risk.", "Exclude high and floor risk.", - "Exclude high, medium, and floor risk.", - "Exclude All Level of Risk (Low, Medium, High and Floor)." + "Exclude medium, high, and floor risk.", + "Exclude all levels of risk (low, medium, high and floor)." ], "type": "string" }, "crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent": { - "description": "Optional. Crime harmful acts to individuals society human rights violations content.", + "description": "Optional. Crime and Harmful Acts Content [GARM](https://wfanet.org/leadership/garm/about-garm) risk ranges to exclude.", "enum": [ "GARM_RISK_EXCLUSION_UNSPECIFIED", "GARM_RISK_EXCLUSION_FLOOR", @@ -9612,16 +9612,16 @@ "GARM_RISK_EXCLUSION_LOW" ], "enumDescriptions": [ - "This enum is only a placeholder and it doesn't specify any GARM risk level option.", + "This enum is only a placeholder and it doesn't specify any GARM risk exclusion option.", "Exclude floor risk.", "Exclude high and floor risk.", - "Exclude high, medium, and floor risk.", - "Exclude All Level of Risk (Low, Medium, High and Floor)." + "Exclude medium, high, and floor risk.", + "Exclude all levels of risk (low, medium, high and floor)." ], "type": "string" }, "deathInjuryMilitaryConflictContent": { - "description": "Optional. Death injury military conflict content.", + "description": "Optional. Death, Injury, or Military Conflict Content [GARM](https://wfanet.org/leadership/garm/about-garm) risk ranges to exclude.", "enum": [ "GARM_RISK_EXCLUSION_UNSPECIFIED", "GARM_RISK_EXCLUSION_FLOOR", @@ -9630,16 +9630,16 @@ "GARM_RISK_EXCLUSION_LOW" ], "enumDescriptions": [ - "This enum is only a placeholder and it doesn't specify any GARM risk level option.", + "This enum is only a placeholder and it doesn't specify any GARM risk exclusion option.", "Exclude floor risk.", "Exclude high and floor risk.", - "Exclude high, medium, and floor risk.", - "Exclude All Level of Risk (Low, Medium, High and Floor)." + "Exclude medium, high, and floor risk.", + "Exclude all levels of risk (low, medium, high and floor)." ], "type": "string" }, "debatedSensitiveSocialIssueContent": { - "description": "Optional. Debated sensitive social issue content.", + "description": "Optional. Debated Sensitive Social Issue Content [GARM](https://wfanet.org/leadership/garm/about-garm) risk ranges to exclude.", "enum": [ "GARM_RISK_EXCLUSION_UNSPECIFIED", "GARM_RISK_EXCLUSION_FLOOR", @@ -9648,16 +9648,16 @@ "GARM_RISK_EXCLUSION_LOW" ], "enumDescriptions": [ - "This enum is only a placeholder and it doesn't specify any GARM risk level option.", + "This enum is only a placeholder and it doesn't specify any GARM risk exclusion option.", "Exclude floor risk.", "Exclude high and floor risk.", - "Exclude high, medium, and floor risk.", - "Exclude All Level of Risk (Low, Medium, High and Floor)." + "Exclude medium, high, and floor risk.", + "Exclude all levels of risk (low, medium, high and floor)." ], "type": "string" }, "displayIabViewability": { - "description": "Optional. Display IAB viewability.", + "description": "Optional. IAB viewability threshold for display ads.", "enum": [ "DISPLAY_IAB_VIEWABILITY_UNSPECIFIED", "DISPLAY_IAB_VIEWABILITY_10", @@ -9667,7 +9667,7 @@ "DISPLAY_IAB_VIEWABILITY_75" ], "enumDescriptions": [ - "This enum is only a placeholder and it doesn't specify any display viewability options.", + "Default value when not specified or is unknown in this version.", "10%+ in view (IAB display viewability standard).", "20%+ in view (IAB display viewability standard).", "35%+ in view (IAB display viewability standard).", @@ -9677,7 +9677,7 @@ "type": "string" }, "excludedAdlooxCategories": { - "description": "Adloox's brand safety settings.", + "description": "Adloox categories to exclude.", "items": { "enum": [ "ADLOOX_UNSPECIFIED", @@ -9691,7 +9691,7 @@ "FRAUD" ], "enumDescriptions": [ - "This enum is only a placeholder and it doesn't specify any Adloox option.", + "Default value when a Adloox category is not specified or is unknown in this version.", "Adult content (hard).", "Adult content (soft).", "Illegal content.", @@ -9706,14 +9706,14 @@ "type": "array" }, "excludedFraudIvtMfaCategories": { - "description": "Optional. Adloox's fraud IVT MFA settings.", + "description": "Optional. Adloox's fraud IVT MFA categories to exclude.", "items": { "enum": [ "FRAUD_IVT_MFA_CATEGORY_UNSPECIFIED", "FRAUD_IVT_MFA" ], "enumDescriptions": [ - "This enum is only a placeholder and it doesn't specify any fraud IVT MFA categories.", + "Default value when a Adloox Fraud, IVT, MFA category is not specified or is unknown in this version.", "FRAUD, IVT, MFA." ], "type": "string" @@ -9721,7 +9721,7 @@ "type": "array" }, "hateSpeechActsAggressionContent": { - "description": "Optional. Hate speech acts of aggression content.", + "description": "Optional. Hate Speech and Acts of Aggression Content [GARM](https://wfanet.org/leadership/garm/about-garm) risk ranges to exclude.", "enum": [ "GARM_RISK_EXCLUSION_UNSPECIFIED", "GARM_RISK_EXCLUSION_FLOOR", @@ -9730,16 +9730,16 @@ "GARM_RISK_EXCLUSION_LOW" ], "enumDescriptions": [ - "This enum is only a placeholder and it doesn't specify any GARM risk level option.", + "This enum is only a placeholder and it doesn't specify any GARM risk exclusion option.", "Exclude floor risk.", "Exclude high and floor risk.", - "Exclude high, medium, and floor risk.", - "Exclude All Level of Risk (Low, Medium, High and Floor)." + "Exclude medium, high, and floor risk.", + "Exclude all levels of risk (low, medium, high and floor)." ], "type": "string" }, "illegalDrugsTobaccoEcigarettesVapingAlcoholContent": { - "description": "Optional. Illegal drugs tobacco ecigarettes vaping alcohol content.", + "description": "Optional. Illegal Drugs/Alcohol Content [GARM](https://wfanet.org/leadership/garm/about-garm) risk ranges to exclude.", "enum": [ "GARM_RISK_EXCLUSION_UNSPECIFIED", "GARM_RISK_EXCLUSION_FLOOR", @@ -9748,16 +9748,16 @@ "GARM_RISK_EXCLUSION_LOW" ], "enumDescriptions": [ - "This enum is only a placeholder and it doesn't specify any GARM risk level option.", + "This enum is only a placeholder and it doesn't specify any GARM risk exclusion option.", "Exclude floor risk.", "Exclude high and floor risk.", - "Exclude high, medium, and floor risk.", - "Exclude All Level of Risk (Low, Medium, High and Floor)." + "Exclude medium, high, and floor risk.", + "Exclude all levels of risk (low, medium, high and floor)." ], "type": "string" }, "misinformationContent": { - "description": "Optional. Misinformation content.", + "description": "Optional. Misinformation Content [GARM](https://wfanet.org/leadership/garm/about-garm) risk ranges to exclude.", "enum": [ "GARM_RISK_EXCLUSION_UNSPECIFIED", "GARM_RISK_EXCLUSION_FLOOR", @@ -9766,16 +9766,16 @@ "GARM_RISK_EXCLUSION_LOW" ], "enumDescriptions": [ - "This enum is only a placeholder and it doesn't specify any GARM risk level option.", + "This enum is only a placeholder and it doesn't specify any GARM risk exclusion option.", "Exclude floor risk.", "Exclude high and floor risk.", - "Exclude high, medium, and floor risk.", - "Exclude All Level of Risk (Low, Medium, High and Floor)." + "Exclude medium, high, and floor risk.", + "Exclude all levels of risk (low, medium, high and floor)." ], "type": "string" }, "obscenityProfanityContent": { - "description": "Optional. Obscenity profanity content.", + "description": "Optional. Obscenity and Profanity Content [GARM](https://wfanet.org/leadership/garm/about-garm) risk ranges to exclude.", "enum": [ "GARM_RISK_EXCLUSION_UNSPECIFIED", "GARM_RISK_EXCLUSION_FLOOR", @@ -9784,16 +9784,16 @@ "GARM_RISK_EXCLUSION_LOW" ], "enumDescriptions": [ - "This enum is only a placeholder and it doesn't specify any GARM risk level option.", + "This enum is only a placeholder and it doesn't specify any GARM risk exclusion option.", "Exclude floor risk.", "Exclude high and floor risk.", - "Exclude high, medium, and floor risk.", - "Exclude All Level of Risk (Low, Medium, High and Floor)." + "Exclude medium, high, and floor risk.", + "Exclude all levels of risk (low, medium, high and floor)." ], "type": "string" }, "onlinePiracyContent": { - "description": "Optional. Online piracy content.", + "description": "Optional. Online Piracy Content [GARM](https://wfanet.org/leadership/garm/about-garm) risk ranges to exclude.", "enum": [ "GARM_RISK_EXCLUSION_UNSPECIFIED", "GARM_RISK_EXCLUSION_FLOOR", @@ -9802,16 +9802,16 @@ "GARM_RISK_EXCLUSION_LOW" ], "enumDescriptions": [ - "This enum is only a placeholder and it doesn't specify any GARM risk level option.", + "This enum is only a placeholder and it doesn't specify any GARM risk exclusion option.", "Exclude floor risk.", "Exclude high and floor risk.", - "Exclude high, medium, and floor risk.", - "Exclude All Level of Risk (Low, Medium, High and Floor)." + "Exclude medium, high, and floor risk.", + "Exclude all levels of risk (low, medium, high and floor)." ], "type": "string" }, "spamHarmfulContent": { - "description": "Optional. Spam harmful content.", + "description": "Optional. Spam or Harmful Content [GARM](https://wfanet.org/leadership/garm/about-garm) risk ranges to exclude.", "enum": [ "GARM_RISK_EXCLUSION_UNSPECIFIED", "GARM_RISK_EXCLUSION_FLOOR", @@ -9820,16 +9820,16 @@ "GARM_RISK_EXCLUSION_LOW" ], "enumDescriptions": [ - "This enum is only a placeholder and it doesn't specify any GARM risk level option.", + "This enum is only a placeholder and it doesn't specify any GARM risk exclusion option.", "Exclude floor risk.", "Exclude high and floor risk.", - "Exclude high, medium, and floor risk.", - "Exclude All Level of Risk (Low, Medium, High and Floor)." + "Exclude medium, high, and floor risk.", + "Exclude all levels of risk (low, medium, high and floor)." ], "type": "string" }, "terrorismContent": { - "description": "Optional. Terrorism content.", + "description": "Optional. Terrorism Content [GARM](https://wfanet.org/leadership/garm/about-garm) risk ranges to exclude.", "enum": [ "GARM_RISK_EXCLUSION_UNSPECIFIED", "GARM_RISK_EXCLUSION_FLOOR", @@ -9838,16 +9838,16 @@ "GARM_RISK_EXCLUSION_LOW" ], "enumDescriptions": [ - "This enum is only a placeholder and it doesn't specify any GARM risk level option.", + "This enum is only a placeholder and it doesn't specify any GARM risk exclusion option.", "Exclude floor risk.", "Exclude high and floor risk.", - "Exclude high, medium, and floor risk.", - "Exclude All Level of Risk (Low, Medium, High and Floor)." + "Exclude medium, high, and floor risk.", + "Exclude all levels of risk (low, medium, high and floor)." ], "type": "string" }, "videoIabViewability": { - "description": "Optional. Video IAB viewability.", + "description": "Optional. IAB viewability threshold for video ads.", "enum": [ "VIDEO_IAB_VIEWABILITY_UNSPECIFIED", "VIDEO_IAB_VIEWABILITY_10", @@ -9857,7 +9857,7 @@ "VIDEO_IAB_VIEWABILITY_75" ], "enumDescriptions": [ - "This enum is only a placeholder and it doesn't specify any video viewability options.", + "Default value when not specified or is unknown in this version.", "10%+ in view (IAB video viewability standard).", "20%+ in view (IAB video viewability standard).", "35%+ in view (IAB video viewability standard).", @@ -9885,7 +9885,7 @@ }, "billingConfig": { "$ref": "AdvertiserBillingConfig", - "description": "Optional. Required. Billing related settings of the advertiser." + "description": "Required. Billing related settings of the advertiser." }, "creativeConfig": { "$ref": "AdvertiserCreativeConfig", @@ -9974,7 +9974,7 @@ "id": "AdvertiserBillingConfig", "properties": { "billingProfileId": { - "description": "Optional. The ID of a billing profile assigned to the advertiser.", + "description": "Required. The ID of a billing profile assigned to the advertiser.", "format": "int64", "type": "string" } diff --git a/displayvideo/v3/displayvideo-gen.go b/displayvideo/v3/displayvideo-gen.go index a9068d69f82..bcde674edd2 100644 --- a/displayvideo/v3/displayvideo-gen.go +++ b/displayvideo/v3/displayvideo-gen.go @@ -1068,71 +1068,76 @@ func (s AdUrl) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Adloox: Details of Adloox settings. +// Adloox: Details of Adloox brand safety settings. type Adloox struct { - // AdultExplicitSexualContent: Optional. Adult explicit sexual content. + // AdultExplicitSexualContent: Optional. Adult and Explicit Sexual Content GARM + // (https://wfanet.org/leadership/garm/about-garm) risk ranges to exclude. // // Possible values: // "GARM_RISK_EXCLUSION_UNSPECIFIED" - This enum is only a placeholder and it - // doesn't specify any GARM risk level option. + // doesn't specify any GARM risk exclusion option. // "GARM_RISK_EXCLUSION_FLOOR" - Exclude floor risk. // "GARM_RISK_EXCLUSION_HIGH" - Exclude high and floor risk. - // "GARM_RISK_EXCLUSION_MEDIUM" - Exclude high, medium, and floor risk. - // "GARM_RISK_EXCLUSION_LOW" - Exclude All Level of Risk (Low, Medium, High - // and Floor). + // "GARM_RISK_EXCLUSION_MEDIUM" - Exclude medium, high, and floor risk. + // "GARM_RISK_EXCLUSION_LOW" - Exclude all levels of risk (low, medium, high + // and floor). AdultExplicitSexualContent string `json:"adultExplicitSexualContent,omitempty"` - // ArmsAmmunitionContent: Optional. Arms ammunition content. + // ArmsAmmunitionContent: Optional. Arms and Ammunition Content GARM + // (https://wfanet.org/leadership/garm/about-garm) risk ranges to exclude. // // Possible values: // "GARM_RISK_EXCLUSION_UNSPECIFIED" - This enum is only a placeholder and it - // doesn't specify any GARM risk level option. + // doesn't specify any GARM risk exclusion option. // "GARM_RISK_EXCLUSION_FLOOR" - Exclude floor risk. // "GARM_RISK_EXCLUSION_HIGH" - Exclude high and floor risk. - // "GARM_RISK_EXCLUSION_MEDIUM" - Exclude high, medium, and floor risk. - // "GARM_RISK_EXCLUSION_LOW" - Exclude All Level of Risk (Low, Medium, High - // and Floor). + // "GARM_RISK_EXCLUSION_MEDIUM" - Exclude medium, high, and floor risk. + // "GARM_RISK_EXCLUSION_LOW" - Exclude all levels of risk (low, medium, high + // and floor). ArmsAmmunitionContent string `json:"armsAmmunitionContent,omitempty"` // CrimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent: Optional. - // Crime harmful acts to individuals society human rights violations content. + // Crime and Harmful Acts Content GARM + // (https://wfanet.org/leadership/garm/about-garm) risk ranges to exclude. // // Possible values: // "GARM_RISK_EXCLUSION_UNSPECIFIED" - This enum is only a placeholder and it - // doesn't specify any GARM risk level option. + // doesn't specify any GARM risk exclusion option. // "GARM_RISK_EXCLUSION_FLOOR" - Exclude floor risk. // "GARM_RISK_EXCLUSION_HIGH" - Exclude high and floor risk. - // "GARM_RISK_EXCLUSION_MEDIUM" - Exclude high, medium, and floor risk. - // "GARM_RISK_EXCLUSION_LOW" - Exclude All Level of Risk (Low, Medium, High - // and Floor). + // "GARM_RISK_EXCLUSION_MEDIUM" - Exclude medium, high, and floor risk. + // "GARM_RISK_EXCLUSION_LOW" - Exclude all levels of risk (low, medium, high + // and floor). CrimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent string `json:"crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent,omitempty"` - // DeathInjuryMilitaryConflictContent: Optional. Death injury military conflict - // content. + // DeathInjuryMilitaryConflictContent: Optional. Death, Injury, or Military + // Conflict Content GARM (https://wfanet.org/leadership/garm/about-garm) risk + // ranges to exclude. // // Possible values: // "GARM_RISK_EXCLUSION_UNSPECIFIED" - This enum is only a placeholder and it - // doesn't specify any GARM risk level option. + // doesn't specify any GARM risk exclusion option. // "GARM_RISK_EXCLUSION_FLOOR" - Exclude floor risk. // "GARM_RISK_EXCLUSION_HIGH" - Exclude high and floor risk. - // "GARM_RISK_EXCLUSION_MEDIUM" - Exclude high, medium, and floor risk. - // "GARM_RISK_EXCLUSION_LOW" - Exclude All Level of Risk (Low, Medium, High - // and Floor). + // "GARM_RISK_EXCLUSION_MEDIUM" - Exclude medium, high, and floor risk. + // "GARM_RISK_EXCLUSION_LOW" - Exclude all levels of risk (low, medium, high + // and floor). DeathInjuryMilitaryConflictContent string `json:"deathInjuryMilitaryConflictContent,omitempty"` - // DebatedSensitiveSocialIssueContent: Optional. Debated sensitive social issue - // content. + // DebatedSensitiveSocialIssueContent: Optional. Debated Sensitive Social Issue + // Content GARM (https://wfanet.org/leadership/garm/about-garm) risk ranges to + // exclude. // // Possible values: // "GARM_RISK_EXCLUSION_UNSPECIFIED" - This enum is only a placeholder and it - // doesn't specify any GARM risk level option. + // doesn't specify any GARM risk exclusion option. // "GARM_RISK_EXCLUSION_FLOOR" - Exclude floor risk. // "GARM_RISK_EXCLUSION_HIGH" - Exclude high and floor risk. - // "GARM_RISK_EXCLUSION_MEDIUM" - Exclude high, medium, and floor risk. - // "GARM_RISK_EXCLUSION_LOW" - Exclude All Level of Risk (Low, Medium, High - // and Floor). + // "GARM_RISK_EXCLUSION_MEDIUM" - Exclude medium, high, and floor risk. + // "GARM_RISK_EXCLUSION_LOW" - Exclude all levels of risk (low, medium, high + // and floor). DebatedSensitiveSocialIssueContent string `json:"debatedSensitiveSocialIssueContent,omitempty"` - // DisplayIabViewability: Optional. Display IAB viewability. + // DisplayIabViewability: Optional. IAB viewability threshold for display ads. // // Possible values: - // "DISPLAY_IAB_VIEWABILITY_UNSPECIFIED" - This enum is only a placeholder - // and it doesn't specify any display viewability options. + // "DISPLAY_IAB_VIEWABILITY_UNSPECIFIED" - Default value when not specified + // or is unknown in this version. // "DISPLAY_IAB_VIEWABILITY_10" - 10%+ in view (IAB display viewability // standard). // "DISPLAY_IAB_VIEWABILITY_20" - 20%+ in view (IAB display viewability @@ -1144,11 +1149,11 @@ type Adloox struct { // "DISPLAY_IAB_VIEWABILITY_75" - 75%+ in view (IAB display viewability // standard). DisplayIabViewability string `json:"displayIabViewability,omitempty"` - // ExcludedAdlooxCategories: Adloox's brand safety settings. + // ExcludedAdlooxCategories: Adloox categories to exclude. // // Possible values: - // "ADLOOX_UNSPECIFIED" - This enum is only a placeholder and it doesn't - // specify any Adloox option. + // "ADLOOX_UNSPECIFIED" - Default value when a Adloox category is not + // specified or is unknown in this version. // "ADULT_CONTENT_HARD" - Adult content (hard). // "ADULT_CONTENT_SOFT" - Adult content (soft). // "ILLEGAL_CONTENT" - Illegal content. @@ -1158,97 +1163,105 @@ type Adloox struct { // "LOW_VIEWABILITY_DOMAINS" - Low viewability domains. // "FRAUD" - Fraud. ExcludedAdlooxCategories []string `json:"excludedAdlooxCategories,omitempty"` - // ExcludedFraudIvtMfaCategories: Optional. Adloox's fraud IVT MFA settings. + // ExcludedFraudIvtMfaCategories: Optional. Adloox's fraud IVT MFA categories + // to exclude. // // Possible values: - // "FRAUD_IVT_MFA_CATEGORY_UNSPECIFIED" - This enum is only a placeholder and - // it doesn't specify any fraud IVT MFA categories. + // "FRAUD_IVT_MFA_CATEGORY_UNSPECIFIED" - Default value when a Adloox Fraud, + // IVT, MFA category is not specified or is unknown in this version. // "FRAUD_IVT_MFA" - FRAUD, IVT, MFA. ExcludedFraudIvtMfaCategories []string `json:"excludedFraudIvtMfaCategories,omitempty"` - // HateSpeechActsAggressionContent: Optional. Hate speech acts of aggression - // content. + // HateSpeechActsAggressionContent: Optional. Hate Speech and Acts of + // Aggression Content GARM (https://wfanet.org/leadership/garm/about-garm) risk + // ranges to exclude. // // Possible values: // "GARM_RISK_EXCLUSION_UNSPECIFIED" - This enum is only a placeholder and it - // doesn't specify any GARM risk level option. + // doesn't specify any GARM risk exclusion option. // "GARM_RISK_EXCLUSION_FLOOR" - Exclude floor risk. // "GARM_RISK_EXCLUSION_HIGH" - Exclude high and floor risk. - // "GARM_RISK_EXCLUSION_MEDIUM" - Exclude high, medium, and floor risk. - // "GARM_RISK_EXCLUSION_LOW" - Exclude All Level of Risk (Low, Medium, High - // and Floor). + // "GARM_RISK_EXCLUSION_MEDIUM" - Exclude medium, high, and floor risk. + // "GARM_RISK_EXCLUSION_LOW" - Exclude all levels of risk (low, medium, high + // and floor). HateSpeechActsAggressionContent string `json:"hateSpeechActsAggressionContent,omitempty"` - // IllegalDrugsTobaccoEcigarettesVapingAlcoholContent: Optional. Illegal drugs - // tobacco ecigarettes vaping alcohol content. + // IllegalDrugsTobaccoEcigarettesVapingAlcoholContent: Optional. Illegal + // Drugs/Alcohol Content GARM (https://wfanet.org/leadership/garm/about-garm) + // risk ranges to exclude. // // Possible values: // "GARM_RISK_EXCLUSION_UNSPECIFIED" - This enum is only a placeholder and it - // doesn't specify any GARM risk level option. + // doesn't specify any GARM risk exclusion option. // "GARM_RISK_EXCLUSION_FLOOR" - Exclude floor risk. // "GARM_RISK_EXCLUSION_HIGH" - Exclude high and floor risk. - // "GARM_RISK_EXCLUSION_MEDIUM" - Exclude high, medium, and floor risk. - // "GARM_RISK_EXCLUSION_LOW" - Exclude All Level of Risk (Low, Medium, High - // and Floor). + // "GARM_RISK_EXCLUSION_MEDIUM" - Exclude medium, high, and floor risk. + // "GARM_RISK_EXCLUSION_LOW" - Exclude all levels of risk (low, medium, high + // and floor). IllegalDrugsTobaccoEcigarettesVapingAlcoholContent string `json:"illegalDrugsTobaccoEcigarettesVapingAlcoholContent,omitempty"` - // MisinformationContent: Optional. Misinformation content. + // MisinformationContent: Optional. Misinformation Content GARM + // (https://wfanet.org/leadership/garm/about-garm) risk ranges to exclude. // // Possible values: // "GARM_RISK_EXCLUSION_UNSPECIFIED" - This enum is only a placeholder and it - // doesn't specify any GARM risk level option. + // doesn't specify any GARM risk exclusion option. // "GARM_RISK_EXCLUSION_FLOOR" - Exclude floor risk. // "GARM_RISK_EXCLUSION_HIGH" - Exclude high and floor risk. - // "GARM_RISK_EXCLUSION_MEDIUM" - Exclude high, medium, and floor risk. - // "GARM_RISK_EXCLUSION_LOW" - Exclude All Level of Risk (Low, Medium, High - // and Floor). + // "GARM_RISK_EXCLUSION_MEDIUM" - Exclude medium, high, and floor risk. + // "GARM_RISK_EXCLUSION_LOW" - Exclude all levels of risk (low, medium, high + // and floor). MisinformationContent string `json:"misinformationContent,omitempty"` - // ObscenityProfanityContent: Optional. Obscenity profanity content. + // ObscenityProfanityContent: Optional. Obscenity and Profanity Content GARM + // (https://wfanet.org/leadership/garm/about-garm) risk ranges to exclude. // // Possible values: // "GARM_RISK_EXCLUSION_UNSPECIFIED" - This enum is only a placeholder and it - // doesn't specify any GARM risk level option. + // doesn't specify any GARM risk exclusion option. // "GARM_RISK_EXCLUSION_FLOOR" - Exclude floor risk. // "GARM_RISK_EXCLUSION_HIGH" - Exclude high and floor risk. - // "GARM_RISK_EXCLUSION_MEDIUM" - Exclude high, medium, and floor risk. - // "GARM_RISK_EXCLUSION_LOW" - Exclude All Level of Risk (Low, Medium, High - // and Floor). + // "GARM_RISK_EXCLUSION_MEDIUM" - Exclude medium, high, and floor risk. + // "GARM_RISK_EXCLUSION_LOW" - Exclude all levels of risk (low, medium, high + // and floor). ObscenityProfanityContent string `json:"obscenityProfanityContent,omitempty"` - // OnlinePiracyContent: Optional. Online piracy content. + // OnlinePiracyContent: Optional. Online Piracy Content GARM + // (https://wfanet.org/leadership/garm/about-garm) risk ranges to exclude. // // Possible values: // "GARM_RISK_EXCLUSION_UNSPECIFIED" - This enum is only a placeholder and it - // doesn't specify any GARM risk level option. + // doesn't specify any GARM risk exclusion option. // "GARM_RISK_EXCLUSION_FLOOR" - Exclude floor risk. // "GARM_RISK_EXCLUSION_HIGH" - Exclude high and floor risk. - // "GARM_RISK_EXCLUSION_MEDIUM" - Exclude high, medium, and floor risk. - // "GARM_RISK_EXCLUSION_LOW" - Exclude All Level of Risk (Low, Medium, High - // and Floor). + // "GARM_RISK_EXCLUSION_MEDIUM" - Exclude medium, high, and floor risk. + // "GARM_RISK_EXCLUSION_LOW" - Exclude all levels of risk (low, medium, high + // and floor). OnlinePiracyContent string `json:"onlinePiracyContent,omitempty"` - // SpamHarmfulContent: Optional. Spam harmful content. + // SpamHarmfulContent: Optional. Spam or Harmful Content GARM + // (https://wfanet.org/leadership/garm/about-garm) risk ranges to exclude. // // Possible values: // "GARM_RISK_EXCLUSION_UNSPECIFIED" - This enum is only a placeholder and it - // doesn't specify any GARM risk level option. + // doesn't specify any GARM risk exclusion option. // "GARM_RISK_EXCLUSION_FLOOR" - Exclude floor risk. // "GARM_RISK_EXCLUSION_HIGH" - Exclude high and floor risk. - // "GARM_RISK_EXCLUSION_MEDIUM" - Exclude high, medium, and floor risk. - // "GARM_RISK_EXCLUSION_LOW" - Exclude All Level of Risk (Low, Medium, High - // and Floor). + // "GARM_RISK_EXCLUSION_MEDIUM" - Exclude medium, high, and floor risk. + // "GARM_RISK_EXCLUSION_LOW" - Exclude all levels of risk (low, medium, high + // and floor). SpamHarmfulContent string `json:"spamHarmfulContent,omitempty"` - // TerrorismContent: Optional. Terrorism content. + // TerrorismContent: Optional. Terrorism Content GARM + // (https://wfanet.org/leadership/garm/about-garm) risk ranges to exclude. // // Possible values: // "GARM_RISK_EXCLUSION_UNSPECIFIED" - This enum is only a placeholder and it - // doesn't specify any GARM risk level option. + // doesn't specify any GARM risk exclusion option. // "GARM_RISK_EXCLUSION_FLOOR" - Exclude floor risk. // "GARM_RISK_EXCLUSION_HIGH" - Exclude high and floor risk. - // "GARM_RISK_EXCLUSION_MEDIUM" - Exclude high, medium, and floor risk. - // "GARM_RISK_EXCLUSION_LOW" - Exclude All Level of Risk (Low, Medium, High - // and Floor). + // "GARM_RISK_EXCLUSION_MEDIUM" - Exclude medium, high, and floor risk. + // "GARM_RISK_EXCLUSION_LOW" - Exclude all levels of risk (low, medium, high + // and floor). TerrorismContent string `json:"terrorismContent,omitempty"` - // VideoIabViewability: Optional. Video IAB viewability. + // VideoIabViewability: Optional. IAB viewability threshold for video ads. // // Possible values: - // "VIDEO_IAB_VIEWABILITY_UNSPECIFIED" - This enum is only a placeholder and - // it doesn't specify any video viewability options. + // "VIDEO_IAB_VIEWABILITY_UNSPECIFIED" - Default value when not specified or + // is unknown in this version. // "VIDEO_IAB_VIEWABILITY_10" - 10%+ in view (IAB video viewability // standard). // "VIDEO_IAB_VIEWABILITY_20" - 20%+ in view (IAB video viewability @@ -1286,8 +1299,7 @@ type Advertiser struct { // AdvertiserId: Output only. The unique ID of the advertiser. Assigned by the // system. AdvertiserId int64 `json:"advertiserId,omitempty,string"` - // BillingConfig: Optional. Required. Billing related settings of the - // advertiser. + // BillingConfig: Required. Billing related settings of the advertiser. BillingConfig *AdvertiserBillingConfig `json:"billingConfig,omitempty"` // CreativeConfig: Required. Creative related settings of the advertiser. CreativeConfig *AdvertiserCreativeConfig `json:"creativeConfig,omitempty"` @@ -1389,7 +1401,7 @@ func (s AdvertiserAdServerConfig) MarshalJSON() ([]byte, error) { // AdvertiserBillingConfig: Billing related settings of an advertiser. type AdvertiserBillingConfig struct { - // BillingProfileId: Optional. The ID of a billing profile assigned to the + // BillingProfileId: Required. The ID of a billing profile assigned to the // advertiser. BillingProfileId int64 `json:"billingProfileId,omitempty,string"` // ForceSendFields is a list of field names (e.g. "BillingProfileId") to diff --git a/dlp/v2/dlp-api.json b/dlp/v2/dlp-api.json index b789f8290f5..2e2f5bdeee3 100644 --- a/dlp/v2/dlp-api.json +++ b/dlp/v2/dlp-api.json @@ -5015,7 +5015,7 @@ } } }, - "revision": "20241006", + "revision": "20241020", "rootUrl": "https://dlp.googleapis.com/", "schemas": { "GooglePrivacyDlpV2Action": { @@ -5431,7 +5431,7 @@ "type": "string" }, "projectId": { - "description": "The Google Cloud Platform project ID of the project containing the table. If omitted, project ID is inferred from the API call.", + "description": "The Google Cloud project ID of the project containing the table. If omitted, project ID is inferred from the API call.", "type": "string" }, "tableId": { @@ -5462,12 +5462,14 @@ "enum": [ "BIG_QUERY_TABLE_TYPE_UNSPECIFIED", "BIG_QUERY_TABLE_TYPE_TABLE", - "BIG_QUERY_TABLE_TYPE_EXTERNAL_BIG_LAKE" + "BIG_QUERY_TABLE_TYPE_EXTERNAL_BIG_LAKE", + "BIG_QUERY_TABLE_TYPE_SNAPSHOT" ], "enumDescriptions": [ "Unused.", "A normal BigQuery table.", - "A table that references data stored in Cloud Storage." + "A table that references data stored in Cloud Storage.", + "A snapshot of a BigQuery table." ], "type": "string" }, diff --git a/dlp/v2/dlp-gen.go b/dlp/v2/dlp-gen.go index 121181084dc..da4179997e6 100644 --- a/dlp/v2/dlp-gen.go +++ b/dlp/v2/dlp-gen.go @@ -1184,8 +1184,8 @@ func (s GooglePrivacyDlpV2BigQueryRegexes) MarshalJSON() ([]byte, error) { type GooglePrivacyDlpV2BigQueryTable struct { // DatasetId: Dataset ID of the table. DatasetId string `json:"datasetId,omitempty"` - // ProjectId: The Google Cloud Platform project ID of the project containing - // the table. If omitted, project ID is inferred from the API call. + // ProjectId: The Google Cloud project ID of the project containing the table. + // If omitted, project ID is inferred from the API call. ProjectId string `json:"projectId,omitempty"` // TableId: Name of the table. TableId string `json:"tableId,omitempty"` @@ -1241,6 +1241,7 @@ type GooglePrivacyDlpV2BigQueryTableTypes struct { // "BIG_QUERY_TABLE_TYPE_TABLE" - A normal BigQuery table. // "BIG_QUERY_TABLE_TYPE_EXTERNAL_BIG_LAKE" - A table that references data // stored in Cloud Storage. + // "BIG_QUERY_TABLE_TYPE_SNAPSHOT" - A snapshot of a BigQuery table. Types []string `json:"types,omitempty"` // ForceSendFields is a list of field names (e.g. "Types") to unconditionally // include in API requests. By default, fields with empty or default values are diff --git a/documentai/v1beta3/documentai-api.json b/documentai/v1beta3/documentai-api.json index 76c71247efc..0acf251ef84 100644 --- a/documentai/v1beta3/documentai-api.json +++ b/documentai/v1beta3/documentai-api.json @@ -1284,7 +1284,7 @@ } } }, - "revision": "20240911", + "revision": "20241025", "rootUrl": "https://documentai.googleapis.com/", "schemas": { "GoogleCloudDocumentaiUiv1beta3AutoLabelDocumentsMetadata": { @@ -3004,6 +3004,16 @@ "name": { "description": "Dataset schema resource name. Format: `projects/{project}/locations/{location}/processors/{processor}/dataset/datasetSchema`", "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" } }, "type": "object" diff --git a/documentai/v1beta3/documentai-gen.go b/documentai/v1beta3/documentai-gen.go index 24f06cdc39a..5017cb47537 100644 --- a/documentai/v1beta3/documentai-gen.go +++ b/documentai/v1beta3/documentai-gen.go @@ -2631,6 +2631,10 @@ type GoogleCloudDocumentaiV1beta3DatasetSchema struct { // `projects/{project}/locations/{location}/processors/{processor}/dataset/datas // etSchema` 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"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` diff --git a/eventarc/v1/eventarc-api.json b/eventarc/v1/eventarc-api.json index 6940648dad9..058880c17ee 100644 --- a/eventarc/v1/eventarc-api.json +++ b/eventarc/v1/eventarc-api.json @@ -712,6 +712,109 @@ }, "enrollments": { "methods": { + "create": { + "description": "Create a new Enrollment in a particular project and location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/enrollments", + "httpMethod": "POST", + "id": "eventarc.projects.locations.enrollments.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "enrollmentId": { + "description": "Required. The user-provided ID to be assigned to the Enrollment. It should match the format (^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$).", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent collection in which to add this enrollment.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "validateOnly": { + "description": "Optional. If set, validate the request and preview the review, but do not post it.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+parent}/enrollments", + "request": { + "$ref": "Enrollment" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Delete a single Enrollment.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/enrollments/{enrollmentsId}", + "httpMethod": "DELETE", + "id": "eventarc.projects.locations.enrollments.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "allowMissing": { + "description": "Optional. If set to true, and the Enrollment is not found, the request will succeed but no action will be taken on the server.", + "location": "query", + "type": "boolean" + }, + "etag": { + "description": "Optional. If provided, the Enrollment will only be deleted if the etag matches the current etag on the resource.", + "location": "query", + "type": "string" + }, + "name": { + "description": "Required. The name of the Enrollment to be deleted.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/enrollments/[^/]+$", + "required": true, + "type": "string" + }, + "validateOnly": { + "description": "Optional. If set, validate the request and preview the review, but do not post it.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Get a single Enrollment.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/enrollments/{enrollmentsId}", + "httpMethod": "GET", + "id": "eventarc.projects.locations.enrollments.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the Enrollment to get.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/enrollments/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Enrollment" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "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}/enrollments/{enrollmentsId}:getIamPolicy", @@ -743,6 +846,96 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "list": { + "description": "List Enrollments.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/enrollments", + "httpMethod": "GET", + "id": "eventarc.projects.locations.enrollments.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "Optional. The filter field that the list request will filter on. Possible filtersare described in https://google.aip.dev/160.", + "location": "query", + "type": "string" + }, + "orderBy": { + "description": "Optional. The sorting order of the resources returned. Value should be a comma-separated list of fields. The default sorting order is ascending. To specify descending order for a field, append a `desc` suffix; for example: `name desc, update_time`.", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Optional. The maximum number of results to return on each page. Note: The service may send fewer.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. The page token; provide the value from the `next_page_token` field in a previous call to retrieve the subsequent page. When paginating, all other parameters provided must match the previous call that provided the page token.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent collection to list triggers on.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/enrollments", + "response": { + "$ref": "ListEnrollmentsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Update a single Enrollment.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/enrollments/{enrollmentsId}", + "httpMethod": "PATCH", + "id": "eventarc.projects.locations.enrollments.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "allowMissing": { + "description": "Optional. If set to true, and the Enrollment is not found, a new Enrollment will be created. In this situation, `update_mask` is ignored.", + "location": "query", + "type": "boolean" + }, + "name": { + "description": "Identifier. Resource name of the form projects/{project}/locations/{location}/enrollments/{enrollment}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/enrollments/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Optional. The fields to be updated; only fields explicitly provided are updated. If no field mask is provided, all provided fields in the request are updated. To update all fields, provide a field mask of \"*\".", + "format": "google-fieldmask", + "location": "query", + "type": "string" + }, + "validateOnly": { + "description": "Optional. If set, validate the request and preview the review, but do not post it.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "Enrollment" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "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}/enrollments/{enrollmentsId}:setIamPolicy", @@ -803,6 +996,109 @@ }, "googleApiSources": { "methods": { + "create": { + "description": "Create a new GoogleApiSource in a particular project and location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/googleApiSources", + "httpMethod": "POST", + "id": "eventarc.projects.locations.googleApiSources.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "googleApiSourceId": { + "description": "Required. The user-provided ID to be assigned to the GoogleApiSource. It should match the format (^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$).", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent collection in which to add this google api source.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "validateOnly": { + "description": "Optional. If set, validate the request and preview the review, but do not post it.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+parent}/googleApiSources", + "request": { + "$ref": "GoogleApiSource" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Delete a single GoogleApiSource.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/googleApiSources/{googleApiSourcesId}", + "httpMethod": "DELETE", + "id": "eventarc.projects.locations.googleApiSources.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "allowMissing": { + "description": "Optional. If set to true, and the MessageBus is not found, the request will succeed but no action will be taken on the server.", + "location": "query", + "type": "boolean" + }, + "etag": { + "description": "Optional. If provided, the MessageBus will only be deleted if the etag matches the current etag on the resource.", + "location": "query", + "type": "string" + }, + "name": { + "description": "Required. The name of the GoogleApiSource to be deleted.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/googleApiSources/[^/]+$", + "required": true, + "type": "string" + }, + "validateOnly": { + "description": "Optional. If set, validate the request and preview the review, but do not post it.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Get a single GoogleApiSource.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/googleApiSources/{googleApiSourcesId}", + "httpMethod": "GET", + "id": "eventarc.projects.locations.googleApiSources.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the google api source to get.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/googleApiSources/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "GoogleApiSource" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "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}/googleApiSources/{googleApiSourcesId}:getIamPolicy", @@ -834,92 +1130,411 @@ "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}/googleApiSources/{googleApiSourcesId}:setIamPolicy", - "httpMethod": "POST", - "id": "eventarc.projects.locations.googleApiSources.setIamPolicy", + "list": { + "description": "List GoogleApiSources.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/googleApiSources", + "httpMethod": "GET", + "id": "eventarc.projects.locations.googleApiSources.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "Optional. The filter field that the list request will filter on. Possible filtersare described in https://google.aip.dev/160.", + "location": "query", + "type": "string" + }, + "orderBy": { + "description": "Optional. The sorting order of the resources returned. Value should be a comma-separated list of fields. The default sorting order is ascending. To specify descending order for a field, append a `desc` suffix; for example: `name desc, update_time`.", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Optional. The maximum number of results to return on each page. Note: The service may send fewer.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. The page token; provide the value from the `next_page_token` field in a previous call to retrieve the subsequent page. When paginating, all other parameters provided must match the previous call that provided the page token.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent collection to list GoogleApiSources on.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/googleApiSources", + "response": { + "$ref": "ListGoogleApiSourcesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Update a single GoogleApiSource.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/googleApiSources/{googleApiSourcesId}", + "httpMethod": "PATCH", + "id": "eventarc.projects.locations.googleApiSources.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "allowMissing": { + "description": "Optional. If set to true, and the GoogleApiSource is not found, a new GoogleApiSource will be created. In this situation, `update_mask` is ignored.", + "location": "query", + "type": "boolean" + }, + "name": { + "description": "Identifier. Resource name of the form projects/{project}/locations/{location}/googleApiSources/{google_api_source}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/googleApiSources/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Optional. The fields to be updated; only fields explicitly provided are updated. If no field mask is provided, all provided fields in the request are updated. To update all fields, provide a field mask of \"*\".", + "format": "google-fieldmask", + "location": "query", + "type": "string" + }, + "validateOnly": { + "description": "Optional. If set, validate the request and preview the review, but do not post it.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "GoogleApiSource" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "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}/googleApiSources/{googleApiSourcesId}:setIamPolicy", + "httpMethod": "POST", + "id": "eventarc.projects.locations.googleApiSources.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/[^/]+/googleApiSources/[^/]+$", + "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}/googleApiSources/{googleApiSourcesId}:testIamPermissions", + "httpMethod": "POST", + "id": "eventarc.projects.locations.googleApiSources.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/[^/]+/googleApiSources/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:testIamPermissions", + "request": { + "$ref": "TestIamPermissionsRequest" + }, + "response": { + "$ref": "TestIamPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, + "messageBuses": { + "methods": { + "create": { + "description": "Create a new MessageBus in a particular project and location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/messageBuses", + "httpMethod": "POST", + "id": "eventarc.projects.locations.messageBuses.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "messageBusId": { + "description": "Required. The user-provided ID to be assigned to the MessageBus. It should match the format (^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$)", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent collection in which to add this message bus.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "validateOnly": { + "description": "Optional. If set, validate the request and preview the review, but do not post it.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+parent}/messageBuses", + "request": { + "$ref": "MessageBus" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Delete a single message bus.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/messageBuses/{messageBusesId}", + "httpMethod": "DELETE", + "id": "eventarc.projects.locations.messageBuses.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "allowMissing": { + "description": "Optional. If set to true, and the MessageBus is not found, the request will succeed but no action will be taken on the server.", + "location": "query", + "type": "boolean" + }, + "etag": { + "description": "Optional. If provided, the MessageBus will only be deleted if the etag matches the current etag on the resource.", + "location": "query", + "type": "string" + }, + "name": { + "description": "Required. The name of the MessageBus to be deleted.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/messageBuses/[^/]+$", + "required": true, + "type": "string" + }, + "validateOnly": { + "description": "Optional. If set, validate the request and preview the review, but do not post it.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Get a single MessageBus.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/messageBuses/{messageBusesId}", + "httpMethod": "GET", + "id": "eventarc.projects.locations.messageBuses.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the message bus to get.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/messageBuses/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "MessageBus" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "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}/messageBuses/{messageBusesId}:getIamPolicy", + "httpMethod": "GET", + "id": "eventarc.projects.locations.messageBuses.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/[^/]+/messageBuses/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "List message buses.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/messageBuses", + "httpMethod": "GET", + "id": "eventarc.projects.locations.messageBuses.list", "parameterOrder": [ - "resource" + "parent" ], "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.", + "filter": { + "description": "Optional. The filter field that the list request will filter on. Possible filtersare described in https://google.aip.dev/160.", + "location": "query", + "type": "string" + }, + "orderBy": { + "description": "Optional. The sorting order of the resources returned. Value should be a comma-separated list of fields. The default sorting order is ascending. To specify descending order for a field, append a `desc` suffix; for example: `name desc, update_time`.", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Optional. The maximum number of results to return on each page. Note: The service may send fewer.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. The page token; provide the value from the `next_page_token` field in a previous call to retrieve the subsequent page. When paginating, all other parameters provided must match the previous call that provided the page token.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent collection to list triggers on.", "location": "path", - "pattern": "^projects/[^/]+/locations/[^/]+/googleApiSources/[^/]+$", + "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "type": "string" } }, - "path": "v1/{+resource}:setIamPolicy", - "request": { - "$ref": "SetIamPolicyRequest" - }, + "path": "v1/{+parent}/messageBuses", "response": { - "$ref": "Policy" + "$ref": "ListMessageBusesResponse" }, "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}/googleApiSources/{googleApiSourcesId}:testIamPermissions", - "httpMethod": "POST", - "id": "eventarc.projects.locations.googleApiSources.testIamPermissions", + "listEnrollments": { + "description": "List message bus enrollments.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/messageBuses/{messageBusesId}:listEnrollments", + "httpMethod": "GET", + "id": "eventarc.projects.locations.messageBuses.listEnrollments", "parameterOrder": [ - "resource" + "parent" ], "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.", + "pageSize": { + "description": "Optional. The maximum number of results to return on each page. Note: The service may send fewer.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. The page token; provide the value from the `next_page_token` field in a previous call to retrieve the subsequent page. When paginating, all other parameters provided must match the previous call that provided the page token.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent message bus to list enrollments on.", "location": "path", - "pattern": "^projects/[^/]+/locations/[^/]+/googleApiSources/[^/]+$", + "pattern": "^projects/[^/]+/locations/[^/]+/messageBuses/[^/]+$", "required": true, "type": "string" } }, - "path": "v1/{+resource}:testIamPermissions", - "request": { - "$ref": "TestIamPermissionsRequest" - }, + "path": "v1/{+parent}:listEnrollments", "response": { - "$ref": "TestIamPermissionsResponse" + "$ref": "ListMessageBusEnrollmentsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] - } - } - }, - "messageBuses": { - "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}/messageBuses/{messageBusesId}:getIamPolicy", - "httpMethod": "GET", - "id": "eventarc.projects.locations.messageBuses.getIamPolicy", + }, + "patch": { + "description": "Update a single message bus.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/messageBuses/{messageBusesId}", + "httpMethod": "PATCH", + "id": "eventarc.projects.locations.messageBuses.patch", "parameterOrder": [ - "resource" + "name" ], "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", + "allowMissing": { + "description": "Optional. If set to true, and the MessageBus is not found, a new MessageBus will be created. In this situation, `update_mask` is ignored.", "location": "query", - "type": "integer" + "type": "boolean" }, - "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.", + "name": { + "description": "Identifier. Resource name of the form projects/{project}/locations/{location}/messageBuses/{message_bus}", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/messageBuses/[^/]+$", "required": true, "type": "string" + }, + "updateMask": { + "description": "Optional. The fields to be updated; only fields explicitly provided are updated. If no field mask is provided, all provided fields in the request are updated. To update all fields, provide a field mask of \"*\".", + "format": "google-fieldmask", + "location": "query", + "type": "string" + }, + "validateOnly": { + "description": "Optional. If set, validate the request and preview the review, but do not post it.", + "location": "query", + "type": "boolean" } }, - "path": "v1/{+resource}:getIamPolicy", + "path": "v1/{+name}", + "request": { + "$ref": "MessageBus" + }, "response": { - "$ref": "Policy" + "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" @@ -1091,49 +1706,242 @@ "type": "integer" }, "pageToken": { - "description": "The standard list page token.", + "description": "The standard list page token.", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}/operations", + "response": { + "$ref": "GoogleLongrunningListOperationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, + "pipelines": { + "methods": { + "create": { + "description": "Create a new Pipeline in a particular project and location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/pipelines", + "httpMethod": "POST", + "id": "eventarc.projects.locations.pipelines.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent collection in which to add this pipeline.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "pipelineId": { + "description": "Required. The user-provided ID to be assigned to the Pipeline.", + "location": "query", + "type": "string" + }, + "validateOnly": { + "description": "Optional. If set, validate the request and preview the review, but do not post it.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+parent}/pipelines", + "request": { + "$ref": "Pipeline" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Delete a single pipeline.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/pipelines/{pipelinesId}", + "httpMethod": "DELETE", + "id": "eventarc.projects.locations.pipelines.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "allowMissing": { + "description": "Optional. If set to true, and the Pipeline is not found, the request will succeed but no action will be taken on the server.", + "location": "query", + "type": "boolean" + }, + "etag": { + "description": "Optional. If provided, the Pipeline will only be deleted if the etag matches the current etag on the resource.", + "location": "query", + "type": "string" + }, + "name": { + "description": "Required. The name of the Pipeline to be deleted.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/pipelines/[^/]+$", + "required": true, + "type": "string" + }, + "validateOnly": { + "description": "Optional. If set, validate the request and preview the review, but do not post it.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Get a single Pipeline.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/pipelines/{pipelinesId}", + "httpMethod": "GET", + "id": "eventarc.projects.locations.pipelines.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the pipeline to get.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/pipelines/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Pipeline" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "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}/pipelines/{pipelinesId}:getIamPolicy", + "httpMethod": "GET", + "id": "eventarc.projects.locations.pipelines.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/[^/]+/pipelines/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "List pipelines.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/pipelines", + "httpMethod": "GET", + "id": "eventarc.projects.locations.pipelines.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "Optional. The filter field that the list request will filter on. Possible filters are described in https://google.aip.dev/160.", + "location": "query", + "type": "string" + }, + "orderBy": { + "description": "Optional. The sorting order of the resources returned. Value should be a comma-separated list of fields. The default sorting order is ascending. To specify descending order for a field, append a `desc` suffix; for example: `name desc, update_time`.", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Optional. The maximum number of results to return on each page. Note: The service may send fewer.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. The page token; provide the value from the `next_page_token` field in a previous call to retrieve the subsequent page. When paginating, all other parameters provided must match the previous call that provided the page token.", "location": "query", "type": "string" + }, + "parent": { + "description": "Required. The parent collection to list pipelines on.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" } }, - "path": "v1/{+name}/operations", + "path": "v1/{+parent}/pipelines", "response": { - "$ref": "GoogleLongrunningListOperationsResponse" + "$ref": "ListPipelinesResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] - } - } - }, - "pipelines": { - "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}/pipelines/{pipelinesId}:getIamPolicy", - "httpMethod": "GET", - "id": "eventarc.projects.locations.pipelines.getIamPolicy", + }, + "patch": { + "description": "Update a single pipeline.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/pipelines/{pipelinesId}", + "httpMethod": "PATCH", + "id": "eventarc.projects.locations.pipelines.patch", "parameterOrder": [ - "resource" + "name" ], "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", + "allowMissing": { + "description": "Optional. If set to true, and the Pipeline is not found, a new Pipeline will be created. In this situation, `update_mask` is ignored.", "location": "query", - "type": "integer" + "type": "boolean" }, - "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.", + "name": { + "description": "Identifier. The resource name of the Pipeline. Must be unique within the location of the project and must be in `projects/{project}/locations/{location}/pipelines/{pipeline}` format.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/pipelines/[^/]+$", "required": true, "type": "string" + }, + "updateMask": { + "description": "Optional. The fields to be updated; only fields explicitly provided are updated. If no field mask is provided, all provided fields in the request are updated. To update all fields, provide a field mask of \"*\".", + "format": "google-fieldmask", + "location": "query", + "type": "string" + }, + "validateOnly": { + "description": "Optional. If set, validate the request and preview the review, but do not post it.", + "location": "query", + "type": "boolean" } }, - "path": "v1/{+resource}:getIamPolicy", + "path": "v1/{+name}", + "request": { + "$ref": "Pipeline" + }, "response": { - "$ref": "Policy" + "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" @@ -1561,7 +2369,7 @@ } } }, - "revision": "20240913", + "revision": "20241021", "rootUrl": "https://eventarc.googleapis.com/", "schemas": { "AuditConfig": { @@ -1794,6 +2602,69 @@ "properties": {}, "type": "object" }, + "Enrollment": { + "description": "An enrollment represents a subscription for messages on a particular message bus. It defines a matching criteria for messages on the bus and the subscriber endpoint where matched messages should be delivered.", + "id": "Enrollment", + "properties": { + "annotations": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Resource annotations.", + "type": "object" + }, + "celMatch": { + "description": "Required. A CEL expression identifying which messages this enrollment applies to.", + "type": "string" + }, + "createTime": { + "description": "Output only. The creation time.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "destination": { + "description": "Required. Destination is the Pipeline that the Enrollment is delivering to. It must point to the full resource name of a Pipeline. Format: \"projects/{PROJECT_ID}/locations/{region}/pipelines/{PIPELINE_ID)\"", + "type": "string" + }, + "displayName": { + "description": "Optional. Resource display name.", + "type": "string" + }, + "etag": { + "description": "Output only. This checksum is computed by the server based on the value of other fields, and might be sent only on update and delete requests to ensure that the client has an up-to-date value before proceeding.", + "readOnly": true, + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Resource labels.", + "type": "object" + }, + "messageBus": { + "description": "Required. Resource name of the message bus identifying the source of the messages. It matches the form projects/{project}/locations/{location}/messageBuses/{messageBus}.", + "type": "string" + }, + "name": { + "description": "Identifier. Resource name of the form projects/{project}/locations/{location}/enrollments/{enrollment}", + "type": "string" + }, + "uid": { + "description": "Output only. Server assigned unique identifier for the channel. The value is a UUID4 string and guaranteed to remain unchanged until the resource is deleted.", + "readOnly": true, + "type": "string" + }, + "updateTime": { + "description": "Output only. The last-modified time.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "EventFilter": { "description": "Filters events based on exact matches on the CloudEvents attributes.", "id": "EventFilter", @@ -1893,49 +2764,309 @@ }, "type": "object" }, - "GKE": { - "description": "Represents a GKE destination.", - "id": "GKE", + "GKE": { + "description": "Represents a GKE destination.", + "id": "GKE", + "properties": { + "cluster": { + "description": "Required. The name of the cluster the GKE service is running in. The cluster must be running in the same project as the trigger being created.", + "type": "string" + }, + "location": { + "description": "Required. The name of the Google Compute Engine in which the cluster resides, which can either be compute zone (for example, us-central1-a) for the zonal clusters or region (for example, us-central1) for regional clusters.", + "type": "string" + }, + "namespace": { + "description": "Required. The namespace the GKE service is running in.", + "type": "string" + }, + "path": { + "description": "Optional. The relative path on the GKE service the events should be sent to. The value must conform to the definition of a URI path segment (section 3.3 of RFC2396). Examples: \"/route\", \"route\", \"route/subroute\".", + "type": "string" + }, + "service": { + "description": "Required. Name of the GKE service.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleApiSource": { + "description": "A GoogleApiSource represents a subscription of 1P events from a MessageBus.", + "id": "GoogleApiSource", + "properties": { + "annotations": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Resource annotations.", + "type": "object" + }, + "createTime": { + "description": "Output only. The creation time.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "cryptoKeyName": { + "description": "Optional. Resource name of a KMS crypto key (managed by the user) used to encrypt/decrypt their event data. It must match the pattern `projects/*/locations/*/keyRings/*/cryptoKeys/*`.", + "type": "string" + }, + "destination": { + "description": "Required. Destination is the message bus that the GoogleApiSource is delivering to. It must be point to the full resource name of a MessageBus. Format: \"projects/{PROJECT_ID}/locations/{region}/messagesBuses/{MESSAGE_BUS_ID)", + "type": "string" + }, + "displayName": { + "description": "Optional. Resource display name.", + "type": "string" + }, + "etag": { + "description": "Output only. This checksum is computed by the server based on the value of other fields, and might be sent only on update and delete requests to ensure that the client has an up-to-date value before proceeding.", + "readOnly": true, + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Resource labels.", + "type": "object" + }, + "loggingConfig": { + "$ref": "LoggingConfig", + "description": "Optional. Config to control Platform logging for the GoogleApiSource." + }, + "name": { + "description": "Identifier. Resource name of the form projects/{project}/locations/{location}/googleApiSources/{google_api_source}", + "type": "string" + }, + "uid": { + "description": "Output only. Server assigned unique identifier for the channel. The value is a UUID4 string and guaranteed to remain unchanged until the resource is deleted.", + "readOnly": true, + "type": "string" + }, + "updateTime": { + "description": "Output only. The last-modified time.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleChannelConfig": { + "description": "A GoogleChannelConfig is a resource that stores the custom settings respected by Eventarc first-party triggers in the matching region. Once configured, first-party event data will be protected using the specified custom managed encryption key instead of Google-managed encryption keys.", + "id": "GoogleChannelConfig", + "properties": { + "cryptoKeyName": { + "description": "Optional. Resource name of a KMS crypto key (managed by the user) used to encrypt/decrypt their event data. It must match the pattern `projects/*/locations/*/keyRings/*/cryptoKeys/*`.", + "type": "string" + }, + "name": { + "description": "Required. The resource name of the config. Must be in the format of, `projects/{project}/locations/{location}/googleChannelConfig`.", + "type": "string" + }, + "updateTime": { + "description": "Output only. The last-modified time.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudEventarcV1PipelineDestination": { + "description": "Represents a target of an invocation over HTTP.", + "id": "GoogleCloudEventarcV1PipelineDestination", + "properties": { + "authenticationConfig": { + "$ref": "GoogleCloudEventarcV1PipelineDestinationAuthenticationConfig", + "description": "Optional. An authentication config used to authenticate message requests, such that destinations can verify the source. For example, this can be used with private GCP destinations that require GCP credentials to access like Cloud Run. This field is optional and should be set only by users interested in authenticated push" + }, + "httpEndpoint": { + "$ref": "GoogleCloudEventarcV1PipelineDestinationHttpEndpoint", + "description": "Optional. An HTTP endpoint destination described by an URI. If a DNS FQDN is provided as the endpoint, Pipeline will create a peering zone to the consumer VPC and forward DNS requests to the VPC specified by network config to resolve the service endpoint. See: https://cloud.google.com/dns/docs/zones/zones-overview#peering_zones" + }, + "messageBus": { + "description": "Optional. The resource name of the Message Bus to which events should be published. The Message Bus resource should exist in the same project as the Pipeline. Format: `projects/{project}/locations/{location}/messageBuses/{message_bus}`", + "type": "string" + }, + "networkConfig": { + "$ref": "GoogleCloudEventarcV1PipelineDestinationNetworkConfig", + "description": "Optional. Network config is used to configure how Pipeline resolves and connects to a destination." + }, + "outputPayloadFormat": { + "$ref": "GoogleCloudEventarcV1PipelineMessagePayloadFormat", + "description": "Optional. The message format before it is delivered to the destination. If not set, the message will be delivered in the format it was originally delivered to the Pipeline. This field can only be set if Pipeline.input_payload_format is also set." + }, + "topic": { + "description": "Optional. The resource name of the Pub/Sub topic to which events should be published. Format: `projects/{project}/locations/{location}/topics/{topic}`", + "type": "string" + }, + "workflow": { + "description": "Optional. The resource name of the Workflow whose Executions are triggered by the events. The Workflow resource should be deployed in the same project as the Pipeline. Format: `projects/{project}/locations/{location}/workflows/{workflow}`", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudEventarcV1PipelineDestinationAuthenticationConfig": { + "description": "Represents a config used to authenticate message requests.", + "id": "GoogleCloudEventarcV1PipelineDestinationAuthenticationConfig", + "properties": { + "googleOidc": { + "$ref": "GoogleCloudEventarcV1PipelineDestinationAuthenticationConfigOidcToken", + "description": "Optional. This authenticate method will apply Google OIDC tokens signed by a GCP service account to the requests." + }, + "oauthToken": { + "$ref": "GoogleCloudEventarcV1PipelineDestinationAuthenticationConfigOAuthToken", + "description": "Optional. 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." + } + }, + "type": "object" + }, + "GoogleCloudEventarcV1PipelineDestinationAuthenticationConfigOAuthToken": { + "description": "Contains information needed for generating an [OAuth token](https://developers.google.com/identity/protocols/OAuth2). This type of authorization should generally only be used when calling Google APIs hosted on *.googleapis.com.", + "id": "GoogleCloudEventarcV1PipelineDestinationAuthenticationConfigOAuthToken", + "properties": { + "scope": { + "description": "Optional. OAuth scope to be used for generating OAuth access token. If not specified, \"https://www.googleapis.com/auth/cloud-platform\" will be used.", + "type": "string" + }, + "serviceAccount": { + "description": "Required. Service account email used to generate the [OAuth token](https://developers.google.com/identity/protocols/OAuth2). The principal who calls this API must have iam.serviceAccounts.actAs permission in the service account. See https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common for more information. Eventarc service agents must have roles/roles/iam.serviceAccountTokenCreator role to allow Pipeline to create OAuth2 tokens for authenticated requests.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudEventarcV1PipelineDestinationAuthenticationConfigOidcToken": { + "description": "Represents a config used to authenticate with a Google OIDC token using a GCP service account. Use this authentication method to invoke your Cloud Run and Cloud Functions destinations or HTTP endpoints that support Google OIDC.", + "id": "GoogleCloudEventarcV1PipelineDestinationAuthenticationConfigOidcToken", + "properties": { + "audience": { + "description": "Optional. Audience to be used to generate the OIDC Token. The audience claim identifies the recipient that the JWT is intended for. If unspecified, the destination URI will be used.", + "type": "string" + }, + "serviceAccount": { + "description": "Required. Service account email used to generate the OIDC Token. The principal who calls this API must have iam.serviceAccounts.actAs permission in the service account. See https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common for more information. Eventarc service agents must have roles/roles/iam.serviceAccountTokenCreator role to allow the Pipeline to create OpenID tokens for authenticated requests.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudEventarcV1PipelineDestinationHttpEndpoint": { + "description": "Represents a HTTP endpoint destination.", + "id": "GoogleCloudEventarcV1PipelineDestinationHttpEndpoint", + "properties": { + "messageBindingTemplate": { + "description": "Optional. The CEL expression used to construct a new HTTP request to be sent to the final destination. The result of the CEL expression must be a map of key/value pairs such that: - If a map named `headers` exists on the result of the expression, then its key/value pairs are directly mapped to the HTTP request headers. The headers values are constructed from the corresponding value type’s canonical representation. If the `headers` field doesn’t exist then the resulting HTTP request will be without headers. - If a field named `body` exists on the result of the expression then its value is directly mapped to the body of the request. If the value of the `body` field is of type bytes or string then it is used for the HTTP request body as-is, with no conversion. If the body field is of any other type then it is converted to a JSON string. If the body field doesn’t exist then the resulting HTTP request will be without a body. - Any other fields in the resulting expression will be ignored. The CEL expression may access the incoming CloudEvent message in its definition, as follows: - The `data` field of the incoming CloudEvent message can be accessed using the `message.data` value. - Each attribute of the incoming CloudEvent message can be accessed using the `message.` value, where is replaced with the name of the attribute. Headers added to the request by previous filters in the chain can be accessed in the CEL expression using the `headers` variable. The `headers` variable defines a map of key/value pairs corresponding to the HTTP headers added by previous mediation steps and not the headers present on the original incoming request. For example, the following CEL expression can be used to construct a Headers-only HTTP request by adding an additional header to the headers added by previous mediations in the Pipeline: ``` {\"headers\": headers.merge({\"new-header-key\": \"new-header-value\"})} ``` Additionally, the following CEL extension functions are provided for use in this CEL expression: - toBase64Url: map.toBase64Url() -\u003e string - Converts a CelValue to a base64url encoded string - toJsonString: map.toJsonString() -\u003e string - Converts a CelValue to a JSON string - merge: map1.merge(map2) -\u003e map3 - Merges the passed CEL map with the existing CEL map the function is applied to. - If the same key exists in both maps, if the key's value is type map both maps are merged else the value from the passed map is used. - toMap: list(map).toMap() -\u003e map - Converts a CEL list of CEL maps to a single CEL map - toDestinationPayloadFormat(): message.data.toDestinationPayloadFormat() -\u003e string or bytes - Converts the message data to the destination payload format specified in Pipeline.Destination.output_payload_format - This function is meant to be applied to the message.data field. - If the destination payload format is not set, the function will return the message data unchanged. - toCloudEventJsonWithPayloadFormat: message.toCloudEventJsonWithPayloadFormat() -\u003e map - Converts a message to the corresponding structure of JSON format for CloudEvents - This function applies toDestinationPayloadFormat() to the message data. It also sets the corresponding datacontenttype of the CloudEvent, as indicated by Pipeline.Destination.output_payload_format. If no output_payload_format is set it will use the existing datacontenttype on the CloudEvent if present, else leave datacontenttype absent. - This function expects that the content of the message will adhere to the standard CloudEvent format. If it doesn’t then this function will fail. - The result is a CEL map that corresponds to the JSON representation of the CloudEvent. To convert that data to a JSON string it can be chained with the toJsonString function. If a binding is not specified here, by default the message is treated as a CloudEvent and is mapped to the HTTP request according to the CloudEvent HTTP Protocol Binding Binary Content Mode. The Pipeline converts the data field of the message to the format provided in Pipeline.Destination.output_payload_format and maps it to the body field of the result. It also sets the corresponding Content-Type header to the output_payload_format type. If the Pipeline.Destination.output_payload_format is not set, then the Pipeline will treat the data field of the message as opaque binary data and attach it to the request body as bytes. In this case the Content-type header will be set to the value of the datacontenttype attribute set on the incoming CloudEvent message if present and the `application/octet-stream` MIME type otherwise. The Pipeline expects that the content of the message will adhere to the standard CloudEvent format. If it doesn’t then the outgoing message request may fail with a persistent error.", + "type": "string" + }, + "uri": { + "description": "Required. The URI of the HTTP enpdoint. The value must be a RFC2396 URI string. Examples: `http://10.10.10.8:80/route`, `http://svc.us-central1.p.local:8080/`. Only HTTP and HTTPS protocols are supported. The host can be either a static IP addressable from the VPC specified by the network config, or an internal DNS hostname of the service resolvable via Cloud DNS.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudEventarcV1PipelineDestinationNetworkConfig": { + "description": "Represents a network config to be used for destination resolution and connectivity.", + "id": "GoogleCloudEventarcV1PipelineDestinationNetworkConfig", + "properties": { + "networkAttachment": { + "description": "Required. Name of the NetworkAttachment that allows access to the consumer VPC. Format: `projects/{PROJECT_ID}/regions/{REGION}/networkAttachments/{NETWORK_ATTACHMENT_NAME}`", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudEventarcV1PipelineMediation": { + "description": "Mediation defines different ways to modify the Pipeline.", + "id": "GoogleCloudEventarcV1PipelineMediation", "properties": { - "cluster": { - "description": "Required. The name of the cluster the GKE service is running in. The cluster must be running in the same project as the trigger being created.", - "type": "string" - }, - "location": { - "description": "Required. The name of the Google Compute Engine in which the cluster resides, which can either be compute zone (for example, us-central1-a) for the zonal clusters or region (for example, us-central1) for regional clusters.", - "type": "string" - }, - "namespace": { - "description": "Required. The namespace the GKE service is running in.", + "transformation": { + "$ref": "GoogleCloudEventarcV1PipelineMediationTransformation", + "description": "Optional. How the Pipeline is to transform messages" + } + }, + "type": "object" + }, + "GoogleCloudEventarcV1PipelineMediationTransformation": { + "description": "Transformation defines the way to transform an incoming message.", + "id": "GoogleCloudEventarcV1PipelineMediationTransformation", + "properties": { + "transformationTemplate": { + "description": "Optional. The template to apply to transform messages.", "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudEventarcV1PipelineMessagePayloadFormat": { + "description": "Represents the format of message data.", + "id": "GoogleCloudEventarcV1PipelineMessagePayloadFormat", + "properties": { + "avro": { + "$ref": "GoogleCloudEventarcV1PipelineMessagePayloadFormatAvroFormat", + "description": "Optional. Avro format." }, - "path": { - "description": "Optional. The relative path on the GKE service the events should be sent to. The value must conform to the definition of a URI path segment (section 3.3 of RFC2396). Examples: \"/route\", \"route\", \"route/subroute\".", - "type": "string" + "json": { + "$ref": "GoogleCloudEventarcV1PipelineMessagePayloadFormatJsonFormat", + "description": "Optional. JSON format." }, - "service": { - "description": "Required. Name of the GKE service.", + "protobuf": { + "$ref": "GoogleCloudEventarcV1PipelineMessagePayloadFormatProtobufFormat", + "description": "Optional. Protobuf format." + } + }, + "type": "object" + }, + "GoogleCloudEventarcV1PipelineMessagePayloadFormatAvroFormat": { + "description": "The format of an AVRO message payload.", + "id": "GoogleCloudEventarcV1PipelineMessagePayloadFormatAvroFormat", + "properties": { + "schemaDefinition": { + "description": "Optional. The entire schema definition is stored in this field.", "type": "string" } }, "type": "object" }, - "GoogleChannelConfig": { - "description": "A GoogleChannelConfig is a resource that stores the custom settings respected by Eventarc first-party triggers in the matching region. Once configured, first-party event data will be protected using the specified custom managed encryption key instead of Google-managed encryption keys.", - "id": "GoogleChannelConfig", + "GoogleCloudEventarcV1PipelineMessagePayloadFormatJsonFormat": { + "description": "The format of a JSON message payload.", + "id": "GoogleCloudEventarcV1PipelineMessagePayloadFormatJsonFormat", + "properties": {}, + "type": "object" + }, + "GoogleCloudEventarcV1PipelineMessagePayloadFormatProtobufFormat": { + "description": "The format of a Protobuf message payload.", + "id": "GoogleCloudEventarcV1PipelineMessagePayloadFormatProtobufFormat", "properties": { - "cryptoKeyName": { - "description": "Optional. Resource name of a KMS crypto key (managed by the user) used to encrypt/decrypt their event data. It must match the pattern `projects/*/locations/*/keyRings/*/cryptoKeys/*`.", + "schemaDefinition": { + "description": "Optional. The entire schema definition is stored in this field.", "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudEventarcV1PipelineRetryPolicy": { + "description": "The retry policy configuration for the Pipeline. The pipeline exponentially backs off in case the destination is non responsive or returns a retryable error code. The default semantics are as follows: The backoff starts with a 5 second delay and doubles the delay after each failed attempt (10 seconds, 20 seconds, 40 seconds, etc.). The delay is capped at 60 seconds by default. Please note that if you set the min_retry_delay and max_retry_delay fields to the same value this will make the duration between retries constant.", + "id": "GoogleCloudEventarcV1PipelineRetryPolicy", + "properties": { + "maxAttempts": { + "description": "Optional. The maximum number of delivery attempts for any message. The value must be between 1 and 100. The default value for this field is 5.", + "format": "int32", + "type": "integer" }, - "name": { - "description": "Required. The resource name of the config. Must be in the format of, `projects/{project}/locations/{location}/googleChannelConfig`.", + "maxRetryDelay": { + "description": "Optional. The maximum amount of seconds to wait between retry attempts. The value must be between 0 and 600. The default value for this field is 60.", + "format": "google-duration", "type": "string" }, - "updateTime": { - "description": "Output only. The last-modified time.", - "format": "google-datetime", - "readOnly": true, + "minRetryDelay": { + "description": "Optional. The minimum amount of seconds to wait between retry attempts. The value must be between 0 and 600. The default value for this field is 5.", + "format": "google-duration", "type": "string" } }, @@ -2088,6 +3219,56 @@ }, "type": "object" }, + "ListEnrollmentsResponse": { + "description": "The response message for the `ListEnrollments` method.", + "id": "ListEnrollmentsResponse", + "properties": { + "enrollments": { + "description": "The requested Enrollments, up to the number specified in `page_size`.", + "items": { + "$ref": "Enrollment" + }, + "type": "array" + }, + "nextPageToken": { + "description": "A page token that can be sent to `ListEnrollments` to request the next page. If this is empty, then there are no more pages.", + "type": "string" + }, + "unreachable": { + "description": "Unreachable resources, if any.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "ListGoogleApiSourcesResponse": { + "description": "The response message for the `ListGoogleApiSources` method.", + "id": "ListGoogleApiSourcesResponse", + "properties": { + "googleApiSources": { + "description": "The requested GoogleApiSources, up to the number specified in `page_size`.", + "items": { + "$ref": "GoogleApiSource" + }, + "type": "array" + }, + "nextPageToken": { + "description": "A page token that can be sent to `ListMessageBusEnrollments` to request the next page. If this is empty, then there are no more pages.", + "type": "string" + }, + "unreachable": { + "description": "Unreachable resources, if any.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "ListLocationsResponse": { "description": "The response message for Locations.ListLocations.", "id": "ListLocationsResponse", @@ -2106,6 +3287,81 @@ }, "type": "object" }, + "ListMessageBusEnrollmentsResponse": { + "description": "The response message for the `ListMessageBusEnrollments` method.`", + "id": "ListMessageBusEnrollmentsResponse", + "properties": { + "enrollments": { + "description": "The requested enrollments, up to the number specified in `page_size`.", + "items": { + "type": "string" + }, + "type": "array" + }, + "nextPageToken": { + "description": "A page token that can be sent to `ListMessageBusEnrollments` to request the next page. If this is empty, then there are no more pages.", + "type": "string" + }, + "unreachable": { + "description": "Unreachable resources, if any.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "ListMessageBusesResponse": { + "description": "The response message for the `ListMessageBuses` method.", + "id": "ListMessageBusesResponse", + "properties": { + "messageBuses": { + "description": "The requested message buses, up to the number specified in `page_size`.", + "items": { + "$ref": "MessageBus" + }, + "type": "array" + }, + "nextPageToken": { + "description": "A page token that can be sent to `ListMessageBuses` to request the next page. If this is empty, then there are no more pages.", + "type": "string" + }, + "unreachable": { + "description": "Unreachable resources, if any.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "ListPipelinesResponse": { + "description": "The response message for the ListPipelines method.", + "id": "ListPipelinesResponse", + "properties": { + "nextPageToken": { + "description": "A page token that can be sent to `ListPipelines` to request the next page. If this is empty, then there are no more pages.", + "type": "string" + }, + "pipelines": { + "description": "The requested pipelines, up to the number specified in `page_size`.", + "items": { + "$ref": "Pipeline" + }, + "type": "array" + }, + "unreachable": { + "description": "Unreachable resources, if any.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "ListProvidersResponse": { "description": "The response message for the `ListProviders` method.", "id": "ListProvidersResponse", @@ -2190,6 +3446,100 @@ }, "type": "object" }, + "LoggingConfig": { + "description": "The configuration for Platform Telemetry logging for Eventarc Avdvanced resources.", + "id": "LoggingConfig", + "properties": { + "logSeverity": { + "description": "Optional. The minimum severity of logs that will be sent to Stackdriver/Platform Telemetry. Logs at severitiy ≥ this value will be sent, unless it is NONE.", + "enum": [ + "LOG_SEVERITY_UNSPECIFIED", + "NONE", + "DEBUG", + "INFO", + "NOTICE", + "WARNING", + "ERROR", + "CRITICAL", + "ALERT", + "EMERGENCY" + ], + "enumDescriptions": [ + "Log severity is not specified. This value is treated the same as NONE, but is used to distinguish between no update and update to NONE in update_masks.", + "Default value at resource creation, presence of this value must be treated as no logging/disable logging.", + "Debug or trace level logging.", + "Routine information, such as ongoing status or performance.", + "Normal but significant events, such as start up, shut down, or a configuration change.", + "Warning events might cause problems.", + "Error events are likely to cause problems.", + "Critical events cause more severe problems or outages.", + "A person must take action immediately.", + "One or more systems are unusable." + ], + "type": "string" + } + }, + "type": "object" + }, + "MessageBus": { + "description": "MessageBus for the messages flowing through the system. The admin has visibility and control over the messages being published and consumed and can restrict publishers and subscribers to only a subset of data available in the system by defining authorization policies.", + "id": "MessageBus", + "properties": { + "annotations": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Resource annotations.", + "type": "object" + }, + "createTime": { + "description": "Output only. The creation time.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "cryptoKeyName": { + "description": "Optional. Resource name of a KMS crypto key (managed by the user) used to encrypt/decrypt their event data. It must match the pattern `projects/*/locations/*/keyRings/*/cryptoKeys/*`.", + "type": "string" + }, + "displayName": { + "description": "Optional. Resource display name.", + "type": "string" + }, + "etag": { + "description": "Output only. This checksum is computed by the server based on the value of other fields, and might be sent only on update and delete requests to ensure that the client has an up-to-date value before proceeding.", + "readOnly": true, + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Resource labels.", + "type": "object" + }, + "loggingConfig": { + "$ref": "LoggingConfig", + "description": "Optional. Config to control Platform logging for the Message Bus. This log configuration is applied to the Message Bus itself, and all the Enrollments attached to it." + }, + "name": { + "description": "Identifier. Resource name of the form projects/{project}/locations/{location}/messageBuses/{message_bus}", + "type": "string" + }, + "uid": { + "description": "Output only. Server assigned unique identifier for the channel. The value is a UUID4 string and guaranteed to remain unchanged until the resource is deleted.", + "readOnly": true, + "type": "string" + }, + "updateTime": { + "description": "Output only. The last-modified time.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "NetworkConfig": { "description": "Network Configuration that can be inherited by other protos.", "id": "NetworkConfig", @@ -2245,6 +3595,86 @@ }, "type": "object" }, + "Pipeline": { + "description": "A representation of the Pipeline resource.", + "id": "Pipeline", + "properties": { + "annotations": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. User-defined annotations. See https://google.aip.dev/128#annotations.", + "type": "object" + }, + "createTime": { + "description": "Output only. The creation time. A timestamp in RFC3339 UTC \"Zulu\" format, with nanosecond resolution and up to nine fractional digits. Examples: \"2014-10-02T15:01:23Z\" and \"2014-10-02T15:01:23.045123456Z\".", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "cryptoKeyName": { + "description": "Optional. Resource name of a KMS crypto key (managed by the user) used to encrypt/decrypt the event data. If not set, an internal Google-owned key will be used to encrypt messages. It must match the pattern \"projects/{project}/locations/{location}/keyRings/{keyring}/cryptoKeys/{key}\".", + "type": "string" + }, + "destinations": { + "description": "Required. List of destinations to which messages will be forwarded. Currently, exactly one destination is supported per Pipeline.", + "items": { + "$ref": "GoogleCloudEventarcV1PipelineDestination" + }, + "type": "array" + }, + "displayName": { + "description": "Optional. Display name of resource.", + "type": "string" + }, + "etag": { + "description": "Output only. This checksum is computed by the server based on the value of other fields, and might be sent only on create requests to ensure that the client has an up-to-date value before proceeding.", + "type": "string" + }, + "inputPayloadFormat": { + "$ref": "GoogleCloudEventarcV1PipelineMessagePayloadFormat", + "description": "Optional. The payload format expected for the messages received by the Pipeline. If input_payload_format is set then any messages not matching this format will be treated as persistent errors. If input_payload_format is not set, then the message data will be treated as an opaque binary and no output format can be set on the Pipeline through the Pipeline.Destination.output_payload_format field. Any Mediations on the Pipeline that involve access to the data field will fail as persistent errors." + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. User labels attached to the Pipeline that can be used to group resources. An object containing a list of \"key\": value pairs. Example: { \"name\": \"wrench\", \"mass\": \"1.3kg\", \"count\": \"3\" }.", + "type": "object" + }, + "loggingConfig": { + "$ref": "LoggingConfig", + "description": "Optional. Config to control Platform Logging for Pipelines." + }, + "mediations": { + "description": "Optional. List of mediation operations to be performed on the message. Currently, only one Transformation operation is allowed in each Pipeline.", + "items": { + "$ref": "GoogleCloudEventarcV1PipelineMediation" + }, + "type": "array" + }, + "name": { + "description": "Identifier. The resource name of the Pipeline. Must be unique within the location of the project and must be in `projects/{project}/locations/{location}/pipelines/{pipeline}` format.", + "type": "string" + }, + "retryPolicy": { + "$ref": "GoogleCloudEventarcV1PipelineRetryPolicy", + "description": "Optional. The retry policy to use in the pipeline." + }, + "uid": { + "description": "Output only. Server-assigned unique identifier for the Pipeline. The value is a UUID4 string and guaranteed to remain unchanged until the resource is deleted.", + "readOnly": true, + "type": "string" + }, + "updateTime": { + "description": "Output only. The last-modified time. A timestamp in RFC3339 UTC \"Zulu\" format, with nanosecond resolution and up to nine fractional digits. Examples: \"2014-10-02T15:01:23Z\" and \"2014-10-02T15:01:23.045123456Z\".", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "Policy": { "description": "An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { \"bindings\": [ { \"role\": \"roles/resourcemanager.organizationAdmin\", \"members\": [ \"user:mike@example.com\", \"group:admins@example.com\", \"domain:google.com\", \"serviceAccount:my-project-id@appspot.gserviceaccount.com\" ] }, { \"role\": \"roles/resourcemanager.organizationViewer\", \"members\": [ \"user:eve@example.com\" ], \"condition\": { \"title\": \"expirable access\", \"description\": \"Does not grant access after Sep 2020\", \"expression\": \"request.time \u003c timestamp('2020-10-01T00:00:00.000Z')\", } } ], \"etag\": \"BwWWja0YfJA=\", \"version\": 3 } ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time \u003c timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/).", "id": "Policy", diff --git a/eventarc/v1/eventarc-gen.go b/eventarc/v1/eventarc-gen.go index 9bbe32db05f..c1e78524274 100644 --- a/eventarc/v1/eventarc-gen.go +++ b/eventarc/v1/eventarc-gen.go @@ -662,6 +662,63 @@ type Empty struct { googleapi.ServerResponse `json:"-"` } +// Enrollment: An enrollment represents a subscription for messages on a +// particular message bus. It defines a matching criteria for messages on the +// bus and the subscriber endpoint where matched messages should be delivered. +type Enrollment struct { + // Annotations: Optional. Resource annotations. + Annotations map[string]string `json:"annotations,omitempty"` + // CelMatch: Required. A CEL expression identifying which messages this + // enrollment applies to. + CelMatch string `json:"celMatch,omitempty"` + // CreateTime: Output only. The creation time. + CreateTime string `json:"createTime,omitempty"` + // Destination: Required. Destination is the Pipeline that the Enrollment is + // delivering to. It must point to the full resource name of a Pipeline. + // Format: "projects/{PROJECT_ID}/locations/{region}/pipelines/{PIPELINE_ID)" + Destination string `json:"destination,omitempty"` + // DisplayName: Optional. Resource display name. + DisplayName string `json:"displayName,omitempty"` + // Etag: Output only. This checksum is computed by the server based on the + // value of other fields, and might be sent only on update and delete requests + // to ensure that the client has an up-to-date value before proceeding. + Etag string `json:"etag,omitempty"` + // Labels: Optional. Resource labels. + Labels map[string]string `json:"labels,omitempty"` + // MessageBus: Required. Resource name of the message bus identifying the + // source of the messages. It matches the form + // projects/{project}/locations/{location}/messageBuses/{messageBus}. + MessageBus string `json:"messageBus,omitempty"` + // Name: Identifier. Resource name of the form + // projects/{project}/locations/{location}/enrollments/{enrollment} + Name string `json:"name,omitempty"` + // Uid: Output only. Server assigned unique identifier for the channel. The + // value is a UUID4 string and guaranteed to remain unchanged until the + // resource is deleted. + Uid string `json:"uid,omitempty"` + // UpdateTime: Output only. The last-modified time. + 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. "Annotations") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Annotations") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s Enrollment) MarshalJSON() ([]byte, error) { + type NoMethod Enrollment + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // EventFilter: Filters events based on exact matches on the CloudEvents // attributes. type EventFilter struct { @@ -849,6 +906,63 @@ func (s GKE) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleApiSource: A GoogleApiSource represents a subscription of 1P events +// from a MessageBus. +type GoogleApiSource struct { + // Annotations: Optional. Resource annotations. + Annotations map[string]string `json:"annotations,omitempty"` + // CreateTime: Output only. The creation time. + CreateTime string `json:"createTime,omitempty"` + // CryptoKeyName: Optional. Resource name of a KMS crypto key (managed by the + // user) used to encrypt/decrypt their event data. It must match the pattern + // `projects/*/locations/*/keyRings/*/cryptoKeys/*`. + CryptoKeyName string `json:"cryptoKeyName,omitempty"` + // Destination: Required. Destination is the message bus that the + // GoogleApiSource is delivering to. It must be point to the full resource name + // of a MessageBus. Format: + // "projects/{PROJECT_ID}/locations/{region}/messagesBuses/{MESSAGE_BUS_ID) + Destination string `json:"destination,omitempty"` + // DisplayName: Optional. Resource display name. + DisplayName string `json:"displayName,omitempty"` + // Etag: Output only. This checksum is computed by the server based on the + // value of other fields, and might be sent only on update and delete requests + // to ensure that the client has an up-to-date value before proceeding. + Etag string `json:"etag,omitempty"` + // Labels: Optional. Resource labels. + Labels map[string]string `json:"labels,omitempty"` + // LoggingConfig: Optional. Config to control Platform logging for the + // GoogleApiSource. + LoggingConfig *LoggingConfig `json:"loggingConfig,omitempty"` + // Name: Identifier. Resource name of the form + // projects/{project}/locations/{location}/googleApiSources/{google_api_source} + Name string `json:"name,omitempty"` + // Uid: Output only. Server assigned unique identifier for the channel. The + // value is a UUID4 string and guaranteed to remain unchanged until the + // resource is deleted. + Uid string `json:"uid,omitempty"` + // UpdateTime: Output only. The last-modified time. + 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. "Annotations") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Annotations") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleApiSource) MarshalJSON() ([]byte, error) { + type NoMethod GoogleApiSource + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleChannelConfig: A GoogleChannelConfig is a resource that stores the // custom settings respected by Eventarc first-party triggers in the matching // region. Once configured, first-party event data will be protected using the @@ -885,6 +999,451 @@ func (s GoogleChannelConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudEventarcV1PipelineDestination: Represents a target of an +// invocation over HTTP. +type GoogleCloudEventarcV1PipelineDestination struct { + // AuthenticationConfig: Optional. An authentication config used to + // authenticate message requests, such that destinations can verify the source. + // For example, this can be used with private GCP destinations that require GCP + // credentials to access like Cloud Run. This field is optional and should be + // set only by users interested in authenticated push + AuthenticationConfig *GoogleCloudEventarcV1PipelineDestinationAuthenticationConfig `json:"authenticationConfig,omitempty"` + // HttpEndpoint: Optional. An HTTP endpoint destination described by an URI. If + // a DNS FQDN is provided as the endpoint, Pipeline will create a peering zone + // to the consumer VPC and forward DNS requests to the VPC specified by network + // config to resolve the service endpoint. See: + // https://cloud.google.com/dns/docs/zones/zones-overview#peering_zones + HttpEndpoint *GoogleCloudEventarcV1PipelineDestinationHttpEndpoint `json:"httpEndpoint,omitempty"` + // MessageBus: Optional. The resource name of the Message Bus to which events + // should be published. The Message Bus resource should exist in the same + // project as the Pipeline. Format: + // `projects/{project}/locations/{location}/messageBuses/{message_bus}` + MessageBus string `json:"messageBus,omitempty"` + // NetworkConfig: Optional. Network config is used to configure how Pipeline + // resolves and connects to a destination. + NetworkConfig *GoogleCloudEventarcV1PipelineDestinationNetworkConfig `json:"networkConfig,omitempty"` + // OutputPayloadFormat: Optional. The message format before it is delivered to + // the destination. If not set, the message will be delivered in the format it + // was originally delivered to the Pipeline. This field can only be set if + // Pipeline.input_payload_format is also set. + OutputPayloadFormat *GoogleCloudEventarcV1PipelineMessagePayloadFormat `json:"outputPayloadFormat,omitempty"` + // Topic: Optional. The resource name of the Pub/Sub topic to which events + // should be published. Format: + // `projects/{project}/locations/{location}/topics/{topic}` + Topic string `json:"topic,omitempty"` + // Workflow: Optional. The resource name of the Workflow whose Executions are + // triggered by the events. The Workflow resource should be deployed in the + // same project as the Pipeline. Format: + // `projects/{project}/locations/{location}/workflows/{workflow}` + Workflow string `json:"workflow,omitempty"` + // ForceSendFields is a list of field names (e.g. "AuthenticationConfig") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AuthenticationConfig") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudEventarcV1PipelineDestination) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudEventarcV1PipelineDestination + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudEventarcV1PipelineDestinationAuthenticationConfig: Represents a +// config used to authenticate message requests. +type GoogleCloudEventarcV1PipelineDestinationAuthenticationConfig struct { + // GoogleOidc: Optional. This authenticate method will apply Google OIDC tokens + // signed by a GCP service account to the requests. + GoogleOidc *GoogleCloudEventarcV1PipelineDestinationAuthenticationConfigOidcToken `json:"googleOidc,omitempty"` + // OauthToken: Optional. 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. + OauthToken *GoogleCloudEventarcV1PipelineDestinationAuthenticationConfigOAuthToken `json:"oauthToken,omitempty"` + // ForceSendFields is a list of field names (e.g. "GoogleOidc") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "GoogleOidc") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudEventarcV1PipelineDestinationAuthenticationConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudEventarcV1PipelineDestinationAuthenticationConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudEventarcV1PipelineDestinationAuthenticationConfigOAuthToken: +// Contains information needed for generating an OAuth token +// (https://developers.google.com/identity/protocols/OAuth2). This type of +// authorization should generally only be used when calling Google APIs hosted +// on *.googleapis.com. +type GoogleCloudEventarcV1PipelineDestinationAuthenticationConfigOAuthToken struct { + // Scope: Optional. OAuth scope to be used for generating OAuth access token. + // If not specified, "https://www.googleapis.com/auth/cloud-platform" will be + // used. + Scope string `json:"scope,omitempty"` + // ServiceAccount: Required. Service account email used to generate the OAuth + // token (https://developers.google.com/identity/protocols/OAuth2). The + // principal who calls this API must have iam.serviceAccounts.actAs permission + // in the service account. See + // https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common + // for more information. Eventarc service agents must have + // roles/roles/iam.serviceAccountTokenCreator role to allow Pipeline to create + // OAuth2 tokens for authenticated requests. + ServiceAccount string `json:"serviceAccount,omitempty"` + // ForceSendFields is a list of field names (e.g. "Scope") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Scope") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudEventarcV1PipelineDestinationAuthenticationConfigOAuthToken) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudEventarcV1PipelineDestinationAuthenticationConfigOAuthToken + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudEventarcV1PipelineDestinationAuthenticationConfigOidcToken: +// Represents a config used to authenticate with a Google OIDC token using a +// GCP service account. Use this authentication method to invoke your Cloud Run +// and Cloud Functions destinations or HTTP endpoints that support Google OIDC. +type GoogleCloudEventarcV1PipelineDestinationAuthenticationConfigOidcToken struct { + // Audience: Optional. Audience to be used to generate the OIDC Token. The + // audience claim identifies the recipient that the JWT is intended for. If + // unspecified, the destination URI will be used. + Audience string `json:"audience,omitempty"` + // ServiceAccount: Required. Service account email used to generate the OIDC + // Token. The principal who calls this API must have iam.serviceAccounts.actAs + // permission in the service account. See + // https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common + // for more information. Eventarc service agents must have + // roles/roles/iam.serviceAccountTokenCreator role to allow the Pipeline to + // create OpenID tokens for authenticated requests. + ServiceAccount string `json:"serviceAccount,omitempty"` + // ForceSendFields is a list of field names (e.g. "Audience") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Audience") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudEventarcV1PipelineDestinationAuthenticationConfigOidcToken) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudEventarcV1PipelineDestinationAuthenticationConfigOidcToken + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudEventarcV1PipelineDestinationHttpEndpoint: Represents a HTTP +// endpoint destination. +type GoogleCloudEventarcV1PipelineDestinationHttpEndpoint struct { + // MessageBindingTemplate: Optional. The CEL expression used to construct a new + // HTTP request to be sent to the final destination. The result of the CEL + // expression must be a map of key/value pairs such that: - If a map named + // `headers` exists on the result of the expression, then its key/value pairs + // are directly mapped to the HTTP request headers. The headers values are + // constructed from the corresponding value type’s canonical representation. + // If the `headers` field doesn’t exist then the resulting HTTP request will + // be without headers. - If a field named `body` exists on the result of the + // expression then its value is directly mapped to the body of the request. If + // the value of the `body` field is of type bytes or string then it is used for + // the HTTP request body as-is, with no conversion. If the body field is of any + // other type then it is converted to a JSON string. If the body field + // doesn’t exist then the resulting HTTP request will be without a body. - + // Any other fields in the resulting expression will be ignored. The CEL + // expression may access the incoming CloudEvent message in its definition, as + // follows: - The `data` field of the incoming CloudEvent message can be + // accessed using the `message.data` value. - Each attribute of the incoming + // CloudEvent message can be accessed using the `message.` value, where is + // replaced with the name of the attribute. Headers added to the request by + // previous filters in the chain can be accessed in the CEL expression using + // the `headers` variable. The `headers` variable defines a map of key/value + // pairs corresponding to the HTTP headers added by previous mediation steps + // and not the headers present on the original incoming request. For example, + // the following CEL expression can be used to construct a Headers-only HTTP + // request by adding an additional header to the headers added by previous + // mediations in the Pipeline: ``` {"headers": headers.merge({"new-header-key": + // "new-header-value"})} ``` Additionally, the following CEL extension + // functions are provided for use in this CEL expression: - toBase64Url: + // map.toBase64Url() -> string - Converts a CelValue to a base64url encoded + // string - toJsonString: map.toJsonString() -> string - Converts a CelValue to + // a JSON string - merge: map1.merge(map2) -> map3 - Merges the passed CEL map + // with the existing CEL map the function is applied to. - If the same key + // exists in both maps, if the key's value is type map both maps are merged + // else the value from the passed map is used. - toMap: list(map).toMap() -> + // map - Converts a CEL list of CEL maps to a single CEL map - + // toDestinationPayloadFormat(): message.data.toDestinationPayloadFormat() -> + // string or bytes - Converts the message data to the destination payload + // format specified in Pipeline.Destination.output_payload_format - This + // function is meant to be applied to the message.data field. - If the + // destination payload format is not set, the function will return the message + // data unchanged. - toCloudEventJsonWithPayloadFormat: + // message.toCloudEventJsonWithPayloadFormat() -> map - Converts a message to + // the corresponding structure of JSON format for CloudEvents - This function + // applies toDestinationPayloadFormat() to the message data. It also sets the + // corresponding datacontenttype of the CloudEvent, as indicated by + // Pipeline.Destination.output_payload_format. If no output_payload_format is + // set it will use the existing datacontenttype on the CloudEvent if present, + // else leave datacontenttype absent. - This function expects that the content + // of the message will adhere to the standard CloudEvent format. If it + // doesn’t then this function will fail. - The result is a CEL map that + // corresponds to the JSON representation of the CloudEvent. To convert that + // data to a JSON string it can be chained with the toJsonString function. If a + // binding is not specified here, by default the message is treated as a + // CloudEvent and is mapped to the HTTP request according to the CloudEvent + // HTTP Protocol Binding Binary Content Mode. The Pipeline converts the data + // field of the message to the format provided in + // Pipeline.Destination.output_payload_format and maps it to the body field of + // the result. It also sets the corresponding Content-Type header to the + // output_payload_format type. If the + // Pipeline.Destination.output_payload_format is not set, then the Pipeline + // will treat the data field of the message as opaque binary data and attach it + // to the request body as bytes. In this case the Content-type header will be + // set to the value of the datacontenttype attribute set on the incoming + // CloudEvent message if present and the `application/octet-stream` MIME type + // otherwise. The Pipeline expects that the content of the message will adhere + // to the standard CloudEvent format. If it doesn’t then the outgoing message + // request may fail with a persistent error. + MessageBindingTemplate string `json:"messageBindingTemplate,omitempty"` + // Uri: Required. The URI of the HTTP enpdoint. The value must be a RFC2396 URI + // string. Examples: `http://10.10.10.8:80/route`, + // `http://svc.us-central1.p.local:8080/`. Only HTTP and HTTPS protocols are + // supported. The host can be either a static IP addressable from the VPC + // specified by the network config, or an internal DNS hostname of the service + // resolvable via Cloud DNS. + Uri string `json:"uri,omitempty"` + // ForceSendFields is a list of field names (e.g. "MessageBindingTemplate") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "MessageBindingTemplate") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudEventarcV1PipelineDestinationHttpEndpoint) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudEventarcV1PipelineDestinationHttpEndpoint + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudEventarcV1PipelineDestinationNetworkConfig: Represents a network +// config to be used for destination resolution and connectivity. +type GoogleCloudEventarcV1PipelineDestinationNetworkConfig struct { + // NetworkAttachment: Required. Name of the NetworkAttachment that allows + // access to the consumer VPC. Format: + // `projects/{PROJECT_ID}/regions/{REGION}/networkAttachments/{NETWORK_ATTACHMEN + // T_NAME}` + NetworkAttachment string `json:"networkAttachment,omitempty"` + // ForceSendFields is a list of field names (e.g. "NetworkAttachment") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "NetworkAttachment") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudEventarcV1PipelineDestinationNetworkConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudEventarcV1PipelineDestinationNetworkConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudEventarcV1PipelineMediation: Mediation defines different ways to +// modify the Pipeline. +type GoogleCloudEventarcV1PipelineMediation struct { + // Transformation: Optional. How the Pipeline is to transform messages + Transformation *GoogleCloudEventarcV1PipelineMediationTransformation `json:"transformation,omitempty"` + // ForceSendFields is a list of field names (e.g. "Transformation") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Transformation") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudEventarcV1PipelineMediation) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudEventarcV1PipelineMediation + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudEventarcV1PipelineMediationTransformation: Transformation defines +// the way to transform an incoming message. +type GoogleCloudEventarcV1PipelineMediationTransformation struct { + // TransformationTemplate: Optional. The template to apply to transform + // messages. + TransformationTemplate string `json:"transformationTemplate,omitempty"` + // ForceSendFields is a list of field names (e.g. "TransformationTemplate") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "TransformationTemplate") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudEventarcV1PipelineMediationTransformation) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudEventarcV1PipelineMediationTransformation + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudEventarcV1PipelineMessagePayloadFormat: Represents the format of +// message data. +type GoogleCloudEventarcV1PipelineMessagePayloadFormat struct { + // Avro: Optional. Avro format. + Avro *GoogleCloudEventarcV1PipelineMessagePayloadFormatAvroFormat `json:"avro,omitempty"` + // Json: Optional. JSON format. + Json *GoogleCloudEventarcV1PipelineMessagePayloadFormatJsonFormat `json:"json,omitempty"` + // Protobuf: Optional. Protobuf format. + Protobuf *GoogleCloudEventarcV1PipelineMessagePayloadFormatProtobufFormat `json:"protobuf,omitempty"` + // ForceSendFields is a list of field names (e.g. "Avro") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Avro") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudEventarcV1PipelineMessagePayloadFormat) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudEventarcV1PipelineMessagePayloadFormat + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudEventarcV1PipelineMessagePayloadFormatAvroFormat: The format of +// an AVRO message payload. +type GoogleCloudEventarcV1PipelineMessagePayloadFormatAvroFormat struct { + // SchemaDefinition: Optional. The entire schema definition is stored in this + // field. + SchemaDefinition string `json:"schemaDefinition,omitempty"` + // ForceSendFields is a list of field names (e.g. "SchemaDefinition") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "SchemaDefinition") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudEventarcV1PipelineMessagePayloadFormatAvroFormat) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudEventarcV1PipelineMessagePayloadFormatAvroFormat + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudEventarcV1PipelineMessagePayloadFormatJsonFormat: The format of a +// JSON message payload. +type GoogleCloudEventarcV1PipelineMessagePayloadFormatJsonFormat struct { +} + +// GoogleCloudEventarcV1PipelineMessagePayloadFormatProtobufFormat: The format +// of a Protobuf message payload. +type GoogleCloudEventarcV1PipelineMessagePayloadFormatProtobufFormat struct { + // SchemaDefinition: Optional. The entire schema definition is stored in this + // field. + SchemaDefinition string `json:"schemaDefinition,omitempty"` + // ForceSendFields is a list of field names (e.g. "SchemaDefinition") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "SchemaDefinition") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudEventarcV1PipelineMessagePayloadFormatProtobufFormat) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudEventarcV1PipelineMessagePayloadFormatProtobufFormat + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudEventarcV1PipelineRetryPolicy: The retry policy configuration for +// the Pipeline. The pipeline exponentially backs off in case the destination +// is non responsive or returns a retryable error code. The default semantics +// are as follows: The backoff starts with a 5 second delay and doubles the +// delay after each failed attempt (10 seconds, 20 seconds, 40 seconds, etc.). +// The delay is capped at 60 seconds by default. Please note that if you set +// the min_retry_delay and max_retry_delay fields to the same value this will +// make the duration between retries constant. +type GoogleCloudEventarcV1PipelineRetryPolicy struct { + // MaxAttempts: Optional. The maximum number of delivery attempts for any + // message. The value must be between 1 and 100. The default value for this + // field is 5. + MaxAttempts int64 `json:"maxAttempts,omitempty"` + // MaxRetryDelay: Optional. The maximum amount of seconds to wait between retry + // attempts. The value must be between 0 and 600. The default value for this + // field is 60. + MaxRetryDelay string `json:"maxRetryDelay,omitempty"` + // MinRetryDelay: Optional. The minimum amount of seconds to wait between retry + // attempts. The value must be between 0 and 600. The default value for this + // field is 5. + MinRetryDelay string `json:"minRetryDelay,omitempty"` + // ForceSendFields is a list of field names (e.g. "MaxAttempts") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "MaxAttempts") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudEventarcV1PipelineRetryPolicy) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudEventarcV1PipelineRetryPolicy + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleLongrunningCancelOperationRequest: The request message for // Operations.CancelOperation. type GoogleLongrunningCancelOperationRequest struct { @@ -1089,14 +1648,78 @@ func (s ListChannelsResponse) MarshalJSON() ([]byte, error) { 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"` - +// ListEnrollmentsResponse: The response message for the `ListEnrollments` +// method. +type ListEnrollmentsResponse struct { + // Enrollments: The requested Enrollments, up to the number specified in + // `page_size`. + Enrollments []*Enrollment `json:"enrollments,omitempty"` + // NextPageToken: A page token that can be sent to `ListEnrollments` to request + // the next page. If this is empty, then there are no more pages. + NextPageToken string `json:"nextPageToken,omitempty"` + // Unreachable: Unreachable resources, if any. + 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. "Enrollments") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Enrollments") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ListEnrollmentsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListEnrollmentsResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ListGoogleApiSourcesResponse: The response message for the +// `ListGoogleApiSources` method. +type ListGoogleApiSourcesResponse struct { + // GoogleApiSources: The requested GoogleApiSources, up to the number specified + // in `page_size`. + GoogleApiSources []*GoogleApiSource `json:"googleApiSources,omitempty"` + // NextPageToken: A page token that can be sent to `ListMessageBusEnrollments` + // to request the next page. If this is empty, then there are no more pages. + NextPageToken string `json:"nextPageToken,omitempty"` + // Unreachable: Unreachable resources, if any. + 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. "GoogleApiSources") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "GoogleApiSources") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ListGoogleApiSourcesResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListGoogleApiSourcesResponse + 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 @@ -1117,6 +1740,101 @@ func (s ListLocationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ListMessageBusEnrollmentsResponse: The response message for the +// `ListMessageBusEnrollments` method.` +type ListMessageBusEnrollmentsResponse struct { + // Enrollments: The requested enrollments, up to the number specified in + // `page_size`. + Enrollments []string `json:"enrollments,omitempty"` + // NextPageToken: A page token that can be sent to `ListMessageBusEnrollments` + // to request the next page. If this is empty, then there are no more pages. + NextPageToken string `json:"nextPageToken,omitempty"` + // Unreachable: Unreachable resources, if any. + 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. "Enrollments") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Enrollments") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ListMessageBusEnrollmentsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListMessageBusEnrollmentsResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ListMessageBusesResponse: The response message for the `ListMessageBuses` +// method. +type ListMessageBusesResponse struct { + // MessageBuses: The requested message buses, up to the number specified in + // `page_size`. + MessageBuses []*MessageBus `json:"messageBuses,omitempty"` + // NextPageToken: A page token that can be sent to `ListMessageBuses` to + // request the next page. If this is empty, then there are no more pages. + NextPageToken string `json:"nextPageToken,omitempty"` + // Unreachable: Unreachable resources, if any. + 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. "MessageBuses") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "MessageBuses") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ListMessageBusesResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListMessageBusesResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ListPipelinesResponse: The response message for the ListPipelines method. +type ListPipelinesResponse struct { + // NextPageToken: A page token that can be sent to `ListPipelines` to request + // the next page. If this is empty, then there are no more pages. + NextPageToken string `json:"nextPageToken,omitempty"` + // Pipelines: The requested pipelines, up to the number specified in + // `page_size`. + Pipelines []*Pipeline `json:"pipelines,omitempty"` + // Unreachable: Unreachable resources, if any. + 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. "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 ListPipelinesResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListPipelinesResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ListProvidersResponse: The response message for the `ListProviders` method. type ListProvidersResponse struct { // NextPageToken: A page token that can be sent to `ListProviders` to request @@ -1216,6 +1934,102 @@ func (s Location) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// LoggingConfig: The configuration for Platform Telemetry logging for Eventarc +// Avdvanced resources. +type LoggingConfig struct { + // LogSeverity: Optional. The minimum severity of logs that will be sent to + // Stackdriver/Platform Telemetry. Logs at severitiy ≥ this value will be + // sent, unless it is NONE. + // + // Possible values: + // "LOG_SEVERITY_UNSPECIFIED" - Log severity is not specified. This value is + // treated the same as NONE, but is used to distinguish between no update and + // update to NONE in update_masks. + // "NONE" - Default value at resource creation, presence of this value must + // be treated as no logging/disable logging. + // "DEBUG" - Debug or trace level logging. + // "INFO" - Routine information, such as ongoing status or performance. + // "NOTICE" - Normal but significant events, such as start up, shut down, or + // a configuration change. + // "WARNING" - Warning events might cause problems. + // "ERROR" - Error events are likely to cause problems. + // "CRITICAL" - Critical events cause more severe problems or outages. + // "ALERT" - A person must take action immediately. + // "EMERGENCY" - One or more systems are unusable. + LogSeverity string `json:"logSeverity,omitempty"` + // ForceSendFields is a list of field names (e.g. "LogSeverity") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "LogSeverity") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s LoggingConfig) MarshalJSON() ([]byte, error) { + type NoMethod LoggingConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// MessageBus: MessageBus for the messages flowing through the system. The +// admin has visibility and control over the messages being published and +// consumed and can restrict publishers and subscribers to only a subset of +// data available in the system by defining authorization policies. +type MessageBus struct { + // Annotations: Optional. Resource annotations. + Annotations map[string]string `json:"annotations,omitempty"` + // CreateTime: Output only. The creation time. + CreateTime string `json:"createTime,omitempty"` + // CryptoKeyName: Optional. Resource name of a KMS crypto key (managed by the + // user) used to encrypt/decrypt their event data. It must match the pattern + // `projects/*/locations/*/keyRings/*/cryptoKeys/*`. + CryptoKeyName string `json:"cryptoKeyName,omitempty"` + // DisplayName: Optional. Resource display name. + DisplayName string `json:"displayName,omitempty"` + // Etag: Output only. This checksum is computed by the server based on the + // value of other fields, and might be sent only on update and delete requests + // to ensure that the client has an up-to-date value before proceeding. + Etag string `json:"etag,omitempty"` + // Labels: Optional. Resource labels. + Labels map[string]string `json:"labels,omitempty"` + // LoggingConfig: Optional. Config to control Platform logging for the Message + // Bus. This log configuration is applied to the Message Bus itself, and all + // the Enrollments attached to it. + LoggingConfig *LoggingConfig `json:"loggingConfig,omitempty"` + // Name: Identifier. Resource name of the form + // projects/{project}/locations/{location}/messageBuses/{message_bus} + Name string `json:"name,omitempty"` + // Uid: Output only. Server assigned unique identifier for the channel. The + // value is a UUID4 string and guaranteed to remain unchanged until the + // resource is deleted. + Uid string `json:"uid,omitempty"` + // UpdateTime: Output only. The last-modified time. + 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. "Annotations") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Annotations") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s MessageBus) MarshalJSON() ([]byte, error) { + type NoMethod MessageBus + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // NetworkConfig: Network Configuration that can be inherited by other protos. type NetworkConfig struct { // NetworkAttachment: Required. Name of the NetworkAttachment that allows @@ -1279,6 +2093,84 @@ func (s OperationMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// Pipeline: A representation of the Pipeline resource. +type Pipeline struct { + // Annotations: Optional. User-defined annotations. See + // https://google.aip.dev/128#annotations. + Annotations map[string]string `json:"annotations,omitempty"` + // CreateTime: Output only. The creation time. A timestamp in RFC3339 UTC + // "Zulu" format, with nanosecond resolution and up to nine fractional digits. + // Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z". + CreateTime string `json:"createTime,omitempty"` + // CryptoKeyName: Optional. Resource name of a KMS crypto key (managed by the + // user) used to encrypt/decrypt the event data. If not set, an internal + // Google-owned key will be used to encrypt messages. It must match the pattern + // "projects/{project}/locations/{location}/keyRings/{keyring}/cryptoKeys/{key}" + // . + CryptoKeyName string `json:"cryptoKeyName,omitempty"` + // Destinations: Required. List of destinations to which messages will be + // forwarded. Currently, exactly one destination is supported per Pipeline. + Destinations []*GoogleCloudEventarcV1PipelineDestination `json:"destinations,omitempty"` + // DisplayName: Optional. Display name of resource. + DisplayName string `json:"displayName,omitempty"` + // Etag: Output only. This checksum is computed by the server based on the + // value of other fields, and might be sent only on create requests to ensure + // that the client has an up-to-date value before proceeding. + Etag string `json:"etag,omitempty"` + // InputPayloadFormat: Optional. The payload format expected for the messages + // received by the Pipeline. If input_payload_format is set then any messages + // not matching this format will be treated as persistent errors. If + // input_payload_format is not set, then the message data will be treated as an + // opaque binary and no output format can be set on the Pipeline through the + // Pipeline.Destination.output_payload_format field. Any Mediations on the + // Pipeline that involve access to the data field will fail as persistent + // errors. + InputPayloadFormat *GoogleCloudEventarcV1PipelineMessagePayloadFormat `json:"inputPayloadFormat,omitempty"` + // Labels: Optional. User labels attached to the Pipeline that can be used to + // group resources. An object containing a list of "key": value pairs. Example: + // { "name": "wrench", "mass": "1.3kg", "count": "3" }. + Labels map[string]string `json:"labels,omitempty"` + // LoggingConfig: Optional. Config to control Platform Logging for Pipelines. + LoggingConfig *LoggingConfig `json:"loggingConfig,omitempty"` + // Mediations: Optional. List of mediation operations to be performed on the + // message. Currently, only one Transformation operation is allowed in each + // Pipeline. + Mediations []*GoogleCloudEventarcV1PipelineMediation `json:"mediations,omitempty"` + // Name: Identifier. The resource name of the Pipeline. Must be unique within + // the location of the project and must be in + // `projects/{project}/locations/{location}/pipelines/{pipeline}` format. + Name string `json:"name,omitempty"` + // RetryPolicy: Optional. The retry policy to use in the pipeline. + RetryPolicy *GoogleCloudEventarcV1PipelineRetryPolicy `json:"retryPolicy,omitempty"` + // Uid: Output only. Server-assigned unique identifier for the Pipeline. The + // value is a UUID4 string and guaranteed to remain unchanged until the + // resource is deleted. + Uid string `json:"uid,omitempty"` + // UpdateTime: Output only. The last-modified time. A timestamp in RFC3339 UTC + // "Zulu" format, with nanosecond resolution and up to nine fractional digits. + // Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z". + 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. "Annotations") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Annotations") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s Pipeline) MarshalJSON() ([]byte, error) { + type NoMethod Pipeline + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Policy: An Identity and Access Management (IAM) policy, which specifies // access controls for Google Cloud resources. A `Policy` is a collection of // `bindings`. A `binding` binds one or more `members`, or principals, to a @@ -3938,102 +4830,92 @@ func (c *ProjectsLocationsChannelsTestIamPermissionsCall) Do(opts ...googleapi.C return ret, nil } -type ProjectsLocationsEnrollmentsGetIamPolicyCall struct { - s *Service - resource string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsEnrollmentsCreateCall struct { + s *Service + parent string + enrollment *Enrollment + urlParams_ gensupport.URLParams + 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. +// Create: Create a new Enrollment in a particular project and location. // -// - 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 *ProjectsLocationsEnrollmentsService) GetIamPolicy(resource string) *ProjectsLocationsEnrollmentsGetIamPolicyCall { - c := &ProjectsLocationsEnrollmentsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource +// - parent: The parent collection in which to add this enrollment. +func (r *ProjectsLocationsEnrollmentsService) Create(parent string, enrollment *Enrollment) *ProjectsLocationsEnrollmentsCreateCall { + c := &ProjectsLocationsEnrollmentsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.enrollment = enrollment 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 *ProjectsLocationsEnrollmentsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsEnrollmentsGetIamPolicyCall { - c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) +// EnrollmentId sets the optional parameter "enrollmentId": Required. The +// user-provided ID to be assigned to the Enrollment. It should match the +// format (^a-z ([a-z0-9-]{0,61}[a-z0-9])?$). +func (c *ProjectsLocationsEnrollmentsCreateCall) EnrollmentId(enrollmentId string) *ProjectsLocationsEnrollmentsCreateCall { + c.urlParams_.Set("enrollmentId", enrollmentId) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": If set, validate +// the request and preview the review, but do not post it. +func (c *ProjectsLocationsEnrollmentsCreateCall) ValidateOnly(validateOnly bool) *ProjectsLocationsEnrollmentsCreateCall { + 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 *ProjectsLocationsEnrollmentsGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsEnrollmentsGetIamPolicyCall { +func (c *ProjectsLocationsEnrollmentsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsEnrollmentsCreateCall { 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 *ProjectsLocationsEnrollmentsGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsEnrollmentsGetIamPolicyCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsEnrollmentsGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsEnrollmentsGetIamPolicyCall { +func (c *ProjectsLocationsEnrollmentsCreateCall) Context(ctx context.Context) *ProjectsLocationsEnrollmentsCreateCall { 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 *ProjectsLocationsEnrollmentsGetIamPolicyCall) Header() http.Header { +func (c *ProjectsLocationsEnrollmentsCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsEnrollmentsGetIamPolicyCall) 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 *ProjectsLocationsEnrollmentsCreateCall) 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.enrollment) + if err != nil { + return nil, err + } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:getIamPolicy") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/enrollments") 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{ - "resource": c.resource, + "parent": c.parent, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "eventarc.projects.locations.enrollments.getIamPolicy" call. +// Do executes the "eventarc.projects.locations.enrollments.create" 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 *ProjectsLocationsEnrollmentsGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, 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 *ProjectsLocationsEnrollmentsCreateCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -4052,7 +4934,7 @@ func (c *ProjectsLocationsEnrollmentsGetIamPolicyCall) Do(opts ...googleapi.Call if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Policy{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -4065,80 +4947,93 @@ func (c *ProjectsLocationsEnrollmentsGetIamPolicyCall) Do(opts ...googleapi.Call return ret, nil } -type ProjectsLocationsEnrollmentsSetIamPolicyCall struct { - s *Service - resource string - setiampolicyrequest *SetIamPolicyRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsEnrollmentsDeleteCall struct { + s *Service + name string + 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. +// Delete: Delete a single Enrollment. // -// - 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 *ProjectsLocationsEnrollmentsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsEnrollmentsSetIamPolicyCall { - c := &ProjectsLocationsEnrollmentsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.setiampolicyrequest = setiampolicyrequest +// - name: The name of the Enrollment to be deleted. +func (r *ProjectsLocationsEnrollmentsService) Delete(name string) *ProjectsLocationsEnrollmentsDeleteCall { + c := &ProjectsLocationsEnrollmentsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// AllowMissing sets the optional parameter "allowMissing": If set to true, and +// the Enrollment is not found, the request will succeed but no action will be +// taken on the server. +func (c *ProjectsLocationsEnrollmentsDeleteCall) AllowMissing(allowMissing bool) *ProjectsLocationsEnrollmentsDeleteCall { + c.urlParams_.Set("allowMissing", fmt.Sprint(allowMissing)) + return c +} + +// Etag sets the optional parameter "etag": If provided, the Enrollment will +// only be deleted if the etag matches the current etag on the resource. +func (c *ProjectsLocationsEnrollmentsDeleteCall) Etag(etag string) *ProjectsLocationsEnrollmentsDeleteCall { + c.urlParams_.Set("etag", etag) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": If set, validate +// the request and preview the review, but do not post it. +func (c *ProjectsLocationsEnrollmentsDeleteCall) ValidateOnly(validateOnly bool) *ProjectsLocationsEnrollmentsDeleteCall { + 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 *ProjectsLocationsEnrollmentsSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsEnrollmentsSetIamPolicyCall { +func (c *ProjectsLocationsEnrollmentsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsEnrollmentsDeleteCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsEnrollmentsSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsEnrollmentsSetIamPolicyCall { +func (c *ProjectsLocationsEnrollmentsDeleteCall) Context(ctx context.Context) *ProjectsLocationsEnrollmentsDeleteCall { 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 *ProjectsLocationsEnrollmentsSetIamPolicyCall) Header() http.Header { +func (c *ProjectsLocationsEnrollmentsDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsEnrollmentsSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) +func (c *ProjectsLocationsEnrollmentsDeleteCall) 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.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 := googleapi.ResolveRelative(c.s.BasePath, "v1/{+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 } 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 "eventarc.projects.locations.enrollments.setIamPolicy" call. +// Do executes the "eventarc.projects.locations.enrollments.delete" 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 *ProjectsLocationsEnrollmentsSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, 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 *ProjectsLocationsEnrollmentsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -4157,7 +5052,7 @@ func (c *ProjectsLocationsEnrollmentsSetIamPolicyCall) Do(opts ...googleapi.Call if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Policy{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -4170,84 +5065,82 @@ func (c *ProjectsLocationsEnrollmentsSetIamPolicyCall) Do(opts ...googleapi.Call return ret, nil } -type ProjectsLocationsEnrollmentsTestIamPermissionsCall struct { - s *Service - resource string - testiampermissionsrequest *TestIamPermissionsRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsEnrollmentsGetCall struct { + s *Service + name 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. +// Get: Get a single Enrollment. // -// - 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 *ProjectsLocationsEnrollmentsService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsEnrollmentsTestIamPermissionsCall { - c := &ProjectsLocationsEnrollmentsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.testiampermissionsrequest = testiampermissionsrequest +// - name: The name of the Enrollment to get. +func (r *ProjectsLocationsEnrollmentsService) Get(name string) *ProjectsLocationsEnrollmentsGetCall { + c := &ProjectsLocationsEnrollmentsGetCall{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 *ProjectsLocationsEnrollmentsTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsEnrollmentsTestIamPermissionsCall { +func (c *ProjectsLocationsEnrollmentsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsEnrollmentsGetCall { 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 *ProjectsLocationsEnrollmentsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsEnrollmentsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsEnrollmentsTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsEnrollmentsTestIamPermissionsCall { +func (c *ProjectsLocationsEnrollmentsGetCall) Context(ctx context.Context) *ProjectsLocationsEnrollmentsGetCall { 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 *ProjectsLocationsEnrollmentsTestIamPermissionsCall) Header() http.Header { +func (c *ProjectsLocationsEnrollmentsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsEnrollmentsTestIamPermissionsCall) 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 +func (c *ProjectsLocationsEnrollmentsGetCall) 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}:testIamPermissions") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+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 "eventarc.projects.locations.enrollments.testIamPermissions" call. +// Do executes the "eventarc.projects.locations.enrollments.get" 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 *ProjectsLocationsEnrollmentsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestIamPermissionsResponse, error) { +// *Enrollment.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 *ProjectsLocationsEnrollmentsGetCall) Do(opts ...googleapi.CallOption) (*Enrollment, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -4266,7 +5159,7 @@ func (c *ProjectsLocationsEnrollmentsTestIamPermissionsCall) Do(opts ...googleap if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &TestIamPermissionsResponse{ + ret := &Enrollment{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -4279,7 +5172,7 @@ func (c *ProjectsLocationsEnrollmentsTestIamPermissionsCall) Do(opts ...googleap return ret, nil } -type ProjectsLocationsGoogleApiSourcesGetIamPolicyCall struct { +type ProjectsLocationsEnrollmentsGetIamPolicyCall struct { s *Service resource string urlParams_ gensupport.URLParams @@ -4294,8 +5187,8 @@ type ProjectsLocationsGoogleApiSourcesGetIamPolicyCall struct { // - 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 *ProjectsLocationsGoogleApiSourcesService) GetIamPolicy(resource string) *ProjectsLocationsGoogleApiSourcesGetIamPolicyCall { - c := &ProjectsLocationsGoogleApiSourcesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsEnrollmentsService) GetIamPolicy(resource string) *ProjectsLocationsEnrollmentsGetIamPolicyCall { + c := &ProjectsLocationsEnrollmentsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource return c } @@ -4312,7 +5205,7 @@ func (r *ProjectsLocationsGoogleApiSourcesService) GetIamPolicy(resource string) // 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 *ProjectsLocationsGoogleApiSourcesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsGoogleApiSourcesGetIamPolicyCall { +func (c *ProjectsLocationsEnrollmentsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsEnrollmentsGetIamPolicyCall { c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) return c } @@ -4320,7 +5213,7 @@ func (c *ProjectsLocationsGoogleApiSourcesGetIamPolicyCall) OptionsRequestedPoli // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsGoogleApiSourcesGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsGoogleApiSourcesGetIamPolicyCall { +func (c *ProjectsLocationsEnrollmentsGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsEnrollmentsGetIamPolicyCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -4328,27 +5221,27 @@ func (c *ProjectsLocationsGoogleApiSourcesGetIamPolicyCall) 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 *ProjectsLocationsGoogleApiSourcesGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsGoogleApiSourcesGetIamPolicyCall { +func (c *ProjectsLocationsEnrollmentsGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsEnrollmentsGetIamPolicyCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsGoogleApiSourcesGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsGoogleApiSourcesGetIamPolicyCall { +func (c *ProjectsLocationsEnrollmentsGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsEnrollmentsGetIamPolicyCall { 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 *ProjectsLocationsGoogleApiSourcesGetIamPolicyCall) Header() http.Header { +func (c *ProjectsLocationsEnrollmentsGetIamPolicyCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsGoogleApiSourcesGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsEnrollmentsGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) @@ -4369,12 +5262,12 @@ func (c *ProjectsLocationsGoogleApiSourcesGetIamPolicyCall) doRequest(alt string return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "eventarc.projects.locations.googleApiSources.getIamPolicy" call. +// Do executes the "eventarc.projects.locations.enrollments.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 *ProjectsLocationsGoogleApiSourcesGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { +func (c *ProjectsLocationsEnrollmentsGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -4406,80 +5299,116 @@ func (c *ProjectsLocationsGoogleApiSourcesGetIamPolicyCall) Do(opts ...googleapi return ret, nil } -type ProjectsLocationsGoogleApiSourcesSetIamPolicyCall struct { - s *Service - resource string - setiampolicyrequest *SetIamPolicyRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsEnrollmentsListCall struct { + s *Service + parent 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: List Enrollments. // -// - 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 *ProjectsLocationsGoogleApiSourcesService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsGoogleApiSourcesSetIamPolicyCall { - c := &ProjectsLocationsGoogleApiSourcesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.setiampolicyrequest = setiampolicyrequest +// - parent: The parent collection to list triggers on. +func (r *ProjectsLocationsEnrollmentsService) List(parent string) *ProjectsLocationsEnrollmentsListCall { + c := &ProjectsLocationsEnrollmentsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Filter sets the optional parameter "filter": The filter field that the list +// request will filter on. Possible filtersare described in +// https://google.aip.dev/160. +func (c *ProjectsLocationsEnrollmentsListCall) Filter(filter string) *ProjectsLocationsEnrollmentsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// OrderBy sets the optional parameter "orderBy": The sorting order of the +// resources returned. Value should be a comma-separated list of fields. The +// default sorting order is ascending. To specify descending order for a field, +// append a `desc` suffix; for example: `name desc, update_time`. +func (c *ProjectsLocationsEnrollmentsListCall) OrderBy(orderBy string) *ProjectsLocationsEnrollmentsListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number of +// results to return on each page. Note: The service may send fewer. +func (c *ProjectsLocationsEnrollmentsListCall) PageSize(pageSize int64) *ProjectsLocationsEnrollmentsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The page token; provide +// the value from the `next_page_token` field in a previous call to retrieve +// the subsequent page. When paginating, all other parameters provided must +// match the previous call that provided the page token. +func (c *ProjectsLocationsEnrollmentsListCall) PageToken(pageToken string) *ProjectsLocationsEnrollmentsListCall { + 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 *ProjectsLocationsGoogleApiSourcesSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsGoogleApiSourcesSetIamPolicyCall { +func (c *ProjectsLocationsEnrollmentsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsEnrollmentsListCall { 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 *ProjectsLocationsEnrollmentsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsEnrollmentsListCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsGoogleApiSourcesSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsGoogleApiSourcesSetIamPolicyCall { +func (c *ProjectsLocationsEnrollmentsListCall) Context(ctx context.Context) *ProjectsLocationsEnrollmentsListCall { 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 *ProjectsLocationsGoogleApiSourcesSetIamPolicyCall) Header() http.Header { +func (c *ProjectsLocationsEnrollmentsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsGoogleApiSourcesSetIamPolicyCall) 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 +func (c *ProjectsLocationsEnrollmentsListCall) 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}:setIamPolicy") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/enrollments") 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 "eventarc.projects.locations.googleApiSources.setIamPolicy" call. +// Do executes the "eventarc.projects.locations.enrollments.list" 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 *ProjectsLocationsGoogleApiSourcesSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { +// *ListEnrollmentsResponse.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 *ProjectsLocationsEnrollmentsListCall) Do(opts ...googleapi.CallOption) (*ListEnrollmentsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -4498,7 +5427,7 @@ func (c *ProjectsLocationsGoogleApiSourcesSetIamPolicyCall) Do(opts ...googleapi if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Policy{ + ret := &ListEnrollmentsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -4511,84 +5440,123 @@ func (c *ProjectsLocationsGoogleApiSourcesSetIamPolicyCall) Do(opts ...googleapi return ret, nil } -type ProjectsLocationsGoogleApiSourcesTestIamPermissionsCall struct { - s *Service - resource string - testiampermissionsrequest *TestIamPermissionsRequest - 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 *ProjectsLocationsEnrollmentsListCall) Pages(ctx context.Context, f func(*ListEnrollmentsResponse) 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 ProjectsLocationsEnrollmentsPatchCall struct { + s *Service + name string + enrollment *Enrollment + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Update a single Enrollment. // -// - 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 *ProjectsLocationsGoogleApiSourcesService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsGoogleApiSourcesTestIamPermissionsCall { - c := &ProjectsLocationsGoogleApiSourcesTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.testiampermissionsrequest = testiampermissionsrequest +// - name: Identifier. Resource name of the form +// projects/{project}/locations/{location}/enrollments/{enrollment}. +func (r *ProjectsLocationsEnrollmentsService) Patch(name string, enrollment *Enrollment) *ProjectsLocationsEnrollmentsPatchCall { + c := &ProjectsLocationsEnrollmentsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.enrollment = enrollment + return c +} + +// AllowMissing sets the optional parameter "allowMissing": If set to true, and +// the Enrollment is not found, a new Enrollment will be created. In this +// situation, `update_mask` is ignored. +func (c *ProjectsLocationsEnrollmentsPatchCall) AllowMissing(allowMissing bool) *ProjectsLocationsEnrollmentsPatchCall { + c.urlParams_.Set("allowMissing", fmt.Sprint(allowMissing)) + return c +} + +// UpdateMask sets the optional parameter "updateMask": The fields to be +// updated; only fields explicitly provided are updated. If no field mask is +// provided, all provided fields in the request are updated. To update all +// fields, provide a field mask of "*". +func (c *ProjectsLocationsEnrollmentsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsEnrollmentsPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": If set, validate +// the request and preview the review, but do not post it. +func (c *ProjectsLocationsEnrollmentsPatchCall) ValidateOnly(validateOnly bool) *ProjectsLocationsEnrollmentsPatchCall { + 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 *ProjectsLocationsGoogleApiSourcesTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsGoogleApiSourcesTestIamPermissionsCall { +func (c *ProjectsLocationsEnrollmentsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsEnrollmentsPatchCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsGoogleApiSourcesTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsGoogleApiSourcesTestIamPermissionsCall { +func (c *ProjectsLocationsEnrollmentsPatchCall) Context(ctx context.Context) *ProjectsLocationsEnrollmentsPatchCall { 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 *ProjectsLocationsGoogleApiSourcesTestIamPermissionsCall) Header() http.Header { +func (c *ProjectsLocationsEnrollmentsPatchCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsGoogleApiSourcesTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsEnrollmentsPatchCall) 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) + body, err := googleapi.WithoutDataWrapper.JSONReader(c.enrollment) 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 := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("PATCH", 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 "eventarc.projects.locations.googleApiSources.testIamPermissions" call. +// Do executes the "eventarc.projects.locations.enrollments.patch" call. // Any non-2xx status code is an error. Response headers are in either -// *TestIamPermissionsResponse.ServerResponse.Header or (if a response was +// *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 *ProjectsLocationsGoogleApiSourcesTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestIamPermissionsResponse, error) { +func (c *ProjectsLocationsEnrollmentsPatchCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -4607,7 +5575,7 @@ func (c *ProjectsLocationsGoogleApiSourcesTestIamPermissionsCall) Do(opts ...goo if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &TestIamPermissionsResponse{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -4620,86 +5588,64 @@ func (c *ProjectsLocationsGoogleApiSourcesTestIamPermissionsCall) Do(opts ...goo return ret, nil } -type ProjectsLocationsMessageBusesGetIamPolicyCall struct { - s *Service - resource string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsEnrollmentsSetIamPolicyCall struct { + s *Service + resource string + setiampolicyrequest *SetIamPolicyRequest + urlParams_ gensupport.URLParams + 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. +// 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 requested. +// - 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 *ProjectsLocationsMessageBusesService) GetIamPolicy(resource string) *ProjectsLocationsMessageBusesGetIamPolicyCall { - c := &ProjectsLocationsMessageBusesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsEnrollmentsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsEnrollmentsSetIamPolicyCall { + c := &ProjectsLocationsEnrollmentsSetIamPolicyCall{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 *ProjectsLocationsMessageBusesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsMessageBusesGetIamPolicyCall { - c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) + 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 *ProjectsLocationsMessageBusesGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsMessageBusesGetIamPolicyCall { +func (c *ProjectsLocationsEnrollmentsSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsEnrollmentsSetIamPolicyCall { 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 *ProjectsLocationsMessageBusesGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsMessageBusesGetIamPolicyCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsMessageBusesGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsMessageBusesGetIamPolicyCall { +func (c *ProjectsLocationsEnrollmentsSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsEnrollmentsSetIamPolicyCall { 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 *ProjectsLocationsMessageBusesGetIamPolicyCall) Header() http.Header { +func (c *ProjectsLocationsEnrollmentsSetIamPolicyCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsMessageBusesGetIamPolicyCall) 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 *ProjectsLocationsEnrollmentsSetIamPolicyCall) 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}:getIamPolicy") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:setIamPolicy") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, body) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } @@ -4710,12 +5656,12 @@ func (c *ProjectsLocationsMessageBusesGetIamPolicyCall) doRequest(alt string) (* return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "eventarc.projects.locations.messageBuses.getIamPolicy" call. +// Do executes the "eventarc.projects.locations.enrollments.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 *ProjectsLocationsMessageBusesGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { +func (c *ProjectsLocationsEnrollmentsSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -4747,62 +5693,65 @@ func (c *ProjectsLocationsMessageBusesGetIamPolicyCall) Do(opts ...googleapi.Cal return ret, nil } -type ProjectsLocationsMessageBusesSetIamPolicyCall struct { - s *Service - resource string - setiampolicyrequest *SetIamPolicyRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsEnrollmentsTestIamPermissionsCall struct { + s *Service + resource string + testiampermissionsrequest *TestIamPermissionsRequest + 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. +// 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 is being specified. -// See Resource names (https://cloud.google.com/apis/design/resource_names) -// for the appropriate value for this field. -func (r *ProjectsLocationsMessageBusesService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsMessageBusesSetIamPolicyCall { - c := &ProjectsLocationsMessageBusesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - 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 *ProjectsLocationsEnrollmentsService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsEnrollmentsTestIamPermissionsCall { + c := &ProjectsLocationsEnrollmentsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource - c.setiampolicyrequest = setiampolicyrequest + 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 *ProjectsLocationsMessageBusesSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsMessageBusesSetIamPolicyCall { +func (c *ProjectsLocationsEnrollmentsTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsEnrollmentsTestIamPermissionsCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsMessageBusesSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsMessageBusesSetIamPolicyCall { +func (c *ProjectsLocationsEnrollmentsTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsEnrollmentsTestIamPermissionsCall { 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 *ProjectsLocationsMessageBusesSetIamPolicyCall) Header() http.Header { +func (c *ProjectsLocationsEnrollmentsTestIamPermissionsCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsMessageBusesSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsEnrollmentsTestIamPermissionsCall) 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) + 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}:setIamPolicy") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:testIamPermissions") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -4815,12 +5764,13 @@ func (c *ProjectsLocationsMessageBusesSetIamPolicyCall) doRequest(alt string) (* return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "eventarc.projects.locations.messageBuses.setIamPolicy" call. +// Do executes the "eventarc.projects.locations.enrollments.testIamPermissions" 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 *ProjectsLocationsMessageBusesSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { +// *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 *ProjectsLocationsEnrollmentsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestIamPermissionsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -4839,7 +5789,7 @@ func (c *ProjectsLocationsMessageBusesSetIamPolicyCall) Do(opts ...googleapi.Cal if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Policy{ + ret := &TestIamPermissionsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -4852,65 +5802,73 @@ func (c *ProjectsLocationsMessageBusesSetIamPolicyCall) Do(opts ...googleapi.Cal return ret, nil } -type ProjectsLocationsMessageBusesTestIamPermissionsCall struct { - s *Service - resource string - testiampermissionsrequest *TestIamPermissionsRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsGoogleApiSourcesCreateCall struct { + s *Service + parent string + googleapisource *GoogleApiSource + 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. +// Create: Create a new GoogleApiSource in a particular 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 *ProjectsLocationsMessageBusesService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsMessageBusesTestIamPermissionsCall { - c := &ProjectsLocationsMessageBusesTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.testiampermissionsrequest = testiampermissionsrequest +// - parent: The parent collection in which to add this google api source. +func (r *ProjectsLocationsGoogleApiSourcesService) Create(parent string, googleapisource *GoogleApiSource) *ProjectsLocationsGoogleApiSourcesCreateCall { + c := &ProjectsLocationsGoogleApiSourcesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleapisource = googleapisource + return c +} + +// GoogleApiSourceId sets the optional parameter "googleApiSourceId": Required. +// The user-provided ID to be assigned to the GoogleApiSource. It should match +// the format (^a-z ([a-z0-9-]{0,61}[a-z0-9])?$). +func (c *ProjectsLocationsGoogleApiSourcesCreateCall) GoogleApiSourceId(googleApiSourceId string) *ProjectsLocationsGoogleApiSourcesCreateCall { + c.urlParams_.Set("googleApiSourceId", googleApiSourceId) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": If set, validate +// the request and preview the review, but do not post it. +func (c *ProjectsLocationsGoogleApiSourcesCreateCall) ValidateOnly(validateOnly bool) *ProjectsLocationsGoogleApiSourcesCreateCall { + 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 *ProjectsLocationsMessageBusesTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsMessageBusesTestIamPermissionsCall { +func (c *ProjectsLocationsGoogleApiSourcesCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsGoogleApiSourcesCreateCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsMessageBusesTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsMessageBusesTestIamPermissionsCall { +func (c *ProjectsLocationsGoogleApiSourcesCreateCall) Context(ctx context.Context) *ProjectsLocationsGoogleApiSourcesCreateCall { 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 *ProjectsLocationsMessageBusesTestIamPermissionsCall) Header() http.Header { +func (c *ProjectsLocationsGoogleApiSourcesCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsMessageBusesTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsGoogleApiSourcesCreateCall) 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) + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleapisource) 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 := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/googleApiSources") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -4918,18 +5876,1992 @@ func (c *ProjectsLocationsMessageBusesTestIamPermissionsCall) doRequest(alt stri } 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 "eventarc.projects.locations.messageBuses.testIamPermissions" call. +// Do executes the "eventarc.projects.locations.googleApiSources.create" call. // Any non-2xx status code is an error. Response headers are in either -// *TestIamPermissionsResponse.ServerResponse.Header or (if a response was +// *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 *ProjectsLocationsMessageBusesTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestIamPermissionsResponse, error) { +func (c *ProjectsLocationsGoogleApiSourcesCreateCall) 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 ProjectsLocationsGoogleApiSourcesDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Delete a single GoogleApiSource. +// +// - name: The name of the GoogleApiSource to be deleted. +func (r *ProjectsLocationsGoogleApiSourcesService) Delete(name string) *ProjectsLocationsGoogleApiSourcesDeleteCall { + c := &ProjectsLocationsGoogleApiSourcesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// AllowMissing sets the optional parameter "allowMissing": If set to true, and +// the MessageBus is not found, the request will succeed but no action will be +// taken on the server. +func (c *ProjectsLocationsGoogleApiSourcesDeleteCall) AllowMissing(allowMissing bool) *ProjectsLocationsGoogleApiSourcesDeleteCall { + c.urlParams_.Set("allowMissing", fmt.Sprint(allowMissing)) + return c +} + +// Etag sets the optional parameter "etag": If provided, the MessageBus will +// only be deleted if the etag matches the current etag on the resource. +func (c *ProjectsLocationsGoogleApiSourcesDeleteCall) Etag(etag string) *ProjectsLocationsGoogleApiSourcesDeleteCall { + c.urlParams_.Set("etag", etag) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": If set, validate +// the request and preview the review, but do not post it. +func (c *ProjectsLocationsGoogleApiSourcesDeleteCall) ValidateOnly(validateOnly bool) *ProjectsLocationsGoogleApiSourcesDeleteCall { + 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 *ProjectsLocationsGoogleApiSourcesDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsGoogleApiSourcesDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGoogleApiSourcesDeleteCall) Context(ctx context.Context) *ProjectsLocationsGoogleApiSourcesDeleteCall { + 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 *ProjectsLocationsGoogleApiSourcesDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGoogleApiSourcesDeleteCall) 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, "v1/{+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 "eventarc.projects.locations.googleApiSources.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 *ProjectsLocationsGoogleApiSourcesDeleteCall) 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 ProjectsLocationsGoogleApiSourcesGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Get a single GoogleApiSource. +// +// - name: The name of the google api source to get. +func (r *ProjectsLocationsGoogleApiSourcesService) Get(name string) *ProjectsLocationsGoogleApiSourcesGetCall { + c := &ProjectsLocationsGoogleApiSourcesGetCall{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 *ProjectsLocationsGoogleApiSourcesGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsGoogleApiSourcesGetCall { + 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 *ProjectsLocationsGoogleApiSourcesGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsGoogleApiSourcesGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGoogleApiSourcesGetCall) Context(ctx context.Context) *ProjectsLocationsGoogleApiSourcesGetCall { + 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 *ProjectsLocationsGoogleApiSourcesGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGoogleApiSourcesGetCall) 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/{+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 "eventarc.projects.locations.googleApiSources.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleApiSource.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 *ProjectsLocationsGoogleApiSourcesGetCall) Do(opts ...googleapi.CallOption) (*GoogleApiSource, 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 := &GoogleApiSource{ + 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 ProjectsLocationsGoogleApiSourcesGetIamPolicyCall 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 *ProjectsLocationsGoogleApiSourcesService) GetIamPolicy(resource string) *ProjectsLocationsGoogleApiSourcesGetIamPolicyCall { + c := &ProjectsLocationsGoogleApiSourcesGetIamPolicyCall{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 *ProjectsLocationsGoogleApiSourcesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsGoogleApiSourcesGetIamPolicyCall { + 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 *ProjectsLocationsGoogleApiSourcesGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsGoogleApiSourcesGetIamPolicyCall { + 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 *ProjectsLocationsGoogleApiSourcesGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsGoogleApiSourcesGetIamPolicyCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGoogleApiSourcesGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsGoogleApiSourcesGetIamPolicyCall { + 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 *ProjectsLocationsGoogleApiSourcesGetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGoogleApiSourcesGetIamPolicyCall) 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 "eventarc.projects.locations.googleApiSources.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 *ProjectsLocationsGoogleApiSourcesGetIamPolicyCall) 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 ProjectsLocationsGoogleApiSourcesListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: List GoogleApiSources. +// +// - parent: The parent collection to list GoogleApiSources on. +func (r *ProjectsLocationsGoogleApiSourcesService) List(parent string) *ProjectsLocationsGoogleApiSourcesListCall { + c := &ProjectsLocationsGoogleApiSourcesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Filter sets the optional parameter "filter": The filter field that the list +// request will filter on. Possible filtersare described in +// https://google.aip.dev/160. +func (c *ProjectsLocationsGoogleApiSourcesListCall) Filter(filter string) *ProjectsLocationsGoogleApiSourcesListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// OrderBy sets the optional parameter "orderBy": The sorting order of the +// resources returned. Value should be a comma-separated list of fields. The +// default sorting order is ascending. To specify descending order for a field, +// append a `desc` suffix; for example: `name desc, update_time`. +func (c *ProjectsLocationsGoogleApiSourcesListCall) OrderBy(orderBy string) *ProjectsLocationsGoogleApiSourcesListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number of +// results to return on each page. Note: The service may send fewer. +func (c *ProjectsLocationsGoogleApiSourcesListCall) PageSize(pageSize int64) *ProjectsLocationsGoogleApiSourcesListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The page token; provide +// the value from the `next_page_token` field in a previous call to retrieve +// the subsequent page. When paginating, all other parameters provided must +// match the previous call that provided the page token. +func (c *ProjectsLocationsGoogleApiSourcesListCall) PageToken(pageToken string) *ProjectsLocationsGoogleApiSourcesListCall { + 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 *ProjectsLocationsGoogleApiSourcesListCall) Fields(s ...googleapi.Field) *ProjectsLocationsGoogleApiSourcesListCall { + 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 *ProjectsLocationsGoogleApiSourcesListCall) IfNoneMatch(entityTag string) *ProjectsLocationsGoogleApiSourcesListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGoogleApiSourcesListCall) Context(ctx context.Context) *ProjectsLocationsGoogleApiSourcesListCall { + 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 *ProjectsLocationsGoogleApiSourcesListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGoogleApiSourcesListCall) 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}/googleApiSources") + 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 "eventarc.projects.locations.googleApiSources.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *ListGoogleApiSourcesResponse.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 *ProjectsLocationsGoogleApiSourcesListCall) Do(opts ...googleapi.CallOption) (*ListGoogleApiSourcesResponse, 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 := &ListGoogleApiSourcesResponse{ + 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 *ProjectsLocationsGoogleApiSourcesListCall) Pages(ctx context.Context, f func(*ListGoogleApiSourcesResponse) 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 ProjectsLocationsGoogleApiSourcesPatchCall struct { + s *Service + name string + googleapisource *GoogleApiSource + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Update a single GoogleApiSource. +// +// - name: Identifier. Resource name of the form +// projects/{project}/locations/{location}/googleApiSources/{google_api_source +// }. +func (r *ProjectsLocationsGoogleApiSourcesService) Patch(name string, googleapisource *GoogleApiSource) *ProjectsLocationsGoogleApiSourcesPatchCall { + c := &ProjectsLocationsGoogleApiSourcesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googleapisource = googleapisource + return c +} + +// AllowMissing sets the optional parameter "allowMissing": If set to true, and +// the GoogleApiSource is not found, a new GoogleApiSource will be created. In +// this situation, `update_mask` is ignored. +func (c *ProjectsLocationsGoogleApiSourcesPatchCall) AllowMissing(allowMissing bool) *ProjectsLocationsGoogleApiSourcesPatchCall { + c.urlParams_.Set("allowMissing", fmt.Sprint(allowMissing)) + return c +} + +// UpdateMask sets the optional parameter "updateMask": The fields to be +// updated; only fields explicitly provided are updated. If no field mask is +// provided, all provided fields in the request are updated. To update all +// fields, provide a field mask of "*". +func (c *ProjectsLocationsGoogleApiSourcesPatchCall) UpdateMask(updateMask string) *ProjectsLocationsGoogleApiSourcesPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": If set, validate +// the request and preview the review, but do not post it. +func (c *ProjectsLocationsGoogleApiSourcesPatchCall) ValidateOnly(validateOnly bool) *ProjectsLocationsGoogleApiSourcesPatchCall { + 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 *ProjectsLocationsGoogleApiSourcesPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsGoogleApiSourcesPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGoogleApiSourcesPatchCall) Context(ctx context.Context) *ProjectsLocationsGoogleApiSourcesPatchCall { + 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 *ProjectsLocationsGoogleApiSourcesPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGoogleApiSourcesPatchCall) 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.googleapisource) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "eventarc.projects.locations.googleApiSources.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 *ProjectsLocationsGoogleApiSourcesPatchCall) 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 ProjectsLocationsGoogleApiSourcesSetIamPolicyCall 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 *ProjectsLocationsGoogleApiSourcesService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsGoogleApiSourcesSetIamPolicyCall { + c := &ProjectsLocationsGoogleApiSourcesSetIamPolicyCall{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 *ProjectsLocationsGoogleApiSourcesSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsGoogleApiSourcesSetIamPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGoogleApiSourcesSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsGoogleApiSourcesSetIamPolicyCall { + 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 *ProjectsLocationsGoogleApiSourcesSetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGoogleApiSourcesSetIamPolicyCall) 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 "eventarc.projects.locations.googleApiSources.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 *ProjectsLocationsGoogleApiSourcesSetIamPolicyCall) 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 ProjectsLocationsGoogleApiSourcesTestIamPermissionsCall 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 *ProjectsLocationsGoogleApiSourcesService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsGoogleApiSourcesTestIamPermissionsCall { + c := &ProjectsLocationsGoogleApiSourcesTestIamPermissionsCall{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 *ProjectsLocationsGoogleApiSourcesTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsGoogleApiSourcesTestIamPermissionsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGoogleApiSourcesTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsGoogleApiSourcesTestIamPermissionsCall { + 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 *ProjectsLocationsGoogleApiSourcesTestIamPermissionsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGoogleApiSourcesTestIamPermissionsCall) 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 "eventarc.projects.locations.googleApiSources.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 *ProjectsLocationsGoogleApiSourcesTestIamPermissionsCall) 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 ProjectsLocationsMessageBusesCreateCall struct { + s *Service + parent string + messagebus *MessageBus + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Create a new MessageBus in a particular project and location. +// +// - parent: The parent collection in which to add this message bus. +func (r *ProjectsLocationsMessageBusesService) Create(parent string, messagebus *MessageBus) *ProjectsLocationsMessageBusesCreateCall { + c := &ProjectsLocationsMessageBusesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.messagebus = messagebus + return c +} + +// MessageBusId sets the optional parameter "messageBusId": Required. The +// user-provided ID to be assigned to the MessageBus. It should match the +// format (^a-z ([a-z0-9-]{0,61}[a-z0-9])?$) +func (c *ProjectsLocationsMessageBusesCreateCall) MessageBusId(messageBusId string) *ProjectsLocationsMessageBusesCreateCall { + c.urlParams_.Set("messageBusId", messageBusId) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": If set, validate +// the request and preview the review, but do not post it. +func (c *ProjectsLocationsMessageBusesCreateCall) ValidateOnly(validateOnly bool) *ProjectsLocationsMessageBusesCreateCall { + 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 *ProjectsLocationsMessageBusesCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsMessageBusesCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsMessageBusesCreateCall) Context(ctx context.Context) *ProjectsLocationsMessageBusesCreateCall { + 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 *ProjectsLocationsMessageBusesCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsMessageBusesCreateCall) 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.messagebus) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/messageBuses") + 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 "eventarc.projects.locations.messageBuses.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 *ProjectsLocationsMessageBusesCreateCall) 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 ProjectsLocationsMessageBusesDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Delete a single message bus. +// +// - name: The name of the MessageBus to be deleted. +func (r *ProjectsLocationsMessageBusesService) Delete(name string) *ProjectsLocationsMessageBusesDeleteCall { + c := &ProjectsLocationsMessageBusesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// AllowMissing sets the optional parameter "allowMissing": If set to true, and +// the MessageBus is not found, the request will succeed but no action will be +// taken on the server. +func (c *ProjectsLocationsMessageBusesDeleteCall) AllowMissing(allowMissing bool) *ProjectsLocationsMessageBusesDeleteCall { + c.urlParams_.Set("allowMissing", fmt.Sprint(allowMissing)) + return c +} + +// Etag sets the optional parameter "etag": If provided, the MessageBus will +// only be deleted if the etag matches the current etag on the resource. +func (c *ProjectsLocationsMessageBusesDeleteCall) Etag(etag string) *ProjectsLocationsMessageBusesDeleteCall { + c.urlParams_.Set("etag", etag) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": If set, validate +// the request and preview the review, but do not post it. +func (c *ProjectsLocationsMessageBusesDeleteCall) ValidateOnly(validateOnly bool) *ProjectsLocationsMessageBusesDeleteCall { + 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 *ProjectsLocationsMessageBusesDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsMessageBusesDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsMessageBusesDeleteCall) Context(ctx context.Context) *ProjectsLocationsMessageBusesDeleteCall { + 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 *ProjectsLocationsMessageBusesDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsMessageBusesDeleteCall) 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, "v1/{+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 "eventarc.projects.locations.messageBuses.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 *ProjectsLocationsMessageBusesDeleteCall) 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 ProjectsLocationsMessageBusesGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Get a single MessageBus. +// +// - name: The name of the message bus to get. +func (r *ProjectsLocationsMessageBusesService) Get(name string) *ProjectsLocationsMessageBusesGetCall { + c := &ProjectsLocationsMessageBusesGetCall{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 *ProjectsLocationsMessageBusesGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsMessageBusesGetCall { + 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 *ProjectsLocationsMessageBusesGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsMessageBusesGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsMessageBusesGetCall) Context(ctx context.Context) *ProjectsLocationsMessageBusesGetCall { + 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 *ProjectsLocationsMessageBusesGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsMessageBusesGetCall) 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/{+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 "eventarc.projects.locations.messageBuses.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *MessageBus.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 *ProjectsLocationsMessageBusesGetCall) Do(opts ...googleapi.CallOption) (*MessageBus, 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 := &MessageBus{ + 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 ProjectsLocationsMessageBusesGetIamPolicyCall 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 *ProjectsLocationsMessageBusesService) GetIamPolicy(resource string) *ProjectsLocationsMessageBusesGetIamPolicyCall { + c := &ProjectsLocationsMessageBusesGetIamPolicyCall{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 *ProjectsLocationsMessageBusesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsMessageBusesGetIamPolicyCall { + 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 *ProjectsLocationsMessageBusesGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsMessageBusesGetIamPolicyCall { + 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 *ProjectsLocationsMessageBusesGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsMessageBusesGetIamPolicyCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsMessageBusesGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsMessageBusesGetIamPolicyCall { + 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 *ProjectsLocationsMessageBusesGetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsMessageBusesGetIamPolicyCall) 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 "eventarc.projects.locations.messageBuses.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 *ProjectsLocationsMessageBusesGetIamPolicyCall) 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 ProjectsLocationsMessageBusesListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: List message buses. +// +// - parent: The parent collection to list triggers on. +func (r *ProjectsLocationsMessageBusesService) List(parent string) *ProjectsLocationsMessageBusesListCall { + c := &ProjectsLocationsMessageBusesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Filter sets the optional parameter "filter": The filter field that the list +// request will filter on. Possible filtersare described in +// https://google.aip.dev/160. +func (c *ProjectsLocationsMessageBusesListCall) Filter(filter string) *ProjectsLocationsMessageBusesListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// OrderBy sets the optional parameter "orderBy": The sorting order of the +// resources returned. Value should be a comma-separated list of fields. The +// default sorting order is ascending. To specify descending order for a field, +// append a `desc` suffix; for example: `name desc, update_time`. +func (c *ProjectsLocationsMessageBusesListCall) OrderBy(orderBy string) *ProjectsLocationsMessageBusesListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number of +// results to return on each page. Note: The service may send fewer. +func (c *ProjectsLocationsMessageBusesListCall) PageSize(pageSize int64) *ProjectsLocationsMessageBusesListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The page token; provide +// the value from the `next_page_token` field in a previous call to retrieve +// the subsequent page. When paginating, all other parameters provided must +// match the previous call that provided the page token. +func (c *ProjectsLocationsMessageBusesListCall) PageToken(pageToken string) *ProjectsLocationsMessageBusesListCall { + 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 *ProjectsLocationsMessageBusesListCall) Fields(s ...googleapi.Field) *ProjectsLocationsMessageBusesListCall { + 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 *ProjectsLocationsMessageBusesListCall) IfNoneMatch(entityTag string) *ProjectsLocationsMessageBusesListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsMessageBusesListCall) Context(ctx context.Context) *ProjectsLocationsMessageBusesListCall { + 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 *ProjectsLocationsMessageBusesListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsMessageBusesListCall) 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}/messageBuses") + 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 "eventarc.projects.locations.messageBuses.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *ListMessageBusesResponse.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 *ProjectsLocationsMessageBusesListCall) Do(opts ...googleapi.CallOption) (*ListMessageBusesResponse, 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 := &ListMessageBusesResponse{ + 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 *ProjectsLocationsMessageBusesListCall) Pages(ctx context.Context, f func(*ListMessageBusesResponse) 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 ProjectsLocationsMessageBusesListEnrollmentsCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// ListEnrollments: List message bus enrollments. +// +// - parent: The parent message bus to list enrollments on. +func (r *ProjectsLocationsMessageBusesService) ListEnrollments(parent string) *ProjectsLocationsMessageBusesListEnrollmentsCall { + c := &ProjectsLocationsMessageBusesListEnrollmentsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number of +// results to return on each page. Note: The service may send fewer. +func (c *ProjectsLocationsMessageBusesListEnrollmentsCall) PageSize(pageSize int64) *ProjectsLocationsMessageBusesListEnrollmentsCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The page token; provide +// the value from the `next_page_token` field in a previous call to retrieve +// the subsequent page. When paginating, all other parameters provided must +// match the previous call that provided the page token. +func (c *ProjectsLocationsMessageBusesListEnrollmentsCall) PageToken(pageToken string) *ProjectsLocationsMessageBusesListEnrollmentsCall { + 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 *ProjectsLocationsMessageBusesListEnrollmentsCall) Fields(s ...googleapi.Field) *ProjectsLocationsMessageBusesListEnrollmentsCall { + 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 *ProjectsLocationsMessageBusesListEnrollmentsCall) IfNoneMatch(entityTag string) *ProjectsLocationsMessageBusesListEnrollmentsCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsMessageBusesListEnrollmentsCall) Context(ctx context.Context) *ProjectsLocationsMessageBusesListEnrollmentsCall { + 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 *ProjectsLocationsMessageBusesListEnrollmentsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsMessageBusesListEnrollmentsCall) 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}:listEnrollments") + 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 "eventarc.projects.locations.messageBuses.listEnrollments" call. +// Any non-2xx status code is an error. Response headers are in either +// *ListMessageBusEnrollmentsResponse.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 *ProjectsLocationsMessageBusesListEnrollmentsCall) Do(opts ...googleapi.CallOption) (*ListMessageBusEnrollmentsResponse, 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 := &ListMessageBusEnrollmentsResponse{ + 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 *ProjectsLocationsMessageBusesListEnrollmentsCall) Pages(ctx context.Context, f func(*ListMessageBusEnrollmentsResponse) 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 ProjectsLocationsMessageBusesPatchCall struct { + s *Service + name string + messagebus *MessageBus + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Update a single message bus. +// +// - name: Identifier. Resource name of the form +// projects/{project}/locations/{location}/messageBuses/{message_bus}. +func (r *ProjectsLocationsMessageBusesService) Patch(name string, messagebus *MessageBus) *ProjectsLocationsMessageBusesPatchCall { + c := &ProjectsLocationsMessageBusesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.messagebus = messagebus + return c +} + +// AllowMissing sets the optional parameter "allowMissing": If set to true, and +// the MessageBus is not found, a new MessageBus will be created. In this +// situation, `update_mask` is ignored. +func (c *ProjectsLocationsMessageBusesPatchCall) AllowMissing(allowMissing bool) *ProjectsLocationsMessageBusesPatchCall { + c.urlParams_.Set("allowMissing", fmt.Sprint(allowMissing)) + return c +} + +// UpdateMask sets the optional parameter "updateMask": The fields to be +// updated; only fields explicitly provided are updated. If no field mask is +// provided, all provided fields in the request are updated. To update all +// fields, provide a field mask of "*". +func (c *ProjectsLocationsMessageBusesPatchCall) UpdateMask(updateMask string) *ProjectsLocationsMessageBusesPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": If set, validate +// the request and preview the review, but do not post it. +func (c *ProjectsLocationsMessageBusesPatchCall) ValidateOnly(validateOnly bool) *ProjectsLocationsMessageBusesPatchCall { + 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 *ProjectsLocationsMessageBusesPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsMessageBusesPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsMessageBusesPatchCall) Context(ctx context.Context) *ProjectsLocationsMessageBusesPatchCall { + 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 *ProjectsLocationsMessageBusesPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsMessageBusesPatchCall) 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.messagebus) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "eventarc.projects.locations.messageBuses.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 *ProjectsLocationsMessageBusesPatchCall) 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 ProjectsLocationsMessageBusesSetIamPolicyCall 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 *ProjectsLocationsMessageBusesService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsMessageBusesSetIamPolicyCall { + c := &ProjectsLocationsMessageBusesSetIamPolicyCall{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 *ProjectsLocationsMessageBusesSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsMessageBusesSetIamPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsMessageBusesSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsMessageBusesSetIamPolicyCall { + 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 *ProjectsLocationsMessageBusesSetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsMessageBusesSetIamPolicyCall) 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 "eventarc.projects.locations.messageBuses.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 *ProjectsLocationsMessageBusesSetIamPolicyCall) 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 ProjectsLocationsMessageBusesTestIamPermissionsCall 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 *ProjectsLocationsMessageBusesService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsMessageBusesTestIamPermissionsCall { + c := &ProjectsLocationsMessageBusesTestIamPermissionsCall{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 *ProjectsLocationsMessageBusesTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsMessageBusesTestIamPermissionsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsMessageBusesTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsMessageBusesTestIamPermissionsCall { + 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 *ProjectsLocationsMessageBusesTestIamPermissionsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsMessageBusesTestIamPermissionsCall) 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 "eventarc.projects.locations.messageBuses.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 *ProjectsLocationsMessageBusesTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestIamPermissionsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -4961,68 +7893,659 @@ func (c *ProjectsLocationsMessageBusesTestIamPermissionsCall) Do(opts ...googlea return ret, nil } -type ProjectsLocationsOperationsCancelCall struct { - s *Service - name string - googlelongrunningcanceloperationrequest *GoogleLongrunningCancelOperationRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +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 +} + +// 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.googlelongrunningcanceloperationrequest) + 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 "eventarc.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 +} + +// 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`. +// +// - 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 *ProjectsLocationsOperationsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +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 *ProjectsLocationsOperationsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsOperationsDeleteCall) 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, "v1/{+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 "eventarc.projects.locations.operations.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 *ProjectsLocationsOperationsDeleteCall) 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, "v1/{+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 "eventarc.projects.locations.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 *ProjectsLocationsOperationsGetCall) 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 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, "v1/{+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 "eventarc.projects.locations.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 *ProjectsLocationsOperationsListCall) 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 *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) + } } -// 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`. +type ProjectsLocationsPipelinesCreateCall struct { + s *Service + parent string + pipeline *Pipeline + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Create a new Pipeline in a particular project and location. // -// - 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 +// - parent: The parent collection in which to add this pipeline. +func (r *ProjectsLocationsPipelinesService) Create(parent string, pipeline *Pipeline) *ProjectsLocationsPipelinesCreateCall { + c := &ProjectsLocationsPipelinesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.pipeline = pipeline + return c +} + +// PipelineId sets the optional parameter "pipelineId": Required. The +// user-provided ID to be assigned to the Pipeline. +func (c *ProjectsLocationsPipelinesCreateCall) PipelineId(pipelineId string) *ProjectsLocationsPipelinesCreateCall { + c.urlParams_.Set("pipelineId", pipelineId) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": If set, validate +// the request and preview the review, but do not post it. +func (c *ProjectsLocationsPipelinesCreateCall) ValidateOnly(validateOnly bool) *ProjectsLocationsPipelinesCreateCall { + 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 *ProjectsLocationsPipelinesCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsPipelinesCreateCall { 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 *ProjectsLocationsPipelinesCreateCall) Context(ctx context.Context) *ProjectsLocationsPipelinesCreateCall { 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 *ProjectsLocationsPipelinesCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsOperationsCancelCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsPipelinesCreateCall) 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 - } + body, err := googleapi.WithoutDataWrapper.JSONReader(c.pipeline) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/pipelines") + 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 "eventarc.projects.locations.pipelines.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 *ProjectsLocationsPipelinesCreateCall) 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 ProjectsLocationsPipelinesDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Delete a single pipeline. +// +// - name: The name of the Pipeline to be deleted. +func (r *ProjectsLocationsPipelinesService) Delete(name string) *ProjectsLocationsPipelinesDeleteCall { + c := &ProjectsLocationsPipelinesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// AllowMissing sets the optional parameter "allowMissing": If set to true, and +// the Pipeline is not found, the request will succeed but no action will be +// taken on the server. +func (c *ProjectsLocationsPipelinesDeleteCall) AllowMissing(allowMissing bool) *ProjectsLocationsPipelinesDeleteCall { + c.urlParams_.Set("allowMissing", fmt.Sprint(allowMissing)) + return c +} + +// Etag sets the optional parameter "etag": If provided, the Pipeline will only +// be deleted if the etag matches the current etag on the resource. +func (c *ProjectsLocationsPipelinesDeleteCall) Etag(etag string) *ProjectsLocationsPipelinesDeleteCall { + c.urlParams_.Set("etag", etag) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": If set, validate +// the request and preview the review, but do not post it. +func (c *ProjectsLocationsPipelinesDeleteCall) ValidateOnly(validateOnly bool) *ProjectsLocationsPipelinesDeleteCall { + 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 *ProjectsLocationsPipelinesDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsPipelinesDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsPipelinesDeleteCall) Context(ctx context.Context) *ProjectsLocationsPipelinesDeleteCall { + 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 *ProjectsLocationsPipelinesDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsPipelinesDeleteCall) 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, "v1/{+name}:cancel") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+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 } @@ -5033,12 +8556,13 @@ func (c *ProjectsLocationsOperationsCancelCall) doRequest(alt string) (*http.Res return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "eventarc.projects.locations.operations.cancel" call. +// Do executes the "eventarc.projects.locations.pipelines.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 *ProjectsLocationsPipelinesDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -5057,7 +8581,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, @@ -5070,22 +8594,20 @@ 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 ProjectsLocationsPipelinesGetCall 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: Get a single Pipeline. // -// - 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 name of the pipeline to get. +func (r *ProjectsLocationsPipelinesService) Get(name string) *ProjectsLocationsPipelinesGetCall { + c := &ProjectsLocationsPipelinesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } @@ -5093,34 +8615,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 *ProjectsLocationsPipelinesGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsPipelinesGetCall { 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 *ProjectsLocationsPipelinesGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsPipelinesGetCall { + 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 *ProjectsLocationsPipelinesGetCall) Context(ctx context.Context) *ProjectsLocationsPipelinesGetCall { 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 *ProjectsLocationsPipelinesGetCall) 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 *ProjectsLocationsPipelinesGetCall) 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/{+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 } @@ -5131,12 +8664,12 @@ func (c *ProjectsLocationsOperationsDeleteCall) doRequest(alt string) (*http.Res return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "eventarc.projects.locations.operations.delete" call. +// Do executes the "eventarc.projects.locations.pipelines.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 +// *Pipeline.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 *ProjectsLocationsOperationsDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error) { +func (c *ProjectsLocationsPipelinesGetCall) Do(opts ...googleapi.CallOption) (*Pipeline, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -5155,7 +8688,7 @@ func (c *ProjectsLocationsOperationsDeleteCall) Do(opts ...googleapi.CallOption) if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Empty{ + ret := &Pipeline{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -5168,30 +8701,48 @@ func (c *ProjectsLocationsOperationsDeleteCall) Do(opts ...googleapi.CallOption) return ret, nil } -type ProjectsLocationsOperationsGetCall struct { +type ProjectsLocationsPipelinesGetIamPolicyCall 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 *ProjectsLocationsPipelinesService) GetIamPolicy(resource string) *ProjectsLocationsPipelinesGetIamPolicyCall { + c := &ProjectsLocationsPipelinesGetIamPolicyCall{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 *ProjectsLocationsPipelinesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsPipelinesGetIamPolicyCall { + 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 *ProjectsLocationsPipelinesGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsPipelinesGetIamPolicyCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -5199,27 +8750,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 *ProjectsLocationsPipelinesGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsPipelinesGetIamPolicyCall { 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 *ProjectsLocationsPipelinesGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsPipelinesGetIamPolicyCall { 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 *ProjectsLocationsPipelinesGetIamPolicyCall) 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 *ProjectsLocationsPipelinesGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) @@ -5227,7 +8778,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, "v1/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:getIamPolicy") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, body) if err != nil { @@ -5235,18 +8786,17 @@ 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 "eventarc.projects.locations.operations.get" call. +// Do executes the "eventarc.projects.locations.pipelines.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) { +// *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 *ProjectsLocationsPipelinesGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -5265,7 +8815,7 @@ func (c *ProjectsLocationsOperationsGetCall) Do(opts ...googleapi.CallOption) (* if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &Policy{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -5278,41 +8828,53 @@ func (c *ProjectsLocationsOperationsGetCall) Do(opts ...googleapi.CallOption) (* return ret, nil } -type ProjectsLocationsOperationsListCall struct { +type ProjectsLocationsPipelinesListCall 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: List pipelines. // -// - 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 collection to list pipelines on. +func (r *ProjectsLocationsPipelinesService) List(parent string) *ProjectsLocationsPipelinesListCall { + c := &ProjectsLocationsPipelinesListCall{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": The filter field that the list +// request will filter on. Possible filters are described in +// https://google.aip.dev/160. +func (c *ProjectsLocationsPipelinesListCall) Filter(filter string) *ProjectsLocationsPipelinesListCall { 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": The sorting order of the +// resources returned. Value should be a comma-separated list of fields. The +// default sorting order is ascending. To specify descending order for a field, +// append a `desc` suffix; for example: `name desc, update_time`. +func (c *ProjectsLocationsPipelinesListCall) OrderBy(orderBy string) *ProjectsLocationsPipelinesListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number of +// results to return on each page. Note: The service may send fewer. +func (c *ProjectsLocationsPipelinesListCall) PageSize(pageSize int64) *ProjectsLocationsPipelinesListCall { 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 page token; provide +// the value from the `next_page_token` field in a previous call to retrieve +// the subsequent page. When paginating, all other parameters provided must +// match the previous call that provided the page token. +func (c *ProjectsLocationsPipelinesListCall) PageToken(pageToken string) *ProjectsLocationsPipelinesListCall { c.urlParams_.Set("pageToken", pageToken) return c } @@ -5320,7 +8882,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 *ProjectsLocationsPipelinesListCall) Fields(s ...googleapi.Field) *ProjectsLocationsPipelinesListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -5328,27 +8890,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 *ProjectsLocationsPipelinesListCall) IfNoneMatch(entityTag string) *ProjectsLocationsPipelinesListCall { 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 *ProjectsLocationsPipelinesListCall) Context(ctx context.Context) *ProjectsLocationsPipelinesListCall { 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 *ProjectsLocationsPipelinesListCall) 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 *ProjectsLocationsPipelinesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) @@ -5356,7 +8918,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, "v1/{+name}/operations") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/pipelines") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, body) if err != nil { @@ -5364,18 +8926,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 "eventarc.projects.locations.operations.list" call. +// Do executes the "eventarc.projects.locations.pipelines.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) { +// *ListPipelinesResponse.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 *ProjectsLocationsPipelinesListCall) Do(opts ...googleapi.CallOption) (*ListPipelinesResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -5394,7 +8956,7 @@ func (c *ProjectsLocationsOperationsListCall) Do(opts ...googleapi.CallOption) ( if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningListOperationsResponse{ + ret := &ListPipelinesResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -5410,7 +8972,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 *ProjectsLocationsPipelinesListCall) Pages(ctx context.Context, f func(*ListPipelinesResponse) error) error { c.ctx_ = ctx defer c.PageToken(c.urlParams_.Get("pageToken")) for { @@ -5428,102 +8990,103 @@ func (c *ProjectsLocationsOperationsListCall) Pages(ctx context.Context, f func( } } -type ProjectsLocationsPipelinesGetIamPolicyCall struct { - s *Service - resource string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsPipelinesPatchCall struct { + s *Service + name string + pipeline *Pipeline + urlParams_ gensupport.URLParams + 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. +// Patch: Update a single pipeline. // -// - 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 *ProjectsLocationsPipelinesService) GetIamPolicy(resource string) *ProjectsLocationsPipelinesGetIamPolicyCall { - c := &ProjectsLocationsPipelinesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource +// - name: Identifier. The resource name of the Pipeline. Must be unique within +// the location of the project and must be in +// `projects/{project}/locations/{location}/pipelines/{pipeline}` format. +func (r *ProjectsLocationsPipelinesService) Patch(name string, pipeline *Pipeline) *ProjectsLocationsPipelinesPatchCall { + c := &ProjectsLocationsPipelinesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.pipeline = pipeline 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 *ProjectsLocationsPipelinesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsPipelinesGetIamPolicyCall { - c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) +// AllowMissing sets the optional parameter "allowMissing": If set to true, and +// the Pipeline is not found, a new Pipeline will be created. In this +// situation, `update_mask` is ignored. +func (c *ProjectsLocationsPipelinesPatchCall) AllowMissing(allowMissing bool) *ProjectsLocationsPipelinesPatchCall { + c.urlParams_.Set("allowMissing", fmt.Sprint(allowMissing)) + return c +} + +// UpdateMask sets the optional parameter "updateMask": The fields to be +// updated; only fields explicitly provided are updated. If no field mask is +// provided, all provided fields in the request are updated. To update all +// fields, provide a field mask of "*". +func (c *ProjectsLocationsPipelinesPatchCall) UpdateMask(updateMask string) *ProjectsLocationsPipelinesPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": If set, validate +// the request and preview the review, but do not post it. +func (c *ProjectsLocationsPipelinesPatchCall) ValidateOnly(validateOnly bool) *ProjectsLocationsPipelinesPatchCall { + 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 *ProjectsLocationsPipelinesGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsPipelinesGetIamPolicyCall { +func (c *ProjectsLocationsPipelinesPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsPipelinesPatchCall { 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 *ProjectsLocationsPipelinesGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsPipelinesGetIamPolicyCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsPipelinesGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsPipelinesGetIamPolicyCall { +func (c *ProjectsLocationsPipelinesPatchCall) Context(ctx context.Context) *ProjectsLocationsPipelinesPatchCall { 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 *ProjectsLocationsPipelinesGetIamPolicyCall) Header() http.Header { +func (c *ProjectsLocationsPipelinesPatchCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsPipelinesGetIamPolicyCall) 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 *ProjectsLocationsPipelinesPatchCall) 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.pipeline) + if err != nil { + return nil, err + } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:getIamPolicy") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+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 } 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 "eventarc.projects.locations.pipelines.getIamPolicy" call. +// Do executes the "eventarc.projects.locations.pipelines.patch" 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 *ProjectsLocationsPipelinesGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, 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 *ProjectsLocationsPipelinesPatchCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -5542,7 +9105,7 @@ func (c *ProjectsLocationsPipelinesGetIamPolicyCall) Do(opts ...googleapi.CallOp if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Policy{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, diff --git a/firebase/v1beta1/firebase-api.json b/firebase/v1beta1/firebase-api.json index 6b0e107cba6..9520c6f85ff 100644 --- a/firebase/v1beta1/firebase-api.json +++ b/firebase/v1beta1/firebase-api.json @@ -1324,7 +1324,7 @@ } } }, - "revision": "20240913", + "revision": "20241025", "rootUrl": "https://firebase.googleapis.com/", "schemas": { "AddFirebaseRequest": { @@ -1436,7 +1436,7 @@ "type": "string" }, "expireTime": { - "description": "Output only. Timestamp of when the App will be considered expired and cannot be undeleted. This value is only provided if the App is in the `DELETED` state.", + "description": "Output only. If the App has been removed from the Project, this is the timestamp of when the App is considered expired and will be permanently deleted. After this time, the App cannot be undeleted (that is, restored to the Project). This value is only provided if the App is in the `DELETED` state.", "format": "google-datetime", "readOnly": true, "type": "string" @@ -1569,7 +1569,7 @@ "type": "string" }, "expireTime": { - "description": "Output only. Timestamp of when the App will be considered expired and cannot be undeleted. This value is only provided if the App is in the `DELETED` state.", + "description": "Output only. If the App has been removed from the Project, this is the timestamp of when the App is considered expired and will be permanently deleted. After this time, the App cannot be undeleted (that is, restored to the Project). This value is only provided if the App is in the `DELETED` state.", "format": "google-datetime", "readOnly": true, "type": "string" @@ -1705,7 +1705,7 @@ "type": "string" }, "expireTime": { - "description": "Output only. Timestamp of when the App will be considered expired and cannot be undeleted. This value is only provided if the App is in the `DELETED` state.", + "description": "Output only. If the App has been removed from the Project, this is the timestamp of when the App is considered expired and will be permanently deleted. After this time, the App cannot be undeleted (that is, restored to the Project). This value is only provided if the App is in the `DELETED` state.", "format": "google-datetime", "readOnly": true, "type": "string" @@ -2020,7 +2020,7 @@ "type": "string" }, "immediate": { - "description": "Determines whether to _immediately_ delete the AndroidApp. If set to true, the App is immediately deleted from the Project and cannot be restored to the Project. If not set, defaults to false, which means the App will be set to expire in 30 days. Within the 30 days, the App may be restored to the Project using UndeleteAndroidApp.", + "description": "Determines whether to _immediately_ delete the AndroidApp. If set to true, the App is immediately deleted from the Project and cannot be undeleted (that is, restored to the Project). If not set, defaults to false, which means the App will be set to expire in 30 days. Within the 30 days, the App may be restored to the Project using UndeleteAndroidApp.", "type": "boolean" }, "validateOnly": { @@ -2042,7 +2042,7 @@ "type": "string" }, "immediate": { - "description": "Determines whether to _immediately_ delete the IosApp. If set to true, the App is immediately deleted from the Project and cannot be restored to the Project. If not set, defaults to false, which means the App will be set to expire in 30 days. Within the 30 days, the App may be restored to the Project using UndeleteIosApp", + "description": "Determines whether to _immediately_ delete the IosApp. If set to true, the App is immediately deleted from the Project and cannot be undeleted (that is, restored to the Project). If not set, defaults to false, which means the App will be set to expire in 30 days. Within the 30 days, the App may be restored to the Project using UndeleteIosApp", "type": "boolean" }, "validateOnly": { @@ -2064,7 +2064,7 @@ "type": "string" }, "immediate": { - "description": "Determines whether to _immediately_ delete the WebApp. If set to true, the App is immediately deleted from the Project and cannot be restored to the Project. If not set, defaults to false, which means the App will be set to expire in 30 days. Within the 30 days, the App may be restored to the Project using UndeleteWebApp", + "description": "Determines whether to _immediately_ delete the WebApp. If set to true, the App is immediately deleted from the Project and cannot be undeleted (that is, restored to the Project). If not set, defaults to false, which means the App will be set to expire in 30 days. Within the 30 days, the App may be restored to the Project using UndeleteWebApp", "type": "boolean" }, "validateOnly": { @@ -2267,7 +2267,7 @@ "type": "string" }, "expireTime": { - "description": "Output only. Timestamp of when the App will be considered expired and cannot be undeleted. This value is only provided if the App is in the `DELETED` state.", + "description": "Output only. If the App has been removed from the Project, this is the timestamp of when the App is considered expired and will be permanently deleted. After this time, the App cannot be undeleted (that is, restored to the Project). This value is only provided if the App is in the `DELETED` state.", "format": "google-datetime", "readOnly": true, "type": "string" diff --git a/firebase/v1beta1/firebase-gen.go b/firebase/v1beta1/firebase-gen.go index 192c7ef4996..20bb53574d4 100644 --- a/firebase/v1beta1/firebase-gen.go +++ b/firebase/v1beta1/firebase-gen.go @@ -481,9 +481,11 @@ type AndroidApp struct { // (https://google.aip.dev/154#declarative-friendly-resources). This etag is // strongly validated. Etag string `json:"etag,omitempty"` - // ExpireTime: Output only. Timestamp of when the App will be considered - // expired and cannot be undeleted. This value is only provided if the App is - // in the `DELETED` state. + // ExpireTime: Output only. If the App has been removed from the Project, this + // is the timestamp of when the App is considered expired and will be + // permanently deleted. After this time, the App cannot be undeleted (that is, + // restored to the Project). This value is only provided if the App is in the + // `DELETED` state. ExpireTime string `json:"expireTime,omitempty"` // Name: The resource name of the AndroidApp, in the format: projects/ // PROJECT_IDENTIFIER/androidApps/APP_ID * PROJECT_IDENTIFIER: the parent @@ -695,9 +697,11 @@ type FirebaseAppInfo struct { AppId string `json:"appId,omitempty"` // DisplayName: The user-assigned display name of the Firebase App. DisplayName string `json:"displayName,omitempty"` - // ExpireTime: Output only. Timestamp of when the App will be considered - // expired and cannot be undeleted. This value is only provided if the App is - // in the `DELETED` state. + // ExpireTime: Output only. If the App has been removed from the Project, this + // is the timestamp of when the App is considered expired and will be + // permanently deleted. After this time, the App cannot be undeleted (that is, + // restored to the Project). This value is only provided if the App is in the + // `DELETED` state. ExpireTime string `json:"expireTime,omitempty"` // Name: The resource name of the Firebase App, in the format: // projects/PROJECT_ID /iosApps/APP_ID or @@ -867,9 +871,11 @@ type IosApp struct { // (https://google.aip.dev/154#declarative-friendly-resources). This etag is // strongly validated. Etag string `json:"etag,omitempty"` - // ExpireTime: Output only. Timestamp of when the App will be considered - // expired and cannot be undeleted. This value is only provided if the App is - // in the `DELETED` state. + // ExpireTime: Output only. If the App has been removed from the Project, this + // is the timestamp of when the App is considered expired and will be + // permanently deleted. After this time, the App cannot be undeleted (that is, + // restored to the Project). This value is only provided if the App is in the + // `DELETED` state. ExpireTime string `json:"expireTime,omitempty"` // Name: The resource name of the IosApp, in the format: // projects/PROJECT_IDENTIFIER /iosApps/APP_ID * PROJECT_IDENTIFIER: the parent @@ -1364,9 +1370,9 @@ type RemoveAndroidAppRequest struct { Etag string `json:"etag,omitempty"` // Immediate: Determines whether to _immediately_ delete the AndroidApp. If set // to true, the App is immediately deleted from the Project and cannot be - // restored to the Project. If not set, defaults to false, which means the App - // will be set to expire in 30 days. Within the 30 days, the App may be - // restored to the Project using UndeleteAndroidApp. + // undeleted (that is, restored to the Project). If not set, defaults to false, + // which means the App will be set to expire in 30 days. Within the 30 days, + // the App may be restored to the Project using UndeleteAndroidApp. Immediate bool `json:"immediate,omitempty"` // ValidateOnly: If set to true, the request is only validated. The App will // _not_ be removed. @@ -1397,10 +1403,10 @@ type RemoveIosAppRequest struct { // ensures that the client has an up-to-date value before proceeding. Etag string `json:"etag,omitempty"` // Immediate: Determines whether to _immediately_ delete the IosApp. If set to - // true, the App is immediately deleted from the Project and cannot be restored - // to the Project. If not set, defaults to false, which means the App will be - // set to expire in 30 days. Within the 30 days, the App may be restored to the - // Project using UndeleteIosApp + // true, the App is immediately deleted from the Project and cannot be + // undeleted (that is, restored to the Project). If not set, defaults to false, + // which means the App will be set to expire in 30 days. Within the 30 days, + // the App may be restored to the Project using UndeleteIosApp Immediate bool `json:"immediate,omitempty"` // ValidateOnly: If set to true, the request is only validated. The App will // _not_ be removed. @@ -1431,10 +1437,10 @@ type RemoveWebAppRequest struct { // ensures that the client has an up-to-date value before proceeding. Etag string `json:"etag,omitempty"` // Immediate: Determines whether to _immediately_ delete the WebApp. If set to - // true, the App is immediately deleted from the Project and cannot be restored - // to the Project. If not set, defaults to false, which means the App will be - // set to expire in 30 days. Within the 30 days, the App may be restored to the - // Project using UndeleteWebApp + // true, the App is immediately deleted from the Project and cannot be + // undeleted (that is, restored to the Project). If not set, defaults to false, + // which means the App will be set to expire in 30 days. Within the 30 days, + // the App may be restored to the Project using UndeleteWebApp Immediate bool `json:"immediate,omitempty"` // ValidateOnly: If set to true, the request is only validated. The App will // _not_ be removed. @@ -1750,9 +1756,11 @@ type WebApp struct { // (https://google.aip.dev/154#declarative-friendly-resources). This etag is // strongly validated. Etag string `json:"etag,omitempty"` - // ExpireTime: Output only. Timestamp of when the App will be considered - // expired and cannot be undeleted. This value is only provided if the App is - // in the `DELETED` state. + // ExpireTime: Output only. If the App has been removed from the Project, this + // is the timestamp of when the App is considered expired and will be + // permanently deleted. After this time, the App cannot be undeleted (that is, + // restored to the Project). This value is only provided if the App is in the + // `DELETED` state. ExpireTime string `json:"expireTime,omitempty"` // Name: The resource name of the WebApp, in the format: // projects/PROJECT_IDENTIFIER /webApps/APP_ID * PROJECT_IDENTIFIER: the parent diff --git a/firebaseappdistribution/v1alpha/firebaseappdistribution-api.json b/firebaseappdistribution/v1alpha/firebaseappdistribution-api.json index bc41ddaa414..d4b361a0b48 100644 --- a/firebaseappdistribution/v1alpha/firebaseappdistribution-api.json +++ b/firebaseappdistribution/v1alpha/firebaseappdistribution-api.json @@ -625,7 +625,7 @@ } } }, - "revision": "20241018", + "revision": "20241028", "rootUrl": "https://firebaseappdistribution.googleapis.com/", "schemas": { "AndroidxCrawlerOutputPoint": { @@ -1488,6 +1488,10 @@ }, "type": "array" }, + "displayName": { + "description": "Optional. Display name of the release test. Required if the release test is created with multiple goals", + "type": "string" + }, "loginCredential": { "$ref": "GoogleFirebaseAppdistroV1alphaLoginCredential", "description": "Optional. Input only. Login credentials for the test. Input only." diff --git a/firebaseappdistribution/v1alpha/firebaseappdistribution-gen.go b/firebaseappdistribution/v1alpha/firebaseappdistribution-gen.go index 9d5c27ace83..1ef0e7f7930 100644 --- a/firebaseappdistribution/v1alpha/firebaseappdistribution-gen.go +++ b/firebaseappdistribution/v1alpha/firebaseappdistribution-gen.go @@ -1248,6 +1248,9 @@ type GoogleFirebaseAppdistroV1alphaReleaseTest struct { CreateTime string `json:"createTime,omitempty"` // DeviceExecutions: Required. The results of the test on each device. DeviceExecutions []*GoogleFirebaseAppdistroV1alphaDeviceExecution `json:"deviceExecutions,omitempty"` + // DisplayName: Optional. Display name of the release test. Required if the + // release test is created with multiple goals + DisplayName string `json:"displayName,omitempty"` // LoginCredential: Optional. Input only. Login credentials for the test. Input // only. LoginCredential *GoogleFirebaseAppdistroV1alphaLoginCredential `json:"loginCredential,omitempty"` diff --git a/firebaseml/v2beta/firebaseml-api.json b/firebaseml/v2beta/firebaseml-api.json index 7513fefcd42..8792b27dd29 100644 --- a/firebaseml/v2beta/firebaseml-api.json +++ b/firebaseml/v2beta/firebaseml-api.json @@ -206,7 +206,7 @@ } } }, - "revision": "20241021", + "revision": "20241024", "rootUrl": "https://firebaseml.googleapis.com/", "schemas": { "Date": { @@ -291,7 +291,7 @@ "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, content is empty if content filters blocks the output.", - "Token generation stopped because the content potentially contains copyright violations.", + "The token generation stopped because of potential recitation.", "All other reasons that stopped the token generation.", "Token generation stopped because the content contains forbidden terms.", "Token generation stopped for potentially containing prohibited content.", @@ -596,7 +596,7 @@ "type": "object" }, "GoogleCloudAiplatformV1beta1FunctionDeclaration": { - "description": "Structured representation of a function declaration as defined by the [OpenAPI 3.0 specification](https://spec.openapis.org/oas/v3.0.3). Included in this declaration are the function name and parameters. This FunctionDeclaration is a representation of a block of code that can be used as a `Tool` by the model and executed by the client.", + "description": "Structured representation of a function declaration as defined by the [OpenAPI 3.0 specification](https://spec.openapis.org/oas/v3.0.3). Included in this declaration are the function name, description, parameters and response type. This FunctionDeclaration is a representation of a block of code that can be used as a `Tool` by the model and executed by the client.", "id": "GoogleCloudAiplatformV1beta1FunctionDeclaration", "properties": { "description": { diff --git a/firebaseml/v2beta/firebaseml-gen.go b/firebaseml/v2beta/firebaseml-gen.go index 5e2f8422586..ce7f1abfe5a 100644 --- a/firebaseml/v2beta/firebaseml-gen.go +++ b/firebaseml/v2beta/firebaseml-gen.go @@ -286,8 +286,8 @@ type GoogleCloudAiplatformV1beta1Candidate struct { // "SAFETY" - Token generation stopped because the content potentially // 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. + // "RECITATION" - The token generation stopped because of potential + // recitation. // "OTHER" - All other reasons that stopped the token generation. // "BLOCKLIST" - Token generation stopped because the content contains // forbidden terms. @@ -703,9 +703,9 @@ func (s GoogleCloudAiplatformV1beta1FunctionCallingConfig) MarshalJSON() ([]byte // GoogleCloudAiplatformV1beta1FunctionDeclaration: Structured representation // of a function declaration as defined by the OpenAPI 3.0 specification // (https://spec.openapis.org/oas/v3.0.3). Included in this declaration are the -// function name and parameters. This FunctionDeclaration is a representation -// of a block of code that can be used as a `Tool` by the model and executed by -// the client. +// function name, description, parameters and response type. This +// FunctionDeclaration is a representation of a block of code that can be used +// as a `Tool` by the model and executed by the client. type GoogleCloudAiplatformV1beta1FunctionDeclaration struct { // Description: Optional. Description and purpose of the function. Model uses // it to decide how and whether to call the function. diff --git a/firestore/v1/firestore-api.json b/firestore/v1/firestore-api.json index fad19ee7852..a5dd57bc853 100644 --- a/firestore/v1/firestore-api.json +++ b/firestore/v1/firestore-api.json @@ -1711,7 +1711,7 @@ } } }, - "revision": "20240904", + "revision": "20241018", "rootUrl": "https://firestore.googleapis.com/", "schemas": { "Aggregation": { @@ -2417,7 +2417,7 @@ "type": "string" }, "distanceThreshold": { - "description": "Optional. Option to specify a threshold for which no less similar documents will be returned. The behavior of the specified `distance_measure` will affect the meaning of the distance threshold. Since DOT_PRODUCT distances increase when the vectors are more similar, the comparison is inverted. For EUCLIDEAN, COSINE: WHERE distance \u003c= distance_threshold For DOT_PRODUCT: WHERE distance \u003e= distance_threshold", + "description": "Optional. Option to specify a threshold for which no less similar documents will be returned. The behavior of the specified `distance_measure` will affect the meaning of the distance threshold. Since DOT_PRODUCT distances increase when the vectors are more similar, the comparison is inverted. * For EUCLIDEAN, COSINE: WHERE distance \u003c= distance_threshold * For DOT_PRODUCT: WHERE distance \u003e= distance_threshold", "format": "double", "type": "number" }, @@ -4264,7 +4264,7 @@ "type": "object" }, "StructuredQuery": { - "description": "A Firestore query. The query stages are executed in the following order: 1. from 2. where 3. select 4. order_by + start_at + end_at 5. offset 6. limit", + "description": "A Firestore query. The query stages are executed in the following order: 1. from 2. where 3. select 4. order_by + start_at + end_at 5. offset 6. limit 7. find_nearest", "id": "StructuredQuery", "properties": { "endAt": { diff --git a/firestore/v1/firestore-gen.go b/firestore/v1/firestore-gen.go index 5dc594ed023..dab4cec9991 100644 --- a/firestore/v1/firestore-gen.go +++ b/firestore/v1/firestore-gen.go @@ -1383,8 +1383,8 @@ type FindNearest struct { // similar documents will be returned. The behavior of the specified // `distance_measure` will affect the meaning of the distance threshold. Since // DOT_PRODUCT distances increase when the vectors are more similar, the - // comparison is inverted. For EUCLIDEAN, COSINE: WHERE distance <= - // distance_threshold For DOT_PRODUCT: WHERE distance >= distance_threshold + // comparison is inverted. * For EUCLIDEAN, COSINE: WHERE distance <= + // distance_threshold * For DOT_PRODUCT: WHERE distance >= distance_threshold DistanceThreshold float64 `json:"distanceThreshold,omitempty"` // Limit: Required. The number of nearest neighbors to return. Must be a // positive integer of no more than 1000. @@ -3796,7 +3796,7 @@ func (s StructuredAggregationQuery) MarshalJSON() ([]byte, error) { // StructuredQuery: A Firestore query. The query stages are executed in the // following order: 1. from 2. where 3. select 4. order_by + start_at + end_at -// 5. offset 6. limit +// 5. offset 6. limit 7. find_nearest type StructuredQuery struct { // EndAt: A potential prefix of a position in the result set to end the query // at. This is similar to `START_AT` but with it controlling the end position diff --git a/firestore/v1beta1/firestore-api.json b/firestore/v1beta1/firestore-api.json index ba5f876cbe2..6dcd34e5d84 100644 --- a/firestore/v1beta1/firestore-api.json +++ b/firestore/v1beta1/firestore-api.json @@ -950,7 +950,7 @@ } } }, - "revision": "20240822", + "revision": "20241018", "rootUrl": "https://firestore.googleapis.com/", "schemas": { "Aggregation": { @@ -1656,7 +1656,7 @@ "type": "string" }, "distanceThreshold": { - "description": "Optional. Option to specify a threshold for which no less similar documents will be returned. The behavior of the specified `distance_measure` will affect the meaning of the distance threshold. Since DOT_PRODUCT distances increase when the vectors are more similar, the comparison is inverted. For EUCLIDEAN, COSINE: WHERE distance \u003c= distance_threshold For DOT_PRODUCT: WHERE distance \u003e= distance_threshold", + "description": "Optional. Option to specify a threshold for which no less similar documents will be returned. The behavior of the specified `distance_measure` will affect the meaning of the distance threshold. Since DOT_PRODUCT distances increase when the vectors are more similar, the comparison is inverted. * For EUCLIDEAN, COSINE: WHERE distance \u003c= distance_threshold * For DOT_PRODUCT: WHERE distance \u003e= distance_threshold", "format": "double", "type": "number" }, @@ -2654,7 +2654,7 @@ "type": "object" }, "StructuredQuery": { - "description": "A Firestore query. The query stages are executed in the following order: 1. from 2. where 3. select 4. order_by + start_at + end_at 5. offset 6. limit", + "description": "A Firestore query. The query stages are executed in the following order: 1. from 2. where 3. select 4. order_by + start_at + end_at 5. offset 6. limit 7. find_nearest", "id": "StructuredQuery", "properties": { "endAt": { diff --git a/firestore/v1beta1/firestore-gen.go b/firestore/v1beta1/firestore-gen.go index 9302eeab73e..7b5f4079afd 100644 --- a/firestore/v1beta1/firestore-gen.go +++ b/firestore/v1beta1/firestore-gen.go @@ -1311,8 +1311,8 @@ type FindNearest struct { // similar documents will be returned. The behavior of the specified // `distance_measure` will affect the meaning of the distance threshold. Since // DOT_PRODUCT distances increase when the vectors are more similar, the - // comparison is inverted. For EUCLIDEAN, COSINE: WHERE distance <= - // distance_threshold For DOT_PRODUCT: WHERE distance >= distance_threshold + // comparison is inverted. * For EUCLIDEAN, COSINE: WHERE distance <= + // distance_threshold * For DOT_PRODUCT: WHERE distance >= distance_threshold DistanceThreshold float64 `json:"distanceThreshold,omitempty"` // Limit: Required. The number of nearest neighbors to return. Must be a // positive integer of no more than 1000. @@ -2648,7 +2648,7 @@ func (s StructuredAggregationQuery) MarshalJSON() ([]byte, error) { // StructuredQuery: A Firestore query. The query stages are executed in the // following order: 1. from 2. where 3. select 4. order_by + start_at + end_at -// 5. offset 6. limit +// 5. offset 6. limit 7. find_nearest type StructuredQuery struct { // EndAt: A potential prefix of a position in the result set to end the query // at. This is similar to `START_AT` but with it controlling the end position diff --git a/gkehub/v1/gkehub-api.json b/gkehub/v1/gkehub-api.json index b9e44b0e703..489fa5e00e5 100644 --- a/gkehub/v1/gkehub-api.json +++ b/gkehub/v1/gkehub-api.json @@ -2111,7 +2111,7 @@ } } }, - "revision": "20241010", + "revision": "20241017", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AppDevExperienceFeatureSpec": { @@ -2649,7 +2649,8 @@ "description": "Git repo configuration for the cluster." }, "metricsGcpServiceAccountEmail": { - "description": "The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA.", + "deprecated": true, + "description": "The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.", "type": "string" }, "oci": { @@ -2867,6 +2868,12 @@ ], "type": "string" }, + "crCount": { + "description": "Output only. The number of RootSync and RepoSync CRs in the cluster.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, "deploymentState": { "$ref": "ConfigManagementConfigSyncDeploymentState", "description": "Information about the deployment of ConfigSync, including the version of the various Pods deployed" @@ -4859,6 +4866,21 @@ "$ref": "Authority", "description": "Optional. How to identify workloads from this Membership. See the documentation on Workload Identity for more details: https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity" }, + "clusterTier": { + "description": "Output only. The tier of the cluster.", + "enum": [ + "CLUSTER_TIER_UNSPECIFIED", + "STANDARD", + "ENTERPRISE" + ], + "enumDescriptions": [ + "The ClusterTier is not set.", + "The ClusterTier is standard.", + "The ClusterTier is enterprise." + ], + "readOnly": true, + "type": "string" + }, "createTime": { "description": "Output only. When the Membership was created.", "format": "google-datetime", diff --git a/gkehub/v1/gkehub-gen.go b/gkehub/v1/gkehub-gen.go index cbcad576516..0b95128d19b 100644 --- a/gkehub/v1/gkehub-gen.go +++ b/gkehub/v1/gkehub-gen.go @@ -1131,7 +1131,10 @@ type ConfigManagementConfigSync struct { // Monarch when Workload Identity is enabled. The GSA should have the // Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The // Kubernetes ServiceAccount `default` in the namespace - // `config-management-monitoring` should be bound to the GSA. + // `config-management-monitoring` should be bound to the GSA. Deprecated: If + // Workload Identity Federation for GKE is enabled, Google Cloud Service + // Account is no longer needed for exporting Config Sync metrics: + // https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring. MetricsGcpServiceAccountEmail string `json:"metricsGcpServiceAccountEmail,omitempty"` // Oci: OCI repo configuration for the cluster Oci *ConfigManagementOciConfig `json:"oci,omitempty"` @@ -1300,6 +1303,9 @@ type ConfigManagementConfigSyncState struct { // "STOPPED" - Syncing resources to the cluster is stopped at the cluster // level. ClusterLevelStopSyncingState string `json:"clusterLevelStopSyncingState,omitempty"` + // CrCount: Output only. The number of RootSync and RepoSync CRs in the + // cluster. + CrCount int64 `json:"crCount,omitempty"` // DeploymentState: Information about the deployment of ConfigSync, including // the version of the various Pods deployed DeploymentState *ConfigManagementConfigSyncDeploymentState `json:"deploymentState,omitempty"` @@ -3815,6 +3821,13 @@ type Membership struct { // documentation on Workload Identity for more details: // https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity Authority *Authority `json:"authority,omitempty"` + // ClusterTier: Output only. The tier of the cluster. + // + // Possible values: + // "CLUSTER_TIER_UNSPECIFIED" - The ClusterTier is not set. + // "STANDARD" - The ClusterTier is standard. + // "ENTERPRISE" - The ClusterTier is enterprise. + ClusterTier string `json:"clusterTier,omitempty"` // CreateTime: Output only. When the Membership was created. CreateTime string `json:"createTime,omitempty"` // DeleteTime: Output only. When the Membership was deleted. diff --git a/gkehub/v1alpha/gkehub-api.json b/gkehub/v1alpha/gkehub-api.json index e28b58f1871..b0977966480 100644 --- a/gkehub/v1alpha/gkehub-api.json +++ b/gkehub/v1alpha/gkehub-api.json @@ -2255,7 +2255,7 @@ } } }, - "revision": "20241010", + "revision": "20241017", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AnthosObservabilityFeatureSpec": { @@ -2994,7 +2994,8 @@ "description": "Git repo configuration for the cluster." }, "metricsGcpServiceAccountEmail": { - "description": "The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA.", + "deprecated": true, + "description": "The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.", "type": "string" }, "oci": { @@ -3212,6 +3213,12 @@ ], "type": "string" }, + "crCount": { + "description": "Output only. The number of RootSync and RepoSync CRs in the cluster.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, "deploymentState": { "$ref": "ConfigManagementConfigSyncDeploymentState", "description": "Information about the deployment of ConfigSync, including the version of the various Pods deployed" @@ -5282,6 +5289,21 @@ "$ref": "Authority", "description": "Optional. How to identify workloads from this Membership. See the documentation on Workload Identity for more details: https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity" }, + "clusterTier": { + "description": "Output only. The tier of the cluster.", + "enum": [ + "CLUSTER_TIER_UNSPECIFIED", + "STANDARD", + "ENTERPRISE" + ], + "enumDescriptions": [ + "The ClusterTier is not set.", + "The ClusterTier is standard.", + "The ClusterTier is enterprise." + ], + "readOnly": true, + "type": "string" + }, "createTime": { "description": "Output only. When the Membership was created.", "format": "google-datetime", diff --git a/gkehub/v1alpha/gkehub-gen.go b/gkehub/v1alpha/gkehub-gen.go index 9dd4698829e..86dbc74fd25 100644 --- a/gkehub/v1alpha/gkehub-gen.go +++ b/gkehub/v1alpha/gkehub-gen.go @@ -1398,7 +1398,10 @@ type ConfigManagementConfigSync struct { // Monarch when Workload Identity is enabled. The GSA should have the // Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The // Kubernetes ServiceAccount `default` in the namespace - // `config-management-monitoring` should be bound to the GSA. + // `config-management-monitoring` should be bound to the GSA. Deprecated: If + // Workload Identity Federation for GKE is enabled, Google Cloud Service + // Account is no longer needed for exporting Config Sync metrics: + // https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring. MetricsGcpServiceAccountEmail string `json:"metricsGcpServiceAccountEmail,omitempty"` // Oci: OCI repo configuration for the cluster Oci *ConfigManagementOciConfig `json:"oci,omitempty"` @@ -1567,6 +1570,9 @@ type ConfigManagementConfigSyncState struct { // "STOPPED" - Syncing resources to the cluster is stopped at the cluster // level. ClusterLevelStopSyncingState string `json:"clusterLevelStopSyncingState,omitempty"` + // CrCount: Output only. The number of RootSync and RepoSync CRs in the + // cluster. + CrCount int64 `json:"crCount,omitempty"` // DeploymentState: Information about the deployment of ConfigSync, including // the version of the various Pods deployed DeploymentState *ConfigManagementConfigSyncDeploymentState `json:"deploymentState,omitempty"` @@ -4187,6 +4193,13 @@ type Membership struct { // documentation on Workload Identity for more details: // https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity Authority *Authority `json:"authority,omitempty"` + // ClusterTier: Output only. The tier of the cluster. + // + // Possible values: + // "CLUSTER_TIER_UNSPECIFIED" - The ClusterTier is not set. + // "STANDARD" - The ClusterTier is standard. + // "ENTERPRISE" - The ClusterTier is enterprise. + ClusterTier string `json:"clusterTier,omitempty"` // CreateTime: Output only. When the Membership was created. CreateTime string `json:"createTime,omitempty"` // DeleteTime: Output only. When the Membership was deleted. diff --git a/gkehub/v1beta/gkehub-api.json b/gkehub/v1beta/gkehub-api.json index 402f7550532..e1503a88df9 100644 --- a/gkehub/v1beta/gkehub-api.json +++ b/gkehub/v1beta/gkehub-api.json @@ -2111,7 +2111,7 @@ } } }, - "revision": "20241010", + "revision": "20241017", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AnthosObservabilityFeatureSpec": { @@ -2734,7 +2734,8 @@ "description": "Git repo configuration for the cluster." }, "metricsGcpServiceAccountEmail": { - "description": "The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA.", + "deprecated": true, + "description": "The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.", "type": "string" }, "oci": { @@ -2952,6 +2953,12 @@ ], "type": "string" }, + "crCount": { + "description": "Output only. The number of RootSync and RepoSync CRs in the cluster.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, "deploymentState": { "$ref": "ConfigManagementConfigSyncDeploymentState", "description": "Information about the deployment of ConfigSync, including the version of the various Pods deployed" @@ -4953,6 +4960,21 @@ "$ref": "Authority", "description": "Optional. How to identify workloads from this Membership. See the documentation on Workload Identity for more details: https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity" }, + "clusterTier": { + "description": "Output only. The tier of the cluster.", + "enum": [ + "CLUSTER_TIER_UNSPECIFIED", + "STANDARD", + "ENTERPRISE" + ], + "enumDescriptions": [ + "The ClusterTier is not set.", + "The ClusterTier is standard.", + "The ClusterTier is enterprise." + ], + "readOnly": true, + "type": "string" + }, "createTime": { "description": "Output only. When the Membership was created.", "format": "google-datetime", diff --git a/gkehub/v1beta/gkehub-gen.go b/gkehub/v1beta/gkehub-gen.go index 85a3b3b427b..7a1a367b8ba 100644 --- a/gkehub/v1beta/gkehub-gen.go +++ b/gkehub/v1beta/gkehub-gen.go @@ -1259,7 +1259,10 @@ type ConfigManagementConfigSync struct { // Monarch when Workload Identity is enabled. The GSA should have the // Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The // Kubernetes ServiceAccount `default` in the namespace - // `config-management-monitoring` should be bound to the GSA. + // `config-management-monitoring` should be bound to the GSA. Deprecated: If + // Workload Identity Federation for GKE is enabled, Google Cloud Service + // Account is no longer needed for exporting Config Sync metrics: + // https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring. MetricsGcpServiceAccountEmail string `json:"metricsGcpServiceAccountEmail,omitempty"` // Oci: OCI repo configuration for the cluster Oci *ConfigManagementOciConfig `json:"oci,omitempty"` @@ -1428,6 +1431,9 @@ type ConfigManagementConfigSyncState struct { // "STOPPED" - Syncing resources to the cluster is stopped at the cluster // level. ClusterLevelStopSyncingState string `json:"clusterLevelStopSyncingState,omitempty"` + // CrCount: Output only. The number of RootSync and RepoSync CRs in the + // cluster. + CrCount int64 `json:"crCount,omitempty"` // DeploymentState: Information about the deployment of ConfigSync, including // the version of the various Pods deployed DeploymentState *ConfigManagementConfigSyncDeploymentState `json:"deploymentState,omitempty"` @@ -3948,6 +3954,13 @@ type Membership struct { // documentation on Workload Identity for more details: // https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity Authority *Authority `json:"authority,omitempty"` + // ClusterTier: Output only. The tier of the cluster. + // + // Possible values: + // "CLUSTER_TIER_UNSPECIFIED" - The ClusterTier is not set. + // "STANDARD" - The ClusterTier is standard. + // "ENTERPRISE" - The ClusterTier is enterprise. + ClusterTier string `json:"clusterTier,omitempty"` // CreateTime: Output only. When the Membership was created. CreateTime string `json:"createTime,omitempty"` // DeleteTime: Output only. When the Membership was deleted. diff --git a/gkehub/v2/gkehub-api.json b/gkehub/v2/gkehub-api.json index d3eb6a3f90d..bec4144018d 100644 --- a/gkehub/v2/gkehub-api.json +++ b/gkehub/v2/gkehub-api.json @@ -471,7 +471,7 @@ } } }, - "revision": "20241010", + "revision": "20241017", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AppDevExperienceState": { @@ -714,7 +714,8 @@ "description": "Git repo configuration for the cluster." }, "metricsGcpServiceAccountEmail": { - "description": "The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA.", + "deprecated": true, + "description": "The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.", "type": "string" }, "oci": { @@ -932,6 +933,12 @@ ], "type": "string" }, + "crCount": { + "description": "Output only. The number of RootSync and RepoSync CRs in the cluster.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, "deploymentState": { "$ref": "ConfigManagementConfigSyncDeploymentState", "description": "Information about the deployment of ConfigSync, including the version. of the various Pods deployed" diff --git a/gkehub/v2/gkehub-gen.go b/gkehub/v2/gkehub-gen.go index fe7d7def01b..d64fe3e7371 100644 --- a/gkehub/v2/gkehub-gen.go +++ b/gkehub/v2/gkehub-gen.go @@ -542,7 +542,10 @@ type ConfigManagementConfigSync struct { // Monarch when Workload Identity is enabled. The GSA should have the // Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The // Kubernetes ServiceAccount `default` in the namespace - // `config-management-monitoring` should be bound to the GSA. + // `config-management-monitoring` should be bound to the GSA. Deprecated: If + // Workload Identity Federation for GKE is enabled, Google Cloud Service + // Account is no longer needed for exporting Config Sync metrics: + // https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring. MetricsGcpServiceAccountEmail string `json:"metricsGcpServiceAccountEmail,omitempty"` // Oci: OCI repo configuration for the cluster. Oci *ConfigManagementOciConfig `json:"oci,omitempty"` @@ -711,6 +714,9 @@ type ConfigManagementConfigSyncState struct { // "STOPPED" - Syncing resources to the cluster is stopped at the cluster // level. ClusterLevelStopSyncingState string `json:"clusterLevelStopSyncingState,omitempty"` + // CrCount: Output only. The number of RootSync and RepoSync CRs in the + // cluster. + CrCount int64 `json:"crCount,omitempty"` // DeploymentState: Information about the deployment of ConfigSync, including // the version. of the various Pods deployed DeploymentState *ConfigManagementConfigSyncDeploymentState `json:"deploymentState,omitempty"` diff --git a/gkehub/v2alpha/gkehub-api.json b/gkehub/v2alpha/gkehub-api.json index a60b32015c4..07ea97dae42 100644 --- a/gkehub/v2alpha/gkehub-api.json +++ b/gkehub/v2alpha/gkehub-api.json @@ -471,7 +471,7 @@ } } }, - "revision": "20241010", + "revision": "20241017", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AppDevExperienceState": { @@ -714,7 +714,8 @@ "description": "Git repo configuration for the cluster." }, "metricsGcpServiceAccountEmail": { - "description": "The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA.", + "deprecated": true, + "description": "The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.", "type": "string" }, "oci": { @@ -932,6 +933,12 @@ ], "type": "string" }, + "crCount": { + "description": "Output only. The number of RootSync and RepoSync CRs in the cluster.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, "deploymentState": { "$ref": "ConfigManagementConfigSyncDeploymentState", "description": "Information about the deployment of ConfigSync, including the version. of the various Pods deployed" diff --git a/gkehub/v2alpha/gkehub-gen.go b/gkehub/v2alpha/gkehub-gen.go index 0a05aa6b11d..269f18b915f 100644 --- a/gkehub/v2alpha/gkehub-gen.go +++ b/gkehub/v2alpha/gkehub-gen.go @@ -542,7 +542,10 @@ type ConfigManagementConfigSync struct { // Monarch when Workload Identity is enabled. The GSA should have the // Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The // Kubernetes ServiceAccount `default` in the namespace - // `config-management-monitoring` should be bound to the GSA. + // `config-management-monitoring` should be bound to the GSA. Deprecated: If + // Workload Identity Federation for GKE is enabled, Google Cloud Service + // Account is no longer needed for exporting Config Sync metrics: + // https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring. MetricsGcpServiceAccountEmail string `json:"metricsGcpServiceAccountEmail,omitempty"` // Oci: OCI repo configuration for the cluster. Oci *ConfigManagementOciConfig `json:"oci,omitempty"` @@ -711,6 +714,9 @@ type ConfigManagementConfigSyncState struct { // "STOPPED" - Syncing resources to the cluster is stopped at the cluster // level. ClusterLevelStopSyncingState string `json:"clusterLevelStopSyncingState,omitempty"` + // CrCount: Output only. The number of RootSync and RepoSync CRs in the + // cluster. + CrCount int64 `json:"crCount,omitempty"` // DeploymentState: Information about the deployment of ConfigSync, including // the version. of the various Pods deployed DeploymentState *ConfigManagementConfigSyncDeploymentState `json:"deploymentState,omitempty"` diff --git a/gkehub/v2beta/gkehub-api.json b/gkehub/v2beta/gkehub-api.json index e608bb4dc43..11e48fa4159 100644 --- a/gkehub/v2beta/gkehub-api.json +++ b/gkehub/v2beta/gkehub-api.json @@ -471,7 +471,7 @@ } } }, - "revision": "20241010", + "revision": "20241017", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AppDevExperienceState": { @@ -714,7 +714,8 @@ "description": "Git repo configuration for the cluster." }, "metricsGcpServiceAccountEmail": { - "description": "The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA.", + "deprecated": true, + "description": "The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.", "type": "string" }, "oci": { @@ -932,6 +933,12 @@ ], "type": "string" }, + "crCount": { + "description": "Output only. The number of RootSync and RepoSync CRs in the cluster.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, "deploymentState": { "$ref": "ConfigManagementConfigSyncDeploymentState", "description": "Information about the deployment of ConfigSync, including the version. of the various Pods deployed" diff --git a/gkehub/v2beta/gkehub-gen.go b/gkehub/v2beta/gkehub-gen.go index 05c2477a9fa..aceea46b66d 100644 --- a/gkehub/v2beta/gkehub-gen.go +++ b/gkehub/v2beta/gkehub-gen.go @@ -542,7 +542,10 @@ type ConfigManagementConfigSync struct { // Monarch when Workload Identity is enabled. The GSA should have the // Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The // Kubernetes ServiceAccount `default` in the namespace - // `config-management-monitoring` should be bound to the GSA. + // `config-management-monitoring` should be bound to the GSA. Deprecated: If + // Workload Identity Federation for GKE is enabled, Google Cloud Service + // Account is no longer needed for exporting Config Sync metrics: + // https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring. MetricsGcpServiceAccountEmail string `json:"metricsGcpServiceAccountEmail,omitempty"` // Oci: OCI repo configuration for the cluster. Oci *ConfigManagementOciConfig `json:"oci,omitempty"` @@ -711,6 +714,9 @@ type ConfigManagementConfigSyncState struct { // "STOPPED" - Syncing resources to the cluster is stopped at the cluster // level. ClusterLevelStopSyncingState string `json:"clusterLevelStopSyncingState,omitempty"` + // CrCount: Output only. The number of RootSync and RepoSync CRs in the + // cluster. + CrCount int64 `json:"crCount,omitempty"` // DeploymentState: Information about the deployment of ConfigSync, including // the version. of the various Pods deployed DeploymentState *ConfigManagementConfigSyncDeploymentState `json:"deploymentState,omitempty"` diff --git a/go.mod b/go.mod index b98b124ea7e..dbb9d6f98b1 100644 --- a/go.mod +++ b/go.mod @@ -4,8 +4,8 @@ go 1.21 require ( cloud.google.com/go v0.116.0 - cloud.google.com/go/auth v0.9.9 - cloud.google.com/go/auth/oauth2adapt v0.2.4 + cloud.google.com/go/auth v0.10.0 + cloud.google.com/go/auth/oauth2adapt v0.2.5 cloud.google.com/go/compute/metadata v0.5.2 github.com/google/go-cmp v0.6.0 github.com/google/s2a-go v0.1.8 @@ -19,9 +19,9 @@ require ( golang.org/x/oauth2 v0.23.0 golang.org/x/sync v0.8.0 golang.org/x/time v0.7.0 - google.golang.org/genproto v0.0.0-20241015192408-796eee8c2d53 - google.golang.org/genproto/googleapis/bytestream v0.0.0-20241015192408-796eee8c2d53 - google.golang.org/genproto/googleapis/rpc v0.0.0-20241015192408-796eee8c2d53 + google.golang.org/genproto v0.0.0-20241021214115-324edc3d5d38 + google.golang.org/genproto/googleapis/bytestream v0.0.0-20241021214115-324edc3d5d38 + google.golang.org/genproto/googleapis/rpc v0.0.0-20241021214115-324edc3d5d38 google.golang.org/grpc v1.67.1 google.golang.org/protobuf v1.35.1 ) diff --git a/go.sum b/go.sum index 7580012a22e..78e15516833 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.116.0 h1:B3fRrSDkLRt5qSHWe40ERJvhvnQwdZiHu0bJOpldweE= cloud.google.com/go v0.116.0/go.mod h1:cEPSRWPzZEswwdr9BxE6ChEn01dWlTaF05LiC2Xs70U= -cloud.google.com/go/auth v0.9.9 h1:BmtbpNQozo8ZwW2t7QJjnrQtdganSdmqeIBxHxNkEZQ= -cloud.google.com/go/auth v0.9.9/go.mod h1:xxA5AqpDrvS+Gkmo9RqrGGRh6WSNKKOXhY3zNOr38tI= -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/auth v0.10.0 h1:tWlkvFAh+wwTOzXIjrwM64karR1iTBZ/GRr0S/DULYo= +cloud.google.com/go/auth v0.10.0/go.mod h1:xxA5AqpDrvS+Gkmo9RqrGGRh6WSNKKOXhY3zNOr38tI= +cloud.google.com/go/auth/oauth2adapt v0.2.5 h1:2p29+dePqsCHPP1bqDJcKj4qxRyYCcbzKpFyKGt3MTk= +cloud.google.com/go/auth/oauth2adapt v0.2.5/go.mod h1:AlmsELtlEBnaNTL7jCj8VQFLy6mbZv0s4Q7NGBeQ5E8= cloud.google.com/go/compute/metadata v0.5.2 h1:UxK4uu/Tn+I3p2dYWTfiX4wva7aYlKixAHn3fyqngqo= cloud.google.com/go/compute/metadata v0.5.2/go.mod h1:C66sj2AluDcIqakBq/M8lw8/ybHgOZqin2obFxa/E5k= github.com/BurntSushi/toml v0.3.1/go.mod h1:xHWCNGjB5oqiDr8zfno3MHue2Ht5sIBksp03qcyfWMU= @@ -128,14 +128,14 @@ 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-20241015192408-796eee8c2d53 h1:Df6WuGvthPzc+JiQ/G+m+sNX24kc0aTBqoDN/0yyykE= -google.golang.org/genproto v0.0.0-20241015192408-796eee8c2d53/go.mod h1:fheguH3Am2dGp1LfXkrvwqC/KlFq8F0nLq3LryOMrrE= -google.golang.org/genproto/googleapis/api v0.0.0-20241007155032-5fefd90f89a9 h1:T6rh4haD3GVYsgEfWExoCZA2o2FmbNyKpTuAxbEFPTg= -google.golang.org/genproto/googleapis/api v0.0.0-20241007155032-5fefd90f89a9/go.mod h1:wp2WsuBYj6j8wUdo3ToZsdxxixbvQNAHqVJrTgi5E5M= -google.golang.org/genproto/googleapis/bytestream v0.0.0-20241015192408-796eee8c2d53 h1:mVZqGNBNN8C63iGnWgHZSGbT/vG7voylnp4atysmReg= -google.golang.org/genproto/googleapis/bytestream v0.0.0-20241015192408-796eee8c2d53/go.mod h1:T8O3fECQbif8cez15vxAcjbwXxvL2xbnvbQ7ZfiMAMs= -google.golang.org/genproto/googleapis/rpc v0.0.0-20241015192408-796eee8c2d53 h1:X58yt85/IXCx0Y3ZwN6sEIKZzQtDEYaBWrDvErdXrRE= -google.golang.org/genproto/googleapis/rpc v0.0.0-20241015192408-796eee8c2d53/go.mod h1:GX3210XPVPUjJbTUbvwI8f2IpZDMZuPJWDzDuebbviI= +google.golang.org/genproto v0.0.0-20241021214115-324edc3d5d38 h1:Q3nlH8iSQSRUwOskjbcSMcF2jiYMNiQYZ0c2KEJLKKU= +google.golang.org/genproto v0.0.0-20241021214115-324edc3d5d38/go.mod h1:xBI+tzfqGGN2JBeSebfKXFSdBpWVQ7sLW40PTupVRm4= +google.golang.org/genproto/googleapis/api v0.0.0-20241015192408-796eee8c2d53 h1:fVoAXEKA4+yufmbdVYv+SE73+cPZbbbe8paLsHfkK+U= +google.golang.org/genproto/googleapis/api v0.0.0-20241015192408-796eee8c2d53/go.mod h1:riSXTwQ4+nqmPGtobMFyW5FqVAmIs0St6VPp4Ug7CE4= +google.golang.org/genproto/googleapis/bytestream v0.0.0-20241021214115-324edc3d5d38 h1:42FIsHvG4GOaVHLDMcy/YMqC4clCbgAPojbcA2hXp5w= +google.golang.org/genproto/googleapis/bytestream v0.0.0-20241021214115-324edc3d5d38/go.mod h1:T8O3fECQbif8cez15vxAcjbwXxvL2xbnvbQ7ZfiMAMs= +google.golang.org/genproto/googleapis/rpc v0.0.0-20241021214115-324edc3d5d38 h1:zciRKQ4kBpFgpfC5QQCVtnnNAcLIqweL7plyZRQHVpI= +google.golang.org/genproto/googleapis/rpc v0.0.0-20241021214115-324edc3d5d38/go.mod h1:GX3210XPVPUjJbTUbvwI8f2IpZDMZuPJWDzDuebbviI= 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= diff --git a/go.work.sum b/go.work.sum index 7ede8d90abd..67896ec71cc 100644 --- a/go.work.sum +++ b/go.work.sum @@ -7,76 +7,100 @@ cloud.google.com/go v0.112.0/go.mod h1:3jEEVwZ/MHU4djK5t5RHuKOA/GbLddgTdVubX1qnP 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/accessapproval v1.8.0/go.mod h1:ycc7qSIXOrH6gGOGQsuBwpRZw3QhZLi0OWeej3rA5Mg= +cloud.google.com/go/accessapproval v1.8.1/go.mod h1:3HAtm2ertsWdwgjSGObyas6fj3ZC/3zwV2WVZXO53sU= 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/accesscontextmanager v1.9.0/go.mod h1:EmdQRGq5FHLrjGjGTp2X2tlRBvU3LDCUqfnysFYooxQ= +cloud.google.com/go/accesscontextmanager v1.9.1/go.mod h1:wUVSoz8HmG7m9miQTh6smbyYuNOJrvZukK5g6WxSOp0= 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/analytics v0.25.0/go.mod h1:LZMfjJnKU1GDkvJV16dKnXm7KJJaMZfvUXx58ujgVLg= +cloud.google.com/go/analytics v0.25.1/go.mod h1:hrAWcN/7tqyYwF/f60Nph1yz5UE3/PxOPzzFsJgtU+Y= 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/apigateway v1.7.0/go.mod h1:miZGNhmrC+SFhxjA7ayjKHk1cA+7vsSINp9K+JxKwZI= +cloud.google.com/go/apigateway v1.7.1/go.mod h1:5JBcLrl7GHSGRzuDaISd5u0RKV05DNFiq4dRdfrhCP0= 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/apigeeconnect v1.7.0/go.mod h1:fd8NFqzu5aXGEUpxiyeCyb4LBLU7B/xIPztfBQi+1zg= +cloud.google.com/go/apigeeconnect v1.7.1/go.mod h1:olkn1lOhIA/aorreenFzfEcEXmFN2pyAwkaUFbug9ZY= 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/apigeeregistry v0.9.0/go.mod h1:4S/btGnijdt9LSIZwBDHgtYfYkFGekzNyWkyYTP8Qzs= +cloud.google.com/go/apigeeregistry v0.9.1/go.mod h1:XCwK9CS65ehi26z7E8/Vl4PEX5c/JJxpfxlB1QEyrZw= 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/appengine v1.9.0/go.mod h1:y5oI+JT3/6s77QmxbTnLHyiMKz3NPHYOjuhmVi+FyYU= +cloud.google.com/go/appengine v1.9.1/go.mod h1:jtguveqRWFfjrk3k/7SlJz1FpDBZhu5CWSRu+HBgClk= 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/area120 v0.9.0/go.mod h1:ujIhRz2gJXutmFYGAUgz3KZ5IRJ6vOwL4CYlNy/jDo4= +cloud.google.com/go/area120 v0.9.1/go.mod h1:foV1BSrnjVL/KydBnAlUQFSy85kWrMwGSmRfIraC+JU= 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/artifactregistry v1.15.0/go.mod h1:4xrfigx32/3N7Pp7YSPOZZGs4VPhyYeRyJ67ZfVdOX4= +cloud.google.com/go/artifactregistry v1.15.1/go.mod h1:ExJb4VN+IMTQWO5iY+mjcY19Rz9jUxCVGZ1YuyAgPBw= 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/asset v1.20.0/go.mod h1:CT3ME6xNZKsPSvi0lMBPgW3azvRhiurJTFSnNl6ahw8= +cloud.google.com/go/asset v1.20.2/go.mod h1:IM1Kpzzo3wq7R/GEiktitzZyXx2zVpWqs9/5EGYs0GY= 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/assuredworkloads v1.12.0/go.mod h1:jX84R+0iANggmSbzvVgrGWaqdhRsQihAv4fF7IQ4r7Q= +cloud.google.com/go/assuredworkloads v1.12.1/go.mod h1:nBnkK2GZNSdtjU3ER75oC5fikub5/+QchbolKgnMI/I= 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/automl v1.14.0/go.mod h1:Kr7rN9ANSjlHyBLGvwhrnt35/vVZy3n/CP4Xmyj0shM= +cloud.google.com/go/automl v1.14.1/go.mod h1:BocG5mhT32cjmf5CXxVsdSM04VXzJW7chVT7CpSL2kk= 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/baremetalsolution v1.3.0/go.mod h1:E+n44UaDVO5EeSa4SUsDFxQLt6dD1CoE2h+mtxxaJKo= +cloud.google.com/go/baremetalsolution v1.3.1/go.mod h1:D1djGGmBl4M6VlyjOMc1SEzDYlO4EeEG1TCUv5mCPi0= 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/batch v1.10.0/go.mod h1:JlktZqyKbcUJWdHOV8juvAiQNH8xXHXTqLp6bD9qreE= +cloud.google.com/go/batch v1.11.1/go.mod h1:4GbJXfdxU8GH6uuo8G47y5tEFOgTLCL9pMKCUcn7VxE= 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/beyondcorp v1.1.0/go.mod h1:F6Rl20QbayaloWIsMhuz+DICcJxckdFKc7R2HCe6iNA= +cloud.google.com/go/beyondcorp v1.1.1/go.mod h1:L09o0gLkgXMxCZs4qojrgpI2/dhWtasMc71zPPiHMn4= 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/bigquery v1.63.1/go.mod h1:ufaITfroCk17WTqBhMpi8CRjsfHjMX07pDrQaRKKX2o= cloud.google.com/go/bigtable v1.27.2-0.20240730134218-123c88616251/go.mod h1:avmXcmxVbLJAo9moICRYMgDyTTPoV0MA0lHKnyqV4fQ= cloud.google.com/go/bigtable v1.29.0/go.mod h1:5p909nNdWaNUcWs6KGZO8mI5HUovstlmrIi7+eA5PTQ= cloud.google.com/go/bigtable v1.31.0/go.mod h1:N/mwZO+4TSHOeyiE1JxO+sRPnW4bnR7WLn9AEaiJqew= +cloud.google.com/go/bigtable v1.33.0/go.mod h1:HtpnH4g25VT1pejHRtInlFPnN5sjTxbQlsYBjh9t5l0= 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/billing v1.19.0/go.mod h1:bGvChbZguyaWRGmu5pQHfFN1VxTDPFmabnCVA/dNdRM= +cloud.google.com/go/billing v1.19.1/go.mod h1:c5l7ORJjOLH/aASJqUqNsEmwrhfjWZYHX+z0fIhuVpo= 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/binaryauthorization v1.9.0/go.mod h1:fssQuxfI9D6dPPqfvDmObof+ZBKsxA9iSigd8aSA1ik= +cloud.google.com/go/binaryauthorization v1.9.1/go.mod h1:jqBzP68bfzjoiMFT6Q1EdZtKJG39zW9ywwzHuv7V8ms= 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/certificatemanager v1.9.0/go.mod h1:hQBpwtKNjUq+er6Rdg675N7lSsNGqMgt7Bt7Dbcm7d0= +cloud.google.com/go/certificatemanager v1.9.1/go.mod h1:a6bXZULtd6iQTRuSVs1fopcHLMJ/T3zSpIB7aJaq/js= 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/channel v1.18.0/go.mod h1:gQr50HxC/FGvufmqXD631ldL1Ee7CNMU5F4pDyJWlt0= +cloud.google.com/go/channel v1.19.0/go.mod h1:8BEvuN5hWL4tT0rmJR4N8xsZHdfGof+KwemjQH6oXsw= 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/cloudbuild v1.17.0/go.mod h1:/RbwgDlbQEwIKoWLIYnW72W3cWs+e83z7nU45xRKnj8= +cloud.google.com/go/cloudbuild v1.18.0/go.mod h1:KCHWGIoS/5fj+By9YmgIQnUiDq8P6YURWOjX3hoc6As= 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/clouddms v1.8.0/go.mod h1:JUgTgqd1M9iPa7p3jodjLTuecdkGTcikrg7nz++XB5E= +cloud.google.com/go/clouddms v1.8.1/go.mod h1:bmW2eDFH1LjuwkHcKKeeppcmuBGS0r6Qz6TXanehKP0= 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/cloudtasks v1.13.0/go.mod h1:O1jFRGb1Vm3sN2u/tBdPiVGVTWIsrsbEs3K3N3nNlEU= +cloud.google.com/go/cloudtasks v1.13.1/go.mod h1:dyRD7tEEkLMbHLagb7UugkDa77UVJp9d/6O9lm3ModI= 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= @@ -92,235 +116,308 @@ cloud.google.com/go/compute v1.27.5 h1:iii9Z+FhEeZ5cUkGOEqU+GM7MJSyxMgbE7H7j+Jnd cloud.google.com/go/compute v1.28.0 h1:OPtBxMcheSS+DWfci803qvPly3d4w7Eu5ztKBcFfzwk= cloud.google.com/go/compute v1.28.0/go.mod h1:DEqZBtYrDnD5PvjsKwb3onnhX+qjdCVM7eshj1XdjV4= cloud.google.com/go/compute v1.28.1 h1:XwPcZjgMCnU2tkwY10VleUjSAfpTj9RDn+kGrbYsi8o= +cloud.google.com/go/compute v1.28.1/go.mod h1:b72iXMY4FucVry3NR3Li4kVyyTvbMDE7x5WsqvxjsYk= 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/contactcenterinsights v1.14.0/go.mod h1:APmWYHDN4sASnUBnXs4o68t1EUfnqadA53//CzXZ1xE= +cloud.google.com/go/contactcenterinsights v1.15.0/go.mod h1:6bJGBQrJsnATv2s6Dh/c6HCRanq2kCZ0kIIjRV1G0mI= 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/container v1.39.0/go.mod h1:gNgnvs1cRHXjYxrotVm+0nxDfZkqzBbXCffh5WtqieI= +cloud.google.com/go/container v1.40.0/go.mod h1:wNI1mOUivm+ZkpHMbouutgbD4sQxyphMwK31X5cThY4= 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/containeranalysis v0.13.0/go.mod h1:OpufGxsNzMOZb6w5yqwUgHr5GHivsAD18KEI06yGkQs= +cloud.google.com/go/containeranalysis v0.13.1/go.mod h1:bmd9H880BNR4Hc8JspEg8ge9WccSQfO+/N+CYvU3sEA= 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/datacatalog v1.22.0/go.mod h1:4Wff6GphTY6guF5WphrD76jOdfBiflDiRGFAxq7t//I= +cloud.google.com/go/datacatalog v1.22.1/go.mod h1:MscnJl9B2lpYlFoxRjicw19kFTwEke8ReKL5Y/6TWg8= 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/dataflow v0.10.0/go.mod h1:zAv3YUNe/2pXWKDSPvbf31mCIUuJa+IHtKmhfzaeGww= +cloud.google.com/go/dataflow v0.10.1/go.mod h1:zP4/tNjONFRcS4NcI9R94YDQEkPalimdbPkijVNJt/g= 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/dataform v0.10.0/go.mod h1:0NKefI6v1ppBEDnwrp6gOMEA3s/RH3ypLUM0+YWqh6A= +cloud.google.com/go/dataform v0.10.1/go.mod h1:c5y0hIOBCfszmBcLJyxnELF30gC1qC/NeHdmkzA7TNQ= 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/datafusion v1.8.0/go.mod h1:zHZ5dJYHhMP1P8SZDZm+6yRY9BCCcfm7Xg7YmP+iA6E= +cloud.google.com/go/datafusion v1.8.1/go.mod h1:I5+nRt6Lob4g1eCbcxP4ayRNx8hyOZ8kA3PB/vGd9Lo= 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/datalabeling v0.9.0/go.mod h1:GVX4sW4cY5OPKu/9v6dv20AU9xmGr4DXR6K26qN0mzw= +cloud.google.com/go/datalabeling v0.9.1/go.mod h1:umplHuZX+x5DItNPV5BFBXau5TDsljLNzEj5AB5uRUM= 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/dataplex v1.19.0/go.mod h1:5H9ftGuZWMtoEIUpTdGUtGgje36YGmtRXoC8wx6QSUc= +cloud.google.com/go/dataplex v1.19.1/go.mod h1:WzoQ+vcxrAyM0cjJWmluEDVsg7W88IXXCfuy01BslKE= 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/dataproc/v2 v2.6.0/go.mod h1:amsKInI+TU4GcXnz+gmmApYbiYM4Fw051SIMDoWCWeE= +cloud.google.com/go/dataproc/v2 v2.9.0/go.mod h1:i4365hSwNP6Bx0SAUnzCC6VloeNxChDjJWH6BfVPcbs= 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/dataqna v0.9.0/go.mod h1:WlRhvLLZv7TfpONlb/rEQx5Qrr7b5sxgSuz5NP6amrw= +cloud.google.com/go/dataqna v0.9.1/go.mod h1:86DNLE33yEfNDp5F2nrITsmTYubMbsF7zQRzC3CcZrY= 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/datastore v1.19.0/go.mod h1:KGzkszuj87VT8tJe67GuB+qLolfsOt6bZq/KFuWaahc= 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/datastream v1.11.0/go.mod h1:vio/5TQ0qNtGcIj7sFb0gucFoqZW19gZ7HztYtkzq9g= +cloud.google.com/go/datastream v1.11.1/go.mod h1:a4j5tnptIxdZ132XboR6uQM/ZHcuv/hLqA6hH3NJWgk= 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/deploy v1.22.0/go.mod h1:qXJgBcnyetoOe+w/79sCC99c5PpHJsgUXCNhwMjG0e4= +cloud.google.com/go/deploy v1.23.0/go.mod h1:O7qoXcg44Ebfv9YIoFEgYjPmrlPsXD4boYSVEiTqdHY= 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/dialogflow v1.57.0/go.mod h1:wegtnocuYEfue6IGlX96n5mHu3JGZUaZxv1L5HzJUJY= +cloud.google.com/go/dialogflow v1.58.0/go.mod h1:sWcyFLdUrg+TWBJVq/OtwDyjcyDOfirTF0Gx12uKy7o= 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/dlp v1.18.0/go.mod h1:RVO9zkh+xXgUa7+YOf9IFNHL/2FXt9Vnv/GKNYmc1fE= +cloud.google.com/go/dlp v1.19.0/go.mod h1:cr8dKBq8un5LALiyGkz4ozcwzt3FyTlOwA4/fFzJ64c= 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/documentai v1.33.0/go.mod h1:lI9Mti9COZ5qVjdpfDZxNjOrTVf6tJ//vaqbtt81214= +cloud.google.com/go/documentai v1.34.0/go.mod h1:onJlbHi4ZjQTsANSZJvW7fi2M8LZJrrupXkWDcy4gLY= 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/domains v0.10.0/go.mod h1:VpPXnkCNRsxkieDFDfjBIrLv3p1kRjJ03wLoPeL30To= +cloud.google.com/go/domains v0.10.1/go.mod h1:RjDl3K8iq/ZZHMVqfZzRuBUr5t85gqA6LEXQBeBL5F4= 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/edgecontainer v1.3.0/go.mod h1:dV1qTl2KAnQOYG+7plYr53KSq/37aga5/xPgOlYXh3A= +cloud.google.com/go/edgecontainer v1.3.1/go.mod h1:qyz5+Nk/UAs6kXp6wiux9I2U4A2R624K15QhHYovKKM= 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/essentialcontacts v1.7.0/go.mod h1:0JEcNuyjyg43H/RJynZzv2eo6MkmnvRPUouBpOh6akY= +cloud.google.com/go/essentialcontacts v1.7.1/go.mod h1:F/MMWNLRW7b42WwWklOsnx4zrMOWDYWqWykBf1jXKPY= 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/eventarc v1.14.0/go.mod h1:60ZzZfOekvsc/keHc7uGHcoEOMVa+p+ZgRmTjpdamnA= +cloud.google.com/go/eventarc v1.14.1/go.mod h1:NG0YicE+z9MDcmh2u4tlzLDVLRjq5UHZlibyQlPhcxY= 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/filestore v1.9.0/go.mod h1:GlQK+VBaAGb19HqprnOMqYYpn7Gev5ZA9SSHpxFKD7Q= +cloud.google.com/go/filestore v1.9.1/go.mod h1:g/FNHBABpxjL1M9nNo0nW6vLYIMVlyOKhBKtYGgcKUI= 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/firestore v1.17.0/go.mod h1:69uPx1papBsY8ZETooc71fOhoKkD70Q1DwMrtKuOT/Y= 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/functions v1.19.0/go.mod h1:WDreEDZoUVoOkXKDejFWGnprrGYn2cY2KHx73UQERC0= +cloud.google.com/go/functions v1.19.1/go.mod h1:18RszySpwRg6aH5UTTVsRfdCwDooSf/5mvSnU7NAk4A= 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/gkebackup v1.6.0/go.mod h1:1rskt7NgawoMDHTdLASX8caXXYG3MvDsoZ7qF4RMamQ= +cloud.google.com/go/gkebackup v1.6.1/go.mod h1:CEnHQCsNBn+cyxcxci0qbAPYe8CkivNEitG/VAZ08ms= 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/gkeconnect v0.10.0/go.mod h1:d8TE+YAlX7mvq8pWy1Q4yOnmxbN0SimmcQdtJwBdUHk= cloud.google.com/go/gkeconnect v0.11.0/go.mod h1:l3iPZl1OfT+DUQ+QkmH1PC5RTLqxKQSVnboLiQGAcCA= +cloud.google.com/go/gkeconnect v0.11.1/go.mod h1:Vu3UoOI2c0amGyv4dT/EmltzscPH41pzS4AXPqQLej0= 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/gkehub v0.15.0/go.mod h1:obpeROly2mjxZJbRkFfHEflcH54XhJI+g2QgfHphL0I= +cloud.google.com/go/gkehub v0.15.1/go.mod h1:cyUwa9iFQYd/pI7IQYl6A+OF6M8uIbhmJr090v9Z4UU= 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/gkemulticloud v1.3.0/go.mod h1:XmcOUQ+hJI62fi/klCjEGs6lhQ56Zjs14sGPXsGP0mE= +cloud.google.com/go/gkemulticloud v1.4.0/go.mod h1:rg8YOQdRKEtMimsiNCzZUP74bOwImhLRv9wQ0FwBUP4= 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/gsuiteaddons v1.7.0/go.mod h1:/B1L8ANPbiSvxCgdSwqH9CqHIJBzTt6v50fPr3vJCtg= +cloud.google.com/go/gsuiteaddons v1.7.1/go.mod h1:SxM63xEPFf0p/plgh4dP82mBSKtp2RWskz5DpVo9jh8= 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/iam v1.2.0/go.mod h1:zITGuWgsLZxd8OwAlX+eMFgZDXzBm7icj1PVTYG766Q= +cloud.google.com/go/iam v1.2.1/go.mod h1:3VUIJDPpwT6p/amXRC5GY8fCCh70lxPygguVtI0Z4/g= 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/iap v1.10.0/go.mod h1:gDT6LZnKnWNCaov/iQbj7NMUpknFDOkhhlH8PwIrpzU= +cloud.google.com/go/iap v1.10.1/go.mod h1:UKetCEzOZ4Zj7l9TSN/wzRNwbgIYzm4VM4bStaQ/tFc= 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/ids v1.5.0/go.mod h1:4NOlC1m9hAJL50j2cRV4PS/J6x/f4BBM0Xg54JQLCWw= +cloud.google.com/go/ids v1.5.1/go.mod h1:d/9jTtY506mTxw/nHH3UN4TFo80jhAX+tESwzj42yFo= 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/iot v1.8.0/go.mod h1:/NMFENPnQ2t1UByUC1qFvA80fo1KFB920BlyUPn1m3s= +cloud.google.com/go/iot v1.8.1/go.mod h1:FNceQ9/EGvbE2az7RGoGPY0aqrsyJO3/LqAL0h83fZw= 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/kms v1.19.0/go.mod h1:e4imokuPJUc17Trz2s6lEXFDt8bgDmvpVynH39bdrHM= +cloud.google.com/go/kms v1.20.0/go.mod h1:/dMbFF1tLLFnQV44AoI2GlotbjowyUfgVwezxW291fM= 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/language v1.14.0/go.mod h1:ldEdlZOFwZREnn/1yWtXdNzfD7hHi9rf87YDkOY9at4= +cloud.google.com/go/language v1.14.1/go.mod h1:WaAL5ZdLLBjiorXl/8vqgb6/Fyt2qijl96c1ZP/vdc8= 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/lifesciences v0.10.0/go.mod h1:1zMhgXQ7LbMbA5n4AYguFgbulbounfUoYvkV8dtsLcA= +cloud.google.com/go/lifesciences v0.10.1/go.mod h1:5D6va5/Gq3gtJPKSsE6vXayAigfOXK2eWLTdFUOTCDs= 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/logging v1.12.0/go.mod h1:wwYBt5HlYP1InnrtYI0wtwttpVU1rifnMT7RejksUAM= 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/longrunning v0.6.0/go.mod h1:uHzSZqW89h7/pasCWNYdUpwGz3PcVWhrWupreVPYLts= +cloud.google.com/go/longrunning v0.6.1/go.mod h1:nHISoOZpBcmlwbJmiVk5oDRz0qG/ZxPynEGs1iZ79s0= 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/managedidentities v1.7.0/go.mod h1:o4LqQkQvJ9Pt7Q8CyZV39HrzCfzyX8zBzm8KIhRw91E= +cloud.google.com/go/managedidentities v1.7.1/go.mod h1:iK4qqIBOOfePt5cJR/Uo3+uol6oAVIbbG7MGy917cYM= 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/maps v1.12.0/go.mod h1:qjErDNStn3BaGx06vHner5d75MRMgGflbgCuWTuslMc= +cloud.google.com/go/maps v1.14.0/go.mod h1:UepOes9un0UP7i8JBiaqgh8jqUaZAHVRXCYjrVlhSC8= 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/mediatranslation v0.9.0/go.mod h1:udnxo0i4YJ5mZfkwvvQQrQ6ra47vcX8jeGV+6I5x+iU= +cloud.google.com/go/mediatranslation v0.9.1/go.mod h1:vQH1amULNhSGryBjbjLb37g54rxrOwVxywS8WvUCsIU= 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/memcache v1.11.0/go.mod h1:99MVF02m5TByT1NKxsoKDnw5kYmMrjbGSeikdyfCYZk= +cloud.google.com/go/memcache v1.11.1/go.mod h1:3zF+dEqmEmElHuO4NtHiShekQY5okQtssjPBv7jpmZ8= 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/metastore v1.14.0/go.mod h1:vtPt5oVF/+ocXO4rv4GUzC8Si5s8gfmo5OIt6bACDuE= +cloud.google.com/go/metastore v1.14.1/go.mod h1:WDvsAcbQLl9M4xL+eIpbKogH7aEaPWMhO9aRBcFOnJE= 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/monitoring v1.21.0/go.mod h1:tuJ+KNDdJbetSsbSGTqnaBvbauS5kr3Q/koy3Up6r+4= +cloud.google.com/go/monitoring v1.21.1/go.mod h1:Rj++LKrlht9uBi8+Eb530dIrzG/cU/lB8mt+lbeFK1c= 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/networkconnectivity v1.15.0/go.mod h1:uBQqx/YHI6gzqfV5J/7fkKwTGlXvQhHevUuzMpos9WY= +cloud.google.com/go/networkconnectivity v1.15.1/go.mod h1:tYAcT4Ahvq+BiePXL/slYipf/8FF0oNJw3MqFhBnSPI= 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/networkmanagement v1.14.0/go.mod h1:4myfd4A0uULCOCGHL1npZN0U+kr1Z2ENlbHdCCX4cE8= +cloud.google.com/go/networkmanagement v1.14.1/go.mod h1:3Ds8FZ3ZHjTVEedsBoZi9ef9haTE14iS6swTSqM39SI= 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/networksecurity v0.10.0/go.mod h1:IcpI5pyzlZyYG8cNRCJmY1AYKajsd9Uz575HoeyYoII= +cloud.google.com/go/networksecurity v0.10.1/go.mod h1:tatO1hYJ9nNChLHOFdsjex5FeqZBlPQgKdKOex7REpU= 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/notebooks v1.12.0/go.mod h1:euIZBbGY6G0J+UHzQ0XflysP0YoAUnDPZU7Fq0KXNw8= +cloud.google.com/go/notebooks v1.12.1/go.mod h1:RJCyRkLjj8UnvLEKaDl9S6//xUCa+r+d/AsxZnYBl50= 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/optimization v1.7.0/go.mod h1:6KvAB1HtlsMMblT/lsQRIlLjUhKjmMWNqV1AJUctbWs= +cloud.google.com/go/optimization v1.7.1/go.mod h1:s2AjwwQEv6uExFmgS4Bf1gidI07w7jCzvvs8exqR1yk= 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/orchestration v1.10.0/go.mod h1:pGiFgTTU6c/nXHTPpfsGT8N4Dax8awccCe6kjhVdWjI= +cloud.google.com/go/orchestration v1.11.0/go.mod h1:s3L89jinQaUHclqgWYw8JhBbzGSidVt5rVBxGrXeheI= 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/orgpolicy v1.13.0/go.mod h1:oKtT56zEFSsYORUunkN2mWVQBc9WGP7yBAPOZW1XCXc= +cloud.google.com/go/orgpolicy v1.14.0/go.mod h1:S6Pveh1JOxpSbs6+2ToJG7h3HwqC6Uf1YQ6JYG7wdM8= 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/osconfig v1.14.0/go.mod h1:GhZzWYVrnQ42r+K5pA/hJCsnWVW2lB6bmVg+GnZ6JkM= +cloud.google.com/go/osconfig v1.14.1/go.mod h1:Rk62nyQscgy8x4bICaTn0iWiip5EpwEfG2UCBa2TP/s= 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/oslogin v1.14.0/go.mod h1:VtMzdQPRP3T+w5OSFiYhaT/xOm7H1wo1HZUD2NAoVK4= +cloud.google.com/go/oslogin v1.14.1/go.mod h1:mM/isJYnohyD3EfM12Fhy8uye46gxA1WjHRCwbkmlVw= 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/phishingprotection v0.9.0/go.mod h1:CzttceTk9UskH9a8BycYmHL64zakEt3EXaM53r4i0Iw= +cloud.google.com/go/phishingprotection v0.9.1/go.mod h1:LRiflQnCpYKCMhsmhNB3hDbW+AzQIojXYr6q5+5eRQk= 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/policytroubleshooter v1.11.0/go.mod h1:yTqY8n60lPLdU5bRbImn9IazrmF1o5b0VBshVxPzblQ= +cloud.google.com/go/policytroubleshooter v1.11.1/go.mod h1:9nJIpgQ2vloJbB8y1JkPL5vxtaSdJnJYPCUvt6PpfRs= 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/privatecatalog v0.10.0/go.mod h1:/Lci3oPTxJpixjiTBoiVv3PmUZg/IdhPvKHcLEgObuc= +cloud.google.com/go/privatecatalog v0.10.1/go.mod h1:mFmn5bjE9J8MEjQuu1fOc4AxOP2MoEwDLMJk04xqQCQ= 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/pubsub v1.42.0/go.mod h1:KADJ6s4MbTwhXmse/50SebEhE4SmUwHi48z3/dHar1Y= +cloud.google.com/go/pubsub v1.44.0/go.mod h1:BD4a/kmE8OePyHoa1qAHEw1rMzXX+Pc8Se54T/8mc3I= 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/recaptchaenterprise/v2 v2.16.0/go.mod h1:iq7s8lR3dXv4mDXE3/qyPtZEXOK7wHC1r3bX2fQyU9s= cloud.google.com/go/recaptchaenterprise/v2 v2.17.0/go.mod h1:SS4QDdlmJ3NvbOMCXQxaFhVGRjvNMfoKCoCdxqXadqs= +cloud.google.com/go/recaptchaenterprise/v2 v2.17.2/go.mod h1:iigNZOnUpf++xlm8RdMZJTX/PihYVMrHidRLjHuekec= 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/recommendationengine v0.9.0/go.mod h1:59ydKXFyXO4Y8S0Bk224sKfj6YvIyzgcpG6w8kXIMm4= +cloud.google.com/go/recommendationengine v0.9.1/go.mod h1:FfWa3OnsnDab4unvTZM2VJmvoeGn1tnntF3n+vmfyzU= 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/recommender v1.13.0/go.mod h1:+XkXkeB9k6zG222ZH70U6DBkmvEL0na+pSjZRmlWcrk= +cloud.google.com/go/recommender v1.13.1/go.mod h1:l+n8rNMC6jZacckzLvVG/2LzKawlwAJYNO8Vl2pBlxc= 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/redis v1.17.0/go.mod h1:pzTdaIhriMLiXu8nn2CgiS52SYko0tO1Du4d3MPOG5I= +cloud.google.com/go/redis v1.17.1/go.mod h1:YJHeYfSoW/agIMeCvM5rszxu75mVh5DOhbu3AEZEIQM= 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/resourcemanager v1.10.0/go.mod h1:kIx3TWDCjLnUQUdjQ/e8EXsS9GJEzvcY+YMOHpADxrk= +cloud.google.com/go/resourcemanager v1.10.1/go.mod h1:A/ANV/Sv7y7fcjd4LSH7PJGTZcWRkO/69yN5UhYUmvE= 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/resourcesettings v1.8.0/go.mod h1:/hleuSOq8E6mF1sRYZrSzib8BxFHprQXrPluWTuZ6Ys= +cloud.google.com/go/resourcesettings v1.8.1/go.mod h1:6V87tIXUpvJMskim6YUa+TRDTm7v6OH8FxLOIRYosl4= 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/retail v1.18.0/go.mod h1:vaCabihbSrq88mKGKcKc4/FDHvVcPP0sQDAt0INM+v8= +cloud.google.com/go/retail v1.19.0/go.mod h1:QMhO+nkvN6Mns1lu6VXmteY0I3mhwPj9bOskn6PK5aY= 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/run v1.5.0/go.mod h1:Z4Tv/XNC/veO6rEpF0waVhR7vEu5RN1uJQ8dD1PeMtI= +cloud.google.com/go/run v1.6.0/go.mod h1:DXkPPa8bZ0jfRGLT+EKIlPbHvosBYBMdxTgo9EBbXZE= 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/scheduler v1.11.0/go.mod h1:RBSu5/rIsF5mDbQUiruvIE6FnfKpLd3HlTDu8aWk0jw= +cloud.google.com/go/scheduler v1.11.1/go.mod h1:ptS76q0oOS8hCHOH4Fb/y8YunPEN8emaDdtw0D7W1VE= 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/secretmanager v1.14.0/go.mod h1:q0hSFHzoW7eRgyYFH8trqEFavgrMeiJI4FETNN78vhM= +cloud.google.com/go/secretmanager v1.14.1/go.mod h1:L+gO+u2JA9CCyXpSR8gDH0o8EV7i/f0jdBOrUXcIV0U= 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/security v1.18.0/go.mod h1:oS/kRVUNmkwEqzCgSmK2EaGd8SbDUvliEiADjSb/8Mo= +cloud.google.com/go/security v1.18.1/go.mod h1:5P1q9rqwt0HuVeL9p61pTqQ6Lgio1c64jL2ZMWZV21Y= 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/securitycenter v1.35.0/go.mod h1:gotw8mBfCxX0CGrRK917CP/l+Z+QoDchJ9HDpSR8eDc= +cloud.google.com/go/securitycenter v1.35.1/go.mod h1:UDeknPuHWi15TaxrJCIv3aN1VDTz9nqWVUmW2vGayTo= 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/servicedirectory v1.12.0/go.mod h1:lKKBoVStJa+8S+iH7h/YRBMUkkqFjfPirkOTEyYAIUk= +cloud.google.com/go/servicedirectory v1.12.1/go.mod h1:d2H6joDMjnTQ4cUUCZn6k9NgZFbXjLVJbHETjoJR9k0= 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/shell v1.8.0/go.mod h1:EoQR8uXuEWHUAMoB4+ijXqRVYatDCdKYOLAaay1R/yw= +cloud.google.com/go/shell v1.8.1/go.mod h1:jaU7OHeldDhTwgs3+clM0KYEDYnBAPevUI6wNLf7ycE= 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/spanner v1.67.0/go.mod h1:Um+TNmxfcCHqNCKid4rmAMvoe/Iu1vdz6UfxJ9GPxRQ= +cloud.google.com/go/spanner v1.70.0/go.mod h1:X5T0XftydYp0K1adeJQDJtdWpbrOeJ7wHecM4tK6FiE= 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/speech v1.25.0/go.mod h1:2IUTYClcJhqPgee5Ko+qJqq29/bglVizgIap0c5MvYs= +cloud.google.com/go/speech v1.25.1/go.mod h1:WgQghvghkZ1htG6BhYn98mP7Tg0mti8dBFDLMVXH/vM= 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= @@ -329,48 +426,63 @@ cloud.google.com/go/storage v1.43.0/go.mod h1:ajvxEa7WmZS1PxvKRq4bq0tFT3vMd502Jw 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/storagetransfer v1.11.0/go.mod h1:arcvgzVC4HPcSikqV8D4h4PwrvGQHfKtbL4OwKPirjs= +cloud.google.com/go/storagetransfer v1.11.1/go.mod h1:xnJo9pWysRIha8MgZxhrBEwLYbEdvdmEedhNsP5NINM= 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/talent v1.7.0/go.mod h1:8zfRPWWV4GNZuUmBwQub0gWAe2KaKhsthyGtV8fV1bY= +cloud.google.com/go/talent v1.7.1/go.mod h1:X8UKtTgcP+h51MtDO/b+y3X1GxTTc7gPJ2y0aX3X1hM= 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/texttospeech v1.8.0/go.mod h1:hAgeA01K5QNfLy2sPUAVETE0L4WdEpaCMfwKH1qjCQU= +cloud.google.com/go/texttospeech v1.8.1/go.mod h1:WoTykB+4mfSDDYPuk7smrdXNRGoJJS6dXRR6l4XqD9g= 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/tpu v1.7.0/go.mod h1:/J6Co458YHMD60nM3cCjA0msvFU/miCGMfx/nYyxv/o= +cloud.google.com/go/tpu v1.7.1/go.mod h1:kgvyq1Z1yuBJSk5ihUaYxX58YMioCYg1UPuIHSxBX3M= 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/trace v1.11.0/go.mod h1:Aiemdi52635dBR7o3zuc9lLjXo3BwGaChEjCa3tJNmM= +cloud.google.com/go/trace v1.11.1/go.mod h1:IQKNQuBzH72EGaXEodKlNJrWykGZxet2zgjtS60OtjA= 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/translate v1.12.0/go.mod h1:4/C4shFIY5hSZ3b3g+xXWM5xhBLqcUqksSMrQ7tyFtc= +cloud.google.com/go/translate v1.12.1/go.mod h1:5f4RvC7/hh76qSl6LYuqOJaKbIzEpR1Sj+CMA6gSgIk= 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/video v1.23.0/go.mod h1:EGLQv3Ce/VNqcl/+Amq7jlrnpg+KMgQcr6YOOBfE9oc= +cloud.google.com/go/video v1.23.1/go.mod h1:ncFS3D2plMLhXkWkob/bH4bxQkubrpAlln5x7RWluXA= 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/videointelligence v1.12.0/go.mod h1:3rjmafNpCEqAb1CElGTA7dsg8dFDsx7RQNHS7o088D0= +cloud.google.com/go/videointelligence v1.12.1/go.mod h1:C9bQom4KOeBl7IFPj+NiOS6WKEm1P6OOkF/ahFfE1Eg= 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/vision/v2 v2.9.0/go.mod h1:sejxShqNOEucObbGNV5Gk85hPCgiVPP4sWv0GrgKuNw= +cloud.google.com/go/vision/v2 v2.9.1/go.mod h1:keORalKMowhEZB5hEWi1XSVnGALMjLlRwZbDiCPFuQY= 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/vmmigration v1.8.0/go.mod h1:+AQnGUabjpYKnkfdXJZ5nteUfzNDCmwbj/HSLGPFG5E= +cloud.google.com/go/vmmigration v1.8.1/go.mod h1:MB7vpxl6Oz2w+CecyITUTDFkhWSMQmRTgREwkBZFyZk= 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/vmwareengine v1.3.0/go.mod h1:7W/C/YFpelGyZzRUfOYkbgUfbN1CK5ME3++doIkh1Vk= +cloud.google.com/go/vmwareengine v1.3.1/go.mod h1:mSYu3wnGKJqvvhIhs7VA47/A/kLoMiJz3gfQAh7cfaI= 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/vpcaccess v1.8.0/go.mod h1:7fz79sxE9DbGm9dbbIdir3tsJhwCxiNAs8aFG8MEhR8= +cloud.google.com/go/vpcaccess v1.8.1/go.mod h1:cWlLCpLOuMH8oaNmobaymgmLesasLd9w1isrKpiGwIc= 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/webrisk v1.10.0/go.mod h1:ztRr0MCLtksoeSOQCEERZXdzwJGoH+RGYQ2qodGOy2U= +cloud.google.com/go/webrisk v1.10.1/go.mod h1:VzmUIag5P6V71nVAuzc7Hu0VkIDKjDa543K7HOulH/k= 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/websecurityscanner v1.7.0/go.mod h1:d5OGdHnbky9MAZ8SGzdWIm3/c9p0r7t+5BerY5JYdZc= +cloud.google.com/go/websecurityscanner v1.7.1/go.mod h1:vAZ6hyqECDhgF+gyVRGzfXMrURQN5NH75Y9yW/7sSHU= 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= cloud.google.com/go/workflows v1.13.0/go.mod h1:StCuY3jhBj1HYMjCPqZs7J0deQLHPhF6hDtzWJaVF+Y= +cloud.google.com/go/workflows v1.13.1/go.mod h1:xNdYtD6Sjoug+khNCAtBMK/rdh8qkjyL6aBas2XlkNc= 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= @@ -441,6 +553,7 @@ go.opentelemetry.io/otel/metric v1.22.0/go.mod h1:evJGjVpZv0mQ5QBRJoBF64yMuOf4xC 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/sdk v1.29.0/go.mod h1:pM8Dx5WKnvxLCb+8lG1PRNIDxu9g9b9g59Qr7hfAAok= 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= diff --git a/healthcare/v1/healthcare-api.json b/healthcare/v1/healthcare-api.json index cf7750a031c..a70cd0d25a0 100644 --- a/healthcare/v1/healthcare-api.json +++ b/healthcare/v1/healthcare-api.json @@ -4783,7 +4783,7 @@ } } }, - "revision": "20241009", + "revision": "20241017", "rootUrl": "https://healthcare.googleapis.com/", "schemas": { "ActivateConsentRequest": { @@ -7185,7 +7185,7 @@ "description": "Optional. Schemas used to parse messages in this store, if schematized parsing is desired." }, "segmentTerminator": { - "description": "Byte(s) to use as the segment terminator. If this is unset, '\\r' is used as segment terminator, matching the HL7 version 2 specification.", + "description": "Optional. Byte(s) to use as the segment terminator. If this is unset, '\\r' is used as segment terminator, matching the HL7 version 2 specification.", "format": "byte", "type": "string" }, diff --git a/healthcare/v1/healthcare-gen.go b/healthcare/v1/healthcare-gen.go index a46755edbfc..b907bc44fde 100644 --- a/healthcare/v1/healthcare-gen.go +++ b/healthcare/v1/healthcare-gen.go @@ -4297,9 +4297,9 @@ type ParserConfig struct { // Schema: Optional. Schemas used to parse messages in this store, if // schematized parsing is desired. Schema *SchemaPackage `json:"schema,omitempty"` - // SegmentTerminator: Byte(s) to use as the segment terminator. If this is - // unset, '\r' is used as segment terminator, matching the HL7 version 2 - // specification. + // SegmentTerminator: Optional. Byte(s) to use as the segment terminator. If + // this is unset, '\r' is used as segment terminator, matching the HL7 version + // 2 specification. SegmentTerminator string `json:"segmentTerminator,omitempty"` // Version: Immutable. Determines the version of both the default parser to be // used when `schema` is not given, as well as the schematized parser used when diff --git a/iam/v1/iam-api.json b/iam/v1/iam-api.json index 8a80e09af27..d316f1ad596 100644 --- a/iam/v1/iam-api.json +++ b/iam/v1/iam-api.json @@ -159,14 +159,14 @@ ], "parameters": { "location": { - "description": "The location of the pool to create. Format: `locations/{location}`.", + "description": "Optional. The location of the pool to create. Format: `locations/{location}`.", "location": "path", "pattern": "^locations/[^/]+$", "required": true, "type": "string" }, "workforcePoolId": { - "description": "The ID to use for the pool, which becomes the final component of the resource name. The IDs must be a globally unique string of 6 to 63 lowercase letters, digits, or hyphens. It must start with a letter, and cannot have a trailing hyphen. The prefix `gcp-` is reserved for use by Google, and may not be specified.", + "description": "Optional. The ID to use for the pool, which becomes the final component of the resource name. The IDs must be a globally unique string of 6 to 63 lowercase letters, digits, or hyphens. It must start with a letter, and cannot have a trailing hyphen. The prefix `gcp-` is reserved for use by Google, and may not be specified.", "location": "query", "type": "string" } @@ -3188,7 +3188,7 @@ } } }, - "revision": "20241017", + "revision": "20241028", "rootUrl": "https://iam.googleapis.com/", "schemas": { "AccessRestrictions": { @@ -3599,14 +3599,14 @@ }, "clientSecret": { "$ref": "GoogleIamAdminV1WorkforcePoolProviderOidcClientSecret", - "description": "The optional client secret. Required to enable Authorization Code flow for web sign-in." + "description": "Optional. The optional client secret. Required to enable Authorization Code flow for web sign-in." }, "issuerUri": { "description": "Required. The OIDC issuer URI. Must be a valid URI using the `https` scheme.", "type": "string" }, "jwksJson": { - "description": "OIDC JWKs in JSON String format. For details on the definition of a JWK, see https://tools.ietf.org/html/rfc7517. If not set, the `jwks_uri` from the discovery document(fetched from the .well-known path of the `issuer_uri`) will be used. Currently, RSA and EC asymmetric keys are supported. The JWK must use following format and include only the following fields: { \"keys\": [ { \"kty\": \"RSA/EC\", \"alg\": \"\", \"use\": \"sig\", \"kid\": \"\", \"n\": \"\", \"e\": \"\", \"x\": \"\", \"y\": \"\", \"crv\": \"\" } ] }", + "description": "Optional. OIDC JWKs in JSON String format. For details on the definition of a JWK, see https://tools.ietf.org/html/rfc7517. If not set, the `jwks_uri` from the discovery document(fetched from the .well-known path of the `issuer_uri`) will be used. Currently, RSA and EC asymmetric keys are supported. The JWK must use following format and include only the following fields: { \"keys\": [ { \"kty\": \"RSA/EC\", \"alg\": \"\", \"use\": \"sig\", \"kid\": \"\", \"n\": \"\", \"e\": \"\", \"x\": \"\", \"y\": \"\", \"crv\": \"\" } ] }", "type": "string" }, "webSsoConfig": { @@ -3632,7 +3632,7 @@ "id": "GoogleIamAdminV1WorkforcePoolProviderOidcClientSecretValue", "properties": { "plainText": { - "description": "Input only. The plain text of the client secret value. For security reasons, this field is only used for input and will never be populated in any response.", + "description": "Optional. Input only. The plain text of the client secret value. For security reasons, this field is only used for input and will never be populated in any response.", "type": "string" }, "thumbprint": { @@ -3648,7 +3648,7 @@ "id": "GoogleIamAdminV1WorkforcePoolProviderOidcWebSsoConfig", "properties": { "additionalScopes": { - "description": "Additional scopes to request for in the OIDC authentication request on top of scopes requested by default. By default, the `openid`, `profile` and `email` scopes that are supported by the identity provider are requested. Each additional scope may be at most 256 characters. A maximum of 10 additional scopes may be configured.", + "description": "Optional. Additional scopes to request for in the OIDC authentication request on top of scopes requested by default. By default, the `openid`, `profile` and `email` scopes that are supported by the identity provider are requested. Each additional scope may be at most 256 characters. A maximum of 10 additional scopes may be configured.", "items": { "type": "string" }, @@ -4998,15 +4998,15 @@ "description": "Optional. Configure access restrictions on the workforce pool users. This is an optional field. If specified web sign-in can be restricted to given set of services or programmatic sign-in can be disabled for pool users." }, "description": { - "description": "A user-specified description of the pool. Cannot exceed 256 characters.", + "description": "Optional. A user-specified description of the pool. Cannot exceed 256 characters.", "type": "string" }, "disabled": { - "description": "Disables the workforce pool. You cannot use a disabled pool to exchange tokens, or use existing tokens to access resources. If the pool is re-enabled, existing tokens grant access again.", + "description": "Optional. Disables the workforce pool. You cannot use a disabled pool to exchange tokens, or use existing tokens to access resources. If the pool is re-enabled, existing tokens grant access again.", "type": "boolean" }, "displayName": { - "description": "A user-specified display name of the pool in Google Cloud Console. Cannot exceed 32 characters.", + "description": "Optional. A user-specified display name of the pool in Google Cloud Console. Cannot exceed 32 characters.", "type": "string" }, "expireTime": { @@ -5025,7 +5025,7 @@ "type": "string" }, "sessionDuration": { - "description": "Duration that the Google Cloud access tokens, console sign-in sessions, and `gcloud` sign-in sessions from this pool are valid. Must be greater than 15 minutes (900s) and less than 12 hours (43200s). If `session_duration` is not configured, minted credentials have a default duration of one hour (3600s). For SAML providers, the lifetime of the token is the minimum of the `session_duration` and the `SessionNotOnOrAfter` claim in the SAML assertion.", + "description": "Optional. Duration that the Google Cloud access tokens, console sign-in sessions, and `gcloud` sign-in sessions from this pool are valid. Must be greater than 15 minutes (900s) and less than 12 hours (43200s). If `session_duration` is not configured, minted credentials have a default duration of one hour (3600s). For SAML providers, the lifetime of the token is the minimum of the `session_duration` and the `SessionNotOnOrAfter` claim in the SAML assertion.", "format": "google-duration", "type": "string" }, @@ -5052,7 +5052,7 @@ "id": "WorkforcePoolProvider", "properties": { "attributeCondition": { - "description": "A [Common Expression Language](https://opensource.google/projects/cel) expression, in plain text, to restrict what otherwise valid authentication credentials issued by the provider should not be accepted. The expression must output a boolean representing whether to allow the federation. The following keywords may be referenced in the expressions: * `assertion`: JSON representing the authentication credential issued by the provider. * `google`: The Google attributes mapped from the assertion in the `attribute_mappings`. `google.profile_photo`, `google.display_name` and `google.posix_username` are not supported. * `attribute`: The custom attributes mapped from the assertion in the `attribute_mappings`. The maximum length of the attribute condition expression is 4096 characters. If unspecified, all valid authentication credentials will be accepted. The following example shows how to only allow credentials with a mapped `google.groups` value of `admins`: ``` \"'admins' in google.groups\" ```", + "description": "Optional. A [Common Expression Language](https://opensource.google/projects/cel) expression, in plain text, to restrict what otherwise valid authentication credentials issued by the provider should not be accepted. The expression must output a boolean representing whether to allow the federation. The following keywords may be referenced in the expressions: * `assertion`: JSON representing the authentication credential issued by the provider. * `google`: The Google attributes mapped from the assertion in the `attribute_mappings`. `google.profile_photo`, `google.display_name` and `google.posix_username` are not supported. * `attribute`: The custom attributes mapped from the assertion in the `attribute_mappings`. The maximum length of the attribute condition expression is 4096 characters. If unspecified, all valid authentication credentials will be accepted. The following example shows how to only allow credentials with a mapped `google.groups` value of `admins`: ``` \"'admins' in google.groups\" ```", "type": "string" }, "attributeMapping": { @@ -5063,15 +5063,15 @@ "type": "object" }, "description": { - "description": "A user-specified description of the provider. Cannot exceed 256 characters.", + "description": "Optional. A user-specified description of the provider. Cannot exceed 256 characters.", "type": "string" }, "disabled": { - "description": "Disables the workforce pool provider. You cannot use a disabled provider to exchange tokens. However, existing tokens still grant access.", + "description": "Optional. Disables the workforce pool provider. You cannot use a disabled provider to exchange tokens. However, existing tokens still grant access.", "type": "boolean" }, "displayName": { - "description": "A user-specified display name for the provider. Cannot exceed 32 characters.", + "description": "Optional. A user-specified display name for the provider. Cannot exceed 32 characters.", "type": "string" }, "expireTime": { diff --git a/iam/v1/iam-gen.go b/iam/v1/iam-gen.go index afea0abe414..2936de90b42 100644 --- a/iam/v1/iam-gen.go +++ b/iam/v1/iam-gen.go @@ -1259,16 +1259,16 @@ type GoogleIamAdminV1WorkforcePoolProviderOidc struct { // ClientId: Required. The client ID. Must match the audience claim of the JWT // issued by the identity provider. ClientId string `json:"clientId,omitempty"` - // ClientSecret: The optional client secret. Required to enable Authorization - // Code flow for web sign-in. + // ClientSecret: Optional. The optional client secret. Required to enable + // Authorization Code flow for web sign-in. ClientSecret *GoogleIamAdminV1WorkforcePoolProviderOidcClientSecret `json:"clientSecret,omitempty"` // IssuerUri: Required. The OIDC issuer URI. Must be a valid URI using the // `https` scheme. IssuerUri string `json:"issuerUri,omitempty"` - // JwksJson: OIDC JWKs in JSON String format. For details on the definition of - // a JWK, see https://tools.ietf.org/html/rfc7517. If not set, the `jwks_uri` - // from the discovery document(fetched from the .well-known path of the - // `issuer_uri`) will be used. Currently, RSA and EC asymmetric keys are + // JwksJson: Optional. OIDC JWKs in JSON String format. For details on the + // definition of a JWK, see https://tools.ietf.org/html/rfc7517. If not set, + // the `jwks_uri` from the discovery document(fetched from the .well-known path + // of the `issuer_uri`) will be used. Currently, RSA and EC asymmetric keys are // supported. The JWK must use following format and include only the following // fields: { "keys": [ { "kty": "RSA/EC", "alg": "", "use": "sig", "kid": "", // "n": "", "e": "", "x": "", "y": "", "crv": "" } ] } @@ -1321,8 +1321,8 @@ func (s GoogleIamAdminV1WorkforcePoolProviderOidcClientSecret) MarshalJSON() ([] // GoogleIamAdminV1WorkforcePoolProviderOidcClientSecretValue: Representation // of the value of the client secret. type GoogleIamAdminV1WorkforcePoolProviderOidcClientSecretValue struct { - // PlainText: Input only. The plain text of the client secret value. For - // security reasons, this field is only used for input and will never be + // PlainText: Optional. Input only. The plain text of the client secret value. + // For security reasons, this field is only used for input and will never be // populated in any response. PlainText string `json:"plainText,omitempty"` // Thumbprint: Output only. A thumbprint to represent the current client secret @@ -1349,7 +1349,7 @@ func (s GoogleIamAdminV1WorkforcePoolProviderOidcClientSecretValue) MarshalJSON( // GoogleIamAdminV1WorkforcePoolProviderOidcWebSsoConfig: Configuration for web // single sign-on for the OIDC provider. type GoogleIamAdminV1WorkforcePoolProviderOidcWebSsoConfig struct { - // AdditionalScopes: Additional scopes to request for in the OIDC + // AdditionalScopes: Optional. Additional scopes to request for in the OIDC // authentication request on top of scopes requested by default. By default, // the `openid`, `profile` and `email` scopes that are supported by the // identity provider are requested. Each additional scope may be at most 256 @@ -3233,15 +3233,15 @@ type WorkforcePool struct { // restricted to given set of services or programmatic sign-in can be disabled // for pool users. AccessRestrictions *AccessRestrictions `json:"accessRestrictions,omitempty"` - // Description: A user-specified description of the pool. Cannot exceed 256 - // characters. + // Description: Optional. A user-specified description of the pool. Cannot + // exceed 256 characters. Description string `json:"description,omitempty"` - // Disabled: Disables the workforce pool. You cannot use a disabled pool to - // exchange tokens, or use existing tokens to access resources. If the pool is - // re-enabled, existing tokens grant access again. + // Disabled: Optional. Disables the workforce pool. You cannot use a disabled + // pool to exchange tokens, or use existing tokens to access resources. If the + // pool is re-enabled, existing tokens grant access again. Disabled bool `json:"disabled,omitempty"` - // DisplayName: A user-specified display name of the pool in Google Cloud - // Console. Cannot exceed 32 characters. + // DisplayName: Optional. A user-specified display name of the pool in Google + // Cloud Console. Cannot exceed 32 characters. DisplayName string `json:"displayName,omitempty"` // ExpireTime: Output only. Time after which the workforce pool will be // permanently purged and cannot be recovered. @@ -3252,13 +3252,13 @@ type WorkforcePool struct { // Parent: Immutable. The resource name of the parent. Format: // `organizations/{org-id}`. Parent string `json:"parent,omitempty"` - // SessionDuration: Duration that the Google Cloud access tokens, console - // sign-in sessions, and `gcloud` sign-in sessions from this pool are valid. - // Must be greater than 15 minutes (900s) and less than 12 hours (43200s). If - // `session_duration` is not configured, minted credentials have a default - // duration of one hour (3600s). For SAML providers, the lifetime of the token - // is the minimum of the `session_duration` and the `SessionNotOnOrAfter` claim - // in the SAML assertion. + // SessionDuration: Optional. Duration that the Google Cloud access tokens, + // console sign-in sessions, and `gcloud` sign-in sessions from this pool are + // valid. Must be greater than 15 minutes (900s) and less than 12 hours + // (43200s). If `session_duration` is not configured, minted credentials have a + // default duration of one hour (3600s). For SAML providers, the lifetime of + // the token is the minimum of the `session_duration` and the + // `SessionNotOnOrAfter` claim in the SAML assertion. SessionDuration string `json:"sessionDuration,omitempty"` // State: Output only. The state of the pool. // @@ -3295,7 +3295,7 @@ func (s WorkforcePool) MarshalJSON() ([]byte, error) { // WorkforcePoolProvider: A configuration for an external identity provider. type WorkforcePoolProvider struct { - // AttributeCondition: A Common Expression Language + // AttributeCondition: Optional. A Common Expression Language // (https://opensource.google/projects/cel) expression, in plain text, to // restrict what otherwise valid authentication credentials issued by the // provider should not be accepted. The expression must output a boolean @@ -3356,14 +3356,15 @@ type WorkforcePoolProvider struct { // `sub` claim of the incoming credential to the `subject` attribute on a // Google token: ``` {"google.subject": "assertion.sub"} ``` AttributeMapping map[string]string `json:"attributeMapping,omitempty"` - // Description: A user-specified description of the provider. Cannot exceed 256 - // characters. + // Description: Optional. A user-specified description of the provider. Cannot + // exceed 256 characters. Description string `json:"description,omitempty"` - // Disabled: Disables the workforce pool provider. You cannot use a disabled - // provider to exchange tokens. However, existing tokens still grant access. + // Disabled: Optional. Disables the workforce pool provider. You cannot use a + // disabled provider to exchange tokens. However, existing tokens still grant + // access. Disabled bool `json:"disabled,omitempty"` - // DisplayName: A user-specified display name for the provider. Cannot exceed - // 32 characters. + // DisplayName: Optional. A user-specified display name for the provider. + // Cannot exceed 32 characters. DisplayName string `json:"displayName,omitempty"` // ExpireTime: Output only. Time after which the workload pool provider will be // permanently purged and cannot be recovered. @@ -3883,7 +3884,7 @@ type LocationsWorkforcePoolsCreateCall struct { // Create: Creates a new WorkforcePool. You cannot reuse the name of a deleted // pool until 30 days after deletion. // -// - location: The location of the pool to create. Format: +// - location: Optional. The location of the pool to create. Format: // `locations/{location}`. func (r *LocationsWorkforcePoolsService) Create(location string, workforcepool *WorkforcePool) *LocationsWorkforcePoolsCreateCall { c := &LocationsWorkforcePoolsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} diff --git a/iamcredentials/v1/iamcredentials-api.json b/iamcredentials/v1/iamcredentials-api.json index 633d334df40..b2633247179 100644 --- a/iamcredentials/v1/iamcredentials-api.json +++ b/iamcredentials/v1/iamcredentials-api.json @@ -165,6 +165,28 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "getAllowedLocations": { + "description": "Returns the trust boundary info for a given service account.", + "flatPath": "v1/projects/{projectsId}/serviceAccounts/{serviceAccountsId}/allowedLocations", + "httpMethod": "GET", + "id": "iamcredentials.projects.serviceAccounts.getAllowedLocations", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Resource name of service account.", + "location": "path", + "pattern": "^projects/[^/]+/serviceAccounts/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}/allowedLocations", + "response": { + "$ref": "ServiceAccountAllowedLocations" + } + }, "signBlob": { "description": "Signs a blob using a service account's system-managed private key.", "flatPath": "v1/projects/{projectsId}/serviceAccounts/{serviceAccountsId}:signBlob", @@ -226,7 +248,7 @@ } } }, - "revision": "20240227", + "revision": "20241024", "rootUrl": "https://iamcredentials.googleapis.com/", "schemas": { "GenerateAccessTokenRequest": { @@ -300,6 +322,26 @@ }, "type": "object" }, + "ServiceAccountAllowedLocations": { + "description": "Represents a list of allowed locations for given service account.", + "id": "ServiceAccountAllowedLocations", + "properties": { + "encodedLocations": { + "description": "Output only. The hex encoded bitmap of the trust boundary locations", + "readOnly": true, + "type": "string" + }, + "locations": { + "description": "Output only. The human readable trust boundary locations. For example, [\"us-central1\", \"europe-west1\"]", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, "SignBlobRequest": { "id": "SignBlobRequest", "properties": { diff --git a/iamcredentials/v1/iamcredentials-gen.go b/iamcredentials/v1/iamcredentials-gen.go index f0c69484583..9c2d660815e 100644 --- a/iamcredentials/v1/iamcredentials-gen.go +++ b/iamcredentials/v1/iamcredentials-gen.go @@ -306,6 +306,36 @@ func (s GenerateIdTokenResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ServiceAccountAllowedLocations: Represents a list of allowed locations for +// given service account. +type ServiceAccountAllowedLocations struct { + // EncodedLocations: Output only. The hex encoded bitmap of the trust boundary + // locations + EncodedLocations string `json:"encodedLocations,omitempty"` + // Locations: Output only. The human readable trust boundary locations. For + // example, ["us-central1", "europe-west1"] + Locations []string `json:"locations,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "EncodedLocations") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "EncodedLocations") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ServiceAccountAllowedLocations) MarshalJSON() ([]byte, error) { + type NoMethod ServiceAccountAllowedLocations + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type SignBlobRequest struct { // Delegates: The sequence of service accounts in a delegation chain. Each // service account must be granted the `roles/iam.serviceAccountTokenCreator` @@ -657,6 +687,115 @@ func (c *ProjectsServiceAccountsGenerateIdTokenCall) Do(opts ...googleapi.CallOp return ret, nil } +type ProjectsServiceAccountsGetAllowedLocationsCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetAllowedLocations: Returns the trust boundary info for a given service +// account. +// +// - name: Resource name of service account. +func (r *ProjectsServiceAccountsService) GetAllowedLocations(name string) *ProjectsServiceAccountsGetAllowedLocationsCall { + c := &ProjectsServiceAccountsGetAllowedLocationsCall{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 *ProjectsServiceAccountsGetAllowedLocationsCall) Fields(s ...googleapi.Field) *ProjectsServiceAccountsGetAllowedLocationsCall { + 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 *ProjectsServiceAccountsGetAllowedLocationsCall) IfNoneMatch(entityTag string) *ProjectsServiceAccountsGetAllowedLocationsCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsServiceAccountsGetAllowedLocationsCall) Context(ctx context.Context) *ProjectsServiceAccountsGetAllowedLocationsCall { + 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 *ProjectsServiceAccountsGetAllowedLocationsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsServiceAccountsGetAllowedLocationsCall) 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/{+name}/allowedLocations") + 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 "iamcredentials.projects.serviceAccounts.getAllowedLocations" call. +// Any non-2xx status code is an error. Response headers are in either +// *ServiceAccountAllowedLocations.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 *ProjectsServiceAccountsGetAllowedLocationsCall) Do(opts ...googleapi.CallOption) (*ServiceAccountAllowedLocations, 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 := &ServiceAccountAllowedLocations{ + 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 ProjectsServiceAccountsSignBlobCall struct { s *Service name string diff --git a/identitytoolkit/v1/identitytoolkit-api.json b/identitytoolkit/v1/identitytoolkit-api.json index 4a96b8c8e67..daabd36075e 100644 --- a/identitytoolkit/v1/identitytoolkit-api.json +++ b/identitytoolkit/v1/identitytoolkit-api.json @@ -1239,7 +1239,7 @@ } } }, - "revision": "20241017", + "revision": "20241024", "rootUrl": "https://identitytoolkit.googleapis.com/", "schemas": { "GoogleCloudIdentitytoolkitV1Argon2Parameters": { @@ -2441,7 +2441,7 @@ "type": "object" }, "GoogleCloudIdentitytoolkitV1SendVerificationCodeRequest": { - "description": "Request message for SendVerificationCode. At least one of (`ios_receipt` and `ios_secret`), `recaptcha_token`, or `safety_net_token` must be specified to verify the verification code is being sent on behalf of a real app and not an emulator.", + "description": "Request message for SendVerificationCode. 'captcha_response' is required when reCAPTCHA enterprise is enabled, or otherwise at least one of (`ios_receipt` and `ios_secret`), `recaptcha_token`, or `safety_net_token` must be specified to verify the verification code is being sent on behalf of a real app and not an emulator.", "id": "GoogleCloudIdentitytoolkitV1SendVerificationCodeRequest", "properties": { "autoRetrievalInfo": { @@ -2469,7 +2469,7 @@ "type": "string" }, "iosReceipt": { - "description": "Receipt of successful iOS app token validation. At least one of (`ios_receipt` and `ios_secret`), `recaptcha_token`, or `safety_net_token` must be specified to verify the verification code is being sent on behalf of a real app and not an emulator. This should come from the response of verifyIosClient. If present, the caller should also provide the `ios_secret`, as well as a bundle ID in the `x-ios-bundle-identifier` header, which must match the bundle ID from the verifyIosClient request.", + "description": "Receipt of successful iOS app token validation. At least one of (`ios_receipt` and `ios_secret`), `recaptcha_token`, or `safety_net_token` must be specified to verify the verification code is being sent on behalf of a real app and not an emulator, if 'captcha_response' is not used (reCAPTCHA enterprise is not enabled). This should come from the response of verifyIosClient. If present, the caller should also provide the `ios_secret`, as well as a bundle ID in the `x-ios-bundle-identifier` header, which must match the bundle ID from the verifyIosClient request.", "type": "string" }, "iosSecret": { @@ -2481,15 +2481,15 @@ "type": "string" }, "playIntegrityToken": { - "description": "Android only. Used to assert application identity in place of a recaptcha token (and safety_net_token). At least one of (`ios_receipt` and `ios_secret`), `recaptcha_token`, , or `play_integrity_token` must be specified to verify the verification code is being sent on behalf of a real app and not an emulator. A Play Integrity Token can be generated via the [PlayIntegrity API](https://developer.android.com/google/play/integrity) with applying SHA256 to the `phone_number` field as the nonce.", + "description": "Android only. Used to assert application identity in place of a recaptcha token (and safety_net_token). At least one of (`ios_receipt` and `ios_secret`), `recaptcha_token`, , or `play_integrity_token` must be specified to verify the verification code is being sent on behalf of a real app and not an emulator, if 'captcha_response' is not used (reCAPTCHA enterprise is not enabled). A Play Integrity Token can be generated via the [PlayIntegrity API](https://developer.android.com/google/play/integrity) with applying SHA256 to the `phone_number` field as the nonce.", "type": "string" }, "recaptchaToken": { - "description": "Recaptcha token for app verification. At least one of (`ios_receipt` and `ios_secret`), `recaptcha_token`, or `safety_net_token` must be specified to verify the verification code is being sent on behalf of a real app and not an emulator. The recaptcha should be generated by calling getRecaptchaParams and the recaptcha token will be generated on user completion of the recaptcha challenge.", + "description": "Recaptcha token for app verification. At least one of (`ios_receipt` and `ios_secret`), `recaptcha_token`, or `safety_net_token` must be specified to verify the verification code is being sent on behalf of a real app and not an emulator, if 'captcha_response' is not used (reCAPTCHA enterprise is not enabled). The recaptcha should be generated by calling getRecaptchaParams and the recaptcha token will be generated on user completion of the recaptcha challenge.", "type": "string" }, "recaptchaVersion": { - "description": "Optional. The reCAPTCHA version of the reCAPTCHA token in the captcha_response.", + "description": "Optional. The reCAPTCHA version of the reCAPTCHA token in the captcha_response. Required when reCAPTCHA Enterprise is enabled.", "enum": [ "RECAPTCHA_VERSION_UNSPECIFIED", "RECAPTCHA_ENTERPRISE" @@ -2501,7 +2501,7 @@ "type": "string" }, "safetyNetToken": { - "description": "Android only. Used to assert application identity in place of a recaptcha token. At least one of (`ios_receipt` and `ios_secret`), `recaptcha_token`, or `safety_net_token` must be specified to verify the verification code is being sent on behalf of a real app and not an emulator. A SafetyNet Token can be generated via the [SafetyNet Android Attestation API](https://developer.android.com/training/safetynet/attestation.html), with the Base64 encoding of the `phone_number` field as the nonce.", + "description": "Android only. Used to assert application identity in place of a recaptcha token. At least one of (`ios_receipt` and `ios_secret`), `recaptcha_token`, or `safety_net_token` must be specified to verify the verification code is being sent on behalf of a real app and not an emulator, if 'captcha_response' is not used (reCAPTCHA enterprise is not enabled). A SafetyNet Token can be generated via the [SafetyNet Android Attestation API](https://developer.android.com/training/safetynet/attestation.html), with the Base64 encoding of the `phone_number` field as the nonce.", "type": "string" }, "tenantId": { diff --git a/identitytoolkit/v1/identitytoolkit-gen.go b/identitytoolkit/v1/identitytoolkit-gen.go index 57eb1e626de..026690d67fe 100644 --- a/identitytoolkit/v1/identitytoolkit-gen.go +++ b/identitytoolkit/v1/identitytoolkit-gen.go @@ -1620,9 +1620,11 @@ func (s GoogleCloudIdentitytoolkitV1ResetPasswordResponse) MarshalJSON() ([]byte } // GoogleCloudIdentitytoolkitV1SendVerificationCodeRequest: Request message for -// SendVerificationCode. At least one of (`ios_receipt` and `ios_secret`), -// `recaptcha_token`, or `safety_net_token` must be specified to verify the -// verification code is being sent on behalf of a real app and not an emulator. +// SendVerificationCode. 'captcha_response' is required when reCAPTCHA +// enterprise is enabled, or otherwise at least one of (`ios_receipt` and +// `ios_secret`), `recaptcha_token`, or `safety_net_token` must be specified to +// verify the verification code is being sent on behalf of a real app and not +// an emulator. type GoogleCloudIdentitytoolkitV1SendVerificationCodeRequest struct { // AutoRetrievalInfo: Android only. Used by Google Play Services to identify // the app for auto-retrieval. @@ -1643,7 +1645,8 @@ type GoogleCloudIdentitytoolkitV1SendVerificationCodeRequest struct { // IosReceipt: Receipt of successful iOS app token validation. At least one of // (`ios_receipt` and `ios_secret`), `recaptcha_token`, or `safety_net_token` // must be specified to verify the verification code is being sent on behalf of - // a real app and not an emulator. This should come from the response of + // a real app and not an emulator, if 'captcha_response' is not used (reCAPTCHA + // enterprise is not enabled). This should come from the response of // verifyIosClient. If present, the caller should also provide the // `ios_secret`, as well as a bundle ID in the `x-ios-bundle-identifier` // header, which must match the bundle ID from the verifyIosClient request. @@ -1659,20 +1662,22 @@ type GoogleCloudIdentitytoolkitV1SendVerificationCodeRequest struct { // place of a recaptcha token (and safety_net_token). At least one of // (`ios_receipt` and `ios_secret`), `recaptcha_token`, , or // `play_integrity_token` must be specified to verify the verification code is - // being sent on behalf of a real app and not an emulator. A Play Integrity - // Token can be generated via the PlayIntegrity API + // being sent on behalf of a real app and not an emulator, if + // 'captcha_response' is not used (reCAPTCHA enterprise is not enabled). A Play + // Integrity Token can be generated via the PlayIntegrity API // (https://developer.android.com/google/play/integrity) with applying SHA256 // to the `phone_number` field as the nonce. PlayIntegrityToken string `json:"playIntegrityToken,omitempty"` // RecaptchaToken: Recaptcha token for app verification. At least one of // (`ios_receipt` and `ios_secret`), `recaptcha_token`, or `safety_net_token` // must be specified to verify the verification code is being sent on behalf of - // a real app and not an emulator. The recaptcha should be generated by calling + // a real app and not an emulator, if 'captcha_response' is not used (reCAPTCHA + // enterprise is not enabled). The recaptcha should be generated by calling // getRecaptchaParams and the recaptcha token will be generated on user // completion of the recaptcha challenge. RecaptchaToken string `json:"recaptchaToken,omitempty"` // RecaptchaVersion: Optional. The reCAPTCHA version of the reCAPTCHA token in - // the captcha_response. + // the captcha_response. Required when reCAPTCHA Enterprise is enabled. // // Possible values: // "RECAPTCHA_VERSION_UNSPECIFIED" - The reCAPTCHA version is not specified. @@ -1681,8 +1686,9 @@ type GoogleCloudIdentitytoolkitV1SendVerificationCodeRequest struct { // SafetyNetToken: Android only. Used to assert application identity in place // of a recaptcha token. At least one of (`ios_receipt` and `ios_secret`), // `recaptcha_token`, or `safety_net_token` must be specified to verify the - // verification code is being sent on behalf of a real app and not an emulator. - // A SafetyNet Token can be generated via the SafetyNet Android Attestation API + // verification code is being sent on behalf of a real app and not an emulator, + // if 'captcha_response' is not used (reCAPTCHA enterprise is not enabled). A + // SafetyNet Token can be generated via the SafetyNet Android Attestation API // (https://developer.android.com/training/safetynet/attestation.html), with // the Base64 encoding of the `phone_number` field as the nonce. SafetyNetToken string `json:"safetyNetToken,omitempty"` diff --git a/identitytoolkit/v2/identitytoolkit-api.json b/identitytoolkit/v2/identitytoolkit-api.json index 733d80081f1..3539defc6b4 100644 --- a/identitytoolkit/v2/identitytoolkit-api.json +++ b/identitytoolkit/v2/identitytoolkit-api.json @@ -1655,7 +1655,7 @@ } } }, - "revision": "20241017", + "revision": "20241024", "rootUrl": "https://identitytoolkit.googleapis.com/", "schemas": { "GoogleCloudIdentitytoolkitAdminV2AllowByDefault": { @@ -2616,7 +2616,7 @@ "id": "GoogleCloudIdentitytoolkitAdminV2RecaptchaConfig", "properties": { "emailPasswordEnforcementState": { - "description": "The reCAPTCHA config for email/password provider, containing the enforcement status. The email/password provider contains all related user flows protected by reCAPTCHA.", + "description": "The reCAPTCHA config for email/password provider, containing the enforcement status. The email/password provider contains all email related user flows protected by reCAPTCHA.", "enum": [ "RECAPTCHA_PROVIDER_ENFORCEMENT_STATE_UNSPECIFIED", "OFF", @@ -2639,7 +2639,7 @@ "type": "array" }, "phoneEnforcementState": { - "description": "The reCAPTCHA config for phone provider, containing the enforcement status. The phone provider contains all related user flows protected by reCAPTCHA.", + "description": "The reCAPTCHA config for phone provider, containing the enforcement status. The phone provider contains all SMS related user flows protected by reCAPTCHA.", "enum": [ "RECAPTCHA_PROVIDER_ENFORCEMENT_STATE_UNSPECIFIED", "OFF", @@ -2662,7 +2662,7 @@ "type": "array" }, "tollFraudManagedRules": { - "description": "The managed rules for toll fraud provider, containing the enforcement status. The toll fraud provider contains all SMS related user flows.", + "description": "The managed rules for the authentication action based on reCAPTCHA toll fraud risk scores. Toll fraud managed rules will only take effect when the phone_enforcement_state is AUDIT or ENFORCE and use_sms_toll_fraud_protection is true.", "items": { "$ref": "GoogleCloudIdentitytoolkitAdminV2RecaptchaTollFraudManagedRule" }, @@ -2671,6 +2671,14 @@ "useAccountDefender": { "description": "Whether to use the account defender for reCAPTCHA assessment. Defaults to `false`.", "type": "boolean" + }, + "useSmsBotScore": { + "description": "Whether to use the rCE bot score for reCAPTCHA phone provider. Can only be true when the phone_enforcement_state is AUDIT or ENFORCE.", + "type": "boolean" + }, + "useSmsTollFraudProtection": { + "description": "Whether to use the rCE sms toll fraud protection risk score for reCAPTCHA phone provider. Can only be true when the phone_enforcement_state is AUDIT or ENFORCE.", + "type": "boolean" } }, "type": "object" @@ -2727,7 +2735,7 @@ "type": "object" }, "GoogleCloudIdentitytoolkitAdminV2RecaptchaTollFraudManagedRule": { - "description": "The config for a reCAPTCHA toll fraud assessment managed rule. Models a single interval [start_score, end_score]. The start_score is maximum_allowed_score. End score is 1.0.", + "description": "The config for a reCAPTCHA toll fraud assessment managed rule. Models a single interval [start_score, end_score]. The end_score is implicit. It is either the closest smaller end_score (if one is available) or 0. Intervals in aggregate span [0, 1] without overlapping.", "id": "GoogleCloudIdentitytoolkitAdminV2RecaptchaTollFraudManagedRule", "properties": { "action": { @@ -2743,7 +2751,7 @@ "type": "string" }, "startScore": { - "description": "The start score (inclusive) for an action. A score of 0.0 indicates the safest request (likely legitimate), whereas 1.0 indicates the riskiest request (likely toll fraud). See https://cloud.google.com/recaptcha-enterprise/docs/sms-fraud-detection#create-assessment-sms.", + "description": "The start score (inclusive) for an action. Must be a value between 0.0 and 1.0, at 11 discrete values; e.g. 0, 0.1, 0.2, 0.3, ... 0.9, 1.0. A score of 0.0 indicates the safest request (likely legitimate), whereas 1.0 indicates the riskiest request (likely toll fraud). See https://cloud.google.com/recaptcha-enterprise/docs/sms-fraud-detection#create-assessment-sms.", "format": "float", "type": "number" } @@ -3369,6 +3377,14 @@ "recaptchaKey": { "description": "The reCAPTCHA Enterprise key resource name, e.g. \"projects/{project}/keys/{key}\". This will only be returned when the reCAPTCHA enforcement state is AUDIT or ENFORCE on at least one of the reCAPTCHA providers.", "type": "string" + }, + "useSmsBotScore": { + "description": "Whether to use the rCE bot score for reCAPTCHA phone provider.", + "type": "boolean" + }, + "useSmsTollFraudProtection": { + "description": "Whether to use the rCE sms toll fraud protection risk score for reCAPTCHA phone provider.", + "type": "boolean" } }, "type": "object" @@ -3546,7 +3562,7 @@ "type": "string" }, "recaptchaVersion": { - "description": "The reCAPTCHA version of the reCAPTCHA token in the captcha_response.", + "description": "The reCAPTCHA version of the reCAPTCHA token in the captcha_response. Required when reCAPTCHA Enterprise is enabled.", "enum": [ "RECAPTCHA_VERSION_UNSPECIFIED", "RECAPTCHA_ENTERPRISE" diff --git a/identitytoolkit/v2/identitytoolkit-gen.go b/identitytoolkit/v2/identitytoolkit-gen.go index d6a754a8e98..1402c1d36de 100644 --- a/identitytoolkit/v2/identitytoolkit-gen.go +++ b/identitytoolkit/v2/identitytoolkit-gen.go @@ -1603,7 +1603,7 @@ func (s GoogleCloudIdentitytoolkitAdminV2QuotaConfig) MarshalJSON() ([]byte, err type GoogleCloudIdentitytoolkitAdminV2RecaptchaConfig struct { // EmailPasswordEnforcementState: The reCAPTCHA config for email/password // provider, containing the enforcement status. The email/password provider - // contains all related user flows protected by reCAPTCHA. + // contains all email related user flows protected by reCAPTCHA. // // Possible values: // "RECAPTCHA_PROVIDER_ENFORCEMENT_STATE_UNSPECIFIED" - Enforcement state has @@ -1616,8 +1616,8 @@ type GoogleCloudIdentitytoolkitAdminV2RecaptchaConfig struct { // scores. The rules are shared across providers for a given tenant project. ManagedRules []*GoogleCloudIdentitytoolkitAdminV2RecaptchaManagedRule `json:"managedRules,omitempty"` // PhoneEnforcementState: The reCAPTCHA config for phone provider, containing - // the enforcement status. The phone provider contains all related user flows - // protected by reCAPTCHA. + // the enforcement status. The phone provider contains all SMS related user + // flows protected by reCAPTCHA. // // Possible values: // "RECAPTCHA_PROVIDER_ENFORCEMENT_STATE_UNSPECIFIED" - Enforcement state has @@ -1628,13 +1628,22 @@ type GoogleCloudIdentitytoolkitAdminV2RecaptchaConfig struct { PhoneEnforcementState string `json:"phoneEnforcementState,omitempty"` // RecaptchaKeys: The reCAPTCHA keys. RecaptchaKeys []*GoogleCloudIdentitytoolkitAdminV2RecaptchaKey `json:"recaptchaKeys,omitempty"` - // TollFraudManagedRules: The managed rules for toll fraud provider, containing - // the enforcement status. The toll fraud provider contains all SMS related - // user flows. + // TollFraudManagedRules: The managed rules for the authentication action based + // on reCAPTCHA toll fraud risk scores. Toll fraud managed rules will only take + // effect when the phone_enforcement_state is AUDIT or ENFORCE and + // use_sms_toll_fraud_protection is true. TollFraudManagedRules []*GoogleCloudIdentitytoolkitAdminV2RecaptchaTollFraudManagedRule `json:"tollFraudManagedRules,omitempty"` // UseAccountDefender: Whether to use the account defender for reCAPTCHA // assessment. Defaults to `false`. UseAccountDefender bool `json:"useAccountDefender,omitempty"` + // UseSmsBotScore: Whether to use the rCE bot score for reCAPTCHA phone + // provider. Can only be true when the phone_enforcement_state is AUDIT or + // ENFORCE. + UseSmsBotScore bool `json:"useSmsBotScore,omitempty"` + // UseSmsTollFraudProtection: Whether to use the rCE sms toll fraud protection + // risk score for reCAPTCHA phone provider. Can only be true when the + // phone_enforcement_state is AUDIT or ENFORCE. + UseSmsTollFraudProtection bool `json:"useSmsTollFraudProtection,omitempty"` // ForceSendFields is a list of field names (e.g. // "EmailPasswordEnforcementState") to unconditionally include in API requests. // By default, fields with empty or default values are omitted from API @@ -1738,8 +1747,9 @@ func (s *GoogleCloudIdentitytoolkitAdminV2RecaptchaManagedRule) UnmarshalJSON(da // GoogleCloudIdentitytoolkitAdminV2RecaptchaTollFraudManagedRule: The config // for a reCAPTCHA toll fraud assessment managed rule. Models a single interval -// [start_score, end_score]. The start_score is maximum_allowed_score. End -// score is 1.0. +// [start_score, end_score]. The end_score is implicit. It is either the +// closest smaller end_score (if one is available) or 0. Intervals in aggregate +// span [0, 1] without overlapping. type GoogleCloudIdentitytoolkitAdminV2RecaptchaTollFraudManagedRule struct { // Action: The action taken if the reCAPTCHA score of a request is within the // interval [start_score, end_score]. @@ -1748,9 +1758,10 @@ type GoogleCloudIdentitytoolkitAdminV2RecaptchaTollFraudManagedRule struct { // "RECAPTCHA_ACTION_UNSPECIFIED" - The reCAPTCHA action is not specified. // "BLOCK" - The reCAPTCHA-protected request will be blocked. Action string `json:"action,omitempty"` - // StartScore: The start score (inclusive) for an action. A score of 0.0 - // indicates the safest request (likely legitimate), whereas 1.0 indicates the - // riskiest request (likely toll fraud). See + // StartScore: The start score (inclusive) for an action. Must be a value + // between 0.0 and 1.0, at 11 discrete values; e.g. 0, 0.1, 0.2, 0.3, ... 0.9, + // 1.0. A score of 0.0 indicates the safest request (likely legitimate), + // whereas 1.0 indicates the riskiest request (likely toll fraud). See // https://cloud.google.com/recaptcha-enterprise/docs/sms-fraud-detection#create-assessment-sms. StartScore float64 `json:"startScore,omitempty"` // ForceSendFields is a list of field names (e.g. "Action") to unconditionally @@ -2565,6 +2576,12 @@ type GoogleCloudIdentitytoolkitV2RecaptchaConfig struct { // reCAPTCHA enforcement state is AUDIT or ENFORCE on at least one of the // reCAPTCHA providers. RecaptchaKey string `json:"recaptchaKey,omitempty"` + // UseSmsBotScore: Whether to use the rCE bot score for reCAPTCHA phone + // provider. + UseSmsBotScore bool `json:"useSmsBotScore,omitempty"` + // UseSmsTollFraudProtection: Whether to use the rCE sms toll fraud protection + // risk score for reCAPTCHA phone provider. + UseSmsTollFraudProtection bool `json:"useSmsTollFraudProtection,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` @@ -2772,7 +2789,7 @@ type GoogleCloudIdentitytoolkitV2StartMfaPhoneRequestInfo struct { // RecaptchaToken: Web only. Recaptcha solution. RecaptchaToken string `json:"recaptchaToken,omitempty"` // RecaptchaVersion: The reCAPTCHA version of the reCAPTCHA token in the - // captcha_response. + // captcha_response. Required when reCAPTCHA Enterprise is enabled. // // Possible values: // "RECAPTCHA_VERSION_UNSPECIFIED" - The reCAPTCHA version is not specified. diff --git a/internal/version.go b/internal/version.go index fd2e72c12d6..f8f7ff8ecd2 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.203.0" +const Version = "0.204.0" diff --git a/logging/v2/logging-api.json b/logging/v2/logging-api.json index fbe32da0ab6..8e89c954deb 100644 --- a/logging/v2/logging-api.json +++ b/logging/v2/logging-api.json @@ -8922,7 +8922,7 @@ } } }, - "revision": "20241010", + "revision": "20241018", "rootUrl": "https://logging.googleapis.com/", "schemas": { "AuditConfig": { @@ -10435,7 +10435,7 @@ "type": "string" }, "resourceNames": { - "description": "Required. Names of one or more parent resources: projects/[PROJECT_ID]May alternatively be one or more views: projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]A log scope can include a maximum of 50 projects and a maximum of 100 resources in total.", + "description": "Required. Names of one or more parent resources: projects/[PROJECT_ID]May alternatively be one or more views: projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]A log scope can include a maximum of 5 projects and a maximum of 100 resources in total.", "items": { "type": "string" }, diff --git a/logging/v2/logging-gen.go b/logging/v2/logging-gen.go index ddafdd52f3f..b0088107928 100644 --- a/logging/v2/logging-gen.go +++ b/logging/v2/logging-gen.go @@ -3192,7 +3192,7 @@ type LogScope struct { // ResourceNames: Required. Names of one or more parent resources: // projects/[PROJECT_ID]May alternatively be one or more views: // projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW - // _ID]A log scope can include a maximum of 50 projects and a maximum of 100 + // _ID]A log scope can include a maximum of 5 projects and a maximum of 100 // resources in total. ResourceNames []string `json:"resourceNames,omitempty"` // UpdateTime: Output only. The last update timestamp of the log scope. diff --git a/looker/v1/looker-api.json b/looker/v1/looker-api.json index a01975ae697..d3d2ee6c709 100644 --- a/looker/v1/looker-api.json +++ b/looker/v1/looker-api.json @@ -731,7 +731,7 @@ } } }, - "revision": "20240910", + "revision": "20241016", "rootUrl": "https://looker.googleapis.com/", "schemas": { "AdminSettings": { @@ -1636,22 +1636,22 @@ "id": "TimeOfDay", "properties": { "hours": { - "description": "Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to allow the value \"24:00:00\" for scenarios like business closing time.", + "description": "Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or equal to 23. An API may choose to allow the value \"24:00:00\" for scenarios like business closing time.", "format": "int32", "type": "integer" }, "minutes": { - "description": "Minutes of hour of day. Must be from 0 to 59.", + "description": "Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59.", "format": "int32", "type": "integer" }, "nanos": { - "description": "Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.", + "description": "Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999.", "format": "int32", "type": "integer" }, "seconds": { - "description": "Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.", + "description": "Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An API may allow the value 60 if it allows leap-seconds.", "format": "int32", "type": "integer" } diff --git a/looker/v1/looker-gen.go b/looker/v1/looker-gen.go index 54b11e895a3..b776f8d5911 100644 --- a/looker/v1/looker-gen.go +++ b/looker/v1/looker-gen.go @@ -1436,16 +1436,19 @@ func (s TestIamPermissionsResponse) MarshalJSON() ([]byte, error) { // significant or are specified elsewhere. An API may choose to allow leap // seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. type TimeOfDay struct { - // Hours: Hours of day in 24 hour format. Should be from 0 to 23. An API may - // choose to allow the value "24:00:00" for scenarios like business closing - // time. + // Hours: Hours of a day in 24 hour format. Must be greater than or equal to 0 + // and typically must be less than or equal to 23. An API may choose to allow + // the value "24:00:00" for scenarios like business closing time. Hours int64 `json:"hours,omitempty"` - // Minutes: Minutes of hour of day. Must be from 0 to 59. + // Minutes: Minutes of an hour. Must be greater than or equal to 0 and less + // than or equal to 59. Minutes int64 `json:"minutes,omitempty"` - // Nanos: Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999. + // Nanos: Fractions of seconds, in nanoseconds. Must be greater than or equal + // to 0 and less than or equal to 999,999,999. Nanos int64 `json:"nanos,omitempty"` - // Seconds: Seconds of minutes of the time. Must normally be from 0 to 59. An - // API may allow the value 60 if it allows leap-seconds. + // Seconds: Seconds of a minute. Must be greater than or equal to 0 and + // typically must be less than or equal to 59. An API may allow the value 60 if + // it allows leap-seconds. Seconds int64 `json:"seconds,omitempty"` // ForceSendFields is a list of field names (e.g. "Hours") to unconditionally // include in API requests. By default, fields with empty or default values are diff --git a/merchantapi/accounts_v1beta/merchantapi-api.json b/merchantapi/accounts_v1beta/merchantapi-api.json index 7acdf313c99..fa36e9e398d 100644 --- a/merchantapi/accounts_v1beta/merchantapi-api.json +++ b/merchantapi/accounts_v1beta/merchantapi-api.json @@ -265,7 +265,7 @@ "type": "string" }, "updateMask": { - "description": "Required. List of fields being updated.", + "description": "Optional. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `account_name` - `adult_content` - `language_code` - `time_zone`", "format": "google-fieldmask", "location": "query", "type": "string" @@ -391,7 +391,7 @@ "type": "string" }, "updateMask": { - "description": "Required. List of fields being updated.", + "description": "Optional. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `black_owned` - `latino_owned` - `promotions_consent` - `small_business` - `veteran_owned` - `women_owned`", "format": "google-fieldmask", "location": "query", "type": "string" @@ -454,7 +454,7 @@ "type": "string" }, "updateMask": { - "description": "Required. List of fields being updated.", + "description": "Optional. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `address` - `customer_service` - `korean_business_registration_number`", "format": "google-fieldmask", "location": "query", "type": "string" @@ -517,7 +517,7 @@ "type": "string" }, "updateMask": { - "description": "Required. List of fields being updated.", + "description": "Required. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `news_and_tips`", "format": "google-fieldmask", "location": "query", "type": "string" @@ -636,7 +636,7 @@ "type": "string" }, "updateMask": { - "description": "Required. List of fields being updated.", + "description": "Optional. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `uri`", "format": "google-fieldmask", "location": "query", "type": "string" @@ -1297,7 +1297,7 @@ "type": "string" }, "updateMask": { - "description": "Required. List of fields being updated.", + "description": "Optional. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `access_rights`", "format": "google-fieldmask", "location": "query", "type": "string" @@ -1417,7 +1417,7 @@ } } }, - "revision": "20241016", + "revision": "20241028", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "Accepted": { @@ -1714,7 +1714,7 @@ "type": "object" }, "CarrierRate": { - "description": "A list of carrier rates that can be referred to by `main_table` or `single_value`.", + "description": "A list of carrier rates that can be referred to by `main_table` or `single_value`. Supported carrier services are defined in https://support.google.com/merchants/answer/12577710?hl=en\u0026ref_topic=12570808\u0026sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only.", "id": "CarrierRate", "properties": { "carrier": { @@ -2755,6 +2755,11 @@ }, "type": "array" }, + "expirationTime": { + "description": "The product expiration time.", + "format": "google-datetime", + "type": "string" + }, "managingAccount": { "description": "The account that manages the merchant's account. can be the same as merchant id if it is standalone account. Format : `accounts/{service_provider_id}`", "type": "string" @@ -3450,7 +3455,7 @@ "id": "WarehouseBasedDeliveryTime", "properties": { "carrier": { - "description": "Required. Carrier, such as `\"UPS\"` or `\"Fedex\"`.", + "description": "Required. Carrier, such as `\"UPS\"` or `\"Fedex\"`. [supported carriers](https://support.google.com/merchants/answer/7050921#zippy=%2Ccarrier-rates-au-de-uk-and-us-only)", "type": "string" }, "carrierService": { diff --git a/merchantapi/accounts_v1beta/merchantapi-gen.go b/merchantapi/accounts_v1beta/merchantapi-gen.go index 7fc7d4cf9ec..ec8a6ce819d 100644 --- a/merchantapi/accounts_v1beta/merchantapi-gen.go +++ b/merchantapi/accounts_v1beta/merchantapi-gen.go @@ -685,7 +685,8 @@ func (s BusinessInfo) MarshalJSON() ([]byte, error) { } // CarrierRate: A list of carrier rates that can be referred to by `main_table` -// or `single_value`. +// or `single_value`. Supported carrier services are defined in +// https://support.google.com/merchants/answer/12577710?hl=en&ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only. type CarrierRate struct { // Carrier: Required. Carrier service, such as "UPS" or "Fedex". Carrier string `json:"carrier,omitempty"` @@ -2073,6 +2074,8 @@ type ProductStatusChangeMessage struct { Attribute string `json:"attribute,omitempty"` // Changes: A message to describe the change that happened to the product Changes []*ProductChange `json:"changes,omitempty"` + // ExpirationTime: The product expiration time. + ExpirationTime string `json:"expirationTime,omitempty"` // ManagingAccount: The account that manages the merchant's account. can be the // same as merchant id if it is standalone account. Format : // `accounts/{service_provider_id}` @@ -2976,7 +2979,8 @@ func (s Warehouse) MarshalJSON() ([]byte, error) { // the selected carrier. When set, no other transit time related field in // `delivery_time` should be set. type WarehouseBasedDeliveryTime struct { - // Carrier: Required. Carrier, such as "UPS" or "Fedex". + // Carrier: Required. Carrier, such as "UPS" or "Fedex". supported carriers + // (https://support.google.com/merchants/answer/7050921#zippy=%2Ccarrier-rates-au-de-uk-and-us-only) Carrier string `json:"carrier,omitempty"` // CarrierService: Required. Carrier service, such as "ground" or "2 days". // The name of the service must be in the eddSupportedServices list. @@ -3702,8 +3706,10 @@ func (r *AccountsService) Patch(name string, account *Account) *AccountsPatchCal return c } -// UpdateMask sets the optional parameter "updateMask": Required. List of -// fields being updated. +// UpdateMask sets the optional parameter "updateMask": List of fields being +// updated. The following fields are supported (in both `snake_case` and +// `lowerCamelCase`): - `account_name` - `adult_content` - `language_code` - +// `time_zone` func (c *AccountsPatchCall) UpdateMask(updateMask string) *AccountsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -4140,8 +4146,10 @@ func (r *AccountsBusinessIdentityService) UpdateBusinessIdentity(name string, bu return c } -// UpdateMask sets the optional parameter "updateMask": Required. List of -// fields being updated. +// UpdateMask sets the optional parameter "updateMask": List of fields being +// updated. The following fields are supported (in both `snake_case` and +// `lowerCamelCase`): - `black_owned` - `latino_owned` - `promotions_consent` - +// `small_business` - `veteran_owned` - `women_owned` func (c *AccountsBusinessIdentityUpdateBusinessIdentityCall) UpdateMask(updateMask string) *AccountsBusinessIdentityUpdateBusinessIdentityCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -4359,8 +4367,10 @@ func (r *AccountsBusinessInfoService) UpdateBusinessInfo(name string, businessin return c } -// UpdateMask sets the optional parameter "updateMask": Required. List of -// fields being updated. +// UpdateMask sets the optional parameter "updateMask": List of fields being +// updated. The following fields are supported (in both `snake_case` and +// `lowerCamelCase`): - `address` - `customer_service` - +// `korean_business_registration_number` func (c *AccountsBusinessInfoUpdateBusinessInfoCall) UpdateMask(updateMask string) *AccountsBusinessInfoUpdateBusinessInfoCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -4588,7 +4598,8 @@ func (r *AccountsEmailPreferencesService) UpdateEmailPreferences(name string, em } // UpdateMask sets the optional parameter "updateMask": Required. List of -// fields being updated. +// fields being updated. The following fields are supported (in both +// `snake_case` and `lowerCamelCase`): - `news_and_tips` func (c *AccountsEmailPreferencesUpdateEmailPreferencesCall) UpdateMask(updateMask string) *AccountsEmailPreferencesUpdateEmailPreferencesCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -5020,8 +5031,9 @@ func (r *AccountsHomepageService) UpdateHomepage(name string, homepage *Homepage return c } -// UpdateMask sets the optional parameter "updateMask": Required. List of -// fields being updated. +// UpdateMask sets the optional parameter "updateMask": List of fields being +// updated. The following fields are supported (in both `snake_case` and +// `lowerCamelCase`): - `uri` func (c *AccountsHomepageUpdateHomepageCall) UpdateMask(updateMask string) *AccountsHomepageUpdateHomepageCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -7493,8 +7505,9 @@ func (r *AccountsUsersService) Patch(name string, user *User) *AccountsUsersPatc return c } -// UpdateMask sets the optional parameter "updateMask": Required. List of -// fields being updated. +// UpdateMask sets the optional parameter "updateMask": List of fields being +// updated. The following fields are supported (in both `snake_case` and +// `lowerCamelCase`): - `access_rights` func (c *AccountsUsersPatchCall) UpdateMask(updateMask string) *AccountsUsersPatchCall { c.urlParams_.Set("updateMask", updateMask) return c diff --git a/merchantapi/conversions_v1beta/merchantapi-api.json b/merchantapi/conversions_v1beta/merchantapi-api.json index bec0d8dcd57..be0e9bd848c 100644 --- a/merchantapi/conversions_v1beta/merchantapi-api.json +++ b/merchantapi/conversions_v1beta/merchantapi-api.json @@ -245,7 +245,7 @@ "type": "string" }, "updateMask": { - "description": "Required. List of fields being updated.", + "description": "Optional. List of fields being updated.", "format": "google-fieldmask", "location": "query", "type": "string" @@ -295,7 +295,7 @@ } } }, - "revision": "20241001", + "revision": "20241023", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "AttributionSettings": { @@ -593,6 +593,11 @@ }, "type": "array" }, + "expirationTime": { + "description": "The product expiration time.", + "format": "google-datetime", + "type": "string" + }, "managingAccount": { "description": "The account that manages the merchant's account. can be the same as merchant id if it is standalone account. Format : `accounts/{service_provider_id}`", "type": "string" diff --git a/merchantapi/conversions_v1beta/merchantapi-gen.go b/merchantapi/conversions_v1beta/merchantapi-gen.go index 1abd4f111d0..d06b45bd87f 100644 --- a/merchantapi/conversions_v1beta/merchantapi-gen.go +++ b/merchantapi/conversions_v1beta/merchantapi-gen.go @@ -481,6 +481,8 @@ type ProductStatusChangeMessage struct { Attribute string `json:"attribute,omitempty"` // Changes: A message to describe the change that happened to the product Changes []*ProductChange `json:"changes,omitempty"` + // ExpirationTime: The product expiration time. + ExpirationTime string `json:"expirationTime,omitempty"` // ManagingAccount: The account that manages the merchant's account. can be the // same as merchant id if it is standalone account. Format : // `accounts/{service_provider_id}` @@ -1011,8 +1013,8 @@ func (r *AccountsConversionSourcesService) Patch(name string, conversionsource * return c } -// UpdateMask sets the optional parameter "updateMask": Required. List of -// fields being updated. +// UpdateMask sets the optional parameter "updateMask": List of fields being +// updated. func (c *AccountsConversionSourcesPatchCall) UpdateMask(updateMask string) *AccountsConversionSourcesPatchCall { c.urlParams_.Set("updateMask", updateMask) return c diff --git a/merchantapi/datasources_v1beta/merchantapi-api.json b/merchantapi/datasources_v1beta/merchantapi-api.json index b8ac0b6e72d..e0f459476bd 100644 --- a/merchantapi/datasources_v1beta/merchantapi-api.json +++ b/merchantapi/datasources_v1beta/merchantapi-api.json @@ -321,7 +321,7 @@ } } }, - "revision": "20241016", + "revision": "20241022", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "DataSource": { @@ -857,6 +857,11 @@ }, "type": "array" }, + "expirationTime": { + "description": "The product expiration time.", + "format": "google-datetime", + "type": "string" + }, "managingAccount": { "description": "The account that manages the merchant's account. can be the same as merchant id if it is standalone account. Format : `accounts/{service_provider_id}`", "type": "string" diff --git a/merchantapi/datasources_v1beta/merchantapi-gen.go b/merchantapi/datasources_v1beta/merchantapi-gen.go index 1736c8a1834..d6a18df0939 100644 --- a/merchantapi/datasources_v1beta/merchantapi-gen.go +++ b/merchantapi/datasources_v1beta/merchantapi-gen.go @@ -737,6 +737,8 @@ type ProductStatusChangeMessage struct { Attribute string `json:"attribute,omitempty"` // Changes: A message to describe the change that happened to the product Changes []*ProductChange `json:"changes,omitempty"` + // ExpirationTime: The product expiration time. + ExpirationTime string `json:"expirationTime,omitempty"` // ManagingAccount: The account that manages the merchant's account. can be the // same as merchant id if it is standalone account. Format : // `accounts/{service_provider_id}` diff --git a/merchantapi/inventories_v1beta/merchantapi-api.json b/merchantapi/inventories_v1beta/merchantapi-api.json index b39b3a56fab..cd21b293baa 100644 --- a/merchantapi/inventories_v1beta/merchantapi-api.json +++ b/merchantapi/inventories_v1beta/merchantapi-api.json @@ -300,7 +300,7 @@ } } }, - "revision": "20240827", + "revision": "20241022", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "CustomAttribute": { @@ -569,6 +569,11 @@ }, "type": "array" }, + "expirationTime": { + "description": "The product expiration time.", + "format": "google-datetime", + "type": "string" + }, "managingAccount": { "description": "The account that manages the merchant's account. can be the same as merchant id if it is standalone account. Format : `accounts/{service_provider_id}`", "type": "string" diff --git a/merchantapi/inventories_v1beta/merchantapi-gen.go b/merchantapi/inventories_v1beta/merchantapi-gen.go index 7f23e6f6a34..f2a6fb9a1fc 100644 --- a/merchantapi/inventories_v1beta/merchantapi-gen.go +++ b/merchantapi/inventories_v1beta/merchantapi-gen.go @@ -503,6 +503,8 @@ type ProductStatusChangeMessage struct { Attribute string `json:"attribute,omitempty"` // Changes: A message to describe the change that happened to the product Changes []*ProductChange `json:"changes,omitempty"` + // ExpirationTime: The product expiration time. + ExpirationTime string `json:"expirationTime,omitempty"` // ManagingAccount: The account that manages the merchant's account. can be the // same as merchant id if it is standalone account. Format : // `accounts/{service_provider_id}` diff --git a/merchantapi/lfp_v1beta/merchantapi-api.json b/merchantapi/lfp_v1beta/merchantapi-api.json index 9e01ac8337b..b9129810e42 100644 --- a/merchantapi/lfp_v1beta/merchantapi-api.json +++ b/merchantapi/lfp_v1beta/merchantapi-api.json @@ -298,7 +298,7 @@ } } }, - "revision": "20240827", + "revision": "20241023", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "Empty": { @@ -643,6 +643,11 @@ }, "type": "array" }, + "expirationTime": { + "description": "The product expiration time.", + "format": "google-datetime", + "type": "string" + }, "managingAccount": { "description": "The account that manages the merchant's account. can be the same as merchant id if it is standalone account. Format : `accounts/{service_provider_id}`", "type": "string" diff --git a/merchantapi/lfp_v1beta/merchantapi-gen.go b/merchantapi/lfp_v1beta/merchantapi-gen.go index 43eae972589..4ddad419c0a 100644 --- a/merchantapi/lfp_v1beta/merchantapi-gen.go +++ b/merchantapi/lfp_v1beta/merchantapi-gen.go @@ -552,6 +552,8 @@ type ProductStatusChangeMessage struct { Attribute string `json:"attribute,omitempty"` // Changes: A message to describe the change that happened to the product Changes []*ProductChange `json:"changes,omitempty"` + // ExpirationTime: The product expiration time. + ExpirationTime string `json:"expirationTime,omitempty"` // ManagingAccount: The account that manages the merchant's account. can be the // same as merchant id if it is standalone account. Format : // `accounts/{service_provider_id}` diff --git a/merchantapi/notifications_v1beta/merchantapi-api.json b/merchantapi/notifications_v1beta/merchantapi-api.json index 05b3e76e3b3..c65ba55ab82 100644 --- a/merchantapi/notifications_v1beta/merchantapi-api.json +++ b/merchantapi/notifications_v1beta/merchantapi-api.json @@ -262,7 +262,7 @@ } } }, - "revision": "20240930", + "revision": "20241022", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "Empty": { @@ -432,6 +432,11 @@ }, "type": "array" }, + "expirationTime": { + "description": "The product expiration time.", + "format": "google-datetime", + "type": "string" + }, "managingAccount": { "description": "The account that manages the merchant's account. can be the same as merchant id if it is standalone account. Format : `accounts/{service_provider_id}`", "type": "string" diff --git a/merchantapi/notifications_v1beta/merchantapi-gen.go b/merchantapi/notifications_v1beta/merchantapi-gen.go index 3c65ec1bf1e..6db190ecb92 100644 --- a/merchantapi/notifications_v1beta/merchantapi-gen.go +++ b/merchantapi/notifications_v1beta/merchantapi-gen.go @@ -339,6 +339,8 @@ type ProductStatusChangeMessage struct { Attribute string `json:"attribute,omitempty"` // Changes: A message to describe the change that happened to the product Changes []*ProductChange `json:"changes,omitempty"` + // ExpirationTime: The product expiration time. + ExpirationTime string `json:"expirationTime,omitempty"` // ManagingAccount: The account that manages the merchant's account. can be the // same as merchant id if it is standalone account. Format : // `accounts/{service_provider_id}` diff --git a/merchantapi/products_v1beta/merchantapi-api.json b/merchantapi/products_v1beta/merchantapi-api.json index 01d35efe9ef..cdff7dd0ecf 100644 --- a/merchantapi/products_v1beta/merchantapi-api.json +++ b/merchantapi/products_v1beta/merchantapi-api.json @@ -242,7 +242,7 @@ } } }, - "revision": "20241015", + "revision": "20241022", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "Attributes": { @@ -1441,6 +1441,11 @@ }, "type": "array" }, + "expirationTime": { + "description": "The product expiration time.", + "format": "google-datetime", + "type": "string" + }, "managingAccount": { "description": "The account that manages the merchant's account. can be the same as merchant id if it is standalone account. Format : `accounts/{service_provider_id}`", "type": "string" diff --git a/merchantapi/products_v1beta/merchantapi-gen.go b/merchantapi/products_v1beta/merchantapi-gen.go index 23c051461a1..c04ae149cf0 100644 --- a/merchantapi/products_v1beta/merchantapi-gen.go +++ b/merchantapi/products_v1beta/merchantapi-gen.go @@ -1349,6 +1349,8 @@ type ProductStatusChangeMessage struct { Attribute string `json:"attribute,omitempty"` // Changes: A message to describe the change that happened to the product Changes []*ProductChange `json:"changes,omitempty"` + // ExpirationTime: The product expiration time. + ExpirationTime string `json:"expirationTime,omitempty"` // ManagingAccount: The account that manages the merchant's account. can be the // same as merchant id if it is standalone account. Format : // `accounts/{service_provider_id}` diff --git a/merchantapi/promotions_v1beta/merchantapi-api.json b/merchantapi/promotions_v1beta/merchantapi-api.json index 47f8eb76943..487aaca2c01 100644 --- a/merchantapi/promotions_v1beta/merchantapi-api.json +++ b/merchantapi/promotions_v1beta/merchantapi-api.json @@ -203,7 +203,7 @@ } } }, - "revision": "20241015", + "revision": "20241022", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "Attributes": { @@ -871,6 +871,11 @@ }, "type": "array" }, + "expirationTime": { + "description": "The product expiration time.", + "format": "google-datetime", + "type": "string" + }, "managingAccount": { "description": "The account that manages the merchant's account. can be the same as merchant id if it is standalone account. Format : `accounts/{service_provider_id}`", "type": "string" diff --git a/merchantapi/promotions_v1beta/merchantapi-gen.go b/merchantapi/promotions_v1beta/merchantapi-gen.go index 27dd0df062b..bf1c45d7848 100644 --- a/merchantapi/promotions_v1beta/merchantapi-gen.go +++ b/merchantapi/promotions_v1beta/merchantapi-gen.go @@ -795,6 +795,8 @@ type ProductStatusChangeMessage struct { Attribute string `json:"attribute,omitempty"` // Changes: A message to describe the change that happened to the product Changes []*ProductChange `json:"changes,omitempty"` + // ExpirationTime: The product expiration time. + ExpirationTime string `json:"expirationTime,omitempty"` // ManagingAccount: The account that manages the merchant's account. can be the // same as merchant id if it is standalone account. Format : // `accounts/{service_provider_id}` diff --git a/merchantapi/quota_v1beta/merchantapi-api.json b/merchantapi/quota_v1beta/merchantapi-api.json index d83545854dc..f316bf3a961 100644 --- a/merchantapi/quota_v1beta/merchantapi-api.json +++ b/merchantapi/quota_v1beta/merchantapi-api.json @@ -150,7 +150,7 @@ } } }, - "revision": "20240827", + "revision": "20241022", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "ListQuotaGroupsResponse": { @@ -305,6 +305,11 @@ }, "type": "array" }, + "expirationTime": { + "description": "The product expiration time.", + "format": "google-datetime", + "type": "string" + }, "managingAccount": { "description": "The account that manages the merchant's account. can be the same as merchant id if it is standalone account. Format : `accounts/{service_provider_id}`", "type": "string" diff --git a/merchantapi/quota_v1beta/merchantapi-gen.go b/merchantapi/quota_v1beta/merchantapi-gen.go index bc70e16beca..1d9650b678f 100644 --- a/merchantapi/quota_v1beta/merchantapi-gen.go +++ b/merchantapi/quota_v1beta/merchantapi-gen.go @@ -312,6 +312,8 @@ type ProductStatusChangeMessage struct { Attribute string `json:"attribute,omitempty"` // Changes: A message to describe the change that happened to the product Changes []*ProductChange `json:"changes,omitempty"` + // ExpirationTime: The product expiration time. + ExpirationTime string `json:"expirationTime,omitempty"` // ManagingAccount: The account that manages the merchant's account. can be the // same as merchant id if it is standalone account. Format : // `accounts/{service_provider_id}` diff --git a/merchantapi/reports_v1beta/merchantapi-api.json b/merchantapi/reports_v1beta/merchantapi-api.json index 72081e70c44..5f25a0ede2d 100644 --- a/merchantapi/reports_v1beta/merchantapi-api.json +++ b/merchantapi/reports_v1beta/merchantapi-api.json @@ -142,7 +142,7 @@ } } }, - "revision": "20240827", + "revision": "20241022", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "BestSellersBrandView": { @@ -1237,6 +1237,11 @@ }, "type": "array" }, + "expirationTime": { + "description": "The product expiration time.", + "format": "google-datetime", + "type": "string" + }, "managingAccount": { "description": "The account that manages the merchant's account. can be the same as merchant id if it is standalone account. Format : `accounts/{service_provider_id}`", "type": "string" diff --git a/merchantapi/reports_v1beta/merchantapi-gen.go b/merchantapi/reports_v1beta/merchantapi-gen.go index c6694e90e73..b6b3eb00905 100644 --- a/merchantapi/reports_v1beta/merchantapi-gen.go +++ b/merchantapi/reports_v1beta/merchantapi-gen.go @@ -1365,6 +1365,8 @@ type ProductStatusChangeMessage struct { Attribute string `json:"attribute,omitempty"` // Changes: A message to describe the change that happened to the product Changes []*ProductChange `json:"changes,omitempty"` + // ExpirationTime: The product expiration time. + ExpirationTime string `json:"expirationTime,omitempty"` // ManagingAccount: The account that manages the merchant's account. can be the // same as merchant id if it is standalone account. Format : // `accounts/{service_provider_id}` diff --git a/merchantapi/reviews_v1beta/merchantapi-api.json b/merchantapi/reviews_v1beta/merchantapi-api.json index 5bae4cb3ab0..a9fe9d75e86 100644 --- a/merchantapi/reviews_v1beta/merchantapi-api.json +++ b/merchantapi/reviews_v1beta/merchantapi-api.json @@ -356,7 +356,7 @@ } } }, - "revision": "20241015", + "revision": "20241022", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "CustomAttribute": { @@ -1292,6 +1292,11 @@ }, "type": "array" }, + "expirationTime": { + "description": "The product expiration time.", + "format": "google-datetime", + "type": "string" + }, "managingAccount": { "description": "The account that manages the merchant's account. can be the same as merchant id if it is standalone account. Format : `accounts/{service_provider_id}`", "type": "string" diff --git a/merchantapi/reviews_v1beta/merchantapi-gen.go b/merchantapi/reviews_v1beta/merchantapi-gen.go index 754f38e028d..a145a67a162 100644 --- a/merchantapi/reviews_v1beta/merchantapi-gen.go +++ b/merchantapi/reviews_v1beta/merchantapi-gen.go @@ -1012,6 +1012,8 @@ type ProductStatusChangeMessage struct { Attribute string `json:"attribute,omitempty"` // Changes: A message to describe the change that happened to the product Changes []*ProductChange `json:"changes,omitempty"` + // ExpirationTime: The product expiration time. + ExpirationTime string `json:"expirationTime,omitempty"` // ManagingAccount: The account that manages the merchant's account. can be the // same as merchant id if it is standalone account. Format : // `accounts/{service_provider_id}` diff --git a/migrationcenter/v1/migrationcenter-api.json b/migrationcenter/v1/migrationcenter-api.json index f2af2ae4423..d69dd2d971a 100644 --- a/migrationcenter/v1/migrationcenter-api.json +++ b/migrationcenter/v1/migrationcenter-api.json @@ -2309,7 +2309,7 @@ } } }, - "revision": "20241001", + "revision": "20241014", "rootUrl": "https://migrationcenter.googleapis.com/", "schemas": { "AddAssetsToGroupRequest": { @@ -2863,7 +2863,7 @@ "PERSISTENT_DISK_TYPE_SSD" ], "enumDescriptions": [ - "Unspecified (default value). Selecting this value allows the system to use any disk type according to reported usage. This a good value to start with.", + "Unspecified. Fallback to default value based on context.", "Standard HDD Persistent Disk.", "Balanced Persistent Disk.", "SSD Persistent Disk." @@ -2933,7 +2933,7 @@ "PERSISTENT_DISK_TYPE_SSD" ], "enumDescriptions": [ - "Unspecified (default value). Selecting this value allows the system to use any disk type according to reported usage. This a good value to start with.", + "Unspecified. Fallback to default value based on context.", "Standard HDD Persistent Disk.", "Balanced Persistent Disk.", "SSD Persistent Disk." @@ -5350,7 +5350,7 @@ "PERSISTENT_DISK_TYPE_SSD" ], "enumDescriptions": [ - "Unspecified (default value). Selecting this value allows the system to use any disk type according to reported usage. This a good value to start with.", + "Unspecified. Fallback to default value based on context.", "Standard HDD Persistent Disk.", "Balanced Persistent Disk.", "SSD Persistent Disk." diff --git a/migrationcenter/v1/migrationcenter-gen.go b/migrationcenter/v1/migrationcenter-gen.go index a483fa8159a..c40a7f5df45 100644 --- a/migrationcenter/v1/migrationcenter-gen.go +++ b/migrationcenter/v1/migrationcenter-gen.go @@ -1026,9 +1026,8 @@ type ComputeEnginePreferences struct { // all types are considered, based on available usage data. // // Possible values: - // "PERSISTENT_DISK_TYPE_UNSPECIFIED" - Unspecified (default value). - // Selecting this value allows the system to use any disk type according to - // reported usage. This a good value to start with. + // "PERSISTENT_DISK_TYPE_UNSPECIFIED" - Unspecified. Fallback to default + // value based on context. // "PERSISTENT_DISK_TYPE_STANDARD" - Standard HDD Persistent Disk. // "PERSISTENT_DISK_TYPE_BALANCED" - Balanced Persistent Disk. // "PERSISTENT_DISK_TYPE_SSD" - SSD Persistent Disk. @@ -1090,9 +1089,8 @@ type ComputeStorageDescriptor struct { // Type: Output only. Disk type backing the storage. // // Possible values: - // "PERSISTENT_DISK_TYPE_UNSPECIFIED" - Unspecified (default value). - // Selecting this value allows the system to use any disk type according to - // reported usage. This a good value to start with. + // "PERSISTENT_DISK_TYPE_UNSPECIFIED" - Unspecified. Fallback to default + // value based on context. // "PERSISTENT_DISK_TYPE_STANDARD" - Standard HDD Persistent Disk. // "PERSISTENT_DISK_TYPE_BALANCED" - Balanced Persistent Disk. // "PERSISTENT_DISK_TYPE_SSD" - SSD Persistent Disk. @@ -3953,9 +3951,8 @@ type ReportSummaryComputeEngineFinding struct { // AllocatedDiskTypes: Set of disk types allocated to assets. // // Possible values: - // "PERSISTENT_DISK_TYPE_UNSPECIFIED" - Unspecified (default value). - // Selecting this value allows the system to use any disk type according to - // reported usage. This a good value to start with. + // "PERSISTENT_DISK_TYPE_UNSPECIFIED" - Unspecified. Fallback to default + // value based on context. // "PERSISTENT_DISK_TYPE_STANDARD" - Standard HDD Persistent Disk. // "PERSISTENT_DISK_TYPE_BALANCED" - Balanced Persistent Disk. // "PERSISTENT_DISK_TYPE_SSD" - SSD Persistent Disk. diff --git a/migrationcenter/v1alpha1/migrationcenter-api.json b/migrationcenter/v1alpha1/migrationcenter-api.json index 5fb8e273a94..65236d324ec 100644 --- a/migrationcenter/v1alpha1/migrationcenter-api.json +++ b/migrationcenter/v1alpha1/migrationcenter-api.json @@ -2548,7 +2548,7 @@ } } }, - "revision": "20241001", + "revision": "20241014", "rootUrl": "https://migrationcenter.googleapis.com/", "schemas": { "AddAssetsToGroupRequest": { @@ -3647,7 +3647,7 @@ "PERSISTENT_DISK_TYPE_SSD" ], "enumDescriptions": [ - "Unspecified (default value). Selecting this value allows the system to use any disk type according to reported usage. This a good value to start with.", + "Unspecified. Fallback to default value based on context.", "Standard HDD Persistent Disk.", "Balanced Persistent Disk.", "SSD Persistent Disk." @@ -3729,7 +3729,7 @@ "PERSISTENT_DISK_TYPE_SSD" ], "enumDescriptions": [ - "Unspecified (default value). Selecting this value allows the system to use any disk type according to reported usage. This a good value to start with.", + "Unspecified. Fallback to default value based on context.", "Standard HDD Persistent Disk.", "Balanced Persistent Disk.", "SSD Persistent Disk." @@ -4199,7 +4199,7 @@ "PERSISTENT_DISK_TYPE_SSD" ], "enumDescriptions": [ - "Unspecified (default value). Selecting this value allows the system to use any disk type according to reported usage. This a good value to start with.", + "Unspecified. Fallback to default value based on context.", "Standard HDD Persistent Disk.", "Balanced Persistent Disk.", "SSD Persistent Disk." @@ -7469,7 +7469,7 @@ "PERSISTENT_DISK_TYPE_SSD" ], "enumDescriptions": [ - "Unspecified (default value). Selecting this value allows the system to use any disk type according to reported usage. This a good value to start with.", + "Unspecified. Fallback to default value based on context.", "Standard HDD Persistent Disk.", "Balanced Persistent Disk.", "SSD Persistent Disk." diff --git a/migrationcenter/v1alpha1/migrationcenter-gen.go b/migrationcenter/v1alpha1/migrationcenter-gen.go index e1a05cdf526..409bc466a5b 100644 --- a/migrationcenter/v1alpha1/migrationcenter-gen.go +++ b/migrationcenter/v1alpha1/migrationcenter-gen.go @@ -1546,9 +1546,8 @@ type ComputeEnginePreferences struct { // all types are considered, based on available usage data. // // Possible values: - // "PERSISTENT_DISK_TYPE_UNSPECIFIED" - Unspecified (default value). - // Selecting this value allows the system to use any disk type according to - // reported usage. This a good value to start with. + // "PERSISTENT_DISK_TYPE_UNSPECIFIED" - Unspecified. Fallback to default + // value based on context. // "PERSISTENT_DISK_TYPE_STANDARD" - Standard HDD Persistent Disk. // "PERSISTENT_DISK_TYPE_BALANCED" - Balanced Persistent Disk. // "PERSISTENT_DISK_TYPE_SSD" - SSD Persistent Disk. @@ -1618,9 +1617,8 @@ type ComputeStorageDescriptor struct { // Type: Output only. Disk type backing the storage. // // Possible values: - // "PERSISTENT_DISK_TYPE_UNSPECIFIED" - Unspecified (default value). - // Selecting this value allows the system to use any disk type according to - // reported usage. This a good value to start with. + // "PERSISTENT_DISK_TYPE_UNSPECIFIED" - Unspecified. Fallback to default + // value based on context. // "PERSISTENT_DISK_TYPE_STANDARD" - Standard HDD Persistent Disk. // "PERSISTENT_DISK_TYPE_BALANCED" - Balanced Persistent Disk. // "PERSISTENT_DISK_TYPE_SSD" - SSD Persistent Disk. @@ -2199,9 +2197,8 @@ type DatabasePreferencesCloudSqlCommon struct { // types are available. // // Possible values: - // "PERSISTENT_DISK_TYPE_UNSPECIFIED" - Unspecified (default value). - // Selecting this value allows the system to use any disk type according to - // reported usage. This a good value to start with. + // "PERSISTENT_DISK_TYPE_UNSPECIFIED" - Unspecified. Fallback to default + // value based on context. // "PERSISTENT_DISK_TYPE_STANDARD" - Standard HDD Persistent Disk. // "PERSISTENT_DISK_TYPE_BALANCED" - Balanced Persistent Disk. // "PERSISTENT_DISK_TYPE_SSD" - SSD Persistent Disk. @@ -5947,9 +5944,8 @@ type ReportSummaryMachineFinding struct { // AllocatedDiskTypes: Set of disk types allocated to assets. // // Possible values: - // "PERSISTENT_DISK_TYPE_UNSPECIFIED" - Unspecified (default value). - // Selecting this value allows the system to use any disk type according to - // reported usage. This a good value to start with. + // "PERSISTENT_DISK_TYPE_UNSPECIFIED" - Unspecified. Fallback to default + // value based on context. // "PERSISTENT_DISK_TYPE_STANDARD" - Standard HDD Persistent Disk. // "PERSISTENT_DISK_TYPE_BALANCED" - Balanced Persistent Disk. // "PERSISTENT_DISK_TYPE_SSD" - SSD Persistent Disk. diff --git a/netapp/v1/netapp-api.json b/netapp/v1/netapp-api.json index bd0bf4c0412..85d6a116d8e 100644 --- a/netapp/v1/netapp-api.json +++ b/netapp/v1/netapp-api.json @@ -2013,7 +2013,7 @@ } } }, - "revision": "20241002", + "revision": "20241021", "rootUrl": "https://netapp.googleapis.com/", "schemas": { "ActiveDirectory": { @@ -2147,42 +2147,6 @@ }, "type": "object" }, - "AssetLocation": { - "description": "Provides the mapping of a cloud asset to a direct physical location or to a proxy that defines the location on its behalf.", - "id": "AssetLocation", - "properties": { - "ccfeRmsPath": { - "description": "Spanner path of the CCFE RMS database. It is only applicable for CCFE tenants that use CCFE RMS for storing resource metadata.", - "type": "string" - }, - "expected": { - "$ref": "IsolationExpectations", - "description": "Defines the customer expectation around ZI/ZS for this asset and ZI/ZS state of the region at the time of asset creation." - }, - "extraParameters": { - "description": "Defines extra parameters required for specific asset types.", - "items": { - "$ref": "ExtraParameter" - }, - "type": "array" - }, - "locationData": { - "description": "Contains all kinds of physical location definitions for this asset.", - "items": { - "$ref": "LocationData" - }, - "type": "array" - }, - "parentAsset": { - "description": "Defines parents assets if any in order to allow later generation of child_asset_location data via child assets.", - "items": { - "$ref": "CloudAsset" - }, - "type": "array" - } - }, - "type": "object" - }, "Backup": { "description": "A NetApp Backup.", "id": "Backup", @@ -2420,49 +2384,12 @@ }, "type": "object" }, - "BlobstoreLocation": { - "description": "Policy ID that identified data placement in Blobstore as per go/blobstore-user-guide#data-metadata-placement-and-failure-domains", - "id": "BlobstoreLocation", - "properties": { - "policyId": { - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "CancelOperationRequest": { "description": "The request message for Operations.CancelOperation.", "id": "CancelOperationRequest", "properties": {}, "type": "object" }, - "CloudAsset": { - "id": "CloudAsset", - "properties": { - "assetName": { - "type": "string" - }, - "assetType": { - "type": "string" - } - }, - "type": "object" - }, - "CloudAssetComposition": { - "id": "CloudAssetComposition", - "properties": { - "childAsset": { - "items": { - "$ref": "CloudAsset" - }, - "type": "array" - } - }, - "type": "object" - }, "DailySchedule": { "description": "Make a snapshot every day e.g. at 04:00, 05:20, 23:50", "id": "DailySchedule", @@ -2508,18 +2435,6 @@ }, "type": "object" }, - "DirectLocationAssignment": { - "id": "DirectLocationAssignment", - "properties": { - "location": { - "items": { - "$ref": "LocationAssignment" - }, - "type": "array" - } - }, - "type": "object" - }, "EncryptVolumesRequest": { "description": "EncryptVolumesRequest specifies the KMS config to encrypt existing volumes.", "id": "EncryptVolumesRequest", @@ -2540,17 +2455,6 @@ }, "type": "object" }, - "ExtraParameter": { - "description": "Defines parameters that should only be used for specific asset types.", - "id": "ExtraParameter", - "properties": { - "regionalMigDistributionPolicy": { - "$ref": "RegionalMigDistributionPolicy", - "description": "Details about zones used by regional compute.googleapis.com/InstanceGroupManager to create instances." - } - }, - "type": "object" - }, "GoogleProtobufEmpty": { "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": "GoogleProtobufEmpty", @@ -2574,131 +2478,6 @@ }, "type": "object" }, - "IsolationExpectations": { - "id": "IsolationExpectations", - "properties": { - "requirementOverride": { - "$ref": "RequirementOverride", - "description": "Explicit overrides for ZI and ZS requirements to be used for resources that should be excluded from ZI/ZS verification logic." - }, - "ziOrgPolicy": { - "enum": [ - "ZI_UNSPECIFIED", - "ZI_UNKNOWN", - "ZI_NOT_REQUIRED", - "ZI_PREFERRED", - "ZI_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "", - "" - ], - "type": "string" - }, - "ziRegionPolicy": { - "enum": [ - "ZI_REGION_POLICY_UNSPECIFIED", - "ZI_REGION_POLICY_UNKNOWN", - "ZI_REGION_POLICY_NOT_SET", - "ZI_REGION_POLICY_FAIL_OPEN", - "ZI_REGION_POLICY_FAIL_CLOSED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "", - "" - ], - "type": "string" - }, - "ziRegionState": { - "enum": [ - "ZI_REGION_UNSPECIFIED", - "ZI_REGION_UNKNOWN", - "ZI_REGION_NOT_ENABLED", - "ZI_REGION_ENABLED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "" - ], - "type": "string" - }, - "zoneIsolation": { - "deprecated": true, - "description": "Deprecated: use zi_org_policy, zi_region_policy and zi_region_state instead for setting ZI expectations as per go/zicy-publish-physical-location.", - "enum": [ - "ZI_UNSPECIFIED", - "ZI_UNKNOWN", - "ZI_NOT_REQUIRED", - "ZI_PREFERRED", - "ZI_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "", - "" - ], - "type": "string" - }, - "zoneSeparation": { - "deprecated": true, - "description": "Deprecated: use zs_org_policy, and zs_region_stateinstead for setting Zs expectations as per go/zicy-publish-physical-location.", - "enum": [ - "ZS_UNSPECIFIED", - "ZS_UNKNOWN", - "ZS_NOT_REQUIRED", - "ZS_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "" - ], - "type": "string" - }, - "zsOrgPolicy": { - "enum": [ - "ZS_UNSPECIFIED", - "ZS_UNKNOWN", - "ZS_NOT_REQUIRED", - "ZS_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "" - ], - "type": "string" - }, - "zsRegionState": { - "enum": [ - "ZS_REGION_UNSPECIFIED", - "ZS_REGION_UNKNOWN", - "ZS_REGION_NOT_ENABLED", - "ZS_REGION_ENABLED" - ], - "enumDescriptions": [ - "", - "To be used if tracking of the asset ZS-bit is not available", - "", - "" - ], - "type": "string" - } - }, - "type": "object" - }, "KmsConfig": { "description": "KmsConfig is the customer managed encryption key(CMEK) configuration.", "id": "KmsConfig", @@ -3074,64 +2853,6 @@ }, "type": "object" }, - "LocationAssignment": { - "id": "LocationAssignment", - "properties": { - "location": { - "type": "string" - }, - "locationType": { - "enum": [ - "UNSPECIFIED", - "CLUSTER", - "POP", - "CLOUD_ZONE", - "CLOUD_REGION", - "MULTI_REGION_GEO", - "MULTI_REGION_JURISDICTION", - "GLOBAL", - "OTHER" - ], - "enumDescriptions": [ - "", - "1-10: Physical failure domains.", - "", - "11-20: Logical failure domains.", - "", - "", - "", - "", - "" - ], - "type": "string" - } - }, - "type": "object" - }, - "LocationData": { - "id": "LocationData", - "properties": { - "blobstoreLocation": { - "$ref": "BlobstoreLocation" - }, - "childAssetLocation": { - "$ref": "CloudAssetComposition" - }, - "directLocation": { - "$ref": "DirectLocationAssignment" - }, - "gcpProjectProxy": { - "$ref": "TenantProjectProxy" - }, - "placerLocation": { - "$ref": "PlacerLocation" - }, - "spannerLocation": { - "$ref": "SpannerLocation" - } - }, - "type": "object" - }, "LocationMetadata": { "description": "Metadata for a given google.cloud.location.Location.", "id": "LocationMetadata", @@ -3301,36 +3022,6 @@ }, "type": "object" }, - "PlacerLocation": { - "description": "Message describing that the location of the customer resource is tied to placer allocations", - "id": "PlacerLocation", - "properties": { - "placerConfig": { - "description": "Directory with a config related to it in placer (e.g. \"/placer/prod/home/my-root/my-dir\")", - "type": "string" - } - }, - "type": "object" - }, - "RegionalMigDistributionPolicy": { - "description": "To be used for specifying the intended distribution of regional compute.googleapis.com/InstanceGroupManager instances", - "id": "RegionalMigDistributionPolicy", - "properties": { - "targetShape": { - "description": "The shape in which the group converges around distribution of resources. Instance of proto2 enum", - "format": "int32", - "type": "integer" - }, - "zones": { - "description": "Cloud zones used by regional MIG to create instances.", - "items": { - "$ref": "ZoneConfiguration" - }, - "type": "array" - } - }, - "type": "object" - }, "Replication": { "description": "Replication is a nested resource under Volume, that describes a cross-region replication relationship between 2 volumes in different regions.", "id": "Replication", @@ -3459,44 +3150,6 @@ }, "type": "object" }, - "RequirementOverride": { - "id": "RequirementOverride", - "properties": { - "ziOverride": { - "enum": [ - "ZI_UNSPECIFIED", - "ZI_UNKNOWN", - "ZI_NOT_REQUIRED", - "ZI_PREFERRED", - "ZI_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "", - "" - ], - "type": "string" - }, - "zsOverride": { - "enum": [ - "ZS_UNSPECIFIED", - "ZS_UNKNOWN", - "ZS_NOT_REQUIRED", - "ZS_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "" - ], - "type": "string" - } - }, - "type": "object" - }, "RestoreParameters": { "description": "The RestoreParameters if volume is created from a snapshot or backup.", "id": "RestoreParameters", @@ -3687,26 +3340,6 @@ }, "type": "object" }, - "SpannerLocation": { - "id": "SpannerLocation", - "properties": { - "backupName": { - "description": "Set of backups used by the resource with name in the same format as what is available at http://table/spanner_automon.backup_metadata", - "items": { - "type": "string" - }, - "type": "array" - }, - "dbName": { - "description": "Set of databases used by the resource in format /span//", - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "Status": { "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", "id": "Status", @@ -3896,18 +3529,6 @@ "properties": {}, "type": "object" }, - "TenantProjectProxy": { - "id": "TenantProjectProxy", - "properties": { - "projectNumbers": { - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "TieringPolicy": { "description": "Defines tiering policy for the volume.", "id": "TieringPolicy", @@ -4322,15 +3943,6 @@ } }, "type": "object" - }, - "ZoneConfiguration": { - "id": "ZoneConfiguration", - "properties": { - "zone": { - "type": "string" - } - }, - "type": "object" } }, "servicePath": "", diff --git a/netapp/v1/netapp-gen.go b/netapp/v1/netapp-gen.go index e155129f9e7..a8832df2599 100644 --- a/netapp/v1/netapp-gen.go +++ b/netapp/v1/netapp-gen.go @@ -386,41 +386,6 @@ func (s ActiveDirectory) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// AssetLocation: Provides the mapping of a cloud asset to a direct physical -// location or to a proxy that defines the location on its behalf. -type AssetLocation struct { - // CcfeRmsPath: Spanner path of the CCFE RMS database. It is only applicable - // for CCFE tenants that use CCFE RMS for storing resource metadata. - CcfeRmsPath string `json:"ccfeRmsPath,omitempty"` - // Expected: Defines the customer expectation around ZI/ZS for this asset and - // ZI/ZS state of the region at the time of asset creation. - Expected *IsolationExpectations `json:"expected,omitempty"` - // ExtraParameters: Defines extra parameters required for specific asset types. - ExtraParameters []*ExtraParameter `json:"extraParameters,omitempty"` - // LocationData: Contains all kinds of physical location definitions for this - // asset. - LocationData []*LocationData `json:"locationData,omitempty"` - // ParentAsset: Defines parents assets if any in order to allow later - // generation of child_asset_location data via child assets. - ParentAsset []*CloudAsset `json:"parentAsset,omitempty"` - // ForceSendFields is a list of field names (e.g. "CcfeRmsPath") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "CcfeRmsPath") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s AssetLocation) MarshalJSON() ([]byte, error) { - type NoMethod AssetLocation - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // Backup: A NetApp Backup. type Backup struct { // BackupType: Output only. Type of backup, manually created or created by a @@ -628,73 +593,10 @@ func (s BackupVault) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// BlobstoreLocation: Policy ID that identified data placement in Blobstore as -// per go/blobstore-user-guide#data-metadata-placement-and-failure-domains -type BlobstoreLocation struct { - PolicyId []string `json:"policyId,omitempty"` - // ForceSendFields is a list of field names (e.g. "PolicyId") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "PolicyId") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s BlobstoreLocation) MarshalJSON() ([]byte, error) { - type NoMethod BlobstoreLocation - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // CancelOperationRequest: The request message for Operations.CancelOperation. type CancelOperationRequest struct { } -type CloudAsset struct { - AssetName string `json:"assetName,omitempty"` - AssetType string `json:"assetType,omitempty"` - // ForceSendFields is a list of field names (e.g. "AssetName") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "AssetName") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s CloudAsset) MarshalJSON() ([]byte, error) { - type NoMethod CloudAsset - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -type CloudAssetComposition struct { - ChildAsset []*CloudAsset `json:"childAsset,omitempty"` - // ForceSendFields is a list of field names (e.g. "ChildAsset") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ChildAsset") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s CloudAssetComposition) MarshalJSON() ([]byte, error) { - type NoMethod CloudAssetComposition - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // DailySchedule: Make a snapshot every day e.g. at 04:00, 05:20, 23:50 type DailySchedule struct { // Hour: Set the hour to start the snapshot (0-23), defaults to midnight (0). @@ -774,26 +676,6 @@ func (s DestinationVolumeParameters) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type DirectLocationAssignment struct { - Location []*LocationAssignment `json:"location,omitempty"` - // ForceSendFields is a list of field names (e.g. "Location") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Location") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s DirectLocationAssignment) MarshalJSON() ([]byte, error) { - type NoMethod DirectLocationAssignment - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // EncryptVolumesRequest: EncryptVolumesRequest specifies the KMS config to // encrypt existing volumes. type EncryptVolumesRequest struct { @@ -821,30 +703,6 @@ func (s ExportPolicy) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// ExtraParameter: Defines parameters that should only be used for specific -// asset types. -type ExtraParameter struct { - // RegionalMigDistributionPolicy: Details about zones used by regional - // compute.googleapis.com/InstanceGroupManager to create instances. - RegionalMigDistributionPolicy *RegionalMigDistributionPolicy `json:"regionalMigDistributionPolicy,omitempty"` - // ForceSendFields is a list of field names (e.g. - // "RegionalMigDistributionPolicy") to unconditionally include in API requests. - // By default, fields with empty or default values are omitted from API - // requests. See https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields - // for more details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "RegionalMigDistributionPolicy") - // to include in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s ExtraParameter) MarshalJSON() ([]byte, error) { - type NoMethod ExtraParameter - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleProtobufEmpty: 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: @@ -897,81 +755,6 @@ func (s *HourlySchedule) UnmarshalJSON(data []byte) error { return nil } -type IsolationExpectations struct { - // RequirementOverride: Explicit overrides for ZI and ZS requirements to be - // used for resources that should be excluded from ZI/ZS verification logic. - RequirementOverride *RequirementOverride `json:"requirementOverride,omitempty"` - // Possible values: - // "ZI_UNSPECIFIED" - // "ZI_UNKNOWN" - To be used if tracking is not available - // "ZI_NOT_REQUIRED" - // "ZI_PREFERRED" - // "ZI_REQUIRED" - ZiOrgPolicy string `json:"ziOrgPolicy,omitempty"` - // Possible values: - // "ZI_REGION_POLICY_UNSPECIFIED" - // "ZI_REGION_POLICY_UNKNOWN" - To be used if tracking is not available - // "ZI_REGION_POLICY_NOT_SET" - // "ZI_REGION_POLICY_FAIL_OPEN" - // "ZI_REGION_POLICY_FAIL_CLOSED" - ZiRegionPolicy string `json:"ziRegionPolicy,omitempty"` - // Possible values: - // "ZI_REGION_UNSPECIFIED" - // "ZI_REGION_UNKNOWN" - To be used if tracking is not available - // "ZI_REGION_NOT_ENABLED" - // "ZI_REGION_ENABLED" - ZiRegionState string `json:"ziRegionState,omitempty"` - // ZoneIsolation: Deprecated: use zi_org_policy, zi_region_policy and - // zi_region_state instead for setting ZI expectations as per - // go/zicy-publish-physical-location. - // - // Possible values: - // "ZI_UNSPECIFIED" - // "ZI_UNKNOWN" - To be used if tracking is not available - // "ZI_NOT_REQUIRED" - // "ZI_PREFERRED" - // "ZI_REQUIRED" - ZoneIsolation string `json:"zoneIsolation,omitempty"` - // ZoneSeparation: Deprecated: use zs_org_policy, and zs_region_stateinstead - // for setting Zs expectations as per go/zicy-publish-physical-location. - // - // Possible values: - // "ZS_UNSPECIFIED" - // "ZS_UNKNOWN" - To be used if tracking is not available - // "ZS_NOT_REQUIRED" - // "ZS_REQUIRED" - ZoneSeparation string `json:"zoneSeparation,omitempty"` - // Possible values: - // "ZS_UNSPECIFIED" - // "ZS_UNKNOWN" - To be used if tracking is not available - // "ZS_NOT_REQUIRED" - // "ZS_REQUIRED" - ZsOrgPolicy string `json:"zsOrgPolicy,omitempty"` - // Possible values: - // "ZS_REGION_UNSPECIFIED" - // "ZS_REGION_UNKNOWN" - To be used if tracking of the asset ZS-bit is not - // available - // "ZS_REGION_NOT_ENABLED" - // "ZS_REGION_ENABLED" - ZsRegionState string `json:"zsRegionState,omitempty"` - // ForceSendFields is a list of field names (e.g. "RequirementOverride") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "RequirementOverride") to include - // in API requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s IsolationExpectations) MarshalJSON() ([]byte, error) { - type NoMethod IsolationExpectations - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // KmsConfig: KmsConfig is the customer managed encryption key(CMEK) // configuration. type KmsConfig struct { @@ -1409,62 +1192,6 @@ func (s Location) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type LocationAssignment struct { - Location string `json:"location,omitempty"` - // Possible values: - // "UNSPECIFIED" - // "CLUSTER" - 1-10: Physical failure domains. - // "POP" - // "CLOUD_ZONE" - 11-20: Logical failure domains. - // "CLOUD_REGION" - // "MULTI_REGION_GEO" - // "MULTI_REGION_JURISDICTION" - // "GLOBAL" - // "OTHER" - LocationType string `json:"locationType,omitempty"` - // ForceSendFields is a list of field names (e.g. "Location") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Location") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s LocationAssignment) MarshalJSON() ([]byte, error) { - type NoMethod LocationAssignment - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -type LocationData struct { - BlobstoreLocation *BlobstoreLocation `json:"blobstoreLocation,omitempty"` - ChildAssetLocation *CloudAssetComposition `json:"childAssetLocation,omitempty"` - DirectLocation *DirectLocationAssignment `json:"directLocation,omitempty"` - GcpProjectProxy *TenantProjectProxy `json:"gcpProjectProxy,omitempty"` - PlacerLocation *PlacerLocation `json:"placerLocation,omitempty"` - SpannerLocation *SpannerLocation `json:"spannerLocation,omitempty"` - // ForceSendFields is a list of field names (e.g. "BlobstoreLocation") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "BlobstoreLocation") to include in - // API requests with the JSON null value. By default, fields with empty values - // are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s LocationData) MarshalJSON() ([]byte, error) { - type NoMethod LocationData - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // LocationMetadata: Metadata for a given google.cloud.location.Location. type LocationMetadata struct { // SupportedServiceLevels: Output only. Supported service levels in a location. @@ -1663,57 +1390,6 @@ func (s OperationMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// PlacerLocation: Message describing that the location of the customer -// resource is tied to placer allocations -type PlacerLocation struct { - // PlacerConfig: Directory with a config related to it in placer (e.g. - // "/placer/prod/home/my-root/my-dir") - PlacerConfig string `json:"placerConfig,omitempty"` - // ForceSendFields is a list of field names (e.g. "PlacerConfig") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "PlacerConfig") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s PlacerLocation) MarshalJSON() ([]byte, error) { - type NoMethod PlacerLocation - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// RegionalMigDistributionPolicy: To be used for specifying the intended -// distribution of regional compute.googleapis.com/InstanceGroupManager -// instances -type RegionalMigDistributionPolicy struct { - // TargetShape: The shape in which the group converges around distribution of - // resources. Instance of proto2 enum - TargetShape int64 `json:"targetShape,omitempty"` - // Zones: Cloud zones used by regional MIG to create instances. - Zones []*ZoneConfiguration `json:"zones,omitempty"` - // ForceSendFields is a list of field names (e.g. "TargetShape") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "TargetShape") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s RegionalMigDistributionPolicy) MarshalJSON() ([]byte, error) { - type NoMethod RegionalMigDistributionPolicy - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // Replication: Replication is a nested resource under Volume, that describes a // cross-region replication relationship between 2 volumes in different // regions. @@ -1803,38 +1479,6 @@ func (s Replication) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type RequirementOverride struct { - // Possible values: - // "ZI_UNSPECIFIED" - // "ZI_UNKNOWN" - To be used if tracking is not available - // "ZI_NOT_REQUIRED" - // "ZI_PREFERRED" - // "ZI_REQUIRED" - ZiOverride string `json:"ziOverride,omitempty"` - // Possible values: - // "ZS_UNSPECIFIED" - // "ZS_UNKNOWN" - To be used if tracking is not available - // "ZS_NOT_REQUIRED" - // "ZS_REQUIRED" - ZsOverride string `json:"zsOverride,omitempty"` - // ForceSendFields is a list of field names (e.g. "ZiOverride") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ZiOverride") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s RequirementOverride) MarshalJSON() ([]byte, error) { - type NoMethod RequirementOverride - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // RestoreParameters: The RestoreParameters if volume is created from a // snapshot or backup. type RestoreParameters struct { @@ -2058,30 +1702,6 @@ func (s SnapshotPolicy) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type SpannerLocation struct { - // BackupName: Set of backups used by the resource with name in the same format - // as what is available at http://table/spanner_automon.backup_metadata - BackupName []string `json:"backupName,omitempty"` - // DbName: Set of databases used by the resource in format /span// - DbName []string `json:"dbName,omitempty"` - // ForceSendFields is a list of field names (e.g. "BackupName") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "BackupName") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s SpannerLocation) MarshalJSON() ([]byte, error) { - type NoMethod SpannerLocation - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // Status: The `Status` type defines a logical error model that is suitable for // different programming environments, including REST APIs and RPC APIs. It is // used by gRPC (https://github.com/grpc). Each `Status` message contains three @@ -2246,26 +1866,6 @@ func (s StoragePool) MarshalJSON() ([]byte, error) { type SwitchActiveReplicaZoneRequest struct { } -type TenantProjectProxy struct { - ProjectNumbers []string `json:"projectNumbers,omitempty"` - // ForceSendFields is a list of field names (e.g. "ProjectNumbers") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ProjectNumbers") to include in - // API requests with the JSON null value. By default, fields with empty values - // are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s TenantProjectProxy) MarshalJSON() ([]byte, error) { - type NoMethod TenantProjectProxy - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // TieringPolicy: Defines tiering policy for the volume. type TieringPolicy struct { // CoolingThresholdDays: Optional. Time in days to mark the volume's data block @@ -2608,26 +2208,6 @@ func (s *WeeklySchedule) UnmarshalJSON(data []byte) error { return nil } -type ZoneConfiguration struct { - Zone string `json:"zone,omitempty"` - // ForceSendFields is a list of field names (e.g. "Zone") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Zone") to include in API requests - // with the JSON null value. By default, fields with empty values are omitted - // from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s ZoneConfiguration) MarshalJSON() ([]byte, error) { - type NoMethod ZoneConfiguration - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - type ProjectsLocationsGetCall struct { s *Service name string diff --git a/netapp/v1beta1/netapp-api.json b/netapp/v1beta1/netapp-api.json index 1a048b1b959..becf395afae 100644 --- a/netapp/v1beta1/netapp-api.json +++ b/netapp/v1beta1/netapp-api.json @@ -2013,7 +2013,7 @@ } } }, - "revision": "20241002", + "revision": "20241021", "rootUrl": "https://netapp.googleapis.com/", "schemas": { "ActiveDirectory": { @@ -2147,42 +2147,6 @@ }, "type": "object" }, - "AssetLocation": { - "description": "Provides the mapping of a cloud asset to a direct physical location or to a proxy that defines the location on its behalf.", - "id": "AssetLocation", - "properties": { - "ccfeRmsPath": { - "description": "Spanner path of the CCFE RMS database. It is only applicable for CCFE tenants that use CCFE RMS for storing resource metadata.", - "type": "string" - }, - "expected": { - "$ref": "IsolationExpectations", - "description": "Defines the customer expectation around ZI/ZS for this asset and ZI/ZS state of the region at the time of asset creation." - }, - "extraParameters": { - "description": "Defines extra parameters required for specific asset types.", - "items": { - "$ref": "ExtraParameter" - }, - "type": "array" - }, - "locationData": { - "description": "Contains all kinds of physical location definitions for this asset.", - "items": { - "$ref": "LocationData" - }, - "type": "array" - }, - "parentAsset": { - "description": "Defines parents assets if any in order to allow later generation of child_asset_location data via child assets.", - "items": { - "$ref": "CloudAsset" - }, - "type": "array" - } - }, - "type": "object" - }, "Backup": { "description": "A NetApp Backup.", "id": "Backup", @@ -2420,49 +2384,12 @@ }, "type": "object" }, - "BlobstoreLocation": { - "description": "Policy ID that identified data placement in Blobstore as per go/blobstore-user-guide#data-metadata-placement-and-failure-domains", - "id": "BlobstoreLocation", - "properties": { - "policyId": { - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "CancelOperationRequest": { "description": "The request message for Operations.CancelOperation.", "id": "CancelOperationRequest", "properties": {}, "type": "object" }, - "CloudAsset": { - "id": "CloudAsset", - "properties": { - "assetName": { - "type": "string" - }, - "assetType": { - "type": "string" - } - }, - "type": "object" - }, - "CloudAssetComposition": { - "id": "CloudAssetComposition", - "properties": { - "childAsset": { - "items": { - "$ref": "CloudAsset" - }, - "type": "array" - } - }, - "type": "object" - }, "DailySchedule": { "description": "Make a snapshot every day e.g. at 04:00, 05:20, 23:50", "id": "DailySchedule", @@ -2508,18 +2435,6 @@ }, "type": "object" }, - "DirectLocationAssignment": { - "id": "DirectLocationAssignment", - "properties": { - "location": { - "items": { - "$ref": "LocationAssignment" - }, - "type": "array" - } - }, - "type": "object" - }, "EncryptVolumesRequest": { "description": "EncryptVolumesRequest specifies the KMS config to encrypt existing volumes.", "id": "EncryptVolumesRequest", @@ -2540,17 +2455,6 @@ }, "type": "object" }, - "ExtraParameter": { - "description": "Defines parameters that should only be used for specific asset types.", - "id": "ExtraParameter", - "properties": { - "regionalMigDistributionPolicy": { - "$ref": "RegionalMigDistributionPolicy", - "description": "Details about zones used by regional compute.googleapis.com/InstanceGroupManager to create instances." - } - }, - "type": "object" - }, "GoogleProtobufEmpty": { "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": "GoogleProtobufEmpty", @@ -2574,131 +2478,6 @@ }, "type": "object" }, - "IsolationExpectations": { - "id": "IsolationExpectations", - "properties": { - "requirementOverride": { - "$ref": "RequirementOverride", - "description": "Explicit overrides for ZI and ZS requirements to be used for resources that should be excluded from ZI/ZS verification logic." - }, - "ziOrgPolicy": { - "enum": [ - "ZI_UNSPECIFIED", - "ZI_UNKNOWN", - "ZI_NOT_REQUIRED", - "ZI_PREFERRED", - "ZI_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "", - "" - ], - "type": "string" - }, - "ziRegionPolicy": { - "enum": [ - "ZI_REGION_POLICY_UNSPECIFIED", - "ZI_REGION_POLICY_UNKNOWN", - "ZI_REGION_POLICY_NOT_SET", - "ZI_REGION_POLICY_FAIL_OPEN", - "ZI_REGION_POLICY_FAIL_CLOSED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "", - "" - ], - "type": "string" - }, - "ziRegionState": { - "enum": [ - "ZI_REGION_UNSPECIFIED", - "ZI_REGION_UNKNOWN", - "ZI_REGION_NOT_ENABLED", - "ZI_REGION_ENABLED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "" - ], - "type": "string" - }, - "zoneIsolation": { - "deprecated": true, - "description": "Deprecated: use zi_org_policy, zi_region_policy and zi_region_state instead for setting ZI expectations as per go/zicy-publish-physical-location.", - "enum": [ - "ZI_UNSPECIFIED", - "ZI_UNKNOWN", - "ZI_NOT_REQUIRED", - "ZI_PREFERRED", - "ZI_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "", - "" - ], - "type": "string" - }, - "zoneSeparation": { - "deprecated": true, - "description": "Deprecated: use zs_org_policy, and zs_region_stateinstead for setting Zs expectations as per go/zicy-publish-physical-location.", - "enum": [ - "ZS_UNSPECIFIED", - "ZS_UNKNOWN", - "ZS_NOT_REQUIRED", - "ZS_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "" - ], - "type": "string" - }, - "zsOrgPolicy": { - "enum": [ - "ZS_UNSPECIFIED", - "ZS_UNKNOWN", - "ZS_NOT_REQUIRED", - "ZS_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "" - ], - "type": "string" - }, - "zsRegionState": { - "enum": [ - "ZS_REGION_UNSPECIFIED", - "ZS_REGION_UNKNOWN", - "ZS_REGION_NOT_ENABLED", - "ZS_REGION_ENABLED" - ], - "enumDescriptions": [ - "", - "To be used if tracking of the asset ZS-bit is not available", - "", - "" - ], - "type": "string" - } - }, - "type": "object" - }, "KmsConfig": { "description": "KmsConfig is the customer managed encryption key(CMEK) configuration.", "id": "KmsConfig", @@ -3074,64 +2853,6 @@ }, "type": "object" }, - "LocationAssignment": { - "id": "LocationAssignment", - "properties": { - "location": { - "type": "string" - }, - "locationType": { - "enum": [ - "UNSPECIFIED", - "CLUSTER", - "POP", - "CLOUD_ZONE", - "CLOUD_REGION", - "MULTI_REGION_GEO", - "MULTI_REGION_JURISDICTION", - "GLOBAL", - "OTHER" - ], - "enumDescriptions": [ - "", - "1-10: Physical failure domains.", - "", - "11-20: Logical failure domains.", - "", - "", - "", - "", - "" - ], - "type": "string" - } - }, - "type": "object" - }, - "LocationData": { - "id": "LocationData", - "properties": { - "blobstoreLocation": { - "$ref": "BlobstoreLocation" - }, - "childAssetLocation": { - "$ref": "CloudAssetComposition" - }, - "directLocation": { - "$ref": "DirectLocationAssignment" - }, - "gcpProjectProxy": { - "$ref": "TenantProjectProxy" - }, - "placerLocation": { - "$ref": "PlacerLocation" - }, - "spannerLocation": { - "$ref": "SpannerLocation" - } - }, - "type": "object" - }, "LocationMetadata": { "description": "Metadata for a given google.cloud.location.Location.", "id": "LocationMetadata", @@ -3301,36 +3022,6 @@ }, "type": "object" }, - "PlacerLocation": { - "description": "Message describing that the location of the customer resource is tied to placer allocations", - "id": "PlacerLocation", - "properties": { - "placerConfig": { - "description": "Directory with a config related to it in placer (e.g. \"/placer/prod/home/my-root/my-dir\")", - "type": "string" - } - }, - "type": "object" - }, - "RegionalMigDistributionPolicy": { - "description": "To be used for specifying the intended distribution of regional compute.googleapis.com/InstanceGroupManager instances", - "id": "RegionalMigDistributionPolicy", - "properties": { - "targetShape": { - "description": "The shape in which the group converges around distribution of resources. Instance of proto2 enum", - "format": "int32", - "type": "integer" - }, - "zones": { - "description": "Cloud zones used by regional MIG to create instances.", - "items": { - "$ref": "ZoneConfiguration" - }, - "type": "array" - } - }, - "type": "object" - }, "Replication": { "description": "Replication is a nested resource under Volume, that describes a cross-region replication relationship between 2 volumes in different regions.", "id": "Replication", @@ -3459,44 +3150,6 @@ }, "type": "object" }, - "RequirementOverride": { - "id": "RequirementOverride", - "properties": { - "ziOverride": { - "enum": [ - "ZI_UNSPECIFIED", - "ZI_UNKNOWN", - "ZI_NOT_REQUIRED", - "ZI_PREFERRED", - "ZI_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "", - "" - ], - "type": "string" - }, - "zsOverride": { - "enum": [ - "ZS_UNSPECIFIED", - "ZS_UNKNOWN", - "ZS_NOT_REQUIRED", - "ZS_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "" - ], - "type": "string" - } - }, - "type": "object" - }, "RestoreParameters": { "description": "The RestoreParameters if volume is created from a snapshot or backup.", "id": "RestoreParameters", @@ -3687,26 +3340,6 @@ }, "type": "object" }, - "SpannerLocation": { - "id": "SpannerLocation", - "properties": { - "backupName": { - "description": "Set of backups used by the resource with name in the same format as what is available at http://table/spanner_automon.backup_metadata", - "items": { - "type": "string" - }, - "type": "array" - }, - "dbName": { - "description": "Set of databases used by the resource in format /span//", - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "Status": { "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", "id": "Status", @@ -3896,18 +3529,6 @@ "properties": {}, "type": "object" }, - "TenantProjectProxy": { - "id": "TenantProjectProxy", - "properties": { - "projectNumbers": { - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "TieringPolicy": { "description": "Defines tiering policy for the volume.", "id": "TieringPolicy", @@ -4322,15 +3943,6 @@ } }, "type": "object" - }, - "ZoneConfiguration": { - "id": "ZoneConfiguration", - "properties": { - "zone": { - "type": "string" - } - }, - "type": "object" } }, "servicePath": "", diff --git a/netapp/v1beta1/netapp-gen.go b/netapp/v1beta1/netapp-gen.go index 3765034a85f..2436bec3d48 100644 --- a/netapp/v1beta1/netapp-gen.go +++ b/netapp/v1beta1/netapp-gen.go @@ -386,41 +386,6 @@ func (s ActiveDirectory) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// AssetLocation: Provides the mapping of a cloud asset to a direct physical -// location or to a proxy that defines the location on its behalf. -type AssetLocation struct { - // CcfeRmsPath: Spanner path of the CCFE RMS database. It is only applicable - // for CCFE tenants that use CCFE RMS for storing resource metadata. - CcfeRmsPath string `json:"ccfeRmsPath,omitempty"` - // Expected: Defines the customer expectation around ZI/ZS for this asset and - // ZI/ZS state of the region at the time of asset creation. - Expected *IsolationExpectations `json:"expected,omitempty"` - // ExtraParameters: Defines extra parameters required for specific asset types. - ExtraParameters []*ExtraParameter `json:"extraParameters,omitempty"` - // LocationData: Contains all kinds of physical location definitions for this - // asset. - LocationData []*LocationData `json:"locationData,omitempty"` - // ParentAsset: Defines parents assets if any in order to allow later - // generation of child_asset_location data via child assets. - ParentAsset []*CloudAsset `json:"parentAsset,omitempty"` - // ForceSendFields is a list of field names (e.g. "CcfeRmsPath") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "CcfeRmsPath") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s AssetLocation) MarshalJSON() ([]byte, error) { - type NoMethod AssetLocation - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // Backup: A NetApp Backup. type Backup struct { // BackupType: Output only. Type of backup, manually created or created by a @@ -628,73 +593,10 @@ func (s BackupVault) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// BlobstoreLocation: Policy ID that identified data placement in Blobstore as -// per go/blobstore-user-guide#data-metadata-placement-and-failure-domains -type BlobstoreLocation struct { - PolicyId []string `json:"policyId,omitempty"` - // ForceSendFields is a list of field names (e.g. "PolicyId") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "PolicyId") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s BlobstoreLocation) MarshalJSON() ([]byte, error) { - type NoMethod BlobstoreLocation - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // CancelOperationRequest: The request message for Operations.CancelOperation. type CancelOperationRequest struct { } -type CloudAsset struct { - AssetName string `json:"assetName,omitempty"` - AssetType string `json:"assetType,omitempty"` - // ForceSendFields is a list of field names (e.g. "AssetName") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "AssetName") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s CloudAsset) MarshalJSON() ([]byte, error) { - type NoMethod CloudAsset - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -type CloudAssetComposition struct { - ChildAsset []*CloudAsset `json:"childAsset,omitempty"` - // ForceSendFields is a list of field names (e.g. "ChildAsset") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ChildAsset") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s CloudAssetComposition) MarshalJSON() ([]byte, error) { - type NoMethod CloudAssetComposition - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // DailySchedule: Make a snapshot every day e.g. at 04:00, 05:20, 23:50 type DailySchedule struct { // Hour: Set the hour to start the snapshot (0-23), defaults to midnight (0). @@ -774,26 +676,6 @@ func (s DestinationVolumeParameters) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type DirectLocationAssignment struct { - Location []*LocationAssignment `json:"location,omitempty"` - // ForceSendFields is a list of field names (e.g. "Location") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Location") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s DirectLocationAssignment) MarshalJSON() ([]byte, error) { - type NoMethod DirectLocationAssignment - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // EncryptVolumesRequest: EncryptVolumesRequest specifies the KMS config to // encrypt existing volumes. type EncryptVolumesRequest struct { @@ -821,30 +703,6 @@ func (s ExportPolicy) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// ExtraParameter: Defines parameters that should only be used for specific -// asset types. -type ExtraParameter struct { - // RegionalMigDistributionPolicy: Details about zones used by regional - // compute.googleapis.com/InstanceGroupManager to create instances. - RegionalMigDistributionPolicy *RegionalMigDistributionPolicy `json:"regionalMigDistributionPolicy,omitempty"` - // ForceSendFields is a list of field names (e.g. - // "RegionalMigDistributionPolicy") to unconditionally include in API requests. - // By default, fields with empty or default values are omitted from API - // requests. See https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields - // for more details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "RegionalMigDistributionPolicy") - // to include in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s ExtraParameter) MarshalJSON() ([]byte, error) { - type NoMethod ExtraParameter - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleProtobufEmpty: 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: @@ -897,81 +755,6 @@ func (s *HourlySchedule) UnmarshalJSON(data []byte) error { return nil } -type IsolationExpectations struct { - // RequirementOverride: Explicit overrides for ZI and ZS requirements to be - // used for resources that should be excluded from ZI/ZS verification logic. - RequirementOverride *RequirementOverride `json:"requirementOverride,omitempty"` - // Possible values: - // "ZI_UNSPECIFIED" - // "ZI_UNKNOWN" - To be used if tracking is not available - // "ZI_NOT_REQUIRED" - // "ZI_PREFERRED" - // "ZI_REQUIRED" - ZiOrgPolicy string `json:"ziOrgPolicy,omitempty"` - // Possible values: - // "ZI_REGION_POLICY_UNSPECIFIED" - // "ZI_REGION_POLICY_UNKNOWN" - To be used if tracking is not available - // "ZI_REGION_POLICY_NOT_SET" - // "ZI_REGION_POLICY_FAIL_OPEN" - // "ZI_REGION_POLICY_FAIL_CLOSED" - ZiRegionPolicy string `json:"ziRegionPolicy,omitempty"` - // Possible values: - // "ZI_REGION_UNSPECIFIED" - // "ZI_REGION_UNKNOWN" - To be used if tracking is not available - // "ZI_REGION_NOT_ENABLED" - // "ZI_REGION_ENABLED" - ZiRegionState string `json:"ziRegionState,omitempty"` - // ZoneIsolation: Deprecated: use zi_org_policy, zi_region_policy and - // zi_region_state instead for setting ZI expectations as per - // go/zicy-publish-physical-location. - // - // Possible values: - // "ZI_UNSPECIFIED" - // "ZI_UNKNOWN" - To be used if tracking is not available - // "ZI_NOT_REQUIRED" - // "ZI_PREFERRED" - // "ZI_REQUIRED" - ZoneIsolation string `json:"zoneIsolation,omitempty"` - // ZoneSeparation: Deprecated: use zs_org_policy, and zs_region_stateinstead - // for setting Zs expectations as per go/zicy-publish-physical-location. - // - // Possible values: - // "ZS_UNSPECIFIED" - // "ZS_UNKNOWN" - To be used if tracking is not available - // "ZS_NOT_REQUIRED" - // "ZS_REQUIRED" - ZoneSeparation string `json:"zoneSeparation,omitempty"` - // Possible values: - // "ZS_UNSPECIFIED" - // "ZS_UNKNOWN" - To be used if tracking is not available - // "ZS_NOT_REQUIRED" - // "ZS_REQUIRED" - ZsOrgPolicy string `json:"zsOrgPolicy,omitempty"` - // Possible values: - // "ZS_REGION_UNSPECIFIED" - // "ZS_REGION_UNKNOWN" - To be used if tracking of the asset ZS-bit is not - // available - // "ZS_REGION_NOT_ENABLED" - // "ZS_REGION_ENABLED" - ZsRegionState string `json:"zsRegionState,omitempty"` - // ForceSendFields is a list of field names (e.g. "RequirementOverride") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "RequirementOverride") to include - // in API requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s IsolationExpectations) MarshalJSON() ([]byte, error) { - type NoMethod IsolationExpectations - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // KmsConfig: KmsConfig is the customer managed encryption key(CMEK) // configuration. type KmsConfig struct { @@ -1409,62 +1192,6 @@ func (s Location) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type LocationAssignment struct { - Location string `json:"location,omitempty"` - // Possible values: - // "UNSPECIFIED" - // "CLUSTER" - 1-10: Physical failure domains. - // "POP" - // "CLOUD_ZONE" - 11-20: Logical failure domains. - // "CLOUD_REGION" - // "MULTI_REGION_GEO" - // "MULTI_REGION_JURISDICTION" - // "GLOBAL" - // "OTHER" - LocationType string `json:"locationType,omitempty"` - // ForceSendFields is a list of field names (e.g. "Location") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Location") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s LocationAssignment) MarshalJSON() ([]byte, error) { - type NoMethod LocationAssignment - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -type LocationData struct { - BlobstoreLocation *BlobstoreLocation `json:"blobstoreLocation,omitempty"` - ChildAssetLocation *CloudAssetComposition `json:"childAssetLocation,omitempty"` - DirectLocation *DirectLocationAssignment `json:"directLocation,omitempty"` - GcpProjectProxy *TenantProjectProxy `json:"gcpProjectProxy,omitempty"` - PlacerLocation *PlacerLocation `json:"placerLocation,omitempty"` - SpannerLocation *SpannerLocation `json:"spannerLocation,omitempty"` - // ForceSendFields is a list of field names (e.g. "BlobstoreLocation") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "BlobstoreLocation") to include in - // API requests with the JSON null value. By default, fields with empty values - // are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s LocationData) MarshalJSON() ([]byte, error) { - type NoMethod LocationData - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // LocationMetadata: Metadata for a given google.cloud.location.Location. type LocationMetadata struct { // SupportedServiceLevels: Output only. Supported service levels in a location. @@ -1663,57 +1390,6 @@ func (s OperationMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// PlacerLocation: Message describing that the location of the customer -// resource is tied to placer allocations -type PlacerLocation struct { - // PlacerConfig: Directory with a config related to it in placer (e.g. - // "/placer/prod/home/my-root/my-dir") - PlacerConfig string `json:"placerConfig,omitempty"` - // ForceSendFields is a list of field names (e.g. "PlacerConfig") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "PlacerConfig") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s PlacerLocation) MarshalJSON() ([]byte, error) { - type NoMethod PlacerLocation - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// RegionalMigDistributionPolicy: To be used for specifying the intended -// distribution of regional compute.googleapis.com/InstanceGroupManager -// instances -type RegionalMigDistributionPolicy struct { - // TargetShape: The shape in which the group converges around distribution of - // resources. Instance of proto2 enum - TargetShape int64 `json:"targetShape,omitempty"` - // Zones: Cloud zones used by regional MIG to create instances. - Zones []*ZoneConfiguration `json:"zones,omitempty"` - // ForceSendFields is a list of field names (e.g. "TargetShape") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "TargetShape") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s RegionalMigDistributionPolicy) MarshalJSON() ([]byte, error) { - type NoMethod RegionalMigDistributionPolicy - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // Replication: Replication is a nested resource under Volume, that describes a // cross-region replication relationship between 2 volumes in different // regions. @@ -1803,38 +1479,6 @@ func (s Replication) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type RequirementOverride struct { - // Possible values: - // "ZI_UNSPECIFIED" - // "ZI_UNKNOWN" - To be used if tracking is not available - // "ZI_NOT_REQUIRED" - // "ZI_PREFERRED" - // "ZI_REQUIRED" - ZiOverride string `json:"ziOverride,omitempty"` - // Possible values: - // "ZS_UNSPECIFIED" - // "ZS_UNKNOWN" - To be used if tracking is not available - // "ZS_NOT_REQUIRED" - // "ZS_REQUIRED" - ZsOverride string `json:"zsOverride,omitempty"` - // ForceSendFields is a list of field names (e.g. "ZiOverride") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ZiOverride") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s RequirementOverride) MarshalJSON() ([]byte, error) { - type NoMethod RequirementOverride - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // RestoreParameters: The RestoreParameters if volume is created from a // snapshot or backup. type RestoreParameters struct { @@ -2058,30 +1702,6 @@ func (s SnapshotPolicy) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type SpannerLocation struct { - // BackupName: Set of backups used by the resource with name in the same format - // as what is available at http://table/spanner_automon.backup_metadata - BackupName []string `json:"backupName,omitempty"` - // DbName: Set of databases used by the resource in format /span// - DbName []string `json:"dbName,omitempty"` - // ForceSendFields is a list of field names (e.g. "BackupName") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "BackupName") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s SpannerLocation) MarshalJSON() ([]byte, error) { - type NoMethod SpannerLocation - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // Status: The `Status` type defines a logical error model that is suitable for // different programming environments, including REST APIs and RPC APIs. It is // used by gRPC (https://github.com/grpc). Each `Status` message contains three @@ -2246,26 +1866,6 @@ func (s StoragePool) MarshalJSON() ([]byte, error) { type SwitchActiveReplicaZoneRequest struct { } -type TenantProjectProxy struct { - ProjectNumbers []string `json:"projectNumbers,omitempty"` - // ForceSendFields is a list of field names (e.g. "ProjectNumbers") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ProjectNumbers") to include in - // API requests with the JSON null value. By default, fields with empty values - // are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s TenantProjectProxy) MarshalJSON() ([]byte, error) { - type NoMethod TenantProjectProxy - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // TieringPolicy: Defines tiering policy for the volume. type TieringPolicy struct { // CoolingThresholdDays: Optional. Time in days to mark the volume's data block @@ -2608,26 +2208,6 @@ func (s *WeeklySchedule) UnmarshalJSON(data []byte) error { return nil } -type ZoneConfiguration struct { - Zone string `json:"zone,omitempty"` - // ForceSendFields is a list of field names (e.g. "Zone") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Zone") to include in API requests - // with the JSON null value. By default, fields with empty values are omitted - // from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s ZoneConfiguration) MarshalJSON() ([]byte, error) { - type NoMethod ZoneConfiguration - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - type ProjectsLocationsGetCall struct { s *Service name string diff --git a/networkmanagement/v1/networkmanagement-api.json b/networkmanagement/v1/networkmanagement-api.json index 01cb394b130..1cf303fac25 100644 --- a/networkmanagement/v1/networkmanagement-api.json +++ b/networkmanagement/v1/networkmanagement-api.json @@ -591,7 +591,7 @@ } } }, - "revision": "20241009", + "revision": "20241016", "rootUrl": "https://networkmanagement.googleapis.com/", "schemas": { "AbortInfo": { @@ -616,6 +616,7 @@ "PERMISSION_DENIED", "PERMISSION_DENIED_NO_CLOUD_NAT_CONFIGS", "PERMISSION_DENIED_NO_NEG_ENDPOINT_CONFIGS", + "PERMISSION_DENIED_NO_CLOUD_ROUTER_CONFIGS", "NO_SOURCE_LOCATION", "INVALID_ARGUMENT", "TRACE_TOO_LONG", @@ -672,6 +673,7 @@ false, false, false, + false, false ], "enumDescriptions": [ @@ -690,6 +692,7 @@ "Aborted because user lacks permission to access all or part of the network configurations required to run the test.", "Aborted because user lacks permission to access Cloud NAT configs required to run the test.", "Aborted because user lacks permission to access Network endpoint group endpoint configs required to run the test.", + "Aborted because user lacks permission to access Cloud Router configs required to run the test.", "Aborted because no valid source or destination endpoint is derived from the input test request.", "Aborted because the source or destination endpoint specified in the request is invalid. Some examples: - The request might contain malformed resource URI, project ID, or IP address. - The request might contain inconsistent information (for example, the request might include both the instance and the network, but the instance might not have a NIC in that network).", "Aborted because the number of steps in the trace exceeds a certain limit. It might be caused by a routing loop.", diff --git a/networkmanagement/v1/networkmanagement-gen.go b/networkmanagement/v1/networkmanagement-gen.go index 0aaf689d693..6af15061b3e 100644 --- a/networkmanagement/v1/networkmanagement-gen.go +++ b/networkmanagement/v1/networkmanagement-gen.go @@ -248,6 +248,8 @@ type AbortInfo struct { // "PERMISSION_DENIED_NO_NEG_ENDPOINT_CONFIGS" - Aborted because user lacks // permission to access Network endpoint group endpoint configs required to run // the test. + // "PERMISSION_DENIED_NO_CLOUD_ROUTER_CONFIGS" - Aborted because user lacks + // permission to access Cloud Router configs required to run the test. // "NO_SOURCE_LOCATION" - Aborted because no valid source or destination // endpoint is derived from the input test request. // "INVALID_ARGUMENT" - Aborted because the source or destination endpoint diff --git a/networkmanagement/v1beta1/networkmanagement-api.json b/networkmanagement/v1beta1/networkmanagement-api.json index ea9079b5ad3..dd33f9834c8 100644 --- a/networkmanagement/v1beta1/networkmanagement-api.json +++ b/networkmanagement/v1beta1/networkmanagement-api.json @@ -758,7 +758,7 @@ } } }, - "revision": "20241009", + "revision": "20241016", "rootUrl": "https://networkmanagement.googleapis.com/", "schemas": { "AbortInfo": { @@ -783,6 +783,7 @@ "PERMISSION_DENIED", "PERMISSION_DENIED_NO_CLOUD_NAT_CONFIGS", "PERMISSION_DENIED_NO_NEG_ENDPOINT_CONFIGS", + "PERMISSION_DENIED_NO_CLOUD_ROUTER_CONFIGS", "NO_SOURCE_LOCATION", "INVALID_ARGUMENT", "TRACE_TOO_LONG", @@ -839,6 +840,7 @@ false, false, false, + false, false ], "enumDescriptions": [ @@ -857,6 +859,7 @@ "Aborted because user lacks permission to access all or part of the network configurations required to run the test.", "Aborted because user lacks permission to access Cloud NAT configs required to run the test.", "Aborted because user lacks permission to access Network endpoint group endpoint configs required to run the test.", + "Aborted because user lacks permission to access Cloud Router configs required to run the test.", "Aborted because no valid source or destination endpoint is derived from the input test request.", "Aborted because the source or destination endpoint specified in the request is invalid. Some examples: - The request might contain malformed resource URI, project ID, or IP address. - The request might contain inconsistent information (for example, the request might include both the instance and the network, but the instance might not have a NIC in that network).", "Aborted because the number of steps in the trace exceeds a certain limit. It might be caused by a routing loop.", @@ -1066,11 +1069,6 @@ "description": "Location in which this revision is deployed.", "type": "string" }, - "serviceName": { - "deprecated": true, - "description": "ID of Cloud Run Service this revision belongs to. Was never set, is not exported to v1 proto and public protos. Do not export to v1beta1 public proto.", - "type": "string" - }, "serviceUri": { "description": "URI of Cloud Run service this revision belongs to.", "type": "string" @@ -3334,6 +3332,21 @@ ], "type": "string" }, + "targetResourceState": { + "description": "Output only. A diagnostic bit - describes the state of the configured target resource for diagnostic purposes.", + "enum": [ + "TARGET_RESOURCE_STATE_UNSPECIFIED", + "TARGET_RESOURCE_EXISTS", + "TARGET_RESOURCE_DOES_NOT_EXIST" + ], + "enumDescriptions": [ + "Unspecified target resource state.", + "Indicates that the target resource exists.", + "Indicates that the target resource does not exist." + ], + "readOnly": true, + "type": "string" + }, "updateTime": { "description": "Output only. The time the config was updated.", "format": "google-datetime", diff --git a/networkmanagement/v1beta1/networkmanagement-gen.go b/networkmanagement/v1beta1/networkmanagement-gen.go index a1ce037d841..297d2988ad5 100644 --- a/networkmanagement/v1beta1/networkmanagement-gen.go +++ b/networkmanagement/v1beta1/networkmanagement-gen.go @@ -260,6 +260,8 @@ type AbortInfo struct { // "PERMISSION_DENIED_NO_NEG_ENDPOINT_CONFIGS" - Aborted because user lacks // permission to access Network endpoint group endpoint configs required to run // the test. + // "PERMISSION_DENIED_NO_CLOUD_ROUTER_CONFIGS" - Aborted because user lacks + // permission to access Cloud Router configs required to run the test. // "NO_SOURCE_LOCATION" - Aborted because no valid source or destination // endpoint is derived from the input test request. // "INVALID_ARGUMENT" - Aborted because the source or destination endpoint @@ -647,10 +649,6 @@ type CloudRunRevisionInfo struct { DisplayName string `json:"displayName,omitempty"` // Location: Location in which this revision is deployed. Location string `json:"location,omitempty"` - // ServiceName: ID of Cloud Run Service this revision belongs to. Was never - // set, is not exported to v1 proto and public protos. Do not export to v1beta1 - // public proto. - ServiceName string `json:"serviceName,omitempty"` // ServiceUri: URI of Cloud Run service this revision belongs to. ServiceUri string `json:"serviceUri,omitempty"` // Uri: URI of a Cloud Run revision. @@ -3054,6 +3052,15 @@ type VpcFlowLogsConfig struct { // "ENABLED" - When ENABLED, this configuration will generate logs. // "DISABLED" - When DISABLED, this configuration will not generate logs. State string `json:"state,omitempty"` + // TargetResourceState: Output only. A diagnostic bit - describes the state of + // the configured target resource for diagnostic purposes. + // + // Possible values: + // "TARGET_RESOURCE_STATE_UNSPECIFIED" - Unspecified target resource state. + // "TARGET_RESOURCE_EXISTS" - Indicates that the target resource exists. + // "TARGET_RESOURCE_DOES_NOT_EXIST" - Indicates that the target resource does + // not exist. + TargetResourceState string `json:"targetResourceState,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: diff --git a/networkservices/v1/networkservices-api.json b/networkservices/v1/networkservices-api.json index 4da34e5db88..65f94ffa521 100644 --- a/networkservices/v1/networkservices-api.json +++ b/networkservices/v1/networkservices-api.json @@ -1976,7 +1976,7 @@ ], "parameters": { "name": { - "description": "Required. Name of the ServiceLbPolicy resource. It matches pattern `projects/{project}/locations/{location}/serviceLbPolicies/{service_lb_policy_name}`.", + "description": "Identifier. Name of the ServiceLbPolicy resource. It matches pattern `projects/{project}/locations/{location}/serviceLbPolicies/{service_lb_policy_name}`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/serviceLbPolicies/[^/]+$", "required": true, @@ -2315,13 +2315,310 @@ ] } } + }, + "wasmPlugins": { + "methods": { + "create": { + "description": "Creates a new `WasmPlugin` resource in a given project and location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/wasmPlugins", + "httpMethod": "POST", + "id": "networkservices.projects.locations.wasmPlugins.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent resource of the `WasmPlugin` resource. Must be in the format `projects/{project}/locations/global`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "wasmPluginId": { + "description": "Required. User-provided ID of the `WasmPlugin` resource to be created.", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+parent}/wasmPlugins", + "request": { + "$ref": "WasmPlugin" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes the specified `WasmPlugin` resource.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/wasmPlugins/{wasmPluginsId}", + "httpMethod": "DELETE", + "id": "networkservices.projects.locations.wasmPlugins.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. A name of the `WasmPlugin` resource to delete. Must be in the format `projects/{project}/locations/global/wasmPlugins/{wasm_plugin}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/wasmPlugins/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets details of the specified `WasmPlugin` resource.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/wasmPlugins/{wasmPluginsId}", + "httpMethod": "GET", + "id": "networkservices.projects.locations.wasmPlugins.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. A name of the `WasmPlugin` resource to get. Must be in the format `projects/{project}/locations/global/wasmPlugins/{wasm_plugin}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/wasmPlugins/[^/]+$", + "required": true, + "type": "string" + }, + "view": { + "description": "Determine how much data should be returned by the API. See [AIP-157](https://google.aip.dev/157).", + "enum": [ + "WASM_PLUGIN_VIEW_UNSPECIFIED", + "WASM_PLUGIN_VIEW_BASIC", + "WASM_PLUGIN_VIEW_FULL" + ], + "enumDescriptions": [ + "The default / unset value. The API will default to the BASIC view.", + "Include just WasmPlugin record.", + "Include WasmPlugin record and all its WasmPluginVersions." + ], + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "WasmPlugin" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists `WasmPlugin` resources in a given project and location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/wasmPlugins", + "httpMethod": "GET", + "id": "networkservices.projects.locations.wasmPlugins.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Maximum number of `WasmPlugin` resources to return per call. If not specified, at most 50 `WasmPlugin`s are returned. The maximum value is 1000; values above 1000 are coerced to 1000.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The value returned by the last `ListWasmPluginsResponse` call. Indicates that this is a continuation of a prior `ListWasmPlugins` call, and that the next page of data is to be returned.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The project and location from which the `WasmPlugin` resources are listed, specified in the following format: `projects/{project}/locations/global`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/wasmPlugins", + "response": { + "$ref": "ListWasmPluginsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Updates the parameters of the specified `WasmPlugin` resource.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/wasmPlugins/{wasmPluginsId}", + "httpMethod": "PATCH", + "id": "networkservices.projects.locations.wasmPlugins.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Identifier. Name of the `WasmPlugin` resource in the following format: `projects/{project}/locations/{location}/wasmPlugins/{wasm_plugin}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/wasmPlugins/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Optional. Used to specify the fields to be overwritten in the `WasmPlugin` resource by the update. The fields specified in the `update_mask` field are relative to the resource, not the full request. An omitted `update_mask` field is treated as an implied `update_mask` field equivalent to all fields that are populated (that have a non-empty value). The `update_mask` field supports a special value `*`, which means that each field in the given `WasmPlugin` resource (including the empty ones) replaces the current value.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "WasmPlugin" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, + "resources": { + "versions": { + "methods": { + "create": { + "description": "Creates a new `WasmPluginVersion` resource in a given project and location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/wasmPlugins/{wasmPluginsId}/versions", + "httpMethod": "POST", + "id": "networkservices.projects.locations.wasmPlugins.versions.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent resource of the `WasmPluginVersion` resource. Must be in the format `projects/{project}/locations/global/wasmPlugins/{wasm_plugin}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/wasmPlugins/[^/]+$", + "required": true, + "type": "string" + }, + "wasmPluginVersionId": { + "description": "Required. User-provided ID of the `WasmPluginVersion` resource to be created.", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+parent}/versions", + "request": { + "$ref": "WasmPluginVersion" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes the specified `WasmPluginVersion` resource.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/wasmPlugins/{wasmPluginsId}/versions/{versionsId}", + "httpMethod": "DELETE", + "id": "networkservices.projects.locations.wasmPlugins.versions.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. A name of the `WasmPluginVersion` resource to delete. Must be in the format `projects/{project}/locations/global/wasmPlugins/{wasm_plugin}/versions/{wasm_plugin_version}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/wasmPlugins/[^/]+/versions/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets details of the specified `WasmPluginVersion` resource.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/wasmPlugins/{wasmPluginsId}/versions/{versionsId}", + "httpMethod": "GET", + "id": "networkservices.projects.locations.wasmPlugins.versions.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. A name of the `WasmPluginVersion` resource to get. Must be in the format `projects/{project}/locations/global/wasmPlugins/{wasm_plugin}/versions/{wasm_plugin_version}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/wasmPlugins/[^/]+/versions/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "WasmPluginVersion" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists `WasmPluginVersion` resources in a given project and location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/wasmPlugins/{wasmPluginsId}/versions", + "httpMethod": "GET", + "id": "networkservices.projects.locations.wasmPlugins.versions.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Maximum number of `WasmPluginVersion` resources to return per call. If not specified, at most 50 `WasmPluginVersion`s are returned. The maximum value is 1000; values above 1000 are coerced to 1000.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The value returned by the last `ListWasmPluginVersionsResponse` call. Indicates that this is a continuation of a prior `ListWasmPluginVersions` call, and that the next page of data is to be returned.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The `WasmPlugin` resource whose `WasmPluginVersion`s are listed, specified in the following format: `projects/{project}/locations/global/wasmPlugins/{wasm_plugin}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/wasmPlugins/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/versions", + "response": { + "$ref": "ListWasmPluginVersionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } } } } } } }, - "revision": "20240919", + "revision": "20241010", "rootUrl": "https://networkservices.googleapis.com/", "schemas": { "AuditConfig": { @@ -2578,7 +2875,7 @@ "id": "ExtensionChainExtension", "properties": { "authority": { - "description": "Optional. The `:authority` header in the gRPC request sent from Envoy to the extension service. Required for Callout extensions.", + "description": "Optional. The `:authority` header in the gRPC request sent from Envoy to the extension service. Required for Callout extensions. This field is not supported for plugin extensions and must not be set.", "type": "string" }, "failOpen": { @@ -2592,12 +2889,20 @@ }, "type": "array" }, + "metadata": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Optional. The metadata provided here is included as part of the `metadata_context` (of type `google.protobuf.Struct`) in the `ProcessingRequest` message sent to the extension server. The metadata is available under the namespace `com.google....`. For example: `com.google.lb_traffic_extension.lbtrafficextension1.chain1.ext1`. The following variables are supported in the metadata: `{forwarding_rule_id}` - substituted with the forwarding rule's fully qualified resource name. This field is not supported for plugin extensions and must not be set.", + "type": "object" + }, "name": { "description": "Required. The name for this extension. The name is logged as part of the HTTP request logs. The name must conform with RFC-1034, is restricted to lower-cased letters, numbers and hyphens, and can have a maximum length of 63 characters. Additionally, the first character must be a letter and the last a letter or a number.", "type": "string" }, "service": { - "description": "Required. The reference to the service that runs the extension. Currently only callout extensions are supported here. To configure a callout extension, `service` must be a fully-qualified reference to a [backend service](https://cloud.google.com/compute/docs/reference/rest/v1/backendServices) in the format: `https://www.googleapis.com/compute/v1/projects/{project}/regions/{region}/backendServices/{backendService}` or `https://www.googleapis.com/compute/v1/projects/{project}/global/backendServices/{backendService}`.", + "description": "Required. The reference to the service that runs the extension. Currently only callout extensions are supported here. To configure a callout extension, `service` must be a fully-qualified reference to a [backend service](https://cloud.google.com/compute/docs/reference/rest/v1/backendServices) in the format: `https://www.googleapis.com/compute/v1/projects/{project}/regions/{region}/backendServices/{backendService}` or `https://www.googleapis.com/compute/v1/projects/{project}/global/backendServices/{backendService}`. To configure a plugin extension, this must be a reference to a [wasm plugin](https://cloud.google.com/service-extensions/docs/reference/rest/v1beta1/projects.locations.wasmPlugins) in the format: `projects/{project}/locations/{location}/wasmPlugins/{plugin}` or `//networkservices.googleapis.com/projects/{project}/locations/{location}/wasmPlugins/{wasmPlugin}`.", "type": "string" }, "supportedEvents": { @@ -2626,7 +2931,7 @@ "type": "array" }, "timeout": { - "description": "Optional. Specifies the timeout for each individual message on the stream. The timeout must be between 10-1000 milliseconds. Required for Callout extensions.", + "description": "Optional. Specifies the timeout for each individual message on the stream. The timeout must be between 10-1000 milliseconds. Required for callout extensions. This field is not supported for plugin extensions and must not be set.", "format": "google-duration", "type": "string" } @@ -3690,7 +3995,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Optional. The metadata provided here is included as part of the `metadata_context` (of type `google.protobuf.Struct`) in the `ProcessingRequest` message sent to the extension server. The metadata is available under the namespace `com.google.lb_route_extension.`. The following variables are supported in the metadata Struct: `{forwarding_rule_id}` - substituted with the forwarding rule's fully qualified resource name.", + "description": "Optional. The metadata provided here is included as part of the `metadata_context` (of type `google.protobuf.Struct`) in the `ProcessingRequest` message sent to the extension server. The metadata is available under the namespace `com.google.lb_route_extension.`. The following variables are supported in the metadata Struct: `{forwarding_rule_id}` - substituted with the forwarding rule's fully qualified resource name. This field is not supported for plugin extensions and must not be set.", "type": "object" }, "name": { @@ -3760,7 +4065,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Optional. The metadata provided here is included in the `ProcessingRequest.metadata_context.filter_metadata` map field. The metadata is available under the key `com.google.lb_traffic_extension.`. The following variables are supported in the metadata: `{forwarding_rule_id}` - substituted with the forwarding rule's fully qualified resource name.", + "description": "Optional. The metadata provided here is included in the `ProcessingRequest.metadata_context.filter_metadata` map field. The metadata is available under the key `com.google.lb_traffic_extension.`. The following variables are supported in the metadata: `{forwarding_rule_id}` - substituted with the forwarding rule's fully qualified resource name. This field is not supported for plugin extensions and must not be set.", "type": "object" }, "name": { @@ -4031,6 +4336,42 @@ }, "type": "object" }, + "ListWasmPluginVersionsResponse": { + "description": "Response returned by the `ListWasmPluginVersions` method.", + "id": "ListWasmPluginVersionsResponse", + "properties": { + "nextPageToken": { + "description": "If there might be more results than those appearing in this response, then `next_page_token` is included. To get the next set of results, call this method again using the value of `next_page_token` as `page_token`.", + "type": "string" + }, + "wasmPluginVersions": { + "description": "List of `WasmPluginVersion` resources.", + "items": { + "$ref": "WasmPluginVersion" + }, + "type": "array" + } + }, + "type": "object" + }, + "ListWasmPluginsResponse": { + "description": "Response returned by the `ListWasmPlugins` method.", + "id": "ListWasmPluginsResponse", + "properties": { + "nextPageToken": { + "description": "If there might be more results than those appearing in this response, then `next_page_token` is included. To get the next set of results, call this method again using the value of `next_page_token` as `page_token`.", + "type": "string" + }, + "wasmPlugins": { + "description": "List of `WasmPlugin` resources.", + "items": { + "$ref": "WasmPlugin" + }, + "type": "array" + } + }, + "type": "object" + }, "Location": { "description": "A resource that represents a Google Cloud location.", "id": "Location", @@ -4369,7 +4710,7 @@ "type": "string" }, "name": { - "description": "Required. Name of the ServiceLbPolicy resource. It matches pattern `projects/{project}/locations/{location}/serviceLbPolicies/{service_lb_policy_name}`.", + "description": "Identifier. Name of the ServiceLbPolicy resource. It matches pattern `projects/{project}/locations/{location}/serviceLbPolicies/{service_lb_policy_name}`.", "type": "string" }, "updateTime": { @@ -4754,6 +5095,223 @@ } }, "type": "object" + }, + "WasmPlugin": { + "description": "`WasmPlugin` is a resource representing a service executing a customer-provided Wasm module.", + "id": "WasmPlugin", + "properties": { + "createTime": { + "description": "Output only. The timestamp when the resource was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "Optional. A human-readable description of the resource.", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Set of labels associated with the `WasmPlugin` resource. The format must comply with [the following requirements](/compute/docs/labeling-resources#requirements).", + "type": "object" + }, + "logConfig": { + "$ref": "WasmPluginLogConfig", + "description": "Optional. Specifies the logging options for the activity performed by this `WasmPlugin`. If logging is enabled, plugin logs are exported to Cloud Logging. Note that the settings relate to the logs generated by using logging statements in your Wasm code." + }, + "mainVersionId": { + "description": "Optional. The ID of the `WasmPluginVersion` resource that is the currently serving one. The version referred to must be a child of this `WasmPlugin` resource.", + "type": "string" + }, + "name": { + "description": "Identifier. Name of the `WasmPlugin` resource in the following format: `projects/{project}/locations/{location}/wasmPlugins/{wasm_plugin}`.", + "type": "string" + }, + "updateTime": { + "description": "Output only. The timestamp when the resource was updated.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "usedBy": { + "description": "Output only. List of all [Service Extensions](https://cloud.google.com/service-extensions/docs/overview) that use this `WasmPlugin`.", + "items": { + "$ref": "WasmPluginUsedBy" + }, + "readOnly": true, + "type": "array" + }, + "versions": { + "additionalProperties": { + "$ref": "WasmPluginVersionDetails" + }, + "description": "Optional. All versions of this `WasmPlugin` in the key-value format. The key is the resource ID, the value is the `VersionDetails`. Allows to create or update `WasmPlugin` and its WasmPluginVersions in a single request. When the `main_version_id` field is not empty it must point to one of the VersionDetails in the map. If provided in the update request, the new versions replace the previous set. Any version omitted from the `versions` will be removed. Since the `WasmPluginVersion` resource is immutable, if the WasmPluginVersion with the same name already exists and differs the Update request will fail. Note: In the GET request, this field is populated only if the GetWasmPluginRequest.view is set to WASM_PLUGIN_VIEW_FULL.", + "type": "object" + } + }, + "type": "object" + }, + "WasmPluginLogConfig": { + "description": "Specifies the logging options for the activity performed by this `WasmPlugin`. If logging is enabled, plugin logs are exported to Cloud Logging.", + "id": "WasmPluginLogConfig", + "properties": { + "enable": { + "description": "Optional. Specifies whether to enable logging for activity by this `WasmPlugin`. Defaults to `false`.", + "type": "boolean" + }, + "minLogLevel": { + "description": "Non-empty default. Specificies the lowest level of the plugin logs that are exported to Cloud Logging. This setting relates to the logs generated by using logging statements in your Wasm code. This field is can be set only if logging is enabled for the `WasmPlugin` resource. If the field is not provided when logging is enabled, it is set to `INFO` by default.", + "enum": [ + "LOG_LEVEL_UNSPECIFIED", + "TRACE", + "DEBUG", + "INFO", + "WARN", + "ERROR", + "CRITICAL" + ], + "enumDescriptions": [ + "Unspecified value.", + "Report logs with TRACE level and above.", + "Report logs with DEBUG level and above.", + "Report logs with INFO level and above.", + "Report logs with WARN level and above.", + "Report logs with ERROR level and above.", + "Report logs with CRITICAL level only." + ], + "type": "string" + }, + "sampleRate": { + "description": "Non-empty default. Configures the sampling rate of activity logs, where `1.0` means all logged activity is reported and `0.0` means no activity is reported. A floating point value between `0.0` and `1.0` indicates that a percentage of log messages is stored. The default value when logging is enabled is `1.0`. The value of the field must be between `0` and `1` (inclusive). This field can only be specified if logging is enabled for this `WasmPlugin`.", + "format": "float", + "type": "number" + } + }, + "type": "object" + }, + "WasmPluginUsedBy": { + "description": "Defines a resource that uses the `WasmPlugin`.", + "id": "WasmPluginUsedBy", + "properties": { + "name": { + "description": "Output only. Full name of the resource https://google.aip.dev/122#full-resource-names, e.g. `//networkservices.googleapis.com/projects/{project}/locations/{location}/lbRouteExtensions/{extension}`", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "WasmPluginVersion": { + "description": "A single immutable version of a `WasmPlugin`. Defines the Wasm module used and optionally its runtime config.", + "id": "WasmPluginVersion", + "properties": { + "createTime": { + "description": "Output only. The timestamp when the resource was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "Optional. A human-readable description of the resource.", + "type": "string" + }, + "imageDigest": { + "description": "Output only. The resolved digest for the image specified in `image`. The digest is resolved during the creation of `WasmPluginVersion` resource. This field holds the digest value regardless of whether a tag or digest was originally specified in the `image` field.", + "readOnly": true, + "type": "string" + }, + "imageUri": { + "description": "Optional. URI of the container image containing the Wasm plugin, stored in the Artifact Registry. When a new `WasmPluginVersion` resource is created, the digest of the container image is saved in the `image_digest` field. When downloading an image, the digest value is used instead of an image tag.", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Set of labels associated with the `WasmPluginVersion` resource.", + "type": "object" + }, + "name": { + "description": "Identifier. Name of the `WasmPluginVersion` resource in the following format: `projects/{project}/locations/{location}/wasmPlugins/{wasm_plugin}/ versions/{wasm_plugin_version}`.", + "type": "string" + }, + "pluginConfigData": { + "description": "Configuration for the Wasm plugin. The configuration is provided to the Wasm plugin at runtime through the `ON_CONFIGURE` callback. When a new `WasmPluginVersion` resource is created, the digest of the contents is saved in the `plugin_config_digest` field.", + "format": "byte", + "type": "string" + }, + "pluginConfigDigest": { + "description": "Output only. This field holds the digest (usually checksum) value for the plugin configuration. The value is calculated based on the contents of the `plugin_config_data` or the container image defined by the `plugin_config_uri` field.", + "readOnly": true, + "type": "string" + }, + "pluginConfigUri": { + "description": "URI of the Wasm plugin configuration stored in the Artifact Registry. The configuration is provided to the plugin at runtime through the `ON_CONFIGURE` callback. The container image must contain only a single file with the name `plugin.config`. When a new `WasmPluginVersion` resource is created, the digest of the container image is saved in the `plugin_config_digest` field.", + "type": "string" + }, + "updateTime": { + "description": "Output only. The timestamp when the resource was updated.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "WasmPluginVersionDetails": { + "description": "Details of a `WasmPluginVersion` resource to be inlined in the `WasmPlugin` resource.", + "id": "WasmPluginVersionDetails", + "properties": { + "createTime": { + "description": "Output only. The timestamp when the resource was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "Optional. A human-readable description of the resource.", + "type": "string" + }, + "imageDigest": { + "description": "Output only. The resolved digest for the image specified in `image`. The digest is resolved during the creation of a `WasmPluginVersion` resource. This field holds the digest value regardless of whether a tag or digest was originally specified in the `image` field.", + "readOnly": true, + "type": "string" + }, + "imageUri": { + "description": "Optional. URI of the container image containing the Wasm module, stored in the Artifact Registry. The container image must contain only a single file with the name `plugin.wasm`. When a new `WasmPluginVersion` resource is created, the URI gets resolved to an image digest and saved in the `image_digest` field.", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Set of labels associated with the `WasmPluginVersion` resource.", + "type": "object" + }, + "pluginConfigData": { + "description": "Configuration for the Wasm plugin. The configuration is provided to the Wasm plugin at runtime through the `ON_CONFIGURE` callback. When a new `WasmPluginVersion` version is created, the digest of the contents is saved in the `plugin_config_digest` field.", + "format": "byte", + "type": "string" + }, + "pluginConfigDigest": { + "description": "Output only. This field holds the digest (usually checksum) value for the plugin configuration. The value is calculated based on the contents of the `plugin_config_data` or the container image defined by the `plugin_config_uri` field.", + "readOnly": true, + "type": "string" + }, + "pluginConfigUri": { + "description": "URI of the WasmPlugin configuration stored in the Artifact Registry. The configuration is provided to the Wasm plugin at runtime through the `ON_CONFIGURE` callback. The container image must contain only a single file with the name `plugin.config`. When a new `WasmPluginVersion` resource is created, the digest of the container image is saved in the `plugin_config_digest` field.", + "type": "string" + }, + "updateTime": { + "description": "Output only. The timestamp when the resource was updated.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" } }, "servicePath": "", diff --git a/networkservices/v1/networkservices-gen.go b/networkservices/v1/networkservices-gen.go index f99f7cd984e..b8305e980f4 100644 --- a/networkservices/v1/networkservices-gen.go +++ b/networkservices/v1/networkservices-gen.go @@ -183,6 +183,7 @@ func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { rs.ServiceLbPolicies = NewProjectsLocationsServiceLbPoliciesService(s) rs.TcpRoutes = NewProjectsLocationsTcpRoutesService(s) rs.TlsRoutes = NewProjectsLocationsTlsRoutesService(s) + rs.WasmPlugins = NewProjectsLocationsWasmPluginsService(s) return rs } @@ -218,6 +219,8 @@ type ProjectsLocationsService struct { TcpRoutes *ProjectsLocationsTcpRoutesService TlsRoutes *ProjectsLocationsTlsRoutesService + + WasmPlugins *ProjectsLocationsWasmPluginsService } func NewProjectsLocationsEdgeCacheKeysetsService(s *Service) *ProjectsLocationsEdgeCacheKeysetsService { @@ -355,6 +358,27 @@ type ProjectsLocationsTlsRoutesService struct { s *Service } +func NewProjectsLocationsWasmPluginsService(s *Service) *ProjectsLocationsWasmPluginsService { + rs := &ProjectsLocationsWasmPluginsService{s: s} + rs.Versions = NewProjectsLocationsWasmPluginsVersionsService(s) + return rs +} + +type ProjectsLocationsWasmPluginsService struct { + s *Service + + Versions *ProjectsLocationsWasmPluginsVersionsService +} + +func NewProjectsLocationsWasmPluginsVersionsService(s *Service) *ProjectsLocationsWasmPluginsVersionsService { + rs := &ProjectsLocationsWasmPluginsVersionsService{s: s} + return rs +} + +type ProjectsLocationsWasmPluginsVersionsService struct { + s *Service +} + // AuditConfig: Specifies the audit configuration for a service. The // configuration determines which permission types are logged, and what // identities, if any, are exempted from logging. An AuditConfig must have one @@ -800,7 +824,8 @@ func (s ExtensionChain) MarshalJSON() ([]byte, error) { // matching request. type ExtensionChainExtension struct { // Authority: Optional. The `:authority` header in the gRPC request sent from - // Envoy to the extension service. Required for Callout extensions. + // Envoy to the extension service. Required for Callout extensions. This field + // is not supported for plugin extensions and must not be set. Authority string `json:"authority,omitempty"` // FailOpen: Optional. Determines how the proxy behaves if the call to the // extension fails or times out. When set to `TRUE`, request or response @@ -817,6 +842,15 @@ type ExtensionChainExtension struct { // extension (from the client or backend). If omitted, all headers are sent. // Each element is a string indicating the header name. ForwardHeaders []string `json:"forwardHeaders,omitempty"` + // Metadata: Optional. The metadata provided here is included as part of the + // `metadata_context` (of type `google.protobuf.Struct`) in the + // `ProcessingRequest` message sent to the extension server. The metadata is + // available under the namespace `com.google....`. For example: + // `com.google.lb_traffic_extension.lbtrafficextension1.chain1.ext1`. The + // following variables are supported in the metadata: `{forwarding_rule_id}` - + // substituted with the forwarding rule's fully qualified resource name. This + // field is not supported for plugin extensions and must not be set. + Metadata googleapi.RawMessage `json:"metadata,omitempty"` // Name: Required. The name for this extension. The name is logged as part of // the HTTP request logs. The name must conform with RFC-1034, is restricted to // lower-cased letters, numbers and hyphens, and can have a maximum length of @@ -832,7 +866,13 @@ type ExtensionChainExtension struct { // `https://www.googleapis.com/compute/v1/projects/{project}/regions/{region}/ba // ckendServices/{backendService}` or // `https://www.googleapis.com/compute/v1/projects/{project}/global/backendServi - // ces/{backendService}`. + // ces/{backendService}`. To configure a plugin extension, this must be a + // reference to a wasm plugin + // (https://cloud.google.com/service-extensions/docs/reference/rest/v1beta1/projects.locations.wasmPlugins) + // in the format: + // `projects/{project}/locations/{location}/wasmPlugins/{plugin}` or + // `//networkservices.googleapis.com/projects/{project}/locations/{location}/was + // mPlugins/{wasmPlugin}`. Service string `json:"service,omitempty"` // SupportedEvents: Optional. A set of events during request or response // processing for which this extension is called. This field is required for @@ -856,7 +896,8 @@ type ExtensionChainExtension struct { SupportedEvents []string `json:"supportedEvents,omitempty"` // Timeout: Optional. Specifies the timeout for each individual message on the // stream. The timeout must be between 10-1000 milliseconds. Required for - // Callout extensions. + // callout extensions. This field is not supported for plugin extensions and + // must not be set. Timeout string `json:"timeout,omitempty"` // ForceSendFields is a list of field names (e.g. "Authority") to // unconditionally include in API requests. By default, fields with empty or @@ -2254,7 +2295,8 @@ type LbRouteExtension struct { // available under the namespace `com.google.lb_route_extension.`. The // following variables are supported in the metadata Struct: // `{forwarding_rule_id}` - substituted with the forwarding rule's fully - // qualified resource name. + // qualified resource name. This field is not supported for plugin extensions + // and must not be set. Metadata googleapi.RawMessage `json:"metadata,omitempty"` // Name: Required. Identifier. Name of the `LbRouteExtension` resource in the // following format: @@ -2327,7 +2369,8 @@ type LbTrafficExtension struct { // `ProcessingRequest.metadata_context.filter_metadata` map field. The metadata // is available under the key `com.google.lb_traffic_extension.`. The following // variables are supported in the metadata: `{forwarding_rule_id}` - - // substituted with the forwarding rule's fully qualified resource name. + // substituted with the forwarding rule's fully qualified resource name. This + // field is not supported for plugin extensions and must not be set. Metadata googleapi.RawMessage `json:"metadata,omitempty"` // Name: Required. Identifier. Name of the `LbTrafficExtension` resource in the // following format: @@ -2750,6 +2793,67 @@ func (s ListTlsRoutesResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ListWasmPluginVersionsResponse: Response returned by the +// `ListWasmPluginVersions` method. +type ListWasmPluginVersionsResponse struct { + // NextPageToken: If there might be more results than those appearing in this + // response, then `next_page_token` is included. To get the next set of + // results, call this method again using the value of `next_page_token` as + // `page_token`. + NextPageToken string `json:"nextPageToken,omitempty"` + // WasmPluginVersions: List of `WasmPluginVersion` resources. + WasmPluginVersions []*WasmPluginVersion `json:"wasmPluginVersions,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 ListWasmPluginVersionsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListWasmPluginVersionsResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ListWasmPluginsResponse: Response returned by the `ListWasmPlugins` method. +type ListWasmPluginsResponse struct { + // NextPageToken: If there might be more results than those appearing in this + // response, then `next_page_token` is included. To get the next set of + // results, call this method again using the value of `next_page_token` as + // `page_token`. + NextPageToken string `json:"nextPageToken,omitempty"` + // WasmPlugins: List of `WasmPlugin` resources. + WasmPlugins []*WasmPlugin `json:"wasmPlugins,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 ListWasmPluginsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListWasmPluginsResponse + 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 @@ -3164,7 +3268,7 @@ type ServiceLbPolicy struct { // "WATERFALL_BY_ZONE" - Attempt to keep traffic in a single zone closest to // the client, before spilling over to other zones. LoadBalancingAlgorithm string `json:"loadBalancingAlgorithm,omitempty"` - // Name: Required. Name of the ServiceLbPolicy resource. It matches pattern + // Name: Identifier. Name of the ServiceLbPolicy resource. It matches pattern // `projects/{project}/locations/{location}/serviceLbPolicies/{service_lb_policy // _name}`. Name string `json:"name,omitempty"` @@ -3736,6 +3840,279 @@ func (s TrafficPortSelector) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// WasmPlugin: `WasmPlugin` is a resource representing a service executing a +// customer-provided Wasm module. +type WasmPlugin struct { + // CreateTime: Output only. The timestamp when the resource was created. + CreateTime string `json:"createTime,omitempty"` + // Description: Optional. A human-readable description of the resource. + Description string `json:"description,omitempty"` + // Labels: Optional. Set of labels associated with the `WasmPlugin` resource. + // The format must comply with the following requirements + // (/compute/docs/labeling-resources#requirements). + Labels map[string]string `json:"labels,omitempty"` + // LogConfig: Optional. Specifies the logging options for the activity + // performed by this `WasmPlugin`. If logging is enabled, plugin logs are + // exported to Cloud Logging. Note that the settings relate to the logs + // generated by using logging statements in your Wasm code. + LogConfig *WasmPluginLogConfig `json:"logConfig,omitempty"` + // MainVersionId: Optional. The ID of the `WasmPluginVersion` resource that is + // the currently serving one. The version referred to must be a child of this + // `WasmPlugin` resource. + MainVersionId string `json:"mainVersionId,omitempty"` + // Name: Identifier. Name of the `WasmPlugin` resource in the following format: + // `projects/{project}/locations/{location}/wasmPlugins/{wasm_plugin}`. + Name string `json:"name,omitempty"` + // UpdateTime: Output only. The timestamp when the resource was updated. + UpdateTime string `json:"updateTime,omitempty"` + // UsedBy: Output only. List of all Service Extensions + // (https://cloud.google.com/service-extensions/docs/overview) that use this + // `WasmPlugin`. + UsedBy []*WasmPluginUsedBy `json:"usedBy,omitempty"` + // Versions: Optional. All versions of this `WasmPlugin` in the key-value + // format. The key is the resource ID, the value is the `VersionDetails`. + // Allows to create or update `WasmPlugin` and its WasmPluginVersions in a + // single request. When the `main_version_id` field is not empty it must point + // to one of the VersionDetails in the map. If provided in the update request, + // the new versions replace the previous set. Any version omitted from the + // `versions` will be removed. Since the `WasmPluginVersion` resource is + // immutable, if the WasmPluginVersion with the same name already exists and + // differs the Update request will fail. Note: In the GET request, this field + // is populated only if the GetWasmPluginRequest.view is set to + // WASM_PLUGIN_VIEW_FULL. + Versions map[string]WasmPluginVersionDetails `json:"versions,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 WasmPlugin) MarshalJSON() ([]byte, error) { + type NoMethod WasmPlugin + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// WasmPluginLogConfig: Specifies the logging options for the activity +// performed by this `WasmPlugin`. If logging is enabled, plugin logs are +// exported to Cloud Logging. +type WasmPluginLogConfig struct { + // Enable: Optional. Specifies whether to enable logging for activity by this + // `WasmPlugin`. Defaults to `false`. + Enable bool `json:"enable,omitempty"` + // MinLogLevel: Non-empty default. Specificies the lowest level of the plugin + // logs that are exported to Cloud Logging. This setting relates to the logs + // generated by using logging statements in your Wasm code. This field is can + // be set only if logging is enabled for the `WasmPlugin` resource. If the + // field is not provided when logging is enabled, it is set to `INFO` by + // default. + // + // Possible values: + // "LOG_LEVEL_UNSPECIFIED" - Unspecified value. + // "TRACE" - Report logs with TRACE level and above. + // "DEBUG" - Report logs with DEBUG level and above. + // "INFO" - Report logs with INFO level and above. + // "WARN" - Report logs with WARN level and above. + // "ERROR" - Report logs with ERROR level and above. + // "CRITICAL" - Report logs with CRITICAL level only. + MinLogLevel string `json:"minLogLevel,omitempty"` + // SampleRate: Non-empty default. Configures the sampling rate of activity + // logs, where `1.0` means all logged activity is reported and `0.0` means no + // activity is reported. A floating point value between `0.0` and `1.0` + // indicates that a percentage of log messages is stored. The default value + // when logging is enabled is `1.0`. The value of the field must be between `0` + // and `1` (inclusive). This field can only be specified if logging is enabled + // for this `WasmPlugin`. + SampleRate float64 `json:"sampleRate,omitempty"` + // ForceSendFields is a list of field names (e.g. "Enable") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Enable") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s WasmPluginLogConfig) MarshalJSON() ([]byte, error) { + type NoMethod WasmPluginLogConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *WasmPluginLogConfig) UnmarshalJSON(data []byte) error { + type NoMethod WasmPluginLogConfig + var s1 struct { + SampleRate gensupport.JSONFloat64 `json:"sampleRate"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.SampleRate = float64(s1.SampleRate) + return nil +} + +// WasmPluginUsedBy: Defines a resource that uses the `WasmPlugin`. +type WasmPluginUsedBy struct { + // Name: Output only. Full name of the resource + // https://google.aip.dev/122#full-resource-names, e.g. + // `//networkservices.googleapis.com/projects/{project}/locations/{location}/lbR + // outeExtensions/{extension}` + 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 WasmPluginUsedBy) MarshalJSON() ([]byte, error) { + type NoMethod WasmPluginUsedBy + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// WasmPluginVersion: A single immutable version of a `WasmPlugin`. Defines the +// Wasm module used and optionally its runtime config. +type WasmPluginVersion struct { + // CreateTime: Output only. The timestamp when the resource was created. + CreateTime string `json:"createTime,omitempty"` + // Description: Optional. A human-readable description of the resource. + Description string `json:"description,omitempty"` + // ImageDigest: Output only. The resolved digest for the image specified in + // `image`. The digest is resolved during the creation of `WasmPluginVersion` + // resource. This field holds the digest value regardless of whether a tag or + // digest was originally specified in the `image` field. + ImageDigest string `json:"imageDigest,omitempty"` + // ImageUri: Optional. URI of the container image containing the Wasm plugin, + // stored in the Artifact Registry. When a new `WasmPluginVersion` resource is + // created, the digest of the container image is saved in the `image_digest` + // field. When downloading an image, the digest value is used instead of an + // image tag. + ImageUri string `json:"imageUri,omitempty"` + // Labels: Optional. Set of labels associated with the `WasmPluginVersion` + // resource. + Labels map[string]string `json:"labels,omitempty"` + // Name: Identifier. Name of the `WasmPluginVersion` resource in the following + // format: `projects/{project}/locations/{location}/wasmPlugins/{wasm_plugin}/ + // versions/{wasm_plugin_version}`. + Name string `json:"name,omitempty"` + // PluginConfigData: Configuration for the Wasm plugin. The configuration is + // provided to the Wasm plugin at runtime through the `ON_CONFIGURE` callback. + // When a new `WasmPluginVersion` resource is created, the digest of the + // contents is saved in the `plugin_config_digest` field. + PluginConfigData string `json:"pluginConfigData,omitempty"` + // PluginConfigDigest: Output only. This field holds the digest (usually + // checksum) value for the plugin configuration. The value is calculated based + // on the contents of the `plugin_config_data` or the container image defined + // by the `plugin_config_uri` field. + PluginConfigDigest string `json:"pluginConfigDigest,omitempty"` + // PluginConfigUri: URI of the Wasm plugin configuration stored in the Artifact + // Registry. The configuration is provided to the plugin at runtime through the + // `ON_CONFIGURE` callback. The container image must contain only a single file + // with the name `plugin.config`. When a new `WasmPluginVersion` resource is + // created, the digest of the container image is saved in the + // `plugin_config_digest` field. + PluginConfigUri string `json:"pluginConfigUri,omitempty"` + // UpdateTime: Output only. The timestamp when the resource was updated. + 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 WasmPluginVersion) MarshalJSON() ([]byte, error) { + type NoMethod WasmPluginVersion + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// WasmPluginVersionDetails: Details of a `WasmPluginVersion` resource to be +// inlined in the `WasmPlugin` resource. +type WasmPluginVersionDetails struct { + // CreateTime: Output only. The timestamp when the resource was created. + CreateTime string `json:"createTime,omitempty"` + // Description: Optional. A human-readable description of the resource. + Description string `json:"description,omitempty"` + // ImageDigest: Output only. The resolved digest for the image specified in + // `image`. The digest is resolved during the creation of a `WasmPluginVersion` + // resource. This field holds the digest value regardless of whether a tag or + // digest was originally specified in the `image` field. + ImageDigest string `json:"imageDigest,omitempty"` + // ImageUri: Optional. URI of the container image containing the Wasm module, + // stored in the Artifact Registry. The container image must contain only a + // single file with the name `plugin.wasm`. When a new `WasmPluginVersion` + // resource is created, the URI gets resolved to an image digest and saved in + // the `image_digest` field. + ImageUri string `json:"imageUri,omitempty"` + // Labels: Optional. Set of labels associated with the `WasmPluginVersion` + // resource. + Labels map[string]string `json:"labels,omitempty"` + // PluginConfigData: Configuration for the Wasm plugin. The configuration is + // provided to the Wasm plugin at runtime through the `ON_CONFIGURE` callback. + // When a new `WasmPluginVersion` version is created, the digest of the + // contents is saved in the `plugin_config_digest` field. + PluginConfigData string `json:"pluginConfigData,omitempty"` + // PluginConfigDigest: Output only. This field holds the digest (usually + // checksum) value for the plugin configuration. The value is calculated based + // on the contents of the `plugin_config_data` or the container image defined + // by the `plugin_config_uri` field. + PluginConfigDigest string `json:"pluginConfigDigest,omitempty"` + // PluginConfigUri: URI of the WasmPlugin configuration stored in the Artifact + // Registry. The configuration is provided to the Wasm plugin at runtime + // through the `ON_CONFIGURE` callback. The container image must contain only a + // single file with the name `plugin.config`. When a new `WasmPluginVersion` + // resource is created, the digest of the container image is saved in the + // `plugin_config_digest` field. + PluginConfigUri string `json:"pluginConfigUri,omitempty"` + // UpdateTime: Output only. The timestamp when the resource was updated. + 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 WasmPluginVersionDetails) MarshalJSON() ([]byte, error) { + type NoMethod WasmPluginVersionDetails + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type ProjectsLocationsGetCall struct { s *Service name string @@ -10558,7 +10935,7 @@ type ProjectsLocationsServiceLbPoliciesPatchCall struct { // Patch: Updates the parameters of a single ServiceLbPolicy. // -// - name: Name of the ServiceLbPolicy resource. It matches pattern +// - name: Identifier. Name of the ServiceLbPolicy resource. It matches pattern // `projects/{project}/locations/{location}/serviceLbPolicies/{service_lb_poli // cy_name}`. func (r *ProjectsLocationsServiceLbPoliciesService) Patch(name string, servicelbpolicy *ServiceLbPolicy) *ProjectsLocationsServiceLbPoliciesPatchCall { @@ -11802,3 +12179,1069 @@ func (c *ProjectsLocationsTlsRoutesPatchCall) Do(opts ...googleapi.CallOption) ( } return ret, nil } + +type ProjectsLocationsWasmPluginsCreateCall struct { + s *Service + parent string + wasmplugin *WasmPlugin + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a new `WasmPlugin` resource in a given project and location. +// +// - parent: The parent resource of the `WasmPlugin` resource. Must be in the +// format `projects/{project}/locations/global`. +func (r *ProjectsLocationsWasmPluginsService) Create(parent string, wasmplugin *WasmPlugin) *ProjectsLocationsWasmPluginsCreateCall { + c := &ProjectsLocationsWasmPluginsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.wasmplugin = wasmplugin + return c +} + +// WasmPluginId sets the optional parameter "wasmPluginId": Required. +// User-provided ID of the `WasmPlugin` resource to be created. +func (c *ProjectsLocationsWasmPluginsCreateCall) WasmPluginId(wasmPluginId string) *ProjectsLocationsWasmPluginsCreateCall { + c.urlParams_.Set("wasmPluginId", wasmPluginId) + 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 *ProjectsLocationsWasmPluginsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsWasmPluginsCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsWasmPluginsCreateCall) Context(ctx context.Context) *ProjectsLocationsWasmPluginsCreateCall { + 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 *ProjectsLocationsWasmPluginsCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsWasmPluginsCreateCall) 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.wasmplugin) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/wasmPlugins") + 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 "networkservices.projects.locations.wasmPlugins.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 *ProjectsLocationsWasmPluginsCreateCall) 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 ProjectsLocationsWasmPluginsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes the specified `WasmPlugin` resource. +// +// - name: A name of the `WasmPlugin` resource to delete. Must be in the format +// `projects/{project}/locations/global/wasmPlugins/{wasm_plugin}`. +func (r *ProjectsLocationsWasmPluginsService) Delete(name string) *ProjectsLocationsWasmPluginsDeleteCall { + c := &ProjectsLocationsWasmPluginsDeleteCall{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 *ProjectsLocationsWasmPluginsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsWasmPluginsDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsWasmPluginsDeleteCall) Context(ctx context.Context) *ProjectsLocationsWasmPluginsDeleteCall { + 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 *ProjectsLocationsWasmPluginsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsWasmPluginsDeleteCall) 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, "v1/{+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 "networkservices.projects.locations.wasmPlugins.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 *ProjectsLocationsWasmPluginsDeleteCall) 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 ProjectsLocationsWasmPluginsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets details of the specified `WasmPlugin` resource. +// +// - name: A name of the `WasmPlugin` resource to get. Must be in the format +// `projects/{project}/locations/global/wasmPlugins/{wasm_plugin}`. +func (r *ProjectsLocationsWasmPluginsService) Get(name string) *ProjectsLocationsWasmPluginsGetCall { + c := &ProjectsLocationsWasmPluginsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// View sets the optional parameter "view": Determine how much data should be +// returned by the API. See AIP-157 (https://google.aip.dev/157). +// +// Possible values: +// +// "WASM_PLUGIN_VIEW_UNSPECIFIED" - The default / unset value. The API will +// +// default to the BASIC view. +// +// "WASM_PLUGIN_VIEW_BASIC" - Include just WasmPlugin record. +// "WASM_PLUGIN_VIEW_FULL" - Include WasmPlugin record and all its +// +// WasmPluginVersions. +func (c *ProjectsLocationsWasmPluginsGetCall) View(view string) *ProjectsLocationsWasmPluginsGetCall { + 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 *ProjectsLocationsWasmPluginsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsWasmPluginsGetCall { + 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 *ProjectsLocationsWasmPluginsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsWasmPluginsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsWasmPluginsGetCall) Context(ctx context.Context) *ProjectsLocationsWasmPluginsGetCall { + 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 *ProjectsLocationsWasmPluginsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsWasmPluginsGetCall) 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/{+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 "networkservices.projects.locations.wasmPlugins.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *WasmPlugin.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 *ProjectsLocationsWasmPluginsGetCall) Do(opts ...googleapi.CallOption) (*WasmPlugin, 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 := &WasmPlugin{ + 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 ProjectsLocationsWasmPluginsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists `WasmPlugin` resources in a given project and location. +// +// - parent: The project and location from which the `WasmPlugin` resources are +// listed, specified in the following format: +// `projects/{project}/locations/global`. +func (r *ProjectsLocationsWasmPluginsService) List(parent string) *ProjectsLocationsWasmPluginsListCall { + c := &ProjectsLocationsWasmPluginsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": Maximum number of +// `WasmPlugin` resources to return per call. If not specified, at most 50 +// `WasmPlugin`s are returned. The maximum value is 1000; values above 1000 are +// coerced to 1000. +func (c *ProjectsLocationsWasmPluginsListCall) PageSize(pageSize int64) *ProjectsLocationsWasmPluginsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The value returned by the +// last `ListWasmPluginsResponse` call. Indicates that this is a continuation +// of a prior `ListWasmPlugins` call, and that the next page of data is to be +// returned. +func (c *ProjectsLocationsWasmPluginsListCall) PageToken(pageToken string) *ProjectsLocationsWasmPluginsListCall { + 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 *ProjectsLocationsWasmPluginsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsWasmPluginsListCall { + 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 *ProjectsLocationsWasmPluginsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsWasmPluginsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsWasmPluginsListCall) Context(ctx context.Context) *ProjectsLocationsWasmPluginsListCall { + 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 *ProjectsLocationsWasmPluginsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsWasmPluginsListCall) 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}/wasmPlugins") + 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 "networkservices.projects.locations.wasmPlugins.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *ListWasmPluginsResponse.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 *ProjectsLocationsWasmPluginsListCall) Do(opts ...googleapi.CallOption) (*ListWasmPluginsResponse, 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 := &ListWasmPluginsResponse{ + 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 *ProjectsLocationsWasmPluginsListCall) Pages(ctx context.Context, f func(*ListWasmPluginsResponse) 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 ProjectsLocationsWasmPluginsPatchCall struct { + s *Service + name string + wasmplugin *WasmPlugin + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates the parameters of the specified `WasmPlugin` resource. +// +// - name: Identifier. Name of the `WasmPlugin` resource in the following +// format: +// `projects/{project}/locations/{location}/wasmPlugins/{wasm_plugin}`. +func (r *ProjectsLocationsWasmPluginsService) Patch(name string, wasmplugin *WasmPlugin) *ProjectsLocationsWasmPluginsPatchCall { + c := &ProjectsLocationsWasmPluginsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.wasmplugin = wasmplugin + return c +} + +// UpdateMask sets the optional parameter "updateMask": Used to specify the +// fields to be overwritten in the `WasmPlugin` resource by the update. The +// fields specified in the `update_mask` field are relative to the resource, +// not the full request. An omitted `update_mask` field is treated as an +// implied `update_mask` field equivalent to all fields that are populated +// (that have a non-empty value). The `update_mask` field supports a special +// value `*`, which means that each field in the given `WasmPlugin` resource +// (including the empty ones) replaces the current value. +func (c *ProjectsLocationsWasmPluginsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsWasmPluginsPatchCall { + 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 *ProjectsLocationsWasmPluginsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsWasmPluginsPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsWasmPluginsPatchCall) Context(ctx context.Context) *ProjectsLocationsWasmPluginsPatchCall { + 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 *ProjectsLocationsWasmPluginsPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsWasmPluginsPatchCall) 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.wasmplugin) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "networkservices.projects.locations.wasmPlugins.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 *ProjectsLocationsWasmPluginsPatchCall) 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 ProjectsLocationsWasmPluginsVersionsCreateCall struct { + s *Service + parent string + wasmpluginversion *WasmPluginVersion + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a new `WasmPluginVersion` resource in a given project and +// location. +// +// - parent: The parent resource of the `WasmPluginVersion` resource. Must be +// in the format +// `projects/{project}/locations/global/wasmPlugins/{wasm_plugin}`. +func (r *ProjectsLocationsWasmPluginsVersionsService) Create(parent string, wasmpluginversion *WasmPluginVersion) *ProjectsLocationsWasmPluginsVersionsCreateCall { + c := &ProjectsLocationsWasmPluginsVersionsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.wasmpluginversion = wasmpluginversion + return c +} + +// WasmPluginVersionId sets the optional parameter "wasmPluginVersionId": +// Required. User-provided ID of the `WasmPluginVersion` resource to be +// created. +func (c *ProjectsLocationsWasmPluginsVersionsCreateCall) WasmPluginVersionId(wasmPluginVersionId string) *ProjectsLocationsWasmPluginsVersionsCreateCall { + c.urlParams_.Set("wasmPluginVersionId", wasmPluginVersionId) + 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 *ProjectsLocationsWasmPluginsVersionsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsWasmPluginsVersionsCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsWasmPluginsVersionsCreateCall) Context(ctx context.Context) *ProjectsLocationsWasmPluginsVersionsCreateCall { + 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 *ProjectsLocationsWasmPluginsVersionsCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsWasmPluginsVersionsCreateCall) 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.wasmpluginversion) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/versions") + 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 "networkservices.projects.locations.wasmPlugins.versions.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 *ProjectsLocationsWasmPluginsVersionsCreateCall) 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 ProjectsLocationsWasmPluginsVersionsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes the specified `WasmPluginVersion` resource. +// +// - name: A name of the `WasmPluginVersion` resource to delete. Must be in the +// format +// `projects/{project}/locations/global/wasmPlugins/{wasm_plugin}/versions/{wa +// sm_plugin_version}`. +func (r *ProjectsLocationsWasmPluginsVersionsService) Delete(name string) *ProjectsLocationsWasmPluginsVersionsDeleteCall { + c := &ProjectsLocationsWasmPluginsVersionsDeleteCall{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 *ProjectsLocationsWasmPluginsVersionsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsWasmPluginsVersionsDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsWasmPluginsVersionsDeleteCall) Context(ctx context.Context) *ProjectsLocationsWasmPluginsVersionsDeleteCall { + 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 *ProjectsLocationsWasmPluginsVersionsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsWasmPluginsVersionsDeleteCall) 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, "v1/{+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 "networkservices.projects.locations.wasmPlugins.versions.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 *ProjectsLocationsWasmPluginsVersionsDeleteCall) 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 ProjectsLocationsWasmPluginsVersionsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets details of the specified `WasmPluginVersion` resource. +// +// - name: A name of the `WasmPluginVersion` resource to get. Must be in the +// format +// `projects/{project}/locations/global/wasmPlugins/{wasm_plugin}/versions/{wa +// sm_plugin_version}`. +func (r *ProjectsLocationsWasmPluginsVersionsService) Get(name string) *ProjectsLocationsWasmPluginsVersionsGetCall { + c := &ProjectsLocationsWasmPluginsVersionsGetCall{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 *ProjectsLocationsWasmPluginsVersionsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsWasmPluginsVersionsGetCall { + 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 *ProjectsLocationsWasmPluginsVersionsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsWasmPluginsVersionsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsWasmPluginsVersionsGetCall) Context(ctx context.Context) *ProjectsLocationsWasmPluginsVersionsGetCall { + 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 *ProjectsLocationsWasmPluginsVersionsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsWasmPluginsVersionsGetCall) 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/{+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 "networkservices.projects.locations.wasmPlugins.versions.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *WasmPluginVersion.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 *ProjectsLocationsWasmPluginsVersionsGetCall) Do(opts ...googleapi.CallOption) (*WasmPluginVersion, 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 := &WasmPluginVersion{ + 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 ProjectsLocationsWasmPluginsVersionsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists `WasmPluginVersion` resources in a given project and location. +// +// - parent: The `WasmPlugin` resource whose `WasmPluginVersion`s are listed, +// specified in the following format: +// `projects/{project}/locations/global/wasmPlugins/{wasm_plugin}`. +func (r *ProjectsLocationsWasmPluginsVersionsService) List(parent string) *ProjectsLocationsWasmPluginsVersionsListCall { + c := &ProjectsLocationsWasmPluginsVersionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": Maximum number of +// `WasmPluginVersion` resources to return per call. If not specified, at most +// 50 `WasmPluginVersion`s are returned. The maximum value is 1000; values +// above 1000 are coerced to 1000. +func (c *ProjectsLocationsWasmPluginsVersionsListCall) PageSize(pageSize int64) *ProjectsLocationsWasmPluginsVersionsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The value returned by the +// last `ListWasmPluginVersionsResponse` call. Indicates that this is a +// continuation of a prior `ListWasmPluginVersions` call, and that the next +// page of data is to be returned. +func (c *ProjectsLocationsWasmPluginsVersionsListCall) PageToken(pageToken string) *ProjectsLocationsWasmPluginsVersionsListCall { + 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 *ProjectsLocationsWasmPluginsVersionsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsWasmPluginsVersionsListCall { + 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 *ProjectsLocationsWasmPluginsVersionsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsWasmPluginsVersionsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsWasmPluginsVersionsListCall) Context(ctx context.Context) *ProjectsLocationsWasmPluginsVersionsListCall { + 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 *ProjectsLocationsWasmPluginsVersionsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsWasmPluginsVersionsListCall) 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}/versions") + 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 "networkservices.projects.locations.wasmPlugins.versions.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *ListWasmPluginVersionsResponse.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 *ProjectsLocationsWasmPluginsVersionsListCall) Do(opts ...googleapi.CallOption) (*ListWasmPluginVersionsResponse, 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 := &ListWasmPluginVersionsResponse{ + 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 *ProjectsLocationsWasmPluginsVersionsListCall) Pages(ctx context.Context, f func(*ListWasmPluginVersionsResponse) 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/networkservices/v1beta1/networkservices-api.json b/networkservices/v1beta1/networkservices-api.json index cd86f26d00f..209a7904c7c 100644 --- a/networkservices/v1beta1/networkservices-api.json +++ b/networkservices/v1beta1/networkservices-api.json @@ -1885,7 +1885,7 @@ ], "parameters": { "name": { - "description": "Required. Name of the ServiceLbPolicy resource. It matches pattern `projects/{project}/locations/{location}/serviceLbPolicies/{service_lb_policy_name}`.", + "description": "Identifier. Name of the ServiceLbPolicy resource. It matches pattern `projects/{project}/locations/{location}/serviceLbPolicies/{service_lb_policy_name}`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/serviceLbPolicies/[^/]+$", "required": true, @@ -2224,13 +2224,310 @@ ] } } + }, + "wasmPlugins": { + "methods": { + "create": { + "description": "Creates a new `WasmPlugin` resource in a given project and location.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/wasmPlugins", + "httpMethod": "POST", + "id": "networkservices.projects.locations.wasmPlugins.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent resource of the `WasmPlugin` resource. Must be in the format `projects/{project}/locations/global`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "wasmPluginId": { + "description": "Required. User-provided ID of the `WasmPlugin` resource to be created.", + "location": "query", + "type": "string" + } + }, + "path": "v1beta1/{+parent}/wasmPlugins", + "request": { + "$ref": "WasmPlugin" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes the specified `WasmPlugin` resource.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/wasmPlugins/{wasmPluginsId}", + "httpMethod": "DELETE", + "id": "networkservices.projects.locations.wasmPlugins.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. A name of the `WasmPlugin` resource to delete. Must be in the format `projects/{project}/locations/global/wasmPlugins/{wasm_plugin}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/wasmPlugins/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets details of the specified `WasmPlugin` resource.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/wasmPlugins/{wasmPluginsId}", + "httpMethod": "GET", + "id": "networkservices.projects.locations.wasmPlugins.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. A name of the `WasmPlugin` resource to get. Must be in the format `projects/{project}/locations/global/wasmPlugins/{wasm_plugin}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/wasmPlugins/[^/]+$", + "required": true, + "type": "string" + }, + "view": { + "description": "Determine how much data should be returned by the API. See [AIP-157](https://google.aip.dev/157).", + "enum": [ + "WASM_PLUGIN_VIEW_UNSPECIFIED", + "WASM_PLUGIN_VIEW_BASIC", + "WASM_PLUGIN_VIEW_FULL" + ], + "enumDescriptions": [ + "The default / unset value. The API will default to the BASIC view.", + "Include just WasmPlugin record.", + "Include WasmPlugin record and all its WasmPluginVersions." + ], + "location": "query", + "type": "string" + } + }, + "path": "v1beta1/{+name}", + "response": { + "$ref": "WasmPlugin" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists `WasmPlugin` resources in a given project and location.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/wasmPlugins", + "httpMethod": "GET", + "id": "networkservices.projects.locations.wasmPlugins.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Maximum number of `WasmPlugin` resources to return per call. If not specified, at most 50 `WasmPlugin`s are returned. The maximum value is 1000; values above 1000 are coerced to 1000.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The value returned by the last `ListWasmPluginsResponse` call. Indicates that this is a continuation of a prior `ListWasmPlugins` call, and that the next page of data is to be returned.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The project and location from which the `WasmPlugin` resources are listed, specified in the following format: `projects/{project}/locations/global`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+parent}/wasmPlugins", + "response": { + "$ref": "ListWasmPluginsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Updates the parameters of the specified `WasmPlugin` resource.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/wasmPlugins/{wasmPluginsId}", + "httpMethod": "PATCH", + "id": "networkservices.projects.locations.wasmPlugins.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Identifier. Name of the `WasmPlugin` resource in the following format: `projects/{project}/locations/{location}/wasmPlugins/{wasm_plugin}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/wasmPlugins/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Optional. Used to specify the fields to be overwritten in the `WasmPlugin` resource by the update. The fields specified in the `update_mask` field are relative to the resource, not the full request. An omitted `update_mask` field is treated as an implied `update_mask` field equivalent to all fields that are populated (that have a non-empty value). The `update_mask` field supports a special value `*`, which means that each field in the given `WasmPlugin` resource (including the empty ones) replaces the current value.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1beta1/{+name}", + "request": { + "$ref": "WasmPlugin" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, + "resources": { + "versions": { + "methods": { + "create": { + "description": "Creates a new `WasmPluginVersion` resource in a given project and location.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/wasmPlugins/{wasmPluginsId}/versions", + "httpMethod": "POST", + "id": "networkservices.projects.locations.wasmPlugins.versions.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent resource of the `WasmPluginVersion` resource. Must be in the format `projects/{project}/locations/global/wasmPlugins/{wasm_plugin}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/wasmPlugins/[^/]+$", + "required": true, + "type": "string" + }, + "wasmPluginVersionId": { + "description": "Required. User-provided ID of the `WasmPluginVersion` resource to be created.", + "location": "query", + "type": "string" + } + }, + "path": "v1beta1/{+parent}/versions", + "request": { + "$ref": "WasmPluginVersion" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes the specified `WasmPluginVersion` resource.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/wasmPlugins/{wasmPluginsId}/versions/{versionsId}", + "httpMethod": "DELETE", + "id": "networkservices.projects.locations.wasmPlugins.versions.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. A name of the `WasmPluginVersion` resource to delete. Must be in the format `projects/{project}/locations/global/wasmPlugins/{wasm_plugin}/versions/{wasm_plugin_version}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/wasmPlugins/[^/]+/versions/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets details of the specified `WasmPluginVersion` resource.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/wasmPlugins/{wasmPluginsId}/versions/{versionsId}", + "httpMethod": "GET", + "id": "networkservices.projects.locations.wasmPlugins.versions.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. A name of the `WasmPluginVersion` resource to get. Must be in the format `projects/{project}/locations/global/wasmPlugins/{wasm_plugin}/versions/{wasm_plugin_version}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/wasmPlugins/[^/]+/versions/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+name}", + "response": { + "$ref": "WasmPluginVersion" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists `WasmPluginVersion` resources in a given project and location.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/wasmPlugins/{wasmPluginsId}/versions", + "httpMethod": "GET", + "id": "networkservices.projects.locations.wasmPlugins.versions.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Maximum number of `WasmPluginVersion` resources to return per call. If not specified, at most 50 `WasmPluginVersion`s are returned. The maximum value is 1000; values above 1000 are coerced to 1000.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The value returned by the last `ListWasmPluginVersionsResponse` call. Indicates that this is a continuation of a prior `ListWasmPluginVersions` call, and that the next page of data is to be returned.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The `WasmPlugin` resource whose `WasmPluginVersion`s are listed, specified in the following format: `projects/{project}/locations/global/wasmPlugins/{wasm_plugin}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/wasmPlugins/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+parent}/versions", + "response": { + "$ref": "ListWasmPluginVersionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } } } } } } }, - "revision": "20240919", + "revision": "20241010", "rootUrl": "https://networkservices.googleapis.com/", "schemas": { "AuthzExtension": { @@ -2443,7 +2740,7 @@ "id": "ExtensionChainExtension", "properties": { "authority": { - "description": "Optional. The `:authority` header in the gRPC request sent from Envoy to the extension service. Required for Callout extensions.", + "description": "Optional. The `:authority` header in the gRPC request sent from Envoy to the extension service. Required for Callout extensions. This field is not supported for plugin extensions and must not be set.", "type": "string" }, "failOpen": { @@ -2457,12 +2754,20 @@ }, "type": "array" }, + "metadata": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Optional. The metadata provided here is included as part of the `metadata_context` (of type `google.protobuf.Struct`) in the `ProcessingRequest` message sent to the extension server. The metadata is available under the namespace `com.google....`. For example: `com.google.lb_traffic_extension.lbtrafficextension1.chain1.ext1`. The following variables are supported in the metadata: `{forwarding_rule_id}` - substituted with the forwarding rule's fully qualified resource name. This field is not supported for plugin extensions and must not be set.", + "type": "object" + }, "name": { "description": "Required. The name for this extension. The name is logged as part of the HTTP request logs. The name must conform with RFC-1034, is restricted to lower-cased letters, numbers and hyphens, and can have a maximum length of 63 characters. Additionally, the first character must be a letter and the last a letter or a number.", "type": "string" }, "service": { - "description": "Required. The reference to the service that runs the extension. Currently only callout extensions are supported here. To configure a callout extension, `service` must be a fully-qualified reference to a [backend service](https://cloud.google.com/compute/docs/reference/rest/v1/backendServices) in the format: `https://www.googleapis.com/compute/v1/projects/{project}/regions/{region}/backendServices/{backendService}` or `https://www.googleapis.com/compute/v1/projects/{project}/global/backendServices/{backendService}`.", + "description": "Required. The reference to the service that runs the extension. Currently only callout extensions are supported here. To configure a callout extension, `service` must be a fully-qualified reference to a [backend service](https://cloud.google.com/compute/docs/reference/rest/v1/backendServices) in the format: `https://www.googleapis.com/compute/v1/projects/{project}/regions/{region}/backendServices/{backendService}` or `https://www.googleapis.com/compute/v1/projects/{project}/global/backendServices/{backendService}`. To configure a plugin extension, this must be a reference to a [wasm plugin](https://cloud.google.com/service-extensions/docs/reference/rest/v1beta1/projects.locations.wasmPlugins) in the format: `projects/{project}/locations/{location}/wasmPlugins/{plugin}` or `//networkservices.googleapis.com/projects/{project}/locations/{location}/wasmPlugins/{wasmPlugin}`.", "type": "string" }, "supportedEvents": { @@ -2491,7 +2796,7 @@ "type": "array" }, "timeout": { - "description": "Optional. Specifies the timeout for each individual message on the stream. The timeout must be between 10-1000 milliseconds. Required for Callout extensions.", + "description": "Optional. Specifies the timeout for each individual message on the stream. The timeout must be between 10-1000 milliseconds. Required for callout extensions. This field is not supported for plugin extensions and must not be set.", "format": "google-duration", "type": "string" } @@ -3555,7 +3860,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Optional. The metadata provided here is included as part of the `metadata_context` (of type `google.protobuf.Struct`) in the `ProcessingRequest` message sent to the extension server. The metadata is available under the namespace `com.google.lb_route_extension.`. The following variables are supported in the metadata Struct: `{forwarding_rule_id}` - substituted with the forwarding rule's fully qualified resource name.", + "description": "Optional. The metadata provided here is included as part of the `metadata_context` (of type `google.protobuf.Struct`) in the `ProcessingRequest` message sent to the extension server. The metadata is available under the namespace `com.google.lb_route_extension.`. The following variables are supported in the metadata Struct: `{forwarding_rule_id}` - substituted with the forwarding rule's fully qualified resource name. This field is not supported for plugin extensions and must not be set.", "type": "object" }, "name": { @@ -3625,7 +3930,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Optional. The metadata provided here is included in the `ProcessingRequest.metadata_context.filter_metadata` map field. The metadata is available under the key `com.google.lb_traffic_extension.`. The following variables are supported in the metadata: `{forwarding_rule_id}` - substituted with the forwarding rule's fully qualified resource name.", + "description": "Optional. The metadata provided here is included in the `ProcessingRequest.metadata_context.filter_metadata` map field. The metadata is available under the key `com.google.lb_traffic_extension.`. The following variables are supported in the metadata: `{forwarding_rule_id}` - substituted with the forwarding rule's fully qualified resource name. This field is not supported for plugin extensions and must not be set.", "type": "object" }, "name": { @@ -3921,6 +4226,42 @@ }, "type": "object" }, + "ListWasmPluginVersionsResponse": { + "description": "Response returned by the `ListWasmPluginVersions` method.", + "id": "ListWasmPluginVersionsResponse", + "properties": { + "nextPageToken": { + "description": "If there might be more results than those appearing in this response, then `next_page_token` is included. To get the next set of results, call this method again using the value of `next_page_token` as `page_token`.", + "type": "string" + }, + "wasmPluginVersions": { + "description": "List of `WasmPluginVersion` resources.", + "items": { + "$ref": "WasmPluginVersion" + }, + "type": "array" + } + }, + "type": "object" + }, + "ListWasmPluginsResponse": { + "description": "Response returned by the `ListWasmPlugins` method.", + "id": "ListWasmPluginsResponse", + "properties": { + "nextPageToken": { + "description": "If there might be more results than those appearing in this response, then `next_page_token` is included. To get the next set of results, call this method again using the value of `next_page_token` as `page_token`.", + "type": "string" + }, + "wasmPlugins": { + "description": "List of `WasmPlugin` resources.", + "items": { + "$ref": "WasmPlugin" + }, + "type": "array" + } + }, + "type": "object" + }, "Location": { "description": "A resource that represents a Google Cloud location.", "id": "Location", @@ -4271,7 +4612,7 @@ "type": "string" }, "name": { - "description": "Required. Name of the ServiceLbPolicy resource. It matches pattern `projects/{project}/locations/{location}/serviceLbPolicies/{service_lb_policy_name}`.", + "description": "Identifier. Name of the ServiceLbPolicy resource. It matches pattern `projects/{project}/locations/{location}/serviceLbPolicies/{service_lb_policy_name}`.", "type": "string" }, "updateTime": { @@ -4612,6 +4953,223 @@ } }, "type": "object" + }, + "WasmPlugin": { + "description": "`WasmPlugin` is a resource representing a service executing a customer-provided Wasm module.", + "id": "WasmPlugin", + "properties": { + "createTime": { + "description": "Output only. The timestamp when the resource was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "Optional. A human-readable description of the resource.", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Set of labels associated with the `WasmPlugin` resource. The format must comply with [the following requirements](/compute/docs/labeling-resources#requirements).", + "type": "object" + }, + "logConfig": { + "$ref": "WasmPluginLogConfig", + "description": "Optional. Specifies the logging options for the activity performed by this `WasmPlugin`. If logging is enabled, plugin logs are exported to Cloud Logging. Note that the settings relate to the logs generated by using logging statements in your Wasm code." + }, + "mainVersionId": { + "description": "Optional. The ID of the `WasmPluginVersion` resource that is the currently serving one. The version referred to must be a child of this `WasmPlugin` resource.", + "type": "string" + }, + "name": { + "description": "Identifier. Name of the `WasmPlugin` resource in the following format: `projects/{project}/locations/{location}/wasmPlugins/{wasm_plugin}`.", + "type": "string" + }, + "updateTime": { + "description": "Output only. The timestamp when the resource was updated.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "usedBy": { + "description": "Output only. List of all [Service Extensions](https://cloud.google.com/service-extensions/docs/overview) that use this `WasmPlugin`.", + "items": { + "$ref": "WasmPluginUsedBy" + }, + "readOnly": true, + "type": "array" + }, + "versions": { + "additionalProperties": { + "$ref": "WasmPluginVersionDetails" + }, + "description": "Optional. All versions of this `WasmPlugin` in the key-value format. The key is the resource ID, the value is the `VersionDetails`. Allows to create or update `WasmPlugin` and its WasmPluginVersions in a single request. When the `main_version_id` field is not empty it must point to one of the VersionDetails in the map. If provided in the update request, the new versions replace the previous set. Any version omitted from the `versions` will be removed. Since the `WasmPluginVersion` resource is immutable, if the WasmPluginVersion with the same name already exists and differs the Update request will fail. Note: In the GET request, this field is populated only if the GetWasmPluginRequest.view is set to WASM_PLUGIN_VIEW_FULL.", + "type": "object" + } + }, + "type": "object" + }, + "WasmPluginLogConfig": { + "description": "Specifies the logging options for the activity performed by this `WasmPlugin`. If logging is enabled, plugin logs are exported to Cloud Logging.", + "id": "WasmPluginLogConfig", + "properties": { + "enable": { + "description": "Optional. Specifies whether to enable logging for activity by this `WasmPlugin`. Defaults to `false`.", + "type": "boolean" + }, + "minLogLevel": { + "description": "Non-empty default. Specificies the lowest level of the plugin logs that are exported to Cloud Logging. This setting relates to the logs generated by using logging statements in your Wasm code. This field is can be set only if logging is enabled for the `WasmPlugin` resource. If the field is not provided when logging is enabled, it is set to `INFO` by default.", + "enum": [ + "LOG_LEVEL_UNSPECIFIED", + "TRACE", + "DEBUG", + "INFO", + "WARN", + "ERROR", + "CRITICAL" + ], + "enumDescriptions": [ + "Unspecified value.", + "Report logs with TRACE level and above.", + "Report logs with DEBUG level and above.", + "Report logs with INFO level and above.", + "Report logs with WARN level and above.", + "Report logs with ERROR level and above.", + "Report logs with CRITICAL level only." + ], + "type": "string" + }, + "sampleRate": { + "description": "Non-empty default. Configures the sampling rate of activity logs, where `1.0` means all logged activity is reported and `0.0` means no activity is reported. A floating point value between `0.0` and `1.0` indicates that a percentage of log messages is stored. The default value when logging is enabled is `1.0`. The value of the field must be between `0` and `1` (inclusive). This field can only be specified if logging is enabled for this `WasmPlugin`.", + "format": "float", + "type": "number" + } + }, + "type": "object" + }, + "WasmPluginUsedBy": { + "description": "Defines a resource that uses the `WasmPlugin`.", + "id": "WasmPluginUsedBy", + "properties": { + "name": { + "description": "Output only. Full name of the resource https://google.aip.dev/122#full-resource-names, e.g. `//networkservices.googleapis.com/projects/{project}/locations/{location}/lbRouteExtensions/{extension}`", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "WasmPluginVersion": { + "description": "A single immutable version of a `WasmPlugin`. Defines the Wasm module used and optionally its runtime config.", + "id": "WasmPluginVersion", + "properties": { + "createTime": { + "description": "Output only. The timestamp when the resource was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "Optional. A human-readable description of the resource.", + "type": "string" + }, + "imageDigest": { + "description": "Output only. The resolved digest for the image specified in `image`. The digest is resolved during the creation of `WasmPluginVersion` resource. This field holds the digest value regardless of whether a tag or digest was originally specified in the `image` field.", + "readOnly": true, + "type": "string" + }, + "imageUri": { + "description": "Optional. URI of the container image containing the Wasm plugin, stored in the Artifact Registry. When a new `WasmPluginVersion` resource is created, the digest of the container image is saved in the `image_digest` field. When downloading an image, the digest value is used instead of an image tag.", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Set of labels associated with the `WasmPluginVersion` resource.", + "type": "object" + }, + "name": { + "description": "Identifier. Name of the `WasmPluginVersion` resource in the following format: `projects/{project}/locations/{location}/wasmPlugins/{wasm_plugin}/ versions/{wasm_plugin_version}`.", + "type": "string" + }, + "pluginConfigData": { + "description": "Configuration for the Wasm plugin. The configuration is provided to the Wasm plugin at runtime through the `ON_CONFIGURE` callback. When a new `WasmPluginVersion` resource is created, the digest of the contents is saved in the `plugin_config_digest` field.", + "format": "byte", + "type": "string" + }, + "pluginConfigDigest": { + "description": "Output only. This field holds the digest (usually checksum) value for the plugin configuration. The value is calculated based on the contents of the `plugin_config_data` or the container image defined by the `plugin_config_uri` field.", + "readOnly": true, + "type": "string" + }, + "pluginConfigUri": { + "description": "URI of the Wasm plugin configuration stored in the Artifact Registry. The configuration is provided to the plugin at runtime through the `ON_CONFIGURE` callback. The container image must contain only a single file with the name `plugin.config`. When a new `WasmPluginVersion` resource is created, the digest of the container image is saved in the `plugin_config_digest` field.", + "type": "string" + }, + "updateTime": { + "description": "Output only. The timestamp when the resource was updated.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "WasmPluginVersionDetails": { + "description": "Details of a `WasmPluginVersion` resource to be inlined in the `WasmPlugin` resource.", + "id": "WasmPluginVersionDetails", + "properties": { + "createTime": { + "description": "Output only. The timestamp when the resource was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "Optional. A human-readable description of the resource.", + "type": "string" + }, + "imageDigest": { + "description": "Output only. The resolved digest for the image specified in `image`. The digest is resolved during the creation of a `WasmPluginVersion` resource. This field holds the digest value regardless of whether a tag or digest was originally specified in the `image` field.", + "readOnly": true, + "type": "string" + }, + "imageUri": { + "description": "Optional. URI of the container image containing the Wasm module, stored in the Artifact Registry. The container image must contain only a single file with the name `plugin.wasm`. When a new `WasmPluginVersion` resource is created, the URI gets resolved to an image digest and saved in the `image_digest` field.", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Set of labels associated with the `WasmPluginVersion` resource.", + "type": "object" + }, + "pluginConfigData": { + "description": "Configuration for the Wasm plugin. The configuration is provided to the Wasm plugin at runtime through the `ON_CONFIGURE` callback. When a new `WasmPluginVersion` version is created, the digest of the contents is saved in the `plugin_config_digest` field.", + "format": "byte", + "type": "string" + }, + "pluginConfigDigest": { + "description": "Output only. This field holds the digest (usually checksum) value for the plugin configuration. The value is calculated based on the contents of the `plugin_config_data` or the container image defined by the `plugin_config_uri` field.", + "readOnly": true, + "type": "string" + }, + "pluginConfigUri": { + "description": "URI of the WasmPlugin configuration stored in the Artifact Registry. The configuration is provided to the Wasm plugin at runtime through the `ON_CONFIGURE` callback. The container image must contain only a single file with the name `plugin.config`. When a new `WasmPluginVersion` resource is created, the digest of the container image is saved in the `plugin_config_digest` field.", + "type": "string" + }, + "updateTime": { + "description": "Output only. The timestamp when the resource was updated.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" } }, "servicePath": "", diff --git a/networkservices/v1beta1/networkservices-gen.go b/networkservices/v1beta1/networkservices-gen.go index c62b094c690..93c0685a628 100644 --- a/networkservices/v1beta1/networkservices-gen.go +++ b/networkservices/v1beta1/networkservices-gen.go @@ -181,6 +181,7 @@ func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { rs.ServiceLbPolicies = NewProjectsLocationsServiceLbPoliciesService(s) rs.TcpRoutes = NewProjectsLocationsTcpRoutesService(s) rs.TlsRoutes = NewProjectsLocationsTlsRoutesService(s) + rs.WasmPlugins = NewProjectsLocationsWasmPluginsService(s) return rs } @@ -212,6 +213,8 @@ type ProjectsLocationsService struct { TcpRoutes *ProjectsLocationsTcpRoutesService TlsRoutes *ProjectsLocationsTlsRoutesService + + WasmPlugins *ProjectsLocationsWasmPluginsService } func NewProjectsLocationsAuthzExtensionsService(s *Service) *ProjectsLocationsAuthzExtensionsService { @@ -331,6 +334,27 @@ type ProjectsLocationsTlsRoutesService struct { s *Service } +func NewProjectsLocationsWasmPluginsService(s *Service) *ProjectsLocationsWasmPluginsService { + rs := &ProjectsLocationsWasmPluginsService{s: s} + rs.Versions = NewProjectsLocationsWasmPluginsVersionsService(s) + return rs +} + +type ProjectsLocationsWasmPluginsService struct { + s *Service + + Versions *ProjectsLocationsWasmPluginsVersionsService +} + +func NewProjectsLocationsWasmPluginsVersionsService(s *Service) *ProjectsLocationsWasmPluginsVersionsService { + rs := &ProjectsLocationsWasmPluginsVersionsService{s: s} + return rs +} + +type ProjectsLocationsWasmPluginsVersionsService struct { + s *Service +} + // AuthzExtension: `AuthzExtension` is a resource that allows traffic // forwarding to a callout backend service to make an authorization decision. type AuthzExtension struct { @@ -576,7 +600,8 @@ func (s ExtensionChain) MarshalJSON() ([]byte, error) { // matching request. type ExtensionChainExtension struct { // Authority: Optional. The `:authority` header in the gRPC request sent from - // Envoy to the extension service. Required for Callout extensions. + // Envoy to the extension service. Required for Callout extensions. This field + // is not supported for plugin extensions and must not be set. Authority string `json:"authority,omitempty"` // FailOpen: Optional. Determines how the proxy behaves if the call to the // extension fails or times out. When set to `TRUE`, request or response @@ -593,6 +618,15 @@ type ExtensionChainExtension struct { // extension (from the client or backend). If omitted, all headers are sent. // Each element is a string indicating the header name. ForwardHeaders []string `json:"forwardHeaders,omitempty"` + // Metadata: Optional. The metadata provided here is included as part of the + // `metadata_context` (of type `google.protobuf.Struct`) in the + // `ProcessingRequest` message sent to the extension server. The metadata is + // available under the namespace `com.google....`. For example: + // `com.google.lb_traffic_extension.lbtrafficextension1.chain1.ext1`. The + // following variables are supported in the metadata: `{forwarding_rule_id}` - + // substituted with the forwarding rule's fully qualified resource name. This + // field is not supported for plugin extensions and must not be set. + Metadata googleapi.RawMessage `json:"metadata,omitempty"` // Name: Required. The name for this extension. The name is logged as part of // the HTTP request logs. The name must conform with RFC-1034, is restricted to // lower-cased letters, numbers and hyphens, and can have a maximum length of @@ -608,7 +642,13 @@ type ExtensionChainExtension struct { // `https://www.googleapis.com/compute/v1/projects/{project}/regions/{region}/ba // ckendServices/{backendService}` or // `https://www.googleapis.com/compute/v1/projects/{project}/global/backendServi - // ces/{backendService}`. + // ces/{backendService}`. To configure a plugin extension, this must be a + // reference to a wasm plugin + // (https://cloud.google.com/service-extensions/docs/reference/rest/v1beta1/projects.locations.wasmPlugins) + // in the format: + // `projects/{project}/locations/{location}/wasmPlugins/{plugin}` or + // `//networkservices.googleapis.com/projects/{project}/locations/{location}/was + // mPlugins/{wasmPlugin}`. Service string `json:"service,omitempty"` // SupportedEvents: Optional. A set of events during request or response // processing for which this extension is called. This field is required for @@ -632,7 +672,8 @@ type ExtensionChainExtension struct { SupportedEvents []string `json:"supportedEvents,omitempty"` // Timeout: Optional. Specifies the timeout for each individual message on the // stream. The timeout must be between 10-1000 milliseconds. Required for - // Callout extensions. + // callout extensions. This field is not supported for plugin extensions and + // must not be set. Timeout string `json:"timeout,omitempty"` // ForceSendFields is a list of field names (e.g. "Authority") to // unconditionally include in API requests. By default, fields with empty or @@ -2030,7 +2071,8 @@ type LbRouteExtension struct { // available under the namespace `com.google.lb_route_extension.`. The // following variables are supported in the metadata Struct: // `{forwarding_rule_id}` - substituted with the forwarding rule's fully - // qualified resource name. + // qualified resource name. This field is not supported for plugin extensions + // and must not be set. Metadata googleapi.RawMessage `json:"metadata,omitempty"` // Name: Required. Identifier. Name of the `LbRouteExtension` resource in the // following format: @@ -2103,7 +2145,8 @@ type LbTrafficExtension struct { // `ProcessingRequest.metadata_context.filter_metadata` map field. The metadata // is available under the key `com.google.lb_traffic_extension.`. The following // variables are supported in the metadata: `{forwarding_rule_id}` - - // substituted with the forwarding rule's fully qualified resource name. + // substituted with the forwarding rule's fully qualified resource name. This + // field is not supported for plugin extensions and must not be set. Metadata googleapi.RawMessage `json:"metadata,omitempty"` // Name: Required. Identifier. Name of the `LbTrafficExtension` resource in the // following format: @@ -2557,6 +2600,67 @@ func (s ListTlsRoutesResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ListWasmPluginVersionsResponse: Response returned by the +// `ListWasmPluginVersions` method. +type ListWasmPluginVersionsResponse struct { + // NextPageToken: If there might be more results than those appearing in this + // response, then `next_page_token` is included. To get the next set of + // results, call this method again using the value of `next_page_token` as + // `page_token`. + NextPageToken string `json:"nextPageToken,omitempty"` + // WasmPluginVersions: List of `WasmPluginVersion` resources. + WasmPluginVersions []*WasmPluginVersion `json:"wasmPluginVersions,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 ListWasmPluginVersionsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListWasmPluginVersionsResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ListWasmPluginsResponse: Response returned by the `ListWasmPlugins` method. +type ListWasmPluginsResponse struct { + // NextPageToken: If there might be more results than those appearing in this + // response, then `next_page_token` is included. To get the next set of + // results, call this method again using the value of `next_page_token` as + // `page_token`. + NextPageToken string `json:"nextPageToken,omitempty"` + // WasmPlugins: List of `WasmPlugin` resources. + WasmPlugins []*WasmPlugin `json:"wasmPlugins,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 ListWasmPluginsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListWasmPluginsResponse + 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 @@ -2951,7 +3055,7 @@ type ServiceLbPolicy struct { // "WATERFALL_BY_ZONE" - Attempt to keep traffic in a single zone closest to // the client, before spilling over to other zones. LoadBalancingAlgorithm string `json:"loadBalancingAlgorithm,omitempty"` - // Name: Required. Name of the ServiceLbPolicy resource. It matches pattern + // Name: Identifier. Name of the ServiceLbPolicy resource. It matches pattern // `projects/{project}/locations/{location}/serviceLbPolicies/{service_lb_policy // _name}`. Name string `json:"name,omitempty"` @@ -3442,6 +3546,279 @@ func (s TrafficPortSelector) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// WasmPlugin: `WasmPlugin` is a resource representing a service executing a +// customer-provided Wasm module. +type WasmPlugin struct { + // CreateTime: Output only. The timestamp when the resource was created. + CreateTime string `json:"createTime,omitempty"` + // Description: Optional. A human-readable description of the resource. + Description string `json:"description,omitempty"` + // Labels: Optional. Set of labels associated with the `WasmPlugin` resource. + // The format must comply with the following requirements + // (/compute/docs/labeling-resources#requirements). + Labels map[string]string `json:"labels,omitempty"` + // LogConfig: Optional. Specifies the logging options for the activity + // performed by this `WasmPlugin`. If logging is enabled, plugin logs are + // exported to Cloud Logging. Note that the settings relate to the logs + // generated by using logging statements in your Wasm code. + LogConfig *WasmPluginLogConfig `json:"logConfig,omitempty"` + // MainVersionId: Optional. The ID of the `WasmPluginVersion` resource that is + // the currently serving one. The version referred to must be a child of this + // `WasmPlugin` resource. + MainVersionId string `json:"mainVersionId,omitempty"` + // Name: Identifier. Name of the `WasmPlugin` resource in the following format: + // `projects/{project}/locations/{location}/wasmPlugins/{wasm_plugin}`. + Name string `json:"name,omitempty"` + // UpdateTime: Output only. The timestamp when the resource was updated. + UpdateTime string `json:"updateTime,omitempty"` + // UsedBy: Output only. List of all Service Extensions + // (https://cloud.google.com/service-extensions/docs/overview) that use this + // `WasmPlugin`. + UsedBy []*WasmPluginUsedBy `json:"usedBy,omitempty"` + // Versions: Optional. All versions of this `WasmPlugin` in the key-value + // format. The key is the resource ID, the value is the `VersionDetails`. + // Allows to create or update `WasmPlugin` and its WasmPluginVersions in a + // single request. When the `main_version_id` field is not empty it must point + // to one of the VersionDetails in the map. If provided in the update request, + // the new versions replace the previous set. Any version omitted from the + // `versions` will be removed. Since the `WasmPluginVersion` resource is + // immutable, if the WasmPluginVersion with the same name already exists and + // differs the Update request will fail. Note: In the GET request, this field + // is populated only if the GetWasmPluginRequest.view is set to + // WASM_PLUGIN_VIEW_FULL. + Versions map[string]WasmPluginVersionDetails `json:"versions,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 WasmPlugin) MarshalJSON() ([]byte, error) { + type NoMethod WasmPlugin + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// WasmPluginLogConfig: Specifies the logging options for the activity +// performed by this `WasmPlugin`. If logging is enabled, plugin logs are +// exported to Cloud Logging. +type WasmPluginLogConfig struct { + // Enable: Optional. Specifies whether to enable logging for activity by this + // `WasmPlugin`. Defaults to `false`. + Enable bool `json:"enable,omitempty"` + // MinLogLevel: Non-empty default. Specificies the lowest level of the plugin + // logs that are exported to Cloud Logging. This setting relates to the logs + // generated by using logging statements in your Wasm code. This field is can + // be set only if logging is enabled for the `WasmPlugin` resource. If the + // field is not provided when logging is enabled, it is set to `INFO` by + // default. + // + // Possible values: + // "LOG_LEVEL_UNSPECIFIED" - Unspecified value. + // "TRACE" - Report logs with TRACE level and above. + // "DEBUG" - Report logs with DEBUG level and above. + // "INFO" - Report logs with INFO level and above. + // "WARN" - Report logs with WARN level and above. + // "ERROR" - Report logs with ERROR level and above. + // "CRITICAL" - Report logs with CRITICAL level only. + MinLogLevel string `json:"minLogLevel,omitempty"` + // SampleRate: Non-empty default. Configures the sampling rate of activity + // logs, where `1.0` means all logged activity is reported and `0.0` means no + // activity is reported. A floating point value between `0.0` and `1.0` + // indicates that a percentage of log messages is stored. The default value + // when logging is enabled is `1.0`. The value of the field must be between `0` + // and `1` (inclusive). This field can only be specified if logging is enabled + // for this `WasmPlugin`. + SampleRate float64 `json:"sampleRate,omitempty"` + // ForceSendFields is a list of field names (e.g. "Enable") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Enable") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s WasmPluginLogConfig) MarshalJSON() ([]byte, error) { + type NoMethod WasmPluginLogConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *WasmPluginLogConfig) UnmarshalJSON(data []byte) error { + type NoMethod WasmPluginLogConfig + var s1 struct { + SampleRate gensupport.JSONFloat64 `json:"sampleRate"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.SampleRate = float64(s1.SampleRate) + return nil +} + +// WasmPluginUsedBy: Defines a resource that uses the `WasmPlugin`. +type WasmPluginUsedBy struct { + // Name: Output only. Full name of the resource + // https://google.aip.dev/122#full-resource-names, e.g. + // `//networkservices.googleapis.com/projects/{project}/locations/{location}/lbR + // outeExtensions/{extension}` + 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 WasmPluginUsedBy) MarshalJSON() ([]byte, error) { + type NoMethod WasmPluginUsedBy + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// WasmPluginVersion: A single immutable version of a `WasmPlugin`. Defines the +// Wasm module used and optionally its runtime config. +type WasmPluginVersion struct { + // CreateTime: Output only. The timestamp when the resource was created. + CreateTime string `json:"createTime,omitempty"` + // Description: Optional. A human-readable description of the resource. + Description string `json:"description,omitempty"` + // ImageDigest: Output only. The resolved digest for the image specified in + // `image`. The digest is resolved during the creation of `WasmPluginVersion` + // resource. This field holds the digest value regardless of whether a tag or + // digest was originally specified in the `image` field. + ImageDigest string `json:"imageDigest,omitempty"` + // ImageUri: Optional. URI of the container image containing the Wasm plugin, + // stored in the Artifact Registry. When a new `WasmPluginVersion` resource is + // created, the digest of the container image is saved in the `image_digest` + // field. When downloading an image, the digest value is used instead of an + // image tag. + ImageUri string `json:"imageUri,omitempty"` + // Labels: Optional. Set of labels associated with the `WasmPluginVersion` + // resource. + Labels map[string]string `json:"labels,omitempty"` + // Name: Identifier. Name of the `WasmPluginVersion` resource in the following + // format: `projects/{project}/locations/{location}/wasmPlugins/{wasm_plugin}/ + // versions/{wasm_plugin_version}`. + Name string `json:"name,omitempty"` + // PluginConfigData: Configuration for the Wasm plugin. The configuration is + // provided to the Wasm plugin at runtime through the `ON_CONFIGURE` callback. + // When a new `WasmPluginVersion` resource is created, the digest of the + // contents is saved in the `plugin_config_digest` field. + PluginConfigData string `json:"pluginConfigData,omitempty"` + // PluginConfigDigest: Output only. This field holds the digest (usually + // checksum) value for the plugin configuration. The value is calculated based + // on the contents of the `plugin_config_data` or the container image defined + // by the `plugin_config_uri` field. + PluginConfigDigest string `json:"pluginConfigDigest,omitempty"` + // PluginConfigUri: URI of the Wasm plugin configuration stored in the Artifact + // Registry. The configuration is provided to the plugin at runtime through the + // `ON_CONFIGURE` callback. The container image must contain only a single file + // with the name `plugin.config`. When a new `WasmPluginVersion` resource is + // created, the digest of the container image is saved in the + // `plugin_config_digest` field. + PluginConfigUri string `json:"pluginConfigUri,omitempty"` + // UpdateTime: Output only. The timestamp when the resource was updated. + 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 WasmPluginVersion) MarshalJSON() ([]byte, error) { + type NoMethod WasmPluginVersion + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// WasmPluginVersionDetails: Details of a `WasmPluginVersion` resource to be +// inlined in the `WasmPlugin` resource. +type WasmPluginVersionDetails struct { + // CreateTime: Output only. The timestamp when the resource was created. + CreateTime string `json:"createTime,omitempty"` + // Description: Optional. A human-readable description of the resource. + Description string `json:"description,omitempty"` + // ImageDigest: Output only. The resolved digest for the image specified in + // `image`. The digest is resolved during the creation of a `WasmPluginVersion` + // resource. This field holds the digest value regardless of whether a tag or + // digest was originally specified in the `image` field. + ImageDigest string `json:"imageDigest,omitempty"` + // ImageUri: Optional. URI of the container image containing the Wasm module, + // stored in the Artifact Registry. The container image must contain only a + // single file with the name `plugin.wasm`. When a new `WasmPluginVersion` + // resource is created, the URI gets resolved to an image digest and saved in + // the `image_digest` field. + ImageUri string `json:"imageUri,omitempty"` + // Labels: Optional. Set of labels associated with the `WasmPluginVersion` + // resource. + Labels map[string]string `json:"labels,omitempty"` + // PluginConfigData: Configuration for the Wasm plugin. The configuration is + // provided to the Wasm plugin at runtime through the `ON_CONFIGURE` callback. + // When a new `WasmPluginVersion` version is created, the digest of the + // contents is saved in the `plugin_config_digest` field. + PluginConfigData string `json:"pluginConfigData,omitempty"` + // PluginConfigDigest: Output only. This field holds the digest (usually + // checksum) value for the plugin configuration. The value is calculated based + // on the contents of the `plugin_config_data` or the container image defined + // by the `plugin_config_uri` field. + PluginConfigDigest string `json:"pluginConfigDigest,omitempty"` + // PluginConfigUri: URI of the WasmPlugin configuration stored in the Artifact + // Registry. The configuration is provided to the Wasm plugin at runtime + // through the `ON_CONFIGURE` callback. The container image must contain only a + // single file with the name `plugin.config`. When a new `WasmPluginVersion` + // resource is created, the digest of the container image is saved in the + // `plugin_config_digest` field. + PluginConfigUri string `json:"pluginConfigUri,omitempty"` + // UpdateTime: Output only. The timestamp when the resource was updated. + 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 WasmPluginVersionDetails) MarshalJSON() ([]byte, error) { + type NoMethod WasmPluginVersionDetails + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type ProjectsLocationsGetCall struct { s *Service name string @@ -9880,7 +10257,7 @@ type ProjectsLocationsServiceLbPoliciesPatchCall struct { // Patch: Updates the parameters of a single ServiceLbPolicy. // -// - name: Name of the ServiceLbPolicy resource. It matches pattern +// - name: Identifier. Name of the ServiceLbPolicy resource. It matches pattern // `projects/{project}/locations/{location}/serviceLbPolicies/{service_lb_poli // cy_name}`. func (r *ProjectsLocationsServiceLbPoliciesService) Patch(name string, servicelbpolicy *ServiceLbPolicy) *ProjectsLocationsServiceLbPoliciesPatchCall { @@ -11124,3 +11501,1069 @@ func (c *ProjectsLocationsTlsRoutesPatchCall) Do(opts ...googleapi.CallOption) ( } return ret, nil } + +type ProjectsLocationsWasmPluginsCreateCall struct { + s *Service + parent string + wasmplugin *WasmPlugin + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a new `WasmPlugin` resource in a given project and location. +// +// - parent: The parent resource of the `WasmPlugin` resource. Must be in the +// format `projects/{project}/locations/global`. +func (r *ProjectsLocationsWasmPluginsService) Create(parent string, wasmplugin *WasmPlugin) *ProjectsLocationsWasmPluginsCreateCall { + c := &ProjectsLocationsWasmPluginsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.wasmplugin = wasmplugin + return c +} + +// WasmPluginId sets the optional parameter "wasmPluginId": Required. +// User-provided ID of the `WasmPlugin` resource to be created. +func (c *ProjectsLocationsWasmPluginsCreateCall) WasmPluginId(wasmPluginId string) *ProjectsLocationsWasmPluginsCreateCall { + c.urlParams_.Set("wasmPluginId", wasmPluginId) + 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 *ProjectsLocationsWasmPluginsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsWasmPluginsCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsWasmPluginsCreateCall) Context(ctx context.Context) *ProjectsLocationsWasmPluginsCreateCall { + 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 *ProjectsLocationsWasmPluginsCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsWasmPluginsCreateCall) 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.wasmplugin) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+parent}/wasmPlugins") + 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 "networkservices.projects.locations.wasmPlugins.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 *ProjectsLocationsWasmPluginsCreateCall) 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 ProjectsLocationsWasmPluginsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes the specified `WasmPlugin` resource. +// +// - name: A name of the `WasmPlugin` resource to delete. Must be in the format +// `projects/{project}/locations/global/wasmPlugins/{wasm_plugin}`. +func (r *ProjectsLocationsWasmPluginsService) Delete(name string) *ProjectsLocationsWasmPluginsDeleteCall { + c := &ProjectsLocationsWasmPluginsDeleteCall{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 *ProjectsLocationsWasmPluginsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsWasmPluginsDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsWasmPluginsDeleteCall) Context(ctx context.Context) *ProjectsLocationsWasmPluginsDeleteCall { + 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 *ProjectsLocationsWasmPluginsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsWasmPluginsDeleteCall) 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 "networkservices.projects.locations.wasmPlugins.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 *ProjectsLocationsWasmPluginsDeleteCall) 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 ProjectsLocationsWasmPluginsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets details of the specified `WasmPlugin` resource. +// +// - name: A name of the `WasmPlugin` resource to get. Must be in the format +// `projects/{project}/locations/global/wasmPlugins/{wasm_plugin}`. +func (r *ProjectsLocationsWasmPluginsService) Get(name string) *ProjectsLocationsWasmPluginsGetCall { + c := &ProjectsLocationsWasmPluginsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// View sets the optional parameter "view": Determine how much data should be +// returned by the API. See AIP-157 (https://google.aip.dev/157). +// +// Possible values: +// +// "WASM_PLUGIN_VIEW_UNSPECIFIED" - The default / unset value. The API will +// +// default to the BASIC view. +// +// "WASM_PLUGIN_VIEW_BASIC" - Include just WasmPlugin record. +// "WASM_PLUGIN_VIEW_FULL" - Include WasmPlugin record and all its +// +// WasmPluginVersions. +func (c *ProjectsLocationsWasmPluginsGetCall) View(view string) *ProjectsLocationsWasmPluginsGetCall { + 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 *ProjectsLocationsWasmPluginsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsWasmPluginsGetCall { + 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 *ProjectsLocationsWasmPluginsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsWasmPluginsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsWasmPluginsGetCall) Context(ctx context.Context) *ProjectsLocationsWasmPluginsGetCall { + 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 *ProjectsLocationsWasmPluginsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsWasmPluginsGetCall) 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 "networkservices.projects.locations.wasmPlugins.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *WasmPlugin.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 *ProjectsLocationsWasmPluginsGetCall) Do(opts ...googleapi.CallOption) (*WasmPlugin, 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 := &WasmPlugin{ + 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 ProjectsLocationsWasmPluginsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists `WasmPlugin` resources in a given project and location. +// +// - parent: The project and location from which the `WasmPlugin` resources are +// listed, specified in the following format: +// `projects/{project}/locations/global`. +func (r *ProjectsLocationsWasmPluginsService) List(parent string) *ProjectsLocationsWasmPluginsListCall { + c := &ProjectsLocationsWasmPluginsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": Maximum number of +// `WasmPlugin` resources to return per call. If not specified, at most 50 +// `WasmPlugin`s are returned. The maximum value is 1000; values above 1000 are +// coerced to 1000. +func (c *ProjectsLocationsWasmPluginsListCall) PageSize(pageSize int64) *ProjectsLocationsWasmPluginsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The value returned by the +// last `ListWasmPluginsResponse` call. Indicates that this is a continuation +// of a prior `ListWasmPlugins` call, and that the next page of data is to be +// returned. +func (c *ProjectsLocationsWasmPluginsListCall) PageToken(pageToken string) *ProjectsLocationsWasmPluginsListCall { + 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 *ProjectsLocationsWasmPluginsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsWasmPluginsListCall { + 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 *ProjectsLocationsWasmPluginsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsWasmPluginsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsWasmPluginsListCall) Context(ctx context.Context) *ProjectsLocationsWasmPluginsListCall { + 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 *ProjectsLocationsWasmPluginsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsWasmPluginsListCall) 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}/wasmPlugins") + 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 "networkservices.projects.locations.wasmPlugins.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *ListWasmPluginsResponse.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 *ProjectsLocationsWasmPluginsListCall) Do(opts ...googleapi.CallOption) (*ListWasmPluginsResponse, 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 := &ListWasmPluginsResponse{ + 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 *ProjectsLocationsWasmPluginsListCall) Pages(ctx context.Context, f func(*ListWasmPluginsResponse) 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 ProjectsLocationsWasmPluginsPatchCall struct { + s *Service + name string + wasmplugin *WasmPlugin + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates the parameters of the specified `WasmPlugin` resource. +// +// - name: Identifier. Name of the `WasmPlugin` resource in the following +// format: +// `projects/{project}/locations/{location}/wasmPlugins/{wasm_plugin}`. +func (r *ProjectsLocationsWasmPluginsService) Patch(name string, wasmplugin *WasmPlugin) *ProjectsLocationsWasmPluginsPatchCall { + c := &ProjectsLocationsWasmPluginsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.wasmplugin = wasmplugin + return c +} + +// UpdateMask sets the optional parameter "updateMask": Used to specify the +// fields to be overwritten in the `WasmPlugin` resource by the update. The +// fields specified in the `update_mask` field are relative to the resource, +// not the full request. An omitted `update_mask` field is treated as an +// implied `update_mask` field equivalent to all fields that are populated +// (that have a non-empty value). The `update_mask` field supports a special +// value `*`, which means that each field in the given `WasmPlugin` resource +// (including the empty ones) replaces the current value. +func (c *ProjectsLocationsWasmPluginsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsWasmPluginsPatchCall { + 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 *ProjectsLocationsWasmPluginsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsWasmPluginsPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsWasmPluginsPatchCall) Context(ctx context.Context) *ProjectsLocationsWasmPluginsPatchCall { + 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 *ProjectsLocationsWasmPluginsPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsWasmPluginsPatchCall) 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.wasmplugin) + 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 "networkservices.projects.locations.wasmPlugins.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 *ProjectsLocationsWasmPluginsPatchCall) 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 ProjectsLocationsWasmPluginsVersionsCreateCall struct { + s *Service + parent string + wasmpluginversion *WasmPluginVersion + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a new `WasmPluginVersion` resource in a given project and +// location. +// +// - parent: The parent resource of the `WasmPluginVersion` resource. Must be +// in the format +// `projects/{project}/locations/global/wasmPlugins/{wasm_plugin}`. +func (r *ProjectsLocationsWasmPluginsVersionsService) Create(parent string, wasmpluginversion *WasmPluginVersion) *ProjectsLocationsWasmPluginsVersionsCreateCall { + c := &ProjectsLocationsWasmPluginsVersionsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.wasmpluginversion = wasmpluginversion + return c +} + +// WasmPluginVersionId sets the optional parameter "wasmPluginVersionId": +// Required. User-provided ID of the `WasmPluginVersion` resource to be +// created. +func (c *ProjectsLocationsWasmPluginsVersionsCreateCall) WasmPluginVersionId(wasmPluginVersionId string) *ProjectsLocationsWasmPluginsVersionsCreateCall { + c.urlParams_.Set("wasmPluginVersionId", wasmPluginVersionId) + 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 *ProjectsLocationsWasmPluginsVersionsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsWasmPluginsVersionsCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsWasmPluginsVersionsCreateCall) Context(ctx context.Context) *ProjectsLocationsWasmPluginsVersionsCreateCall { + 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 *ProjectsLocationsWasmPluginsVersionsCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsWasmPluginsVersionsCreateCall) 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.wasmpluginversion) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+parent}/versions") + 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 "networkservices.projects.locations.wasmPlugins.versions.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 *ProjectsLocationsWasmPluginsVersionsCreateCall) 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 ProjectsLocationsWasmPluginsVersionsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes the specified `WasmPluginVersion` resource. +// +// - name: A name of the `WasmPluginVersion` resource to delete. Must be in the +// format +// `projects/{project}/locations/global/wasmPlugins/{wasm_plugin}/versions/{wa +// sm_plugin_version}`. +func (r *ProjectsLocationsWasmPluginsVersionsService) Delete(name string) *ProjectsLocationsWasmPluginsVersionsDeleteCall { + c := &ProjectsLocationsWasmPluginsVersionsDeleteCall{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 *ProjectsLocationsWasmPluginsVersionsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsWasmPluginsVersionsDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsWasmPluginsVersionsDeleteCall) Context(ctx context.Context) *ProjectsLocationsWasmPluginsVersionsDeleteCall { + 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 *ProjectsLocationsWasmPluginsVersionsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsWasmPluginsVersionsDeleteCall) 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 "networkservices.projects.locations.wasmPlugins.versions.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 *ProjectsLocationsWasmPluginsVersionsDeleteCall) 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 ProjectsLocationsWasmPluginsVersionsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets details of the specified `WasmPluginVersion` resource. +// +// - name: A name of the `WasmPluginVersion` resource to get. Must be in the +// format +// `projects/{project}/locations/global/wasmPlugins/{wasm_plugin}/versions/{wa +// sm_plugin_version}`. +func (r *ProjectsLocationsWasmPluginsVersionsService) Get(name string) *ProjectsLocationsWasmPluginsVersionsGetCall { + c := &ProjectsLocationsWasmPluginsVersionsGetCall{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 *ProjectsLocationsWasmPluginsVersionsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsWasmPluginsVersionsGetCall { + 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 *ProjectsLocationsWasmPluginsVersionsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsWasmPluginsVersionsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsWasmPluginsVersionsGetCall) Context(ctx context.Context) *ProjectsLocationsWasmPluginsVersionsGetCall { + 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 *ProjectsLocationsWasmPluginsVersionsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsWasmPluginsVersionsGetCall) 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 "networkservices.projects.locations.wasmPlugins.versions.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *WasmPluginVersion.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 *ProjectsLocationsWasmPluginsVersionsGetCall) Do(opts ...googleapi.CallOption) (*WasmPluginVersion, 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 := &WasmPluginVersion{ + 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 ProjectsLocationsWasmPluginsVersionsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists `WasmPluginVersion` resources in a given project and location. +// +// - parent: The `WasmPlugin` resource whose `WasmPluginVersion`s are listed, +// specified in the following format: +// `projects/{project}/locations/global/wasmPlugins/{wasm_plugin}`. +func (r *ProjectsLocationsWasmPluginsVersionsService) List(parent string) *ProjectsLocationsWasmPluginsVersionsListCall { + c := &ProjectsLocationsWasmPluginsVersionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": Maximum number of +// `WasmPluginVersion` resources to return per call. If not specified, at most +// 50 `WasmPluginVersion`s are returned. The maximum value is 1000; values +// above 1000 are coerced to 1000. +func (c *ProjectsLocationsWasmPluginsVersionsListCall) PageSize(pageSize int64) *ProjectsLocationsWasmPluginsVersionsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The value returned by the +// last `ListWasmPluginVersionsResponse` call. Indicates that this is a +// continuation of a prior `ListWasmPluginVersions` call, and that the next +// page of data is to be returned. +func (c *ProjectsLocationsWasmPluginsVersionsListCall) PageToken(pageToken string) *ProjectsLocationsWasmPluginsVersionsListCall { + 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 *ProjectsLocationsWasmPluginsVersionsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsWasmPluginsVersionsListCall { + 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 *ProjectsLocationsWasmPluginsVersionsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsWasmPluginsVersionsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsWasmPluginsVersionsListCall) Context(ctx context.Context) *ProjectsLocationsWasmPluginsVersionsListCall { + 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 *ProjectsLocationsWasmPluginsVersionsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsWasmPluginsVersionsListCall) 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}/versions") + 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 "networkservices.projects.locations.wasmPlugins.versions.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *ListWasmPluginVersionsResponse.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 *ProjectsLocationsWasmPluginsVersionsListCall) Do(opts ...googleapi.CallOption) (*ListWasmPluginVersionsResponse, 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 := &ListWasmPluginVersionsResponse{ + 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 *ProjectsLocationsWasmPluginsVersionsListCall) Pages(ctx context.Context, f func(*ListWasmPluginVersionsResponse) 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/notebooks/v1/notebooks-api.json b/notebooks/v1/notebooks-api.json index 88ac34d4d58..66ab3fe04b4 100644 --- a/notebooks/v1/notebooks-api.json +++ b/notebooks/v1/notebooks-api.json @@ -2008,7 +2008,7 @@ } } }, - "revision": "20240918", + "revision": "20241016", "rootUrl": "https://notebooks.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -2132,7 +2132,7 @@ "description": "Required. Defines flags that are used to run the diagnostic tool" }, "timeoutMinutes": { - "description": "Optional. Maxmium amount of time in minutes before the operation times out.", + "description": "Optional. Maximum amount of time in minutes before the operation times out.", "format": "int32", "type": "integer" } @@ -2148,7 +2148,7 @@ "description": "Required. Defines flags that are used to run the diagnostic tool" }, "timeoutMinutes": { - "description": "Optional. Maxmium amount of time in minutes before the operation times out.", + "description": "Optional. Maximum amount of time in minutes before the operation times out.", "format": "int32", "type": "integer" } diff --git a/notebooks/v1/notebooks-gen.go b/notebooks/v1/notebooks-gen.go index f04d73f20f9..ae721276a9c 100644 --- a/notebooks/v1/notebooks-gen.go +++ b/notebooks/v1/notebooks-gen.go @@ -459,7 +459,7 @@ type DiagnoseInstanceRequest struct { // DiagnosticConfig: Required. Defines flags that are used to run the // diagnostic tool DiagnosticConfig *DiagnosticConfig `json:"diagnosticConfig,omitempty"` - // TimeoutMinutes: Optional. Maxmium amount of time in minutes before the + // TimeoutMinutes: Optional. Maximum amount of time in minutes before the // operation times out. TimeoutMinutes int64 `json:"timeoutMinutes,omitempty"` // ForceSendFields is a list of field names (e.g. "DiagnosticConfig") to @@ -486,7 +486,7 @@ type DiagnoseRuntimeRequest struct { // DiagnosticConfig: Required. Defines flags that are used to run the // diagnostic tool DiagnosticConfig *DiagnosticConfig `json:"diagnosticConfig,omitempty"` - // TimeoutMinutes: Optional. Maxmium amount of time in minutes before the + // TimeoutMinutes: Optional. Maximum amount of time in minutes before the // operation times out. TimeoutMinutes int64 `json:"timeoutMinutes,omitempty"` // ForceSendFields is a list of field names (e.g. "DiagnosticConfig") to diff --git a/notebooks/v2/notebooks-api.json b/notebooks/v2/notebooks-api.json index 2de9e62dc9d..6bf661bb1ac 100644 --- a/notebooks/v2/notebooks-api.json +++ b/notebooks/v2/notebooks-api.json @@ -904,7 +904,7 @@ } } }, - "revision": "20240918", + "revision": "20241016", "rootUrl": "https://notebooks.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -1168,7 +1168,7 @@ "description": "Required. Defines flags that are used to run the diagnostic tool" }, "timeoutMinutes": { - "description": "Optional. Maxmium amount of time in minutes before the operation times out.", + "description": "Optional. Maximum amount of time in minutes before the operation times out.", "format": "int32", "type": "integer" } diff --git a/notebooks/v2/notebooks-gen.go b/notebooks/v2/notebooks-gen.go index 01dfaec4d28..73069179478 100644 --- a/notebooks/v2/notebooks-gen.go +++ b/notebooks/v2/notebooks-gen.go @@ -586,7 +586,7 @@ type DiagnoseInstanceRequest struct { // DiagnosticConfig: Required. Defines flags that are used to run the // diagnostic tool DiagnosticConfig *DiagnosticConfig `json:"diagnosticConfig,omitempty"` - // TimeoutMinutes: Optional. Maxmium amount of time in minutes before the + // TimeoutMinutes: Optional. Maximum amount of time in minutes before the // operation times out. TimeoutMinutes int64 `json:"timeoutMinutes,omitempty"` // ForceSendFields is a list of field names (e.g. "DiagnosticConfig") to diff --git a/option/option.go b/option/option.go index 23aba01b628..687047c54ce 100644 --- a/option/option.go +++ b/option/option.go @@ -359,8 +359,6 @@ func (w withAuthCredentials) Apply(o *internal.DialSettings) { } // WithUniverseDomain returns a ClientOption that sets the universe domain. -// -// This is an EXPERIMENTAL API and may be changed or removed in the future. func WithUniverseDomain(ud string) ClientOption { return withUniverseDomain(ud) } diff --git a/orgpolicy/v2/orgpolicy-api.json b/orgpolicy/v2/orgpolicy-api.json index 272de1ed45a..d529ce4df38 100644 --- a/orgpolicy/v2/orgpolicy-api.json +++ b/orgpolicy/v2/orgpolicy-api.json @@ -930,7 +930,7 @@ } } }, - "revision": "20240513", + "revision": "20241021", "rootUrl": "https://orgpolicy.googleapis.com/", "schemas": { "GoogleCloudOrgpolicyV2AlternatePolicySpec": { @@ -996,7 +996,136 @@ "GoogleCloudOrgpolicyV2ConstraintBooleanConstraint": { "description": "A constraint that is either enforced or not. For example, a constraint `constraints/compute.disableSerialPortAccess`. If it is enforced on a VM instance, serial port connections will not be opened to that instance.", "id": "GoogleCloudOrgpolicyV2ConstraintBooleanConstraint", - "properties": {}, + "properties": { + "customConstraintDefinition": { + "$ref": "GoogleCloudOrgpolicyV2ConstraintCustomConstraintDefinition", + "description": "Custom constraint definition. This is set only for Managed Constraints" + } + }, + "type": "object" + }, + "GoogleCloudOrgpolicyV2ConstraintCustomConstraintDefinition": { + "description": "Currently used for Managed Constraints. This represents a subset of fields missing from Constraint proto that are required to describe CustomConstraint", + "id": "GoogleCloudOrgpolicyV2ConstraintCustomConstraintDefinition", + "properties": { + "actionType": { + "description": "Allow or deny type.", + "enum": [ + "ACTION_TYPE_UNSPECIFIED", + "ALLOW", + "DENY" + ], + "enumDescriptions": [ + "Unspecified. Results in an error.", + "Allowed action type.", + "Deny action type." + ], + "type": "string" + }, + "condition": { + "description": "Org policy condition/expression. For example: `resource.instanceName.matches(\"[production|test]_.*_(\\d)+\")` or, `resource.management.auto_upgrade == true` The max length of the condition is 1000 characters.", + "type": "string" + }, + "methodTypes": { + "description": "All the operations being applied for this constraint.", + "items": { + "enum": [ + "METHOD_TYPE_UNSPECIFIED", + "CREATE", + "UPDATE", + "DELETE", + "REMOVE_GRANT", + "GOVERN_TAGS" + ], + "enumDescriptions": [ + "Unspecified. Results in an error.", + "Constraint applied when creating the resource.", + "Constraint applied when updating the resource.", + "Constraint applied when deleting the resource. Not supported yet.", + "Constraint applied when removing an IAM grant.", + "Constraint applied when enforcing forced tagging." + ], + "type": "string" + }, + "type": "array" + }, + "parameters": { + "additionalProperties": { + "$ref": "GoogleCloudOrgpolicyV2ConstraintCustomConstraintDefinitionParameter" + }, + "description": "Stores Structure of parameters used by Constraint condition. Key of map represents name of the parameter.", + "type": "object" + }, + "resourceTypes": { + "description": "The resource instance type on which this policy applies. Format will be of the form : `/` Example: * `compute.googleapis.com/Instance`.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudOrgpolicyV2ConstraintCustomConstraintDefinitionParameter": { + "description": "Defines a parameter structure.", + "id": "GoogleCloudOrgpolicyV2ConstraintCustomConstraintDefinitionParameter", + "properties": { + "defaultValue": { + "description": "Sets the value of the parameter in an assignment if no value is given.", + "type": "any" + }, + "item": { + "description": "Determines the parameter’s value structure. For example, LIST can be specified by defining type : LIST, and item type as : STRING.", + "enum": [ + "TYPE_UNSPECIFIED", + "LIST", + "STRING", + "BOOLEAN" + ], + "enumDescriptions": [ + "Unspecified. Results in an error.", + "List parameter type.", + "String parameter type.", + "Boolean parameter type." + ], + "type": "string" + }, + "metadata": { + "$ref": "GoogleCloudOrgpolicyV2ConstraintCustomConstraintDefinitionParameterMetadata", + "description": "Defines subproperties primarily used by the UI to display user-friendly information." + }, + "type": { + "description": "Type of the parameter.", + "enum": [ + "TYPE_UNSPECIFIED", + "LIST", + "STRING", + "BOOLEAN" + ], + "enumDescriptions": [ + "Unspecified. Results in an error.", + "List parameter type.", + "String parameter type.", + "Boolean parameter type." + ], + "type": "string" + }, + "validValuesExpr": { + "description": "Provides a CEL expression to specify the acceptable parameter values during assignment. For example, parameterName in (\"parameterValue1\", \"parameterValue2\")", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudOrgpolicyV2ConstraintCustomConstraintDefinitionParameterMetadata": { + "description": "Defines Medata structure.", + "id": "GoogleCloudOrgpolicyV2ConstraintCustomConstraintDefinitionParameterMetadata", + "properties": { + "description": { + "description": "Detailed description of what this `parameter` is and use of it. Mutable.", + "type": "string" + } + }, "type": "object" }, "GoogleCloudOrgpolicyV2ConstraintListConstraint": { diff --git a/orgpolicy/v2/orgpolicy-gen.go b/orgpolicy/v2/orgpolicy-gen.go index 62214d78c19..2afecd91d38 100644 --- a/orgpolicy/v2/orgpolicy-gen.go +++ b/orgpolicy/v2/orgpolicy-gen.go @@ -363,6 +363,149 @@ func (s GoogleCloudOrgpolicyV2Constraint) MarshalJSON() ([]byte, error) { // `constraints/compute.disableSerialPortAccess`. If it is enforced on a VM // instance, serial port connections will not be opened to that instance. type GoogleCloudOrgpolicyV2ConstraintBooleanConstraint struct { + // CustomConstraintDefinition: Custom constraint definition. This is set only + // for Managed Constraints + CustomConstraintDefinition *GoogleCloudOrgpolicyV2ConstraintCustomConstraintDefinition `json:"customConstraintDefinition,omitempty"` + // ForceSendFields is a list of field names (e.g. "CustomConstraintDefinition") + // to unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CustomConstraintDefinition") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudOrgpolicyV2ConstraintBooleanConstraint) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudOrgpolicyV2ConstraintBooleanConstraint + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudOrgpolicyV2ConstraintCustomConstraintDefinition: Currently used +// for Managed Constraints. This represents a subset of fields missing from +// Constraint proto that are required to describe CustomConstraint +type GoogleCloudOrgpolicyV2ConstraintCustomConstraintDefinition struct { + // ActionType: Allow or deny type. + // + // Possible values: + // "ACTION_TYPE_UNSPECIFIED" - Unspecified. Results in an error. + // "ALLOW" - Allowed action type. + // "DENY" - Deny action type. + ActionType string `json:"actionType,omitempty"` + // Condition: Org policy condition/expression. For example: + // `resource.instanceName.matches("[production|test]_.*_(\d)+")` or, + // `resource.management.auto_upgrade == true` The max length of the condition + // is 1000 characters. + Condition string `json:"condition,omitempty"` + // MethodTypes: All the operations being applied for this constraint. + // + // Possible values: + // "METHOD_TYPE_UNSPECIFIED" - Unspecified. Results in an error. + // "CREATE" - Constraint applied when creating the resource. + // "UPDATE" - Constraint applied when updating the resource. + // "DELETE" - Constraint applied when deleting the resource. Not supported + // yet. + // "REMOVE_GRANT" - Constraint applied when removing an IAM grant. + // "GOVERN_TAGS" - Constraint applied when enforcing forced tagging. + MethodTypes []string `json:"methodTypes,omitempty"` + // Parameters: Stores Structure of parameters used by Constraint condition. Key + // of map represents name of the parameter. + Parameters map[string]GoogleCloudOrgpolicyV2ConstraintCustomConstraintDefinitionParameter `json:"parameters,omitempty"` + // ResourceTypes: The resource instance type on which this policy applies. + // Format will be of the form : `/` Example: * + // `compute.googleapis.com/Instance`. + ResourceTypes []string `json:"resourceTypes,omitempty"` + // ForceSendFields is a list of field names (e.g. "ActionType") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ActionType") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudOrgpolicyV2ConstraintCustomConstraintDefinition) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudOrgpolicyV2ConstraintCustomConstraintDefinition + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudOrgpolicyV2ConstraintCustomConstraintDefinitionParameter: Defines +// a parameter structure. +type GoogleCloudOrgpolicyV2ConstraintCustomConstraintDefinitionParameter struct { + // DefaultValue: Sets the value of the parameter in an assignment if no value + // is given. + DefaultValue interface{} `json:"defaultValue,omitempty"` + // Item: Determines the parameter’s value structure. For example, LIST can be + // specified by defining type : LIST, and item type as : STRING. + // + // Possible values: + // "TYPE_UNSPECIFIED" - Unspecified. Results in an error. + // "LIST" - List parameter type. + // "STRING" - String parameter type. + // "BOOLEAN" - Boolean parameter type. + Item string `json:"item,omitempty"` + // Metadata: Defines subproperties primarily used by the UI to display + // user-friendly information. + Metadata *GoogleCloudOrgpolicyV2ConstraintCustomConstraintDefinitionParameterMetadata `json:"metadata,omitempty"` + // Type: Type of the parameter. + // + // Possible values: + // "TYPE_UNSPECIFIED" - Unspecified. Results in an error. + // "LIST" - List parameter type. + // "STRING" - String parameter type. + // "BOOLEAN" - Boolean parameter type. + Type string `json:"type,omitempty"` + // ValidValuesExpr: Provides a CEL expression to specify the acceptable + // parameter values during assignment. For example, parameterName in + // ("parameterValue1", "parameterValue2") + ValidValuesExpr string `json:"validValuesExpr,omitempty"` + // ForceSendFields is a list of field names (e.g. "DefaultValue") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "DefaultValue") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudOrgpolicyV2ConstraintCustomConstraintDefinitionParameter) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudOrgpolicyV2ConstraintCustomConstraintDefinitionParameter + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudOrgpolicyV2ConstraintCustomConstraintDefinitionParameterMetadata: +// Defines Medata structure. +type GoogleCloudOrgpolicyV2ConstraintCustomConstraintDefinitionParameterMetadata struct { + // Description: Detailed description of what this `parameter` is and use of it. + // Mutable. + Description string `json:"description,omitempty"` + // ForceSendFields is a list of field names (e.g. "Description") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Description") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudOrgpolicyV2ConstraintCustomConstraintDefinitionParameterMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudOrgpolicyV2ConstraintCustomConstraintDefinitionParameterMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } // GoogleCloudOrgpolicyV2ConstraintListConstraint: A constraint that allows or diff --git a/osconfig/v2beta/osconfig-api.json b/osconfig/v2beta/osconfig-api.json new file mode 100644 index 00000000000..18321a3b34e --- /dev/null +++ b/osconfig/v2beta/osconfig-api.json @@ -0,0 +1,2274 @@ +{ + "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://osconfig.googleapis.com/", + "batchPath": "batch", + "canonicalName": "OS Config", + "description": "OS management tools that can be used for patch management, patch compliance, and configuration management on VM instances.", + "discoveryVersion": "v1", + "documentationLink": "https://cloud.google.com/compute/docs/osconfig/rest", + "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": "osconfig:v2beta", + "kind": "discovery#restDescription", + "mtlsRootUrl": "https://osconfig.mtls.googleapis.com/", + "name": "osconfig", + "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": { + "folders": { + "resources": { + "locations": { + "resources": { + "global": { + "resources": { + "policyOrchestrators": { + "methods": { + "create": { + "description": "Creates a new policy orchestrator under the given folder resource. `name` field of the given orchestrator are ignored and instead replaced by a product of `parent` and `policy_orchestrator_id`. Orchestrator state field might be only set to `ACTIVE`, `STOPPED` or omitted (in which case, the created resource will be in `ACTIVE` state anyway).", + "flatPath": "v2beta/folders/{foldersId}/locations/global/policyOrchestrators", + "httpMethod": "POST", + "id": "osconfig.folders.locations.global.policyOrchestrators.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent resource name in the form of: `organizations/{organization_id}/locations/global` `folders/{folder_id}/locations/global` 'projects/{project_id_or_number}/locations/global'", + "location": "path", + "pattern": "^folders/[^/]+/locations/global$", + "required": true, + "type": "string" + }, + "policyOrchestratorId": { + "description": "Required. The logical identifier of the policy orchestrator, with the following restrictions: * Must contain only lowercase letters, numbers, and hyphens. * Must start with a letter. * Must be between 1-63 characters. * Must end with a number or a letter. * Must be unique within the parent.", + "location": "query", + "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 since 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" + } + }, + "path": "v2beta/{+parent}/policyOrchestrators", + "request": { + "$ref": "GoogleCloudOsconfigV2beta__PolicyOrchestrator" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes an existing policy orchestrator resource, parented by a folder.", + "flatPath": "v2beta/folders/{foldersId}/locations/global/policyOrchestrators/{policyOrchestratorsId}", + "httpMethod": "DELETE", + "id": "osconfig.folders.locations.global.policyOrchestrators.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "etag": { + "description": "Optional. The current etag of the policy orchestrator. If an etag is provided and does not match the current etag of the policy orchestrator, deletion will be blocked and an ABORTED error will be returned.", + "location": "query", + "type": "string" + }, + "name": { + "description": "Required. Name of the resource to be deleted.", + "location": "path", + "pattern": "^folders/[^/]+/locations/global/policyOrchestrators/[^/]+$", + "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" + } + }, + "path": "v2beta/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Retrieves an existing policy orchestrator, parented by a folder.", + "flatPath": "v2beta/folders/{foldersId}/locations/global/policyOrchestrators/{policyOrchestratorsId}", + "httpMethod": "GET", + "id": "osconfig.folders.locations.global.policyOrchestrators.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource name.", + "location": "path", + "pattern": "^folders/[^/]+/locations/global/policyOrchestrators/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+name}", + "response": { + "$ref": "GoogleCloudOsconfigV2beta__PolicyOrchestrator" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists the policy orchestrators under the given parent folder resource.", + "flatPath": "v2beta/folders/{foldersId}/locations/global/policyOrchestrators", + "httpMethod": "GET", + "id": "osconfig.folders.locations.global.policyOrchestrators.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "Optional. Filtering results", + "location": "query", + "type": "string" + }, + "orderBy": { + "description": "Optional. Hint for how to order the results", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. A token identifying a page of results the server should return.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent resource name.", + "location": "path", + "pattern": "^folders/[^/]+/locations/global$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+parent}/policyOrchestrators", + "response": { + "$ref": "GoogleCloudOsconfigV2beta__ListPolicyOrchestratorsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Updates an existing policy orchestrator, parented by a folder.", + "flatPath": "v2beta/folders/{foldersId}/locations/global/policyOrchestrators/{policyOrchestratorsId}", + "httpMethod": "PATCH", + "id": "osconfig.folders.locations.global.policyOrchestrators.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Immutable. Identifier. In form of * `organizations/{organization_id}/locations/global/policyOrchestrators/{orchestrator_id}` * `folders/{folder_id}/locations/global/policyOrchestrators/{orchestrator_id}` * `projects/{project_id_or_number}/locations/global/policyOrchestrators/{orchestrator_id}`", + "location": "path", + "pattern": "^folders/[^/]+/locations/global/policyOrchestrators/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Optional. The list of fields to update.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v2beta/{+name}", + "request": { + "$ref": "GoogleCloudOsconfigV2beta__PolicyOrchestrator" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + }, + "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/folders/{foldersId}/locations/{locationsId}/operations/{operationsId}:cancel", + "httpMethod": "POST", + "id": "osconfig.folders.locations.operations.cancel", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to be cancelled.", + "location": "path", + "pattern": "^folders/[^/]+/locations/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+name}:cancel", + "request": { + "$ref": "CancelOperationRequest" + }, + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "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`.", + "flatPath": "v2beta/folders/{foldersId}/locations/{locationsId}/operations/{operationsId}", + "httpMethod": "DELETE", + "id": "osconfig.folders.locations.operations.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to be deleted.", + "location": "path", + "pattern": "^folders/[^/]+/locations/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+name}", + "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/folders/{foldersId}/locations/{locationsId}/operations/{operationsId}", + "httpMethod": "GET", + "id": "osconfig.folders.locations.operations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource.", + "location": "path", + "pattern": "^folders/[^/]+/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/folders/{foldersId}/locations/{locationsId}/operations", + "httpMethod": "GET", + "id": "osconfig.folders.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": "^folders/[^/]+/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" + ] + } + } + } + } + } + } + }, + "organizations": { + "resources": { + "locations": { + "resources": { + "global": { + "resources": { + "policyOrchestrators": { + "methods": { + "create": { + "description": "Creates a new policy orchestrator under the given organizations resource. `name` field of the given orchestrator are ignored and instead replaced by a product of `parent` and `policy_orchestrator_id`. Orchestrator state field might be only set to `ACTIVE`, `STOPPED` or omitted (in which case, the created resource will be in `ACTIVE` state anyway).", + "flatPath": "v2beta/organizations/{organizationsId}/locations/global/policyOrchestrators", + "httpMethod": "POST", + "id": "osconfig.organizations.locations.global.policyOrchestrators.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent resource name in the form of: `organizations/{organization_id}/locations/global` `folders/{folder_id}/locations/global` 'projects/{project_id_or_number}/locations/global'", + "location": "path", + "pattern": "^organizations/[^/]+/locations/global$", + "required": true, + "type": "string" + }, + "policyOrchestratorId": { + "description": "Required. The logical identifier of the policy orchestrator, with the following restrictions: * Must contain only lowercase letters, numbers, and hyphens. * Must start with a letter. * Must be between 1-63 characters. * Must end with a number or a letter. * Must be unique within the parent.", + "location": "query", + "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 since 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" + } + }, + "path": "v2beta/{+parent}/policyOrchestrators", + "request": { + "$ref": "GoogleCloudOsconfigV2beta__PolicyOrchestrator" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes an existing policy orchestrator resource, parented by an organization.", + "flatPath": "v2beta/organizations/{organizationsId}/locations/global/policyOrchestrators/{policyOrchestratorsId}", + "httpMethod": "DELETE", + "id": "osconfig.organizations.locations.global.policyOrchestrators.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "etag": { + "description": "Optional. The current etag of the policy orchestrator. If an etag is provided and does not match the current etag of the policy orchestrator, deletion will be blocked and an ABORTED error will be returned.", + "location": "query", + "type": "string" + }, + "name": { + "description": "Required. Name of the resource to be deleted.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/global/policyOrchestrators/[^/]+$", + "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" + } + }, + "path": "v2beta/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Retrieves an existing policy orchestrator, parented by an organization.", + "flatPath": "v2beta/organizations/{organizationsId}/locations/global/policyOrchestrators/{policyOrchestratorsId}", + "httpMethod": "GET", + "id": "osconfig.organizations.locations.global.policyOrchestrators.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource name.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/global/policyOrchestrators/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+name}", + "response": { + "$ref": "GoogleCloudOsconfigV2beta__PolicyOrchestrator" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists the policy orchestrators under the given parent organization resource.", + "flatPath": "v2beta/organizations/{organizationsId}/locations/global/policyOrchestrators", + "httpMethod": "GET", + "id": "osconfig.organizations.locations.global.policyOrchestrators.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "Optional. Filtering results", + "location": "query", + "type": "string" + }, + "orderBy": { + "description": "Optional. Hint for how to order the results", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. A token identifying a page of results the server should return.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent resource name.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/global$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+parent}/policyOrchestrators", + "response": { + "$ref": "GoogleCloudOsconfigV2beta__ListPolicyOrchestratorsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Updates an existing policy orchestrator, parented by an organization.", + "flatPath": "v2beta/organizations/{organizationsId}/locations/global/policyOrchestrators/{policyOrchestratorsId}", + "httpMethod": "PATCH", + "id": "osconfig.organizations.locations.global.policyOrchestrators.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Immutable. Identifier. In form of * `organizations/{organization_id}/locations/global/policyOrchestrators/{orchestrator_id}` * `folders/{folder_id}/locations/global/policyOrchestrators/{orchestrator_id}` * `projects/{project_id_or_number}/locations/global/policyOrchestrators/{orchestrator_id}`", + "location": "path", + "pattern": "^organizations/[^/]+/locations/global/policyOrchestrators/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Optional. The list of fields to update.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v2beta/{+name}", + "request": { + "$ref": "GoogleCloudOsconfigV2beta__PolicyOrchestrator" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + }, + "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/organizations/{organizationsId}/locations/{locationsId}/operations/{operationsId}:cancel", + "httpMethod": "POST", + "id": "osconfig.organizations.locations.operations.cancel", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to be cancelled.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+name}:cancel", + "request": { + "$ref": "CancelOperationRequest" + }, + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "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`.", + "flatPath": "v2beta/organizations/{organizationsId}/locations/{locationsId}/operations/{operationsId}", + "httpMethod": "DELETE", + "id": "osconfig.organizations.locations.operations.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to be deleted.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+name}", + "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/organizations/{organizationsId}/locations/{locationsId}/operations/{operationsId}", + "httpMethod": "GET", + "id": "osconfig.organizations.locations.operations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource.", + "location": "path", + "pattern": "^organizations/[^/]+/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/organizations/{organizationsId}/locations/{locationsId}/operations", + "httpMethod": "GET", + "id": "osconfig.organizations.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": "^organizations/[^/]+/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" + ] + } + } + } + } + } + } + }, + "projects": { + "resources": { + "locations": { + "resources": { + "global": { + "resources": { + "policyOrchestrators": { + "methods": { + "create": { + "description": "Creates a new policy orchestrator under the given project resource. `name` field of the given orchestrator are ignored and instead replaced by a product of `parent` and `policy_orchestrator_id`. Orchestrator state field might be only set to `ACTIVE`, `STOPPED` or omitted (in which case, the created resource will be in `ACTIVE` state anyway).", + "flatPath": "v2beta/projects/{projectsId}/locations/global/policyOrchestrators", + "httpMethod": "POST", + "id": "osconfig.projects.locations.global.policyOrchestrators.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent resource name in the form of: `organizations/{organization_id}/locations/global` `folders/{folder_id}/locations/global` 'projects/{project_id_or_number}/locations/global'", + "location": "path", + "pattern": "^projects/[^/]+/locations/global$", + "required": true, + "type": "string" + }, + "policyOrchestratorId": { + "description": "Required. The logical identifier of the policy orchestrator, with the following restrictions: * Must contain only lowercase letters, numbers, and hyphens. * Must start with a letter. * Must be between 1-63 characters. * Must end with a number or a letter. * Must be unique within the parent.", + "location": "query", + "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 since 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" + } + }, + "path": "v2beta/{+parent}/policyOrchestrators", + "request": { + "$ref": "GoogleCloudOsconfigV2beta__PolicyOrchestrator" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes an existing policy orchestrator resource, parented by a project.", + "flatPath": "v2beta/projects/{projectsId}/locations/global/policyOrchestrators/{policyOrchestratorsId}", + "httpMethod": "DELETE", + "id": "osconfig.projects.locations.global.policyOrchestrators.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "etag": { + "description": "Optional. The current etag of the policy orchestrator. If an etag is provided and does not match the current etag of the policy orchestrator, deletion will be blocked and an ABORTED error will be returned.", + "location": "query", + "type": "string" + }, + "name": { + "description": "Required. Name of the resource to be deleted.", + "location": "path", + "pattern": "^projects/[^/]+/locations/global/policyOrchestrators/[^/]+$", + "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" + } + }, + "path": "v2beta/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Retrieves an existing policy orchestrator, parented by a project.", + "flatPath": "v2beta/projects/{projectsId}/locations/global/policyOrchestrators/{policyOrchestratorsId}", + "httpMethod": "GET", + "id": "osconfig.projects.locations.global.policyOrchestrators.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource name.", + "location": "path", + "pattern": "^projects/[^/]+/locations/global/policyOrchestrators/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+name}", + "response": { + "$ref": "GoogleCloudOsconfigV2beta__PolicyOrchestrator" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists the policy orchestrators under the given parent project resource.", + "flatPath": "v2beta/projects/{projectsId}/locations/global/policyOrchestrators", + "httpMethod": "GET", + "id": "osconfig.projects.locations.global.policyOrchestrators.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "Optional. Filtering results", + "location": "query", + "type": "string" + }, + "orderBy": { + "description": "Optional. Hint for how to order the results", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. A token identifying a page of results the server should return.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent resource name.", + "location": "path", + "pattern": "^projects/[^/]+/locations/global$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+parent}/policyOrchestrators", + "response": { + "$ref": "GoogleCloudOsconfigV2beta__ListPolicyOrchestratorsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Updates an existing policy orchestrator, parented by a project.", + "flatPath": "v2beta/projects/{projectsId}/locations/global/policyOrchestrators/{policyOrchestratorsId}", + "httpMethod": "PATCH", + "id": "osconfig.projects.locations.global.policyOrchestrators.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Immutable. Identifier. In form of * `organizations/{organization_id}/locations/global/policyOrchestrators/{orchestrator_id}` * `folders/{folder_id}/locations/global/policyOrchestrators/{orchestrator_id}` * `projects/{project_id_or_number}/locations/global/policyOrchestrators/{orchestrator_id}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/global/policyOrchestrators/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Optional. The list of fields to update.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v2beta/{+name}", + "request": { + "$ref": "GoogleCloudOsconfigV2beta__PolicyOrchestrator" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + }, + "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": "osconfig.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" + ] + }, + "delete": { + "description": "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`.", + "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", + "httpMethod": "DELETE", + "id": "osconfig.projects.locations.operations.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to be deleted.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+name}", + "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": "osconfig.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": "osconfig.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": "20241028", + "rootUrl": "https://osconfig.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" + }, + "FixedOrPercent": { + "description": "Message encapsulating a value that can be either absolute (\"fixed\") or relative (\"percent\") to a value.", + "id": "FixedOrPercent", + "properties": { + "fixed": { + "description": "Specifies a fixed value.", + "format": "int32", + "type": "integer" + }, + "percent": { + "description": "Specifies the relative value defined as a percentage, which will be multiplied by a reference value.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "GoogleCloudOsconfigV1__OSPolicyAssignmentOperationMetadata": { + "description": "OS policy assignment operation metadata provided by OS policy assignment API methods that return long running operations.", + "id": "GoogleCloudOsconfigV1__OSPolicyAssignmentOperationMetadata", + "properties": { + "apiMethod": { + "description": "The OS policy assignment API method.", + "enum": [ + "API_METHOD_UNSPECIFIED", + "CREATE", + "UPDATE", + "DELETE" + ], + "enumDescriptions": [ + "Invalid value", + "Create OS policy assignment API method", + "Update OS policy assignment API method", + "Delete OS policy assignment API method" + ], + "type": "string" + }, + "osPolicyAssignment": { + "description": "Reference to the `OSPolicyAssignment` API resource. Format: `projects/{project_number}/locations/{location}/osPolicyAssignments/{os_policy_assignment_id@revision_id}`", + "type": "string" + }, + "rolloutStartTime": { + "description": "Rollout start time", + "format": "google-datetime", + "type": "string" + }, + "rolloutState": { + "description": "State of the rollout", + "enum": [ + "ROLLOUT_STATE_UNSPECIFIED", + "IN_PROGRESS", + "CANCELLING", + "CANCELLED", + "SUCCEEDED" + ], + "enumDescriptions": [ + "Invalid value", + "The rollout is in progress.", + "The rollout is being cancelled.", + "The rollout is cancelled.", + "The rollout has completed successfully." + ], + "type": "string" + }, + "rolloutUpdateTime": { + "description": "Rollout update time", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudOsconfigV2beta_OrchestrationScope_LocationSelector": { + "description": "Selector containing locations in scope.", + "id": "GoogleCloudOsconfigV2beta_OrchestrationScope_LocationSelector", + "properties": { + "includedLocations": { + "description": "Optional. Names of the locations in scope. Format: `us-central1-a`", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudOsconfigV2beta_OrchestrationScope_ResourceHierarchySelector": { + "description": "Selector containing Cloud Resource Manager resource hierarchy nodes.", + "id": "GoogleCloudOsconfigV2beta_OrchestrationScope_ResourceHierarchySelector", + "properties": { + "includedFolders": { + "description": "Optional. Names of the folders in scope. Format: `folders/{folder_id}`", + "items": { + "type": "string" + }, + "type": "array" + }, + "includedProjects": { + "description": "Optional. Names of the projects in scope. Format: `projects/{project_number}`", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudOsconfigV2beta_OrchestrationScope_Selector": { + "description": "Selector for the resources in scope of orchestration.", + "id": "GoogleCloudOsconfigV2beta_OrchestrationScope_Selector", + "properties": { + "locationSelector": { + "$ref": "GoogleCloudOsconfigV2beta_OrchestrationScope_LocationSelector", + "description": "Selector for selecting locations." + }, + "resourceHierarchySelector": { + "$ref": "GoogleCloudOsconfigV2beta_OrchestrationScope_ResourceHierarchySelector", + "description": "Selector for selecting resource hierarchy." + } + }, + "type": "object" + }, + "GoogleCloudOsconfigV2beta_PolicyOrchestrator_IterationState": { + "description": "Describes the state of a single iteration of the orchestrator.", + "id": "GoogleCloudOsconfigV2beta_PolicyOrchestrator_IterationState", + "properties": { + "error": { + "$ref": "Status", + "description": "Output only. Error thrown in the wave iteration.", + "readOnly": true + }, + "failedActions": { + "description": "Output only. Number of orchestration actions which failed so far. For more details, query the Cloud Logs.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "finishTime": { + "description": "Output only. Finish time of the wave iteration.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "performedActions": { + "description": "Output only. Overall number of actions done by the orchestrator so far.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "progress": { + "description": "Output only. An estimated percentage of the progress. Number between 0 and 100.", + "format": "float", + "readOnly": true, + "type": "number" + }, + "rolloutResource": { + "description": "Output only. Handle to the Progressive Rollouts API rollout resource, which contains detailed information about a particular orchestration iteration.", + "readOnly": true, + "type": "string" + }, + "startTime": { + "description": "Output only. Start time of the wave iteration.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "state": { + "description": "Output only. State of the iteration.", + "enum": [ + "STATE_UNSPECIFIED", + "PROCESSING", + "COMPLETED", + "FAILED", + "CANCELLED", + "UNKNOWN" + ], + "enumDescriptions": [ + "Default value. This value is unused.", + "Iteration is in progress.", + "Iteration completed, with all actions being successful.", + "Iteration completed, with failures.", + "Iteration was explicitly cancelled.", + "Impossible to determine current state of the iteration." + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudOsconfigV2beta_PolicyOrchestrator_OrchestrationState": { + "description": "Describes the state of the orchestration process.", + "id": "GoogleCloudOsconfigV2beta_PolicyOrchestrator_OrchestrationState", + "properties": { + "currentIterationState": { + "$ref": "GoogleCloudOsconfigV2beta_PolicyOrchestrator_IterationState", + "description": "Output only. Current Wave iteration state.", + "readOnly": true + }, + "previousIterationState": { + "$ref": "GoogleCloudOsconfigV2beta_PolicyOrchestrator_IterationState", + "description": "Output only. Previous Wave iteration state.", + "readOnly": true + } + }, + "type": "object" + }, + "GoogleCloudOsconfigV2beta__ListPolicyOrchestratorsResponse": { + "description": "Response for the list policy orchestrator resources.", + "id": "GoogleCloudOsconfigV2beta__ListPolicyOrchestratorsResponse", + "properties": { + "nextPageToken": { + "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", + "type": "string" + }, + "policyOrchestrators": { + "description": "The policy orchestrators for the specified parent resource.", + "items": { + "$ref": "GoogleCloudOsconfigV2beta__PolicyOrchestrator" + }, + "type": "array" + }, + "unreachable": { + "description": "Locations that could not be reached.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudOsconfigV2beta__OperationMetadata": { + "description": "Represents the metadata of the long-running operation.", + "id": "GoogleCloudOsconfigV2beta__OperationMetadata", + "properties": { + "apiVersion": { + "description": "Output only. API version used to start the operation.", + "readOnly": true, + "type": "string" + }, + "createTime": { + "description": "Output only. The time the operation was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "endTime": { + "description": "Output only. The time the operation finished running.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "requestedCancellation": { + "description": "Output only. Identifies whether the user has requested cancellation of the operation. Operations that have been cancelled successfully have Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", + "readOnly": true, + "type": "boolean" + }, + "statusMessage": { + "description": "Output only. Human-readable status of the operation, if any.", + "readOnly": true, + "type": "string" + }, + "target": { + "description": "Output only. Server-defined resource path for the target of the operation.", + "readOnly": true, + "type": "string" + }, + "verb": { + "description": "Output only. Name of the verb executed by the operation.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudOsconfigV2beta__OrchestratedResource": { + "description": "Represents a resource that is being orchestrated by the policy orchestrator.", + "id": "GoogleCloudOsconfigV2beta__OrchestratedResource", + "properties": { + "id": { + "description": "Optional. ID of the resource to be used while generating set of affected resources. For UPSERT action the value is auto-generated during PolicyOrchestrator creation when not set. When the value is set it should following next restrictions: * Must contain only lowercase letters, numbers, and hyphens. * Must start with a letter. * Must be between 1-63 characters. * Must end with a number or a letter. * Must be unique within the project. For DELETE action, ID must be specified explicitly during PolicyOrchestrator creation.", + "type": "string" + }, + "osPolicyAssignmentV1Payload": { + "$ref": "OSPolicyAssignment", + "description": "Optional. OSPolicyAssignment resource to be created, updated or deleted. Name field is ignored and replace with a generated value. With this field set, orchestrator will perform actions on `project/{project}/locations/{zone}/osPolicyAssignments/{resource_id}` resources, where `project` and `zone` pairs come from the expanded scope, and `resource_id` comes from the `resource_id` field of orchestrator resource." + } + }, + "type": "object" + }, + "GoogleCloudOsconfigV2beta__OrchestrationScope": { + "description": "Defines a set of selectors which drive which resources are in scope of policy orchestration.", + "id": "GoogleCloudOsconfigV2beta__OrchestrationScope", + "properties": { + "selectors": { + "description": "Optional. Selectors of the orchestration scope. There is a logical AND between each selector defined. When there is no explicit `ResourceHierarchySelector` selector specified, the scope is by default bounded to the parent of the policy orchestrator resource.", + "items": { + "$ref": "GoogleCloudOsconfigV2beta_OrchestrationScope_Selector" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudOsconfigV2beta__PolicyOrchestrator": { + "description": "PolicyOrchestrator helps managing project+zone level policy resources (e.g. OS Policy Assignments), by providing tools to create, update and delete them across projects and locations, at scale. Policy orchestrator functions as an endless loop. Each iteration orchestrator computes a set of resources that should be affected, then progressively applies changes to them. If for some reason this set of resources changes over time (e.g. new projects are added), the future loop iterations will address that. Orchestrator can either upsert or delete policy resources. For more details, see the description of the `action`, and `orchestrated_resource` fields. Note that policy orchestrator do not \"manage\" the resources it creates. Every iteration is independent and only minimal history of past actions is retained (apart from Cloud Logging). If orchestrator gets deleted, it does not affect the resources it created in the past. Those will remain where they were. Same applies if projects are removed from the orchestrator's scope.", + "id": "GoogleCloudOsconfigV2beta__PolicyOrchestrator", + "properties": { + "action": { + "description": "Required. Action to be done by the orchestrator in `projects/{project_id}/zones/{zone_id}` locations defined by the `orchestration_scope`. Allowed values: - `UPSERT` - Orchestrator will create or update target resources. - `DELETE` - Orchestrator will delete target resources, if they exist", + "type": "string" + }, + "createTime": { + "description": "Output only. Timestamp when the policy orchestrator resource was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "Optional. Freeform text describing the purpose of the resource.", + "type": "string" + }, + "etag": { + "description": "Output only. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.", + "readOnly": true, + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Labels as key value pairs", + "type": "object" + }, + "name": { + "description": "Immutable. Identifier. In form of * `organizations/{organization_id}/locations/global/policyOrchestrators/{orchestrator_id}` * `folders/{folder_id}/locations/global/policyOrchestrators/{orchestrator_id}` * `projects/{project_id_or_number}/locations/global/policyOrchestrators/{orchestrator_id}`", + "type": "string" + }, + "orchestratedResource": { + "$ref": "GoogleCloudOsconfigV2beta__OrchestratedResource", + "description": "Required. Resource to be orchestrated by the policy orchestrator." + }, + "orchestrationScope": { + "$ref": "GoogleCloudOsconfigV2beta__OrchestrationScope", + "description": "Optional. Defines scope for the orchestration, in context of the enclosing PolicyOrchestrator resource. Scope is expanded into a list of pairs, in which the rollout action will take place. Expansion starts with a Folder resource parenting the PolicyOrchestrator resource: - All the descendant projects are listed. - List of project is cross joined with a list of all available zones. - Resulting list of pairs is filtered according to the selectors." + }, + "orchestrationState": { + "$ref": "GoogleCloudOsconfigV2beta_PolicyOrchestrator_OrchestrationState", + "description": "Output only. State of the orchestration.", + "readOnly": true + }, + "reconciling": { + "description": "Output only. Set to true, if the there are ongoing changes being applied by the orchestrator.", + "readOnly": true, + "type": "boolean" + }, + "state": { + "description": "Optional. State of the orchestrator. Can be updated to change orchestrator behaviour. Allowed values: - `ACTIVE` - orchestrator is actively looking for actions to be taken. - `STOPPED` - orchestrator won't make any changes. Note: There might be more states added in the future. We use string here instead of an enum, to avoid the need of propagating new states to all the client code.", + "type": "string" + }, + "updateTime": { + "description": "Output only. Timestamp when the policy orchestrator resource was last modified.", + "format": "google-datetime", + "readOnly": true, + "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" + }, + "OSPolicy": { + "description": "An OS policy defines the desired state configuration for a VM.", + "id": "OSPolicy", + "properties": { + "allowNoResourceGroupMatch": { + "description": "This flag determines the OS policy compliance status when none of the resource groups within the policy are applicable for a VM. Set this value to `true` if the policy needs to be reported as compliant even if the policy has nothing to validate or enforce.", + "type": "boolean" + }, + "description": { + "description": "Policy description. Length of the description is limited to 1024 characters.", + "type": "string" + }, + "id": { + "description": "Required. The id of the OS policy with the following restrictions: * Must contain only lowercase letters, numbers, and hyphens. * Must start with a letter. * Must be between 1-63 characters. * Must end with a number or a letter. * Must be unique within the assignment.", + "type": "string" + }, + "mode": { + "description": "Required. Policy mode", + "enum": [ + "MODE_UNSPECIFIED", + "VALIDATION", + "ENFORCEMENT" + ], + "enumDescriptions": [ + "Invalid mode", + "This mode checks if the configuration resources in the policy are in their desired state. No actions are performed if they are not in the desired state. This mode is used for reporting purposes.", + "This mode checks if the configuration resources in the policy are in their desired state, and if not, enforces the desired state." + ], + "type": "string" + }, + "resourceGroups": { + "description": "Required. List of resource groups for the policy. For a particular VM, resource groups are evaluated in the order specified and the first resource group that is applicable is selected and the rest are ignored. If none of the resource groups are applicable for a VM, the VM is considered to be non-compliant w.r.t this policy. This behavior can be toggled by the flag `allow_no_resource_group_match`", + "items": { + "$ref": "OSPolicyResourceGroup" + }, + "type": "array" + } + }, + "type": "object" + }, + "OSPolicyAssignment": { + "description": "OS policy assignment is an API resource that is used to apply a set of OS policies to a dynamically targeted group of Compute Engine VM instances. An OS policy is used to define the desired state configuration for a Compute Engine VM instance through a set of configuration resources that provide capabilities such as installing or removing software packages, or executing a script. For more information about the OS policy resource definitions and examples, see [OS policy and OS policy assignment](https://cloud.google.com/compute/docs/os-configuration-management/working-with-os-policies).", + "id": "OSPolicyAssignment", + "properties": { + "baseline": { + "description": "Output only. Indicates that this revision has been successfully rolled out in this zone and new VMs will be assigned OS policies from this revision. For a given OS policy assignment, there is only one revision with a value of `true` for this field.", + "readOnly": true, + "type": "boolean" + }, + "deleted": { + "description": "Output only. Indicates that this revision deletes the OS policy assignment.", + "readOnly": true, + "type": "boolean" + }, + "description": { + "description": "OS policy assignment description. Length of the description is limited to 1024 characters.", + "type": "string" + }, + "etag": { + "description": "The etag for this OS policy assignment. If this is provided on update, it must match the server's etag.", + "type": "string" + }, + "instanceFilter": { + "$ref": "OSPolicyAssignmentInstanceFilter", + "description": "Required. Filter to select VMs." + }, + "name": { + "description": "Resource name. Format: `projects/{project_number}/locations/{location}/osPolicyAssignments/{os_policy_assignment_id}` This field is ignored when you create an OS policy assignment.", + "type": "string" + }, + "osPolicies": { + "description": "Required. List of OS policies to be applied to the VMs.", + "items": { + "$ref": "OSPolicy" + }, + "type": "array" + }, + "reconciling": { + "description": "Output only. Indicates that reconciliation is in progress for the revision. This value is `true` when the `rollout_state` is one of: * IN_PROGRESS * CANCELLING", + "readOnly": true, + "type": "boolean" + }, + "revisionCreateTime": { + "description": "Output only. The timestamp that the revision was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "revisionId": { + "description": "Output only. The assignment revision ID A new revision is committed whenever a rollout is triggered for a OS policy assignment", + "readOnly": true, + "type": "string" + }, + "rollout": { + "$ref": "OSPolicyAssignmentRollout", + "description": "Required. Rollout to deploy the OS policy assignment. A rollout is triggered in the following situations: 1) OSPolicyAssignment is created. 2) OSPolicyAssignment is updated and the update contains changes to one of the following fields: - instance_filter - os_policies 3) OSPolicyAssignment is deleted." + }, + "rolloutState": { + "description": "Output only. OS policy assignment rollout state", + "enum": [ + "ROLLOUT_STATE_UNSPECIFIED", + "IN_PROGRESS", + "CANCELLING", + "CANCELLED", + "SUCCEEDED" + ], + "enumDescriptions": [ + "Invalid value", + "The rollout is in progress.", + "The rollout is being cancelled.", + "The rollout is cancelled.", + "The rollout has completed successfully." + ], + "readOnly": true, + "type": "string" + }, + "uid": { + "description": "Output only. Server generated unique id for the OS policy assignment resource.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "OSPolicyAssignmentInstanceFilter": { + "description": "Filters to select target VMs for an assignment. If more than one filter criteria is specified below, a VM will be selected if and only if it satisfies all of them.", + "id": "OSPolicyAssignmentInstanceFilter", + "properties": { + "all": { + "description": "Target all VMs in the project. If true, no other criteria is permitted.", + "type": "boolean" + }, + "exclusionLabels": { + "description": "List of label sets used for VM exclusion. If the list has more than one label set, the VM is excluded if any of the label sets are applicable for the VM.", + "items": { + "$ref": "OSPolicyAssignmentLabelSet" + }, + "type": "array" + }, + "inclusionLabels": { + "description": "List of label sets used for VM inclusion. If the list has more than one `LabelSet`, the VM is included if any of the label sets are applicable for the VM.", + "items": { + "$ref": "OSPolicyAssignmentLabelSet" + }, + "type": "array" + }, + "inventories": { + "description": "List of inventories to select VMs. A VM is selected if its inventory data matches at least one of the following inventories.", + "items": { + "$ref": "OSPolicyAssignmentInstanceFilterInventory" + }, + "type": "array" + } + }, + "type": "object" + }, + "OSPolicyAssignmentInstanceFilterInventory": { + "description": "VM inventory details.", + "id": "OSPolicyAssignmentInstanceFilterInventory", + "properties": { + "osShortName": { + "description": "Required. The OS short name", + "type": "string" + }, + "osVersion": { + "description": "The OS version Prefix matches are supported if asterisk(*) is provided as the last character. For example, to match all versions with a major version of `7`, specify the following value for this field `7.*` An empty string matches all OS versions.", + "type": "string" + } + }, + "type": "object" + }, + "OSPolicyAssignmentLabelSet": { + "description": "Message representing label set. * A label is a key value pair set for a VM. * A LabelSet is a set of labels. * Labels within a LabelSet are ANDed. In other words, a LabelSet is applicable for a VM only if it matches all the labels in the LabelSet. * Example: A LabelSet with 2 labels: `env=prod` and `type=webserver` will only be applicable for those VMs with both labels present.", + "id": "OSPolicyAssignmentLabelSet", + "properties": { + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Labels are identified by key/value pairs in this map. A VM should contain all the key/value pairs specified in this map to be selected.", + "type": "object" + } + }, + "type": "object" + }, + "OSPolicyAssignmentOperationMetadata": { + "description": "OS policy assignment operation metadata provided by OS policy assignment API methods that return long running operations.", + "id": "OSPolicyAssignmentOperationMetadata", + "properties": { + "apiMethod": { + "description": "The OS policy assignment API method.", + "enum": [ + "API_METHOD_UNSPECIFIED", + "CREATE", + "UPDATE", + "DELETE" + ], + "enumDescriptions": [ + "Invalid value", + "Create OS policy assignment API method", + "Update OS policy assignment API method", + "Delete OS policy assignment API method" + ], + "type": "string" + }, + "osPolicyAssignment": { + "description": "Reference to the `OSPolicyAssignment` API resource. Format: `projects/{project_number}/locations/{location}/osPolicyAssignments/{os_policy_assignment_id@revision_id}`", + "type": "string" + }, + "rolloutStartTime": { + "description": "Rollout start time", + "format": "google-datetime", + "type": "string" + }, + "rolloutState": { + "description": "State of the rollout", + "enum": [ + "ROLLOUT_STATE_UNSPECIFIED", + "IN_PROGRESS", + "CANCELLING", + "CANCELLED", + "SUCCEEDED" + ], + "enumDescriptions": [ + "Invalid value", + "The rollout is in progress.", + "The rollout is being cancelled.", + "The rollout is cancelled.", + "The rollout has completed successfully." + ], + "type": "string" + }, + "rolloutUpdateTime": { + "description": "Rollout update time", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "OSPolicyAssignmentRollout": { + "description": "Message to configure the rollout at the zonal level for the OS policy assignment.", + "id": "OSPolicyAssignmentRollout", + "properties": { + "disruptionBudget": { + "$ref": "FixedOrPercent", + "description": "Required. The maximum number (or percentage) of VMs per zone to disrupt at any given moment." + }, + "minWaitDuration": { + "description": "Required. This determines the minimum duration of time to wait after the configuration changes are applied through the current rollout. A VM continues to count towards the `disruption_budget` at least until this duration of time has passed after configuration changes are applied.", + "format": "google-duration", + "type": "string" + } + }, + "type": "object" + }, + "OSPolicyInventoryFilter": { + "description": "Filtering criteria to select VMs based on inventory details.", + "id": "OSPolicyInventoryFilter", + "properties": { + "osShortName": { + "description": "Required. The OS short name", + "type": "string" + }, + "osVersion": { + "description": "The OS version Prefix matches are supported if asterisk(*) is provided as the last character. For example, to match all versions with a major version of `7`, specify the following value for this field `7.*` An empty string matches all OS versions.", + "type": "string" + } + }, + "type": "object" + }, + "OSPolicyResource": { + "description": "An OS policy resource is used to define the desired state configuration and provides a specific functionality like installing/removing packages, executing a script etc. The system ensures that resources are always in their desired state by taking necessary actions if they have drifted from their desired state.", + "id": "OSPolicyResource", + "properties": { + "exec": { + "$ref": "OSPolicyResourceExecResource", + "description": "Exec resource" + }, + "file": { + "$ref": "OSPolicyResourceFileResource", + "description": "File resource" + }, + "id": { + "description": "Required. The id of the resource with the following restrictions: * Must contain only lowercase letters, numbers, and hyphens. * Must start with a letter. * Must be between 1-63 characters. * Must end with a number or a letter. * Must be unique within the OS policy.", + "type": "string" + }, + "pkg": { + "$ref": "OSPolicyResourcePackageResource", + "description": "Package resource" + }, + "repository": { + "$ref": "OSPolicyResourceRepositoryResource", + "description": "Package repository resource" + } + }, + "type": "object" + }, + "OSPolicyResourceExecResource": { + "description": "A resource that allows executing scripts on the VM. The `ExecResource` has 2 stages: `validate` and `enforce` and both stages accept a script as an argument to execute. When the `ExecResource` is applied by the agent, it first executes the script in the `validate` stage. The `validate` stage can signal that the `ExecResource` is already in the desired state by returning an exit code of `100`. If the `ExecResource` is not in the desired state, it should return an exit code of `101`. Any other exit code returned by this stage is considered an error. If the `ExecResource` is not in the desired state based on the exit code from the `validate` stage, the agent proceeds to execute the script from the `enforce` stage. If the `ExecResource` is already in the desired state, the `enforce` stage will not be run. Similar to `validate` stage, the `enforce` stage should return an exit code of `100` to indicate that the resource in now in its desired state. Any other exit code is considered an error. NOTE: An exit code of `100` was chosen over `0` (and `101` vs `1`) to have an explicit indicator of `in desired state`, `not in desired state` and errors. Because, for example, Powershell will always return an exit code of `0` unless an `exit` statement is provided in the script. So, for reasons of consistency and being explicit, exit codes `100` and `101` were chosen.", + "id": "OSPolicyResourceExecResource", + "properties": { + "enforce": { + "$ref": "OSPolicyResourceExecResourceExec", + "description": "What to run to bring this resource into the desired state. An exit code of 100 indicates \"success\", any other exit code indicates a failure running enforce." + }, + "validate": { + "$ref": "OSPolicyResourceExecResourceExec", + "description": "Required. What to run to validate this resource is in the desired state. An exit code of 100 indicates \"in desired state\", and exit code of 101 indicates \"not in desired state\". Any other exit code indicates a failure running validate." + } + }, + "type": "object" + }, + "OSPolicyResourceExecResourceExec": { + "description": "A file or script to execute.", + "id": "OSPolicyResourceExecResourceExec", + "properties": { + "args": { + "description": "Optional arguments to pass to the source during execution.", + "items": { + "type": "string" + }, + "type": "array" + }, + "file": { + "$ref": "OSPolicyResourceFile", + "description": "A remote or local file." + }, + "interpreter": { + "description": "Required. The script interpreter to use.", + "enum": [ + "INTERPRETER_UNSPECIFIED", + "NONE", + "SHELL", + "POWERSHELL" + ], + "enumDescriptions": [ + "Invalid value, the request will return validation error.", + "If an interpreter is not specified, the source is executed directly. This execution, without an interpreter, only succeeds for executables and scripts that have shebang lines.", + "Indicates that the script runs with `/bin/sh` on Linux and `cmd.exe` on Windows.", + "Indicates that the script runs with PowerShell." + ], + "type": "string" + }, + "outputFilePath": { + "description": "Only recorded for enforce Exec. Path to an output file (that is created by this Exec) whose content will be recorded in OSPolicyResourceCompliance after a successful run. Absence or failure to read this file will result in this ExecResource being non-compliant. Output file size is limited to 500K bytes.", + "type": "string" + }, + "script": { + "description": "An inline script. The size of the script is limited to 32KiB.", + "type": "string" + } + }, + "type": "object" + }, + "OSPolicyResourceFile": { + "description": "A remote or local file.", + "id": "OSPolicyResourceFile", + "properties": { + "allowInsecure": { + "description": "Defaults to false. When false, files are subject to validations based on the file type: Remote: A checksum must be specified. Cloud Storage: An object generation number must be specified.", + "type": "boolean" + }, + "gcs": { + "$ref": "OSPolicyResourceFileGcs", + "description": "A Cloud Storage object." + }, + "localPath": { + "description": "A local path within the VM to use.", + "type": "string" + }, + "remote": { + "$ref": "OSPolicyResourceFileRemote", + "description": "A generic remote file." + } + }, + "type": "object" + }, + "OSPolicyResourceFileGcs": { + "description": "Specifies a file available as a Cloud Storage Object.", + "id": "OSPolicyResourceFileGcs", + "properties": { + "bucket": { + "description": "Required. Bucket of the Cloud Storage object.", + "type": "string" + }, + "generation": { + "description": "Generation number of the Cloud Storage object.", + "format": "int64", + "type": "string" + }, + "object": { + "description": "Required. Name of the Cloud Storage object.", + "type": "string" + } + }, + "type": "object" + }, + "OSPolicyResourceFileRemote": { + "description": "Specifies a file available via some URI.", + "id": "OSPolicyResourceFileRemote", + "properties": { + "sha256Checksum": { + "description": "SHA256 checksum of the remote file.", + "type": "string" + }, + "uri": { + "description": "Required. URI from which to fetch the object. It should contain both the protocol and path following the format `{protocol}://{location}`.", + "type": "string" + } + }, + "type": "object" + }, + "OSPolicyResourceFileResource": { + "description": "A resource that manages the state of a file.", + "id": "OSPolicyResourceFileResource", + "properties": { + "content": { + "description": "A a file with this content. The size of the content is limited to 32KiB.", + "type": "string" + }, + "file": { + "$ref": "OSPolicyResourceFile", + "description": "A remote or local source." + }, + "path": { + "description": "Required. The absolute path of the file within the VM.", + "type": "string" + }, + "permissions": { + "description": "Consists of three octal digits which represent, in order, the permissions of the owner, group, and other users for the file (similarly to the numeric mode used in the linux chmod utility). Each digit represents a three bit number with the 4 bit corresponding to the read permissions, the 2 bit corresponds to the write bit, and the one bit corresponds to the execute permission. Default behavior is 755. Below are some examples of permissions and their associated values: read, write, and execute: 7 read and execute: 5 read and write: 6 read only: 4", + "type": "string" + }, + "state": { + "description": "Required. Desired state of the file.", + "enum": [ + "DESIRED_STATE_UNSPECIFIED", + "PRESENT", + "ABSENT", + "CONTENTS_MATCH" + ], + "enumDescriptions": [ + "Unspecified is invalid.", + "Ensure file at path is present.", + "Ensure file at path is absent.", + "Ensure the contents of the file at path matches. If the file does not exist it will be created." + ], + "type": "string" + } + }, + "type": "object" + }, + "OSPolicyResourceGroup": { + "description": "Resource groups provide a mechanism to group OS policy resources. Resource groups enable OS policy authors to create a single OS policy to be applied to VMs running different operating Systems. When the OS policy is applied to a target VM, the appropriate resource group within the OS policy is selected based on the `OSFilter` specified within the resource group.", + "id": "OSPolicyResourceGroup", + "properties": { + "inventoryFilters": { + "description": "List of inventory filters for the resource group. The resources in this resource group are applied to the target VM if it satisfies at least one of the following inventory filters. For example, to apply this resource group to VMs running either `RHEL` or `CentOS` operating systems, specify 2 items for the list with following values: inventory_filters[0].os_short_name='rhel' and inventory_filters[1].os_short_name='centos' If the list is empty, this resource group will be applied to the target VM unconditionally.", + "items": { + "$ref": "OSPolicyInventoryFilter" + }, + "type": "array" + }, + "resources": { + "description": "Required. List of resources configured for this resource group. The resources are executed in the exact order specified here.", + "items": { + "$ref": "OSPolicyResource" + }, + "type": "array" + } + }, + "type": "object" + }, + "OSPolicyResourcePackageResource": { + "description": "A resource that manages a system package.", + "id": "OSPolicyResourcePackageResource", + "properties": { + "apt": { + "$ref": "OSPolicyResourcePackageResourceAPT", + "description": "A package managed by Apt." + }, + "deb": { + "$ref": "OSPolicyResourcePackageResourceDeb", + "description": "A deb package file." + }, + "desiredState": { + "description": "Required. The desired state the agent should maintain for this package.", + "enum": [ + "DESIRED_STATE_UNSPECIFIED", + "INSTALLED", + "REMOVED" + ], + "enumDescriptions": [ + "Unspecified is invalid.", + "Ensure that the package is installed.", + "The agent ensures that the package is not installed and uninstalls it if detected." + ], + "type": "string" + }, + "googet": { + "$ref": "OSPolicyResourcePackageResourceGooGet", + "description": "A package managed by GooGet." + }, + "msi": { + "$ref": "OSPolicyResourcePackageResourceMSI", + "description": "An MSI package." + }, + "rpm": { + "$ref": "OSPolicyResourcePackageResourceRPM", + "description": "An rpm package file." + }, + "yum": { + "$ref": "OSPolicyResourcePackageResourceYUM", + "description": "A package managed by YUM." + }, + "zypper": { + "$ref": "OSPolicyResourcePackageResourceZypper", + "description": "A package managed by Zypper." + } + }, + "type": "object" + }, + "OSPolicyResourcePackageResourceAPT": { + "description": "A package managed by APT. - install: `apt-get update \u0026\u0026 apt-get -y install [name]` - remove: `apt-get -y remove [name]`", + "id": "OSPolicyResourcePackageResourceAPT", + "properties": { + "name": { + "description": "Required. Package name.", + "type": "string" + } + }, + "type": "object" + }, + "OSPolicyResourcePackageResourceDeb": { + "description": "A deb package file. dpkg packages only support INSTALLED state.", + "id": "OSPolicyResourcePackageResourceDeb", + "properties": { + "pullDeps": { + "description": "Whether dependencies should also be installed. - install when false: `dpkg -i package` - install when true: `apt-get update \u0026\u0026 apt-get -y install package.deb`", + "type": "boolean" + }, + "source": { + "$ref": "OSPolicyResourceFile", + "description": "Required. A deb package." + } + }, + "type": "object" + }, + "OSPolicyResourcePackageResourceGooGet": { + "description": "A package managed by GooGet. - install: `googet -noconfirm install package` - remove: `googet -noconfirm remove package`", + "id": "OSPolicyResourcePackageResourceGooGet", + "properties": { + "name": { + "description": "Required. Package name.", + "type": "string" + } + }, + "type": "object" + }, + "OSPolicyResourcePackageResourceMSI": { + "description": "An MSI package. MSI packages only support INSTALLED state.", + "id": "OSPolicyResourcePackageResourceMSI", + "properties": { + "properties": { + "description": "Additional properties to use during installation. This should be in the format of Property=Setting. Appended to the defaults of `ACTION=INSTALL REBOOT=ReallySuppress`.", + "items": { + "type": "string" + }, + "type": "array" + }, + "source": { + "$ref": "OSPolicyResourceFile", + "description": "Required. The MSI package." + } + }, + "type": "object" + }, + "OSPolicyResourcePackageResourceRPM": { + "description": "An RPM package file. RPM packages only support INSTALLED state.", + "id": "OSPolicyResourcePackageResourceRPM", + "properties": { + "pullDeps": { + "description": "Whether dependencies should also be installed. - install when false: `rpm --upgrade --replacepkgs package.rpm` - install when true: `yum -y install package.rpm` or `zypper -y install package.rpm`", + "type": "boolean" + }, + "source": { + "$ref": "OSPolicyResourceFile", + "description": "Required. An rpm package." + } + }, + "type": "object" + }, + "OSPolicyResourcePackageResourceYUM": { + "description": "A package managed by YUM. - install: `yum -y install package` - remove: `yum -y remove package`", + "id": "OSPolicyResourcePackageResourceYUM", + "properties": { + "name": { + "description": "Required. Package name.", + "type": "string" + } + }, + "type": "object" + }, + "OSPolicyResourcePackageResourceZypper": { + "description": "A package managed by Zypper. - install: `zypper -y install package` - remove: `zypper -y rm package`", + "id": "OSPolicyResourcePackageResourceZypper", + "properties": { + "name": { + "description": "Required. Package name.", + "type": "string" + } + }, + "type": "object" + }, + "OSPolicyResourceRepositoryResource": { + "description": "A resource that manages a package repository.", + "id": "OSPolicyResourceRepositoryResource", + "properties": { + "apt": { + "$ref": "OSPolicyResourceRepositoryResourceAptRepository", + "description": "An Apt Repository." + }, + "goo": { + "$ref": "OSPolicyResourceRepositoryResourceGooRepository", + "description": "A Goo Repository." + }, + "yum": { + "$ref": "OSPolicyResourceRepositoryResourceYumRepository", + "description": "A Yum Repository." + }, + "zypper": { + "$ref": "OSPolicyResourceRepositoryResourceZypperRepository", + "description": "A Zypper Repository." + } + }, + "type": "object" + }, + "OSPolicyResourceRepositoryResourceAptRepository": { + "description": "Represents a single apt package repository. These will be added to a repo file that will be managed at `/etc/apt/sources.list.d/google_osconfig.list`.", + "id": "OSPolicyResourceRepositoryResourceAptRepository", + "properties": { + "archiveType": { + "description": "Required. Type of archive files in this repository.", + "enum": [ + "ARCHIVE_TYPE_UNSPECIFIED", + "DEB", + "DEB_SRC" + ], + "enumDescriptions": [ + "Unspecified is invalid.", + "Deb indicates that the archive contains binary files.", + "Deb-src indicates that the archive contains source files." + ], + "type": "string" + }, + "components": { + "description": "Required. List of components for this repository. Must contain at least one item.", + "items": { + "type": "string" + }, + "type": "array" + }, + "distribution": { + "description": "Required. Distribution of this repository.", + "type": "string" + }, + "gpgKey": { + "description": "URI of the key file for this repository. The agent maintains a keyring at `/etc/apt/trusted.gpg.d/osconfig_agent_managed.gpg`.", + "type": "string" + }, + "uri": { + "description": "Required. URI for this repository.", + "type": "string" + } + }, + "type": "object" + }, + "OSPolicyResourceRepositoryResourceGooRepository": { + "description": "Represents a Goo package repository. These are added to a repo file that is managed at `C:/ProgramData/GooGet/repos/google_osconfig.repo`.", + "id": "OSPolicyResourceRepositoryResourceGooRepository", + "properties": { + "name": { + "description": "Required. The name of the repository.", + "type": "string" + }, + "url": { + "description": "Required. The url of the repository.", + "type": "string" + } + }, + "type": "object" + }, + "OSPolicyResourceRepositoryResourceYumRepository": { + "description": "Represents a single yum package repository. These are added to a repo file that is managed at `/etc/yum.repos.d/google_osconfig.repo`.", + "id": "OSPolicyResourceRepositoryResourceYumRepository", + "properties": { + "baseUrl": { + "description": "Required. The location of the repository directory.", + "type": "string" + }, + "displayName": { + "description": "The display name of the repository.", + "type": "string" + }, + "gpgKeys": { + "description": "URIs of GPG keys.", + "items": { + "type": "string" + }, + "type": "array" + }, + "id": { + "description": "Required. A one word, unique name for this repository. This is the `repo id` in the yum config file and also the `display_name` if `display_name` is omitted. This id is also used as the unique identifier when checking for resource conflicts.", + "type": "string" + } + }, + "type": "object" + }, + "OSPolicyResourceRepositoryResourceZypperRepository": { + "description": "Represents a single zypper package repository. These are added to a repo file that is managed at `/etc/zypp/repos.d/google_osconfig.repo`.", + "id": "OSPolicyResourceRepositoryResourceZypperRepository", + "properties": { + "baseUrl": { + "description": "Required. The location of the repository directory.", + "type": "string" + }, + "displayName": { + "description": "The display name of the repository.", + "type": "string" + }, + "gpgKeys": { + "description": "URIs of GPG keys.", + "items": { + "type": "string" + }, + "type": "array" + }, + "id": { + "description": "Required. A one word, unique name for this repository. This is the `repo id` in the zypper config file and also the `display_name` if `display_name` is omitted. This id is also used as the unique identifier when checking for GuestPolicy conflicts.", + "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": "Status", + "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" + }, + "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", + "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" + } + }, + "servicePath": "", + "title": "OS Config API", + "version": "v2beta", + "version_module": true +} \ No newline at end of file diff --git a/osconfig/v2beta/osconfig-gen.go b/osconfig/v2beta/osconfig-gen.go new file mode 100644 index 00000000000..e8e1f4af191 --- /dev/null +++ b/osconfig/v2beta/osconfig-gen.go @@ -0,0 +1,5212 @@ +// 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 osconfig provides access to the OS Config API. +// +// For product documentation, see: https://cloud.google.com/compute/docs/osconfig/rest +// +// # 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/osconfig/v2beta" +// ... +// ctx := context.Background() +// osconfigService, err := osconfig.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]: +// +// osconfigService, err := osconfig.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, ...) +// osconfigService, err := osconfig.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token))) +// +// See [google.golang.org/api/option.ClientOption] for details on options. +package osconfig // import "google.golang.org/api/osconfig/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 = "osconfig:v2beta" +const apiName = "osconfig" +const apiVersion = "v2beta" +const basePath = "https://osconfig.googleapis.com/" +const basePathTemplate = "https://osconfig.UNIVERSE_DOMAIN/" +const mtlsBasePath = "https://osconfig.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.Folders = NewFoldersService(s) + s.Organizations = NewOrganizationsService(s) + 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 + + Folders *FoldersService + + Organizations *OrganizationsService + + Projects *ProjectsService +} + +func (s *Service) userAgent() string { + if s.UserAgent == "" { + return googleapi.UserAgent + } + return googleapi.UserAgent + " " + s.UserAgent +} + +func NewFoldersService(s *Service) *FoldersService { + rs := &FoldersService{s: s} + rs.Locations = NewFoldersLocationsService(s) + return rs +} + +type FoldersService struct { + s *Service + + Locations *FoldersLocationsService +} + +func NewFoldersLocationsService(s *Service) *FoldersLocationsService { + rs := &FoldersLocationsService{s: s} + rs.Global = NewFoldersLocationsGlobalService(s) + rs.Operations = NewFoldersLocationsOperationsService(s) + return rs +} + +type FoldersLocationsService struct { + s *Service + + Global *FoldersLocationsGlobalService + + Operations *FoldersLocationsOperationsService +} + +func NewFoldersLocationsGlobalService(s *Service) *FoldersLocationsGlobalService { + rs := &FoldersLocationsGlobalService{s: s} + rs.PolicyOrchestrators = NewFoldersLocationsGlobalPolicyOrchestratorsService(s) + return rs +} + +type FoldersLocationsGlobalService struct { + s *Service + + PolicyOrchestrators *FoldersLocationsGlobalPolicyOrchestratorsService +} + +func NewFoldersLocationsGlobalPolicyOrchestratorsService(s *Service) *FoldersLocationsGlobalPolicyOrchestratorsService { + rs := &FoldersLocationsGlobalPolicyOrchestratorsService{s: s} + return rs +} + +type FoldersLocationsGlobalPolicyOrchestratorsService struct { + s *Service +} + +func NewFoldersLocationsOperationsService(s *Service) *FoldersLocationsOperationsService { + rs := &FoldersLocationsOperationsService{s: s} + return rs +} + +type FoldersLocationsOperationsService struct { + s *Service +} + +func NewOrganizationsService(s *Service) *OrganizationsService { + rs := &OrganizationsService{s: s} + rs.Locations = NewOrganizationsLocationsService(s) + return rs +} + +type OrganizationsService struct { + s *Service + + Locations *OrganizationsLocationsService +} + +func NewOrganizationsLocationsService(s *Service) *OrganizationsLocationsService { + rs := &OrganizationsLocationsService{s: s} + rs.Global = NewOrganizationsLocationsGlobalService(s) + rs.Operations = NewOrganizationsLocationsOperationsService(s) + return rs +} + +type OrganizationsLocationsService struct { + s *Service + + Global *OrganizationsLocationsGlobalService + + Operations *OrganizationsLocationsOperationsService +} + +func NewOrganizationsLocationsGlobalService(s *Service) *OrganizationsLocationsGlobalService { + rs := &OrganizationsLocationsGlobalService{s: s} + rs.PolicyOrchestrators = NewOrganizationsLocationsGlobalPolicyOrchestratorsService(s) + return rs +} + +type OrganizationsLocationsGlobalService struct { + s *Service + + PolicyOrchestrators *OrganizationsLocationsGlobalPolicyOrchestratorsService +} + +func NewOrganizationsLocationsGlobalPolicyOrchestratorsService(s *Service) *OrganizationsLocationsGlobalPolicyOrchestratorsService { + rs := &OrganizationsLocationsGlobalPolicyOrchestratorsService{s: s} + return rs +} + +type OrganizationsLocationsGlobalPolicyOrchestratorsService struct { + s *Service +} + +func NewOrganizationsLocationsOperationsService(s *Service) *OrganizationsLocationsOperationsService { + rs := &OrganizationsLocationsOperationsService{s: s} + return rs +} + +type OrganizationsLocationsOperationsService struct { + s *Service +} + +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.Global = NewProjectsLocationsGlobalService(s) + rs.Operations = NewProjectsLocationsOperationsService(s) + return rs +} + +type ProjectsLocationsService struct { + s *Service + + Global *ProjectsLocationsGlobalService + + Operations *ProjectsLocationsOperationsService +} + +func NewProjectsLocationsGlobalService(s *Service) *ProjectsLocationsGlobalService { + rs := &ProjectsLocationsGlobalService{s: s} + rs.PolicyOrchestrators = NewProjectsLocationsGlobalPolicyOrchestratorsService(s) + return rs +} + +type ProjectsLocationsGlobalService struct { + s *Service + + PolicyOrchestrators *ProjectsLocationsGlobalPolicyOrchestratorsService +} + +func NewProjectsLocationsGlobalPolicyOrchestratorsService(s *Service) *ProjectsLocationsGlobalPolicyOrchestratorsService { + rs := &ProjectsLocationsGlobalPolicyOrchestratorsService{s: s} + return rs +} + +type ProjectsLocationsGlobalPolicyOrchestratorsService struct { + s *Service +} + +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:"-"` +} + +// FixedOrPercent: Message encapsulating a value that can be either absolute +// ("fixed") or relative ("percent") to a value. +type FixedOrPercent struct { + // Fixed: Specifies a fixed value. + Fixed int64 `json:"fixed,omitempty"` + // Percent: Specifies the relative value defined as a percentage, which will be + // multiplied by a reference value. + Percent int64 `json:"percent,omitempty"` + // ForceSendFields is a list of field names (e.g. "Fixed") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Fixed") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s FixedOrPercent) MarshalJSON() ([]byte, error) { + type NoMethod FixedOrPercent + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudOsconfigV1__OSPolicyAssignmentOperationMetadata: OS policy +// assignment operation metadata provided by OS policy assignment API methods +// that return long running operations. +type GoogleCloudOsconfigV1__OSPolicyAssignmentOperationMetadata struct { + // ApiMethod: The OS policy assignment API method. + // + // Possible values: + // "API_METHOD_UNSPECIFIED" - Invalid value + // "CREATE" - Create OS policy assignment API method + // "UPDATE" - Update OS policy assignment API method + // "DELETE" - Delete OS policy assignment API method + ApiMethod string `json:"apiMethod,omitempty"` + // OsPolicyAssignment: Reference to the `OSPolicyAssignment` API resource. + // Format: + // `projects/{project_number}/locations/{location}/osPolicyAssignments/{os_polic + // y_assignment_id@revision_id}` + OsPolicyAssignment string `json:"osPolicyAssignment,omitempty"` + // RolloutStartTime: Rollout start time + RolloutStartTime string `json:"rolloutStartTime,omitempty"` + // RolloutState: State of the rollout + // + // Possible values: + // "ROLLOUT_STATE_UNSPECIFIED" - Invalid value + // "IN_PROGRESS" - The rollout is in progress. + // "CANCELLING" - The rollout is being cancelled. + // "CANCELLED" - The rollout is cancelled. + // "SUCCEEDED" - The rollout has completed successfully. + RolloutState string `json:"rolloutState,omitempty"` + // RolloutUpdateTime: Rollout update time + RolloutUpdateTime string `json:"rolloutUpdateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "ApiMethod") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ApiMethod") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudOsconfigV1__OSPolicyAssignmentOperationMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudOsconfigV1__OSPolicyAssignmentOperationMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudOsconfigV2betaOrchestrationScopeLocationSelector: Selector +// containing locations in scope. +type GoogleCloudOsconfigV2betaOrchestrationScopeLocationSelector struct { + // IncludedLocations: Optional. Names of the locations in scope. Format: + // `us-central1-a` + IncludedLocations []string `json:"includedLocations,omitempty"` + // ForceSendFields is a list of field names (e.g. "IncludedLocations") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "IncludedLocations") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudOsconfigV2betaOrchestrationScopeLocationSelector) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudOsconfigV2betaOrchestrationScopeLocationSelector + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudOsconfigV2betaOrchestrationScopeResourceHierarchySelector: +// Selector containing Cloud Resource Manager resource hierarchy nodes. +type GoogleCloudOsconfigV2betaOrchestrationScopeResourceHierarchySelector struct { + // IncludedFolders: Optional. Names of the folders in scope. Format: + // `folders/{folder_id}` + IncludedFolders []string `json:"includedFolders,omitempty"` + // IncludedProjects: Optional. Names of the projects in scope. Format: + // `projects/{project_number}` + IncludedProjects []string `json:"includedProjects,omitempty"` + // ForceSendFields is a list of field names (e.g. "IncludedFolders") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "IncludedFolders") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudOsconfigV2betaOrchestrationScopeResourceHierarchySelector) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudOsconfigV2betaOrchestrationScopeResourceHierarchySelector + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudOsconfigV2betaOrchestrationScopeSelector: Selector for the +// resources in scope of orchestration. +type GoogleCloudOsconfigV2betaOrchestrationScopeSelector struct { + // LocationSelector: Selector for selecting locations. + LocationSelector *GoogleCloudOsconfigV2betaOrchestrationScopeLocationSelector `json:"locationSelector,omitempty"` + // ResourceHierarchySelector: Selector for selecting resource hierarchy. + ResourceHierarchySelector *GoogleCloudOsconfigV2betaOrchestrationScopeResourceHierarchySelector `json:"resourceHierarchySelector,omitempty"` + // ForceSendFields is a list of field names (e.g. "LocationSelector") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "LocationSelector") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudOsconfigV2betaOrchestrationScopeSelector) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudOsconfigV2betaOrchestrationScopeSelector + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudOsconfigV2betaPolicyOrchestratorIterationState: Describes the +// state of a single iteration of the orchestrator. +type GoogleCloudOsconfigV2betaPolicyOrchestratorIterationState struct { + // Error: Output only. Error thrown in the wave iteration. + Error *Status `json:"error,omitempty"` + // FailedActions: Output only. Number of orchestration actions which failed so + // far. For more details, query the Cloud Logs. + FailedActions int64 `json:"failedActions,omitempty,string"` + // FinishTime: Output only. Finish time of the wave iteration. + FinishTime string `json:"finishTime,omitempty"` + // PerformedActions: Output only. Overall number of actions done by the + // orchestrator so far. + PerformedActions int64 `json:"performedActions,omitempty,string"` + // Progress: Output only. An estimated percentage of the progress. Number + // between 0 and 100. + Progress float64 `json:"progress,omitempty"` + // RolloutResource: Output only. Handle to the Progressive Rollouts API rollout + // resource, which contains detailed information about a particular + // orchestration iteration. + RolloutResource string `json:"rolloutResource,omitempty"` + // StartTime: Output only. Start time of the wave iteration. + StartTime string `json:"startTime,omitempty"` + // State: Output only. State of the iteration. + // + // Possible values: + // "STATE_UNSPECIFIED" - Default value. This value is unused. + // "PROCESSING" - Iteration is in progress. + // "COMPLETED" - Iteration completed, with all actions being successful. + // "FAILED" - Iteration completed, with failures. + // "CANCELLED" - Iteration was explicitly cancelled. + // "UNKNOWN" - Impossible to determine current state of the iteration. + State string `json:"state,omitempty"` + // ForceSendFields is a list of field names (e.g. "Error") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Error") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudOsconfigV2betaPolicyOrchestratorIterationState) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudOsconfigV2betaPolicyOrchestratorIterationState + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleCloudOsconfigV2betaPolicyOrchestratorIterationState) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudOsconfigV2betaPolicyOrchestratorIterationState + var s1 struct { + Progress gensupport.JSONFloat64 `json:"progress"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Progress = float64(s1.Progress) + return nil +} + +// GoogleCloudOsconfigV2betaPolicyOrchestratorOrchestrationState: Describes the +// state of the orchestration process. +type GoogleCloudOsconfigV2betaPolicyOrchestratorOrchestrationState struct { + // CurrentIterationState: Output only. Current Wave iteration state. + CurrentIterationState *GoogleCloudOsconfigV2betaPolicyOrchestratorIterationState `json:"currentIterationState,omitempty"` + // PreviousIterationState: Output only. Previous Wave iteration state. + PreviousIterationState *GoogleCloudOsconfigV2betaPolicyOrchestratorIterationState `json:"previousIterationState,omitempty"` + // ForceSendFields is a list of field names (e.g. "CurrentIterationState") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CurrentIterationState") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudOsconfigV2betaPolicyOrchestratorOrchestrationState) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudOsconfigV2betaPolicyOrchestratorOrchestrationState + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudOsconfigV2beta__ListPolicyOrchestratorsResponse: Response for the +// list policy orchestrator resources. +type GoogleCloudOsconfigV2beta__ListPolicyOrchestratorsResponse struct { + // NextPageToken: A token, which can be sent as `page_token` to retrieve the + // next page. If this field is omitted, there are no subsequent pages. + NextPageToken string `json:"nextPageToken,omitempty"` + // PolicyOrchestrators: The policy orchestrators for the specified parent + // resource. + PolicyOrchestrators []*GoogleCloudOsconfigV2beta__PolicyOrchestrator `json:"policyOrchestrators,omitempty"` + // Unreachable: 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. "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 GoogleCloudOsconfigV2beta__ListPolicyOrchestratorsResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudOsconfigV2beta__ListPolicyOrchestratorsResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudOsconfigV2beta__OperationMetadata: Represents the metadata of the +// long-running operation. +type GoogleCloudOsconfigV2beta__OperationMetadata struct { + // ApiVersion: Output only. API version used to start the operation. + ApiVersion string `json:"apiVersion,omitempty"` + // CreateTime: Output only. The time the operation was created. + CreateTime string `json:"createTime,omitempty"` + // EndTime: Output only. The time the operation finished running. + EndTime string `json:"endTime,omitempty"` + // RequestedCancellation: Output only. Identifies whether the user has + // requested cancellation of the operation. Operations that have been cancelled + // successfully have Operation.error value with a google.rpc.Status.code of 1, + // corresponding to `Code.CANCELLED`. + RequestedCancellation bool `json:"requestedCancellation,omitempty"` + // StatusMessage: Output only. Human-readable status of the operation, if any. + StatusMessage string `json:"statusMessage,omitempty"` + // Target: Output only. Server-defined resource path for the target of the + // operation. + Target string `json:"target,omitempty"` + // Verb: Output only. Name of the verb executed by the operation. + Verb string `json:"verb,omitempty"` + // ForceSendFields is a list of field names (e.g. "ApiVersion") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ApiVersion") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudOsconfigV2beta__OperationMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudOsconfigV2beta__OperationMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudOsconfigV2beta__OrchestratedResource: Represents a resource that +// is being orchestrated by the policy orchestrator. +type GoogleCloudOsconfigV2beta__OrchestratedResource struct { + // Id: Optional. ID of the resource to be used while generating set of affected + // resources. For UPSERT action the value is auto-generated during + // PolicyOrchestrator creation when not set. When the value is set it should + // following next restrictions: * Must contain only lowercase letters, numbers, + // and hyphens. * Must start with a letter. * Must be between 1-63 characters. + // * Must end with a number or a letter. * Must be unique within the project. + // For DELETE action, ID must be specified explicitly during PolicyOrchestrator + // creation. + Id string `json:"id,omitempty"` + // OsPolicyAssignmentV1Payload: Optional. OSPolicyAssignment resource to be + // created, updated or deleted. Name field is ignored and replace with a + // generated value. With this field set, orchestrator will perform actions on + // `project/{project}/locations/{zone}/osPolicyAssignments/{resource_id}` + // resources, where `project` and `zone` pairs come from the expanded scope, + // and `resource_id` comes from the `resource_id` field of orchestrator + // resource. + OsPolicyAssignmentV1Payload *OSPolicyAssignment `json:"osPolicyAssignmentV1Payload,omitempty"` + // ForceSendFields is a list of field names (e.g. "Id") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Id") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudOsconfigV2beta__OrchestratedResource) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudOsconfigV2beta__OrchestratedResource + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudOsconfigV2beta__OrchestrationScope: Defines a set of selectors +// which drive which resources are in scope of policy orchestration. +type GoogleCloudOsconfigV2beta__OrchestrationScope struct { + // Selectors: Optional. Selectors of the orchestration scope. There is a + // logical AND between each selector defined. When there is no explicit + // `ResourceHierarchySelector` selector specified, the scope is by default + // bounded to the parent of the policy orchestrator resource. + Selectors []*GoogleCloudOsconfigV2betaOrchestrationScopeSelector `json:"selectors,omitempty"` + // ForceSendFields is a list of field names (e.g. "Selectors") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Selectors") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudOsconfigV2beta__OrchestrationScope) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudOsconfigV2beta__OrchestrationScope + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudOsconfigV2beta__PolicyOrchestrator: PolicyOrchestrator helps +// managing project+zone level policy resources (e.g. OS Policy Assignments), +// by providing tools to create, update and delete them across projects and +// locations, at scale. Policy orchestrator functions as an endless loop. Each +// iteration orchestrator computes a set of resources that should be affected, +// then progressively applies changes to them. If for some reason this set of +// resources changes over time (e.g. new projects are added), the future loop +// iterations will address that. Orchestrator can either upsert or delete +// policy resources. For more details, see the description of the `action`, and +// `orchestrated_resource` fields. Note that policy orchestrator do not +// "manage" the resources it creates. Every iteration is independent and only +// minimal history of past actions is retained (apart from Cloud Logging). If +// orchestrator gets deleted, it does not affect the resources it created in +// the past. Those will remain where they were. Same applies if projects are +// removed from the orchestrator's scope. +type GoogleCloudOsconfigV2beta__PolicyOrchestrator struct { + // Action: Required. Action to be done by the orchestrator in + // `projects/{project_id}/zones/{zone_id}` locations defined by the + // `orchestration_scope`. Allowed values: - `UPSERT` - Orchestrator will create + // or update target resources. - `DELETE` - Orchestrator will delete target + // resources, if they exist + Action string `json:"action,omitempty"` + // CreateTime: Output only. Timestamp when the policy orchestrator resource was + // created. + CreateTime string `json:"createTime,omitempty"` + // Description: Optional. Freeform text describing the purpose of the resource. + Description string `json:"description,omitempty"` + // Etag: Output only. This checksum is computed by the server based on the + // value of other fields, and may be sent on update and delete requests to + // ensure the client has an up-to-date value before proceeding. + Etag string `json:"etag,omitempty"` + // Labels: Optional. Labels as key value pairs + Labels map[string]string `json:"labels,omitempty"` + // Name: Immutable. Identifier. In form of * + // `organizations/{organization_id}/locations/global/policyOrchestrators/{orches + // trator_id}` * + // `folders/{folder_id}/locations/global/policyOrchestrators/{orchestrator_id}` + // * + // `projects/{project_id_or_number}/locations/global/policyOrchestrators/{orches + // trator_id}` + Name string `json:"name,omitempty"` + // OrchestratedResource: Required. Resource to be orchestrated by the policy + // orchestrator. + OrchestratedResource *GoogleCloudOsconfigV2beta__OrchestratedResource `json:"orchestratedResource,omitempty"` + // OrchestrationScope: Optional. Defines scope for the orchestration, in + // context of the enclosing PolicyOrchestrator resource. Scope is expanded into + // a list of pairs, in which the rollout action will take place. Expansion + // starts with a Folder resource parenting the PolicyOrchestrator resource: - + // All the descendant projects are listed. - List of project is cross joined + // with a list of all available zones. - Resulting list of pairs is filtered + // according to the selectors. + OrchestrationScope *GoogleCloudOsconfigV2beta__OrchestrationScope `json:"orchestrationScope,omitempty"` + // OrchestrationState: Output only. State of the orchestration. + OrchestrationState *GoogleCloudOsconfigV2betaPolicyOrchestratorOrchestrationState `json:"orchestrationState,omitempty"` + // Reconciling: Output only. Set to true, if the there are ongoing changes + // being applied by the orchestrator. + Reconciling bool `json:"reconciling,omitempty"` + // State: Optional. State of the orchestrator. Can be updated to change + // orchestrator behaviour. Allowed values: - `ACTIVE` - orchestrator is + // actively looking for actions to be taken. - `STOPPED` - orchestrator won't + // make any changes. Note: There might be more states added in the future. We + // use string here instead of an enum, to avoid the need of propagating new + // states to all the client code. + State string `json:"state,omitempty"` + // UpdateTime: Output only. Timestamp when the policy orchestrator 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. "Action") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Action") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudOsconfigV2beta__PolicyOrchestrator) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudOsconfigV2beta__PolicyOrchestrator + 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) +} + +// OSPolicy: An OS policy defines the desired state configuration for a VM. +type OSPolicy struct { + // AllowNoResourceGroupMatch: This flag determines the OS policy compliance + // status when none of the resource groups within the policy are applicable for + // a VM. Set this value to `true` if the policy needs to be reported as + // compliant even if the policy has nothing to validate or enforce. + AllowNoResourceGroupMatch bool `json:"allowNoResourceGroupMatch,omitempty"` + // Description: Policy description. Length of the description is limited to + // 1024 characters. + Description string `json:"description,omitempty"` + // Id: Required. The id of the OS policy with the following restrictions: * + // Must contain only lowercase letters, numbers, and hyphens. * Must start with + // a letter. * Must be between 1-63 characters. * Must end with a number or a + // letter. * Must be unique within the assignment. + Id string `json:"id,omitempty"` + // Mode: Required. Policy mode + // + // Possible values: + // "MODE_UNSPECIFIED" - Invalid mode + // "VALIDATION" - This mode checks if the configuration resources in the + // policy are in their desired state. No actions are performed if they are not + // in the desired state. This mode is used for reporting purposes. + // "ENFORCEMENT" - This mode checks if the configuration resources in the + // policy are in their desired state, and if not, enforces the desired state. + Mode string `json:"mode,omitempty"` + // ResourceGroups: Required. List of resource groups for the policy. For a + // particular VM, resource groups are evaluated in the order specified and the + // first resource group that is applicable is selected and the rest are + // ignored. If none of the resource groups are applicable for a VM, the VM is + // considered to be non-compliant w.r.t this policy. This behavior can be + // toggled by the flag `allow_no_resource_group_match` + ResourceGroups []*OSPolicyResourceGroup `json:"resourceGroups,omitempty"` + // ForceSendFields is a list of field names (e.g. "AllowNoResourceGroupMatch") + // to unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AllowNoResourceGroupMatch") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s OSPolicy) MarshalJSON() ([]byte, error) { + type NoMethod OSPolicy + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// OSPolicyAssignment: OS policy assignment is an API resource that is used to +// apply a set of OS policies to a dynamically targeted group of Compute Engine +// VM instances. An OS policy is used to define the desired state configuration +// for a Compute Engine VM instance through a set of configuration resources +// that provide capabilities such as installing or removing software packages, +// or executing a script. For more information about the OS policy resource +// definitions and examples, see OS policy and OS policy assignment +// (https://cloud.google.com/compute/docs/os-configuration-management/working-with-os-policies). +type OSPolicyAssignment struct { + // Baseline: Output only. Indicates that this revision has been successfully + // rolled out in this zone and new VMs will be assigned OS policies from this + // revision. For a given OS policy assignment, there is only one revision with + // a value of `true` for this field. + Baseline bool `json:"baseline,omitempty"` + // Deleted: Output only. Indicates that this revision deletes the OS policy + // assignment. + Deleted bool `json:"deleted,omitempty"` + // Description: OS policy assignment description. Length of the description is + // limited to 1024 characters. + Description string `json:"description,omitempty"` + // Etag: The etag for this OS policy assignment. If this is provided on update, + // it must match the server's etag. + Etag string `json:"etag,omitempty"` + // InstanceFilter: Required. Filter to select VMs. + InstanceFilter *OSPolicyAssignmentInstanceFilter `json:"instanceFilter,omitempty"` + // Name: Resource name. Format: + // `projects/{project_number}/locations/{location}/osPolicyAssignments/{os_polic + // y_assignment_id}` This field is ignored when you create an OS policy + // assignment. + Name string `json:"name,omitempty"` + // OsPolicies: Required. List of OS policies to be applied to the VMs. + OsPolicies []*OSPolicy `json:"osPolicies,omitempty"` + // Reconciling: Output only. Indicates that reconciliation is in progress for + // the revision. This value is `true` when the `rollout_state` is one of: * + // IN_PROGRESS * CANCELLING + Reconciling bool `json:"reconciling,omitempty"` + // RevisionCreateTime: Output only. The timestamp that the revision was + // created. + RevisionCreateTime string `json:"revisionCreateTime,omitempty"` + // RevisionId: Output only. The assignment revision ID A new revision is + // committed whenever a rollout is triggered for a OS policy assignment + RevisionId string `json:"revisionId,omitempty"` + // Rollout: Required. Rollout to deploy the OS policy assignment. A rollout is + // triggered in the following situations: 1) OSPolicyAssignment is created. 2) + // OSPolicyAssignment is updated and the update contains changes to one of the + // following fields: - instance_filter - os_policies 3) OSPolicyAssignment is + // deleted. + Rollout *OSPolicyAssignmentRollout `json:"rollout,omitempty"` + // RolloutState: Output only. OS policy assignment rollout state + // + // Possible values: + // "ROLLOUT_STATE_UNSPECIFIED" - Invalid value + // "IN_PROGRESS" - The rollout is in progress. + // "CANCELLING" - The rollout is being cancelled. + // "CANCELLED" - The rollout is cancelled. + // "SUCCEEDED" - The rollout has completed successfully. + RolloutState string `json:"rolloutState,omitempty"` + // Uid: Output only. Server generated unique id for the OS policy assignment + // resource. + Uid string `json:"uid,omitempty"` + // ForceSendFields is a list of field names (e.g. "Baseline") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Baseline") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s OSPolicyAssignment) MarshalJSON() ([]byte, error) { + type NoMethod OSPolicyAssignment + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// OSPolicyAssignmentInstanceFilter: Filters to select target VMs for an +// assignment. If more than one filter criteria is specified below, a VM will +// be selected if and only if it satisfies all of them. +type OSPolicyAssignmentInstanceFilter struct { + // All: Target all VMs in the project. If true, no other criteria is permitted. + All bool `json:"all,omitempty"` + // ExclusionLabels: List of label sets used for VM exclusion. If the list has + // more than one label set, the VM is excluded if any of the label sets are + // applicable for the VM. + ExclusionLabels []*OSPolicyAssignmentLabelSet `json:"exclusionLabels,omitempty"` + // InclusionLabels: List of label sets used for VM inclusion. If the list has + // more than one `LabelSet`, the VM is included if any of the label sets are + // applicable for the VM. + InclusionLabels []*OSPolicyAssignmentLabelSet `json:"inclusionLabels,omitempty"` + // Inventories: List of inventories to select VMs. A VM is selected if its + // inventory data matches at least one of the following inventories. + Inventories []*OSPolicyAssignmentInstanceFilterInventory `json:"inventories,omitempty"` + // ForceSendFields is a list of field names (e.g. "All") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "All") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s OSPolicyAssignmentInstanceFilter) MarshalJSON() ([]byte, error) { + type NoMethod OSPolicyAssignmentInstanceFilter + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// OSPolicyAssignmentInstanceFilterInventory: VM inventory details. +type OSPolicyAssignmentInstanceFilterInventory struct { + // OsShortName: Required. The OS short name + OsShortName string `json:"osShortName,omitempty"` + // OsVersion: The OS version Prefix matches are supported if asterisk(*) is + // provided as the last character. For example, to match all versions with a + // major version of `7`, specify the following value for this field `7.*` An + // empty string matches all OS versions. + OsVersion string `json:"osVersion,omitempty"` + // ForceSendFields is a list of field names (e.g. "OsShortName") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "OsShortName") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s OSPolicyAssignmentInstanceFilterInventory) MarshalJSON() ([]byte, error) { + type NoMethod OSPolicyAssignmentInstanceFilterInventory + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// OSPolicyAssignmentLabelSet: Message representing label set. * A label is a +// key value pair set for a VM. * A LabelSet is a set of labels. * Labels +// within a LabelSet are ANDed. In other words, a LabelSet is applicable for a +// VM only if it matches all the labels in the LabelSet. * Example: A LabelSet +// with 2 labels: `env=prod` and `type=webserver` will only be applicable for +// those VMs with both labels present. +type OSPolicyAssignmentLabelSet struct { + // Labels: Labels are identified by key/value pairs in this map. A VM should + // contain all the key/value pairs specified in this map to be selected. + Labels map[string]string `json:"labels,omitempty"` + // ForceSendFields is a list of field names (e.g. "Labels") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Labels") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s OSPolicyAssignmentLabelSet) MarshalJSON() ([]byte, error) { + type NoMethod OSPolicyAssignmentLabelSet + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// OSPolicyAssignmentOperationMetadata: OS policy assignment operation metadata +// provided by OS policy assignment API methods that return long running +// operations. +type OSPolicyAssignmentOperationMetadata struct { + // ApiMethod: The OS policy assignment API method. + // + // Possible values: + // "API_METHOD_UNSPECIFIED" - Invalid value + // "CREATE" - Create OS policy assignment API method + // "UPDATE" - Update OS policy assignment API method + // "DELETE" - Delete OS policy assignment API method + ApiMethod string `json:"apiMethod,omitempty"` + // OsPolicyAssignment: Reference to the `OSPolicyAssignment` API resource. + // Format: + // `projects/{project_number}/locations/{location}/osPolicyAssignments/{os_polic + // y_assignment_id@revision_id}` + OsPolicyAssignment string `json:"osPolicyAssignment,omitempty"` + // RolloutStartTime: Rollout start time + RolloutStartTime string `json:"rolloutStartTime,omitempty"` + // RolloutState: State of the rollout + // + // Possible values: + // "ROLLOUT_STATE_UNSPECIFIED" - Invalid value + // "IN_PROGRESS" - The rollout is in progress. + // "CANCELLING" - The rollout is being cancelled. + // "CANCELLED" - The rollout is cancelled. + // "SUCCEEDED" - The rollout has completed successfully. + RolloutState string `json:"rolloutState,omitempty"` + // RolloutUpdateTime: Rollout update time + RolloutUpdateTime string `json:"rolloutUpdateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "ApiMethod") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ApiMethod") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s OSPolicyAssignmentOperationMetadata) MarshalJSON() ([]byte, error) { + type NoMethod OSPolicyAssignmentOperationMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// OSPolicyAssignmentRollout: Message to configure the rollout at the zonal +// level for the OS policy assignment. +type OSPolicyAssignmentRollout struct { + // DisruptionBudget: Required. The maximum number (or percentage) of VMs per + // zone to disrupt at any given moment. + DisruptionBudget *FixedOrPercent `json:"disruptionBudget,omitempty"` + // MinWaitDuration: Required. This determines the minimum duration of time to + // wait after the configuration changes are applied through the current + // rollout. A VM continues to count towards the `disruption_budget` at least + // until this duration of time has passed after configuration changes are + // applied. + MinWaitDuration string `json:"minWaitDuration,omitempty"` + // ForceSendFields is a list of field names (e.g. "DisruptionBudget") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "DisruptionBudget") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s OSPolicyAssignmentRollout) MarshalJSON() ([]byte, error) { + type NoMethod OSPolicyAssignmentRollout + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// OSPolicyInventoryFilter: Filtering criteria to select VMs based on inventory +// details. +type OSPolicyInventoryFilter struct { + // OsShortName: Required. The OS short name + OsShortName string `json:"osShortName,omitempty"` + // OsVersion: The OS version Prefix matches are supported if asterisk(*) is + // provided as the last character. For example, to match all versions with a + // major version of `7`, specify the following value for this field `7.*` An + // empty string matches all OS versions. + OsVersion string `json:"osVersion,omitempty"` + // ForceSendFields is a list of field names (e.g. "OsShortName") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "OsShortName") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s OSPolicyInventoryFilter) MarshalJSON() ([]byte, error) { + type NoMethod OSPolicyInventoryFilter + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// OSPolicyResource: An OS policy resource is used to define the desired state +// configuration and provides a specific functionality like installing/removing +// packages, executing a script etc. The system ensures that resources are +// always in their desired state by taking necessary actions if they have +// drifted from their desired state. +type OSPolicyResource struct { + // Exec: Exec resource + Exec *OSPolicyResourceExecResource `json:"exec,omitempty"` + // File: File resource + File *OSPolicyResourceFileResource `json:"file,omitempty"` + // Id: Required. The id of the resource with the following restrictions: * Must + // contain only lowercase letters, numbers, and hyphens. * Must start with a + // letter. * Must be between 1-63 characters. * Must end with a number or a + // letter. * Must be unique within the OS policy. + Id string `json:"id,omitempty"` + // Pkg: Package resource + Pkg *OSPolicyResourcePackageResource `json:"pkg,omitempty"` + // Repository: Package repository resource + Repository *OSPolicyResourceRepositoryResource `json:"repository,omitempty"` + // ForceSendFields is a list of field names (e.g. "Exec") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Exec") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s OSPolicyResource) MarshalJSON() ([]byte, error) { + type NoMethod OSPolicyResource + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// OSPolicyResourceExecResource: A resource that allows executing scripts on +// the VM. The `ExecResource` has 2 stages: `validate` and `enforce` and both +// stages accept a script as an argument to execute. When the `ExecResource` is +// applied by the agent, it first executes the script in the `validate` stage. +// The `validate` stage can signal that the `ExecResource` is already in the +// desired state by returning an exit code of `100`. If the `ExecResource` is +// not in the desired state, it should return an exit code of `101`. Any other +// exit code returned by this stage is considered an error. If the +// `ExecResource` is not in the desired state based on the exit code from the +// `validate` stage, the agent proceeds to execute the script from the +// `enforce` stage. If the `ExecResource` is already in the desired state, the +// `enforce` stage will not be run. Similar to `validate` stage, the `enforce` +// stage should return an exit code of `100` to indicate that the resource in +// now in its desired state. Any other exit code is considered an error. NOTE: +// An exit code of `100` was chosen over `0` (and `101` vs `1`) to have an +// explicit indicator of `in desired state`, `not in desired state` and errors. +// Because, for example, Powershell will always return an exit code of `0` +// unless an `exit` statement is provided in the script. So, for reasons of +// consistency and being explicit, exit codes `100` and `101` were chosen. +type OSPolicyResourceExecResource struct { + // Enforce: What to run to bring this resource into the desired state. An exit + // code of 100 indicates "success", any other exit code indicates a failure + // running enforce. + Enforce *OSPolicyResourceExecResourceExec `json:"enforce,omitempty"` + // Validate: Required. What to run to validate this resource is in the desired + // state. An exit code of 100 indicates "in desired state", and exit code of + // 101 indicates "not in desired state". Any other exit code indicates a + // failure running validate. + Validate *OSPolicyResourceExecResourceExec `json:"validate,omitempty"` + // ForceSendFields is a list of field names (e.g. "Enforce") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Enforce") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s OSPolicyResourceExecResource) MarshalJSON() ([]byte, error) { + type NoMethod OSPolicyResourceExecResource + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// OSPolicyResourceExecResourceExec: A file or script to execute. +type OSPolicyResourceExecResourceExec struct { + // Args: Optional arguments to pass to the source during execution. + Args []string `json:"args,omitempty"` + // File: A remote or local file. + File *OSPolicyResourceFile `json:"file,omitempty"` + // Interpreter: Required. The script interpreter to use. + // + // Possible values: + // "INTERPRETER_UNSPECIFIED" - Invalid value, the request will return + // validation error. + // "NONE" - If an interpreter is not specified, the source is executed + // directly. This execution, without an interpreter, only succeeds for + // executables and scripts that have shebang lines. + // "SHELL" - Indicates that the script runs with `/bin/sh` on Linux and + // `cmd.exe` on Windows. + // "POWERSHELL" - Indicates that the script runs with PowerShell. + Interpreter string `json:"interpreter,omitempty"` + // OutputFilePath: Only recorded for enforce Exec. Path to an output file (that + // is created by this Exec) whose content will be recorded in + // OSPolicyResourceCompliance after a successful run. Absence or failure to + // read this file will result in this ExecResource being non-compliant. Output + // file size is limited to 500K bytes. + OutputFilePath string `json:"outputFilePath,omitempty"` + // Script: An inline script. The size of the script is limited to 32KiB. + Script string `json:"script,omitempty"` + // ForceSendFields is a list of field names (e.g. "Args") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Args") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s OSPolicyResourceExecResourceExec) MarshalJSON() ([]byte, error) { + type NoMethod OSPolicyResourceExecResourceExec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// OSPolicyResourceFile: A remote or local file. +type OSPolicyResourceFile struct { + // AllowInsecure: Defaults to false. When false, files are subject to + // validations based on the file type: Remote: A checksum must be specified. + // Cloud Storage: An object generation number must be specified. + AllowInsecure bool `json:"allowInsecure,omitempty"` + // Gcs: A Cloud Storage object. + Gcs *OSPolicyResourceFileGcs `json:"gcs,omitempty"` + // LocalPath: A local path within the VM to use. + LocalPath string `json:"localPath,omitempty"` + // Remote: A generic remote file. + Remote *OSPolicyResourceFileRemote `json:"remote,omitempty"` + // ForceSendFields is a list of field names (e.g. "AllowInsecure") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AllowInsecure") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s OSPolicyResourceFile) MarshalJSON() ([]byte, error) { + type NoMethod OSPolicyResourceFile + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// OSPolicyResourceFileGcs: Specifies a file available as a Cloud Storage +// Object. +type OSPolicyResourceFileGcs struct { + // Bucket: Required. Bucket of the Cloud Storage object. + Bucket string `json:"bucket,omitempty"` + // Generation: Generation number of the Cloud Storage object. + Generation int64 `json:"generation,omitempty,string"` + // Object: Required. Name of the Cloud Storage object. + 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 OSPolicyResourceFileGcs) MarshalJSON() ([]byte, error) { + type NoMethod OSPolicyResourceFileGcs + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// OSPolicyResourceFileRemote: Specifies a file available via some URI. +type OSPolicyResourceFileRemote struct { + // Sha256Checksum: SHA256 checksum of the remote file. + Sha256Checksum string `json:"sha256Checksum,omitempty"` + // Uri: Required. URI from which to fetch the object. It should contain both + // the protocol and path following the format `{protocol}://{location}`. + Uri string `json:"uri,omitempty"` + // ForceSendFields is a list of field names (e.g. "Sha256Checksum") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Sha256Checksum") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s OSPolicyResourceFileRemote) MarshalJSON() ([]byte, error) { + type NoMethod OSPolicyResourceFileRemote + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// OSPolicyResourceFileResource: A resource that manages the state of a file. +type OSPolicyResourceFileResource struct { + // Content: A a file with this content. The size of the content is limited to + // 32KiB. + Content string `json:"content,omitempty"` + // File: A remote or local source. + File *OSPolicyResourceFile `json:"file,omitempty"` + // Path: Required. The absolute path of the file within the VM. + Path string `json:"path,omitempty"` + // Permissions: Consists of three octal digits which represent, in order, the + // permissions of the owner, group, and other users for the file (similarly to + // the numeric mode used in the linux chmod utility). Each digit represents a + // three bit number with the 4 bit corresponding to the read permissions, the 2 + // bit corresponds to the write bit, and the one bit corresponds to the execute + // permission. Default behavior is 755. Below are some examples of permissions + // and their associated values: read, write, and execute: 7 read and execute: 5 + // read and write: 6 read only: 4 + Permissions string `json:"permissions,omitempty"` + // State: Required. Desired state of the file. + // + // Possible values: + // "DESIRED_STATE_UNSPECIFIED" - Unspecified is invalid. + // "PRESENT" - Ensure file at path is present. + // "ABSENT" - Ensure file at path is absent. + // "CONTENTS_MATCH" - Ensure the contents of the file at path matches. If the + // file does not exist it will be created. + State string `json:"state,omitempty"` + // ForceSendFields is a list of field names (e.g. "Content") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Content") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s OSPolicyResourceFileResource) MarshalJSON() ([]byte, error) { + type NoMethod OSPolicyResourceFileResource + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// OSPolicyResourceGroup: Resource groups provide a mechanism to group OS +// policy resources. Resource groups enable OS policy authors to create a +// single OS policy to be applied to VMs running different operating Systems. +// When the OS policy is applied to a target VM, the appropriate resource group +// within the OS policy is selected based on the `OSFilter` specified within +// the resource group. +type OSPolicyResourceGroup struct { + // InventoryFilters: List of inventory filters for the resource group. The + // resources in this resource group are applied to the target VM if it + // satisfies at least one of the following inventory filters. For example, to + // apply this resource group to VMs running either `RHEL` or `CentOS` operating + // systems, specify 2 items for the list with following values: + // inventory_filters[0].os_short_name='rhel' and + // inventory_filters[1].os_short_name='centos' If the list is empty, this + // resource group will be applied to the target VM unconditionally. + InventoryFilters []*OSPolicyInventoryFilter `json:"inventoryFilters,omitempty"` + // Resources: Required. List of resources configured for this resource group. + // The resources are executed in the exact order specified here. + Resources []*OSPolicyResource `json:"resources,omitempty"` + // ForceSendFields is a list of field names (e.g. "InventoryFilters") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "InventoryFilters") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s OSPolicyResourceGroup) MarshalJSON() ([]byte, error) { + type NoMethod OSPolicyResourceGroup + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// OSPolicyResourcePackageResource: A resource that manages a system package. +type OSPolicyResourcePackageResource struct { + // Apt: A package managed by Apt. + Apt *OSPolicyResourcePackageResourceAPT `json:"apt,omitempty"` + // Deb: A deb package file. + Deb *OSPolicyResourcePackageResourceDeb `json:"deb,omitempty"` + // DesiredState: Required. The desired state the agent should maintain for this + // package. + // + // Possible values: + // "DESIRED_STATE_UNSPECIFIED" - Unspecified is invalid. + // "INSTALLED" - Ensure that the package is installed. + // "REMOVED" - The agent ensures that the package is not installed and + // uninstalls it if detected. + DesiredState string `json:"desiredState,omitempty"` + // Googet: A package managed by GooGet. + Googet *OSPolicyResourcePackageResourceGooGet `json:"googet,omitempty"` + // Msi: An MSI package. + Msi *OSPolicyResourcePackageResourceMSI `json:"msi,omitempty"` + // Rpm: An rpm package file. + Rpm *OSPolicyResourcePackageResourceRPM `json:"rpm,omitempty"` + // Yum: A package managed by YUM. + Yum *OSPolicyResourcePackageResourceYUM `json:"yum,omitempty"` + // Zypper: A package managed by Zypper. + Zypper *OSPolicyResourcePackageResourceZypper `json:"zypper,omitempty"` + // ForceSendFields is a list of field names (e.g. "Apt") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Apt") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s OSPolicyResourcePackageResource) MarshalJSON() ([]byte, error) { + type NoMethod OSPolicyResourcePackageResource + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// OSPolicyResourcePackageResourceAPT: A package managed by APT. - install: +// `apt-get update && apt-get -y install [name]` - remove: `apt-get -y remove +// [name]` +type OSPolicyResourcePackageResourceAPT struct { + // Name: Required. Package name. + 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 OSPolicyResourcePackageResourceAPT) MarshalJSON() ([]byte, error) { + type NoMethod OSPolicyResourcePackageResourceAPT + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// OSPolicyResourcePackageResourceDeb: A deb package file. dpkg packages only +// support INSTALLED state. +type OSPolicyResourcePackageResourceDeb struct { + // PullDeps: Whether dependencies should also be installed. - install when + // false: `dpkg -i package` - install when true: `apt-get update && apt-get -y + // install package.deb` + PullDeps bool `json:"pullDeps,omitempty"` + // Source: Required. A deb package. + Source *OSPolicyResourceFile `json:"source,omitempty"` + // ForceSendFields is a list of field names (e.g. "PullDeps") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "PullDeps") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s OSPolicyResourcePackageResourceDeb) MarshalJSON() ([]byte, error) { + type NoMethod OSPolicyResourcePackageResourceDeb + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// OSPolicyResourcePackageResourceGooGet: A package managed by GooGet. - +// install: `googet -noconfirm install package` - remove: `googet -noconfirm +// remove package` +type OSPolicyResourcePackageResourceGooGet struct { + // Name: Required. Package name. + 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 OSPolicyResourcePackageResourceGooGet) MarshalJSON() ([]byte, error) { + type NoMethod OSPolicyResourcePackageResourceGooGet + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// OSPolicyResourcePackageResourceMSI: An MSI package. MSI packages only +// support INSTALLED state. +type OSPolicyResourcePackageResourceMSI struct { + // Properties: Additional properties to use during installation. This should be + // in the format of Property=Setting. Appended to the defaults of + // `ACTION=INSTALL REBOOT=ReallySuppress`. + Properties []string `json:"properties,omitempty"` + // Source: Required. The MSI package. + Source *OSPolicyResourceFile `json:"source,omitempty"` + // ForceSendFields is a list of field names (e.g. "Properties") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Properties") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s OSPolicyResourcePackageResourceMSI) MarshalJSON() ([]byte, error) { + type NoMethod OSPolicyResourcePackageResourceMSI + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// OSPolicyResourcePackageResourceRPM: An RPM package file. RPM packages only +// support INSTALLED state. +type OSPolicyResourcePackageResourceRPM struct { + // PullDeps: Whether dependencies should also be installed. - install when + // false: `rpm --upgrade --replacepkgs package.rpm` - install when true: `yum + // -y install package.rpm` or `zypper -y install package.rpm` + PullDeps bool `json:"pullDeps,omitempty"` + // Source: Required. An rpm package. + Source *OSPolicyResourceFile `json:"source,omitempty"` + // ForceSendFields is a list of field names (e.g. "PullDeps") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "PullDeps") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s OSPolicyResourcePackageResourceRPM) MarshalJSON() ([]byte, error) { + type NoMethod OSPolicyResourcePackageResourceRPM + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// OSPolicyResourcePackageResourceYUM: A package managed by YUM. - install: +// `yum -y install package` - remove: `yum -y remove package` +type OSPolicyResourcePackageResourceYUM struct { + // Name: Required. Package name. + 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 OSPolicyResourcePackageResourceYUM) MarshalJSON() ([]byte, error) { + type NoMethod OSPolicyResourcePackageResourceYUM + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// OSPolicyResourcePackageResourceZypper: A package managed by Zypper. - +// install: `zypper -y install package` - remove: `zypper -y rm package` +type OSPolicyResourcePackageResourceZypper struct { + // Name: Required. Package name. + 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 OSPolicyResourcePackageResourceZypper) MarshalJSON() ([]byte, error) { + type NoMethod OSPolicyResourcePackageResourceZypper + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// OSPolicyResourceRepositoryResource: A resource that manages a package +// repository. +type OSPolicyResourceRepositoryResource struct { + // Apt: An Apt Repository. + Apt *OSPolicyResourceRepositoryResourceAptRepository `json:"apt,omitempty"` + // Goo: A Goo Repository. + Goo *OSPolicyResourceRepositoryResourceGooRepository `json:"goo,omitempty"` + // Yum: A Yum Repository. + Yum *OSPolicyResourceRepositoryResourceYumRepository `json:"yum,omitempty"` + // Zypper: A Zypper Repository. + Zypper *OSPolicyResourceRepositoryResourceZypperRepository `json:"zypper,omitempty"` + // ForceSendFields is a list of field names (e.g. "Apt") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Apt") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s OSPolicyResourceRepositoryResource) MarshalJSON() ([]byte, error) { + type NoMethod OSPolicyResourceRepositoryResource + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// OSPolicyResourceRepositoryResourceAptRepository: Represents a single apt +// package repository. These will be added to a repo file that will be managed +// at `/etc/apt/sources.list.d/google_osconfig.list`. +type OSPolicyResourceRepositoryResourceAptRepository struct { + // ArchiveType: Required. Type of archive files in this repository. + // + // Possible values: + // "ARCHIVE_TYPE_UNSPECIFIED" - Unspecified is invalid. + // "DEB" - Deb indicates that the archive contains binary files. + // "DEB_SRC" - Deb-src indicates that the archive contains source files. + ArchiveType string `json:"archiveType,omitempty"` + // Components: Required. List of components for this repository. Must contain + // at least one item. + Components []string `json:"components,omitempty"` + // Distribution: Required. Distribution of this repository. + Distribution string `json:"distribution,omitempty"` + // GpgKey: URI of the key file for this repository. The agent maintains a + // keyring at `/etc/apt/trusted.gpg.d/osconfig_agent_managed.gpg`. + GpgKey string `json:"gpgKey,omitempty"` + // Uri: Required. URI for this repository. + Uri string `json:"uri,omitempty"` + // ForceSendFields is a list of field names (e.g. "ArchiveType") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ArchiveType") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s OSPolicyResourceRepositoryResourceAptRepository) MarshalJSON() ([]byte, error) { + type NoMethod OSPolicyResourceRepositoryResourceAptRepository + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// OSPolicyResourceRepositoryResourceGooRepository: Represents a Goo package +// repository. These are added to a repo file that is managed at +// `C:/ProgramData/GooGet/repos/google_osconfig.repo`. +type OSPolicyResourceRepositoryResourceGooRepository struct { + // Name: Required. The name of the repository. + Name string `json:"name,omitempty"` + // Url: Required. The url of the repository. + Url string `json:"url,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 OSPolicyResourceRepositoryResourceGooRepository) MarshalJSON() ([]byte, error) { + type NoMethod OSPolicyResourceRepositoryResourceGooRepository + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// OSPolicyResourceRepositoryResourceYumRepository: Represents a single yum +// package repository. These are added to a repo file that is managed at +// `/etc/yum.repos.d/google_osconfig.repo`. +type OSPolicyResourceRepositoryResourceYumRepository struct { + // BaseUrl: Required. The location of the repository directory. + BaseUrl string `json:"baseUrl,omitempty"` + // DisplayName: The display name of the repository. + DisplayName string `json:"displayName,omitempty"` + // GpgKeys: URIs of GPG keys. + GpgKeys []string `json:"gpgKeys,omitempty"` + // Id: Required. A one word, unique name for this repository. This is the `repo + // id` in the yum config file and also the `display_name` if `display_name` is + // omitted. This id is also used as the unique identifier when checking for + // resource conflicts. + Id string `json:"id,omitempty"` + // ForceSendFields is a list of field names (e.g. "BaseUrl") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BaseUrl") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s OSPolicyResourceRepositoryResourceYumRepository) MarshalJSON() ([]byte, error) { + type NoMethod OSPolicyResourceRepositoryResourceYumRepository + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// OSPolicyResourceRepositoryResourceZypperRepository: Represents a single +// zypper package repository. These are added to a repo file that is managed at +// `/etc/zypp/repos.d/google_osconfig.repo`. +type OSPolicyResourceRepositoryResourceZypperRepository struct { + // BaseUrl: Required. The location of the repository directory. + BaseUrl string `json:"baseUrl,omitempty"` + // DisplayName: The display name of the repository. + DisplayName string `json:"displayName,omitempty"` + // GpgKeys: URIs of GPG keys. + GpgKeys []string `json:"gpgKeys,omitempty"` + // Id: Required. A one word, unique name for this repository. This is the `repo + // id` in the zypper config file and also the `display_name` if `display_name` + // is omitted. This id is also used as the unique identifier when checking for + // GuestPolicy conflicts. + Id string `json:"id,omitempty"` + // ForceSendFields is a list of field names (e.g. "BaseUrl") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BaseUrl") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s OSPolicyResourceRepositoryResourceZypperRepository) MarshalJSON() ([]byte, error) { + type NoMethod OSPolicyResourceRepositoryResourceZypperRepository + 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 *Status `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) +} + +// 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 +// 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 Status 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 Status) MarshalJSON() ([]byte, error) { + type NoMethod Status + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type FoldersLocationsGlobalPolicyOrchestratorsCreateCall struct { + s *Service + parent string + googlecloudosconfigv2beta__policyorchestrator *GoogleCloudOsconfigV2beta__PolicyOrchestrator + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a new policy orchestrator under the given folder resource. +// `name` field of the given orchestrator are ignored and instead replaced by a +// product of `parent` and `policy_orchestrator_id`. Orchestrator state field +// might be only set to `ACTIVE`, `STOPPED` or omitted (in which case, the +// created resource will be in `ACTIVE` state anyway). +// +// - parent: The parent resource name in the form of: +// `organizations/{organization_id}/locations/global` +// `folders/{folder_id}/locations/global` +// 'projects/{project_id_or_number}/locations/global'. +func (r *FoldersLocationsGlobalPolicyOrchestratorsService) Create(parent string, googlecloudosconfigv2beta__policyorchestrator *GoogleCloudOsconfigV2beta__PolicyOrchestrator) *FoldersLocationsGlobalPolicyOrchestratorsCreateCall { + c := &FoldersLocationsGlobalPolicyOrchestratorsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googlecloudosconfigv2beta__policyorchestrator = googlecloudosconfigv2beta__policyorchestrator + return c +} + +// PolicyOrchestratorId sets the optional parameter "policyOrchestratorId": +// Required. The logical identifier of the policy orchestrator, with the +// following restrictions: * Must contain only lowercase letters, numbers, and +// hyphens. * Must start with a letter. * Must be between 1-63 characters. * +// Must end with a number or a letter. * Must be unique within the parent. +func (c *FoldersLocationsGlobalPolicyOrchestratorsCreateCall) PolicyOrchestratorId(policyOrchestratorId string) *FoldersLocationsGlobalPolicyOrchestratorsCreateCall { + c.urlParams_.Set("policyOrchestratorId", policyOrchestratorId) + 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 since +// 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 *FoldersLocationsGlobalPolicyOrchestratorsCreateCall) RequestId(requestId string) *FoldersLocationsGlobalPolicyOrchestratorsCreateCall { + 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 *FoldersLocationsGlobalPolicyOrchestratorsCreateCall) Fields(s ...googleapi.Field) *FoldersLocationsGlobalPolicyOrchestratorsCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *FoldersLocationsGlobalPolicyOrchestratorsCreateCall) Context(ctx context.Context) *FoldersLocationsGlobalPolicyOrchestratorsCreateCall { + 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 *FoldersLocationsGlobalPolicyOrchestratorsCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *FoldersLocationsGlobalPolicyOrchestratorsCreateCall) 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.googlecloudosconfigv2beta__policyorchestrator) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2beta/{+parent}/policyOrchestrators") + 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 "osconfig.folders.locations.global.policyOrchestrators.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 *FoldersLocationsGlobalPolicyOrchestratorsCreateCall) 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 FoldersLocationsGlobalPolicyOrchestratorsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes an existing policy orchestrator resource, parented by a +// folder. +// +// - name: Name of the resource to be deleted. +func (r *FoldersLocationsGlobalPolicyOrchestratorsService) Delete(name string) *FoldersLocationsGlobalPolicyOrchestratorsDeleteCall { + c := &FoldersLocationsGlobalPolicyOrchestratorsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Etag sets the optional parameter "etag": The current etag of the policy +// orchestrator. If an etag is provided and does not match the current etag of +// the policy orchestrator, deletion will be blocked and an ABORTED error will +// be returned. +func (c *FoldersLocationsGlobalPolicyOrchestratorsDeleteCall) Etag(etag string) *FoldersLocationsGlobalPolicyOrchestratorsDeleteCall { + c.urlParams_.Set("etag", etag) + 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 *FoldersLocationsGlobalPolicyOrchestratorsDeleteCall) RequestId(requestId string) *FoldersLocationsGlobalPolicyOrchestratorsDeleteCall { + 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 *FoldersLocationsGlobalPolicyOrchestratorsDeleteCall) Fields(s ...googleapi.Field) *FoldersLocationsGlobalPolicyOrchestratorsDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *FoldersLocationsGlobalPolicyOrchestratorsDeleteCall) Context(ctx context.Context) *FoldersLocationsGlobalPolicyOrchestratorsDeleteCall { + 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 *FoldersLocationsGlobalPolicyOrchestratorsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *FoldersLocationsGlobalPolicyOrchestratorsDeleteCall) 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, "v2beta/{+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 "osconfig.folders.locations.global.policyOrchestrators.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 *FoldersLocationsGlobalPolicyOrchestratorsDeleteCall) 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 FoldersLocationsGlobalPolicyOrchestratorsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Retrieves an existing policy orchestrator, parented by a folder. +// +// - name: The resource name. +func (r *FoldersLocationsGlobalPolicyOrchestratorsService) Get(name string) *FoldersLocationsGlobalPolicyOrchestratorsGetCall { + c := &FoldersLocationsGlobalPolicyOrchestratorsGetCall{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 *FoldersLocationsGlobalPolicyOrchestratorsGetCall) Fields(s ...googleapi.Field) *FoldersLocationsGlobalPolicyOrchestratorsGetCall { + 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 *FoldersLocationsGlobalPolicyOrchestratorsGetCall) IfNoneMatch(entityTag string) *FoldersLocationsGlobalPolicyOrchestratorsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *FoldersLocationsGlobalPolicyOrchestratorsGetCall) Context(ctx context.Context) *FoldersLocationsGlobalPolicyOrchestratorsGetCall { + 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 *FoldersLocationsGlobalPolicyOrchestratorsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *FoldersLocationsGlobalPolicyOrchestratorsGetCall) 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 "osconfig.folders.locations.global.policyOrchestrators.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudOsconfigV2beta__PolicyOrchestrator.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 *FoldersLocationsGlobalPolicyOrchestratorsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudOsconfigV2beta__PolicyOrchestrator, 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 := &GoogleCloudOsconfigV2beta__PolicyOrchestrator{ + 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 FoldersLocationsGlobalPolicyOrchestratorsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists the policy orchestrators under the given parent folder resource. +// +// - parent: The parent resource name. +func (r *FoldersLocationsGlobalPolicyOrchestratorsService) List(parent string) *FoldersLocationsGlobalPolicyOrchestratorsListCall { + c := &FoldersLocationsGlobalPolicyOrchestratorsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Filter sets the optional parameter "filter": Filtering results +func (c *FoldersLocationsGlobalPolicyOrchestratorsListCall) Filter(filter string) *FoldersLocationsGlobalPolicyOrchestratorsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// OrderBy sets the optional parameter "orderBy": Hint for how to order the +// results +func (c *FoldersLocationsGlobalPolicyOrchestratorsListCall) OrderBy(orderBy string) *FoldersLocationsGlobalPolicyOrchestratorsListCall { + 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. +func (c *FoldersLocationsGlobalPolicyOrchestratorsListCall) PageSize(pageSize int64) *FoldersLocationsGlobalPolicyOrchestratorsListCall { + 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 *FoldersLocationsGlobalPolicyOrchestratorsListCall) PageToken(pageToken string) *FoldersLocationsGlobalPolicyOrchestratorsListCall { + 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 *FoldersLocationsGlobalPolicyOrchestratorsListCall) Fields(s ...googleapi.Field) *FoldersLocationsGlobalPolicyOrchestratorsListCall { + 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 *FoldersLocationsGlobalPolicyOrchestratorsListCall) IfNoneMatch(entityTag string) *FoldersLocationsGlobalPolicyOrchestratorsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *FoldersLocationsGlobalPolicyOrchestratorsListCall) Context(ctx context.Context) *FoldersLocationsGlobalPolicyOrchestratorsListCall { + 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 *FoldersLocationsGlobalPolicyOrchestratorsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *FoldersLocationsGlobalPolicyOrchestratorsListCall) 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/{+parent}/policyOrchestrators") + 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 "osconfig.folders.locations.global.policyOrchestrators.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudOsconfigV2beta__ListPolicyOrchestratorsResponse.ServerResponse.He +// ader 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 *FoldersLocationsGlobalPolicyOrchestratorsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudOsconfigV2beta__ListPolicyOrchestratorsResponse, 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 := &GoogleCloudOsconfigV2beta__ListPolicyOrchestratorsResponse{ + 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 *FoldersLocationsGlobalPolicyOrchestratorsListCall) Pages(ctx context.Context, f func(*GoogleCloudOsconfigV2beta__ListPolicyOrchestratorsResponse) 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 FoldersLocationsGlobalPolicyOrchestratorsPatchCall struct { + s *Service + name string + googlecloudosconfigv2beta__policyorchestrator *GoogleCloudOsconfigV2beta__PolicyOrchestrator + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates an existing policy orchestrator, parented by a folder. +// +// - name: Immutable. Identifier. In form of * +// `organizations/{organization_id}/locations/global/policyOrchestrators/{orch +// estrator_id}` * +// `folders/{folder_id}/locations/global/policyOrchestrators/{orchestrator_id} +// ` * +// `projects/{project_id_or_number}/locations/global/policyOrchestrators/{orch +// estrator_id}`. +func (r *FoldersLocationsGlobalPolicyOrchestratorsService) Patch(name string, googlecloudosconfigv2beta__policyorchestrator *GoogleCloudOsconfigV2beta__PolicyOrchestrator) *FoldersLocationsGlobalPolicyOrchestratorsPatchCall { + c := &FoldersLocationsGlobalPolicyOrchestratorsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googlecloudosconfigv2beta__policyorchestrator = googlecloudosconfigv2beta__policyorchestrator + return c +} + +// UpdateMask sets the optional parameter "updateMask": The list of fields to +// update. +func (c *FoldersLocationsGlobalPolicyOrchestratorsPatchCall) UpdateMask(updateMask string) *FoldersLocationsGlobalPolicyOrchestratorsPatchCall { + 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 *FoldersLocationsGlobalPolicyOrchestratorsPatchCall) Fields(s ...googleapi.Field) *FoldersLocationsGlobalPolicyOrchestratorsPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *FoldersLocationsGlobalPolicyOrchestratorsPatchCall) Context(ctx context.Context) *FoldersLocationsGlobalPolicyOrchestratorsPatchCall { + 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 *FoldersLocationsGlobalPolicyOrchestratorsPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *FoldersLocationsGlobalPolicyOrchestratorsPatchCall) 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.googlecloudosconfigv2beta__policyorchestrator) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2beta/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "osconfig.folders.locations.global.policyOrchestrators.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 *FoldersLocationsGlobalPolicyOrchestratorsPatchCall) 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 FoldersLocationsOperationsCancelCall 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 *FoldersLocationsOperationsService) Cancel(name string, canceloperationrequest *CancelOperationRequest) *FoldersLocationsOperationsCancelCall { + c := &FoldersLocationsOperationsCancelCall{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 *FoldersLocationsOperationsCancelCall) Fields(s ...googleapi.Field) *FoldersLocationsOperationsCancelCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *FoldersLocationsOperationsCancelCall) Context(ctx context.Context) *FoldersLocationsOperationsCancelCall { + 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 *FoldersLocationsOperationsCancelCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *FoldersLocationsOperationsCancelCall) 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 "osconfig.folders.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 *FoldersLocationsOperationsCancelCall) 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 FoldersLocationsOperationsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + 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`. +// +// - name: The name of the operation resource to be deleted. +func (r *FoldersLocationsOperationsService) Delete(name string) *FoldersLocationsOperationsDeleteCall { + c := &FoldersLocationsOperationsDeleteCall{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 *FoldersLocationsOperationsDeleteCall) Fields(s ...googleapi.Field) *FoldersLocationsOperationsDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *FoldersLocationsOperationsDeleteCall) Context(ctx context.Context) *FoldersLocationsOperationsDeleteCall { + 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 *FoldersLocationsOperationsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *FoldersLocationsOperationsDeleteCall) 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, "v2beta/{+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 "osconfig.folders.locations.operations.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 *FoldersLocationsOperationsDeleteCall) 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 FoldersLocationsOperationsGetCall 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 *FoldersLocationsOperationsService) Get(name string) *FoldersLocationsOperationsGetCall { + c := &FoldersLocationsOperationsGetCall{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 *FoldersLocationsOperationsGetCall) Fields(s ...googleapi.Field) *FoldersLocationsOperationsGetCall { + 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 *FoldersLocationsOperationsGetCall) IfNoneMatch(entityTag string) *FoldersLocationsOperationsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *FoldersLocationsOperationsGetCall) Context(ctx context.Context) *FoldersLocationsOperationsGetCall { + 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 *FoldersLocationsOperationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *FoldersLocationsOperationsGetCall) 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 "osconfig.folders.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 *FoldersLocationsOperationsGetCall) 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 FoldersLocationsOperationsListCall 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 *FoldersLocationsOperationsService) List(name string) *FoldersLocationsOperationsListCall { + c := &FoldersLocationsOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Filter sets the optional parameter "filter": The standard list filter. +func (c *FoldersLocationsOperationsListCall) Filter(filter string) *FoldersLocationsOperationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The standard list page +// size. +func (c *FoldersLocationsOperationsListCall) PageSize(pageSize int64) *FoldersLocationsOperationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The standard list page +// token. +func (c *FoldersLocationsOperationsListCall) PageToken(pageToken string) *FoldersLocationsOperationsListCall { + 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 *FoldersLocationsOperationsListCall) Fields(s ...googleapi.Field) *FoldersLocationsOperationsListCall { + 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 *FoldersLocationsOperationsListCall) IfNoneMatch(entityTag string) *FoldersLocationsOperationsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *FoldersLocationsOperationsListCall) Context(ctx context.Context) *FoldersLocationsOperationsListCall { + 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 *FoldersLocationsOperationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *FoldersLocationsOperationsListCall) 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 "osconfig.folders.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 *FoldersLocationsOperationsListCall) 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 *FoldersLocationsOperationsListCall) 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) + } +} + +type OrganizationsLocationsGlobalPolicyOrchestratorsCreateCall struct { + s *Service + parent string + googlecloudosconfigv2beta__policyorchestrator *GoogleCloudOsconfigV2beta__PolicyOrchestrator + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a new policy orchestrator under the given organizations +// resource. `name` field of the given orchestrator are ignored and instead +// replaced by a product of `parent` and `policy_orchestrator_id`. Orchestrator +// state field might be only set to `ACTIVE`, `STOPPED` or omitted (in which +// case, the created resource will be in `ACTIVE` state anyway). +// +// - parent: The parent resource name in the form of: +// `organizations/{organization_id}/locations/global` +// `folders/{folder_id}/locations/global` +// 'projects/{project_id_or_number}/locations/global'. +func (r *OrganizationsLocationsGlobalPolicyOrchestratorsService) Create(parent string, googlecloudosconfigv2beta__policyorchestrator *GoogleCloudOsconfigV2beta__PolicyOrchestrator) *OrganizationsLocationsGlobalPolicyOrchestratorsCreateCall { + c := &OrganizationsLocationsGlobalPolicyOrchestratorsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googlecloudosconfigv2beta__policyorchestrator = googlecloudosconfigv2beta__policyorchestrator + return c +} + +// PolicyOrchestratorId sets the optional parameter "policyOrchestratorId": +// Required. The logical identifier of the policy orchestrator, with the +// following restrictions: * Must contain only lowercase letters, numbers, and +// hyphens. * Must start with a letter. * Must be between 1-63 characters. * +// Must end with a number or a letter. * Must be unique within the parent. +func (c *OrganizationsLocationsGlobalPolicyOrchestratorsCreateCall) PolicyOrchestratorId(policyOrchestratorId string) *OrganizationsLocationsGlobalPolicyOrchestratorsCreateCall { + c.urlParams_.Set("policyOrchestratorId", policyOrchestratorId) + 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 since +// 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 *OrganizationsLocationsGlobalPolicyOrchestratorsCreateCall) RequestId(requestId string) *OrganizationsLocationsGlobalPolicyOrchestratorsCreateCall { + 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 *OrganizationsLocationsGlobalPolicyOrchestratorsCreateCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalPolicyOrchestratorsCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsLocationsGlobalPolicyOrchestratorsCreateCall) Context(ctx context.Context) *OrganizationsLocationsGlobalPolicyOrchestratorsCreateCall { + 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 *OrganizationsLocationsGlobalPolicyOrchestratorsCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsGlobalPolicyOrchestratorsCreateCall) 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.googlecloudosconfigv2beta__policyorchestrator) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2beta/{+parent}/policyOrchestrators") + 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 "osconfig.organizations.locations.global.policyOrchestrators.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 *OrganizationsLocationsGlobalPolicyOrchestratorsCreateCall) 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 OrganizationsLocationsGlobalPolicyOrchestratorsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes an existing policy orchestrator resource, parented by an +// organization. +// +// - name: Name of the resource to be deleted. +func (r *OrganizationsLocationsGlobalPolicyOrchestratorsService) Delete(name string) *OrganizationsLocationsGlobalPolicyOrchestratorsDeleteCall { + c := &OrganizationsLocationsGlobalPolicyOrchestratorsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Etag sets the optional parameter "etag": The current etag of the policy +// orchestrator. If an etag is provided and does not match the current etag of +// the policy orchestrator, deletion will be blocked and an ABORTED error will +// be returned. +func (c *OrganizationsLocationsGlobalPolicyOrchestratorsDeleteCall) Etag(etag string) *OrganizationsLocationsGlobalPolicyOrchestratorsDeleteCall { + c.urlParams_.Set("etag", etag) + 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 *OrganizationsLocationsGlobalPolicyOrchestratorsDeleteCall) RequestId(requestId string) *OrganizationsLocationsGlobalPolicyOrchestratorsDeleteCall { + 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 *OrganizationsLocationsGlobalPolicyOrchestratorsDeleteCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalPolicyOrchestratorsDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsLocationsGlobalPolicyOrchestratorsDeleteCall) Context(ctx context.Context) *OrganizationsLocationsGlobalPolicyOrchestratorsDeleteCall { + 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 *OrganizationsLocationsGlobalPolicyOrchestratorsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsGlobalPolicyOrchestratorsDeleteCall) 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, "v2beta/{+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 "osconfig.organizations.locations.global.policyOrchestrators.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 *OrganizationsLocationsGlobalPolicyOrchestratorsDeleteCall) 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 OrganizationsLocationsGlobalPolicyOrchestratorsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Retrieves an existing policy orchestrator, parented by an organization. +// +// - name: The resource name. +func (r *OrganizationsLocationsGlobalPolicyOrchestratorsService) Get(name string) *OrganizationsLocationsGlobalPolicyOrchestratorsGetCall { + c := &OrganizationsLocationsGlobalPolicyOrchestratorsGetCall{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 *OrganizationsLocationsGlobalPolicyOrchestratorsGetCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalPolicyOrchestratorsGetCall { + 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 *OrganizationsLocationsGlobalPolicyOrchestratorsGetCall) IfNoneMatch(entityTag string) *OrganizationsLocationsGlobalPolicyOrchestratorsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsLocationsGlobalPolicyOrchestratorsGetCall) Context(ctx context.Context) *OrganizationsLocationsGlobalPolicyOrchestratorsGetCall { + 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 *OrganizationsLocationsGlobalPolicyOrchestratorsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsGlobalPolicyOrchestratorsGetCall) 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 "osconfig.organizations.locations.global.policyOrchestrators.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudOsconfigV2beta__PolicyOrchestrator.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 *OrganizationsLocationsGlobalPolicyOrchestratorsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudOsconfigV2beta__PolicyOrchestrator, 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 := &GoogleCloudOsconfigV2beta__PolicyOrchestrator{ + 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 OrganizationsLocationsGlobalPolicyOrchestratorsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists the policy orchestrators under the given parent organization +// resource. +// +// - parent: The parent resource name. +func (r *OrganizationsLocationsGlobalPolicyOrchestratorsService) List(parent string) *OrganizationsLocationsGlobalPolicyOrchestratorsListCall { + c := &OrganizationsLocationsGlobalPolicyOrchestratorsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Filter sets the optional parameter "filter": Filtering results +func (c *OrganizationsLocationsGlobalPolicyOrchestratorsListCall) Filter(filter string) *OrganizationsLocationsGlobalPolicyOrchestratorsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// OrderBy sets the optional parameter "orderBy": Hint for how to order the +// results +func (c *OrganizationsLocationsGlobalPolicyOrchestratorsListCall) OrderBy(orderBy string) *OrganizationsLocationsGlobalPolicyOrchestratorsListCall { + 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. +func (c *OrganizationsLocationsGlobalPolicyOrchestratorsListCall) PageSize(pageSize int64) *OrganizationsLocationsGlobalPolicyOrchestratorsListCall { + 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 *OrganizationsLocationsGlobalPolicyOrchestratorsListCall) PageToken(pageToken string) *OrganizationsLocationsGlobalPolicyOrchestratorsListCall { + 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 *OrganizationsLocationsGlobalPolicyOrchestratorsListCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalPolicyOrchestratorsListCall { + 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 *OrganizationsLocationsGlobalPolicyOrchestratorsListCall) IfNoneMatch(entityTag string) *OrganizationsLocationsGlobalPolicyOrchestratorsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsLocationsGlobalPolicyOrchestratorsListCall) Context(ctx context.Context) *OrganizationsLocationsGlobalPolicyOrchestratorsListCall { + 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 *OrganizationsLocationsGlobalPolicyOrchestratorsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsGlobalPolicyOrchestratorsListCall) 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/{+parent}/policyOrchestrators") + 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 "osconfig.organizations.locations.global.policyOrchestrators.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudOsconfigV2beta__ListPolicyOrchestratorsResponse.ServerResponse.He +// ader 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 *OrganizationsLocationsGlobalPolicyOrchestratorsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudOsconfigV2beta__ListPolicyOrchestratorsResponse, 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 := &GoogleCloudOsconfigV2beta__ListPolicyOrchestratorsResponse{ + 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 *OrganizationsLocationsGlobalPolicyOrchestratorsListCall) Pages(ctx context.Context, f func(*GoogleCloudOsconfigV2beta__ListPolicyOrchestratorsResponse) 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 OrganizationsLocationsGlobalPolicyOrchestratorsPatchCall struct { + s *Service + name string + googlecloudosconfigv2beta__policyorchestrator *GoogleCloudOsconfigV2beta__PolicyOrchestrator + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates an existing policy orchestrator, parented by an organization. +// +// - name: Immutable. Identifier. In form of * +// `organizations/{organization_id}/locations/global/policyOrchestrators/{orch +// estrator_id}` * +// `folders/{folder_id}/locations/global/policyOrchestrators/{orchestrator_id} +// ` * +// `projects/{project_id_or_number}/locations/global/policyOrchestrators/{orch +// estrator_id}`. +func (r *OrganizationsLocationsGlobalPolicyOrchestratorsService) Patch(name string, googlecloudosconfigv2beta__policyorchestrator *GoogleCloudOsconfigV2beta__PolicyOrchestrator) *OrganizationsLocationsGlobalPolicyOrchestratorsPatchCall { + c := &OrganizationsLocationsGlobalPolicyOrchestratorsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googlecloudosconfigv2beta__policyorchestrator = googlecloudosconfigv2beta__policyorchestrator + return c +} + +// UpdateMask sets the optional parameter "updateMask": The list of fields to +// update. +func (c *OrganizationsLocationsGlobalPolicyOrchestratorsPatchCall) UpdateMask(updateMask string) *OrganizationsLocationsGlobalPolicyOrchestratorsPatchCall { + 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 *OrganizationsLocationsGlobalPolicyOrchestratorsPatchCall) Fields(s ...googleapi.Field) *OrganizationsLocationsGlobalPolicyOrchestratorsPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsLocationsGlobalPolicyOrchestratorsPatchCall) Context(ctx context.Context) *OrganizationsLocationsGlobalPolicyOrchestratorsPatchCall { + 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 *OrganizationsLocationsGlobalPolicyOrchestratorsPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsGlobalPolicyOrchestratorsPatchCall) 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.googlecloudosconfigv2beta__policyorchestrator) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2beta/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "osconfig.organizations.locations.global.policyOrchestrators.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 *OrganizationsLocationsGlobalPolicyOrchestratorsPatchCall) 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 OrganizationsLocationsOperationsCancelCall 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 *OrganizationsLocationsOperationsService) Cancel(name string, canceloperationrequest *CancelOperationRequest) *OrganizationsLocationsOperationsCancelCall { + c := &OrganizationsLocationsOperationsCancelCall{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 *OrganizationsLocationsOperationsCancelCall) Fields(s ...googleapi.Field) *OrganizationsLocationsOperationsCancelCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsLocationsOperationsCancelCall) Context(ctx context.Context) *OrganizationsLocationsOperationsCancelCall { + 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 *OrganizationsLocationsOperationsCancelCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsOperationsCancelCall) 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 "osconfig.organizations.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 *OrganizationsLocationsOperationsCancelCall) 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 OrganizationsLocationsOperationsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + 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`. +// +// - name: The name of the operation resource to be deleted. +func (r *OrganizationsLocationsOperationsService) Delete(name string) *OrganizationsLocationsOperationsDeleteCall { + c := &OrganizationsLocationsOperationsDeleteCall{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 *OrganizationsLocationsOperationsDeleteCall) Fields(s ...googleapi.Field) *OrganizationsLocationsOperationsDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsLocationsOperationsDeleteCall) Context(ctx context.Context) *OrganizationsLocationsOperationsDeleteCall { + 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 *OrganizationsLocationsOperationsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsOperationsDeleteCall) 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, "v2beta/{+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 "osconfig.organizations.locations.operations.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 *OrganizationsLocationsOperationsDeleteCall) 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 OrganizationsLocationsOperationsGetCall 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 *OrganizationsLocationsOperationsService) Get(name string) *OrganizationsLocationsOperationsGetCall { + c := &OrganizationsLocationsOperationsGetCall{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 *OrganizationsLocationsOperationsGetCall) Fields(s ...googleapi.Field) *OrganizationsLocationsOperationsGetCall { + 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 *OrganizationsLocationsOperationsGetCall) IfNoneMatch(entityTag string) *OrganizationsLocationsOperationsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsLocationsOperationsGetCall) Context(ctx context.Context) *OrganizationsLocationsOperationsGetCall { + 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 *OrganizationsLocationsOperationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsOperationsGetCall) 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 "osconfig.organizations.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 *OrganizationsLocationsOperationsGetCall) 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 OrganizationsLocationsOperationsListCall 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 *OrganizationsLocationsOperationsService) List(name string) *OrganizationsLocationsOperationsListCall { + c := &OrganizationsLocationsOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Filter sets the optional parameter "filter": The standard list filter. +func (c *OrganizationsLocationsOperationsListCall) Filter(filter string) *OrganizationsLocationsOperationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The standard list page +// size. +func (c *OrganizationsLocationsOperationsListCall) PageSize(pageSize int64) *OrganizationsLocationsOperationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The standard list page +// token. +func (c *OrganizationsLocationsOperationsListCall) PageToken(pageToken string) *OrganizationsLocationsOperationsListCall { + 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 *OrganizationsLocationsOperationsListCall) Fields(s ...googleapi.Field) *OrganizationsLocationsOperationsListCall { + 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 *OrganizationsLocationsOperationsListCall) IfNoneMatch(entityTag string) *OrganizationsLocationsOperationsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsLocationsOperationsListCall) Context(ctx context.Context) *OrganizationsLocationsOperationsListCall { + 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 *OrganizationsLocationsOperationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsOperationsListCall) 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 "osconfig.organizations.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 *OrganizationsLocationsOperationsListCall) 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 *OrganizationsLocationsOperationsListCall) 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) + } +} + +type ProjectsLocationsGlobalPolicyOrchestratorsCreateCall struct { + s *Service + parent string + googlecloudosconfigv2beta__policyorchestrator *GoogleCloudOsconfigV2beta__PolicyOrchestrator + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a new policy orchestrator under the given project resource. +// `name` field of the given orchestrator are ignored and instead replaced by a +// product of `parent` and `policy_orchestrator_id`. Orchestrator state field +// might be only set to `ACTIVE`, `STOPPED` or omitted (in which case, the +// created resource will be in `ACTIVE` state anyway). +// +// - parent: The parent resource name in the form of: +// `organizations/{organization_id}/locations/global` +// `folders/{folder_id}/locations/global` +// 'projects/{project_id_or_number}/locations/global'. +func (r *ProjectsLocationsGlobalPolicyOrchestratorsService) Create(parent string, googlecloudosconfigv2beta__policyorchestrator *GoogleCloudOsconfigV2beta__PolicyOrchestrator) *ProjectsLocationsGlobalPolicyOrchestratorsCreateCall { + c := &ProjectsLocationsGlobalPolicyOrchestratorsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googlecloudosconfigv2beta__policyorchestrator = googlecloudosconfigv2beta__policyorchestrator + return c +} + +// PolicyOrchestratorId sets the optional parameter "policyOrchestratorId": +// Required. The logical identifier of the policy orchestrator, with the +// following restrictions: * Must contain only lowercase letters, numbers, and +// hyphens. * Must start with a letter. * Must be between 1-63 characters. * +// Must end with a number or a letter. * Must be unique within the parent. +func (c *ProjectsLocationsGlobalPolicyOrchestratorsCreateCall) PolicyOrchestratorId(policyOrchestratorId string) *ProjectsLocationsGlobalPolicyOrchestratorsCreateCall { + c.urlParams_.Set("policyOrchestratorId", policyOrchestratorId) + 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 since +// 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 *ProjectsLocationsGlobalPolicyOrchestratorsCreateCall) RequestId(requestId string) *ProjectsLocationsGlobalPolicyOrchestratorsCreateCall { + 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 *ProjectsLocationsGlobalPolicyOrchestratorsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsGlobalPolicyOrchestratorsCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGlobalPolicyOrchestratorsCreateCall) Context(ctx context.Context) *ProjectsLocationsGlobalPolicyOrchestratorsCreateCall { + 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 *ProjectsLocationsGlobalPolicyOrchestratorsCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGlobalPolicyOrchestratorsCreateCall) 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.googlecloudosconfigv2beta__policyorchestrator) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2beta/{+parent}/policyOrchestrators") + 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 "osconfig.projects.locations.global.policyOrchestrators.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 *ProjectsLocationsGlobalPolicyOrchestratorsCreateCall) 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 ProjectsLocationsGlobalPolicyOrchestratorsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes an existing policy orchestrator resource, parented by a +// project. +// +// - name: Name of the resource to be deleted. +func (r *ProjectsLocationsGlobalPolicyOrchestratorsService) Delete(name string) *ProjectsLocationsGlobalPolicyOrchestratorsDeleteCall { + c := &ProjectsLocationsGlobalPolicyOrchestratorsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Etag sets the optional parameter "etag": The current etag of the policy +// orchestrator. If an etag is provided and does not match the current etag of +// the policy orchestrator, deletion will be blocked and an ABORTED error will +// be returned. +func (c *ProjectsLocationsGlobalPolicyOrchestratorsDeleteCall) Etag(etag string) *ProjectsLocationsGlobalPolicyOrchestratorsDeleteCall { + c.urlParams_.Set("etag", etag) + 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 *ProjectsLocationsGlobalPolicyOrchestratorsDeleteCall) RequestId(requestId string) *ProjectsLocationsGlobalPolicyOrchestratorsDeleteCall { + 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 *ProjectsLocationsGlobalPolicyOrchestratorsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsGlobalPolicyOrchestratorsDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGlobalPolicyOrchestratorsDeleteCall) Context(ctx context.Context) *ProjectsLocationsGlobalPolicyOrchestratorsDeleteCall { + 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 *ProjectsLocationsGlobalPolicyOrchestratorsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGlobalPolicyOrchestratorsDeleteCall) 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, "v2beta/{+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 "osconfig.projects.locations.global.policyOrchestrators.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 *ProjectsLocationsGlobalPolicyOrchestratorsDeleteCall) 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 ProjectsLocationsGlobalPolicyOrchestratorsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Retrieves an existing policy orchestrator, parented by a project. +// +// - name: The resource name. +func (r *ProjectsLocationsGlobalPolicyOrchestratorsService) Get(name string) *ProjectsLocationsGlobalPolicyOrchestratorsGetCall { + c := &ProjectsLocationsGlobalPolicyOrchestratorsGetCall{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 *ProjectsLocationsGlobalPolicyOrchestratorsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsGlobalPolicyOrchestratorsGetCall { + 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 *ProjectsLocationsGlobalPolicyOrchestratorsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsGlobalPolicyOrchestratorsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGlobalPolicyOrchestratorsGetCall) Context(ctx context.Context) *ProjectsLocationsGlobalPolicyOrchestratorsGetCall { + 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 *ProjectsLocationsGlobalPolicyOrchestratorsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGlobalPolicyOrchestratorsGetCall) 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 "osconfig.projects.locations.global.policyOrchestrators.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudOsconfigV2beta__PolicyOrchestrator.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 *ProjectsLocationsGlobalPolicyOrchestratorsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudOsconfigV2beta__PolicyOrchestrator, 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 := &GoogleCloudOsconfigV2beta__PolicyOrchestrator{ + 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 ProjectsLocationsGlobalPolicyOrchestratorsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists the policy orchestrators under the given parent project +// resource. +// +// - parent: The parent resource name. +func (r *ProjectsLocationsGlobalPolicyOrchestratorsService) List(parent string) *ProjectsLocationsGlobalPolicyOrchestratorsListCall { + c := &ProjectsLocationsGlobalPolicyOrchestratorsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Filter sets the optional parameter "filter": Filtering results +func (c *ProjectsLocationsGlobalPolicyOrchestratorsListCall) Filter(filter string) *ProjectsLocationsGlobalPolicyOrchestratorsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// OrderBy sets the optional parameter "orderBy": Hint for how to order the +// results +func (c *ProjectsLocationsGlobalPolicyOrchestratorsListCall) OrderBy(orderBy string) *ProjectsLocationsGlobalPolicyOrchestratorsListCall { + 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. +func (c *ProjectsLocationsGlobalPolicyOrchestratorsListCall) PageSize(pageSize int64) *ProjectsLocationsGlobalPolicyOrchestratorsListCall { + 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 *ProjectsLocationsGlobalPolicyOrchestratorsListCall) PageToken(pageToken string) *ProjectsLocationsGlobalPolicyOrchestratorsListCall { + 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 *ProjectsLocationsGlobalPolicyOrchestratorsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsGlobalPolicyOrchestratorsListCall { + 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 *ProjectsLocationsGlobalPolicyOrchestratorsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsGlobalPolicyOrchestratorsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGlobalPolicyOrchestratorsListCall) Context(ctx context.Context) *ProjectsLocationsGlobalPolicyOrchestratorsListCall { + 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 *ProjectsLocationsGlobalPolicyOrchestratorsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGlobalPolicyOrchestratorsListCall) 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/{+parent}/policyOrchestrators") + 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 "osconfig.projects.locations.global.policyOrchestrators.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudOsconfigV2beta__ListPolicyOrchestratorsResponse.ServerResponse.He +// ader 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 *ProjectsLocationsGlobalPolicyOrchestratorsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudOsconfigV2beta__ListPolicyOrchestratorsResponse, 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 := &GoogleCloudOsconfigV2beta__ListPolicyOrchestratorsResponse{ + 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 *ProjectsLocationsGlobalPolicyOrchestratorsListCall) Pages(ctx context.Context, f func(*GoogleCloudOsconfigV2beta__ListPolicyOrchestratorsResponse) 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 ProjectsLocationsGlobalPolicyOrchestratorsPatchCall struct { + s *Service + name string + googlecloudosconfigv2beta__policyorchestrator *GoogleCloudOsconfigV2beta__PolicyOrchestrator + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates an existing policy orchestrator, parented by a project. +// +// - name: Immutable. Identifier. In form of * +// `organizations/{organization_id}/locations/global/policyOrchestrators/{orch +// estrator_id}` * +// `folders/{folder_id}/locations/global/policyOrchestrators/{orchestrator_id} +// ` * +// `projects/{project_id_or_number}/locations/global/policyOrchestrators/{orch +// estrator_id}`. +func (r *ProjectsLocationsGlobalPolicyOrchestratorsService) Patch(name string, googlecloudosconfigv2beta__policyorchestrator *GoogleCloudOsconfigV2beta__PolicyOrchestrator) *ProjectsLocationsGlobalPolicyOrchestratorsPatchCall { + c := &ProjectsLocationsGlobalPolicyOrchestratorsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googlecloudosconfigv2beta__policyorchestrator = googlecloudosconfigv2beta__policyorchestrator + return c +} + +// UpdateMask sets the optional parameter "updateMask": The list of fields to +// update. +func (c *ProjectsLocationsGlobalPolicyOrchestratorsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsGlobalPolicyOrchestratorsPatchCall { + 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 *ProjectsLocationsGlobalPolicyOrchestratorsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsGlobalPolicyOrchestratorsPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGlobalPolicyOrchestratorsPatchCall) Context(ctx context.Context) *ProjectsLocationsGlobalPolicyOrchestratorsPatchCall { + 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 *ProjectsLocationsGlobalPolicyOrchestratorsPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGlobalPolicyOrchestratorsPatchCall) 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.googlecloudosconfigv2beta__policyorchestrator) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2beta/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "osconfig.projects.locations.global.policyOrchestrators.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 *ProjectsLocationsGlobalPolicyOrchestratorsPatchCall) 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 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 "osconfig.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 +} + +// 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`. +// +// - 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 *ProjectsLocationsOperationsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +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 *ProjectsLocationsOperationsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsOperationsDeleteCall) 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, "v2beta/{+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 "osconfig.projects.locations.operations.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 *ProjectsLocationsOperationsDeleteCall) 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 "osconfig.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 "osconfig.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/places/v1/places-api.json b/places/v1/places-api.json index 165873ce508..0d9c10a4466 100644 --- a/places/v1/places-api.json +++ b/places/v1/places-api.json @@ -280,7 +280,7 @@ } } }, - "revision": "20241015", + "revision": "20241028", "rootUrl": "https://places.googleapis.com/", "schemas": { "GoogleGeoTypeViewport": { @@ -393,12 +393,12 @@ "type": "string" }, "straightLineDistanceMeters": { - "description": "The straight line distance in meters between the target location and the landmark.", + "description": "The straight line distance, in meters, between the center point of the target and the center point of the landmark. In some situations, this value can be longer than `travel_distance_meters`.", "format": "float", "type": "number" }, "travelDistanceMeters": { - "description": "The travel distance in meters along the road network if known. This does not take into account the mode of transportation (walking/driving).", + "description": "The travel distance, in meters, along the road network from the target to the landmark, if known. This value does not take into account the mode of transportation, such as walking, driving, or biking.", "format": "float", "type": "number" }, @@ -957,6 +957,14 @@ }, "type": "array" }, + "flagContentUri": { + "description": "A link where users can flag a problem with the photo.", + "type": "string" + }, + "googleMapsUri": { + "description": "A link to show the photo on Google Maps.", + "type": "string" + }, "heightPx": { "description": "The maximum available height, in pixels.", "format": "int32", @@ -1102,6 +1110,10 @@ "description": "Place is suitable for watching sports.", "type": "boolean" }, + "googleMapsLinks": { + "$ref": "GoogleMapsPlacesV1PlaceGoogleMapsLinks", + "description": "Links to trigger different Google Maps actions." + }, "googleMapsUri": { "description": "A URL providing more information about this place.", "type": "string" @@ -1366,6 +1378,10 @@ "$ref": "GoogleMapsPlacesV1ContentBlock" }, "type": "array" + }, + "flagContentUri": { + "description": "A link where users can flag a problem with the summary.", + "type": "string" } }, "type": "object" @@ -1393,10 +1409,18 @@ "$ref": "GoogleTypeLocalizedText", "description": "The detailed description of the place." }, + "descriptionFlagContentUri": { + "description": "A link where users can flag a problem with the description summary.", + "type": "string" + }, "overview": { "$ref": "GoogleTypeLocalizedText", "description": "The overview of the place." }, + "overviewFlagContentUri": { + "description": "A link where users can flag a problem with the overview summary.", + "type": "string" + }, "references": { "$ref": "GoogleMapsPlacesV1References", "description": "References that are used to generate the summary description." @@ -1404,6 +1428,33 @@ }, "type": "object" }, + "GoogleMapsPlacesV1PlaceGoogleMapsLinks": { + "description": "Links to trigger different Google Maps actions.", + "id": "GoogleMapsPlacesV1PlaceGoogleMapsLinks", + "properties": { + "directionsUri": { + "description": "A link to show the directions to the place. The link only populates the destination location and uses the default travel mode `DRIVE`.", + "type": "string" + }, + "photosUri": { + "description": "A link to show photos of this place. This link is currently not supported on Google Maps Mobile and only works on the web version of Google Maps.", + "type": "string" + }, + "placeUri": { + "description": "A link to show this place.", + "type": "string" + }, + "reviewsUri": { + "description": "A link to show reviews of this place. This link is currently not supported on Google Maps Mobile and only works on the web version of Google Maps.", + "type": "string" + }, + "writeAReviewUri": { + "description": "A link to write a review for this place. This link is currently not supported on Google Maps Mobile and only works on the web version of Google Maps.", + "type": "string" + } + }, + "type": "object" + }, "GoogleMapsPlacesV1PlaceOpeningHours": { "description": "Information about business hour of the place.", "id": "GoogleMapsPlacesV1PlaceOpeningHours", @@ -1656,6 +1707,14 @@ "$ref": "GoogleMapsPlacesV1AuthorAttribution", "description": "This review's author." }, + "flagContentUri": { + "description": "A link where users can flag a problem with the review.", + "type": "string" + }, + "googleMapsUri": { + "description": "A link to show the review on Google Maps.", + "type": "string" + }, "name": { "description": "A reference representing this place review which may be used to look up this place review again (also called the API \"resource\" name: `places/{place_id}/reviews/{review}`).", "type": "string" @@ -1761,6 +1820,10 @@ "description": "The duration and distance from the routing origin to a place in the response, and a second leg from that place to the destination, if requested. **Note:** Adding `routingSummaries` in the field mask without also including either the `routingParameters.origin` parameter or the `searchAlongRouteParameters.polyline.encodedPolyline` parameter in the request causes an error.", "id": "GoogleMapsPlacesV1RoutingSummary", "properties": { + "directionsUri": { + "description": "A link to show directions on Google Maps using the waypoints from the given routing summary. The route generated by this link is not guaranteed to be the same as the route used to generate the routing summary. The link uses information provided in the request, from fields including `routingParameters` and `searchAlongRouteParameters` when applicable, to generate the directions link.", + "type": "string" + }, "legs": { "description": "The legs of the trip. When you calculate travel duration and distance from a set origin, `legs` contains a single leg containing the duration and distance from the origin to the destination. When you do a search along route, `legs` contains two legs: one from the origin to place, and one from the place to the destination.", "items": { @@ -2106,6 +2169,10 @@ "$ref": "GoogleMapsPlacesV1RoutingSummary" }, "type": "array" + }, + "searchUri": { + "description": "A link allows the user to search with the same text query as specified in the request on Google Maps.", + "type": "string" } }, "type": "object" diff --git a/places/v1/places-gen.go b/places/v1/places-gen.go index ee58d48df16..eba4d2c8d8d 100644 --- a/places/v1/places-gen.go +++ b/places/v1/places-gen.go @@ -344,12 +344,13 @@ type GoogleMapsPlacesV1AddressDescriptorLandmark struct { // "BEHIND" - Close to the landmark's structure but further away from its // street entrances. SpatialRelationship string `json:"spatialRelationship,omitempty"` - // StraightLineDistanceMeters: The straight line distance in meters between the - // target location and the landmark. + // StraightLineDistanceMeters: The straight line distance, in meters, between + // the center point of the target and the center point of the landmark. In some + // situations, this value can be longer than `travel_distance_meters`. StraightLineDistanceMeters float64 `json:"straightLineDistanceMeters,omitempty"` - // TravelDistanceMeters: The travel distance in meters along the road network - // if known. This does not take into account the mode of transportation - // (walking/driving). + // TravelDistanceMeters: The travel distance, in meters, along the road network + // from the target to the landmark, if known. This value does not take into + // account the mode of transportation, such as walking, driving, or biking. TravelDistanceMeters float64 `json:"travelDistanceMeters,omitempty"` // Types: A set of type tags for this landmark. For a complete list of possible // values, see @@ -1215,6 +1216,10 @@ func (s GoogleMapsPlacesV1FuelOptionsFuelPrice) MarshalJSON() ([]byte, error) { type GoogleMapsPlacesV1Photo struct { // AuthorAttributions: This photo's authors. AuthorAttributions []*GoogleMapsPlacesV1AuthorAttribution `json:"authorAttributions,omitempty"` + // FlagContentUri: A link where users can flag a problem with the photo. + FlagContentUri string `json:"flagContentUri,omitempty"` + // GoogleMapsUri: A link to show the photo on Google Maps. + GoogleMapsUri string `json:"googleMapsUri,omitempty"` // HeightPx: The maximum available height, in pixels. HeightPx int64 `json:"heightPx,omitempty"` // Name: Identifier. A reference representing this place photo which may be @@ -1362,6 +1367,8 @@ type GoogleMapsPlacesV1Place struct { GoodForGroups bool `json:"goodForGroups,omitempty"` // GoodForWatchingSports: Place is suitable for watching sports. GoodForWatchingSports bool `json:"goodForWatchingSports,omitempty"` + // GoogleMapsLinks: Links to trigger different Google Maps actions. + GoogleMapsLinks *GoogleMapsPlacesV1PlaceGoogleMapsLinks `json:"googleMapsLinks,omitempty"` // GoogleMapsUri: A URL providing more information about this place. GoogleMapsUri string `json:"googleMapsUri,omitempty"` // IconBackgroundColor: Background color for icon_mask in hex format, e.g. @@ -1589,6 +1596,8 @@ type GoogleMapsPlacesV1PlaceAreaSummary struct { // ContentBlocks: Content blocks that compose the area summary. Each block has // a separate topic about the area. ContentBlocks []*GoogleMapsPlacesV1ContentBlock `json:"contentBlocks,omitempty"` + // FlagContentUri: A link where users can flag a problem with the summary. + FlagContentUri string `json:"flagContentUri,omitempty"` // ForceSendFields is a list of field names (e.g. "ContentBlocks") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -1638,8 +1647,14 @@ func (s GoogleMapsPlacesV1PlaceAttribution) MarshalJSON() ([]byte, error) { type GoogleMapsPlacesV1PlaceGenerativeSummary struct { // Description: The detailed description of the place. Description *GoogleTypeLocalizedText `json:"description,omitempty"` + // DescriptionFlagContentUri: A link where users can flag a problem with the + // description summary. + DescriptionFlagContentUri string `json:"descriptionFlagContentUri,omitempty"` // Overview: The overview of the place. Overview *GoogleTypeLocalizedText `json:"overview,omitempty"` + // OverviewFlagContentUri: A link where users can flag a problem with the + // overview summary. + OverviewFlagContentUri string `json:"overviewFlagContentUri,omitempty"` // References: References that are used to generate the summary description. References *GoogleMapsPlacesV1References `json:"references,omitempty"` // ForceSendFields is a list of field names (e.g. "Description") to @@ -1660,6 +1675,44 @@ func (s GoogleMapsPlacesV1PlaceGenerativeSummary) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleMapsPlacesV1PlaceGoogleMapsLinks: Links to trigger different Google +// Maps actions. +type GoogleMapsPlacesV1PlaceGoogleMapsLinks struct { + // DirectionsUri: A link to show the directions to the place. The link only + // populates the destination location and uses the default travel mode `DRIVE`. + DirectionsUri string `json:"directionsUri,omitempty"` + // PhotosUri: A link to show photos of this place. This link is currently not + // supported on Google Maps Mobile and only works on the web version of Google + // Maps. + PhotosUri string `json:"photosUri,omitempty"` + // PlaceUri: A link to show this place. + PlaceUri string `json:"placeUri,omitempty"` + // ReviewsUri: A link to show reviews of this place. This link is currently not + // supported on Google Maps Mobile and only works on the web version of Google + // Maps. + ReviewsUri string `json:"reviewsUri,omitempty"` + // WriteAReviewUri: A link to write a review for this place. This link is + // currently not supported on Google Maps Mobile and only works on the web + // version of Google Maps. + WriteAReviewUri string `json:"writeAReviewUri,omitempty"` + // ForceSendFields is a list of field names (e.g. "DirectionsUri") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "DirectionsUri") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleMapsPlacesV1PlaceGoogleMapsLinks) MarshalJSON() ([]byte, error) { + type NoMethod GoogleMapsPlacesV1PlaceGoogleMapsLinks + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleMapsPlacesV1PlaceOpeningHours: Information about business hour of the // place. type GoogleMapsPlacesV1PlaceOpeningHours struct { @@ -1994,6 +2047,10 @@ func (s GoogleMapsPlacesV1References) MarshalJSON() ([]byte, error) { type GoogleMapsPlacesV1Review struct { // AuthorAttribution: This review's author. AuthorAttribution *GoogleMapsPlacesV1AuthorAttribution `json:"authorAttribution,omitempty"` + // FlagContentUri: A link where users can flag a problem with the review. + FlagContentUri string `json:"flagContentUri,omitempty"` + // GoogleMapsUri: A link to show the review on Google Maps. + GoogleMapsUri string `json:"googleMapsUri,omitempty"` // Name: A reference representing this place review which may be used to look // up this place review again (also called the API "resource" name: // `places/{place_id}/reviews/{review}`). @@ -2155,21 +2212,28 @@ func (s GoogleMapsPlacesV1RoutingParameters) MarshalJSON() ([]byte, error) { // or the `searchAlongRouteParameters.polyline.encodedPolyline` parameter in // the request causes an error. type GoogleMapsPlacesV1RoutingSummary struct { + // DirectionsUri: A link to show directions on Google Maps using the waypoints + // from the given routing summary. The route generated by this link is not + // guaranteed to be the same as the route used to generate the routing summary. + // The link uses information provided in the request, from fields including + // `routingParameters` and `searchAlongRouteParameters` when applicable, to + // generate the directions link. + DirectionsUri string `json:"directionsUri,omitempty"` // Legs: The legs of the trip. When you calculate travel duration and distance // from a set origin, `legs` contains a single leg containing the duration and // distance from the origin to the destination. When you do a search along // route, `legs` contains two legs: one from the origin to place, and one from // the place to the destination. Legs []*GoogleMapsPlacesV1RoutingSummaryLeg `json:"legs,omitempty"` - // ForceSendFields is a list of field names (e.g. "Legs") 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. "DirectionsUri") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Legs") 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. "DirectionsUri") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -2673,6 +2737,9 @@ type GoogleMapsPlacesV1SearchTextResponse struct { // empty entry. This list will have as many entries as the list of places if // requested. RoutingSummaries []*GoogleMapsPlacesV1RoutingSummary `json:"routingSummaries,omitempty"` + // SearchUri: A link allows the user to search with the same text query as + // specified in the request on Google Maps. + SearchUri string `json:"searchUri,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` diff --git a/redis/v1/redis-api.json b/redis/v1/redis-api.json index e57b7301f8c..978f6b6b6f9 100644 --- a/redis/v1/redis-api.json +++ b/redis/v1/redis-api.json @@ -849,7 +849,7 @@ } } }, - "revision": "20241003", + "revision": "20241017", "rootUrl": "https://redis.googleapis.com/", "schemas": { "AOFConfig": { @@ -875,42 +875,6 @@ }, "type": "object" }, - "AssetLocation": { - "description": "Provides the mapping of a cloud asset to a direct physical location or to a proxy that defines the location on its behalf.", - "id": "AssetLocation", - "properties": { - "ccfeRmsPath": { - "description": "Spanner path of the CCFE RMS database. It is only applicable for CCFE tenants that use CCFE RMS for storing resource metadata.", - "type": "string" - }, - "expected": { - "$ref": "IsolationExpectations", - "description": "Defines the customer expectation around ZI/ZS for this asset and ZI/ZS state of the region at the time of asset creation." - }, - "extraParameters": { - "description": "Defines extra parameters required for specific asset types.", - "items": { - "$ref": "ExtraParameter" - }, - "type": "array" - }, - "locationData": { - "description": "Contains all kinds of physical location definitions for this asset.", - "items": { - "$ref": "LocationData" - }, - "type": "array" - }, - "parentAsset": { - "description": "Defines parents assets if any in order to allow later generation of child_asset_location data via child assets.", - "items": { - "$ref": "CloudAsset" - }, - "type": "array" - } - }, - "type": "object" - }, "AvailabilityConfiguration": { "description": "Configuration for availability of database instance", "id": "AvailabilityConfiguration", @@ -1004,19 +968,6 @@ }, "type": "object" }, - "BlobstoreLocation": { - "description": "Policy ID that identified data placement in Blobstore as per go/blobstore-user-guide#data-metadata-placement-and-failure-domains", - "id": "BlobstoreLocation", - "properties": { - "policyId": { - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "CertChain": { "id": "CertChain", "properties": { @@ -1044,30 +995,6 @@ }, "type": "object" }, - "CloudAsset": { - "id": "CloudAsset", - "properties": { - "assetName": { - "type": "string" - }, - "assetType": { - "type": "string" - } - }, - "type": "object" - }, - "CloudAssetComposition": { - "id": "CloudAssetComposition", - "properties": { - "childAsset": { - "items": { - "$ref": "CloudAsset" - }, - "type": "array" - } - }, - "type": "object" - }, "Cluster": { "description": "A cluster instance.", "id": "Cluster", @@ -1086,6 +1013,13 @@ ], "type": "string" }, + "clusterEndpoints": { + "description": "Optional. A list of cluster enpoints.", + "items": { + "$ref": "ClusterEndpoint" + }, + "type": "array" + }, "createTime": { "description": "Output only. The timestamp associated with the cluster creation request.", "format": "google-datetime", @@ -1150,7 +1084,7 @@ "type": "number" }, "pscConfigs": { - "description": "Required. Each PscConfig configures the consumer network where IPs will be designated to the cluster for client access through Private Service Connect Automation. Currently, only one PscConfig is supported.", + "description": "Optional. Each PscConfig configures the consumer network where IPs will be designated to the cluster for client access through Private Service Connect Automation. Currently, only one PscConfig is supported.", "items": { "$ref": "PscConfig" }, @@ -1164,6 +1098,14 @@ "readOnly": true, "type": "array" }, + "pscServiceAttachments": { + "description": "Output only. Service attachment details to configure Psc connections", + "items": { + "$ref": "PscServiceAttachment" + }, + "readOnly": true, + "type": "array" + }, "redisConfigs": { "additionalProperties": { "type": "string" @@ -1237,6 +1179,20 @@ }, "type": "object" }, + "ClusterEndpoint": { + "description": "ClusterEndpoint consists of PSC connections that are created as a group in each VPC network for accessing the cluster. In each group, there shall be one connection for each service attachment in the cluster.", + "id": "ClusterEndpoint", + "properties": { + "connections": { + "description": "A group of PSC connections. They are created in the same VPC network, one for each service attachment in the cluster.", + "items": { + "$ref": "ConnectionDetail" + }, + "type": "array" + } + }, + "type": "object" + }, "ClusterMaintenancePolicy": { "description": "Maintenance policy per cluster.", "id": "ClusterMaintenancePolicy", @@ -1363,6 +1319,17 @@ }, "type": "object" }, + "ConnectionDetail": { + "description": "Detailed information of each PSC connection.", + "id": "ConnectionDetail", + "properties": { + "pscConnection": { + "$ref": "PscConnection", + "description": "Detailed information of a PSC connection that is created by the customer who owns the cluster." + } + }, + "type": "object" + }, "CrossClusterReplicationConfig": { "description": "Cross cluster replication config.", "id": "CrossClusterReplicationConfig", @@ -2360,18 +2327,6 @@ }, "type": "object" }, - "DirectLocationAssignment": { - "id": "DirectLocationAssignment", - "properties": { - "location": { - "items": { - "$ref": "LocationAssignment" - }, - "type": "array" - } - }, - "type": "object" - }, "DiscoveryEndpoint": { "description": "Endpoints on each network, for Redis clients to connect to the cluster.", "id": "DiscoveryEndpoint", @@ -2445,17 +2400,6 @@ }, "type": "object" }, - "ExtraParameter": { - "description": "Defines parameters that should only be used for specific asset types.", - "id": "ExtraParameter", - "properties": { - "regionalMigDistributionPolicy": { - "$ref": "RegionalMigDistributionPolicy", - "description": "Details about zones used by regional compute.googleapis.com/InstanceGroupManager to create instances." - } - }, - "type": "object" - }, "FailoverInstanceRequest": { "description": "Request for Failover.", "id": "FailoverInstanceRequest", @@ -2877,131 +2821,6 @@ }, "type": "object" }, - "IsolationExpectations": { - "id": "IsolationExpectations", - "properties": { - "requirementOverride": { - "$ref": "RequirementOverride", - "description": "Explicit overrides for ZI and ZS requirements to be used for resources that should be excluded from ZI/ZS verification logic." - }, - "ziOrgPolicy": { - "enum": [ - "ZI_UNSPECIFIED", - "ZI_UNKNOWN", - "ZI_NOT_REQUIRED", - "ZI_PREFERRED", - "ZI_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "", - "" - ], - "type": "string" - }, - "ziRegionPolicy": { - "enum": [ - "ZI_REGION_POLICY_UNSPECIFIED", - "ZI_REGION_POLICY_UNKNOWN", - "ZI_REGION_POLICY_NOT_SET", - "ZI_REGION_POLICY_FAIL_OPEN", - "ZI_REGION_POLICY_FAIL_CLOSED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "", - "" - ], - "type": "string" - }, - "ziRegionState": { - "enum": [ - "ZI_REGION_UNSPECIFIED", - "ZI_REGION_UNKNOWN", - "ZI_REGION_NOT_ENABLED", - "ZI_REGION_ENABLED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "" - ], - "type": "string" - }, - "zoneIsolation": { - "deprecated": true, - "description": "Deprecated: use zi_org_policy, zi_region_policy and zi_region_state instead for setting ZI expectations as per go/zicy-publish-physical-location.", - "enum": [ - "ZI_UNSPECIFIED", - "ZI_UNKNOWN", - "ZI_NOT_REQUIRED", - "ZI_PREFERRED", - "ZI_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "", - "" - ], - "type": "string" - }, - "zoneSeparation": { - "deprecated": true, - "description": "Deprecated: use zs_org_policy, and zs_region_stateinstead for setting Zs expectations as per go/zicy-publish-physical-location.", - "enum": [ - "ZS_UNSPECIFIED", - "ZS_UNKNOWN", - "ZS_NOT_REQUIRED", - "ZS_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "" - ], - "type": "string" - }, - "zsOrgPolicy": { - "enum": [ - "ZS_UNSPECIFIED", - "ZS_UNKNOWN", - "ZS_NOT_REQUIRED", - "ZS_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "" - ], - "type": "string" - }, - "zsRegionState": { - "enum": [ - "ZS_REGION_UNSPECIFIED", - "ZS_REGION_UNKNOWN", - "ZS_REGION_NOT_ENABLED", - "ZS_REGION_ENABLED" - ], - "enumDescriptions": [ - "", - "To be used if tracking of the asset ZS-bit is not available", - "", - "" - ], - "type": "string" - } - }, - "type": "object" - }, "ListClustersResponse": { "description": "Response for ListClusters.", "id": "ListClustersResponse", @@ -3122,64 +2941,6 @@ }, "type": "object" }, - "LocationAssignment": { - "id": "LocationAssignment", - "properties": { - "location": { - "type": "string" - }, - "locationType": { - "enum": [ - "UNSPECIFIED", - "CLUSTER", - "POP", - "CLOUD_ZONE", - "CLOUD_REGION", - "MULTI_REGION_GEO", - "MULTI_REGION_JURISDICTION", - "GLOBAL", - "OTHER" - ], - "enumDescriptions": [ - "", - "1-10: Physical failure domains.", - "", - "11-20: Logical failure domains.", - "", - "", - "", - "", - "" - ], - "type": "string" - } - }, - "type": "object" - }, - "LocationData": { - "id": "LocationData", - "properties": { - "blobstoreLocation": { - "$ref": "BlobstoreLocation" - }, - "childAssetLocation": { - "$ref": "CloudAssetComposition" - }, - "directLocation": { - "$ref": "DirectLocationAssignment" - }, - "gcpProjectProxy": { - "$ref": "TenantProjectProxy" - }, - "placerLocation": { - "$ref": "PlacerLocation" - }, - "spannerLocation": { - "$ref": "SpannerLocation" - } - }, - "type": "object" - }, "MachineConfiguration": { "description": "MachineConfiguration describes the configuration of a machine specific to Database Resource.", "id": "MachineConfiguration", @@ -3545,17 +3306,6 @@ }, "type": "object" }, - "PlacerLocation": { - "description": "Message describing that the location of the customer resource is tied to placer allocations", - "id": "PlacerLocation", - "properties": { - "placerConfig": { - "description": "Directory with a config related to it in placer (e.g. \"/placer/prod/home/my-root/my-dir\")", - "type": "string" - } - }, - "type": "object" - }, "Product": { "description": "Product specification for Condor resources.", "id": "Product", @@ -3689,6 +3439,23 @@ "description": "Required. The IP allocated on the consumer network for the PSC forwarding rule.", "type": "string" }, + "connectionType": { + "description": "Output only. Type of the PSC connection.", + "enum": [ + "CONNECTION_TYPE_UNSPECIFIED", + "CONNECTION_TYPE_DISCOVERY", + "CONNECTION_TYPE_PRIMARY", + "CONNECTION_TYPE_READER" + ], + "enumDescriptions": [ + "Cluster endpoint Type is not set", + "Cluster endpoint that will be used as for cluster topology discovery.", + "Cluster endpoint that will be used as primary endpoint to access primary.", + "Cluster endpoint that will be used as reader endpoint to access replicas." + ], + "readOnly": true, + "type": "string" + }, "forwardingRule": { "description": "Required. The URI of the consumer side forwarding rule. Example: projects/{projectNumOrId}/regions/us-east1/forwardingRules/{resourceId}.", "type": "string" @@ -3705,6 +3472,21 @@ "description": "Required. The PSC connection id of the forwarding rule connected to the service attachment.", "type": "string" }, + "pscConnectionStatus": { + "description": "Output only. The status of the PSC connection. Please note that this value is updated periodically. To get the latest status of a PSC connection, follow https://cloud.google.com/vpc/docs/configure-private-service-connect-services#endpoint-details.", + "enum": [ + "PSC_CONNECTION_STATUS_UNSPECIFIED", + "PSC_CONNECTION_STATUS_ACTIVE", + "PSC_CONNECTION_STATUS_NOT_FOUND" + ], + "enumDescriptions": [ + "PSC connection status is not specified.", + "The connection is active", + "Connection not found" + ], + "readOnly": true, + "type": "string" + }, "serviceAttachment": { "description": "Required. The service attachment which is the target of the PSC connection, in the form of projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment-id}.", "type": "string" @@ -3712,6 +3494,35 @@ }, "type": "object" }, + "PscServiceAttachment": { + "description": "Configuration of a service attachment of the cluster, for creating PSC connections.", + "id": "PscServiceAttachment", + "properties": { + "connectionType": { + "description": "Output only. Type of a PSC connection targeting this service attachment.", + "enum": [ + "CONNECTION_TYPE_UNSPECIFIED", + "CONNECTION_TYPE_DISCOVERY", + "CONNECTION_TYPE_PRIMARY", + "CONNECTION_TYPE_READER" + ], + "enumDescriptions": [ + "Cluster endpoint Type is not set", + "Cluster endpoint that will be used as for cluster topology discovery.", + "Cluster endpoint that will be used as primary endpoint to access primary.", + "Cluster endpoint that will be used as reader endpoint to access replicas." + ], + "readOnly": true, + "type": "string" + }, + "serviceAttachment": { + "description": "Output only. Service attachment URI which your self-created PscConnection should use as target", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "RDBConfig": { "description": "Configuration of the RDB based persistence.", "id": "RDBConfig", @@ -3773,25 +3584,6 @@ }, "type": "object" }, - "RegionalMigDistributionPolicy": { - "description": "To be used for specifying the intended distribution of regional compute.googleapis.com/InstanceGroupManager instances", - "id": "RegionalMigDistributionPolicy", - "properties": { - "targetShape": { - "description": "The shape in which the group converges around distribution of resources. Instance of proto2 enum", - "format": "int32", - "type": "integer" - }, - "zones": { - "description": "Cloud zones used by regional MIG to create instances.", - "items": { - "$ref": "ZoneConfiguration" - }, - "type": "array" - } - }, - "type": "object" - }, "RemoteCluster": { "description": "Details of the remote cluster associated with this cluster in a cross cluster replication setup.", "id": "RemoteCluster", @@ -3808,44 +3600,6 @@ }, "type": "object" }, - "RequirementOverride": { - "id": "RequirementOverride", - "properties": { - "ziOverride": { - "enum": [ - "ZI_UNSPECIFIED", - "ZI_UNKNOWN", - "ZI_NOT_REQUIRED", - "ZI_PREFERRED", - "ZI_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "", - "" - ], - "type": "string" - }, - "zsOverride": { - "enum": [ - "ZS_UNSPECIFIED", - "ZS_UNKNOWN", - "ZS_NOT_REQUIRED", - "ZS_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "" - ], - "type": "string" - } - }, - "type": "object" - }, "RescheduleClusterMaintenanceRequest": { "description": "Request for rescheduling a cluster maintenance.", "id": "RescheduleClusterMaintenanceRequest", @@ -3913,6 +3667,7 @@ "type": "integer" }, "retentionUnit": { + "deprecated": true, "description": "The unit that 'retained_backups' represents.", "enum": [ "RETENTION_UNIT_UNSPECIFIED", @@ -3933,26 +3688,11 @@ "timeBasedRetention": { "format": "google-duration", "type": "string" - } - }, - "type": "object" - }, - "SpannerLocation": { - "id": "SpannerLocation", - "properties": { - "backupName": { - "description": "Set of backups used by the resource with name in the same format as what is available at http://table/spanner_automon.backup_metadata", - "items": { - "type": "string" - }, - "type": "array" }, - "dbName": { - "description": "Set of databases used by the resource in format /span//", - "items": { - "type": "string" - }, - "type": "array" + "timestampBasedRetentionTime": { + "description": "Timestamp based retention period i.e. 2024-05-01T00:00:00Z", + "format": "google-datetime", + "type": "string" } }, "type": "object" @@ -4009,18 +3749,6 @@ }, "type": "object" }, - "TenantProjectProxy": { - "id": "TenantProjectProxy", - "properties": { - "projectNumbers": { - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "TimeOfDay": { "description": "Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`.", "id": "TimeOfDay", @@ -4186,15 +3914,6 @@ }, "type": "object" }, - "ZoneConfiguration": { - "id": "ZoneConfiguration", - "properties": { - "zone": { - "type": "string" - } - }, - "type": "object" - }, "ZoneDistributionConfig": { "description": "Zone distribution config for allocation of cluster resources.", "id": "ZoneDistributionConfig", diff --git a/redis/v1/redis-gen.go b/redis/v1/redis-gen.go index 76aa666057f..c24629de5fc 100644 --- a/redis/v1/redis-gen.go +++ b/redis/v1/redis-gen.go @@ -244,41 +244,6 @@ func (s AOFConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// AssetLocation: Provides the mapping of a cloud asset to a direct physical -// location or to a proxy that defines the location on its behalf. -type AssetLocation struct { - // CcfeRmsPath: Spanner path of the CCFE RMS database. It is only applicable - // for CCFE tenants that use CCFE RMS for storing resource metadata. - CcfeRmsPath string `json:"ccfeRmsPath,omitempty"` - // Expected: Defines the customer expectation around ZI/ZS for this asset and - // ZI/ZS state of the region at the time of asset creation. - Expected *IsolationExpectations `json:"expected,omitempty"` - // ExtraParameters: Defines extra parameters required for specific asset types. - ExtraParameters []*ExtraParameter `json:"extraParameters,omitempty"` - // LocationData: Contains all kinds of physical location definitions for this - // asset. - LocationData []*LocationData `json:"locationData,omitempty"` - // ParentAsset: Defines parents assets if any in order to allow later - // generation of child_asset_location data via child assets. - ParentAsset []*CloudAsset `json:"parentAsset,omitempty"` - // ForceSendFields is a list of field names (e.g. "CcfeRmsPath") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "CcfeRmsPath") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s AssetLocation) MarshalJSON() ([]byte, error) { - type NoMethod AssetLocation - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // AvailabilityConfiguration: Configuration for availability of database // instance type AvailabilityConfiguration struct { @@ -386,28 +351,6 @@ func (s BackupRun) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// BlobstoreLocation: Policy ID that identified data placement in Blobstore as -// per go/blobstore-user-guide#data-metadata-placement-and-failure-domains -type BlobstoreLocation struct { - PolicyId []string `json:"policyId,omitempty"` - // ForceSendFields is a list of field names (e.g. "PolicyId") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "PolicyId") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s BlobstoreLocation) MarshalJSON() ([]byte, error) { - type NoMethod BlobstoreLocation - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - type CertChain struct { // Certificates: The certificates that form the CA chain, from leaf to root // order. @@ -459,47 +402,6 @@ func (s CertificateAuthority) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type CloudAsset struct { - AssetName string `json:"assetName,omitempty"` - AssetType string `json:"assetType,omitempty"` - // ForceSendFields is a list of field names (e.g. "AssetName") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "AssetName") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s CloudAsset) MarshalJSON() ([]byte, error) { - type NoMethod CloudAsset - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -type CloudAssetComposition struct { - ChildAsset []*CloudAsset `json:"childAsset,omitempty"` - // ForceSendFields is a list of field names (e.g. "ChildAsset") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ChildAsset") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s CloudAssetComposition) MarshalJSON() ([]byte, error) { - type NoMethod CloudAssetComposition - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // Cluster: A cluster instance. type Cluster struct { // AuthorizationMode: Optional. The authorization mode of the Redis cluster. If @@ -510,6 +412,8 @@ type Cluster struct { // "AUTH_MODE_IAM_AUTH" - IAM basic authorization mode // "AUTH_MODE_DISABLED" - Authorization disabled mode AuthorizationMode string `json:"authorizationMode,omitempty"` + // ClusterEndpoints: Optional. A list of cluster enpoints. + ClusterEndpoints []*ClusterEndpoint `json:"clusterEndpoints,omitempty"` // CreateTime: Output only. The timestamp associated with the cluster creation // request. CreateTime string `json:"createTime,omitempty"` @@ -547,13 +451,16 @@ type Cluster struct { // PreciseSizeGb: Output only. Precise value of redis memory size in GB for the // entire cluster. PreciseSizeGb float64 `json:"preciseSizeGb,omitempty"` - // PscConfigs: Required. Each PscConfig configures the consumer network where + // PscConfigs: Optional. Each PscConfig configures the consumer network where // IPs will be designated to the cluster for client access through Private // Service Connect Automation. Currently, only one PscConfig is supported. PscConfigs []*PscConfig `json:"pscConfigs,omitempty"` // PscConnections: Output only. The list of PSC connections that are // auto-created through service connectivity automation. PscConnections []*PscConnection `json:"pscConnections,omitempty"` + // PscServiceAttachments: Output only. Service attachment details to configure + // Psc connections + PscServiceAttachments []*PscServiceAttachment `json:"pscServiceAttachments,omitempty"` // RedisConfigs: Optional. Key/Value pairs of customer overrides for mutable // Redis Configs RedisConfigs map[string]string `json:"redisConfigs,omitempty"` @@ -626,6 +533,32 @@ func (s *Cluster) UnmarshalJSON(data []byte) error { return nil } +// ClusterEndpoint: ClusterEndpoint consists of PSC connections that are +// created as a group in each VPC network for accessing the cluster. In each +// group, there shall be one connection for each service attachment in the +// cluster. +type ClusterEndpoint struct { + // Connections: A group of PSC connections. They are created in the same VPC + // network, one for each service attachment in the cluster. + Connections []*ConnectionDetail `json:"connections,omitempty"` + // ForceSendFields is a list of field names (e.g. "Connections") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Connections") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ClusterEndpoint) MarshalJSON() ([]byte, error) { + type NoMethod ClusterEndpoint + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ClusterMaintenancePolicy: Maintenance policy per cluster. type ClusterMaintenancePolicy struct { // CreateTime: Output only. The time when the policy was created i.e. @@ -776,6 +709,29 @@ func (s Compliance) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ConnectionDetail: Detailed information of each PSC connection. +type ConnectionDetail struct { + // PscConnection: Detailed information of a PSC connection that is created by + // the customer who owns the cluster. + PscConnection *PscConnection `json:"pscConnection,omitempty"` + // ForceSendFields is a list of field names (e.g. "PscConnection") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "PscConnection") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ConnectionDetail) MarshalJSON() ([]byte, error) { + type NoMethod ConnectionDetail + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // CrossClusterReplicationConfig: Cross cluster replication config. type CrossClusterReplicationConfig struct { // ClusterRole: The role of the cluster in cross cluster replication. @@ -1613,26 +1569,6 @@ func (s DatabaseResourceRecommendationSignalData) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type DirectLocationAssignment struct { - Location []*LocationAssignment `json:"location,omitempty"` - // ForceSendFields is a list of field names (e.g. "Location") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Location") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s DirectLocationAssignment) MarshalJSON() ([]byte, error) { - type NoMethod DirectLocationAssignment - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // DiscoveryEndpoint: Endpoints on each network, for Redis clients to connect // to the cluster. type DiscoveryEndpoint struct { @@ -1731,30 +1667,6 @@ func (s ExportInstanceRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// ExtraParameter: Defines parameters that should only be used for specific -// asset types. -type ExtraParameter struct { - // RegionalMigDistributionPolicy: Details about zones used by regional - // compute.googleapis.com/InstanceGroupManager to create instances. - RegionalMigDistributionPolicy *RegionalMigDistributionPolicy `json:"regionalMigDistributionPolicy,omitempty"` - // ForceSendFields is a list of field names (e.g. - // "RegionalMigDistributionPolicy") to unconditionally include in API requests. - // By default, fields with empty or default values are omitted from API - // requests. See https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields - // for more details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "RegionalMigDistributionPolicy") - // to include in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s ExtraParameter) MarshalJSON() ([]byte, error) { - type NoMethod ExtraParameter - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // FailoverInstanceRequest: Request for Failover. type FailoverInstanceRequest struct { // DataProtectionMode: Optional. Available data protection modes that the user @@ -2214,81 +2126,6 @@ func (s InternalResourceMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type IsolationExpectations struct { - // RequirementOverride: Explicit overrides for ZI and ZS requirements to be - // used for resources that should be excluded from ZI/ZS verification logic. - RequirementOverride *RequirementOverride `json:"requirementOverride,omitempty"` - // Possible values: - // "ZI_UNSPECIFIED" - // "ZI_UNKNOWN" - To be used if tracking is not available - // "ZI_NOT_REQUIRED" - // "ZI_PREFERRED" - // "ZI_REQUIRED" - ZiOrgPolicy string `json:"ziOrgPolicy,omitempty"` - // Possible values: - // "ZI_REGION_POLICY_UNSPECIFIED" - // "ZI_REGION_POLICY_UNKNOWN" - To be used if tracking is not available - // "ZI_REGION_POLICY_NOT_SET" - // "ZI_REGION_POLICY_FAIL_OPEN" - // "ZI_REGION_POLICY_FAIL_CLOSED" - ZiRegionPolicy string `json:"ziRegionPolicy,omitempty"` - // Possible values: - // "ZI_REGION_UNSPECIFIED" - // "ZI_REGION_UNKNOWN" - To be used if tracking is not available - // "ZI_REGION_NOT_ENABLED" - // "ZI_REGION_ENABLED" - ZiRegionState string `json:"ziRegionState,omitempty"` - // ZoneIsolation: Deprecated: use zi_org_policy, zi_region_policy and - // zi_region_state instead for setting ZI expectations as per - // go/zicy-publish-physical-location. - // - // Possible values: - // "ZI_UNSPECIFIED" - // "ZI_UNKNOWN" - To be used if tracking is not available - // "ZI_NOT_REQUIRED" - // "ZI_PREFERRED" - // "ZI_REQUIRED" - ZoneIsolation string `json:"zoneIsolation,omitempty"` - // ZoneSeparation: Deprecated: use zs_org_policy, and zs_region_stateinstead - // for setting Zs expectations as per go/zicy-publish-physical-location. - // - // Possible values: - // "ZS_UNSPECIFIED" - // "ZS_UNKNOWN" - To be used if tracking is not available - // "ZS_NOT_REQUIRED" - // "ZS_REQUIRED" - ZoneSeparation string `json:"zoneSeparation,omitempty"` - // Possible values: - // "ZS_UNSPECIFIED" - // "ZS_UNKNOWN" - To be used if tracking is not available - // "ZS_NOT_REQUIRED" - // "ZS_REQUIRED" - ZsOrgPolicy string `json:"zsOrgPolicy,omitempty"` - // Possible values: - // "ZS_REGION_UNSPECIFIED" - // "ZS_REGION_UNKNOWN" - To be used if tracking of the asset ZS-bit is not - // available - // "ZS_REGION_NOT_ENABLED" - // "ZS_REGION_ENABLED" - ZsRegionState string `json:"zsRegionState,omitempty"` - // ForceSendFields is a list of field names (e.g. "RequirementOverride") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "RequirementOverride") to include - // in API requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s IsolationExpectations) MarshalJSON() ([]byte, error) { - type NoMethod IsolationExpectations - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // ListClustersResponse: Response for ListClusters. type ListClustersResponse struct { // Clusters: A list of Redis clusters in the project in the specified location, @@ -2460,62 +2297,6 @@ func (s Location) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type LocationAssignment struct { - Location string `json:"location,omitempty"` - // Possible values: - // "UNSPECIFIED" - // "CLUSTER" - 1-10: Physical failure domains. - // "POP" - // "CLOUD_ZONE" - 11-20: Logical failure domains. - // "CLOUD_REGION" - // "MULTI_REGION_GEO" - // "MULTI_REGION_JURISDICTION" - // "GLOBAL" - // "OTHER" - LocationType string `json:"locationType,omitempty"` - // ForceSendFields is a list of field names (e.g. "Location") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Location") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s LocationAssignment) MarshalJSON() ([]byte, error) { - type NoMethod LocationAssignment - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -type LocationData struct { - BlobstoreLocation *BlobstoreLocation `json:"blobstoreLocation,omitempty"` - ChildAssetLocation *CloudAssetComposition `json:"childAssetLocation,omitempty"` - DirectLocation *DirectLocationAssignment `json:"directLocation,omitempty"` - GcpProjectProxy *TenantProjectProxy `json:"gcpProjectProxy,omitempty"` - PlacerLocation *PlacerLocation `json:"placerLocation,omitempty"` - SpannerLocation *SpannerLocation `json:"spannerLocation,omitempty"` - // ForceSendFields is a list of field names (e.g. "BlobstoreLocation") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "BlobstoreLocation") to include in - // API requests with the JSON null value. By default, fields with empty values - // are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s LocationData) MarshalJSON() ([]byte, error) { - type NoMethod LocationData - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // MachineConfiguration: MachineConfiguration describes the configuration of a // machine specific to Database Resource. type MachineConfiguration struct { @@ -2928,30 +2709,6 @@ func (s PersistenceConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// PlacerLocation: Message describing that the location of the customer -// resource is tied to placer allocations -type PlacerLocation struct { - // PlacerConfig: Directory with a config related to it in placer (e.g. - // "/placer/prod/home/my-root/my-dir") - PlacerConfig string `json:"placerConfig,omitempty"` - // ForceSendFields is a list of field names (e.g. "PlacerConfig") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "PlacerConfig") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s PlacerLocation) MarshalJSON() ([]byte, error) { - type NoMethod PlacerLocation - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // Product: Product specification for Condor resources. type Product struct { // Engine: The specific engine that the underlying database is running. @@ -3050,6 +2807,17 @@ type PscConnection struct { // Address: Required. The IP allocated on the consumer network for the PSC // forwarding rule. Address string `json:"address,omitempty"` + // ConnectionType: Output only. Type of the PSC connection. + // + // Possible values: + // "CONNECTION_TYPE_UNSPECIFIED" - Cluster endpoint Type is not set + // "CONNECTION_TYPE_DISCOVERY" - Cluster endpoint that will be used as for + // cluster topology discovery. + // "CONNECTION_TYPE_PRIMARY" - Cluster endpoint that will be used as primary + // endpoint to access primary. + // "CONNECTION_TYPE_READER" - Cluster endpoint that will be used as reader + // endpoint to access replicas. + ConnectionType string `json:"connectionType,omitempty"` // ForwardingRule: Required. The URI of the consumer side forwarding rule. // Example: // projects/{projectNumOrId}/regions/us-east1/forwardingRules/{resourceId}. @@ -3063,6 +2831,17 @@ type PscConnection struct { // PscConnectionId: Required. The PSC connection id of the forwarding rule // connected to the service attachment. PscConnectionId string `json:"pscConnectionId,omitempty"` + // PscConnectionStatus: Output only. The status of the PSC connection. Please + // note that this value is updated periodically. To get the latest status of a + // PSC connection, follow + // https://cloud.google.com/vpc/docs/configure-private-service-connect-services#endpoint-details. + // + // Possible values: + // "PSC_CONNECTION_STATUS_UNSPECIFIED" - PSC connection status is not + // specified. + // "PSC_CONNECTION_STATUS_ACTIVE" - The connection is active + // "PSC_CONNECTION_STATUS_NOT_FOUND" - Connection not found + PscConnectionStatus string `json:"pscConnectionStatus,omitempty"` // ServiceAttachment: Required. The service attachment which is the target of // the PSC connection, in the form of // projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment @@ -3086,6 +2865,42 @@ func (s PscConnection) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// PscServiceAttachment: Configuration of a service attachment of the cluster, +// for creating PSC connections. +type PscServiceAttachment struct { + // ConnectionType: Output only. Type of a PSC connection targeting this service + // attachment. + // + // Possible values: + // "CONNECTION_TYPE_UNSPECIFIED" - Cluster endpoint Type is not set + // "CONNECTION_TYPE_DISCOVERY" - Cluster endpoint that will be used as for + // cluster topology discovery. + // "CONNECTION_TYPE_PRIMARY" - Cluster endpoint that will be used as primary + // endpoint to access primary. + // "CONNECTION_TYPE_READER" - Cluster endpoint that will be used as reader + // endpoint to access replicas. + ConnectionType string `json:"connectionType,omitempty"` + // ServiceAttachment: Output only. Service attachment URI which your + // self-created PscConnection should use as target + ServiceAttachment string `json:"serviceAttachment,omitempty"` + // ForceSendFields is a list of field names (e.g. "ConnectionType") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ConnectionType") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s PscServiceAttachment) MarshalJSON() ([]byte, error) { + type NoMethod PscServiceAttachment + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // RDBConfig: Configuration of the RDB based persistence. type RDBConfig struct { // RdbSnapshotPeriod: Optional. Period between RDB snapshots. @@ -3154,33 +2969,6 @@ func (s ReconciliationOperationMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// RegionalMigDistributionPolicy: To be used for specifying the intended -// distribution of regional compute.googleapis.com/InstanceGroupManager -// instances -type RegionalMigDistributionPolicy struct { - // TargetShape: The shape in which the group converges around distribution of - // resources. Instance of proto2 enum - TargetShape int64 `json:"targetShape,omitempty"` - // Zones: Cloud zones used by regional MIG to create instances. - Zones []*ZoneConfiguration `json:"zones,omitempty"` - // ForceSendFields is a list of field names (e.g. "TargetShape") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "TargetShape") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s RegionalMigDistributionPolicy) MarshalJSON() ([]byte, error) { - type NoMethod RegionalMigDistributionPolicy - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // RemoteCluster: Details of the remote cluster associated with this cluster in // a cross cluster replication setup. type RemoteCluster struct { @@ -3207,38 +2995,6 @@ func (s RemoteCluster) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type RequirementOverride struct { - // Possible values: - // "ZI_UNSPECIFIED" - // "ZI_UNKNOWN" - To be used if tracking is not available - // "ZI_NOT_REQUIRED" - // "ZI_PREFERRED" - // "ZI_REQUIRED" - ZiOverride string `json:"ziOverride,omitempty"` - // Possible values: - // "ZS_UNSPECIFIED" - // "ZS_UNKNOWN" - To be used if tracking is not available - // "ZS_NOT_REQUIRED" - // "ZS_REQUIRED" - ZsOverride string `json:"zsOverride,omitempty"` - // ForceSendFields is a list of field names (e.g. "ZiOverride") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ZiOverride") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s RequirementOverride) MarshalJSON() ([]byte, error) { - type NoMethod RequirementOverride - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // RescheduleClusterMaintenanceRequest: Request for rescheduling a cluster // maintenance. type RescheduleClusterMaintenanceRequest struct { @@ -3327,6 +3083,9 @@ type RetentionSettings struct { // "RETENTION_UNIT_OTHER" - For rest of the other category RetentionUnit string `json:"retentionUnit,omitempty"` TimeBasedRetention string `json:"timeBasedRetention,omitempty"` + // TimestampBasedRetentionTime: Timestamp based retention period i.e. + // 2024-05-01T00:00:00Z + TimestampBasedRetentionTime string `json:"timestampBasedRetentionTime,omitempty"` // ForceSendFields is a list of field names (e.g. "DurationBasedRetention") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -3345,30 +3104,6 @@ func (s RetentionSettings) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type SpannerLocation struct { - // BackupName: Set of backups used by the resource with name in the same format - // as what is available at http://table/spanner_automon.backup_metadata - BackupName []string `json:"backupName,omitempty"` - // DbName: Set of databases used by the resource in format /span// - DbName []string `json:"dbName,omitempty"` - // ForceSendFields is a list of field names (e.g. "BackupName") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "BackupName") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s SpannerLocation) MarshalJSON() ([]byte, error) { - type NoMethod SpannerLocation - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // StateInfo: Represents additional information about the state of the cluster. type StateInfo struct { // UpdateInfo: Describes ongoing update on the cluster when cluster state is @@ -3450,26 +3185,6 @@ func (s Tags) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type TenantProjectProxy struct { - ProjectNumbers []string `json:"projectNumbers,omitempty"` - // ForceSendFields is a list of field names (e.g. "ProjectNumbers") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ProjectNumbers") to include in - // API requests with the JSON null value. By default, fields with empty values - // are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s TenantProjectProxy) MarshalJSON() ([]byte, error) { - type NoMethod TenantProjectProxy - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // TimeOfDay: Represents a time of day. The date and time zone are either not // significant or are specified elsewhere. An API may choose to allow leap // seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. @@ -3691,26 +3406,6 @@ func (s WeeklyMaintenanceWindow) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type ZoneConfiguration struct { - Zone string `json:"zone,omitempty"` - // ForceSendFields is a list of field names (e.g. "Zone") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Zone") to include in API requests - // with the JSON null value. By default, fields with empty values are omitted - // from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s ZoneConfiguration) MarshalJSON() ([]byte, error) { - type NoMethod ZoneConfiguration - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // ZoneDistributionConfig: Zone distribution config for allocation of cluster // resources. type ZoneDistributionConfig struct { diff --git a/redis/v1beta1/redis-api.json b/redis/v1beta1/redis-api.json index 4ca37bb02fe..39d9be037d4 100644 --- a/redis/v1beta1/redis-api.json +++ b/redis/v1beta1/redis-api.json @@ -849,7 +849,7 @@ } } }, - "revision": "20241010", + "revision": "20241017", "rootUrl": "https://redis.googleapis.com/", "schemas": { "AOFConfig": { @@ -875,42 +875,6 @@ }, "type": "object" }, - "AssetLocation": { - "description": "Provides the mapping of a cloud asset to a direct physical location or to a proxy that defines the location on its behalf.", - "id": "AssetLocation", - "properties": { - "ccfeRmsPath": { - "description": "Spanner path of the CCFE RMS database. It is only applicable for CCFE tenants that use CCFE RMS for storing resource metadata.", - "type": "string" - }, - "expected": { - "$ref": "IsolationExpectations", - "description": "Defines the customer expectation around ZI/ZS for this asset and ZI/ZS state of the region at the time of asset creation." - }, - "extraParameters": { - "description": "Defines extra parameters required for specific asset types.", - "items": { - "$ref": "ExtraParameter" - }, - "type": "array" - }, - "locationData": { - "description": "Contains all kinds of physical location definitions for this asset.", - "items": { - "$ref": "LocationData" - }, - "type": "array" - }, - "parentAsset": { - "description": "Defines parents assets if any in order to allow later generation of child_asset_location data via child assets.", - "items": { - "$ref": "CloudAsset" - }, - "type": "array" - } - }, - "type": "object" - }, "AvailabilityConfiguration": { "description": "Configuration for availability of database instance", "id": "AvailabilityConfiguration", @@ -1004,19 +968,6 @@ }, "type": "object" }, - "BlobstoreLocation": { - "description": "Policy ID that identified data placement in Blobstore as per go/blobstore-user-guide#data-metadata-placement-and-failure-domains", - "id": "BlobstoreLocation", - "properties": { - "policyId": { - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "CertChain": { "id": "CertChain", "properties": { @@ -1044,30 +995,6 @@ }, "type": "object" }, - "CloudAsset": { - "id": "CloudAsset", - "properties": { - "assetName": { - "type": "string" - }, - "assetType": { - "type": "string" - } - }, - "type": "object" - }, - "CloudAssetComposition": { - "id": "CloudAssetComposition", - "properties": { - "childAsset": { - "items": { - "$ref": "CloudAsset" - }, - "type": "array" - } - }, - "type": "object" - }, "Cluster": { "description": "A cluster instance.", "id": "Cluster", @@ -1086,6 +1013,13 @@ ], "type": "string" }, + "clusterEndpoints": { + "description": "Optional. A list of cluster enpoints.", + "items": { + "$ref": "ClusterEndpoint" + }, + "type": "array" + }, "createTime": { "description": "Output only. The timestamp associated with the cluster creation request.", "format": "google-datetime", @@ -1150,7 +1084,7 @@ "type": "number" }, "pscConfigs": { - "description": "Required. Each PscConfig configures the consumer network where IPs will be designated to the cluster for client access through Private Service Connect Automation. Currently, only one PscConfig is supported.", + "description": "Optional. Each PscConfig configures the consumer network where IPs will be designated to the cluster for client access through Private Service Connect Automation. Currently, only one PscConfig is supported.", "items": { "$ref": "PscConfig" }, @@ -1164,6 +1098,14 @@ "readOnly": true, "type": "array" }, + "pscServiceAttachments": { + "description": "Output only. Service attachment details to configure Psc connections", + "items": { + "$ref": "PscServiceAttachment" + }, + "readOnly": true, + "type": "array" + }, "redisConfigs": { "additionalProperties": { "type": "string" @@ -1237,6 +1179,20 @@ }, "type": "object" }, + "ClusterEndpoint": { + "description": "ClusterEndpoint consists of PSC connections that are created as a group in each VPC network for accessing the cluster. In each group, there shall be one connection for each service attachment in the cluster.", + "id": "ClusterEndpoint", + "properties": { + "connections": { + "description": "A group of PSC connections. They are created in the same VPC network, one for each service attachment in the cluster.", + "items": { + "$ref": "ConnectionDetail" + }, + "type": "array" + } + }, + "type": "object" + }, "ClusterMaintenancePolicy": { "description": "Maintenance policy per cluster.", "id": "ClusterMaintenancePolicy", @@ -1363,6 +1319,17 @@ }, "type": "object" }, + "ConnectionDetail": { + "description": "Detailed information of each PSC connection.", + "id": "ConnectionDetail", + "properties": { + "pscConnection": { + "$ref": "PscConnection", + "description": "Detailed information of a PSC connection that is created by the customer who owns the cluster." + } + }, + "type": "object" + }, "CrossClusterReplicationConfig": { "description": "Cross cluster replication config.", "id": "CrossClusterReplicationConfig", @@ -2360,18 +2327,6 @@ }, "type": "object" }, - "DirectLocationAssignment": { - "id": "DirectLocationAssignment", - "properties": { - "location": { - "items": { - "$ref": "LocationAssignment" - }, - "type": "array" - } - }, - "type": "object" - }, "DiscoveryEndpoint": { "description": "Endpoints on each network, for Redis clients to connect to the cluster.", "id": "DiscoveryEndpoint", @@ -2445,17 +2400,6 @@ }, "type": "object" }, - "ExtraParameter": { - "description": "Defines parameters that should only be used for specific asset types.", - "id": "ExtraParameter", - "properties": { - "regionalMigDistributionPolicy": { - "$ref": "RegionalMigDistributionPolicy", - "description": "Details about zones used by regional compute.googleapis.com/InstanceGroupManager to create instances." - } - }, - "type": "object" - }, "FailoverInstanceRequest": { "description": "Request for Failover.", "id": "FailoverInstanceRequest", @@ -2884,131 +2828,6 @@ }, "type": "object" }, - "IsolationExpectations": { - "id": "IsolationExpectations", - "properties": { - "requirementOverride": { - "$ref": "RequirementOverride", - "description": "Explicit overrides for ZI and ZS requirements to be used for resources that should be excluded from ZI/ZS verification logic." - }, - "ziOrgPolicy": { - "enum": [ - "ZI_UNSPECIFIED", - "ZI_UNKNOWN", - "ZI_NOT_REQUIRED", - "ZI_PREFERRED", - "ZI_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "", - "" - ], - "type": "string" - }, - "ziRegionPolicy": { - "enum": [ - "ZI_REGION_POLICY_UNSPECIFIED", - "ZI_REGION_POLICY_UNKNOWN", - "ZI_REGION_POLICY_NOT_SET", - "ZI_REGION_POLICY_FAIL_OPEN", - "ZI_REGION_POLICY_FAIL_CLOSED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "", - "" - ], - "type": "string" - }, - "ziRegionState": { - "enum": [ - "ZI_REGION_UNSPECIFIED", - "ZI_REGION_UNKNOWN", - "ZI_REGION_NOT_ENABLED", - "ZI_REGION_ENABLED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "" - ], - "type": "string" - }, - "zoneIsolation": { - "deprecated": true, - "description": "Deprecated: use zi_org_policy, zi_region_policy and zi_region_state instead for setting ZI expectations as per go/zicy-publish-physical-location.", - "enum": [ - "ZI_UNSPECIFIED", - "ZI_UNKNOWN", - "ZI_NOT_REQUIRED", - "ZI_PREFERRED", - "ZI_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "", - "" - ], - "type": "string" - }, - "zoneSeparation": { - "deprecated": true, - "description": "Deprecated: use zs_org_policy, and zs_region_stateinstead for setting Zs expectations as per go/zicy-publish-physical-location.", - "enum": [ - "ZS_UNSPECIFIED", - "ZS_UNKNOWN", - "ZS_NOT_REQUIRED", - "ZS_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "" - ], - "type": "string" - }, - "zsOrgPolicy": { - "enum": [ - "ZS_UNSPECIFIED", - "ZS_UNKNOWN", - "ZS_NOT_REQUIRED", - "ZS_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "" - ], - "type": "string" - }, - "zsRegionState": { - "enum": [ - "ZS_REGION_UNSPECIFIED", - "ZS_REGION_UNKNOWN", - "ZS_REGION_NOT_ENABLED", - "ZS_REGION_ENABLED" - ], - "enumDescriptions": [ - "", - "To be used if tracking of the asset ZS-bit is not available", - "", - "" - ], - "type": "string" - } - }, - "type": "object" - }, "ListClustersResponse": { "description": "Response for ListClusters.", "id": "ListClustersResponse", @@ -3129,64 +2948,6 @@ }, "type": "object" }, - "LocationAssignment": { - "id": "LocationAssignment", - "properties": { - "location": { - "type": "string" - }, - "locationType": { - "enum": [ - "UNSPECIFIED", - "CLUSTER", - "POP", - "CLOUD_ZONE", - "CLOUD_REGION", - "MULTI_REGION_GEO", - "MULTI_REGION_JURISDICTION", - "GLOBAL", - "OTHER" - ], - "enumDescriptions": [ - "", - "1-10: Physical failure domains.", - "", - "11-20: Logical failure domains.", - "", - "", - "", - "", - "" - ], - "type": "string" - } - }, - "type": "object" - }, - "LocationData": { - "id": "LocationData", - "properties": { - "blobstoreLocation": { - "$ref": "BlobstoreLocation" - }, - "childAssetLocation": { - "$ref": "CloudAssetComposition" - }, - "directLocation": { - "$ref": "DirectLocationAssignment" - }, - "gcpProjectProxy": { - "$ref": "TenantProjectProxy" - }, - "placerLocation": { - "$ref": "PlacerLocation" - }, - "spannerLocation": { - "$ref": "SpannerLocation" - } - }, - "type": "object" - }, "MachineConfiguration": { "description": "MachineConfiguration describes the configuration of a machine specific to Database Resource.", "id": "MachineConfiguration", @@ -3552,17 +3313,6 @@ }, "type": "object" }, - "PlacerLocation": { - "description": "Message describing that the location of the customer resource is tied to placer allocations", - "id": "PlacerLocation", - "properties": { - "placerConfig": { - "description": "Directory with a config related to it in placer (e.g. \"/placer/prod/home/my-root/my-dir\")", - "type": "string" - } - }, - "type": "object" - }, "Product": { "description": "Product specification for Condor resources.", "id": "Product", @@ -3696,6 +3446,23 @@ "description": "Required. The IP allocated on the consumer network for the PSC forwarding rule.", "type": "string" }, + "connectionType": { + "description": "Output only. Type of the PSC connection.", + "enum": [ + "CONNECTION_TYPE_UNSPECIFIED", + "CONNECTION_TYPE_DISCOVERY", + "CONNECTION_TYPE_PRIMARY", + "CONNECTION_TYPE_READER" + ], + "enumDescriptions": [ + "Cluster endpoint Type is not set", + "Cluster endpoint that will be used as for cluster topology discovery.", + "Cluster endpoint that will be used as primary endpoint to access primary.", + "Cluster endpoint that will be used as reader endpoint to access replicas." + ], + "readOnly": true, + "type": "string" + }, "forwardingRule": { "description": "Required. The URI of the consumer side forwarding rule. Example: projects/{projectNumOrId}/regions/us-east1/forwardingRules/{resourceId}.", "type": "string" @@ -3712,6 +3479,21 @@ "description": "Required. The PSC connection id of the forwarding rule connected to the service attachment.", "type": "string" }, + "pscConnectionStatus": { + "description": "Output only. The status of the PSC connection. Please note that this value is updated periodically. To get the latest status of a PSC connection, follow https://cloud.google.com/vpc/docs/configure-private-service-connect-services#endpoint-details.", + "enum": [ + "PSC_CONNECTION_STATUS_UNSPECIFIED", + "PSC_CONNECTION_STATUS_ACTIVE", + "PSC_CONNECTION_STATUS_NOT_FOUND" + ], + "enumDescriptions": [ + "PSC connection status is not specified.", + "The connection is active", + "Connection not found" + ], + "readOnly": true, + "type": "string" + }, "serviceAttachment": { "description": "Required. The service attachment which is the target of the PSC connection, in the form of projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment-id}.", "type": "string" @@ -3719,6 +3501,35 @@ }, "type": "object" }, + "PscServiceAttachment": { + "description": "Configuration of a service attachment of the cluster, for creating PSC connections.", + "id": "PscServiceAttachment", + "properties": { + "connectionType": { + "description": "Output only. Type of a PSC connection targeting this service attachment.", + "enum": [ + "CONNECTION_TYPE_UNSPECIFIED", + "CONNECTION_TYPE_DISCOVERY", + "CONNECTION_TYPE_PRIMARY", + "CONNECTION_TYPE_READER" + ], + "enumDescriptions": [ + "Cluster endpoint Type is not set", + "Cluster endpoint that will be used as for cluster topology discovery.", + "Cluster endpoint that will be used as primary endpoint to access primary.", + "Cluster endpoint that will be used as reader endpoint to access replicas." + ], + "readOnly": true, + "type": "string" + }, + "serviceAttachment": { + "description": "Output only. Service attachment URI which your self-created PscConnection should use as target", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "RDBConfig": { "description": "Configuration of the RDB based persistence.", "id": "RDBConfig", @@ -3780,25 +3591,6 @@ }, "type": "object" }, - "RegionalMigDistributionPolicy": { - "description": "To be used for specifying the intended distribution of regional compute.googleapis.com/InstanceGroupManager instances", - "id": "RegionalMigDistributionPolicy", - "properties": { - "targetShape": { - "description": "The shape in which the group converges around distribution of resources. Instance of proto2 enum", - "format": "int32", - "type": "integer" - }, - "zones": { - "description": "Cloud zones used by regional MIG to create instances.", - "items": { - "$ref": "ZoneConfiguration" - }, - "type": "array" - } - }, - "type": "object" - }, "RemoteCluster": { "description": "Details of the remote cluster associated with this cluster in a cross cluster replication setup.", "id": "RemoteCluster", @@ -3815,44 +3607,6 @@ }, "type": "object" }, - "RequirementOverride": { - "id": "RequirementOverride", - "properties": { - "ziOverride": { - "enum": [ - "ZI_UNSPECIFIED", - "ZI_UNKNOWN", - "ZI_NOT_REQUIRED", - "ZI_PREFERRED", - "ZI_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "", - "" - ], - "type": "string" - }, - "zsOverride": { - "enum": [ - "ZS_UNSPECIFIED", - "ZS_UNKNOWN", - "ZS_NOT_REQUIRED", - "ZS_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "" - ], - "type": "string" - } - }, - "type": "object" - }, "RescheduleClusterMaintenanceRequest": { "description": "Request for rescheduling a cluster maintenance.", "id": "RescheduleClusterMaintenanceRequest", @@ -3950,26 +3704,6 @@ }, "type": "object" }, - "SpannerLocation": { - "id": "SpannerLocation", - "properties": { - "backupName": { - "description": "Set of backups used by the resource with name in the same format as what is available at http://table/spanner_automon.backup_metadata", - "items": { - "type": "string" - }, - "type": "array" - }, - "dbName": { - "description": "Set of databases used by the resource in format /span//", - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "StateInfo": { "description": "Represents additional information about the state of the cluster.", "id": "StateInfo", @@ -4022,18 +3756,6 @@ }, "type": "object" }, - "TenantProjectProxy": { - "id": "TenantProjectProxy", - "properties": { - "projectNumbers": { - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "TimeOfDay": { "description": "Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`.", "id": "TimeOfDay", @@ -4199,15 +3921,6 @@ }, "type": "object" }, - "ZoneConfiguration": { - "id": "ZoneConfiguration", - "properties": { - "zone": { - "type": "string" - } - }, - "type": "object" - }, "ZoneDistributionConfig": { "description": "Zone distribution config for allocation of cluster resources.", "id": "ZoneDistributionConfig", diff --git a/redis/v1beta1/redis-gen.go b/redis/v1beta1/redis-gen.go index 2ec70150cac..6338f7276ce 100644 --- a/redis/v1beta1/redis-gen.go +++ b/redis/v1beta1/redis-gen.go @@ -244,41 +244,6 @@ func (s AOFConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// AssetLocation: Provides the mapping of a cloud asset to a direct physical -// location or to a proxy that defines the location on its behalf. -type AssetLocation struct { - // CcfeRmsPath: Spanner path of the CCFE RMS database. It is only applicable - // for CCFE tenants that use CCFE RMS for storing resource metadata. - CcfeRmsPath string `json:"ccfeRmsPath,omitempty"` - // Expected: Defines the customer expectation around ZI/ZS for this asset and - // ZI/ZS state of the region at the time of asset creation. - Expected *IsolationExpectations `json:"expected,omitempty"` - // ExtraParameters: Defines extra parameters required for specific asset types. - ExtraParameters []*ExtraParameter `json:"extraParameters,omitempty"` - // LocationData: Contains all kinds of physical location definitions for this - // asset. - LocationData []*LocationData `json:"locationData,omitempty"` - // ParentAsset: Defines parents assets if any in order to allow later - // generation of child_asset_location data via child assets. - ParentAsset []*CloudAsset `json:"parentAsset,omitempty"` - // ForceSendFields is a list of field names (e.g. "CcfeRmsPath") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "CcfeRmsPath") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s AssetLocation) MarshalJSON() ([]byte, error) { - type NoMethod AssetLocation - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // AvailabilityConfiguration: Configuration for availability of database // instance type AvailabilityConfiguration struct { @@ -386,28 +351,6 @@ func (s BackupRun) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// BlobstoreLocation: Policy ID that identified data placement in Blobstore as -// per go/blobstore-user-guide#data-metadata-placement-and-failure-domains -type BlobstoreLocation struct { - PolicyId []string `json:"policyId,omitempty"` - // ForceSendFields is a list of field names (e.g. "PolicyId") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "PolicyId") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s BlobstoreLocation) MarshalJSON() ([]byte, error) { - type NoMethod BlobstoreLocation - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - type CertChain struct { // Certificates: The certificates that form the CA chain, from leaf to root // order. @@ -459,47 +402,6 @@ func (s CertificateAuthority) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type CloudAsset struct { - AssetName string `json:"assetName,omitempty"` - AssetType string `json:"assetType,omitempty"` - // ForceSendFields is a list of field names (e.g. "AssetName") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "AssetName") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s CloudAsset) MarshalJSON() ([]byte, error) { - type NoMethod CloudAsset - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -type CloudAssetComposition struct { - ChildAsset []*CloudAsset `json:"childAsset,omitempty"` - // ForceSendFields is a list of field names (e.g. "ChildAsset") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ChildAsset") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s CloudAssetComposition) MarshalJSON() ([]byte, error) { - type NoMethod CloudAssetComposition - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // Cluster: A cluster instance. type Cluster struct { // AuthorizationMode: Optional. The authorization mode of the Redis cluster. If @@ -510,6 +412,8 @@ type Cluster struct { // "AUTH_MODE_IAM_AUTH" - IAM basic authorization mode // "AUTH_MODE_DISABLED" - Authorization disabled mode AuthorizationMode string `json:"authorizationMode,omitempty"` + // ClusterEndpoints: Optional. A list of cluster enpoints. + ClusterEndpoints []*ClusterEndpoint `json:"clusterEndpoints,omitempty"` // CreateTime: Output only. The timestamp associated with the cluster creation // request. CreateTime string `json:"createTime,omitempty"` @@ -547,13 +451,16 @@ type Cluster struct { // PreciseSizeGb: Output only. Precise value of redis memory size in GB for the // entire cluster. PreciseSizeGb float64 `json:"preciseSizeGb,omitempty"` - // PscConfigs: Required. Each PscConfig configures the consumer network where + // PscConfigs: Optional. Each PscConfig configures the consumer network where // IPs will be designated to the cluster for client access through Private // Service Connect Automation. Currently, only one PscConfig is supported. PscConfigs []*PscConfig `json:"pscConfigs,omitempty"` // PscConnections: Output only. The list of PSC connections that are // auto-created through service connectivity automation. PscConnections []*PscConnection `json:"pscConnections,omitempty"` + // PscServiceAttachments: Output only. Service attachment details to configure + // Psc connections + PscServiceAttachments []*PscServiceAttachment `json:"pscServiceAttachments,omitempty"` // RedisConfigs: Optional. Key/Value pairs of customer overrides for mutable // Redis Configs RedisConfigs map[string]string `json:"redisConfigs,omitempty"` @@ -626,6 +533,32 @@ func (s *Cluster) UnmarshalJSON(data []byte) error { return nil } +// ClusterEndpoint: ClusterEndpoint consists of PSC connections that are +// created as a group in each VPC network for accessing the cluster. In each +// group, there shall be one connection for each service attachment in the +// cluster. +type ClusterEndpoint struct { + // Connections: A group of PSC connections. They are created in the same VPC + // network, one for each service attachment in the cluster. + Connections []*ConnectionDetail `json:"connections,omitempty"` + // ForceSendFields is a list of field names (e.g. "Connections") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Connections") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ClusterEndpoint) MarshalJSON() ([]byte, error) { + type NoMethod ClusterEndpoint + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ClusterMaintenancePolicy: Maintenance policy per cluster. type ClusterMaintenancePolicy struct { // CreateTime: Output only. The time when the policy was created i.e. @@ -776,6 +709,29 @@ func (s Compliance) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ConnectionDetail: Detailed information of each PSC connection. +type ConnectionDetail struct { + // PscConnection: Detailed information of a PSC connection that is created by + // the customer who owns the cluster. + PscConnection *PscConnection `json:"pscConnection,omitempty"` + // ForceSendFields is a list of field names (e.g. "PscConnection") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "PscConnection") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ConnectionDetail) MarshalJSON() ([]byte, error) { + type NoMethod ConnectionDetail + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // CrossClusterReplicationConfig: Cross cluster replication config. type CrossClusterReplicationConfig struct { // ClusterRole: The role of the cluster in cross cluster replication. @@ -1613,26 +1569,6 @@ func (s DatabaseResourceRecommendationSignalData) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type DirectLocationAssignment struct { - Location []*LocationAssignment `json:"location,omitempty"` - // ForceSendFields is a list of field names (e.g. "Location") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Location") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s DirectLocationAssignment) MarshalJSON() ([]byte, error) { - type NoMethod DirectLocationAssignment - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // DiscoveryEndpoint: Endpoints on each network, for Redis clients to connect // to the cluster. type DiscoveryEndpoint struct { @@ -1731,30 +1667,6 @@ func (s ExportInstanceRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// ExtraParameter: Defines parameters that should only be used for specific -// asset types. -type ExtraParameter struct { - // RegionalMigDistributionPolicy: Details about zones used by regional - // compute.googleapis.com/InstanceGroupManager to create instances. - RegionalMigDistributionPolicy *RegionalMigDistributionPolicy `json:"regionalMigDistributionPolicy,omitempty"` - // ForceSendFields is a list of field names (e.g. - // "RegionalMigDistributionPolicy") to unconditionally include in API requests. - // By default, fields with empty or default values are omitted from API - // requests. See https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields - // for more details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "RegionalMigDistributionPolicy") - // to include in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s ExtraParameter) MarshalJSON() ([]byte, error) { - type NoMethod ExtraParameter - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // FailoverInstanceRequest: Request for Failover. type FailoverInstanceRequest struct { // DataProtectionMode: Optional. Available data protection modes that the user @@ -2218,81 +2130,6 @@ func (s InternalResourceMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type IsolationExpectations struct { - // RequirementOverride: Explicit overrides for ZI and ZS requirements to be - // used for resources that should be excluded from ZI/ZS verification logic. - RequirementOverride *RequirementOverride `json:"requirementOverride,omitempty"` - // Possible values: - // "ZI_UNSPECIFIED" - // "ZI_UNKNOWN" - To be used if tracking is not available - // "ZI_NOT_REQUIRED" - // "ZI_PREFERRED" - // "ZI_REQUIRED" - ZiOrgPolicy string `json:"ziOrgPolicy,omitempty"` - // Possible values: - // "ZI_REGION_POLICY_UNSPECIFIED" - // "ZI_REGION_POLICY_UNKNOWN" - To be used if tracking is not available - // "ZI_REGION_POLICY_NOT_SET" - // "ZI_REGION_POLICY_FAIL_OPEN" - // "ZI_REGION_POLICY_FAIL_CLOSED" - ZiRegionPolicy string `json:"ziRegionPolicy,omitempty"` - // Possible values: - // "ZI_REGION_UNSPECIFIED" - // "ZI_REGION_UNKNOWN" - To be used if tracking is not available - // "ZI_REGION_NOT_ENABLED" - // "ZI_REGION_ENABLED" - ZiRegionState string `json:"ziRegionState,omitempty"` - // ZoneIsolation: Deprecated: use zi_org_policy, zi_region_policy and - // zi_region_state instead for setting ZI expectations as per - // go/zicy-publish-physical-location. - // - // Possible values: - // "ZI_UNSPECIFIED" - // "ZI_UNKNOWN" - To be used if tracking is not available - // "ZI_NOT_REQUIRED" - // "ZI_PREFERRED" - // "ZI_REQUIRED" - ZoneIsolation string `json:"zoneIsolation,omitempty"` - // ZoneSeparation: Deprecated: use zs_org_policy, and zs_region_stateinstead - // for setting Zs expectations as per go/zicy-publish-physical-location. - // - // Possible values: - // "ZS_UNSPECIFIED" - // "ZS_UNKNOWN" - To be used if tracking is not available - // "ZS_NOT_REQUIRED" - // "ZS_REQUIRED" - ZoneSeparation string `json:"zoneSeparation,omitempty"` - // Possible values: - // "ZS_UNSPECIFIED" - // "ZS_UNKNOWN" - To be used if tracking is not available - // "ZS_NOT_REQUIRED" - // "ZS_REQUIRED" - ZsOrgPolicy string `json:"zsOrgPolicy,omitempty"` - // Possible values: - // "ZS_REGION_UNSPECIFIED" - // "ZS_REGION_UNKNOWN" - To be used if tracking of the asset ZS-bit is not - // available - // "ZS_REGION_NOT_ENABLED" - // "ZS_REGION_ENABLED" - ZsRegionState string `json:"zsRegionState,omitempty"` - // ForceSendFields is a list of field names (e.g. "RequirementOverride") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "RequirementOverride") to include - // in API requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s IsolationExpectations) MarshalJSON() ([]byte, error) { - type NoMethod IsolationExpectations - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // ListClustersResponse: Response for ListClusters. type ListClustersResponse struct { // Clusters: A list of Redis clusters in the project in the specified location, @@ -2464,62 +2301,6 @@ func (s Location) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type LocationAssignment struct { - Location string `json:"location,omitempty"` - // Possible values: - // "UNSPECIFIED" - // "CLUSTER" - 1-10: Physical failure domains. - // "POP" - // "CLOUD_ZONE" - 11-20: Logical failure domains. - // "CLOUD_REGION" - // "MULTI_REGION_GEO" - // "MULTI_REGION_JURISDICTION" - // "GLOBAL" - // "OTHER" - LocationType string `json:"locationType,omitempty"` - // ForceSendFields is a list of field names (e.g. "Location") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Location") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s LocationAssignment) MarshalJSON() ([]byte, error) { - type NoMethod LocationAssignment - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -type LocationData struct { - BlobstoreLocation *BlobstoreLocation `json:"blobstoreLocation,omitempty"` - ChildAssetLocation *CloudAssetComposition `json:"childAssetLocation,omitempty"` - DirectLocation *DirectLocationAssignment `json:"directLocation,omitempty"` - GcpProjectProxy *TenantProjectProxy `json:"gcpProjectProxy,omitempty"` - PlacerLocation *PlacerLocation `json:"placerLocation,omitempty"` - SpannerLocation *SpannerLocation `json:"spannerLocation,omitempty"` - // ForceSendFields is a list of field names (e.g. "BlobstoreLocation") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "BlobstoreLocation") to include in - // API requests with the JSON null value. By default, fields with empty values - // are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s LocationData) MarshalJSON() ([]byte, error) { - type NoMethod LocationData - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // MachineConfiguration: MachineConfiguration describes the configuration of a // machine specific to Database Resource. type MachineConfiguration struct { @@ -2932,30 +2713,6 @@ func (s PersistenceConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// PlacerLocation: Message describing that the location of the customer -// resource is tied to placer allocations -type PlacerLocation struct { - // PlacerConfig: Directory with a config related to it in placer (e.g. - // "/placer/prod/home/my-root/my-dir") - PlacerConfig string `json:"placerConfig,omitempty"` - // ForceSendFields is a list of field names (e.g. "PlacerConfig") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "PlacerConfig") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s PlacerLocation) MarshalJSON() ([]byte, error) { - type NoMethod PlacerLocation - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // Product: Product specification for Condor resources. type Product struct { // Engine: The specific engine that the underlying database is running. @@ -3054,6 +2811,17 @@ type PscConnection struct { // Address: Required. The IP allocated on the consumer network for the PSC // forwarding rule. Address string `json:"address,omitempty"` + // ConnectionType: Output only. Type of the PSC connection. + // + // Possible values: + // "CONNECTION_TYPE_UNSPECIFIED" - Cluster endpoint Type is not set + // "CONNECTION_TYPE_DISCOVERY" - Cluster endpoint that will be used as for + // cluster topology discovery. + // "CONNECTION_TYPE_PRIMARY" - Cluster endpoint that will be used as primary + // endpoint to access primary. + // "CONNECTION_TYPE_READER" - Cluster endpoint that will be used as reader + // endpoint to access replicas. + ConnectionType string `json:"connectionType,omitempty"` // ForwardingRule: Required. The URI of the consumer side forwarding rule. // Example: // projects/{projectNumOrId}/regions/us-east1/forwardingRules/{resourceId}. @@ -3067,6 +2835,17 @@ type PscConnection struct { // PscConnectionId: Required. The PSC connection id of the forwarding rule // connected to the service attachment. PscConnectionId string `json:"pscConnectionId,omitempty"` + // PscConnectionStatus: Output only. The status of the PSC connection. Please + // note that this value is updated periodically. To get the latest status of a + // PSC connection, follow + // https://cloud.google.com/vpc/docs/configure-private-service-connect-services#endpoint-details. + // + // Possible values: + // "PSC_CONNECTION_STATUS_UNSPECIFIED" - PSC connection status is not + // specified. + // "PSC_CONNECTION_STATUS_ACTIVE" - The connection is active + // "PSC_CONNECTION_STATUS_NOT_FOUND" - Connection not found + PscConnectionStatus string `json:"pscConnectionStatus,omitempty"` // ServiceAttachment: Required. The service attachment which is the target of // the PSC connection, in the form of // projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment @@ -3090,6 +2869,42 @@ func (s PscConnection) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// PscServiceAttachment: Configuration of a service attachment of the cluster, +// for creating PSC connections. +type PscServiceAttachment struct { + // ConnectionType: Output only. Type of a PSC connection targeting this service + // attachment. + // + // Possible values: + // "CONNECTION_TYPE_UNSPECIFIED" - Cluster endpoint Type is not set + // "CONNECTION_TYPE_DISCOVERY" - Cluster endpoint that will be used as for + // cluster topology discovery. + // "CONNECTION_TYPE_PRIMARY" - Cluster endpoint that will be used as primary + // endpoint to access primary. + // "CONNECTION_TYPE_READER" - Cluster endpoint that will be used as reader + // endpoint to access replicas. + ConnectionType string `json:"connectionType,omitempty"` + // ServiceAttachment: Output only. Service attachment URI which your + // self-created PscConnection should use as target + ServiceAttachment string `json:"serviceAttachment,omitempty"` + // ForceSendFields is a list of field names (e.g. "ConnectionType") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ConnectionType") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s PscServiceAttachment) MarshalJSON() ([]byte, error) { + type NoMethod PscServiceAttachment + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // RDBConfig: Configuration of the RDB based persistence. type RDBConfig struct { // RdbSnapshotPeriod: Optional. Period between RDB snapshots. @@ -3158,33 +2973,6 @@ func (s ReconciliationOperationMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// RegionalMigDistributionPolicy: To be used for specifying the intended -// distribution of regional compute.googleapis.com/InstanceGroupManager -// instances -type RegionalMigDistributionPolicy struct { - // TargetShape: The shape in which the group converges around distribution of - // resources. Instance of proto2 enum - TargetShape int64 `json:"targetShape,omitempty"` - // Zones: Cloud zones used by regional MIG to create instances. - Zones []*ZoneConfiguration `json:"zones,omitempty"` - // ForceSendFields is a list of field names (e.g. "TargetShape") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "TargetShape") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s RegionalMigDistributionPolicy) MarshalJSON() ([]byte, error) { - type NoMethod RegionalMigDistributionPolicy - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // RemoteCluster: Details of the remote cluster associated with this cluster in // a cross cluster replication setup. type RemoteCluster struct { @@ -3211,38 +2999,6 @@ func (s RemoteCluster) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type RequirementOverride struct { - // Possible values: - // "ZI_UNSPECIFIED" - // "ZI_UNKNOWN" - To be used if tracking is not available - // "ZI_NOT_REQUIRED" - // "ZI_PREFERRED" - // "ZI_REQUIRED" - ZiOverride string `json:"ziOverride,omitempty"` - // Possible values: - // "ZS_UNSPECIFIED" - // "ZS_UNKNOWN" - To be used if tracking is not available - // "ZS_NOT_REQUIRED" - // "ZS_REQUIRED" - ZsOverride string `json:"zsOverride,omitempty"` - // ForceSendFields is a list of field names (e.g. "ZiOverride") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ZiOverride") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s RequirementOverride) MarshalJSON() ([]byte, error) { - type NoMethod RequirementOverride - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // RescheduleClusterMaintenanceRequest: Request for rescheduling a cluster // maintenance. type RescheduleClusterMaintenanceRequest struct { @@ -3352,30 +3108,6 @@ func (s RetentionSettings) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type SpannerLocation struct { - // BackupName: Set of backups used by the resource with name in the same format - // as what is available at http://table/spanner_automon.backup_metadata - BackupName []string `json:"backupName,omitempty"` - // DbName: Set of databases used by the resource in format /span// - DbName []string `json:"dbName,omitempty"` - // ForceSendFields is a list of field names (e.g. "BackupName") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "BackupName") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s SpannerLocation) MarshalJSON() ([]byte, error) { - type NoMethod SpannerLocation - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // StateInfo: Represents additional information about the state of the cluster. type StateInfo struct { // UpdateInfo: Describes ongoing update on the cluster when cluster state is @@ -3457,26 +3189,6 @@ func (s Tags) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type TenantProjectProxy struct { - ProjectNumbers []string `json:"projectNumbers,omitempty"` - // ForceSendFields is a list of field names (e.g. "ProjectNumbers") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ProjectNumbers") to include in - // API requests with the JSON null value. By default, fields with empty values - // are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s TenantProjectProxy) MarshalJSON() ([]byte, error) { - type NoMethod TenantProjectProxy - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // TimeOfDay: Represents a time of day. The date and time zone are either not // significant or are specified elsewhere. An API may choose to allow leap // seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. @@ -3698,26 +3410,6 @@ func (s WeeklyMaintenanceWindow) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type ZoneConfiguration struct { - Zone string `json:"zone,omitempty"` - // ForceSendFields is a list of field names (e.g. "Zone") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Zone") to include in API requests - // with the JSON null value. By default, fields with empty values are omitted - // from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s ZoneConfiguration) MarshalJSON() ([]byte, error) { - type NoMethod ZoneConfiguration - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // ZoneDistributionConfig: Zone distribution config for allocation of cluster // resources. type ZoneDistributionConfig struct { diff --git a/retail/v2/retail-api.json b/retail/v2/retail-api.json index c1b0ae6138c..fe45a308046 100644 --- a/retail/v2/retail-api.json +++ b/retail/v2/retail-api.json @@ -2246,7 +2246,7 @@ } } }, - "revision": "20241017", + "revision": "20241024", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -4041,6 +4041,41 @@ "properties": {}, "type": "object" }, + "GoogleCloudRetailV2PinControlMetadata": { + "description": "Metadata for pinning to be returned in the response. This is used for distinguishing between applied vs dropped pins.", + "id": "GoogleCloudRetailV2PinControlMetadata", + "properties": { + "allMatchedPins": { + "additionalProperties": { + "$ref": "GoogleCloudRetailV2PinControlMetadataProductPins" + }, + "description": "Map of all matched pins, keyed by pin position.", + "type": "object" + }, + "droppedPins": { + "additionalProperties": { + "$ref": "GoogleCloudRetailV2PinControlMetadataProductPins" + }, + "description": "Map of pins that were dropped due to overlap with other matching pins, keyed by pin position.", + "type": "object" + } + }, + "type": "object" + }, + "GoogleCloudRetailV2PinControlMetadataProductPins": { + "description": "List of product ids which have associated pins.", + "id": "GoogleCloudRetailV2PinControlMetadataProductPins", + "properties": { + "productId": { + "description": "List of product ids which have associated pins.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudRetailV2PredictRequest": { "description": "Request message for Predict method.", "id": "GoogleCloudRetailV2PredictRequest", @@ -5504,6 +5539,10 @@ "description": "A token that can be sent as SearchRequest.page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, + "pinControlMetadata": { + "$ref": "GoogleCloudRetailV2PinControlMetadata", + "description": "Metadata for pin controls which were applicable to the request. This contains two map fields, one for all matched pins and one for pins which were matched but not applied. The two maps are keyed by pin position, and the values are the product ids which were matched to that pin." + }, "queryExpansionInfo": { "$ref": "GoogleCloudRetailV2SearchResponseQueryExpansionInfo", "description": "Query expansion information for the returned results." diff --git a/retail/v2/retail-gen.go b/retail/v2/retail-gen.go index 8d42e4b9544..ec799eee214 100644 --- a/retail/v2/retail-gen.go +++ b/retail/v2/retail-gen.go @@ -3111,6 +3111,56 @@ func (s GoogleCloudRetailV2OutputResult) MarshalJSON() ([]byte, error) { type GoogleCloudRetailV2PauseModelRequest struct { } +// GoogleCloudRetailV2PinControlMetadata: Metadata for pinning to be returned +// in the response. This is used for distinguishing between applied vs dropped +// pins. +type GoogleCloudRetailV2PinControlMetadata struct { + // AllMatchedPins: Map of all matched pins, keyed by pin position. + AllMatchedPins map[string]GoogleCloudRetailV2PinControlMetadataProductPins `json:"allMatchedPins,omitempty"` + // DroppedPins: Map of pins that were dropped due to overlap with other + // matching pins, keyed by pin position. + DroppedPins map[string]GoogleCloudRetailV2PinControlMetadataProductPins `json:"droppedPins,omitempty"` + // ForceSendFields is a list of field names (e.g. "AllMatchedPins") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AllMatchedPins") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudRetailV2PinControlMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2PinControlMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2PinControlMetadataProductPins: List of product ids which +// have associated pins. +type GoogleCloudRetailV2PinControlMetadataProductPins struct { + // ProductId: List of product ids which have associated pins. + ProductId []string `json:"productId,omitempty"` + // ForceSendFields is a list of field names (e.g. "ProductId") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ProductId") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudRetailV2PinControlMetadataProductPins) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2PinControlMetadataProductPins + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudRetailV2PredictRequest: Request message for Predict method. type GoogleCloudRetailV2PredictRequest struct { // Filter: Filter for restricting prediction results with a length limit of @@ -5530,6 +5580,11 @@ type GoogleCloudRetailV2SearchResponse struct { // retrieve the next page. If this field is omitted, there are no subsequent // pages. NextPageToken string `json:"nextPageToken,omitempty"` + // PinControlMetadata: Metadata for pin controls which were applicable to the + // request. This contains two map fields, one for all matched pins and one for + // pins which were matched but not applied. The two maps are keyed by pin + // position, and the values are the product ids which were matched to that pin. + PinControlMetadata *GoogleCloudRetailV2PinControlMetadata `json:"pinControlMetadata,omitempty"` // QueryExpansionInfo: Query expansion information for the returned results. QueryExpansionInfo *GoogleCloudRetailV2SearchResponseQueryExpansionInfo `json:"queryExpansionInfo,omitempty"` // RedirectUri: The URI of a customer-defined redirect page. If redirect action diff --git a/retail/v2alpha/retail-api.json b/retail/v2alpha/retail-api.json index c982bea8b2f..a62c79bb039 100644 --- a/retail/v2alpha/retail-api.json +++ b/retail/v2alpha/retail-api.json @@ -2767,7 +2767,7 @@ } } }, - "revision": "20241017", + "revision": "20241024", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -5864,6 +5864,41 @@ "properties": {}, "type": "object" }, + "GoogleCloudRetailV2alphaPinControlMetadata": { + "description": "Metadata for pinning to be returned in the response. This is used for distinguishing between applied vs dropped pins.", + "id": "GoogleCloudRetailV2alphaPinControlMetadata", + "properties": { + "allMatchedPins": { + "additionalProperties": { + "$ref": "GoogleCloudRetailV2alphaPinControlMetadataProductPins" + }, + "description": "Map of all matched pins, keyed by pin position.", + "type": "object" + }, + "droppedPins": { + "additionalProperties": { + "$ref": "GoogleCloudRetailV2alphaPinControlMetadataProductPins" + }, + "description": "Map of pins that were dropped due to overlap with other matching pins, keyed by pin position.", + "type": "object" + } + }, + "type": "object" + }, + "GoogleCloudRetailV2alphaPinControlMetadataProductPins": { + "description": "List of product ids which have associated pins.", + "id": "GoogleCloudRetailV2alphaPinControlMetadataProductPins", + "properties": { + "productId": { + "description": "List of product ids which have associated pins.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudRetailV2alphaPredictRequest": { "description": "Request message for Predict method.", "id": "GoogleCloudRetailV2alphaPredictRequest", @@ -7375,6 +7410,10 @@ "description": "A token that can be sent as SearchRequest.page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, + "pinControlMetadata": { + "$ref": "GoogleCloudRetailV2alphaPinControlMetadata", + "description": "Metadata for pin controls which were applicable to the request. This contains two map fields, one for all matched pins and one for pins which were matched but not applied. The two maps are keyed by pin position, and the values are the product ids which were matched to that pin." + }, "queryExpansionInfo": { "$ref": "GoogleCloudRetailV2alphaSearchResponseQueryExpansionInfo", "description": "Query expansion information for the returned results." diff --git a/retail/v2alpha/retail-gen.go b/retail/v2alpha/retail-gen.go index bb56ace93d0..fd617735b86 100644 --- a/retail/v2alpha/retail-gen.go +++ b/retail/v2alpha/retail-gen.go @@ -5107,6 +5107,56 @@ func (s GoogleCloudRetailV2alphaOutputResult) MarshalJSON() ([]byte, error) { type GoogleCloudRetailV2alphaPauseModelRequest struct { } +// GoogleCloudRetailV2alphaPinControlMetadata: Metadata for pinning to be +// returned in the response. This is used for distinguishing between applied vs +// dropped pins. +type GoogleCloudRetailV2alphaPinControlMetadata struct { + // AllMatchedPins: Map of all matched pins, keyed by pin position. + AllMatchedPins map[string]GoogleCloudRetailV2alphaPinControlMetadataProductPins `json:"allMatchedPins,omitempty"` + // DroppedPins: Map of pins that were dropped due to overlap with other + // matching pins, keyed by pin position. + DroppedPins map[string]GoogleCloudRetailV2alphaPinControlMetadataProductPins `json:"droppedPins,omitempty"` + // ForceSendFields is a list of field names (e.g. "AllMatchedPins") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AllMatchedPins") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudRetailV2alphaPinControlMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2alphaPinControlMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2alphaPinControlMetadataProductPins: List of product ids +// which have associated pins. +type GoogleCloudRetailV2alphaPinControlMetadataProductPins struct { + // ProductId: List of product ids which have associated pins. + ProductId []string `json:"productId,omitempty"` + // ForceSendFields is a list of field names (e.g. "ProductId") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ProductId") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudRetailV2alphaPinControlMetadataProductPins) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2alphaPinControlMetadataProductPins + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudRetailV2alphaPredictRequest: Request message for Predict method. type GoogleCloudRetailV2alphaPredictRequest struct { // Filter: Filter for restricting prediction results with a length limit of @@ -7579,6 +7629,11 @@ type GoogleCloudRetailV2alphaSearchResponse struct { // retrieve the next page. If this field is omitted, there are no subsequent // pages. NextPageToken string `json:"nextPageToken,omitempty"` + // PinControlMetadata: Metadata for pin controls which were applicable to the + // request. This contains two map fields, one for all matched pins and one for + // pins which were matched but not applied. The two maps are keyed by pin + // position, and the values are the product ids which were matched to that pin. + PinControlMetadata *GoogleCloudRetailV2alphaPinControlMetadata `json:"pinControlMetadata,omitempty"` // QueryExpansionInfo: Query expansion information for the returned results. QueryExpansionInfo *GoogleCloudRetailV2alphaSearchResponseQueryExpansionInfo `json:"queryExpansionInfo,omitempty"` // RedirectUri: The URI of a customer-defined redirect page. If redirect action diff --git a/retail/v2beta/retail-api.json b/retail/v2beta/retail-api.json index dcac19d00b6..6cb38ff3c50 100644 --- a/retail/v2beta/retail-api.json +++ b/retail/v2beta/retail-api.json @@ -2391,7 +2391,7 @@ } } }, - "revision": "20241017", + "revision": "20241024", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -5842,6 +5842,41 @@ "properties": {}, "type": "object" }, + "GoogleCloudRetailV2betaPinControlMetadata": { + "description": "Metadata for pinning to be returned in the response. This is used for distinguishing between applied vs dropped pins.", + "id": "GoogleCloudRetailV2betaPinControlMetadata", + "properties": { + "allMatchedPins": { + "additionalProperties": { + "$ref": "GoogleCloudRetailV2betaPinControlMetadataProductPins" + }, + "description": "Map of all matched pins, keyed by pin position.", + "type": "object" + }, + "droppedPins": { + "additionalProperties": { + "$ref": "GoogleCloudRetailV2betaPinControlMetadataProductPins" + }, + "description": "Map of pins that were dropped due to overlap with other matching pins, keyed by pin position.", + "type": "object" + } + }, + "type": "object" + }, + "GoogleCloudRetailV2betaPinControlMetadataProductPins": { + "description": "List of product ids which have associated pins.", + "id": "GoogleCloudRetailV2betaPinControlMetadataProductPins", + "properties": { + "productId": { + "description": "List of product ids which have associated pins.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudRetailV2betaPredictRequest": { "description": "Request message for Predict method.", "id": "GoogleCloudRetailV2betaPredictRequest", @@ -7305,6 +7340,10 @@ "description": "A token that can be sent as SearchRequest.page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, + "pinControlMetadata": { + "$ref": "GoogleCloudRetailV2betaPinControlMetadata", + "description": "Metadata for pin controls which were applicable to the request. This contains two map fields, one for all matched pins and one for pins which were matched but not applied. The two maps are keyed by pin position, and the values are the product ids which were matched to that pin." + }, "queryExpansionInfo": { "$ref": "GoogleCloudRetailV2betaSearchResponseQueryExpansionInfo", "description": "Query expansion information for the returned results." diff --git a/retail/v2beta/retail-gen.go b/retail/v2beta/retail-gen.go index 4a905bccbde..eec3befe218 100644 --- a/retail/v2beta/retail-gen.go +++ b/retail/v2beta/retail-gen.go @@ -5515,6 +5515,56 @@ func (s GoogleCloudRetailV2betaOutputResult) MarshalJSON() ([]byte, error) { type GoogleCloudRetailV2betaPauseModelRequest struct { } +// GoogleCloudRetailV2betaPinControlMetadata: Metadata for pinning to be +// returned in the response. This is used for distinguishing between applied vs +// dropped pins. +type GoogleCloudRetailV2betaPinControlMetadata struct { + // AllMatchedPins: Map of all matched pins, keyed by pin position. + AllMatchedPins map[string]GoogleCloudRetailV2betaPinControlMetadataProductPins `json:"allMatchedPins,omitempty"` + // DroppedPins: Map of pins that were dropped due to overlap with other + // matching pins, keyed by pin position. + DroppedPins map[string]GoogleCloudRetailV2betaPinControlMetadataProductPins `json:"droppedPins,omitempty"` + // ForceSendFields is a list of field names (e.g. "AllMatchedPins") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AllMatchedPins") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudRetailV2betaPinControlMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2betaPinControlMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2betaPinControlMetadataProductPins: List of product ids +// which have associated pins. +type GoogleCloudRetailV2betaPinControlMetadataProductPins struct { + // ProductId: List of product ids which have associated pins. + ProductId []string `json:"productId,omitempty"` + // ForceSendFields is a list of field names (e.g. "ProductId") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ProductId") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudRetailV2betaPinControlMetadataProductPins) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2betaPinControlMetadataProductPins + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudRetailV2betaPredictRequest: Request message for Predict method. type GoogleCloudRetailV2betaPredictRequest struct { // Filter: Filter for restricting prediction results with a length limit of @@ -7936,6 +7986,11 @@ type GoogleCloudRetailV2betaSearchResponse struct { // retrieve the next page. If this field is omitted, there are no subsequent // pages. NextPageToken string `json:"nextPageToken,omitempty"` + // PinControlMetadata: Metadata for pin controls which were applicable to the + // request. This contains two map fields, one for all matched pins and one for + // pins which were matched but not applied. The two maps are keyed by pin + // position, and the values are the product ids which were matched to that pin. + PinControlMetadata *GoogleCloudRetailV2betaPinControlMetadata `json:"pinControlMetadata,omitempty"` // QueryExpansionInfo: Query expansion information for the returned results. QueryExpansionInfo *GoogleCloudRetailV2betaSearchResponseQueryExpansionInfo `json:"queryExpansionInfo,omitempty"` // RedirectUri: The URI of a customer-defined redirect page. If redirect action diff --git a/run/v2/run-api.json b/run/v2/run-api.json index 1485ec95451..2213d2281b9 100644 --- a/run/v2/run-api.json +++ b/run/v2/run-api.json @@ -1526,7 +1526,7 @@ } } }, - "revision": "20241011", + "revision": "20241025", "rootUrl": "https://run.googleapis.com/", "schemas": { "GoogleCloudRunV2BinaryAuthorization": { @@ -2267,6 +2267,13 @@ "description": "Cloud Storage Bucket name.", "type": "string" }, + "mountOptions": { + "description": "A list of additional flags to pass to the gcsfuse CLI. Options should be specified without the leading \"--\".", + "items": { + "type": "string" + }, + "type": "array" + }, "readOnly": { "description": "If true, the volume will be mounted as read only for all mounts.", "type": "boolean" diff --git a/run/v2/run-gen.go b/run/v2/run-gen.go index 1eae900b143..e72f37f5665 100644 --- a/run/v2/run-gen.go +++ b/run/v2/run-gen.go @@ -1060,6 +1060,9 @@ func (s GoogleCloudRunV2ExportStatusResponse) MarshalJSON() ([]byte, error) { type GoogleCloudRunV2GCSVolumeSource struct { // Bucket: Cloud Storage Bucket name. Bucket string `json:"bucket,omitempty"` + // MountOptions: A list of additional flags to pass to the gcsfuse CLI. Options + // should be specified without the leading "--". + MountOptions []string `json:"mountOptions,omitempty"` // ReadOnly: If true, the volume will be mounted as read only for all mounts. ReadOnly bool `json:"readOnly,omitempty"` // ForceSendFields is a list of field names (e.g. "Bucket") to unconditionally diff --git a/securitycenter/v1/securitycenter-api.json b/securitycenter/v1/securitycenter-api.json index 0137d412293..fa5c15b940e 100644 --- a/securitycenter/v1/securitycenter-api.json +++ b/securitycenter/v1/securitycenter-api.json @@ -1509,6 +1509,7 @@ ], "parameters": { "compareDuration": { + "deprecated": true, "description": "When compare_duration is set, the ListFindingsResult's \"state_change\" attribute is updated to indicate whether the finding had its state changed, the finding's state remained unchanged, or if the finding was added in any state during the compare_duration period of time that precedes the read_time. This is the time between (read_time - compare_duration) and read_time. The state_change value is derived based on the presence and state of the finding at the two points in time. Intermediate state changes between the two times don't affect the result. For example, the results aren't affected if the finding is made inactive and then active again. Possible \"state_change\" values when compare_duration is specified: * \"CHANGED\": indicates that the finding was present and matched the given filter at the start of compare_duration, but changed its state at read_time. * \"UNCHANGED\": indicates that the finding was present and matched the given filter at the start of compare_duration and did not change state at read_time. * \"ADDED\": indicates that the finding did not match the given filter or was not present at the start of compare_duration, but was present at read_time. * \"REMOVED\": indicates that the finding was present and matched the filter at the start of compare_duration, but did not match the filter at read_time. If compare_duration is not specified, then the only possible state_change is \"UNUSED\", which will be the state_change set for all findings present at read_time.", "format": "google-duration", "location": "query", @@ -1549,6 +1550,7 @@ "type": "string" }, "readTime": { + "deprecated": true, "description": "Time used as a reference point when filtering findings. The filter is limited to findings existing at the supplied time and their values are those at that specific time. Absence of this field will default to the API's version of NOW.", "format": "google-datetime", "location": "query", @@ -3989,6 +3991,7 @@ ], "parameters": { "compareDuration": { + "deprecated": true, "description": "When compare_duration is set, the ListFindingsResult's \"state_change\" attribute is updated to indicate whether the finding had its state changed, the finding's state remained unchanged, or if the finding was added in any state during the compare_duration period of time that precedes the read_time. This is the time between (read_time - compare_duration) and read_time. The state_change value is derived based on the presence and state of the finding at the two points in time. Intermediate state changes between the two times don't affect the result. For example, the results aren't affected if the finding is made inactive and then active again. Possible \"state_change\" values when compare_duration is specified: * \"CHANGED\": indicates that the finding was present and matched the given filter at the start of compare_duration, but changed its state at read_time. * \"UNCHANGED\": indicates that the finding was present and matched the given filter at the start of compare_duration and did not change state at read_time. * \"ADDED\": indicates that the finding did not match the given filter or was not present at the start of compare_duration, but was present at read_time. * \"REMOVED\": indicates that the finding was present and matched the filter at the start of compare_duration, but did not match the filter at read_time. If compare_duration is not specified, then the only possible state_change is \"UNUSED\", which will be the state_change set for all findings present at read_time.", "format": "google-duration", "location": "query", @@ -4029,6 +4032,7 @@ "type": "string" }, "readTime": { + "deprecated": true, "description": "Time used as a reference point when filtering findings. The filter is limited to findings existing at the supplied time and their values are those at that specific time. Absence of this field will default to the API's version of NOW.", "format": "google-datetime", "location": "query", @@ -5656,6 +5660,7 @@ ], "parameters": { "compareDuration": { + "deprecated": true, "description": "When compare_duration is set, the ListFindingsResult's \"state_change\" attribute is updated to indicate whether the finding had its state changed, the finding's state remained unchanged, or if the finding was added in any state during the compare_duration period of time that precedes the read_time. This is the time between (read_time - compare_duration) and read_time. The state_change value is derived based on the presence and state of the finding at the two points in time. Intermediate state changes between the two times don't affect the result. For example, the results aren't affected if the finding is made inactive and then active again. Possible \"state_change\" values when compare_duration is specified: * \"CHANGED\": indicates that the finding was present and matched the given filter at the start of compare_duration, but changed its state at read_time. * \"UNCHANGED\": indicates that the finding was present and matched the given filter at the start of compare_duration and did not change state at read_time. * \"ADDED\": indicates that the finding did not match the given filter or was not present at the start of compare_duration, but was present at read_time. * \"REMOVED\": indicates that the finding was present and matched the filter at the start of compare_duration, but did not match the filter at read_time. If compare_duration is not specified, then the only possible state_change is \"UNUSED\", which will be the state_change set for all findings present at read_time.", "format": "google-duration", "location": "query", @@ -5696,6 +5701,7 @@ "type": "string" }, "readTime": { + "deprecated": true, "description": "Time used as a reference point when filtering findings. The filter is limited to findings existing at the supplied time and their values are those at that specific time. Absence of this field will default to the API's version of NOW.", "format": "google-datetime", "location": "query", @@ -5887,7 +5893,7 @@ } } }, - "revision": "20241018", + "revision": "20241026", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -12034,6 +12040,7 @@ "id": "GroupFindingsRequest", "properties": { "compareDuration": { + "deprecated": true, "description": "When compare_duration is set, the GroupResult's \"state_change\" attribute is updated to indicate whether the finding had its state changed, the finding's state remained unchanged, or if the finding was added during the compare_duration period of time that precedes the read_time. This is the time between (read_time - compare_duration) and read_time. The state_change value is derived based on the presence and state of the finding at the two points in time. Intermediate state changes between the two times don't affect the result. For example, the results aren't affected if the finding is made inactive and then active again. Possible \"state_change\" values when compare_duration is specified: * \"CHANGED\": indicates that the finding was present and matched the given filter at the start of compare_duration, but changed its state at read_time. * \"UNCHANGED\": indicates that the finding was present and matched the given filter at the start of compare_duration and did not change state at read_time. * \"ADDED\": indicates that the finding did not match the given filter or was not present at the start of compare_duration, but was present at read_time. * \"REMOVED\": indicates that the finding was present and matched the filter at the start of compare_duration, but did not match the filter at read_time. If compare_duration is not specified, then the only possible state_change is \"UNUSED\", which will be the state_change set for all findings present at read_time. If this field is set then `state_change` must be a specified field in `group_by`.", "format": "google-duration", "type": "string" @@ -12056,6 +12063,7 @@ "type": "string" }, "readTime": { + "deprecated": true, "description": "Time used as a reference point when filtering findings. The filter is limited to findings existing at the supplied time and their values are those at that specific time. Absence of this field will default to the API's version of NOW.", "format": "google-datetime", "type": "string" @@ -13936,6 +13944,7 @@ "id": "SetFindingStateRequest", "properties": { "startTime": { + "deprecated": true, "description": "Optional. The time at which the updated state takes effect. If unset, defaults to the request time.", "format": "google-datetime", "type": "string" diff --git a/securitycenter/v1beta1/securitycenter-api.json b/securitycenter/v1beta1/securitycenter-api.json index e35e6b8d59d..cfcfac820cf 100644 --- a/securitycenter/v1beta1/securitycenter-api.json +++ b/securitycenter/v1beta1/securitycenter-api.json @@ -913,7 +913,7 @@ } } }, - "revision": "20241018", + "revision": "20241026", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -8233,7 +8233,7 @@ "id": "SetFindingStateRequest", "properties": { "startTime": { - "description": "Required. The time at which the updated state takes effect.", + "description": "Optional. The time at which the updated state takes effect. If not set uses the current time.", "format": "google-datetime", "type": "string" }, diff --git a/securitycenter/v1beta1/securitycenter-gen.go b/securitycenter/v1beta1/securitycenter-gen.go index da211911c70..0af201442b9 100644 --- a/securitycenter/v1beta1/securitycenter-gen.go +++ b/securitycenter/v1beta1/securitycenter-gen.go @@ -8897,7 +8897,8 @@ func (s ServiceAccountDelegationInfo) MarshalJSON() ([]byte, error) { // SetFindingStateRequest: Request message for updating a finding's state. type SetFindingStateRequest struct { - // StartTime: Required. The time at which the updated state takes effect. + // StartTime: Optional. The time at which the updated state takes effect. If + // not set uses the current time. StartTime string `json:"startTime,omitempty"` // State: Required. The desired State of the finding. // diff --git a/spanner/v1/spanner-api.json b/spanner/v1/spanner-api.json index 08f37d504b9..5f29265035b 100644 --- a/spanner/v1/spanner-api.json +++ b/spanner/v1/spanner-api.json @@ -1044,7 +1044,7 @@ "type": "string" }, "encryptionConfig.kmsKeyNames": { - "description": "Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by kms_key_names must fully cover all regions of the backup's instance configuration. Some examples: * For single region instance configs, specify a single regional location KMS key. * For multi-regional instance configs of type GOOGLE_MANAGED, either specify a multi-regional location KMS key or multiple regional location KMS keys that cover all regions in the instance config. * For an instance config of type USER_MANAGED, please specify only regional location KMS keys to cover each region in the instance config. Multi-regional location KMS keys are not supported for USER_MANAGED instance configs.", + "description": "Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by `kms_key_names` must fully cover all regions of the backup's instance configuration. Some examples: * For regional (single-region) instance configurations, specify a regional location KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional location KMS keys that cover all regions in the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each region in the instance configuration. Multi-region location KMS keys aren't supported for `USER_MANAGED` type instance configurations.", "location": "query", "repeated": true, "type": "string" @@ -1122,7 +1122,7 @@ ] }, "getIamPolicy": { - "description": "Gets the access control policy for a database or backup resource. Returns an empty policy if a database or backup exists but does not have a policy set. Authorization requires `spanner.databases.getIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.getIamPolicy` permission on resource.", + "description": "Gets the access control policy for a database or backup resource. Returns an empty policy if a database or backup exists but does not have a policy set. Authorization requires `spanner.databases.getIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.getIamPolicy` permission on resource. For backup schedules, authorization requires `spanner.backupSchedules.getIamPolicy` permission on resource.", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/backups/{backupsId}:getIamPolicy", "httpMethod": "POST", "id": "spanner.projects.instances.backups.getIamPolicy", @@ -1228,7 +1228,7 @@ ] }, "setIamPolicy": { - "description": "Sets the access control policy on a database or backup resource. Replaces any existing policy. Authorization requires `spanner.databases.setIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.setIamPolicy` permission on resource.", + "description": "Sets the access control policy on a database or backup resource. Replaces any existing policy. Authorization requires `spanner.databases.setIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.setIamPolicy` permission on resource. For backup schedules, authorization requires `spanner.backupSchedules.setIamPolicy` permission on resource.", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/backups/{backupsId}:setIamPolicy", "httpMethod": "POST", "id": "spanner.projects.instances.backups.setIamPolicy", @@ -1257,7 +1257,7 @@ ] }, "testIamPermissions": { - "description": "Returns permissions that the caller has on the specified database or backup resource. Attempting this RPC on a non-existent Cloud Spanner database will result in a NOT_FOUND error if the user has `spanner.databases.list` permission on the containing Cloud Spanner instance. Otherwise returns an empty set of permissions. Calling this method on a backup that does not exist will result in a NOT_FOUND error if the user has `spanner.backups.list` permission on the containing instance.", + "description": "Returns permissions that the caller has on the specified database or backup resource. Attempting this RPC on a non-existent Cloud Spanner database will result in a NOT_FOUND error if the user has `spanner.databases.list` permission on the containing Cloud Spanner instance. Otherwise returns an empty set of permissions. Calling this method on a backup that does not exist will result in a NOT_FOUND error if the user has `spanner.backups.list` permission on the containing instance. Calling this method on a backup schedule that does not exist will result in a NOT_FOUND error if the user has `spanner.backupSchedules.list` permission on the containing database.", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/backups/{backupsId}:testIamPermissions", "httpMethod": "POST", "id": "spanner.projects.instances.backups.testIamPermissions", @@ -1425,7 +1425,7 @@ ], "parameters": { "filter": { - "description": "An expression that filters the list of returned operations. A filter expression consists of a field name, a comparison operator, and a value for filtering. The value must be a string, a number, or a boolean. The comparison operator must be one of: `\u003c`, `\u003e`, `\u003c=`, `\u003e=`, `!=`, `=`, or `:`. Colon `:` is the contains operator. Filter rules are not case sensitive. The following fields in the Operation are eligible for filtering: * `name` - The name of the long-running operation * `done` - False if the operation is in progress, else true. * `metadata.@type` - the type of metadata. For example, the type string for RestoreDatabaseMetadata is `type.googleapis.com/google.spanner.admin.database.v1.RestoreDatabaseMetadata`. * `metadata.` - any field in metadata.value. `metadata.@type` must be specified first, if filtering on metadata fields. * `error` - Error associated with the long-running operation. * `response.@type` - the type of response. * `response.` - any field in response.value. You can combine multiple expressions by enclosing each expression in parentheses. By default, expressions are combined with AND logic. However, you can specify AND, OR, and NOT logic explicitly. Here are a few examples: * `done:true` - The operation is complete. * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.RestoreDatabaseMetadata) AND` \\ `(metadata.source_type:BACKUP) AND` \\ `(metadata.backup_info.backup:backup_howl) AND` \\ `(metadata.name:restored_howl) AND` \\ `(metadata.progress.start_time \u003c \\\"2018-03-28T14:50:00Z\\\") AND` \\ `(error:*)` - Return operations where: * The operation's metadata type is RestoreDatabaseMetadata. * The database is restored from a backup. * The backup name contains \"backup_howl\". * The restored database's name contains \"restored_howl\". * The operation started before 2018-03-28T14:50:00Z. * The operation resulted in an error.", + "description": "An expression that filters the list of returned operations. A filter expression consists of a field name, a comparison operator, and a value for filtering. The value must be a string, a number, or a boolean. The comparison operator must be one of: `\u003c`, `\u003e`, `\u003c=`, `\u003e=`, `!=`, `=`, or `:`. Colon `:` is the contains operator. Filter rules are not case sensitive. The following fields in the operation are eligible for filtering: * `name` - The name of the long-running operation * `done` - False if the operation is in progress, else true. * `metadata.@type` - the type of metadata. For example, the type string for RestoreDatabaseMetadata is `type.googleapis.com/google.spanner.admin.database.v1.RestoreDatabaseMetadata`. * `metadata.` - any field in metadata.value. `metadata.@type` must be specified first, if filtering on metadata fields. * `error` - Error associated with the long-running operation. * `response.@type` - the type of response. * `response.` - any field in response.value. You can combine multiple expressions by enclosing each expression in parentheses. By default, expressions are combined with AND logic. However, you can specify AND, OR, and NOT logic explicitly. Here are a few examples: * `done:true` - The operation is complete. * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.RestoreDatabaseMetadata) AND` \\ `(metadata.source_type:BACKUP) AND` \\ `(metadata.backup_info.backup:backup_howl) AND` \\ `(metadata.name:restored_howl) AND` \\ `(metadata.progress.start_time \u003c \\\"2018-03-28T14:50:00Z\\\") AND` \\ `(error:*)` - Return operations where: * The operation's metadata type is RestoreDatabaseMetadata. * The database is restored from a backup. * The backup name contains \"backup_howl\". * The restored database's name contains \"restored_howl\". * The operation started before 2018-03-28T14:50:00Z. * The operation resulted in an error.", "location": "query", "type": "string" }, @@ -1598,7 +1598,7 @@ ] }, "getIamPolicy": { - "description": "Gets the access control policy for a database or backup resource. Returns an empty policy if a database or backup exists but does not have a policy set. Authorization requires `spanner.databases.getIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.getIamPolicy` permission on resource.", + "description": "Gets the access control policy for a database or backup resource. Returns an empty policy if a database or backup exists but does not have a policy set. Authorization requires `spanner.databases.getIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.getIamPolicy` permission on resource. For backup schedules, authorization requires `spanner.backupSchedules.getIamPolicy` permission on resource.", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/databases/{databasesId}:getIamPolicy", "httpMethod": "POST", "id": "spanner.projects.instances.databases.getIamPolicy", @@ -1781,7 +1781,7 @@ ] }, "setIamPolicy": { - "description": "Sets the access control policy on a database or backup resource. Replaces any existing policy. Authorization requires `spanner.databases.setIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.setIamPolicy` permission on resource.", + "description": "Sets the access control policy on a database or backup resource. Replaces any existing policy. Authorization requires `spanner.databases.setIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.setIamPolicy` permission on resource. For backup schedules, authorization requires `spanner.backupSchedules.setIamPolicy` permission on resource.", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/databases/{databasesId}:setIamPolicy", "httpMethod": "POST", "id": "spanner.projects.instances.databases.setIamPolicy", @@ -1810,7 +1810,7 @@ ] }, "testIamPermissions": { - "description": "Returns permissions that the caller has on the specified database or backup resource. Attempting this RPC on a non-existent Cloud Spanner database will result in a NOT_FOUND error if the user has `spanner.databases.list` permission on the containing Cloud Spanner instance. Otherwise returns an empty set of permissions. Calling this method on a backup that does not exist will result in a NOT_FOUND error if the user has `spanner.backups.list` permission on the containing instance.", + "description": "Returns permissions that the caller has on the specified database or backup resource. Attempting this RPC on a non-existent Cloud Spanner database will result in a NOT_FOUND error if the user has `spanner.databases.list` permission on the containing Cloud Spanner instance. Otherwise returns an empty set of permissions. Calling this method on a backup that does not exist will result in a NOT_FOUND error if the user has `spanner.backups.list` permission on the containing instance. Calling this method on a backup schedule that does not exist will result in a NOT_FOUND error if the user has `spanner.backupSchedules.list` permission on the containing database.", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/databases/{databasesId}:testIamPermissions", "httpMethod": "POST", "id": "spanner.projects.instances.databases.testIamPermissions", @@ -1958,7 +1958,7 @@ ] }, "getIamPolicy": { - "description": "Gets the access control policy for a database or backup resource. Returns an empty policy if a database or backup exists but does not have a policy set. Authorization requires `spanner.databases.getIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.getIamPolicy` permission on resource.", + "description": "Gets the access control policy for a database or backup resource. Returns an empty policy if a database or backup exists but does not have a policy set. Authorization requires `spanner.databases.getIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.getIamPolicy` permission on resource. For backup schedules, authorization requires `spanner.backupSchedules.getIamPolicy` permission on resource.", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/databases/{databasesId}/backupSchedules/{backupSchedulesId}:getIamPolicy", "httpMethod": "POST", "id": "spanner.projects.instances.databases.backupSchedules.getIamPolicy", @@ -2059,7 +2059,7 @@ ] }, "setIamPolicy": { - "description": "Sets the access control policy on a database or backup resource. Replaces any existing policy. Authorization requires `spanner.databases.setIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.setIamPolicy` permission on resource.", + "description": "Sets the access control policy on a database or backup resource. Replaces any existing policy. Authorization requires `spanner.databases.setIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.setIamPolicy` permission on resource. For backup schedules, authorization requires `spanner.backupSchedules.setIamPolicy` permission on resource.", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/databases/{databasesId}/backupSchedules/{backupSchedulesId}:setIamPolicy", "httpMethod": "POST", "id": "spanner.projects.instances.databases.backupSchedules.setIamPolicy", @@ -2088,7 +2088,7 @@ ] }, "testIamPermissions": { - "description": "Returns permissions that the caller has on the specified database or backup resource. Attempting this RPC on a non-existent Cloud Spanner database will result in a NOT_FOUND error if the user has `spanner.databases.list` permission on the containing Cloud Spanner instance. Otherwise returns an empty set of permissions. Calling this method on a backup that does not exist will result in a NOT_FOUND error if the user has `spanner.backups.list` permission on the containing instance.", + "description": "Returns permissions that the caller has on the specified database or backup resource. Attempting this RPC on a non-existent Cloud Spanner database will result in a NOT_FOUND error if the user has `spanner.databases.list` permission on the containing Cloud Spanner instance. Otherwise returns an empty set of permissions. Calling this method on a backup that does not exist will result in a NOT_FOUND error if the user has `spanner.backups.list` permission on the containing instance. Calling this method on a backup schedule that does not exist will result in a NOT_FOUND error if the user has `spanner.backupSchedules.list` permission on the containing database.", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/databases/{databasesId}/backupSchedules/{backupSchedulesId}:testIamPermissions", "httpMethod": "POST", "id": "spanner.projects.instances.databases.backupSchedules.testIamPermissions", @@ -2158,7 +2158,7 @@ ] }, "testIamPermissions": { - "description": "Returns permissions that the caller has on the specified database or backup resource. Attempting this RPC on a non-existent Cloud Spanner database will result in a NOT_FOUND error if the user has `spanner.databases.list` permission on the containing Cloud Spanner instance. Otherwise returns an empty set of permissions. Calling this method on a backup that does not exist will result in a NOT_FOUND error if the user has `spanner.backups.list` permission on the containing instance.", + "description": "Returns permissions that the caller has on the specified database or backup resource. Attempting this RPC on a non-existent Cloud Spanner database will result in a NOT_FOUND error if the user has `spanner.databases.list` permission on the containing Cloud Spanner instance. Otherwise returns an empty set of permissions. Calling this method on a backup that does not exist will result in a NOT_FOUND error if the user has `spanner.backups.list` permission on the containing instance. Calling this method on a backup schedule that does not exist will result in a NOT_FOUND error if the user has `spanner.backupSchedules.list` permission on the containing database.", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/databases/{databasesId}/databaseRoles/{databaseRolesId}:testIamPermissions", "httpMethod": "POST", "id": "spanner.projects.instances.databases.databaseRoles.testIamPermissions", @@ -3319,7 +3319,7 @@ } } }, - "revision": "20241010", + "revision": "20241020", "rootUrl": "https://spanner.googleapis.com/", "schemas": { "AsymmetricAutoscalingOption": { @@ -3462,7 +3462,7 @@ "readOnly": true }, "encryptionInformation": { - "description": "Output only. The encryption information for the backup, whether it is protected by one or more KMS keys. The information includes all Cloud KMS key versions used to encrypt the backup. The `encryption_status' field inside of each `EncryptionInfo` is not populated. At least one of the key versions must be available for the backup to be restored. If a key version is revoked in the middle of a restore, the restore behavior is undefined.", + "description": "Output only. The encryption information for the backup, whether it is protected by one or more KMS keys. The information includes all Cloud KMS key versions used to encrypt the backup. The `encryption_status` field inside of each `EncryptionInfo` is not populated. At least one of the key versions must be available for the backup to be restored. If a key version is revoked in the middle of a restore, the restore behavior is undefined.", "items": { "$ref": "EncryptionInfo" }, @@ -3706,6 +3706,10 @@ "description": "The request for BeginTransaction.", "id": "BeginTransactionRequest", "properties": { + "mutationKey": { + "$ref": "Mutation", + "description": "Optional. Required for read-write transactions on a multiplexed session that commit mutations but do not perform any reads or queries. Clients should randomly select one of the mutations from the mutation set and send it as a part of this request." + }, "options": { "$ref": "TransactionOptions", "description": "Required. Options for the new transaction." @@ -3815,6 +3819,10 @@ }, "type": "array" }, + "precommitToken": { + "$ref": "MultiplexedSessionPrecommitToken", + "description": "Optional. If the read-write transaction was executed on a multiplexed session, the precommit token with the highest sequence number received in this transaction attempt, should be included here. Failing to do so will result in a FailedPrecondition error." + }, "requestOptions": { "$ref": "RequestOptions", "description": "Common options for this request." @@ -3847,6 +3855,10 @@ "description": "The Cloud Spanner timestamp at which the transaction committed.", "format": "google-datetime", "type": "string" + }, + "precommitToken": { + "$ref": "MultiplexedSessionPrecommitToken", + "description": "If specified, transaction has not committed yet. Clients must retry the commit with the new precommit token." } }, "type": "object" @@ -3926,7 +3938,7 @@ "type": "string" }, "kmsKeyNames": { - "description": "Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of the form `projects//locations//keyRings//cryptoKeys/`. Kms keys specified can be in any order. The keys referenced by kms_key_names must fully cover all regions of the backup's instance configuration. Some examples: * For single region instance configs, specify a single regional location KMS key. * For multi-regional instance configs of type GOOGLE_MANAGED, either specify a multi-regional location KMS key or multiple regional location KMS keys that cover all regions in the instance config. * For an instance config of type USER_MANAGED, please specify only regional location KMS keys to cover each region in the instance config. Multi-regional location KMS keys are not supported for USER_MANAGED instance configs.", + "description": "Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of the form `projects//locations//keyRings//cryptoKeys/`. KMS keys specified can be in any order. The keys referenced by `kms_key_names` must fully cover all regions of the backup's instance configuration. Some examples: * For regional (single-region) instance configurations, specify a regional location KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional location KMS keys that cover all regions in the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each region in the instance configuration. Multi-region location KMS keys aren't supported for `USER_MANAGED` type instance configurations.", "items": { "type": "string" }, @@ -4008,7 +4020,7 @@ "type": "string" }, "kmsKeyNames": { - "description": "Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by kms_key_names must fully cover all regions of the backup's instance configuration. Some examples: * For single region instance configs, specify a single regional location KMS key. * For multi-regional instance configs of type GOOGLE_MANAGED, either specify a multi-regional location KMS key or multiple regional location KMS keys that cover all regions in the instance config. * For an instance config of type USER_MANAGED, please specify only regional location KMS keys to cover each region in the instance config. Multi-regional location KMS keys are not supported for USER_MANAGED instance configs.", + "description": "Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by `kms_key_names` must fully cover all regions of the backup's instance configuration. Some examples: * For regional (single-region) instance configurations, specify a regional location KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional location KMS keys that cover all regions in the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each region in the instance configuration. Multi-region location KMS keys aren't supported for `USER_MANAGED` type instance configurations.", "items": { "type": "string" }, @@ -4307,7 +4319,7 @@ "readOnly": true }, "encryptionInfo": { - "description": "Output only. For databases that are using customer managed encryption, this field contains the encryption information for the database, such as all Cloud KMS key versions that are in use. The `encryption_status' field inside of each `EncryptionInfo` is not populated. For databases that are using Google default or other types of encryption, this field is empty. This field is propagated lazily from the backend. There might be a delay from when a key version is being used and when it appears in this field.", + "description": "Output only. For databases that are using customer managed encryption, this field contains the encryption information for the database, such as all Cloud KMS key versions that are in use. The `encryption_status` field inside of each `EncryptionInfo` is not populated. For databases that are using Google default or other types of encryption, this field is empty. This field is propagated lazily from the backend. There might be a delay from when a key version is being used and when it appears in this field.", "items": { "$ref": "EncryptionInfo" }, @@ -4498,7 +4510,7 @@ "type": "string" }, "kmsKeyNames": { - "description": "Specifies the KMS configuration for the one or more keys used to encrypt the database. Values are of the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by kms_key_names must fully cover all regions of the database instance configuration. Some examples: * For single region database instance configs, specify a single regional location KMS key. * For multi-regional database instance configs of type GOOGLE_MANAGED, either specify a multi-regional location KMS key or multiple regional location KMS keys that cover all regions in the instance config. * For a database instance config of type USER_MANAGED, please specify only regional location KMS keys to cover each region in the instance config. Multi-regional location KMS keys are not supported for USER_MANAGED instance configs.", + "description": "Specifies the KMS configuration for one or more keys used to encrypt the database. Values are of the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by `kms_key_names` must fully cover all regions of the database's instance configuration. Some examples: * For regional (single-region) instance configurations, specify a regional location KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional location KMS keys that cover all regions in the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each region in the instance configuration. Multi-region location KMS keys aren't supported for `USER_MANAGED` type instance configurations.", "items": { "type": "string" }, @@ -4584,6 +4596,10 @@ "description": "The response for ExecuteBatchDml. Contains a list of ResultSet messages, one for each DML statement that has successfully executed, in the same order as the statements in the request. If a statement fails, the status in the response body identifies the cause of the failure. To check for DML statements that failed, use the following approach: 1. Check the status in the response message. The google.rpc.Code enum value `OK` indicates that all statements were executed successfully. 2. If the status was not `OK`, check the number of result sets in the response. If the response contains `N` ResultSet messages, then statement `N+1` in the request failed. Example 1: * Request: 5 DML statements, all executed successfully. * Response: 5 ResultSet messages, with the status `OK`. Example 2: * Request: 5 DML statements. The third statement has a syntax error. * Response: 2 ResultSet messages, and a syntax error (`INVALID_ARGUMENT`) status. The number of ResultSet messages indicates that the third statement failed, and the fourth and fifth statements were not executed.", "id": "ExecuteBatchDmlResponse", "properties": { + "precommitToken": { + "$ref": "MultiplexedSessionPrecommitToken", + "description": "Optional. A precommit token will be included if the read-write transaction is on a multiplexed session. The precommit token with the highest sequence number from this transaction attempt should be passed to the Commit request for this transaction." + }, "resultSets": { "description": "One ResultSet for each statement in the request that ran successfully, in the same order as the statements in the request. Each ResultSet does not contain any rows. The ResultSetStats in each ResultSet contain the number of rows modified by the statement. Only the first ResultSet in the response contains valid ResultSetMetadata.", "items": { @@ -4886,6 +4902,20 @@ "readOnly": true, "type": "string" }, + "defaultBackupScheduleType": { + "description": "Optional. Controls the default backup behavior for new databases within the instance. Note that `AUTOMATIC` is not permitted for free instances, as backups and backup schedules are not allowed for free instances. In the `GetInstance` or `ListInstances` response, if the value of default_backup_schedule_type is unset or NONE, no default backup schedule will be created for new databases within the instance.", + "enum": [ + "DEFAULT_BACKUP_SCHEDULE_TYPE_UNSPECIFIED", + "NONE", + "AUTOMATIC" + ], + "enumDescriptions": [ + "Not specified.", + "No default backup schedule will be created automatically on creation of a database within the instance.", + "A default backup schedule will be created automatically on creation of a database within the instance. The default backup schedule creates a full backup every 24 hours and retains the backup for a period of 7 days. Once created, the default backup schedule can be edited/deleted similar to any other backup schedule." + ], + "type": "string" + }, "displayName": { "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" @@ -4943,12 +4973,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. If the instance has varying node count across replicas (achieved by setting asymmetric_autoscaling_options in autoscaling config), the node_count here is the maximum node count across all replicas. 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. If the instance has varying processing units per replica (achieved by setting asymmetric_autoscaling_options in autoscaling config), the processing_units here is the maximum processing units across all replicas. For more information, see [Compute capacity, nodes and processing units](https://cloud.google.com/spanner/docs/compute-capacity).", + "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" }, @@ -5905,6 +5935,10 @@ "$ref": "ResultSetMetadata", "description": "Metadata about the result set, such as row type information. Only present in the first response." }, + "precommitToken": { + "$ref": "MultiplexedSessionPrecommitToken", + "description": "Optional. A precommit token will be included if the read-write transaction is on a multiplexed session. The precommit token with the highest sequence number from this transaction attempt should be passed to the Commit request for this transaction." + }, "resumeToken": { "description": "Streaming calls might be interrupted for a variety of reasons, such as TCP connection loss. If this occurs, the stream of results can be resumed by re-sending the original request and including `resume_token`. Note that executing any other transaction in the same session invalidates the token.", "format": "byte", @@ -6380,6 +6414,11 @@ "description": "Message type to initiate a read-write transaction. Currently this transaction type has no options.", "id": "ReadWrite", "properties": { + "multiplexedSessionPreviousTransactionId": { + "description": "Optional. Clients should pass the transaction ID of the previous transaction attempt that was aborted if this transaction is being executed on a multiplexed session.", + "format": "byte", + "type": "string" + }, "readLockMode": { "description": "Read lock mode for the transaction.", "enum": [ @@ -6529,7 +6568,7 @@ "type": "string" }, "kmsKeyNames": { - "description": "Optional. Specifies the KMS configuration for the one or more keys used to encrypt the database. Values have the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by kms_key_names must fully cover all regions of the database instance configuration. Some examples: * For single region database instance configurations, specify a single regional location KMS key. * For multi-regional database instance configurations of type `GOOGLE_MANAGED`, either specify a multi-regional location KMS key or multiple regional location KMS keys that cover all regions in the instance configuration. * For a database instance configuration of type `USER_MANAGED`, please specify only regional location KMS keys to cover each region in the instance configuration. Multi-regional location KMS keys are not supported for USER_MANAGED instance configurations.", + "description": "Optional. Specifies the KMS configuration for one or more keys used to encrypt the database. Values have the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by `kms_key_names` must fully cover all regions of the database's instance configuration. Some examples: * For regional (single-region) instance configurations, specify a regional location KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional location KMS keys that cover all regions in the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each region in the instance configuration. Multi-region location KMS keys aren't supported for `USER_MANAGED` type instance configurations.", "items": { "type": "string" }, @@ -6628,6 +6667,10 @@ "$ref": "ResultSetMetadata", "description": "Metadata about the result set, such as row type information." }, + "precommitToken": { + "$ref": "MultiplexedSessionPrecommitToken", + "description": "Optional. A precommit token will be included if the read-write transaction is on a multiplexed session. The precommit token with the highest sequence number from this transaction attempt should be passed to the Commit request for this transaction." + }, "rows": { "description": "Each element in `rows` is a row whose format is defined by metadata.row_type. The ith element in each row matches the ith field in metadata.row_type. Elements are encoded based on type as described here.", "items": { @@ -7122,7 +7165,7 @@ "id": "UpdateDatabaseDdlRequest", "properties": { "operationId": { - "description": "If empty, the new update request is assigned an automatically-generated operation ID. Otherwise, `operation_id` is used to construct the name of the resulting Operation. Specifying an explicit operation ID simplifies determining whether the statements were executed in the event that the UpdateDatabaseDdl call is replayed, or the return value is otherwise lost: the database and `operation_id` fields can be combined to form the name of the resulting longrunning.Operation: `/operations/`. `operation_id` should be unique within the database, and must be a valid identifier: `a-z*`. Note that automatically-generated operation IDs always begin with an underscore. If the named operation already exists, UpdateDatabaseDdl returns `ALREADY_EXISTS`.", + "description": "If empty, the new update request is assigned an automatically-generated operation ID. Otherwise, `operation_id` is used to construct the name of the resulting Operation. Specifying an explicit operation ID simplifies determining whether the statements were executed in the event that the UpdateDatabaseDdl call is replayed, or the return value is otherwise lost: the database and `operation_id` fields can be combined to form the `name` of the resulting longrunning.Operation: `/operations/`. `operation_id` should be unique within the database, and must be a valid identifier: `a-z*`. Note that automatically-generated operation IDs always begin with an underscore. If the named operation already exists, UpdateDatabaseDdl returns `ALREADY_EXISTS`.", "type": "string" }, "protoDescriptors": { diff --git a/spanner/v1/spanner-gen.go b/spanner/v1/spanner-gen.go index 9ee3ed9a41e..9de3748ac86 100644 --- a/spanner/v1/spanner-gen.go +++ b/spanner/v1/spanner-gen.go @@ -609,7 +609,7 @@ type Backup struct { // EncryptionInformation: Output only. The encryption information for the // backup, whether it is protected by one or more KMS keys. The information // includes all Cloud KMS key versions used to encrypt the backup. The - // `encryption_status' field inside of each `EncryptionInfo` is not populated. + // `encryption_status` field inside of each `EncryptionInfo` is not populated. // At least one of the key versions must be available for the backup to be // restored. If a key version is revoked in the middle of a restore, the // restore behavior is undefined. @@ -941,6 +941,11 @@ func (s BatchWriteResponse) MarshalJSON() ([]byte, error) { // BeginTransactionRequest: The request for BeginTransaction. type BeginTransactionRequest struct { + // MutationKey: Optional. Required for read-write transactions on a multiplexed + // session that commit mutations but do not perform any reads or queries. + // Clients should randomly select one of the mutations from the mutation set + // and send it as a part of this request. + MutationKey *Mutation `json:"mutationKey,omitempty"` // Options: Required. Options for the new transaction. Options *TransactionOptions `json:"options,omitempty"` // RequestOptions: Common options for this request. Priority is ignored for @@ -948,13 +953,13 @@ type BeginTransactionRequest struct { // do anything. To set the priority for a transaction, set it on the reads and // writes that are part of this transaction instead. RequestOptions *RequestOptions `json:"requestOptions,omitempty"` - // ForceSendFields is a list of field names (e.g. "Options") 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. "MutationKey") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Options") to include in API + // NullFields is a list of field names (e.g. "MutationKey") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. @@ -1171,6 +1176,11 @@ type CommitRequest struct { // Mutations: The mutations to be executed when this transaction commits. All // mutations are applied atomically, in the order they appear in this list. Mutations []*Mutation `json:"mutations,omitempty"` + // PrecommitToken: Optional. If the read-write transaction was executed on a + // multiplexed session, the precommit token with the highest sequence number + // received in this transaction attempt, should be included here. Failing to do + // so will result in a FailedPrecondition error. + PrecommitToken *MultiplexedSessionPrecommitToken `json:"precommitToken,omitempty"` // RequestOptions: Common options for this request. RequestOptions *RequestOptions `json:"requestOptions,omitempty"` // ReturnCommitStats: If `true`, then statistics related to the transaction @@ -1212,6 +1222,9 @@ type CommitResponse struct { // CommitTimestamp: The Cloud Spanner timestamp at which the transaction // committed. CommitTimestamp string `json:"commitTimestamp,omitempty"` + // PrecommitToken: If specified, transaction has not committed yet. Clients + // must retry the commit with the new precommit token. + PrecommitToken *MultiplexedSessionPrecommitToken `json:"precommitToken,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` @@ -1334,16 +1347,17 @@ type CopyBackupEncryptionConfig struct { KmsKeyName string `json:"kmsKeyName,omitempty"` // KmsKeyNames: Optional. Specifies the KMS configuration for the one or more // keys used to protect the backup. Values are of the form - // `projects//locations//keyRings//cryptoKeys/`. Kms keys specified can be in - // any order. The keys referenced by kms_key_names must fully cover all regions - // of the backup's instance configuration. Some examples: * For single region - // instance configs, specify a single regional location KMS key. * For - // multi-regional instance configs of type GOOGLE_MANAGED, either specify a - // multi-regional location KMS key or multiple regional location KMS keys that - // cover all regions in the instance config. * For an instance config of type - // USER_MANAGED, please specify only regional location KMS keys to cover each - // region in the instance config. Multi-regional location KMS keys are not - // supported for USER_MANAGED instance configs. + // `projects//locations//keyRings//cryptoKeys/`. KMS keys specified can be in + // any order. The keys referenced by `kms_key_names` must fully cover all + // regions of the backup's instance configuration. Some examples: * For + // regional (single-region) instance configurations, specify a regional + // location KMS key. * For multi-region instance configurations of type + // `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple + // regional location KMS keys that cover all regions in the instance + // configuration. * For an instance configuration of type `USER_MANAGED`, + // specify only regional location KMS keys to cover each region in the instance + // configuration. Multi-region location KMS keys aren't supported for + // `USER_MANAGED` type instance configurations. KmsKeyNames []string `json:"kmsKeyNames,omitempty"` // ForceSendFields is a list of field names (e.g. "EncryptionType") to // unconditionally include in API requests. By default, fields with empty or @@ -1465,15 +1479,16 @@ type CreateBackupEncryptionConfig struct { // KmsKeyNames: Optional. Specifies the KMS configuration for the one or more // keys used to protect the backup. Values are of the form // `projects//locations//keyRings//cryptoKeys/`. The keys referenced by - // kms_key_names must fully cover all regions of the backup's instance - // configuration. Some examples: * For single region instance configs, specify - // a single regional location KMS key. * For multi-regional instance configs of - // type GOOGLE_MANAGED, either specify a multi-regional location KMS key or - // multiple regional location KMS keys that cover all regions in the instance - // config. * For an instance config of type USER_MANAGED, please specify only - // regional location KMS keys to cover each region in the instance config. - // Multi-regional location KMS keys are not supported for USER_MANAGED instance - // configs. + // `kms_key_names` must fully cover all regions of the backup's instance + // configuration. Some examples: * For regional (single-region) instance + // configurations, specify a regional location KMS key. * For multi-region + // instance configurations of type `GOOGLE_MANAGED`, either specify a + // multi-region location KMS key or multiple regional location KMS keys that + // cover all regions in the instance configuration. * For an instance + // configuration of type `USER_MANAGED`, specify only regional location KMS + // keys to cover each region in the instance configuration. Multi-region + // location KMS keys aren't supported for `USER_MANAGED` type instance + // configurations. KmsKeyNames []string `json:"kmsKeyNames,omitempty"` // ForceSendFields is a list of field names (e.g. "EncryptionType") to // unconditionally include in API requests. By default, fields with empty or @@ -1900,7 +1915,7 @@ type Database struct { EncryptionConfig *EncryptionConfig `json:"encryptionConfig,omitempty"` // EncryptionInfo: Output only. For databases that are using customer managed // encryption, this field contains the encryption information for the database, - // such as all Cloud KMS key versions that are in use. The `encryption_status' + // such as all Cloud KMS key versions that are in use. The `encryption_status` // field inside of each `EncryptionInfo` is not populated. For databases that // are using Google default or other types of encryption, this field is empty. // This field is propagated lazily from the backend. There might be a delay @@ -2167,18 +2182,19 @@ type EncryptionConfig struct { // database. Values are of the form // `projects//locations//keyRings//cryptoKeys/`. KmsKeyName string `json:"kmsKeyName,omitempty"` - // KmsKeyNames: Specifies the KMS configuration for the one or more keys used - // to encrypt the database. Values are of the form + // KmsKeyNames: Specifies the KMS configuration for one or more keys used to + // encrypt the database. Values are of the form // `projects//locations//keyRings//cryptoKeys/`. The keys referenced by - // kms_key_names must fully cover all regions of the database instance - // configuration. Some examples: * For single region database instance configs, - // specify a single regional location KMS key. * For multi-regional database - // instance configs of type GOOGLE_MANAGED, either specify a multi-regional - // location KMS key or multiple regional location KMS keys that cover all - // regions in the instance config. * For a database instance config of type - // USER_MANAGED, please specify only regional location KMS keys to cover each - // region in the instance config. Multi-regional location KMS keys are not - // supported for USER_MANAGED instance configs. + // `kms_key_names` must fully cover all regions of the database's instance + // configuration. Some examples: * For regional (single-region) instance + // configurations, specify a regional location KMS key. * For multi-region + // instance configurations of type `GOOGLE_MANAGED`, either specify a + // multi-region location KMS key or multiple regional location KMS keys that + // cover all regions in the instance configuration. * For an instance + // configuration of type `USER_MANAGED`, specify only regional location KMS + // keys to cover each region in the instance configuration. Multi-region + // location KMS keys aren't supported for `USER_MANAGED` type instance + // configurations. KmsKeyNames []string `json:"kmsKeyNames,omitempty"` // ForceSendFields is a list of field names (e.g. "KmsKeyName") to // unconditionally include in API requests. By default, fields with empty or @@ -2320,6 +2336,11 @@ func (s ExecuteBatchDmlRequest) MarshalJSON() ([]byte, error) { // the third statement failed, and the fourth and fifth statements were not // executed. type ExecuteBatchDmlResponse struct { + // PrecommitToken: Optional. A precommit token will be included if the + // read-write transaction is on a multiplexed session. The precommit token with + // the highest sequence number from this transaction attempt should be passed + // to the Commit request for this transaction. + PrecommitToken *MultiplexedSessionPrecommitToken `json:"precommitToken,omitempty"` // ResultSets: One ResultSet for each statement in the request that ran // successfully, in the same order as the statements in the request. Each // ResultSet does not contain any rows. The ResultSetStats in each ResultSet @@ -2332,15 +2353,15 @@ type ExecuteBatchDmlResponse struct { // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "ResultSets") to + // ForceSendFields is a list of field names (e.g. "PrecommitToken") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ResultSets") 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. "PrecommitToken") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -2797,6 +2818,24 @@ type Instance struct { Config string `json:"config,omitempty"` // CreateTime: Output only. The time at which the instance was created. CreateTime string `json:"createTime,omitempty"` + // DefaultBackupScheduleType: Optional. Controls the default backup behavior + // for new databases within the instance. Note that `AUTOMATIC` is not + // permitted for free instances, as backups and backup schedules are not + // allowed for free instances. In the `GetInstance` or `ListInstances` + // response, if the value of default_backup_schedule_type is unset or NONE, no + // default backup schedule will be created for new databases within the + // instance. + // + // Possible values: + // "DEFAULT_BACKUP_SCHEDULE_TYPE_UNSPECIFIED" - Not specified. + // "NONE" - No default backup schedule will be created automatically on + // creation of a database within the instance. + // "AUTOMATIC" - A default backup schedule will be created automatically on + // creation of a database within the instance. The default backup schedule + // creates a full backup every 24 hours and retains the backup for a period of + // 7 days. Once created, the default backup schedule can be edited/deleted + // similar to any other backup schedule. + DefaultBackupScheduleType string `json:"defaultBackupScheduleType,omitempty"` // DisplayName: 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. @@ -2852,11 +2891,9 @@ type Instance struct { // 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. If the instance has varying node - // count across replicas (achieved by setting asymmetric_autoscaling_options in - // autoscaling config), the node_count here is the maximum node count across - // all replicas. For more information, see Compute capacity, nodes, and - // processing units (https://cloud.google.com/spanner/docs/compute-capacity). + // 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. // At most, one of either `processing_units` or `node_count` should be present @@ -2865,11 +2902,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. If the instance has varying processing units per replica - // (achieved by setting asymmetric_autoscaling_options in autoscaling config), - // the processing_units here is the maximum processing units across all - // replicas. For more information, see Compute capacity, nodes and processing - // units (https://cloud.google.com/spanner/docs/compute-capacity). + // `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"` // ReplicaComputeCapacity: Output only. Lists the compute capacity per // ReplicaSelection. A replica selection identifies a set of replicas with @@ -4189,6 +4223,11 @@ type PartialResultSet struct { // Metadata: Metadata about the result set, such as row type information. Only // present in the first response. Metadata *ResultSetMetadata `json:"metadata,omitempty"` + // PrecommitToken: Optional. A precommit token will be included if the + // read-write transaction is on a multiplexed session. The precommit token with + // the highest sequence number from this transaction attempt should be passed + // to the Commit request for this transaction. + PrecommitToken *MultiplexedSessionPrecommitToken `json:"precommitToken,omitempty"` // ResumeToken: Streaming calls might be interrupted for a variety of reasons, // such as TCP connection loss. If this occurs, the stream of results can be // resumed by re-sending the original request and including `resume_token`. @@ -4965,6 +5004,10 @@ func (s ReadRequest) MarshalJSON() ([]byte, error) { // ReadWrite: Message type to initiate a read-write transaction. Currently this // transaction type has no options. type ReadWrite struct { + // MultiplexedSessionPreviousTransactionId: Optional. Clients should pass the + // transaction ID of the previous transaction attempt that was aborted if this + // transaction is being executed on a multiplexed session. + MultiplexedSessionPreviousTransactionId string `json:"multiplexedSessionPreviousTransactionId,omitempty"` // ReadLockMode: Read lock mode for the transaction. // // Possible values: @@ -4977,16 +5020,18 @@ type ReadWrite struct { // commit to validate that read/queried data has not changed since the // transaction started. ReadLockMode string `json:"readLockMode,omitempty"` - // ForceSendFields is a list of field names (e.g. "ReadLockMode") 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. + // "MultiplexedSessionPreviousTransactionId") to unconditionally include in API + // requests. By default, fields with empty or default values are omitted from + // API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ReadLockMode") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + // NullFields is a list of field names (e.g. + // "MultiplexedSessionPreviousTransactionId") to include in API requests with + // the JSON null value. By default, fields with empty values are omitted from + // API requests. See https://pkg.go.dev/google.golang.org/api#hdr-NullFields + // for more details. NullFields []string `json:"-"` } @@ -5174,19 +5219,19 @@ type RestoreDatabaseEncryptionConfig struct { // `CUSTOMER_MANAGED_ENCRYPTION`. Values are of the form // `projects//locations//keyRings//cryptoKeys/`. KmsKeyName string `json:"kmsKeyName,omitempty"` - // KmsKeyNames: Optional. Specifies the KMS configuration for the one or more - // keys used to encrypt the database. Values have the form + // KmsKeyNames: Optional. Specifies the KMS configuration for one or more keys + // used to encrypt the database. Values have the form // `projects//locations//keyRings//cryptoKeys/`. The keys referenced by - // kms_key_names must fully cover all regions of the database instance - // configuration. Some examples: * For single region database instance - // configurations, specify a single regional location KMS key. * For - // multi-regional database instance configurations of type `GOOGLE_MANAGED`, - // either specify a multi-regional location KMS key or multiple regional - // location KMS keys that cover all regions in the instance configuration. * - // For a database instance configuration of type `USER_MANAGED`, please specify - // only regional location KMS keys to cover each region in the instance - // configuration. Multi-regional location KMS keys are not supported for - // USER_MANAGED instance configurations. + // `kms_key_names` must fully cover all regions of the database's instance + // configuration. Some examples: * For regional (single-region) instance + // configurations, specify a regional location KMS key. * For multi-region + // instance configurations of type `GOOGLE_MANAGED`, either specify a + // multi-region location KMS key or multiple regional location KMS keys that + // cover all regions in the instance configuration. * For an instance + // configuration of type `USER_MANAGED`, specify only regional location KMS + // keys to cover each region in the instance configuration. Multi-region + // location KMS keys aren't supported for `USER_MANAGED` type instance + // configurations. KmsKeyNames []string `json:"kmsKeyNames,omitempty"` // ForceSendFields is a list of field names (e.g. "EncryptionType") to // unconditionally include in API requests. By default, fields with empty or @@ -5326,6 +5371,11 @@ func (s RestoreInfo) MarshalJSON() ([]byte, error) { type ResultSet struct { // Metadata: Metadata about the result set, such as row type information. Metadata *ResultSetMetadata `json:"metadata,omitempty"` + // PrecommitToken: Optional. A precommit token will be included if the + // read-write transaction is on a multiplexed session. The precommit token with + // the highest sequence number from this transaction attempt should be passed + // to the Commit request for this transaction. + PrecommitToken *MultiplexedSessionPrecommitToken `json:"precommitToken,omitempty"` // Rows: Each element in `rows` is a row whose format is defined by // metadata.row_type. The ith element in each row matches the ith field in // metadata.row_type. Elements are encoded based on type as described here. @@ -6262,7 +6312,7 @@ type UpdateDatabaseDdlRequest struct { // operation ID simplifies determining whether the statements were executed in // the event that the UpdateDatabaseDdl call is replayed, or the return value // is otherwise lost: the database and `operation_id` fields can be combined to - // form the name of the resulting longrunning.Operation: `/operations/`. + // form the `name` of the resulting longrunning.Operation: `/operations/`. // `operation_id` should be unique within the database, and must be a valid // identifier: `a-z*`. Note that automatically-generated operation IDs always // begin with an underscore. If the named operation already exists, @@ -9818,15 +9868,16 @@ func (c *ProjectsInstancesBackupsCreateCall) EncryptionConfigKmsKeyName(encrypti // "encryptionConfig.kmsKeyNames": Specifies the KMS configuration for the one // or more keys used to protect the backup. Values are of the form // `projects//locations//keyRings//cryptoKeys/`. The keys referenced by -// kms_key_names must fully cover all regions of the backup's instance -// configuration. Some examples: * For single region instance configs, specify -// a single regional location KMS key. * For multi-regional instance configs of -// type GOOGLE_MANAGED, either specify a multi-regional location KMS key or -// multiple regional location KMS keys that cover all regions in the instance -// config. * For an instance config of type USER_MANAGED, please specify only -// regional location KMS keys to cover each region in the instance config. -// Multi-regional location KMS keys are not supported for USER_MANAGED instance -// configs. +// `kms_key_names` must fully cover all regions of the backup's instance +// configuration. Some examples: * For regional (single-region) instance +// configurations, specify a regional location KMS key. * For multi-region +// instance configurations of type `GOOGLE_MANAGED`, either specify a +// multi-region location KMS key or multiple regional location KMS keys that +// cover all regions in the instance configuration. * For an instance +// configuration of type `USER_MANAGED`, specify only regional location KMS +// keys to cover each region in the instance configuration. Multi-region +// location KMS keys aren't supported for `USER_MANAGED` type instance +// configurations. func (c *ProjectsInstancesBackupsCreateCall) EncryptionConfigKmsKeyNames(encryptionConfigKmsKeyNames ...string) *ProjectsInstancesBackupsCreateCall { c.urlParams_.SetMulti("encryptionConfig.kmsKeyNames", append([]string{}, encryptionConfigKmsKeyNames...)) return c @@ -10132,7 +10183,8 @@ type ProjectsInstancesBackupsGetIamPolicyCall struct { // not have a policy set. Authorization requires // `spanner.databases.getIamPolicy` permission on resource. For backups, // authorization requires `spanner.backups.getIamPolicy` permission on -// resource. +// resource. For backup schedules, authorization requires +// `spanner.backupSchedules.getIamPolicy` permission on resource. // // - resource: REQUIRED: The Cloud Spanner resource for which the policy is // being retrieved. The format is `projects//instances/` for instance @@ -10534,7 +10586,8 @@ type ProjectsInstancesBackupsSetIamPolicyCall struct { // resource. Replaces any existing policy. Authorization requires // `spanner.databases.setIamPolicy` permission on resource. For backups, // authorization requires `spanner.backups.setIamPolicy` permission on -// resource. +// resource. For backup schedules, authorization requires +// `spanner.backupSchedules.setIamPolicy` permission on resource. // // - resource: REQUIRED: The Cloud Spanner resource for which the policy is // being set. The format is `projects//instances/` for instance resources and @@ -10643,7 +10696,10 @@ type ProjectsInstancesBackupsTestIamPermissionsCall struct { // `spanner.databases.list` permission on the containing Cloud Spanner // instance. Otherwise returns an empty set of permissions. Calling this method // on a backup that does not exist will result in a NOT_FOUND error if the user -// has `spanner.backups.list` permission on the containing instance. +// has `spanner.backups.list` permission on the containing instance. Calling +// this method on a backup schedule that does not exist will result in a +// NOT_FOUND error if the user has `spanner.backupSchedules.list` permission on +// the containing database. // // - resource: REQUIRED: The Cloud Spanner resource for which permissions are // being tested. The format is `projects//instances/` for instance resources @@ -11226,7 +11282,7 @@ func (r *ProjectsInstancesDatabaseOperationsService) List(parent string) *Projec // comparison operator, and a value for filtering. The value must be a string, // a number, or a boolean. The comparison operator must be one of: `<`, `>`, // `<=`, `>=`, `!=`, `=`, or `:`. Colon `:` is the contains operator. Filter -// rules are not case sensitive. The following fields in the Operation are +// rules are not case sensitive. The following fields in the operation are // eligible for filtering: * `name` - The name of the long-running operation * // `done` - False if the operation is in progress, else true. * // `metadata.@type` - the type of metadata. For example, the type string for @@ -11928,7 +11984,8 @@ type ProjectsInstancesDatabasesGetIamPolicyCall struct { // not have a policy set. Authorization requires // `spanner.databases.getIamPolicy` permission on resource. For backups, // authorization requires `spanner.backups.getIamPolicy` permission on -// resource. +// resource. For backup schedules, authorization requires +// `spanner.backupSchedules.getIamPolicy` permission on resource. // // - resource: REQUIRED: The Cloud Spanner resource for which the policy is // being retrieved. The format is `projects//instances/` for instance @@ -12570,7 +12627,8 @@ type ProjectsInstancesDatabasesSetIamPolicyCall struct { // resource. Replaces any existing policy. Authorization requires // `spanner.databases.setIamPolicy` permission on resource. For backups, // authorization requires `spanner.backups.setIamPolicy` permission on -// resource. +// resource. For backup schedules, authorization requires +// `spanner.backupSchedules.setIamPolicy` permission on resource. // // - resource: REQUIRED: The Cloud Spanner resource for which the policy is // being set. The format is `projects//instances/` for instance resources and @@ -12679,7 +12737,10 @@ type ProjectsInstancesDatabasesTestIamPermissionsCall struct { // `spanner.databases.list` permission on the containing Cloud Spanner // instance. Otherwise returns an empty set of permissions. Calling this method // on a backup that does not exist will result in a NOT_FOUND error if the user -// has `spanner.backups.list` permission on the containing instance. +// has `spanner.backups.list` permission on the containing instance. Calling +// this method on a backup schedule that does not exist will result in a +// NOT_FOUND error if the user has `spanner.backupSchedules.list` permission on +// the containing database. // // - resource: REQUIRED: The Cloud Spanner resource for which permissions are // being tested. The format is `projects//instances/` for instance resources @@ -13207,7 +13268,8 @@ type ProjectsInstancesDatabasesBackupSchedulesGetIamPolicyCall struct { // not have a policy set. Authorization requires // `spanner.databases.getIamPolicy` permission on resource. For backups, // authorization requires `spanner.backups.getIamPolicy` permission on -// resource. +// resource. For backup schedules, authorization requires +// `spanner.backupSchedules.getIamPolicy` permission on resource. // // - resource: REQUIRED: The Cloud Spanner resource for which the policy is // being retrieved. The format is `projects//instances/` for instance @@ -13576,7 +13638,8 @@ type ProjectsInstancesDatabasesBackupSchedulesSetIamPolicyCall struct { // resource. Replaces any existing policy. Authorization requires // `spanner.databases.setIamPolicy` permission on resource. For backups, // authorization requires `spanner.backups.setIamPolicy` permission on -// resource. +// resource. For backup schedules, authorization requires +// `spanner.backupSchedules.setIamPolicy` permission on resource. // // - resource: REQUIRED: The Cloud Spanner resource for which the policy is // being set. The format is `projects//instances/` for instance resources and @@ -13685,7 +13748,10 @@ type ProjectsInstancesDatabasesBackupSchedulesTestIamPermissionsCall struct { // `spanner.databases.list` permission on the containing Cloud Spanner // instance. Otherwise returns an empty set of permissions. Calling this method // on a backup that does not exist will result in a NOT_FOUND error if the user -// has `spanner.backups.list` permission on the containing instance. +// has `spanner.backups.list` permission on the containing instance. Calling +// this method on a backup schedule that does not exist will result in a +// NOT_FOUND error if the user has `spanner.backupSchedules.list` permission on +// the containing database. // // - resource: REQUIRED: The Cloud Spanner resource for which permissions are // being tested. The format is `projects//instances/` for instance resources @@ -13941,7 +14007,10 @@ type ProjectsInstancesDatabasesDatabaseRolesTestIamPermissionsCall struct { // `spanner.databases.list` permission on the containing Cloud Spanner // instance. Otherwise returns an empty set of permissions. Calling this method // on a backup that does not exist will result in a NOT_FOUND error if the user -// has `spanner.backups.list` permission on the containing instance. +// has `spanner.backups.list` permission on the containing instance. Calling +// this method on a backup schedule that does not exist will result in a +// NOT_FOUND error if the user has `spanner.backupSchedules.list` permission on +// the containing database. // // - resource: REQUIRED: The Cloud Spanner resource for which permissions are // being tested. The format is `projects//instances/` for instance resources diff --git a/speech/v1/speech-api.json b/speech/v1/speech-api.json index 9c424642458..fcf425269f0 100644 --- a/speech/v1/speech-api.json +++ b/speech/v1/speech-api.json @@ -15,6 +15,23 @@ "description": "Converts audio to text by applying powerful neural network models.", "discoveryVersion": "v1", "documentationLink": "https://cloud.google.com/speech-to-text/docs/quickstart-protocol", + "endpoints": [ + { + "description": "Regional Endpoint", + "endpointUrl": "https://speech.us-central1.rep.googleapis.com/", + "location": "us-central1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://speech.us-west1.rep.googleapis.com/", + "location": "us-west1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://speech.me-west1.rep.googleapis.com/", + "location": "me-west1" + } + ], "fullyEncodeReservedExpansion": true, "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", @@ -524,7 +541,7 @@ } } }, - "revision": "20240926", + "revision": "20241024", "rootUrl": "https://speech.googleapis.com/", "schemas": { "ABNFGrammar": { diff --git a/speech/v1p1beta1/speech-api.json b/speech/v1p1beta1/speech-api.json index 53db242eb8c..6a93d7f15f4 100644 --- a/speech/v1p1beta1/speech-api.json +++ b/speech/v1p1beta1/speech-api.json @@ -15,6 +15,23 @@ "description": "Converts audio to text by applying powerful neural network models.", "discoveryVersion": "v1", "documentationLink": "https://cloud.google.com/speech-to-text/docs/quickstart-protocol", + "endpoints": [ + { + "description": "Regional Endpoint", + "endpointUrl": "https://speech.us-central1.rep.googleapis.com/", + "location": "us-central1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://speech.us-west1.rep.googleapis.com/", + "location": "us-west1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://speech.me-west1.rep.googleapis.com/", + "location": "me-west1" + } + ], "fullyEncodeReservedExpansion": true, "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", @@ -524,7 +541,7 @@ } } }, - "revision": "20240926", + "revision": "20241024", "rootUrl": "https://speech.googleapis.com/", "schemas": { "ABNFGrammar": { diff --git a/texttospeech/v1/texttospeech-api.json b/texttospeech/v1/texttospeech-api.json index 6f9f38e5fad..5e7f4733319 100644 --- a/texttospeech/v1/texttospeech-api.json +++ b/texttospeech/v1/texttospeech-api.json @@ -318,7 +318,7 @@ } } }, - "revision": "20241008", + "revision": "20241026", "rootUrl": "https://texttospeech.googleapis.com/", "schemas": { "AdvancedVoiceOptions": { @@ -326,7 +326,7 @@ "id": "AdvancedVoiceOptions", "properties": { "lowLatencyJourneySynthesis": { - "description": "Only for Jounrney voices. If false, the synthesis will be context aware and have higher latency.", + "description": "Only for Journey voices. If false, the synthesis will be context aware and have higher latency.", "type": "boolean" } }, @@ -522,6 +522,20 @@ }, "type": "object" }, + "MultiSpeakerMarkup": { + "description": "A collection of turns for multi-speaker synthesis.", + "id": "MultiSpeakerMarkup", + "properties": { + "turns": { + "description": "Required. Speaker turns.", + "items": { + "$ref": "Turn" + }, + "type": "array" + } + }, + "type": "object" + }, "Operation": { "description": "This resource represents a long-running operation that is the result of a network API call.", "id": "Operation", @@ -592,6 +606,10 @@ "$ref": "CustomPronunciations", "description": "Optional. The pronunciation customizations to be applied to the input. If this is set, the input will be synthesized using the given pronunciation customizations. The initial support will be for EFIGS (English, French, Italian, German, Spanish) languages, as provided in VoiceSelectionParams. Journey and Instant Clone voices are not supported yet. In order to customize the pronunciation of a phrase, there must be an exact match of the phrase in the input types. If using SSML, the phrase must not be inside a phoneme tag (entirely or partially)." }, + "multiSpeakerMarkup": { + "$ref": "MultiSpeakerMarkup", + "description": "The multi-speaker input to be synthesized. Only applicable for multi-speaker synthesis." + }, "ssml": { "description": "The SSML document to be synthesized. The SSML document must be valid and well-formed. Otherwise the RPC will fail and return google.rpc.Code.INVALID_ARGUMENT. For more information, see [SSML](https://cloud.google.com/text-to-speech/docs/ssml).", "type": "string" @@ -655,7 +673,7 @@ "properties": { "advancedVoiceOptions": { "$ref": "AdvancedVoiceOptions", - "description": "Adnanced voice options." + "description": "Advanced voice options." }, "audioConfig": { "$ref": "AudioConfig", @@ -684,6 +702,21 @@ }, "type": "object" }, + "Turn": { + "description": "A Multi-speaker turn.", + "id": "Turn", + "properties": { + "speaker": { + "description": "Required. The speaker of the turn, for example, 'O' or 'Q'. Please refer to documentation for available speakers.", + "type": "string" + }, + "text": { + "description": "Required. The text to speak.", + "type": "string" + } + }, + "type": "object" + }, "Voice": { "description": "Description of a voice supported by the TTS service.", "id": "Voice", @@ -723,6 +756,17 @@ }, "type": "object" }, + "VoiceCloneParams": { + "description": "The configuration of Voice Clone feature.", + "id": "VoiceCloneParams", + "properties": { + "voiceCloningKey": { + "description": "Required. Created by GenerateVoiceCloningKey.", + "type": "string" + } + }, + "type": "object" + }, "VoiceSelectionParams": { "description": "Description of which voice to use for a synthesis request.", "id": "VoiceSelectionParams", @@ -754,6 +798,10 @@ "A gender-neutral voice. This voice is not yet supported." ], "type": "string" + }, + "voiceClone": { + "$ref": "VoiceCloneParams", + "description": "Optional. The configuration for a voice clone. If [VoiceCloneParams.voice_clone_key] is set, the service will choose the voice clone matching the specified configuration." } }, "type": "object" diff --git a/texttospeech/v1/texttospeech-gen.go b/texttospeech/v1/texttospeech-gen.go index 8bb59a93731..38577322244 100644 --- a/texttospeech/v1/texttospeech-gen.go +++ b/texttospeech/v1/texttospeech-gen.go @@ -227,8 +227,8 @@ type VoicesService struct { // AdvancedVoiceOptions: Used for advanced voice options. type AdvancedVoiceOptions struct { - // LowLatencyJourneySynthesis: Only for Jounrney voices. If false, the - // synthesis will be context aware and have higher latency. + // LowLatencyJourneySynthesis: Only for Journey voices. If false, the synthesis + // will be context aware and have higher latency. LowLatencyJourneySynthesis bool `json:"lowLatencyJourneySynthesis,omitempty"` // ForceSendFields is a list of field names (e.g. "LowLatencyJourneySynthesis") // to unconditionally include in API requests. By default, fields with empty or @@ -537,6 +537,28 @@ func (s ListVoicesResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// MultiSpeakerMarkup: A collection of turns for multi-speaker synthesis. +type MultiSpeakerMarkup struct { + // Turns: Required. Speaker turns. + Turns []*Turn `json:"turns,omitempty"` + // ForceSendFields is a list of field names (e.g. "Turns") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Turns") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s MultiSpeakerMarkup) MarshalJSON() ([]byte, error) { + type NoMethod MultiSpeakerMarkup + 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 { @@ -631,6 +653,9 @@ type SynthesisInput struct { // exact match of the phrase in the input types. If using SSML, the phrase must // not be inside a phoneme tag (entirely or partially). CustomPronunciations *CustomPronunciations `json:"customPronunciations,omitempty"` + // MultiSpeakerMarkup: The multi-speaker input to be synthesized. Only + // applicable for multi-speaker synthesis. + MultiSpeakerMarkup *MultiSpeakerMarkup `json:"multiSpeakerMarkup,omitempty"` // Ssml: The SSML document to be synthesized. The SSML document must be valid // and well-formed. Otherwise the RPC will fail and return // google.rpc.Code.INVALID_ARGUMENT. For more information, see SSML @@ -733,7 +758,7 @@ func (s SynthesizeLongAudioRequest) MarshalJSON() ([]byte, error) { // SynthesizeSpeechRequest: The top-level message sent by the client for the // `SynthesizeSpeech` method. type SynthesizeSpeechRequest struct { - // AdvancedVoiceOptions: Adnanced voice options. + // AdvancedVoiceOptions: Advanced voice options. AdvancedVoiceOptions *AdvancedVoiceOptions `json:"advancedVoiceOptions,omitempty"` // AudioConfig: Required. The configuration of the synthesized audio. AudioConfig *AudioConfig `json:"audioConfig,omitempty"` @@ -790,6 +815,31 @@ func (s SynthesizeSpeechResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// Turn: A Multi-speaker turn. +type Turn struct { + // Speaker: Required. The speaker of the turn, for example, 'O' or 'Q'. Please + // refer to documentation for available speakers. + Speaker string `json:"speaker,omitempty"` + // Text: Required. The text to speak. + Text string `json:"text,omitempty"` + // ForceSendFields is a list of field names (e.g. "Speaker") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Speaker") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s Turn) MarshalJSON() ([]byte, error) { + type NoMethod Turn + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Voice: Description of a voice supported by the TTS service. type Voice struct { // LanguageCodes: The languages that this voice supports, expressed as BCP-47 @@ -830,6 +880,28 @@ func (s Voice) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// VoiceCloneParams: The configuration of Voice Clone feature. +type VoiceCloneParams struct { + // VoiceCloningKey: Required. Created by GenerateVoiceCloningKey. + VoiceCloningKey string `json:"voiceCloningKey,omitempty"` + // ForceSendFields is a list of field names (e.g. "VoiceCloningKey") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "VoiceCloningKey") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s VoiceCloneParams) MarshalJSON() ([]byte, error) { + type NoMethod VoiceCloneParams + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // VoiceSelectionParams: Description of which voice to use for a synthesis // request. type VoiceSelectionParams struct { @@ -869,6 +941,10 @@ type VoiceSelectionParams struct { // "FEMALE" - A female voice. // "NEUTRAL" - A gender-neutral voice. This voice is not yet supported. SsmlGender string `json:"ssmlGender,omitempty"` + // VoiceClone: Optional. The configuration for a voice clone. If + // [VoiceCloneParams.voice_clone_key] is set, the service will choose the voice + // clone matching the specified configuration. + VoiceClone *VoiceCloneParams `json:"voiceClone,omitempty"` // ForceSendFields is a list of field names (e.g. "CustomVoice") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See diff --git a/texttospeech/v1beta1/texttospeech-api.json b/texttospeech/v1beta1/texttospeech-api.json index 5b14029b01b..77169025a57 100644 --- a/texttospeech/v1beta1/texttospeech-api.json +++ b/texttospeech/v1beta1/texttospeech-api.json @@ -261,7 +261,7 @@ } } }, - "revision": "20241008", + "revision": "20241026", "rootUrl": "https://texttospeech.googleapis.com/", "schemas": { "AdvancedVoiceOptions": { @@ -269,7 +269,7 @@ "id": "AdvancedVoiceOptions", "properties": { "lowLatencyJourneySynthesis": { - "description": "Only for Jounrney voices. If false, the synthesis will be context aware and have higher latency.", + "description": "Only for Journey voices. If false, the synthesis will be context aware and have higher latency.", "type": "boolean" } }, @@ -455,6 +455,20 @@ }, "type": "object" }, + "MultiSpeakerMarkup": { + "description": "A collection of turns for multi-speaker synthesis.", + "id": "MultiSpeakerMarkup", + "properties": { + "turns": { + "description": "Required. Speaker turns.", + "items": { + "$ref": "Turn" + }, + "type": "array" + } + }, + "type": "object" + }, "Operation": { "description": "This resource represents a long-running operation that is the result of a network API call.", "id": "Operation", @@ -525,6 +539,10 @@ "$ref": "CustomPronunciations", "description": "Optional. The pronunciation customizations to be applied to the input. If this is set, the input will be synthesized using the given pronunciation customizations. The initial support will be for EFIGS (English, French, Italian, German, Spanish) languages, as provided in VoiceSelectionParams. Journey and Instant Clone voices are not supported yet. In order to customize the pronunciation of a phrase, there must be an exact match of the phrase in the input types. If using SSML, the phrase must not be inside a phoneme tag (entirely or partially)." }, + "multiSpeakerMarkup": { + "$ref": "MultiSpeakerMarkup", + "description": "The multi-speaker input to be synthesized. Only applicable for multi-speaker synthesis." + }, "ssml": { "description": "The SSML document to be synthesized. The SSML document must be valid and well-formed. Otherwise the RPC will fail and return google.rpc.Code.INVALID_ARGUMENT. For more information, see [SSML](https://cloud.google.com/text-to-speech/docs/ssml).", "type": "string" @@ -588,7 +606,7 @@ "properties": { "advancedVoiceOptions": { "$ref": "AdvancedVoiceOptions", - "description": "Adnanced voice options." + "description": "Advanced voice options." }, "audioConfig": { "$ref": "AudioConfig", @@ -659,6 +677,21 @@ }, "type": "object" }, + "Turn": { + "description": "A Multi-speaker turn.", + "id": "Turn", + "properties": { + "speaker": { + "description": "Required. The speaker of the turn, for example, 'O' or 'Q'. Please refer to documentation for available speakers.", + "type": "string" + }, + "text": { + "description": "Required. The text to speak.", + "type": "string" + } + }, + "type": "object" + }, "Voice": { "description": "Description of a voice supported by the TTS service.", "id": "Voice", @@ -698,6 +731,17 @@ }, "type": "object" }, + "VoiceCloneParams": { + "description": "The configuration of Voice Clone feature.", + "id": "VoiceCloneParams", + "properties": { + "voiceCloningKey": { + "description": "Required. Created by GenerateVoiceCloningKey.", + "type": "string" + } + }, + "type": "object" + }, "VoiceSelectionParams": { "description": "Description of which voice to use for a synthesis request.", "id": "VoiceSelectionParams", @@ -729,6 +773,10 @@ "A gender-neutral voice. This voice is not yet supported." ], "type": "string" + }, + "voiceClone": { + "$ref": "VoiceCloneParams", + "description": "Optional. The configuration for a voice clone. If [VoiceCloneParams.voice_clone_key] is set, the service will choose the voice clone matching the specified configuration." } }, "type": "object" diff --git a/texttospeech/v1beta1/texttospeech-gen.go b/texttospeech/v1beta1/texttospeech-gen.go index 4dd0ed4978b..a6e7dfab30a 100644 --- a/texttospeech/v1beta1/texttospeech-gen.go +++ b/texttospeech/v1beta1/texttospeech-gen.go @@ -215,8 +215,8 @@ type VoicesService struct { // AdvancedVoiceOptions: Used for advanced voice options. type AdvancedVoiceOptions struct { - // LowLatencyJourneySynthesis: Only for Jounrney voices. If false, the - // synthesis will be context aware and have higher latency. + // LowLatencyJourneySynthesis: Only for Journey voices. If false, the synthesis + // will be context aware and have higher latency. LowLatencyJourneySynthesis bool `json:"lowLatencyJourneySynthesis,omitempty"` // ForceSendFields is a list of field names (e.g. "LowLatencyJourneySynthesis") // to unconditionally include in API requests. By default, fields with empty or @@ -513,6 +513,28 @@ func (s ListVoicesResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// MultiSpeakerMarkup: A collection of turns for multi-speaker synthesis. +type MultiSpeakerMarkup struct { + // Turns: Required. Speaker turns. + Turns []*Turn `json:"turns,omitempty"` + // ForceSendFields is a list of field names (e.g. "Turns") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Turns") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s MultiSpeakerMarkup) MarshalJSON() ([]byte, error) { + type NoMethod MultiSpeakerMarkup + 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 { @@ -607,6 +629,9 @@ type SynthesisInput struct { // exact match of the phrase in the input types. If using SSML, the phrase must // not be inside a phoneme tag (entirely or partially). CustomPronunciations *CustomPronunciations `json:"customPronunciations,omitempty"` + // MultiSpeakerMarkup: The multi-speaker input to be synthesized. Only + // applicable for multi-speaker synthesis. + MultiSpeakerMarkup *MultiSpeakerMarkup `json:"multiSpeakerMarkup,omitempty"` // Ssml: The SSML document to be synthesized. The SSML document must be valid // and well-formed. Otherwise the RPC will fail and return // google.rpc.Code.INVALID_ARGUMENT. For more information, see SSML @@ -709,7 +734,7 @@ func (s SynthesizeLongAudioRequest) MarshalJSON() ([]byte, error) { // SynthesizeSpeechRequest: The top-level message sent by the client for the // `SynthesizeSpeech` method. type SynthesizeSpeechRequest struct { - // AdvancedVoiceOptions: Adnanced voice options. + // AdvancedVoiceOptions: Advanced voice options. AdvancedVoiceOptions *AdvancedVoiceOptions `json:"advancedVoiceOptions,omitempty"` // AudioConfig: Required. The configuration of the synthesized audio. AudioConfig *AudioConfig `json:"audioConfig,omitempty"` @@ -820,6 +845,31 @@ func (s *Timepoint) UnmarshalJSON(data []byte) error { return nil } +// Turn: A Multi-speaker turn. +type Turn struct { + // Speaker: Required. The speaker of the turn, for example, 'O' or 'Q'. Please + // refer to documentation for available speakers. + Speaker string `json:"speaker,omitempty"` + // Text: Required. The text to speak. + Text string `json:"text,omitempty"` + // ForceSendFields is a list of field names (e.g. "Speaker") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Speaker") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s Turn) MarshalJSON() ([]byte, error) { + type NoMethod Turn + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Voice: Description of a voice supported by the TTS service. type Voice struct { // LanguageCodes: The languages that this voice supports, expressed as BCP-47 @@ -860,6 +910,28 @@ func (s Voice) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// VoiceCloneParams: The configuration of Voice Clone feature. +type VoiceCloneParams struct { + // VoiceCloningKey: Required. Created by GenerateVoiceCloningKey. + VoiceCloningKey string `json:"voiceCloningKey,omitempty"` + // ForceSendFields is a list of field names (e.g. "VoiceCloningKey") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "VoiceCloningKey") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s VoiceCloneParams) MarshalJSON() ([]byte, error) { + type NoMethod VoiceCloneParams + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // VoiceSelectionParams: Description of which voice to use for a synthesis // request. type VoiceSelectionParams struct { @@ -899,6 +971,10 @@ type VoiceSelectionParams struct { // "FEMALE" - A female voice. // "NEUTRAL" - A gender-neutral voice. This voice is not yet supported. SsmlGender string `json:"ssmlGender,omitempty"` + // VoiceClone: Optional. The configuration for a voice clone. If + // [VoiceCloneParams.voice_clone_key] is set, the service will choose the voice + // clone matching the specified configuration. + VoiceClone *VoiceCloneParams `json:"voiceClone,omitempty"` // ForceSendFields is a list of field names (e.g. "CustomVoice") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See diff --git a/tpu/v2alpha1/tpu-api.json b/tpu/v2alpha1/tpu-api.json index 772f54bf3b4..847952bc847 100644 --- a/tpu/v2alpha1/tpu-api.json +++ b/tpu/v2alpha1/tpu-api.json @@ -965,7 +965,7 @@ } } }, - "revision": "20241009", + "revision": "20241017", "rootUrl": "https://tpu.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -1461,6 +1461,20 @@ "nodeIdPrefix": { "description": "Prefix of node_ids in case of multi-node request Should follow the `^[A-Za-z0-9_.~+%-]+$` regex format. If node_count = 3 and node_id_prefix = \"np\", node ids of nodes created will be \"np-0\", \"np-1\", \"np-2\". If this field is not provided we use queued_resource_id as the node_id_prefix.", "type": "string" + }, + "workloadType": { + "description": "Optional. The workload type for the multi-node request.", + "enum": [ + "WORKLOAD_TYPE_UNSPECIFIED", + "THROUGHPUT_OPTIMIZED", + "AVAILABILITY_OPTIMIZED" + ], + "enumDescriptions": [ + "Not specified.", + "All of the nodes are available most of the time. Recommended for training workloads.", + "Most of the nodes are available all of the time. Recommended for serving workloads." + ], + "type": "string" } }, "type": "object" diff --git a/tpu/v2alpha1/tpu-gen.go b/tpu/v2alpha1/tpu-gen.go index ac9aba7fcb9..8531f8c2eda 100644 --- a/tpu/v2alpha1/tpu-gen.go +++ b/tpu/v2alpha1/tpu-gen.go @@ -929,6 +929,15 @@ type MultiNodeParams struct { // "np-2". If this field is not provided we use queued_resource_id as the // node_id_prefix. NodeIdPrefix string `json:"nodeIdPrefix,omitempty"` + // WorkloadType: Optional. The workload type for the multi-node request. + // + // Possible values: + // "WORKLOAD_TYPE_UNSPECIFIED" - Not specified. + // "THROUGHPUT_OPTIMIZED" - All of the nodes are available most of the time. + // Recommended for training workloads. + // "AVAILABILITY_OPTIMIZED" - Most of the nodes are available all of the + // time. Recommended for serving workloads. + WorkloadType string `json:"workloadType,omitempty"` // ForceSendFields is a list of field names (e.g. "NodeCount") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See diff --git a/transport/grpc/dial.go b/transport/grpc/dial.go index ff3539d898f..22940678d26 100644 --- a/transport/grpc/dial.go +++ b/transport/grpc/dial.go @@ -229,6 +229,7 @@ func dialPoolNewAuth(ctx context.Context, secure bool, poolSize int, ds *interna GRPCDialOpts: prepareDialOptsNewAuth(ds), PoolSize: poolSize, Credentials: creds, + ClientCertProvider: ds.ClientCertSource, APIKey: ds.APIKey, DetectOpts: &credentials.DetectOptions{ Scopes: ds.Scopes, diff --git a/travelimpactmodel/v1/travelimpactmodel-api.json b/travelimpactmodel/v1/travelimpactmodel-api.json index 29eb1f3d632..e2c075395d1 100644 --- a/travelimpactmodel/v1/travelimpactmodel-api.json +++ b/travelimpactmodel/v1/travelimpactmodel-api.json @@ -116,7 +116,7 @@ } } }, - "revision": "20231011", + "revision": "20241027", "rootUrl": "https://travelimpactmodel.googleapis.com/", "schemas": { "ComputeFlightEmissionsRequest": { @@ -234,7 +234,7 @@ "properties": { "emissionsGramsPerPax": { "$ref": "EmissionsGramsPerPax", - "description": "Optional. Per-passenger emission estimate numbers. Will not be present if emissions could not be computed. For the list of reasons why emissions could not be computed, see ComputeFlightEmissions. Note this field is currently equivalent to ttw_emissions_grams_per_pax until TIM version 1.X.0 which will update this to be total wtw emissions aka wtt_emissions_grams_per_pax + ttw_emissions_grams_per_pax." + "description": "Optional. Per-passenger emission estimate numbers. Will not be present if emissions could not be computed. For the list of reasons why emissions could not be computed, see ComputeFlightEmissions. This field uses wtw emissions aka ttw_emissions_grams_per_pax + wtt_emissions_grams_per_pax." }, "flight": { "$ref": "Flight", diff --git a/travelimpactmodel/v1/travelimpactmodel-gen.go b/travelimpactmodel/v1/travelimpactmodel-gen.go index 305bf90b84e..22b87768e3e 100644 --- a/travelimpactmodel/v1/travelimpactmodel-gen.go +++ b/travelimpactmodel/v1/travelimpactmodel-gen.go @@ -314,9 +314,8 @@ type FlightWithEmissions struct { // EmissionsGramsPerPax: Optional. Per-passenger emission estimate numbers. // Will not be present if emissions could not be computed. For the list of // reasons why emissions could not be computed, see ComputeFlightEmissions. - // Note this field is currently equivalent to ttw_emissions_grams_per_pax until - // TIM version 1.X.0 which will update this to be total wtw emissions aka - // wtt_emissions_grams_per_pax + ttw_emissions_grams_per_pax. + // This field uses wtw emissions aka ttw_emissions_grams_per_pax + + // wtt_emissions_grams_per_pax. EmissionsGramsPerPax *EmissionsGramsPerPax `json:"emissionsGramsPerPax,omitempty"` // Flight: Required. Matches the flight identifiers in the request. Note: all // IATA codes are capitalized. diff --git a/walletobjects/v1/walletobjects-api.json b/walletobjects/v1/walletobjects-api.json index fc9522e9d69..cb8d5f1d1cd 100644 --- a/walletobjects/v1/walletobjects-api.json +++ b/walletobjects/v1/walletobjects-api.json @@ -2681,7 +2681,7 @@ } } }, - "revision": "20241017", + "revision": "20241024", "rootUrl": "https://walletobjects.googleapis.com/", "schemas": { "ActivationOptions": { @@ -5378,6 +5378,7 @@ "GENERIC_HOME_INSURANCE", "GENERIC_ENTRY_TICKET", "GENERIC_RECEIPT", + "GENERIC_LOYALTY_CARD", "GENERIC_OTHER" ], "enumDescriptions": [ @@ -5393,6 +5394,7 @@ "Home-insurance cards", "Entry tickets", "Receipts", + "Loyalty cards. Please note that it is advisable to use a dedicated Loyalty card pass type instead of this generic type. A dedicated loyalty card pass type offers more features and functionality than a generic pass type.", "Other type" ], "type": "string" diff --git a/walletobjects/v1/walletobjects-gen.go b/walletobjects/v1/walletobjects-gen.go index 26a9a6dbe0b..6ac0d76d2a3 100644 --- a/walletobjects/v1/walletobjects-gen.go +++ b/walletobjects/v1/walletobjects-gen.go @@ -3330,6 +3330,10 @@ type GenericObject struct { // "GENERIC_HOME_INSURANCE" - Home-insurance cards // "GENERIC_ENTRY_TICKET" - Entry tickets // "GENERIC_RECEIPT" - Receipts + // "GENERIC_LOYALTY_CARD" - Loyalty cards. Please note that it is advisable + // to use a dedicated Loyalty card pass type instead of this generic type. A + // dedicated loyalty card pass type offers more features and functionality than + // a generic pass type. // "GENERIC_OTHER" - Other type GenericType string `json:"genericType,omitempty"` // GroupingInfo: Information that controls how passes are grouped together. diff --git a/workloadmanager/v1/workloadmanager-api.json b/workloadmanager/v1/workloadmanager-api.json index 65d138bffc9..50303bde227 100644 --- a/workloadmanager/v1/workloadmanager-api.json +++ b/workloadmanager/v1/workloadmanager-api.json @@ -772,7 +772,7 @@ } } }, - "revision": "20241009", + "revision": "20241016", "rootUrl": "https://workloadmanager.googleapis.com/", "schemas": { "AgentCommand": { @@ -793,42 +793,6 @@ }, "type": "object" }, - "AssetLocation": { - "description": "Provides the mapping of a cloud asset to a direct physical location or to a proxy that defines the location on its behalf.", - "id": "AssetLocation", - "properties": { - "ccfeRmsPath": { - "description": "Spanner path of the CCFE RMS database. It is only applicable for CCFE tenants that use CCFE RMS for storing resource metadata.", - "type": "string" - }, - "expected": { - "$ref": "IsolationExpectations", - "description": "Defines the customer expectation around ZI/ZS for this asset and ZI/ZS state of the region at the time of asset creation." - }, - "extraParameters": { - "description": "Defines extra parameters required for specific asset types.", - "items": { - "$ref": "ExtraParameter" - }, - "type": "array" - }, - "locationData": { - "description": "Contains all kinds of physical location definitions for this asset.", - "items": { - "$ref": "LocationData" - }, - "type": "array" - }, - "parentAsset": { - "description": "Defines parents assets if any in order to allow later generation of child_asset_location data via child assets.", - "items": { - "$ref": "CloudAsset" - }, - "type": "array" - } - }, - "type": "object" - }, "BigQueryDestination": { "description": "Message describing big query destination", "id": "BigQueryDestination", @@ -844,49 +808,12 @@ }, "type": "object" }, - "BlobstoreLocation": { - "description": "Policy ID that identified data placement in Blobstore as per go/blobstore-user-guide#data-metadata-placement-and-failure-domains", - "id": "BlobstoreLocation", - "properties": { - "policyId": { - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "CancelOperationRequest": { "description": "The request message for Operations.CancelOperation.", "id": "CancelOperationRequest", "properties": {}, "type": "object" }, - "CloudAsset": { - "id": "CloudAsset", - "properties": { - "assetName": { - "type": "string" - }, - "assetType": { - "type": "string" - } - }, - "type": "object" - }, - "CloudAssetComposition": { - "id": "CloudAssetComposition", - "properties": { - "childAsset": { - "items": { - "$ref": "CloudAsset" - }, - "type": "array" - } - }, - "type": "object" - }, "Command": { "description": "* Command specifies the type of command to execute.", "id": "Command", @@ -902,18 +829,6 @@ }, "type": "object" }, - "DirectLocationAssignment": { - "id": "DirectLocationAssignment", - "properties": { - "location": { - "items": { - "$ref": "LocationAssignment" - }, - "type": "array" - } - }, - "type": "object" - }, "Empty": { "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", "id": "Empty", @@ -1029,6 +944,14 @@ "description": "The name of execution resource. The format is projects/{project}/locations/{location}/evaluations/{evaluation}/executions/{execution}", "type": "string" }, + "notices": { + "description": "Output only. Additional information generated by the execution", + "items": { + "$ref": "Notice" + }, + "readOnly": true, + "type": "array" + }, "ruleResults": { "description": "Output only. execution result summary per rule", "items": { @@ -1160,17 +1083,6 @@ }, "type": "object" }, - "ExtraParameter": { - "description": "Defines parameters that should only be used for specific asset types.", - "id": "ExtraParameter", - "properties": { - "regionalMigDistributionPolicy": { - "$ref": "RegionalMigDistributionPolicy", - "description": "Details about zones used by regional compute.googleapis.com/InstanceGroupManager to create instances." - } - }, - "type": "object" - }, "GceInstanceFilter": { "description": "Message describing compute engine instance filter", "id": "GceInstanceFilter", @@ -1214,131 +1126,6 @@ }, "type": "object" }, - "IsolationExpectations": { - "id": "IsolationExpectations", - "properties": { - "requirementOverride": { - "$ref": "RequirementOverride", - "description": "Explicit overrides for ZI and ZS requirements to be used for resources that should be excluded from ZI/ZS verification logic." - }, - "ziOrgPolicy": { - "enum": [ - "ZI_UNSPECIFIED", - "ZI_UNKNOWN", - "ZI_NOT_REQUIRED", - "ZI_PREFERRED", - "ZI_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "", - "" - ], - "type": "string" - }, - "ziRegionPolicy": { - "enum": [ - "ZI_REGION_POLICY_UNSPECIFIED", - "ZI_REGION_POLICY_UNKNOWN", - "ZI_REGION_POLICY_NOT_SET", - "ZI_REGION_POLICY_FAIL_OPEN", - "ZI_REGION_POLICY_FAIL_CLOSED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "", - "" - ], - "type": "string" - }, - "ziRegionState": { - "enum": [ - "ZI_REGION_UNSPECIFIED", - "ZI_REGION_UNKNOWN", - "ZI_REGION_NOT_ENABLED", - "ZI_REGION_ENABLED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "" - ], - "type": "string" - }, - "zoneIsolation": { - "deprecated": true, - "description": "Deprecated: use zi_org_policy, zi_region_policy and zi_region_state instead for setting ZI expectations as per go/zicy-publish-physical-location.", - "enum": [ - "ZI_UNSPECIFIED", - "ZI_UNKNOWN", - "ZI_NOT_REQUIRED", - "ZI_PREFERRED", - "ZI_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "", - "" - ], - "type": "string" - }, - "zoneSeparation": { - "deprecated": true, - "description": "Deprecated: use zs_org_policy, and zs_region_stateinstead for setting Zs expectations as per go/zicy-publish-physical-location.", - "enum": [ - "ZS_UNSPECIFIED", - "ZS_UNKNOWN", - "ZS_NOT_REQUIRED", - "ZS_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "" - ], - "type": "string" - }, - "zsOrgPolicy": { - "enum": [ - "ZS_UNSPECIFIED", - "ZS_UNKNOWN", - "ZS_NOT_REQUIRED", - "ZS_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "" - ], - "type": "string" - }, - "zsRegionState": { - "enum": [ - "ZS_REGION_UNSPECIFIED", - "ZS_REGION_UNKNOWN", - "ZS_REGION_NOT_ENABLED", - "ZS_REGION_ENABLED" - ], - "enumDescriptions": [ - "", - "To be used if tracking of the asset ZS-bit is not available", - "", - "" - ], - "type": "string" - } - }, - "type": "object" - }, "ListEvaluationsResponse": { "description": "Message for response to listing Evaluations", "id": "ListEvaluationsResponse", @@ -1513,64 +1300,18 @@ }, "type": "object" }, - "LocationAssignment": { - "id": "LocationAssignment", + "Notice": { + "description": "Message for additional information generated by the execution", + "id": "Notice", "properties": { - "location": { - "type": "string" - }, - "locationType": { - "enum": [ - "UNSPECIFIED", - "CLUSTER", - "POP", - "CLOUD_ZONE", - "CLOUD_REGION", - "MULTI_REGION_GEO", - "MULTI_REGION_JURISDICTION", - "GLOBAL", - "OTHER" - ], - "enumDescriptions": [ - "", - "1-10: Physical failure domains.", - "", - "11-20: Logical failure domains.", - "", - "", - "", - "", - "" - ], + "message": { + "description": "Output only. Message of the notice", + "readOnly": true, "type": "string" } }, "type": "object" }, - "LocationData": { - "id": "LocationData", - "properties": { - "blobstoreLocation": { - "$ref": "BlobstoreLocation" - }, - "childAssetLocation": { - "$ref": "CloudAssetComposition" - }, - "directLocation": { - "$ref": "DirectLocationAssignment" - }, - "gcpProjectProxy": { - "$ref": "TenantProjectProxy" - }, - "placerLocation": { - "$ref": "PlacerLocation" - }, - "spannerLocation": { - "$ref": "SpannerLocation" - } - }, - "type": "object" - }, "Operation": { "description": "This resource represents a long-running operation that is the result of a network API call.", "id": "Operation", @@ -1650,74 +1391,6 @@ }, "type": "object" }, - "PlacerLocation": { - "description": "Message describing that the location of the customer resource is tied to placer allocations", - "id": "PlacerLocation", - "properties": { - "placerConfig": { - "description": "Directory with a config related to it in placer (e.g. \"/placer/prod/home/my-root/my-dir\")", - "type": "string" - } - }, - "type": "object" - }, - "RegionalMigDistributionPolicy": { - "description": "To be used for specifying the intended distribution of regional compute.googleapis.com/InstanceGroupManager instances", - "id": "RegionalMigDistributionPolicy", - "properties": { - "targetShape": { - "description": "The shape in which the group converges around distribution of resources. Instance of proto2 enum", - "format": "int32", - "type": "integer" - }, - "zones": { - "description": "Cloud zones used by regional MIG to create instances.", - "items": { - "$ref": "ZoneConfiguration" - }, - "type": "array" - } - }, - "type": "object" - }, - "RequirementOverride": { - "id": "RequirementOverride", - "properties": { - "ziOverride": { - "enum": [ - "ZI_UNSPECIFIED", - "ZI_UNKNOWN", - "ZI_NOT_REQUIRED", - "ZI_PREFERRED", - "ZI_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "", - "" - ], - "type": "string" - }, - "zsOverride": { - "enum": [ - "ZS_UNSPECIFIED", - "ZS_UNKNOWN", - "ZS_NOT_REQUIRED", - "ZS_REQUIRED" - ], - "enumDescriptions": [ - "", - "To be used if tracking is not available", - "", - "" - ], - "type": "string" - } - }, - "type": "object" - }, "Resource": { "description": "Message represent resource in execution result", "id": "Resource", @@ -2452,26 +2125,6 @@ }, "type": "object" }, - "SpannerLocation": { - "id": "SpannerLocation", - "properties": { - "backupName": { - "description": "Set of backups used by the resource with name in the same format as what is available at http://table/spanner_automon.backup_metadata", - "items": { - "type": "string" - }, - "type": "array" - }, - "dbName": { - "description": "Set of databases used by the resource in format /span//", - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "SqlserverValidation": { "description": "A presentation of SQLServer workload insight. The schema of SqlServer workloads validation related data.", "id": "SqlserverValidation", @@ -2587,18 +2240,6 @@ }, "type": "object" }, - "TenantProjectProxy": { - "id": "TenantProjectProxy", - "properties": { - "projectNumbers": { - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "ViolationDetails": { "description": "Message describing the violation in an evaluation result.", "id": "ViolationDetails", @@ -2645,15 +2286,6 @@ "id": "WriteInsightResponse", "properties": {}, "type": "object" - }, - "ZoneConfiguration": { - "id": "ZoneConfiguration", - "properties": { - "zone": { - "type": "string" - } - }, - "type": "object" } }, "servicePath": "", diff --git a/workloadmanager/v1/workloadmanager-gen.go b/workloadmanager/v1/workloadmanager-gen.go index 7d87e4d9514..80f298b2daf 100644 --- a/workloadmanager/v1/workloadmanager-gen.go +++ b/workloadmanager/v1/workloadmanager-gen.go @@ -286,41 +286,6 @@ func (s AgentCommand) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// AssetLocation: Provides the mapping of a cloud asset to a direct physical -// location or to a proxy that defines the location on its behalf. -type AssetLocation struct { - // CcfeRmsPath: Spanner path of the CCFE RMS database. It is only applicable - // for CCFE tenants that use CCFE RMS for storing resource metadata. - CcfeRmsPath string `json:"ccfeRmsPath,omitempty"` - // Expected: Defines the customer expectation around ZI/ZS for this asset and - // ZI/ZS state of the region at the time of asset creation. - Expected *IsolationExpectations `json:"expected,omitempty"` - // ExtraParameters: Defines extra parameters required for specific asset types. - ExtraParameters []*ExtraParameter `json:"extraParameters,omitempty"` - // LocationData: Contains all kinds of physical location definitions for this - // asset. - LocationData []*LocationData `json:"locationData,omitempty"` - // ParentAsset: Defines parents assets if any in order to allow later - // generation of child_asset_location data via child assets. - ParentAsset []*CloudAsset `json:"parentAsset,omitempty"` - // ForceSendFields is a list of field names (e.g. "CcfeRmsPath") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "CcfeRmsPath") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s AssetLocation) MarshalJSON() ([]byte, error) { - type NoMethod AssetLocation - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // BigQueryDestination: Message describing big query destination type BigQueryDestination struct { // CreateNewResultsTable: Optional. determine if results will be saved in a new @@ -346,73 +311,10 @@ func (s BigQueryDestination) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// BlobstoreLocation: Policy ID that identified data placement in Blobstore as -// per go/blobstore-user-guide#data-metadata-placement-and-failure-domains -type BlobstoreLocation struct { - PolicyId []string `json:"policyId,omitempty"` - // ForceSendFields is a list of field names (e.g. "PolicyId") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "PolicyId") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s BlobstoreLocation) MarshalJSON() ([]byte, error) { - type NoMethod BlobstoreLocation - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // CancelOperationRequest: The request message for Operations.CancelOperation. type CancelOperationRequest struct { } -type CloudAsset struct { - AssetName string `json:"assetName,omitempty"` - AssetType string `json:"assetType,omitempty"` - // ForceSendFields is a list of field names (e.g. "AssetName") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "AssetName") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s CloudAsset) MarshalJSON() ([]byte, error) { - type NoMethod CloudAsset - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -type CloudAssetComposition struct { - ChildAsset []*CloudAsset `json:"childAsset,omitempty"` - // ForceSendFields is a list of field names (e.g. "ChildAsset") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ChildAsset") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s CloudAssetComposition) MarshalJSON() ([]byte, error) { - type NoMethod CloudAssetComposition - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // Command: * Command specifies the type of command to execute. type Command struct { // AgentCommand: AgentCommand specifies a one-time executable program for the @@ -438,26 +340,6 @@ func (s Command) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type DirectLocationAssignment struct { - Location []*LocationAssignment `json:"location,omitempty"` - // ForceSendFields is a list of field names (e.g. "Location") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Location") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s DirectLocationAssignment) MarshalJSON() ([]byte, error) { - type NoMethod DirectLocationAssignment - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // Empty: A generic empty message that you can re-use to avoid defining // duplicated empty messages in your APIs. A typical example is to use it as // the request or the response type of an API method. For instance: service Foo @@ -533,6 +415,8 @@ type Execution struct { // projects/{project}/locations/{location}/evaluations/{evaluation}/executions/{ // execution} Name string `json:"name,omitempty"` + // Notices: Output only. Additional information generated by the execution + Notices []*Notice `json:"notices,omitempty"` // RuleResults: Output only. execution result summary per rule RuleResults []*RuleExecutionResult `json:"ruleResults,omitempty"` // RunType: type represent whether the execution executed directly by user or @@ -652,30 +536,6 @@ func (s ExternalDataSources) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// ExtraParameter: Defines parameters that should only be used for specific -// asset types. -type ExtraParameter struct { - // RegionalMigDistributionPolicy: Details about zones used by regional - // compute.googleapis.com/InstanceGroupManager to create instances. - RegionalMigDistributionPolicy *RegionalMigDistributionPolicy `json:"regionalMigDistributionPolicy,omitempty"` - // ForceSendFields is a list of field names (e.g. - // "RegionalMigDistributionPolicy") to unconditionally include in API requests. - // By default, fields with empty or default values are omitted from API - // requests. See https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields - // for more details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "RegionalMigDistributionPolicy") - // to include in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s ExtraParameter) MarshalJSON() ([]byte, error) { - type NoMethod ExtraParameter - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GceInstanceFilter: Message describing compute engine instance filter type GceInstanceFilter struct { // ServiceAccounts: Service account of compute engine @@ -730,81 +590,6 @@ func (s Insight) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type IsolationExpectations struct { - // RequirementOverride: Explicit overrides for ZI and ZS requirements to be - // used for resources that should be excluded from ZI/ZS verification logic. - RequirementOverride *RequirementOverride `json:"requirementOverride,omitempty"` - // Possible values: - // "ZI_UNSPECIFIED" - // "ZI_UNKNOWN" - To be used if tracking is not available - // "ZI_NOT_REQUIRED" - // "ZI_PREFERRED" - // "ZI_REQUIRED" - ZiOrgPolicy string `json:"ziOrgPolicy,omitempty"` - // Possible values: - // "ZI_REGION_POLICY_UNSPECIFIED" - // "ZI_REGION_POLICY_UNKNOWN" - To be used if tracking is not available - // "ZI_REGION_POLICY_NOT_SET" - // "ZI_REGION_POLICY_FAIL_OPEN" - // "ZI_REGION_POLICY_FAIL_CLOSED" - ZiRegionPolicy string `json:"ziRegionPolicy,omitempty"` - // Possible values: - // "ZI_REGION_UNSPECIFIED" - // "ZI_REGION_UNKNOWN" - To be used if tracking is not available - // "ZI_REGION_NOT_ENABLED" - // "ZI_REGION_ENABLED" - ZiRegionState string `json:"ziRegionState,omitempty"` - // ZoneIsolation: Deprecated: use zi_org_policy, zi_region_policy and - // zi_region_state instead for setting ZI expectations as per - // go/zicy-publish-physical-location. - // - // Possible values: - // "ZI_UNSPECIFIED" - // "ZI_UNKNOWN" - To be used if tracking is not available - // "ZI_NOT_REQUIRED" - // "ZI_PREFERRED" - // "ZI_REQUIRED" - ZoneIsolation string `json:"zoneIsolation,omitempty"` - // ZoneSeparation: Deprecated: use zs_org_policy, and zs_region_stateinstead - // for setting Zs expectations as per go/zicy-publish-physical-location. - // - // Possible values: - // "ZS_UNSPECIFIED" - // "ZS_UNKNOWN" - To be used if tracking is not available - // "ZS_NOT_REQUIRED" - // "ZS_REQUIRED" - ZoneSeparation string `json:"zoneSeparation,omitempty"` - // Possible values: - // "ZS_UNSPECIFIED" - // "ZS_UNKNOWN" - To be used if tracking is not available - // "ZS_NOT_REQUIRED" - // "ZS_REQUIRED" - ZsOrgPolicy string `json:"zsOrgPolicy,omitempty"` - // Possible values: - // "ZS_REGION_UNSPECIFIED" - // "ZS_REGION_UNKNOWN" - To be used if tracking of the asset ZS-bit is not - // available - // "ZS_REGION_NOT_ENABLED" - // "ZS_REGION_ENABLED" - ZsRegionState string `json:"zsRegionState,omitempty"` - // ForceSendFields is a list of field names (e.g. "RequirementOverride") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "RequirementOverride") to include - // in API requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s IsolationExpectations) MarshalJSON() ([]byte, error) { - type NoMethod IsolationExpectations - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // ListEvaluationsResponse: Message for response to listing Evaluations type ListEvaluationsResponse struct { // Evaluations: The list of Evaluation @@ -1043,59 +828,25 @@ func (s Location) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type LocationAssignment struct { - Location string `json:"location,omitempty"` - // Possible values: - // "UNSPECIFIED" - // "CLUSTER" - 1-10: Physical failure domains. - // "POP" - // "CLOUD_ZONE" - 11-20: Logical failure domains. - // "CLOUD_REGION" - // "MULTI_REGION_GEO" - // "MULTI_REGION_JURISDICTION" - // "GLOBAL" - // "OTHER" - LocationType string `json:"locationType,omitempty"` - // ForceSendFields is a list of field names (e.g. "Location") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See +// Notice: Message for additional information generated by the execution +type Notice struct { + // Message: Output only. Message of the notice + Message string `json:"message,omitempty"` + // ForceSendFields is a list of field names (e.g. "Message") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Location") to include in API + // NullFields is a list of field names (e.g. "Message") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s LocationAssignment) MarshalJSON() ([]byte, error) { - type NoMethod LocationAssignment - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -type LocationData struct { - BlobstoreLocation *BlobstoreLocation `json:"blobstoreLocation,omitempty"` - ChildAssetLocation *CloudAssetComposition `json:"childAssetLocation,omitempty"` - DirectLocation *DirectLocationAssignment `json:"directLocation,omitempty"` - GcpProjectProxy *TenantProjectProxy `json:"gcpProjectProxy,omitempty"` - PlacerLocation *PlacerLocation `json:"placerLocation,omitempty"` - SpannerLocation *SpannerLocation `json:"spannerLocation,omitempty"` - // ForceSendFields is a list of field names (e.g. "BlobstoreLocation") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "BlobstoreLocation") to include in - // API requests with the JSON null value. By default, fields with empty values - // are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s LocationData) MarshalJSON() ([]byte, error) { - type NoMethod LocationData +func (s Notice) MarshalJSON() ([]byte, error) { + type NoMethod Notice return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } @@ -1184,89 +935,6 @@ func (s OperationMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// PlacerLocation: Message describing that the location of the customer -// resource is tied to placer allocations -type PlacerLocation struct { - // PlacerConfig: Directory with a config related to it in placer (e.g. - // "/placer/prod/home/my-root/my-dir") - PlacerConfig string `json:"placerConfig,omitempty"` - // ForceSendFields is a list of field names (e.g. "PlacerConfig") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "PlacerConfig") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s PlacerLocation) MarshalJSON() ([]byte, error) { - type NoMethod PlacerLocation - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// RegionalMigDistributionPolicy: To be used for specifying the intended -// distribution of regional compute.googleapis.com/InstanceGroupManager -// instances -type RegionalMigDistributionPolicy struct { - // TargetShape: The shape in which the group converges around distribution of - // resources. Instance of proto2 enum - TargetShape int64 `json:"targetShape,omitempty"` - // Zones: Cloud zones used by regional MIG to create instances. - Zones []*ZoneConfiguration `json:"zones,omitempty"` - // ForceSendFields is a list of field names (e.g. "TargetShape") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "TargetShape") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s RegionalMigDistributionPolicy) MarshalJSON() ([]byte, error) { - type NoMethod RegionalMigDistributionPolicy - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -type RequirementOverride struct { - // Possible values: - // "ZI_UNSPECIFIED" - // "ZI_UNKNOWN" - To be used if tracking is not available - // "ZI_NOT_REQUIRED" - // "ZI_PREFERRED" - // "ZI_REQUIRED" - ZiOverride string `json:"ziOverride,omitempty"` - // Possible values: - // "ZS_UNSPECIFIED" - // "ZS_UNKNOWN" - To be used if tracking is not available - // "ZS_NOT_REQUIRED" - // "ZS_REQUIRED" - ZsOverride string `json:"zsOverride,omitempty"` - // ForceSendFields is a list of field names (e.g. "ZiOverride") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ZiOverride") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s RequirementOverride) MarshalJSON() ([]byte, error) { - type NoMethod RequirementOverride - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // Resource: Message represent resource in execution result type Resource struct { // Name: The name of the resource. @@ -2021,30 +1689,6 @@ func (s ShellCommand) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type SpannerLocation struct { - // BackupName: Set of backups used by the resource with name in the same format - // as what is available at http://table/spanner_automon.backup_metadata - BackupName []string `json:"backupName,omitempty"` - // DbName: Set of databases used by the resource in format /span// - DbName []string `json:"dbName,omitempty"` - // ForceSendFields is a list of field names (e.g. "BackupName") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "BackupName") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s SpannerLocation) MarshalJSON() ([]byte, error) { - type NoMethod SpannerLocation - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // SqlserverValidation: A presentation of SQLServer workload insight. The // schema of SqlServer workloads validation related data. type SqlserverValidation struct { @@ -2176,26 +1820,6 @@ func (s Status) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type TenantProjectProxy struct { - ProjectNumbers []string `json:"projectNumbers,omitempty"` - // ForceSendFields is a list of field names (e.g. "ProjectNumbers") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ProjectNumbers") to include in - // API requests with the JSON null value. By default, fields with empty values - // are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s TenantProjectProxy) MarshalJSON() ([]byte, error) { - type NoMethod TenantProjectProxy - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // ViolationDetails: Message describing the violation in an evaluation result. type ViolationDetails struct { // Asset: The name of the asset. @@ -2264,26 +1888,6 @@ type WriteInsightResponse struct { googleapi.ServerResponse `json:"-"` } -type ZoneConfiguration struct { - Zone string `json:"zone,omitempty"` - // ForceSendFields is a list of field names (e.g. "Zone") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Zone") to include in API requests - // with the JSON null value. By default, fields with empty values are omitted - // from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s ZoneConfiguration) MarshalJSON() ([]byte, error) { - type NoMethod ZoneConfiguration - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - type ProjectsLocationsGetCall struct { s *Service name string diff --git a/workspaceevents/v1/workspaceevents-api.json b/workspaceevents/v1/workspaceevents-api.json index 4b38496ec7b..25e99f8f3b5 100644 --- a/workspaceevents/v1/workspaceevents-api.json +++ b/workspaceevents/v1/workspaceevents-api.json @@ -29,6 +29,21 @@ "https://www.googleapis.com/auth/chat.spaces.readonly": { "description": "View chat and spaces in Google Chat" }, + "https://www.googleapis.com/auth/drive": { + "description": "See, edit, create, and delete all of your Google Drive files" + }, + "https://www.googleapis.com/auth/drive.file": { + "description": "See, edit, create, and delete only the specific Google Drive files you use with this app" + }, + "https://www.googleapis.com/auth/drive.metadata": { + "description": "View and manage metadata of files in your Google Drive" + }, + "https://www.googleapis.com/auth/drive.metadata.readonly": { + "description": "See information about your Google Drive files" + }, + "https://www.googleapis.com/auth/drive.readonly": { + "description": "See and download all your Google Drive files" + }, "https://www.googleapis.com/auth/meetings.space.created": { "description": "Create, edit, and see information about your Google Meet conferences created by the app." }, @@ -168,6 +183,11 @@ "https://www.googleapis.com/auth/chat.messages.readonly", "https://www.googleapis.com/auth/chat.spaces", "https://www.googleapis.com/auth/chat.spaces.readonly", + "https://www.googleapis.com/auth/drive", + "https://www.googleapis.com/auth/drive.file", + "https://www.googleapis.com/auth/drive.metadata", + "https://www.googleapis.com/auth/drive.metadata.readonly", + "https://www.googleapis.com/auth/drive.readonly", "https://www.googleapis.com/auth/meetings.space.created", "https://www.googleapis.com/auth/meetings.space.readonly" ] @@ -205,6 +225,11 @@ "https://www.googleapis.com/auth/chat.messages.readonly", "https://www.googleapis.com/auth/chat.spaces", "https://www.googleapis.com/auth/chat.spaces.readonly", + "https://www.googleapis.com/auth/drive", + "https://www.googleapis.com/auth/drive.file", + "https://www.googleapis.com/auth/drive.metadata", + "https://www.googleapis.com/auth/drive.metadata.readonly", + "https://www.googleapis.com/auth/drive.readonly", "https://www.googleapis.com/auth/meetings.space.created", "https://www.googleapis.com/auth/meetings.space.readonly" ] @@ -255,6 +280,11 @@ "https://www.googleapis.com/auth/chat.messages.readonly", "https://www.googleapis.com/auth/chat.spaces", "https://www.googleapis.com/auth/chat.spaces.readonly", + "https://www.googleapis.com/auth/drive", + "https://www.googleapis.com/auth/drive.file", + "https://www.googleapis.com/auth/drive.metadata", + "https://www.googleapis.com/auth/drive.metadata.readonly", + "https://www.googleapis.com/auth/drive.readonly", "https://www.googleapis.com/auth/meetings.space.created", "https://www.googleapis.com/auth/meetings.space.readonly" ] @@ -290,6 +320,11 @@ "https://www.googleapis.com/auth/chat.messages.readonly", "https://www.googleapis.com/auth/chat.spaces", "https://www.googleapis.com/auth/chat.spaces.readonly", + "https://www.googleapis.com/auth/drive", + "https://www.googleapis.com/auth/drive.file", + "https://www.googleapis.com/auth/drive.metadata", + "https://www.googleapis.com/auth/drive.metadata.readonly", + "https://www.googleapis.com/auth/drive.readonly", "https://www.googleapis.com/auth/meetings.space.created", "https://www.googleapis.com/auth/meetings.space.readonly" ] @@ -332,6 +367,11 @@ "https://www.googleapis.com/auth/chat.messages.readonly", "https://www.googleapis.com/auth/chat.spaces", "https://www.googleapis.com/auth/chat.spaces.readonly", + "https://www.googleapis.com/auth/drive", + "https://www.googleapis.com/auth/drive.file", + "https://www.googleapis.com/auth/drive.metadata", + "https://www.googleapis.com/auth/drive.metadata.readonly", + "https://www.googleapis.com/auth/drive.readonly", "https://www.googleapis.com/auth/meetings.space.created", "https://www.googleapis.com/auth/meetings.space.readonly" ] @@ -380,12 +420,17 @@ "https://www.googleapis.com/auth/chat.messages.readonly", "https://www.googleapis.com/auth/chat.spaces", "https://www.googleapis.com/auth/chat.spaces.readonly", + "https://www.googleapis.com/auth/drive", + "https://www.googleapis.com/auth/drive.file", + "https://www.googleapis.com/auth/drive.metadata", + "https://www.googleapis.com/auth/drive.metadata.readonly", + "https://www.googleapis.com/auth/drive.readonly", "https://www.googleapis.com/auth/meetings.space.created", "https://www.googleapis.com/auth/meetings.space.readonly" ] }, "reactivate": { - "description": "[Developer Preview](https://developers.google.com/workspace/preview): Reactivates a suspended Google Workspace subscription. This method resets your subscription's `State` field to `ACTIVE`. Before you use this method, you must fix the error that suspended the subscription. To learn how to use this method, see [Reactivate a Google Workspace subscription](https://developers.google.com/workspace/events/guides/reactivate-subscription).", + "description": "[Developer Preview](https://developers.google.com/workspace/preview): Reactivates a suspended Google Workspace subscription. This method resets your subscription's `State` field to `ACTIVE`. Before you use this method, you must fix the error that suspended the subscription. This method will ignore or reject any subscription that isn't currently in a suspended state. To learn how to use this method, see [Reactivate a Google Workspace subscription](https://developers.google.com/workspace/events/guides/reactivate-subscription).", "flatPath": "v1/subscriptions/{subscriptionsId}:reactivate", "httpMethod": "POST", "id": "workspaceevents.subscriptions.reactivate", @@ -417,6 +462,11 @@ "https://www.googleapis.com/auth/chat.messages.readonly", "https://www.googleapis.com/auth/chat.spaces", "https://www.googleapis.com/auth/chat.spaces.readonly", + "https://www.googleapis.com/auth/drive", + "https://www.googleapis.com/auth/drive.file", + "https://www.googleapis.com/auth/drive.metadata", + "https://www.googleapis.com/auth/drive.metadata.readonly", + "https://www.googleapis.com/auth/drive.readonly", "https://www.googleapis.com/auth/meetings.space.created", "https://www.googleapis.com/auth/meetings.space.readonly" ] @@ -424,7 +474,7 @@ } } }, - "revision": "20241008", + "revision": "20241027", "rootUrl": "https://workspaceevents.googleapis.com/", "schemas": { "ListSubscriptionsResponse": { diff --git a/workspaceevents/v1/workspaceevents-gen.go b/workspaceevents/v1/workspaceevents-gen.go index 8b36f74668f..14409d0e690 100644 --- a/workspaceevents/v1/workspaceevents-gen.go +++ b/workspaceevents/v1/workspaceevents-gen.go @@ -130,6 +130,22 @@ const ( // View chat and spaces in Google Chat ChatSpacesReadonlyScope = "https://www.googleapis.com/auth/chat.spaces.readonly" + // See, edit, create, and delete all of your Google Drive files + DriveScope = "https://www.googleapis.com/auth/drive" + + // See, edit, create, and delete only the specific Google Drive files you use + // with this app + DriveFileScope = "https://www.googleapis.com/auth/drive.file" + + // View and manage metadata of files in your Google Drive + DriveMetadataScope = "https://www.googleapis.com/auth/drive.metadata" + + // See information about your Google Drive files + DriveMetadataReadonlyScope = "https://www.googleapis.com/auth/drive.metadata.readonly" + + // See and download all your Google Drive files + DriveReadonlyScope = "https://www.googleapis.com/auth/drive.readonly" + // Create, edit, and see information about your Google Meet conferences created // by the app. MeetingsSpaceCreatedScope = "https://www.googleapis.com/auth/meetings.space.created" @@ -150,6 +166,11 @@ func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, err "https://www.googleapis.com/auth/chat.messages.readonly", "https://www.googleapis.com/auth/chat.spaces", "https://www.googleapis.com/auth/chat.spaces.readonly", + "https://www.googleapis.com/auth/drive", + "https://www.googleapis.com/auth/drive.file", + "https://www.googleapis.com/auth/drive.metadata", + "https://www.googleapis.com/auth/drive.metadata.readonly", + "https://www.googleapis.com/auth/drive.readonly", "https://www.googleapis.com/auth/meetings.space.created", "https://www.googleapis.com/auth/meetings.space.readonly", ) @@ -1268,8 +1289,9 @@ type SubscriptionsReactivateCall struct { // (https://developers.google.com/workspace/preview): Reactivates a suspended // Google Workspace subscription. This method resets your subscription's // `State` field to `ACTIVE`. Before you use this method, you must fix the -// error that suspended the subscription. To learn how to use this method, see -// Reactivate a Google Workspace subscription +// error that suspended the subscription. This method will ignore or reject any +// subscription that isn't currently in a suspended state. To learn how to use +// this method, see Reactivate a Google Workspace subscription // (https://developers.google.com/workspace/events/guides/reactivate-subscription). // // - name: Resource name of the subscription. Format: