diff --git a/admin/directory/v1/admin-api.json b/admin/directory/v1/admin-api.json index a52687760da..8647610cd09 100644 --- a/admin/directory/v1/admin-api.json +++ b/admin/directory/v1/admin-api.json @@ -15,10 +15,10 @@ "description": "View customer related information" }, "https://www.googleapis.com/auth/admin.directory.device.chromeos": { - "description": "View and manage your Chrome OS devices' metadata" + "description": "View and manage your ChromeOS devices' metadata" }, "https://www.googleapis.com/auth/admin.directory.device.chromeos.readonly": { - "description": "View your Chrome OS devices' metadata" + "description": "View your ChromeOS devices' metadata" }, "https://www.googleapis.com/auth/admin.directory.device.mobile": { "description": "View and manage your mobile devices' metadata" @@ -4671,7 +4671,7 @@ } } }, - "revision": "20240917", + "revision": "20240924", "rootUrl": "https://admin.googleapis.com/", "schemas": { "Alias": { diff --git a/admin/directory/v1/admin-gen.go b/admin/directory/v1/admin-gen.go index 10dcb7724c6..9bf1ef8eb95 100644 --- a/admin/directory/v1/admin-gen.go +++ b/admin/directory/v1/admin-gen.go @@ -113,10 +113,10 @@ const ( // View customer related information AdminDirectoryCustomerReadonlyScope = "https://www.googleapis.com/auth/admin.directory.customer.readonly" - // View and manage your Chrome OS devices' metadata + // View and manage your ChromeOS devices' metadata AdminDirectoryDeviceChromeosScope = "https://www.googleapis.com/auth/admin.directory.device.chromeos" - // View your Chrome OS devices' metadata + // View your ChromeOS devices' metadata AdminDirectoryDeviceChromeosReadonlyScope = "https://www.googleapis.com/auth/admin.directory.device.chromeos.readonly" // View and manage your mobile devices' metadata diff --git a/aiplatform/v1/aiplatform-api.json b/aiplatform/v1/aiplatform-api.json index 8ffd941f86d..4bbc9bdf737 100644 --- a/aiplatform/v1/aiplatform-api.json +++ b/aiplatform/v1/aiplatform-api.json @@ -17813,7 +17813,7 @@ } } }, - "revision": "20240916", + "revision": "20240923", "rootUrl": "https://aiplatform.googleapis.com/", "schemas": { "CloudAiLargeModelsVisionGenerateVideoResponse": { @@ -34947,6 +34947,10 @@ "description": "Whether the prompt dataset has prompt variable.", "type": "boolean" }, + "logprobs": { + "description": "Whether or not the user has enabled logit probabilities in the model parameters.", + "type": "boolean" + }, "maxOutputTokens": { "description": "Value of the maximum number of tokens generated set when the dataset was saved.", "format": "int64", @@ -34960,6 +34964,15 @@ "description": "Type of the prompt dataset.", "type": "string" }, + "seedEnabled": { + "description": "Seeding enables model to return a deterministic response on a best effort basis. Determinism isn't guaranteed. This field determines whether or not seeding is enabled.", + "type": "boolean" + }, + "seedValue": { + "description": "The actual value of the seed.", + "format": "int64", + "type": "string" + }, "stopSequences": { "description": "Customized stop sequences.", "items": { diff --git a/aiplatform/v1/aiplatform-gen.go b/aiplatform/v1/aiplatform-gen.go index 6f3f8e52248..f8d409dc734 100644 --- a/aiplatform/v1/aiplatform-gen.go +++ b/aiplatform/v1/aiplatform-gen.go @@ -25921,6 +25921,9 @@ type GoogleCloudAiplatformV1SchemaTextPromptDatasetMetadata struct { GroundingConfig *GoogleCloudAiplatformV1SchemaPredictParamsGroundingConfig `json:"groundingConfig,omitempty"` // HasPromptVariable: Whether the prompt dataset has prompt variable. HasPromptVariable bool `json:"hasPromptVariable,omitempty"` + // Logprobs: Whether or not the user has enabled logit probabilities in the + // model parameters. + Logprobs bool `json:"logprobs,omitempty"` // MaxOutputTokens: Value of the maximum number of tokens generated set when // the dataset was saved. MaxOutputTokens int64 `json:"maxOutputTokens,omitempty,string"` @@ -25928,6 +25931,12 @@ type GoogleCloudAiplatformV1SchemaTextPromptDatasetMetadata struct { Note string `json:"note,omitempty"` // PromptType: Type of the prompt dataset. PromptType string `json:"promptType,omitempty"` + // SeedEnabled: Seeding enables model to return a deterministic response on a + // best effort basis. Determinism isn't guaranteed. This field determines + // whether or not seeding is enabled. + SeedEnabled bool `json:"seedEnabled,omitempty"` + // SeedValue: The actual value of the seed. + SeedValue int64 `json:"seedValue,omitempty,string"` // StopSequences: Customized stop sequences. StopSequences []string `json:"stopSequences,omitempty"` // SystemInstruction: The content of the prompt dataset system instruction. diff --git a/androidmanagement/v1/androidmanagement-api.json b/androidmanagement/v1/androidmanagement-api.json index 656f948c90c..0009c215384 100644 --- a/androidmanagement/v1/androidmanagement-api.json +++ b/androidmanagement/v1/androidmanagement-api.json @@ -1168,7 +1168,7 @@ } } }, - "revision": "20240923", + "revision": "20240924", "rootUrl": "https://androidmanagement.googleapis.com/", "schemas": { "AdbShellCommandEvent": { @@ -2795,6 +2795,10 @@ ], "type": "string" }, + "wifiRoamingPolicy": { + "$ref": "WifiRoamingPolicy", + "description": "Optional. Wi-Fi roaming policy." + }, "wifiSsidPolicy": { "$ref": "WifiSsidPolicy", "description": "Restrictions on which Wi-Fi SSIDs the device can connect to. Note that this does not affect which networks can be configured on the device. Supported on company-owned devices running Android 13 and above." @@ -6600,6 +6604,45 @@ }, "type": "object" }, + "WifiRoamingPolicy": { + "description": "Wi-Fi roaming policy.", + "id": "WifiRoamingPolicy", + "properties": { + "wifiRoamingSettings": { + "description": "Optional. Wi-Fi roaming settings. SSIDs provided in this list must be unique, the policy will be rejected otherwise.", + "items": { + "$ref": "WifiRoamingSetting" + }, + "type": "array" + } + }, + "type": "object" + }, + "WifiRoamingSetting": { + "description": "Wi-Fi roaming setting.", + "id": "WifiRoamingSetting", + "properties": { + "wifiRoamingMode": { + "description": "Required. Wi-Fi roaming mode for the specified SSID.", + "enum": [ + "WIFI_ROAMING_MODE_UNSPECIFIED", + "WIFI_ROAMING_DEFAULT", + "WIFI_ROAMING_AGGRESSIVE" + ], + "enumDescriptions": [ + "Unspecified. Defaults to WIFI_ROAMING_DEFAULT.", + "Default Wi-Fi roaming mode of the device.", + "Aggressive roaming mode which allows quicker Wi-Fi roaming. Supported on Android 15 and above on fully managed devices and work profiles on company-owned devices. A nonComplianceDetail with MANAGEMENT_MODE is reported for other management modes. A nonComplianceDetail with API_LEVEL is reported if the Android version is less than 15. A nonComplianceDetail with DEVICE_INCOMPATIBLE is reported if the device does not support aggressive roaming mode." + ], + "type": "string" + }, + "wifiSsid": { + "description": "Required. SSID of the Wi-Fi network.", + "type": "string" + } + }, + "type": "object" + }, "WifiSsid": { "description": "Represents a Wi-Fi SSID.", "id": "WifiSsid", diff --git a/androidmanagement/v1/androidmanagement-gen.go b/androidmanagement/v1/androidmanagement-gen.go index 8c8576a9aab..a8ddc14a020 100644 --- a/androidmanagement/v1/androidmanagement-gen.go +++ b/androidmanagement/v1/androidmanagement-gen.go @@ -2149,6 +2149,8 @@ type DeviceConnectivityManagement struct { // nonComplianceDetail with API_LEVEL is reported if the Android version is // less than 13. WifiDirectSettings string `json:"wifiDirectSettings,omitempty"` + // WifiRoamingPolicy: Optional. Wi-Fi roaming policy. + WifiRoamingPolicy *WifiRoamingPolicy `json:"wifiRoamingPolicy,omitempty"` // WifiSsidPolicy: Restrictions on which Wi-Fi SSIDs the device can connect to. // Note that this does not affect which networks can be configured on the // device. Supported on company-owned devices running Android 13 and above. @@ -6665,6 +6667,65 @@ func (s WebToken) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// WifiRoamingPolicy: Wi-Fi roaming policy. +type WifiRoamingPolicy struct { + // WifiRoamingSettings: Optional. Wi-Fi roaming settings. SSIDs provided in + // this list must be unique, the policy will be rejected otherwise. + WifiRoamingSettings []*WifiRoamingSetting `json:"wifiRoamingSettings,omitempty"` + // ForceSendFields is a list of field names (e.g. "WifiRoamingSettings") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "WifiRoamingSettings") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s WifiRoamingPolicy) MarshalJSON() ([]byte, error) { + type NoMethod WifiRoamingPolicy + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// WifiRoamingSetting: Wi-Fi roaming setting. +type WifiRoamingSetting struct { + // WifiRoamingMode: Required. Wi-Fi roaming mode for the specified SSID. + // + // Possible values: + // "WIFI_ROAMING_MODE_UNSPECIFIED" - Unspecified. Defaults to + // WIFI_ROAMING_DEFAULT. + // "WIFI_ROAMING_DEFAULT" - Default Wi-Fi roaming mode of the device. + // "WIFI_ROAMING_AGGRESSIVE" - Aggressive roaming mode which allows quicker + // Wi-Fi roaming. Supported on Android 15 and above on fully managed devices + // and work profiles on company-owned devices. A nonComplianceDetail with + // MANAGEMENT_MODE is reported for other management modes. A + // nonComplianceDetail with API_LEVEL is reported if the Android version is + // less than 15. A nonComplianceDetail with DEVICE_INCOMPATIBLE is reported if + // the device does not support aggressive roaming mode. + WifiRoamingMode string `json:"wifiRoamingMode,omitempty"` + // WifiSsid: Required. SSID of the Wi-Fi network. + WifiSsid string `json:"wifiSsid,omitempty"` + // ForceSendFields is a list of field names (e.g. "WifiRoamingMode") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "WifiRoamingMode") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s WifiRoamingSetting) MarshalJSON() ([]byte, error) { + type NoMethod WifiRoamingSetting + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // WifiSsid: Represents a Wi-Fi SSID. type WifiSsid struct { // WifiSsid: Required. Wi-Fi SSID represented as a string. diff --git a/assuredworkloads/v1beta1/assuredworkloads-api.json b/assuredworkloads/v1beta1/assuredworkloads-api.json index 61d7230752e..1f40c8587c4 100644 --- a/assuredworkloads/v1beta1/assuredworkloads-api.json +++ b/assuredworkloads/v1beta1/assuredworkloads-api.json @@ -471,6 +471,74 @@ } }, "resources": { + "updates": { + "methods": { + "apply": { + "description": "This endpoint creates a new operation to apply the given update.", + "flatPath": "v1beta1/organizations/{organizationsId}/locations/{locationsId}/workloads/{workloadsId}/updates/{updatesId}:apply", + "httpMethod": "POST", + "id": "assuredworkloads.organizations.locations.workloads.updates.apply", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource name of the update. Format: organizations/{org_id}/locations/{location_id}/workloads/{workload_id}/updates/{update_id}", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+/workloads/[^/]+/updates/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+name}:apply", + "request": { + "$ref": "GoogleCloudAssuredworkloadsV1beta1ApplyWorkloadUpdateRequest" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "This endpoint lists all updates for the given workload.", + "flatPath": "v1beta1/organizations/{organizationsId}/locations/{locationsId}/workloads/{workloadsId}/updates", + "httpMethod": "GET", + "id": "assuredworkloads.organizations.locations.workloads.updates.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Page size. The default value is 20 and the max allowed value is 100.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Page token returned from previous request.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. organizations/{org_id}/locations/{location_id}/workloads/{workload_id}", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+/workloads/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+parent}/updates", + "response": { + "$ref": "GoogleCloudAssuredworkloadsV1beta1ListWorkloadUpdatesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "violations": { "methods": { "acknowledge": { @@ -588,7 +656,7 @@ } } }, - "revision": "20240913", + "revision": "20240923", "rootUrl": "https://assuredworkloads.googleapis.com/", "schemas": { "GoogleCloudAssuredworkloadsV1beta1AcknowledgeViolationRequest": { @@ -645,6 +713,65 @@ }, "type": "object" }, + "GoogleCloudAssuredworkloadsV1beta1ApplyWorkloadUpdateOperationMetadata": { + "description": "Operation metadata to give request details of ApplyWorkloadUpdate.", + "id": "GoogleCloudAssuredworkloadsV1beta1ApplyWorkloadUpdateOperationMetadata", + "properties": { + "action": { + "description": "Optional. The time the operation was created.", + "enum": [ + "WORKLOAD_UPDATE_ACTION_UNSPECIFIED", + "APPLY" + ], + "enumDescriptions": [ + "Unspecified value.", + "The update is applied." + ], + "type": "string" + }, + "createTime": { + "description": "Optional. Output only. The time the operation was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "updateName": { + "description": "Required. The resource name of the update", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudAssuredworkloadsV1beta1ApplyWorkloadUpdateRequest": { + "description": "Request to apply update to a workload.", + "id": "GoogleCloudAssuredworkloadsV1beta1ApplyWorkloadUpdateRequest", + "properties": { + "action": { + "description": "The action to be performed on the update.", + "enum": [ + "WORKLOAD_UPDATE_ACTION_UNSPECIFIED", + "APPLY" + ], + "enumDescriptions": [ + "Unspecified value.", + "The update is applied." + ], + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudAssuredworkloadsV1beta1ApplyWorkloadUpdateResponse": { + "description": "Response for ApplyWorkloadUpdate endpoint.", + "id": "GoogleCloudAssuredworkloadsV1beta1ApplyWorkloadUpdateResponse", + "properties": { + "appliedUpdate": { + "$ref": "GoogleCloudAssuredworkloadsV1beta1WorkloadUpdate", + "description": "The update that was applied." + } + }, + "type": "object" + }, "GoogleCloudAssuredworkloadsV1beta1AssetMoveAnalysis": { "description": "Represents move analysis results for an asset.", "id": "GoogleCloudAssuredworkloadsV1beta1AssetMoveAnalysis", @@ -780,6 +907,24 @@ }, "type": "object" }, + "GoogleCloudAssuredworkloadsV1beta1ListWorkloadUpdatesResponse": { + "description": "Response of listing the compliance updates per workload with pagination.", + "id": "GoogleCloudAssuredworkloadsV1beta1ListWorkloadUpdatesResponse", + "properties": { + "nextPageToken": { + "description": "The next page token. Return empty if reached the last page.", + "type": "string" + }, + "workloadUpdates": { + "description": "The list of workload updates for a given workload.", + "items": { + "$ref": "GoogleCloudAssuredworkloadsV1beta1WorkloadUpdate" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudAssuredworkloadsV1beta1ListWorkloadsResponse": { "description": "Response of ListWorkloads endpoint.", "id": "GoogleCloudAssuredworkloadsV1beta1ListWorkloadsResponse", @@ -849,6 +994,92 @@ }, "type": "object" }, + "GoogleCloudAssuredworkloadsV1beta1OrgPolicy": { + "description": "This assured workload service object is used to represent the org policy attached to a resource. It servces the same purpose as the orgpolicy.v2.Policy object but with functionality that is limited to what is supported by Assured Workloads(e.g. only one rule under one OrgPolicy object, no conditions, etc).", + "id": "GoogleCloudAssuredworkloadsV1beta1OrgPolicy", + "properties": { + "constraint": { + "description": "The constraint name of the OrgPolicy. e.g. \"constraints/gcp.resourceLocations\".", + "type": "string" + }, + "inherit": { + "description": "If `inherit` is true, policy rules of the lowest ancestor in the resource hierarchy chain are inherited. If it is false, policy rules are not inherited.", + "type": "boolean" + }, + "reset": { + "description": "Ignores policies set above this resource and restores to the `constraint_default` value. `reset` can only be true when `rules` is empty and `inherit` is false.", + "type": "boolean" + }, + "resource": { + "description": "Resource that the OrgPolicy attaches to. Format: folders/123\" projects/123\".", + "type": "string" + }, + "rule": { + "$ref": "GoogleCloudAssuredworkloadsV1beta1OrgPolicyPolicyRule", + "description": "The rule of the OrgPolicy." + } + }, + "type": "object" + }, + "GoogleCloudAssuredworkloadsV1beta1OrgPolicyPolicyRule": { + "description": "A rule used to express this policy.", + "id": "GoogleCloudAssuredworkloadsV1beta1OrgPolicyPolicyRule", + "properties": { + "allowAll": { + "description": "ListPolicy only when all values are allowed.", + "type": "boolean" + }, + "denyAll": { + "description": "ListPolicy only when all values are denied.", + "type": "boolean" + }, + "enforce": { + "description": "BooleanPolicy only.", + "type": "boolean" + }, + "values": { + "$ref": "GoogleCloudAssuredworkloadsV1beta1OrgPolicyPolicyRuleStringValues", + "description": "ListPolicy only when custom values are specified." + } + }, + "type": "object" + }, + "GoogleCloudAssuredworkloadsV1beta1OrgPolicyPolicyRuleStringValues": { + "description": "The values allowed for a ListPolicy.", + "id": "GoogleCloudAssuredworkloadsV1beta1OrgPolicyPolicyRuleStringValues", + "properties": { + "allowedValues": { + "description": "List of values allowed at this resource.", + "items": { + "type": "string" + }, + "type": "array" + }, + "deniedValues": { + "description": "List of values denied at this resource.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudAssuredworkloadsV1beta1OrgPolicyUpdate": { + "description": "Represents an update for an org policy control applied on an Assured Workload resource. The inherited org policy is not considered.", + "id": "GoogleCloudAssuredworkloadsV1beta1OrgPolicyUpdate", + "properties": { + "appliedPolicy": { + "$ref": "GoogleCloudAssuredworkloadsV1beta1OrgPolicy", + "description": "The org policy currently applied on the assured workload resource." + }, + "suggestedPolicy": { + "$ref": "GoogleCloudAssuredworkloadsV1beta1OrgPolicy", + "description": "The suggested org policy that replaces the applied policy." + } + }, + "type": "object" + }, "GoogleCloudAssuredworkloadsV1beta1RestrictAllowedResourcesRequest": { "description": "Request for restricting list of available resources in Workload environment.", "id": "GoogleCloudAssuredworkloadsV1beta1RestrictAllowedResourcesRequest", @@ -878,6 +1109,17 @@ "properties": {}, "type": "object" }, + "GoogleCloudAssuredworkloadsV1beta1UpdateDetails": { + "description": "The details of the update.", + "id": "GoogleCloudAssuredworkloadsV1beta1UpdateDetails", + "properties": { + "orgPolicyUpdate": { + "$ref": "GoogleCloudAssuredworkloadsV1beta1OrgPolicyUpdate", + "description": "Update to one org policy, e.g. gcp.resourceLocation." + } + }, + "type": "object" + }, "GoogleCloudAssuredworkloadsV1beta1Violation": { "description": "Workload monitoring Violation.", "id": "GoogleCloudAssuredworkloadsV1beta1Violation", @@ -1149,6 +1391,12 @@ "description": "A Workload object for managing highly regulated workloads of cloud customers.", "id": "GoogleCloudAssuredworkloadsV1beta1Workload", "properties": { + "availableUpdates": { + "description": "Output only. The number of updates available for the workload.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, "billingAccount": { "description": "Optional. The billing account used for the resources which are direct children of workload. This billing account is initially associated with the resources created as part of Workload creation. After the initial creation of these resources, the customer can change the assigned billing account. The resource name has the form `billingAccounts/{billing_account_id}`. For example, `billingAccounts/012345-567890-ABCDEF`.", "type": "string" @@ -1661,6 +1909,49 @@ }, "type": "object" }, + "GoogleCloudAssuredworkloadsV1beta1WorkloadUpdate": { + "description": "A workload update is a change to the workload's compliance configuration.", + "id": "GoogleCloudAssuredworkloadsV1beta1WorkloadUpdate", + "properties": { + "createTime": { + "description": "The time the update was created.", + "format": "google-datetime", + "type": "string" + }, + "details": { + "$ref": "GoogleCloudAssuredworkloadsV1beta1UpdateDetails", + "description": "The details of the update." + }, + "name": { + "description": "Output only. Immutable. Identifier. Resource name of the WorkloadUpdate. Format: organizations/{organization}/locations/{location}/workloads/{workload}/updates/{update}", + "readOnly": true, + "type": "string" + }, + "state": { + "description": "Output only. The state of the update.", + "enum": [ + "STATE_UNSPECIFIED", + "AVAILABLE", + "APPLIED", + "WITHDRAWN" + ], + "enumDescriptions": [ + "Unspecified.", + "The update is available to be applied.", + "The update has been applied.", + "The update has been withdrawn by the service." + ], + "readOnly": true, + "type": "string" + }, + "updateTime": { + "description": "The time the update was last updated.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, "GoogleLongrunningListOperationsResponse": { "description": "The response message for Operations.ListOperations.", "id": "GoogleLongrunningListOperationsResponse", diff --git a/assuredworkloads/v1beta1/assuredworkloads-gen.go b/assuredworkloads/v1beta1/assuredworkloads-gen.go index 20ded6a3c7e..a7a3fa22ee4 100644 --- a/assuredworkloads/v1beta1/assuredworkloads-gen.go +++ b/assuredworkloads/v1beta1/assuredworkloads-gen.go @@ -192,6 +192,7 @@ type OrganizationsLocationsOperationsService struct { func NewOrganizationsLocationsWorkloadsService(s *Service) *OrganizationsLocationsWorkloadsService { rs := &OrganizationsLocationsWorkloadsService{s: s} + rs.Updates = NewOrganizationsLocationsWorkloadsUpdatesService(s) rs.Violations = NewOrganizationsLocationsWorkloadsViolationsService(s) return rs } @@ -199,9 +200,20 @@ func NewOrganizationsLocationsWorkloadsService(s *Service) *OrganizationsLocatio type OrganizationsLocationsWorkloadsService struct { s *Service + Updates *OrganizationsLocationsWorkloadsUpdatesService + Violations *OrganizationsLocationsWorkloadsViolationsService } +func NewOrganizationsLocationsWorkloadsUpdatesService(s *Service) *OrganizationsLocationsWorkloadsUpdatesService { + rs := &OrganizationsLocationsWorkloadsUpdatesService{s: s} + return rs +} + +type OrganizationsLocationsWorkloadsUpdatesService struct { + s *Service +} + func NewOrganizationsLocationsWorkloadsViolationsService(s *Service) *OrganizationsLocationsWorkloadsViolationsService { rs := &OrganizationsLocationsWorkloadsViolationsService{s: s} return rs @@ -285,6 +297,87 @@ func (s GoogleCloudAssuredworkloadsV1beta1AnalyzeWorkloadMoveResponse) MarshalJS return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudAssuredworkloadsV1beta1ApplyWorkloadUpdateOperationMetadata: +// Operation metadata to give request details of ApplyWorkloadUpdate. +type GoogleCloudAssuredworkloadsV1beta1ApplyWorkloadUpdateOperationMetadata struct { + // Action: Optional. The time the operation was created. + // + // Possible values: + // "WORKLOAD_UPDATE_ACTION_UNSPECIFIED" - Unspecified value. + // "APPLY" - The update is applied. + Action string `json:"action,omitempty"` + // CreateTime: Optional. Output only. The time the operation was created. + CreateTime string `json:"createTime,omitempty"` + // UpdateName: Required. The resource name of the update + UpdateName string `json:"updateName,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 GoogleCloudAssuredworkloadsV1beta1ApplyWorkloadUpdateOperationMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAssuredworkloadsV1beta1ApplyWorkloadUpdateOperationMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudAssuredworkloadsV1beta1ApplyWorkloadUpdateRequest: Request to +// apply update to a workload. +type GoogleCloudAssuredworkloadsV1beta1ApplyWorkloadUpdateRequest struct { + // Action: The action to be performed on the update. + // + // Possible values: + // "WORKLOAD_UPDATE_ACTION_UNSPECIFIED" - Unspecified value. + // "APPLY" - The update is applied. + Action string `json:"action,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 GoogleCloudAssuredworkloadsV1beta1ApplyWorkloadUpdateRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAssuredworkloadsV1beta1ApplyWorkloadUpdateRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudAssuredworkloadsV1beta1ApplyWorkloadUpdateResponse: Response for +// ApplyWorkloadUpdate endpoint. +type GoogleCloudAssuredworkloadsV1beta1ApplyWorkloadUpdateResponse struct { + // AppliedUpdate: The update that was applied. + AppliedUpdate *GoogleCloudAssuredworkloadsV1beta1WorkloadUpdate `json:"appliedUpdate,omitempty"` + // ForceSendFields is a list of field names (e.g. "AppliedUpdate") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AppliedUpdate") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAssuredworkloadsV1beta1ApplyWorkloadUpdateResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAssuredworkloadsV1beta1ApplyWorkloadUpdateResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAssuredworkloadsV1beta1AssetMoveAnalysis: Represents move // analysis results for an asset. type GoogleCloudAssuredworkloadsV1beta1AssetMoveAnalysis struct { @@ -424,6 +517,34 @@ func (s GoogleCloudAssuredworkloadsV1beta1ListViolationsResponse) MarshalJSON() return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudAssuredworkloadsV1beta1ListWorkloadUpdatesResponse: Response of +// listing the compliance updates per workload with pagination. +type GoogleCloudAssuredworkloadsV1beta1ListWorkloadUpdatesResponse struct { + // NextPageToken: The next page token. Return empty if reached the last page. + NextPageToken string `json:"nextPageToken,omitempty"` + // WorkloadUpdates: The list of workload updates for a given workload. + WorkloadUpdates []*GoogleCloudAssuredworkloadsV1beta1WorkloadUpdate `json:"workloadUpdates,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 GoogleCloudAssuredworkloadsV1beta1ListWorkloadUpdatesResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAssuredworkloadsV1beta1ListWorkloadUpdatesResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAssuredworkloadsV1beta1ListWorkloadsResponse: Response of // ListWorkloads endpoint. type GoogleCloudAssuredworkloadsV1beta1ListWorkloadsResponse struct { @@ -530,6 +651,127 @@ func (s GoogleCloudAssuredworkloadsV1beta1MoveImpact) MarshalJSON() ([]byte, err return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudAssuredworkloadsV1beta1OrgPolicy: This assured workload service +// object is used to represent the org policy attached to a resource. It +// servces the same purpose as the orgpolicy.v2.Policy object but with +// functionality that is limited to what is supported by Assured Workloads(e.g. +// only one rule under one OrgPolicy object, no conditions, etc). +type GoogleCloudAssuredworkloadsV1beta1OrgPolicy struct { + // Constraint: The constraint name of the OrgPolicy. e.g. + // "constraints/gcp.resourceLocations". + Constraint string `json:"constraint,omitempty"` + // Inherit: If `inherit` is true, policy rules of the lowest ancestor in the + // resource hierarchy chain are inherited. If it is false, policy rules are not + // inherited. + Inherit bool `json:"inherit,omitempty"` + // Reset: Ignores policies set above this resource and restores to the + // `constraint_default` value. `reset` can only be true when `rules` is empty + // and `inherit` is false. + Reset bool `json:"reset,omitempty"` + // Resource: Resource that the OrgPolicy attaches to. Format: folders/123" + // projects/123". + Resource string `json:"resource,omitempty"` + // Rule: The rule of the OrgPolicy. + Rule *GoogleCloudAssuredworkloadsV1beta1OrgPolicyPolicyRule `json:"rule,omitempty"` + // ForceSendFields is a list of field names (e.g. "Constraint") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Constraint") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAssuredworkloadsV1beta1OrgPolicy) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAssuredworkloadsV1beta1OrgPolicy + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudAssuredworkloadsV1beta1OrgPolicyPolicyRule: A rule used to +// express this policy. +type GoogleCloudAssuredworkloadsV1beta1OrgPolicyPolicyRule struct { + // AllowAll: ListPolicy only when all values are allowed. + AllowAll bool `json:"allowAll,omitempty"` + // DenyAll: ListPolicy only when all values are denied. + DenyAll bool `json:"denyAll,omitempty"` + // Enforce: BooleanPolicy only. + Enforce bool `json:"enforce,omitempty"` + // Values: ListPolicy only when custom values are specified. + Values *GoogleCloudAssuredworkloadsV1beta1OrgPolicyPolicyRuleStringValues `json:"values,omitempty"` + // ForceSendFields is a list of field names (e.g. "AllowAll") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AllowAll") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAssuredworkloadsV1beta1OrgPolicyPolicyRule) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAssuredworkloadsV1beta1OrgPolicyPolicyRule + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudAssuredworkloadsV1beta1OrgPolicyPolicyRuleStringValues: The +// values allowed for a ListPolicy. +type GoogleCloudAssuredworkloadsV1beta1OrgPolicyPolicyRuleStringValues struct { + // AllowedValues: List of values allowed at this resource. + AllowedValues []string `json:"allowedValues,omitempty"` + // DeniedValues: List of values denied at this resource. + DeniedValues []string `json:"deniedValues,omitempty"` + // ForceSendFields is a list of field names (e.g. "AllowedValues") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AllowedValues") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAssuredworkloadsV1beta1OrgPolicyPolicyRuleStringValues) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAssuredworkloadsV1beta1OrgPolicyPolicyRuleStringValues + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudAssuredworkloadsV1beta1OrgPolicyUpdate: Represents an update for +// an org policy control applied on an Assured Workload resource. The inherited +// org policy is not considered. +type GoogleCloudAssuredworkloadsV1beta1OrgPolicyUpdate struct { + // AppliedPolicy: The org policy currently applied on the assured workload + // resource. + AppliedPolicy *GoogleCloudAssuredworkloadsV1beta1OrgPolicy `json:"appliedPolicy,omitempty"` + // SuggestedPolicy: The suggested org policy that replaces the applied policy. + SuggestedPolicy *GoogleCloudAssuredworkloadsV1beta1OrgPolicy `json:"suggestedPolicy,omitempty"` + // ForceSendFields is a list of field names (e.g. "AppliedPolicy") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AppliedPolicy") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAssuredworkloadsV1beta1OrgPolicyUpdate) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAssuredworkloadsV1beta1OrgPolicyUpdate + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAssuredworkloadsV1beta1RestrictAllowedResourcesRequest: Request // for restricting list of available resources in Workload environment. type GoogleCloudAssuredworkloadsV1beta1RestrictAllowedResourcesRequest struct { @@ -575,6 +817,28 @@ type GoogleCloudAssuredworkloadsV1beta1RestrictAllowedResourcesResponse struct { googleapi.ServerResponse `json:"-"` } +// GoogleCloudAssuredworkloadsV1beta1UpdateDetails: The details of the update. +type GoogleCloudAssuredworkloadsV1beta1UpdateDetails struct { + // OrgPolicyUpdate: Update to one org policy, e.g. gcp.resourceLocation. + OrgPolicyUpdate *GoogleCloudAssuredworkloadsV1beta1OrgPolicyUpdate `json:"orgPolicyUpdate,omitempty"` + // ForceSendFields is a list of field names (e.g. "OrgPolicyUpdate") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "OrgPolicyUpdate") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAssuredworkloadsV1beta1UpdateDetails) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAssuredworkloadsV1beta1UpdateDetails + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAssuredworkloadsV1beta1Violation: Workload monitoring Violation. type GoogleCloudAssuredworkloadsV1beta1Violation struct { // Acknowledged: A boolean that indicates if the violation is acknowledged @@ -832,6 +1096,9 @@ func (s GoogleCloudAssuredworkloadsV1beta1ViolationRemediationInstructionsGcloud // GoogleCloudAssuredworkloadsV1beta1Workload: A Workload object for managing // highly regulated workloads of cloud customers. type GoogleCloudAssuredworkloadsV1beta1Workload struct { + // AvailableUpdates: Output only. The number of updates available for the + // workload. + AvailableUpdates int64 `json:"availableUpdates,omitempty"` // BillingAccount: Optional. The billing account used for the resources which // are direct children of workload. This billing account is initially // associated with the resources created as part of Workload creation. After @@ -994,13 +1261,13 @@ type GoogleCloudAssuredworkloadsV1beta1Workload struct { // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "BillingAccount") to + // ForceSendFields is a list of field names (e.g. "AvailableUpdates") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "BillingAccount") to include in + // NullFields is a list of field names (e.g. "AvailableUpdates") to include in // API requests with the JSON null value. By default, fields with empty values // are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. @@ -1378,6 +1645,46 @@ func (s GoogleCloudAssuredworkloadsV1beta1WorkloadSaaEnrollmentResponse) Marshal return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudAssuredworkloadsV1beta1WorkloadUpdate: A workload update is a +// change to the workload's compliance configuration. +type GoogleCloudAssuredworkloadsV1beta1WorkloadUpdate struct { + // CreateTime: The time the update was created. + CreateTime string `json:"createTime,omitempty"` + // Details: The details of the update. + Details *GoogleCloudAssuredworkloadsV1beta1UpdateDetails `json:"details,omitempty"` + // Name: Output only. Immutable. Identifier. Resource name of the + // WorkloadUpdate. Format: + // organizations/{organization}/locations/{location}/workloads/{workload}/update + // s/{update} + Name string `json:"name,omitempty"` + // State: Output only. The state of the update. + // + // Possible values: + // "STATE_UNSPECIFIED" - Unspecified. + // "AVAILABLE" - The update is available to be applied. + // "APPLIED" - The update has been applied. + // "WITHDRAWN" - The update has been withdrawn by the service. + State string `json:"state,omitempty"` + // UpdateTime: The time the update was last 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 GoogleCloudAssuredworkloadsV1beta1WorkloadUpdate) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAssuredworkloadsV1beta1WorkloadUpdate + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleLongrunningListOperationsResponse: The response message for // Operations.ListOperations. type GoogleLongrunningListOperationsResponse struct { @@ -2838,6 +3145,254 @@ func (c *OrganizationsLocationsWorkloadsRestrictAllowedResourcesCall) Do(opts .. return ret, nil } +type OrganizationsLocationsWorkloadsUpdatesApplyCall struct { + s *Service + name string + googlecloudassuredworkloadsv1beta1applyworkloadupdaterequest *GoogleCloudAssuredworkloadsV1beta1ApplyWorkloadUpdateRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Apply: This endpoint creates a new operation to apply the given update. +// +// - name: The resource name of the update. Format: +// organizations/{org_id}/locations/{location_id}/workloads/{workload_id}/upda +// tes/{update_id}. +func (r *OrganizationsLocationsWorkloadsUpdatesService) Apply(name string, googlecloudassuredworkloadsv1beta1applyworkloadupdaterequest *GoogleCloudAssuredworkloadsV1beta1ApplyWorkloadUpdateRequest) *OrganizationsLocationsWorkloadsUpdatesApplyCall { + c := &OrganizationsLocationsWorkloadsUpdatesApplyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googlecloudassuredworkloadsv1beta1applyworkloadupdaterequest = googlecloudassuredworkloadsv1beta1applyworkloadupdaterequest + 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 *OrganizationsLocationsWorkloadsUpdatesApplyCall) Fields(s ...googleapi.Field) *OrganizationsLocationsWorkloadsUpdatesApplyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsLocationsWorkloadsUpdatesApplyCall) Context(ctx context.Context) *OrganizationsLocationsWorkloadsUpdatesApplyCall { + 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 *OrganizationsLocationsWorkloadsUpdatesApplyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsWorkloadsUpdatesApplyCall) 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.googlecloudassuredworkloadsv1beta1applyworkloadupdaterequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}:apply") + 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 "assuredworkloads.organizations.locations.workloads.updates.apply" 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 *OrganizationsLocationsWorkloadsUpdatesApplyCall) 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 OrganizationsLocationsWorkloadsUpdatesListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: This endpoint lists all updates for the given workload. +// +// - parent: +// organizations/{org_id}/locations/{location_id}/workloads/{workload_id}. +func (r *OrganizationsLocationsWorkloadsUpdatesService) List(parent string) *OrganizationsLocationsWorkloadsUpdatesListCall { + c := &OrganizationsLocationsWorkloadsUpdatesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": Page size. The default +// value is 20 and the max allowed value is 100. +func (c *OrganizationsLocationsWorkloadsUpdatesListCall) PageSize(pageSize int64) *OrganizationsLocationsWorkloadsUpdatesListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": Page token returned from +// previous request. +func (c *OrganizationsLocationsWorkloadsUpdatesListCall) PageToken(pageToken string) *OrganizationsLocationsWorkloadsUpdatesListCall { + 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 *OrganizationsLocationsWorkloadsUpdatesListCall) Fields(s ...googleapi.Field) *OrganizationsLocationsWorkloadsUpdatesListCall { + 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 *OrganizationsLocationsWorkloadsUpdatesListCall) IfNoneMatch(entityTag string) *OrganizationsLocationsWorkloadsUpdatesListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsLocationsWorkloadsUpdatesListCall) Context(ctx context.Context) *OrganizationsLocationsWorkloadsUpdatesListCall { + 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 *OrganizationsLocationsWorkloadsUpdatesListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsWorkloadsUpdatesListCall) 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}/updates") + 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 "assuredworkloads.organizations.locations.workloads.updates.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudAssuredworkloadsV1beta1ListWorkloadUpdatesResponse.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 *OrganizationsLocationsWorkloadsUpdatesListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudAssuredworkloadsV1beta1ListWorkloadUpdatesResponse, 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 := &GoogleCloudAssuredworkloadsV1beta1ListWorkloadUpdatesResponse{ + 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 *OrganizationsLocationsWorkloadsUpdatesListCall) Pages(ctx context.Context, f func(*GoogleCloudAssuredworkloadsV1beta1ListWorkloadUpdatesResponse) 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 OrganizationsLocationsWorkloadsViolationsAcknowledgeCall struct { s *Service name string diff --git a/authorizedbuyersmarketplace/v1alpha/authorizedbuyersmarketplace-api.json b/authorizedbuyersmarketplace/v1alpha/authorizedbuyersmarketplace-api.json index 8b2b87d698b..6c750d43ee2 100644 --- a/authorizedbuyersmarketplace/v1alpha/authorizedbuyersmarketplace-api.json +++ b/authorizedbuyersmarketplace/v1alpha/authorizedbuyersmarketplace-api.json @@ -1550,7 +1550,7 @@ } } }, - "revision": "20240718", + "revision": "20240924", "rootUrl": "https://authorizedbuyersmarketplace.googleapis.com/", "schemas": { "AcceptProposalRequest": { @@ -1969,7 +1969,7 @@ "properties": { "cpmFee": { "$ref": "Money", - "description": "Optional. This will be charged when other accounts use this data segment. For example, when other accounts add this data segment to a deal or auction package." + "description": "Optional. This will be charged when other accounts use this data segment. For example, when other accounts add this data segment to a deal or auction package. Once set, the currency code cannot be changed." }, "createTime": { "description": "Output only. Time the data segment was created.", diff --git a/authorizedbuyersmarketplace/v1alpha/authorizedbuyersmarketplace-gen.go b/authorizedbuyersmarketplace/v1alpha/authorizedbuyersmarketplace-gen.go index 0bb0e4af64d..9fae64c80f3 100644 --- a/authorizedbuyersmarketplace/v1alpha/authorizedbuyersmarketplace-gen.go +++ b/authorizedbuyersmarketplace/v1alpha/authorizedbuyersmarketplace-gen.go @@ -776,7 +776,7 @@ func (s CriteriaTargeting) MarshalJSON() ([]byte, error) { type DataSegment struct { // CpmFee: Optional. This will be charged when other accounts use this data // segment. For example, when other accounts add this data segment to a deal or - // auction package. + // auction package. Once set, the currency code cannot be changed. CpmFee *Money `json:"cpmFee,omitempty"` // CreateTime: Output only. Time the data segment was created. CreateTime string `json:"createTime,omitempty"` diff --git a/batch/v1/batch-api.json b/batch/v1/batch-api.json index 13e4a9ca627..43efe14abe3 100644 --- a/batch/v1/batch-api.json +++ b/batch/v1/batch-api.json @@ -561,7 +561,7 @@ } } }, - "revision": "20240911", + "revision": "20240919", "rootUrl": "https://batch.googleapis.com/", "schemas": { "Accelerator": { @@ -1001,7 +1001,7 @@ "additionalProperties": { "type": "string" }, - "description": "Labels applied to all VM instances and other resources created by AllocationPolicy. Labels could be user provided or system generated. You can assign up to 64 labels. [Google Compute Engine label restrictions](https://cloud.google.com/compute/docs/labeling-resources#restrictions) apply. Label names that start with \"goog-\" or \"google-\" are reserved.", + "description": "Custom labels to apply to the job and all the Compute Engine resources that both are created by this allocation policy and support labels. Use labels to group and describe the resources they are applied to. Batch automatically applies predefined labels and supports multiple `labels` fields for each job, which each let you apply custom labels to various resources. Label names that start with \"goog-\" or \"google-\" are reserved for predefined labels. For more information about labels with Batch, see [Organize resources using labels](https://cloud.google.com/batch/docs/organize-resources-using-labels).", "type": "object" }, "location": { @@ -1351,7 +1351,7 @@ "additionalProperties": { "type": "string" }, - "description": "Labels for the Job. Labels could be user provided or system generated. For example, \"labels\": { \"department\": \"finance\", \"environment\": \"test\" } You can assign up to 64 labels. [Google Compute Engine label restrictions](https://cloud.google.com/compute/docs/labeling-resources#restrictions) apply. Label names that start with \"goog-\" or \"google-\" are reserved.", + "description": "Custom labels to apply to the job and any Cloud Logging [LogEntry](https://cloud.google.com/logging/docs/reference/v2/rest/v2/LogEntry) that it generates. Use labels to group and describe the resources they are applied to. Batch automatically applies predefined labels and supports multiple `labels` fields for each job, which each let you apply custom labels to various resources. Label names that start with \"goog-\" or \"google-\" are reserved for predefined labels. For more information about labels with Batch, see [Organize resources using labels](https://cloud.google.com/batch/docs/organize-resources-using-labels).", "type": "object" }, "logsPolicy": { diff --git a/batch/v1/batch-gen.go b/batch/v1/batch-gen.go index aa9e70d935e..4184353e9ba 100644 --- a/batch/v1/batch-gen.go +++ b/batch/v1/batch-gen.go @@ -755,11 +755,15 @@ type AllocationPolicy struct { // Instances: Describe instances that can be created by this AllocationPolicy. // Only instances[0] is supported now. Instances []*InstancePolicyOrTemplate `json:"instances,omitempty"` - // Labels: Labels applied to all VM instances and other resources created by - // AllocationPolicy. Labels could be user provided or system generated. You can - // assign up to 64 labels. Google Compute Engine label restrictions - // (https://cloud.google.com/compute/docs/labeling-resources#restrictions) - // apply. Label names that start with "goog-" or "google-" are reserved. + // Labels: Custom labels to apply to the job and all the Compute Engine + // resources that both are created by this allocation policy and support + // labels. Use labels to group and describe the resources they are applied to. + // Batch automatically applies predefined labels and supports multiple `labels` + // fields for each job, which each let you apply custom labels to various + // resources. Label names that start with "goog-" or "google-" are reserved for + // predefined labels. For more information about labels with Batch, see + // Organize resources using labels + // (https://cloud.google.com/batch/docs/organize-resources-using-labels). Labels map[string]string `json:"labels,omitempty"` // Location: Location where compute resources should be allocated for the Job. Location *LocationPolicy `json:"location,omitempty"` @@ -1300,12 +1304,15 @@ type Job struct { AllocationPolicy *AllocationPolicy `json:"allocationPolicy,omitempty"` // CreateTime: Output only. When the Job was created. CreateTime string `json:"createTime,omitempty"` - // Labels: Labels for the Job. Labels could be user provided or system - // generated. For example, "labels": { "department": "finance", "environment": - // "test" } You can assign up to 64 labels. Google Compute Engine label - // restrictions - // (https://cloud.google.com/compute/docs/labeling-resources#restrictions) - // apply. Label names that start with "goog-" or "google-" are reserved. + // Labels: Custom labels to apply to the job and any Cloud Logging LogEntry + // (https://cloud.google.com/logging/docs/reference/v2/rest/v2/LogEntry) that + // it generates. Use labels to group and describe the resources they are + // applied to. Batch automatically applies predefined labels and supports + // multiple `labels` fields for each job, which each let you apply custom + // labels to various resources. Label names that start with "goog-" or + // "google-" are reserved for predefined labels. For more information about + // labels with Batch, see Organize resources using labels + // (https://cloud.google.com/batch/docs/organize-resources-using-labels). Labels map[string]string `json:"labels,omitempty"` // LogsPolicy: Log preservation policy for the Job. LogsPolicy *LogsPolicy `json:"logsPolicy,omitempty"` diff --git a/beyondcorp/v1alpha/beyondcorp-api.json b/beyondcorp/v1alpha/beyondcorp-api.json index 1f650e18442..5a6c471b903 100644 --- a/beyondcorp/v1alpha/beyondcorp-api.json +++ b/beyondcorp/v1alpha/beyondcorp-api.json @@ -4499,7 +4499,7 @@ } } }, - "revision": "20240904", + "revision": "20240918", "rootUrl": "https://beyondcorp.googleapis.com/", "schemas": { "AllocatedConnection": { @@ -6684,7 +6684,7 @@ "type": "string" }, "displayName": { - "description": "Optional. An arbitrary user-provided name for the Route resource. Cannot exceed 64 characters.", + "description": "Optional. An arbitrary user-provided name for the Application resource. Cannot exceed 64 characters.", "type": "string" }, "endpointMatchers": { diff --git a/beyondcorp/v1alpha/beyondcorp-gen.go b/beyondcorp/v1alpha/beyondcorp-gen.go index 32d1dc4ca42..d5c49dd0618 100644 --- a/beyondcorp/v1alpha/beyondcorp-gen.go +++ b/beyondcorp/v1alpha/beyondcorp-gen.go @@ -2865,7 +2865,7 @@ func (s GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaSubscription) Marsh type GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplication struct { // CreateTime: Output only. Timestamp when the resource was created. CreateTime string `json:"createTime,omitempty"` - // DisplayName: Optional. An arbitrary user-provided name for the Route + // DisplayName: Optional. An arbitrary user-provided name for the Application // resource. Cannot exceed 64 characters. DisplayName string `json:"displayName,omitempty"` // EndpointMatchers: Required. Endpoint matchers associated with an diff --git a/cloudbuild/v1/cloudbuild-api.json b/cloudbuild/v1/cloudbuild-api.json index 5389af39cdd..46b1e8beb5c 100644 --- a/cloudbuild/v1/cloudbuild-api.json +++ b/cloudbuild/v1/cloudbuild-api.json @@ -2346,7 +2346,7 @@ } } }, - "revision": "20240903", + "revision": "20240923", "rootUrl": "https://cloudbuild.googleapis.com/", "schemas": { "ApprovalConfig": { @@ -3017,11 +3017,13 @@ "description": "Optional. Option to specify how default logs buckets are setup.", "enum": [ "DEFAULT_LOGS_BUCKET_BEHAVIOR_UNSPECIFIED", - "REGIONAL_USER_OWNED_BUCKET" + "REGIONAL_USER_OWNED_BUCKET", + "LEGACY_BUCKET" ], "enumDescriptions": [ "Unspecified.", - "Bucket is located in user-owned project in the same region as the build. The builder service account must have access to create and write to Cloud Storage buckets in the build project." + "Bucket is located in user-owned project in the same region as the build. The builder service account must have access to create and write to Cloud Storage buckets in the build project.", + "Bucket is located in a Google-owned project and is not regionalized." ], "type": "string" }, diff --git a/cloudbuild/v1/cloudbuild-gen.go b/cloudbuild/v1/cloudbuild-gen.go index aa0377d0846..845c0e05df2 100644 --- a/cloudbuild/v1/cloudbuild-gen.go +++ b/cloudbuild/v1/cloudbuild-gen.go @@ -1185,6 +1185,8 @@ type BuildOptions struct { // "REGIONAL_USER_OWNED_BUCKET" - Bucket is located in user-owned project in // the same region as the build. The builder service account must have access // to create and write to Cloud Storage buckets in the build project. + // "LEGACY_BUCKET" - Bucket is located in a Google-owned project and is not + // regionalized. DefaultLogsBucketBehavior string `json:"defaultLogsBucketBehavior,omitempty"` // DiskSizeGb: Requested disk size for the VM that runs the build. Note that // this is *NOT* "disk free"; some of the space will be used by the operating diff --git a/cloudscheduler/v1/cloudscheduler-api.json b/cloudscheduler/v1/cloudscheduler-api.json index 36fc4bbad55..8e0b5f517df 100644 --- a/cloudscheduler/v1/cloudscheduler-api.json +++ b/cloudscheduler/v1/cloudscheduler-api.json @@ -105,6 +105,117 @@ }, "protocol": "rest", "resources": { + "operations": { + "methods": { + "cancel": { + "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", + "flatPath": "v1/operations/{operationsId}:cancel", + "httpMethod": "POST", + "id": "cloudscheduler.operations.cancel", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to be cancelled.", + "location": "path", + "pattern": "^operations/.*$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}:cancel", + "request": { + "$ref": "CancelOperationRequest" + }, + "response": { + "$ref": "Empty" + } + }, + "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": "v1/operations/{operationsId}", + "httpMethod": "DELETE", + "id": "cloudscheduler.operations.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to be deleted.", + "location": "path", + "pattern": "^operations/.*$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Empty" + } + }, + "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": "v1/operations/{operationsId}", + "httpMethod": "GET", + "id": "cloudscheduler.operations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource.", + "location": "path", + "pattern": "^operations/.*$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Operation" + } + }, + "list": { + "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", + "flatPath": "v1/operations", + "httpMethod": "GET", + "id": "cloudscheduler.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": "^operations$", + "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": "v1/{+name}", + "response": { + "$ref": "ListOperationsResponse" + } + } + } + }, "projects": { "resources": { "locations": { @@ -418,7 +529,7 @@ } } }, - "revision": "20240126", + "revision": "20240917", "rootUrl": "https://cloudscheduler.googleapis.com/", "schemas": { "AppEngineHttpTarget": { @@ -495,6 +606,12 @@ }, "type": "object" }, + "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", @@ -678,6 +795,24 @@ }, "type": "object" }, + "ListOperationsResponse": { + "description": "The response message for Operations.ListOperations.", + "id": "ListOperationsResponse", + "properties": { + "nextPageToken": { + "description": "The standard List next-page token.", + "type": "string" + }, + "operations": { + "description": "A list of operations that matches the specified filter in the request.", + "items": { + "$ref": "Operation" + }, + "type": "array" + } + }, + "type": "object" + }, "Location": { "description": "A resource that represents a Google Cloud location.", "id": "Location", @@ -742,6 +877,85 @@ }, "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" + }, + "OperationMetadata": { + "description": "Represents the metadata of the long-running operation.", + "id": "OperationMetadata", + "properties": { + "apiVersion": { + "description": "Output only. API version used to start the operation.", + "readOnly": true, + "type": "string" + }, + "cancelRequested": { + "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" + }, + "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" + }, + "statusDetail": { + "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" + }, "PauseJobRequest": { "description": "Request message for PauseJob.", "id": "PauseJobRequest", diff --git a/cloudscheduler/v1/cloudscheduler-gen.go b/cloudscheduler/v1/cloudscheduler-gen.go index a91fd3f8cf0..1400f663238 100644 --- a/cloudscheduler/v1/cloudscheduler-gen.go +++ b/cloudscheduler/v1/cloudscheduler-gen.go @@ -135,6 +135,7 @@ func New(client *http.Client) (*Service, error) { return nil, errors.New("client is nil") } s := &Service{client: client, BasePath: basePath} + s.Operations = NewOperationsService(s) s.Projects = NewProjectsService(s) return s, nil } @@ -144,6 +145,8 @@ type Service struct { BasePath string // API endpoint base URL UserAgent string // optional additional User-Agent fragment + Operations *OperationsService + Projects *ProjectsService } @@ -154,6 +157,15 @@ func (s *Service) userAgent() string { return googleapi.UserAgent + " " + s.UserAgent } +func NewOperationsService(s *Service) *OperationsService { + rs := &OperationsService{s: s} + return rs +} + +type OperationsService struct { + s *Service +} + func NewProjectsService(s *Service) *ProjectsService { rs := &ProjectsService{s: s} rs.Locations = NewProjectsLocationsService(s) @@ -328,6 +340,10 @@ func (s AppEngineRouting) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// 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 @@ -586,6 +602,34 @@ func (s ListLocationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ListOperationsResponse: The response message for Operations.ListOperations. +type ListOperationsResponse struct { + // NextPageToken: The standard List next-page token. + NextPageToken string `json:"nextPageToken,omitempty"` + // Operations: A list of operations that matches the specified filter in the + // request. + Operations []*Operation `json:"operations,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "NextPageToken") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "NextPageToken") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ListOperationsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListOperationsResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby city @@ -688,6 +732,91 @@ func (s OidcToken) MarshalJSON() ([]byte, error) { 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) +} + +// OperationMetadata: Represents the metadata of the long-running operation. +type OperationMetadata struct { + // ApiVersion: Output only. API version used to start the operation. + ApiVersion string `json:"apiVersion,omitempty"` + // CancelRequested: 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`. + CancelRequested bool `json:"cancelRequested,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"` + // StatusDetail: Output only. Human-readable status of the operation, if any. + StatusDetail string `json:"statusDetail,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 OperationMetadata) MarshalJSON() ([]byte, error) { + type NoMethod OperationMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // PauseJobRequest: Request message for PauseJob. type PauseJobRequest struct { } @@ -877,6 +1006,472 @@ func (s Status) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type OperationsCancelCall 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 *OperationsService) Cancel(name string, canceloperationrequest *CancelOperationRequest) *OperationsCancelCall { + c := &OperationsCancelCall{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 *OperationsCancelCall) Fields(s ...googleapi.Field) *OperationsCancelCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OperationsCancelCall) Context(ctx context.Context) *OperationsCancelCall { + 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 *OperationsCancelCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OperationsCancelCall) 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, "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 "cloudscheduler.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 *OperationsCancelCall) 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 OperationsDeleteCall 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 *OperationsService) Delete(name string) *OperationsDeleteCall { + c := &OperationsDeleteCall{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 *OperationsDeleteCall) Fields(s ...googleapi.Field) *OperationsDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OperationsDeleteCall) Context(ctx context.Context) *OperationsDeleteCall { + 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 *OperationsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OperationsDeleteCall) 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 "cloudscheduler.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 *OperationsDeleteCall) 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 OperationsGetCall 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 *OperationsService) Get(name string) *OperationsGetCall { + c := &OperationsGetCall{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 *OperationsGetCall) Fields(s ...googleapi.Field) *OperationsGetCall { + 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 *OperationsGetCall) IfNoneMatch(entityTag string) *OperationsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OperationsGetCall) Context(ctx context.Context) *OperationsGetCall { + 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 *OperationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OperationsGetCall) 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 "cloudscheduler.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 *OperationsGetCall) 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 OperationsListCall 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 *OperationsService) List(name string) *OperationsListCall { + c := &OperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Filter sets the optional parameter "filter": The standard list filter. +func (c *OperationsListCall) Filter(filter string) *OperationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The standard list page +// size. +func (c *OperationsListCall) PageSize(pageSize int64) *OperationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The standard list page +// token. +func (c *OperationsListCall) PageToken(pageToken string) *OperationsListCall { + 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 *OperationsListCall) Fields(s ...googleapi.Field) *OperationsListCall { + 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 *OperationsListCall) IfNoneMatch(entityTag string) *OperationsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OperationsListCall) Context(ctx context.Context) *OperationsListCall { + 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 *OperationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OperationsListCall) 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 "cloudscheduler.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 *OperationsListCall) 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 *OperationsListCall) 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 ProjectsLocationsGetCall struct { s *Service name string diff --git a/cloudscheduler/v1beta1/cloudscheduler-api.json b/cloudscheduler/v1beta1/cloudscheduler-api.json index 9ec00a58201..b320ac7bbf6 100644 --- a/cloudscheduler/v1beta1/cloudscheduler-api.json +++ b/cloudscheduler/v1beta1/cloudscheduler-api.json @@ -433,7 +433,7 @@ } } }, - "revision": "20240126", + "revision": "20240917", "rootUrl": "https://cloudscheduler.googleapis.com/", "schemas": { "AppEngineHttpTarget": { @@ -761,6 +761,50 @@ }, "type": "object" }, + "OperationMetadata": { + "description": "Represents the metadata of the long-running operation.", + "id": "OperationMetadata", + "properties": { + "apiVersion": { + "description": "Output only. API version used to start the operation.", + "readOnly": true, + "type": "string" + }, + "cancelRequested": { + "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" + }, + "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" + }, + "statusDetail": { + "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" + }, "PauseJobRequest": { "description": "Request message for PauseJob.", "id": "PauseJobRequest", diff --git a/cloudscheduler/v1beta1/cloudscheduler-gen.go b/cloudscheduler/v1beta1/cloudscheduler-gen.go index 8ffec079319..864a99e591a 100644 --- a/cloudscheduler/v1beta1/cloudscheduler-gen.go +++ b/cloudscheduler/v1beta1/cloudscheduler-gen.go @@ -694,6 +694,44 @@ func (s OidcToken) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// OperationMetadata: Represents the metadata of the long-running operation. +type OperationMetadata struct { + // ApiVersion: Output only. API version used to start the operation. + ApiVersion string `json:"apiVersion,omitempty"` + // CancelRequested: 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`. + CancelRequested bool `json:"cancelRequested,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"` + // StatusDetail: Output only. Human-readable status of the operation, if any. + StatusDetail string `json:"statusDetail,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 OperationMetadata) MarshalJSON() ([]byte, error) { + type NoMethod OperationMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // PauseJobRequest: Request message for PauseJob. type PauseJobRequest struct { } diff --git a/containeranalysis/v1alpha1/containeranalysis-api.json b/containeranalysis/v1alpha1/containeranalysis-api.json index 3d778c1e716..faec57110ff 100644 --- a/containeranalysis/v1alpha1/containeranalysis-api.json +++ b/containeranalysis/v1alpha1/containeranalysis-api.json @@ -1420,7 +1420,7 @@ } } }, - "revision": "20240816", + "revision": "20240924", "rootUrl": "https://containeranalysis.googleapis.com/", "schemas": { "AnalysisCompleted": { @@ -2721,11 +2721,13 @@ "description": "Optional. Option to specify how default logs buckets are setup.", "enum": [ "DEFAULT_LOGS_BUCKET_BEHAVIOR_UNSPECIFIED", - "REGIONAL_USER_OWNED_BUCKET" + "REGIONAL_USER_OWNED_BUCKET", + "LEGACY_BUCKET" ], "enumDescriptions": [ "Unspecified.", - "Bucket is located in user-owned project in the same region as the build. The builder service account must have access to create and write to Cloud Storage buckets in the build project." + "Bucket is located in user-owned project in the same region as the build. The builder service account must have access to create and write to Cloud Storage buckets in the build project.", + "Bucket is located in a Google-owned project and is not regionalized." ], "type": "string" }, diff --git a/containeranalysis/v1alpha1/containeranalysis-gen.go b/containeranalysis/v1alpha1/containeranalysis-gen.go index bda9b1ea455..02a02cbcfa1 100644 --- a/containeranalysis/v1alpha1/containeranalysis-gen.go +++ b/containeranalysis/v1alpha1/containeranalysis-gen.go @@ -1740,6 +1740,8 @@ type ContaineranalysisGoogleDevtoolsCloudbuildV1BuildOptions struct { // "REGIONAL_USER_OWNED_BUCKET" - Bucket is located in user-owned project in // the same region as the build. The builder service account must have access // to create and write to Cloud Storage buckets in the build project. + // "LEGACY_BUCKET" - Bucket is located in a Google-owned project and is not + // regionalized. DefaultLogsBucketBehavior string `json:"defaultLogsBucketBehavior,omitempty"` // DiskSizeGb: Requested disk size for the VM that runs the build. Note that // this is *NOT* "disk free"; some of the space will be used by the operating diff --git a/containeranalysis/v1beta1/containeranalysis-api.json b/containeranalysis/v1beta1/containeranalysis-api.json index ec23f8afece..bad0d5ff954 100644 --- a/containeranalysis/v1beta1/containeranalysis-api.json +++ b/containeranalysis/v1beta1/containeranalysis-api.json @@ -1711,7 +1711,7 @@ } } }, - "revision": "20240830", + "revision": "20240924", "rootUrl": "https://containeranalysis.googleapis.com/", "schemas": { "AliasContext": { @@ -3106,11 +3106,13 @@ "description": "Optional. Option to specify how default logs buckets are setup.", "enum": [ "DEFAULT_LOGS_BUCKET_BEHAVIOR_UNSPECIFIED", - "REGIONAL_USER_OWNED_BUCKET" + "REGIONAL_USER_OWNED_BUCKET", + "LEGACY_BUCKET" ], "enumDescriptions": [ "Unspecified.", - "Bucket is located in user-owned project in the same region as the build. The builder service account must have access to create and write to Cloud Storage buckets in the build project." + "Bucket is located in user-owned project in the same region as the build. The builder service account must have access to create and write to Cloud Storage buckets in the build project.", + "Bucket is located in a Google-owned project and is not regionalized." ], "type": "string" }, diff --git a/containeranalysis/v1beta1/containeranalysis-gen.go b/containeranalysis/v1beta1/containeranalysis-gen.go index abd3b91f036..7a675bb1dd9 100644 --- a/containeranalysis/v1beta1/containeranalysis-gen.go +++ b/containeranalysis/v1beta1/containeranalysis-gen.go @@ -1806,6 +1806,8 @@ type ContaineranalysisGoogleDevtoolsCloudbuildV1BuildOptions struct { // "REGIONAL_USER_OWNED_BUCKET" - Bucket is located in user-owned project in // the same region as the build. The builder service account must have access // to create and write to Cloud Storage buckets in the build project. + // "LEGACY_BUCKET" - Bucket is located in a Google-owned project and is not + // regionalized. DefaultLogsBucketBehavior string `json:"defaultLogsBucketBehavior,omitempty"` // DiskSizeGb: Requested disk size for the VM that runs the build. Note that // this is *NOT* "disk free"; some of the space will be used by the operating diff --git a/discoveryengine/v1/discoveryengine-api.json b/discoveryengine/v1/discoveryengine-api.json index c77651ca792..6e44f0954da 100644 --- a/discoveryengine/v1/discoveryengine-api.json +++ b/discoveryengine/v1/discoveryengine-api.json @@ -5986,7 +5986,7 @@ } } }, - "revision": "20240912", + "revision": "20240920", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -8216,6 +8216,11 @@ "description": "DataStore captures global settings and configs at the DataStore level.", "id": "GoogleCloudDiscoveryengineV1DataStore", "properties": { + "billingEstimation": { + "$ref": "GoogleCloudDiscoveryengineV1DataStoreBillingEstimation", + "description": "Output only. Data size estimation for billing.", + "readOnly": true + }, "contentConfig": { "description": "Immutable. The content config of the data store. If this field is unset, the server behavior defaults to ContentConfig.NO_CONTENT.", "enum": [ @@ -8309,6 +8314,43 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1DataStoreBillingEstimation": { + "description": "Estimation of data size per data store.", + "id": "GoogleCloudDiscoveryengineV1DataStoreBillingEstimation", + "properties": { + "structuredDataSize": { + "description": "Data size for structured data in terms of bytes.", + "format": "int64", + "type": "string" + }, + "structuredDataUpdateTime": { + "description": "Last updated timestamp for structured data.", + "format": "google-datetime", + "type": "string" + }, + "unstructuredDataSize": { + "description": "Data size for unstructured data in terms of bytes.", + "format": "int64", + "type": "string" + }, + "unstructuredDataUpdateTime": { + "description": "Last updated timestamp for unstructured data.", + "format": "google-datetime", + "type": "string" + }, + "websiteDataSize": { + "description": "Data size for websites in terms of bytes.", + "format": "int64", + "type": "string" + }, + "websiteDataUpdateTime": { + "description": "Last updated timestamp for websites.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1DeleteDataStoreMetadata": { "description": "Metadata related to the progress of the DataStoreService.DeleteDataStore operation. This will be returned by the google.longrunning.Operation.metadata field.", "id": "GoogleCloudDiscoveryengineV1DeleteDataStoreMetadata", @@ -10574,6 +10616,10 @@ "dataStore": { "description": "Required. Full resource name of DataStore, such as `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`.", "type": "string" + }, + "filter": { + "description": "Optional. Filter specification to filter documents in the data store specified by data_store field. For more information on filtering, see [Filtering](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)", + "type": "string" } }, "type": "object" @@ -12551,6 +12597,11 @@ "description": "Immutable. Whether data in the DataStore has ACL information. If set to `true`, the source data must have ACL. ACL will be ingested when data is ingested by DocumentService.ImportDocuments methods. When ACL is enabled for the DataStore, Document can't be accessed by calling DocumentService.GetDocument or DocumentService.ListDocuments. Currently ACL is only supported in `GENERIC` industry vertical with non-`PUBLIC_WEBSITE` content config.", "type": "boolean" }, + "billingEstimation": { + "$ref": "GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation", + "description": "Output only. Data size estimation for billing.", + "readOnly": true + }, "contentConfig": { "description": "Immutable. The content config of the data store. If this field is unset, the server behavior defaults to ContentConfig.NO_CONTENT.", "enum": [ @@ -12657,6 +12708,43 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation": { + "description": "Estimation of data size per data store.", + "id": "GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation", + "properties": { + "structuredDataSize": { + "description": "Data size for structured data in terms of bytes.", + "format": "int64", + "type": "string" + }, + "structuredDataUpdateTime": { + "description": "Last updated timestamp for structured data.", + "format": "google-datetime", + "type": "string" + }, + "unstructuredDataSize": { + "description": "Data size for unstructured data in terms of bytes.", + "format": "int64", + "type": "string" + }, + "unstructuredDataUpdateTime": { + "description": "Last updated timestamp for unstructured data.", + "format": "google-datetime", + "type": "string" + }, + "websiteDataSize": { + "description": "Data size for websites in terms of bytes.", + "format": "int64", + "type": "string" + }, + "websiteDataUpdateTime": { + "description": "Last updated timestamp for websites.", + "format": "google-datetime", + "type": "string" + } + }, + "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", @@ -13393,6 +13481,10 @@ "readOnly": true, "type": "string" }, + "metatagName": { + "description": "Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.", + "type": "string" + }, "recsFilterableOption": { "description": "If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.", "enum": [ @@ -14370,6 +14462,10 @@ "description": "Additional search parameters. For public website search only, supported values are: * `user_country_code`: string. Default empty. If set to non-empty, results are restricted or boosted based on the location provided. For example, `user_country_code: \"au\"` For available codes see [Country Codes](https://developers.google.com/custom-search/docs/json_api_reference#countryCodes) * `search_type`: double. Default empty. Enables non-webpage searching depending on the value. The only valid non-default value is 1, which enables image searching. For example, `search_type: 1`", "type": "object" }, + "personalizationSpec": { + "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec", + "description": "The specification for personalization. Notice that if both ServingConfig.personalization_spec and SearchRequest.personalization_spec are set, SearchRequest.personalization_spec overrides ServingConfig.personalization_spec." + }, "query": { "description": "Raw search query.", "type": "string" @@ -14724,6 +14820,10 @@ "dataStore": { "description": "Required. Full resource name of DataStore, such as `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`.", "type": "string" + }, + "filter": { + "description": "Optional. Filter specification to filter documents in the data store specified by data_store field. For more information on filtering, see [Filtering](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)", + "type": "string" } }, "type": "object" @@ -14874,6 +14974,27 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec": { + "description": "The specification for personalization.", + "id": "GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec", + "properties": { + "mode": { + "description": "The personalization mode of the search request. Defaults to Mode.AUTO.", + "enum": [ + "MODE_UNSPECIFIED", + "AUTO", + "DISABLED" + ], + "enumDescriptions": [ + "Default value. In this case, server behavior defaults to Mode.AUTO.", + "Personalization is enabled if data quality requirements are met.", + "Disable personalization." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaSearchRequestQueryExpansionSpec": { "description": "Specification to determine under which conditions query expansion should occur.", "id": "GoogleCloudDiscoveryengineV1alphaSearchRequestQueryExpansionSpec", @@ -15700,6 +15821,11 @@ "description": "DataStore captures global settings and configs at the DataStore level.", "id": "GoogleCloudDiscoveryengineV1betaDataStore", "properties": { + "billingEstimation": { + "$ref": "GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation", + "description": "Output only. Data size estimation for billing.", + "readOnly": true + }, "contentConfig": { "description": "Immutable. The content config of the data store. If this field is unset, the server behavior defaults to ContentConfig.NO_CONTENT.", "enum": [ @@ -15801,6 +15927,43 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation": { + "description": "Estimation of data size per data store.", + "id": "GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation", + "properties": { + "structuredDataSize": { + "description": "Data size for structured data in terms of bytes.", + "format": "int64", + "type": "string" + }, + "structuredDataUpdateTime": { + "description": "Last updated timestamp for structured data.", + "format": "google-datetime", + "type": "string" + }, + "unstructuredDataSize": { + "description": "Data size for unstructured data in terms of bytes.", + "format": "int64", + "type": "string" + }, + "unstructuredDataUpdateTime": { + "description": "Last updated timestamp for unstructured data.", + "format": "google-datetime", + "type": "string" + }, + "websiteDataSize": { + "description": "Data size for websites in terms of bytes.", + "format": "int64", + "type": "string" + }, + "websiteDataUpdateTime": { + "description": "Last updated timestamp for websites.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaDeleteDataStoreMetadata": { "description": "Metadata related to the progress of the DataStoreService.DeleteDataStore operation. This will be returned by the google.longrunning.Operation.metadata field.", "id": "GoogleCloudDiscoveryengineV1betaDeleteDataStoreMetadata", @@ -16951,6 +17114,10 @@ "description": "Additional search parameters. For public website search only, supported values are: * `user_country_code`: string. Default empty. If set to non-empty, results are restricted or boosted based on the location provided. For example, `user_country_code: \"au\"` For available codes see [Country Codes](https://developers.google.com/custom-search/docs/json_api_reference#countryCodes) * `search_type`: double. Default empty. Enables non-webpage searching depending on the value. The only valid non-default value is 1, which enables image searching. For example, `search_type: 1`", "type": "object" }, + "personalizationSpec": { + "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec", + "description": "The specification for personalization. Notice that if both ServingConfig.personalization_spec and SearchRequest.personalization_spec are set, SearchRequest.personalization_spec overrides ServingConfig.personalization_spec." + }, "query": { "description": "Raw search query.", "type": "string" @@ -17305,6 +17472,10 @@ "dataStore": { "description": "Required. Full resource name of DataStore, such as `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`.", "type": "string" + }, + "filter": { + "description": "Optional. Filter specification to filter documents in the data store specified by data_store field. For more information on filtering, see [Filtering](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)", + "type": "string" } }, "type": "object" @@ -17455,6 +17626,27 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec": { + "description": "The specification for personalization.", + "id": "GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec", + "properties": { + "mode": { + "description": "The personalization mode of the search request. Defaults to Mode.AUTO.", + "enum": [ + "MODE_UNSPECIFIED", + "AUTO", + "DISABLED" + ], + "enumDescriptions": [ + "Default value. In this case, server behavior defaults to Mode.AUTO.", + "Personalization is enabled if data quality requirements are met.", + "Disable personalization." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaSearchRequestQueryExpansionSpec": { "description": "Specification to determine under which conditions query expansion should occur.", "id": "GoogleCloudDiscoveryengineV1betaSearchRequestQueryExpansionSpec", diff --git a/discoveryengine/v1/discoveryengine-gen.go b/discoveryengine/v1/discoveryengine-gen.go index 073ef50bfd1..3d8f99ae0e4 100644 --- a/discoveryengine/v1/discoveryengine-gen.go +++ b/discoveryengine/v1/discoveryengine-gen.go @@ -3986,6 +3986,8 @@ func (s GoogleCloudDiscoveryengineV1CustomTuningModel) MarshalJSON() ([]byte, er // GoogleCloudDiscoveryengineV1DataStore: DataStore captures global settings // and configs at the DataStore level. type GoogleCloudDiscoveryengineV1DataStore struct { + // BillingEstimation: Output only. Data size estimation for billing. + BillingEstimation *GoogleCloudDiscoveryengineV1DataStoreBillingEstimation `json:"billingEstimation,omitempty"` // ContentConfig: Immutable. The content config of the data store. If this // field is unset, the server behavior defaults to ContentConfig.NO_CONTENT. // @@ -4058,15 +4060,15 @@ type GoogleCloudDiscoveryengineV1DataStore struct { // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "ContentConfig") to + // ForceSendFields is a list of field names (e.g. "BillingEstimation") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ContentConfig") 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. "BillingEstimation") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -4076,6 +4078,39 @@ func (s GoogleCloudDiscoveryengineV1DataStore) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1DataStoreBillingEstimation: Estimation of data +// size per data store. +type GoogleCloudDiscoveryengineV1DataStoreBillingEstimation struct { + // StructuredDataSize: Data size for structured data in terms of bytes. + StructuredDataSize int64 `json:"structuredDataSize,omitempty,string"` + // StructuredDataUpdateTime: Last updated timestamp for structured data. + StructuredDataUpdateTime string `json:"structuredDataUpdateTime,omitempty"` + // UnstructuredDataSize: Data size for unstructured data in terms of bytes. + UnstructuredDataSize int64 `json:"unstructuredDataSize,omitempty,string"` + // UnstructuredDataUpdateTime: Last updated timestamp for unstructured data. + UnstructuredDataUpdateTime string `json:"unstructuredDataUpdateTime,omitempty"` + // WebsiteDataSize: Data size for websites in terms of bytes. + WebsiteDataSize int64 `json:"websiteDataSize,omitempty,string"` + // WebsiteDataUpdateTime: Last updated timestamp for websites. + WebsiteDataUpdateTime string `json:"websiteDataUpdateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "StructuredDataSize") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "StructuredDataSize") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1DataStoreBillingEstimation) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DataStoreBillingEstimation + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1DeleteDataStoreMetadata: Metadata related to the // progress of the DataStoreService.DeleteDataStore operation. This will be // returned by the google.longrunning.Operation.metadata field. @@ -7509,6 +7544,11 @@ type GoogleCloudDiscoveryengineV1SearchRequestDataStoreSpec struct { // `projects/{project}/locations/{location}/collections/{collection_id}/dataStor // es/{data_store_id}`. DataStore string `json:"dataStore,omitempty"` + // Filter: Optional. Filter specification to filter documents in the data store + // specified by data_store field. For more information on filtering, see + // Filtering + // (https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata) + Filter string `json:"filter,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 @@ -10277,6 +10317,8 @@ type GoogleCloudDiscoveryengineV1alphaDataStore struct { // is only supported in `GENERIC` industry vertical with non-`PUBLIC_WEBSITE` // content config. AclEnabled bool `json:"aclEnabled,omitempty"` + // BillingEstimation: Output only. Data size estimation for billing. + BillingEstimation *GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation `json:"billingEstimation,omitempty"` // ContentConfig: Immutable. The content config of the data store. If this // field is unset, the server behavior defaults to ContentConfig.NO_CONTENT. // @@ -10371,6 +10413,39 @@ func (s GoogleCloudDiscoveryengineV1alphaDataStore) MarshalJSON() ([]byte, error return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation: Estimation of +// data size per data store. +type GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation struct { + // StructuredDataSize: Data size for structured data in terms of bytes. + StructuredDataSize int64 `json:"structuredDataSize,omitempty,string"` + // StructuredDataUpdateTime: Last updated timestamp for structured data. + StructuredDataUpdateTime string `json:"structuredDataUpdateTime,omitempty"` + // UnstructuredDataSize: Data size for unstructured data in terms of bytes. + UnstructuredDataSize int64 `json:"unstructuredDataSize,omitempty,string"` + // UnstructuredDataUpdateTime: Last updated timestamp for unstructured data. + UnstructuredDataUpdateTime string `json:"unstructuredDataUpdateTime,omitempty"` + // WebsiteDataSize: Data size for websites in terms of bytes. + WebsiteDataSize int64 `json:"websiteDataSize,omitempty,string"` + // WebsiteDataUpdateTime: Last updated timestamp for websites. + WebsiteDataUpdateTime string `json:"websiteDataUpdateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "StructuredDataSize") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "StructuredDataSize") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation + 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. @@ -11367,6 +11442,11 @@ type GoogleCloudDiscoveryengineV1alphaFieldConfig struct { // a `KeyPropertyMapping` annotation, `indexable_option` and // `searchable_option` of this field cannot be modified. KeyPropertyType string `json:"keyPropertyType,omitempty"` + // MetatagName: Optional. The metatag name found in the HTML page. If user + // defines this field, the value of this metatag name will be used to extract + // metatag. If the user does not define this field, the FieldConfig.field_path + // will be used to extract metatag. + MetatagName string `json:"metatagName,omitempty"` // RecsFilterableOption: If recs_filterable_option is FILTERABLE_ENABLED, field // values are filterable by filter expression in // RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is @@ -12679,6 +12759,12 @@ type GoogleCloudDiscoveryengineV1alphaSearchRequest struct { // depending on the value. The only valid non-default value is 1, which enables // image searching. For example, `search_type: 1` Params googleapi.RawMessage `json:"params,omitempty"` + // PersonalizationSpec: The specification for personalization. Notice that if + // both ServingConfig.personalization_spec and + // SearchRequest.personalization_spec are set, + // SearchRequest.personalization_spec overrides + // ServingConfig.personalization_spec. + PersonalizationSpec *GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec `json:"personalizationSpec,omitempty"` // Query: Raw search query. Query string `json:"query,omitempty"` // QueryExpansionSpec: The query expansion specification that specifies the @@ -13295,6 +13381,11 @@ type GoogleCloudDiscoveryengineV1alphaSearchRequestDataStoreSpec struct { // `projects/{project}/locations/{location}/collections/{collection_id}/dataStor // es/{data_store_id}`. DataStore string `json:"dataStore,omitempty"` + // Filter: Optional. Filter specification to filter documents in the data store + // specified by data_store field. For more information on filtering, see + // Filtering + // (https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata) + Filter string `json:"filter,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 @@ -13564,6 +13655,35 @@ func (s GoogleCloudDiscoveryengineV1alphaSearchRequestNaturalLanguageQueryUnders return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec: The +// specification for personalization. +type GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec struct { + // Mode: The personalization mode of the search request. Defaults to Mode.AUTO. + // + // Possible values: + // "MODE_UNSPECIFIED" - Default value. In this case, server behavior defaults + // to Mode.AUTO. + // "AUTO" - Personalization is enabled if data quality requirements are met. + // "DISABLED" - Disable personalization. + Mode string `json:"mode,omitempty"` + // ForceSendFields is a list of field names (e.g. "Mode") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Mode") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaSearchRequestQueryExpansionSpec: // Specification to determine under which conditions query expansion should // occur. @@ -14691,6 +14811,8 @@ func (s GoogleCloudDiscoveryengineV1betaCustomTuningModel) MarshalJSON() ([]byte // GoogleCloudDiscoveryengineV1betaDataStore: DataStore captures global // settings and configs at the DataStore level. type GoogleCloudDiscoveryengineV1betaDataStore struct { + // BillingEstimation: Output only. Data size estimation for billing. + BillingEstimation *GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation `json:"billingEstimation,omitempty"` // ContentConfig: Immutable. The content config of the data store. If this // field is unset, the server behavior defaults to ContentConfig.NO_CONTENT. // @@ -14765,15 +14887,15 @@ type GoogleCloudDiscoveryengineV1betaDataStore struct { // data. This must be set when DataStore.content_config is set as // DataStore.ContentConfig.GOOGLE_WORKSPACE. WorkspaceConfig *GoogleCloudDiscoveryengineV1betaWorkspaceConfig `json:"workspaceConfig,omitempty"` - // ForceSendFields is a list of field names (e.g. "ContentConfig") to + // ForceSendFields is a list of field names (e.g. "BillingEstimation") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ContentConfig") 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. "BillingEstimation") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -14783,6 +14905,39 @@ func (s GoogleCloudDiscoveryengineV1betaDataStore) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation: Estimation of +// data size per data store. +type GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation struct { + // StructuredDataSize: Data size for structured data in terms of bytes. + StructuredDataSize int64 `json:"structuredDataSize,omitempty,string"` + // StructuredDataUpdateTime: Last updated timestamp for structured data. + StructuredDataUpdateTime string `json:"structuredDataUpdateTime,omitempty"` + // UnstructuredDataSize: Data size for unstructured data in terms of bytes. + UnstructuredDataSize int64 `json:"unstructuredDataSize,omitempty,string"` + // UnstructuredDataUpdateTime: Last updated timestamp for unstructured data. + UnstructuredDataUpdateTime string `json:"unstructuredDataUpdateTime,omitempty"` + // WebsiteDataSize: Data size for websites in terms of bytes. + WebsiteDataSize int64 `json:"websiteDataSize,omitempty,string"` + // WebsiteDataUpdateTime: Last updated timestamp for websites. + WebsiteDataUpdateTime string `json:"websiteDataUpdateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "StructuredDataSize") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "StructuredDataSize") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1betaDeleteDataStoreMetadata: Metadata related to // the progress of the DataStoreService.DeleteDataStore operation. This will be // returned by the google.longrunning.Operation.metadata field. @@ -16365,6 +16520,12 @@ type GoogleCloudDiscoveryengineV1betaSearchRequest struct { // depending on the value. The only valid non-default value is 1, which enables // image searching. For example, `search_type: 1` Params googleapi.RawMessage `json:"params,omitempty"` + // PersonalizationSpec: The specification for personalization. Notice that if + // both ServingConfig.personalization_spec and + // SearchRequest.personalization_spec are set, + // SearchRequest.personalization_spec overrides + // ServingConfig.personalization_spec. + PersonalizationSpec *GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec `json:"personalizationSpec,omitempty"` // Query: Raw search query. Query string `json:"query,omitempty"` // QueryExpansionSpec: The query expansion specification that specifies the @@ -16981,6 +17142,11 @@ type GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec struct { // `projects/{project}/locations/{location}/collections/{collection_id}/dataStor // es/{data_store_id}`. DataStore string `json:"dataStore,omitempty"` + // Filter: Optional. Filter specification to filter documents in the data store + // specified by data_store field. For more information on filtering, see + // Filtering + // (https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata) + Filter string `json:"filter,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 @@ -17250,6 +17416,35 @@ func (s GoogleCloudDiscoveryengineV1betaSearchRequestNaturalLanguageQueryUnderst return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec: The +// specification for personalization. +type GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec struct { + // Mode: The personalization mode of the search request. Defaults to Mode.AUTO. + // + // Possible values: + // "MODE_UNSPECIFIED" - Default value. In this case, server behavior defaults + // to Mode.AUTO. + // "AUTO" - Personalization is enabled if data quality requirements are met. + // "DISABLED" - Disable personalization. + Mode string `json:"mode,omitempty"` + // ForceSendFields is a list of field names (e.g. "Mode") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Mode") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1betaSearchRequestQueryExpansionSpec: // Specification to determine under which conditions query expansion should // occur. diff --git a/discoveryengine/v1alpha/discoveryengine-api.json b/discoveryengine/v1alpha/discoveryengine-api.json index d0a27b0fa84..97b8cebeb08 100644 --- a/discoveryengine/v1alpha/discoveryengine-api.json +++ b/discoveryengine/v1alpha/discoveryengine-api.json @@ -7517,7 +7517,7 @@ } } }, - "revision": "20240912", + "revision": "20240920", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiDistribution": { @@ -8149,6 +8149,11 @@ "description": "DataStore captures global settings and configs at the DataStore level.", "id": "GoogleCloudDiscoveryengineV1DataStore", "properties": { + "billingEstimation": { + "$ref": "GoogleCloudDiscoveryengineV1DataStoreBillingEstimation", + "description": "Output only. Data size estimation for billing.", + "readOnly": true + }, "contentConfig": { "description": "Immutable. The content config of the data store. If this field is unset, the server behavior defaults to ContentConfig.NO_CONTENT.", "enum": [ @@ -8242,6 +8247,43 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1DataStoreBillingEstimation": { + "description": "Estimation of data size per data store.", + "id": "GoogleCloudDiscoveryengineV1DataStoreBillingEstimation", + "properties": { + "structuredDataSize": { + "description": "Data size for structured data in terms of bytes.", + "format": "int64", + "type": "string" + }, + "structuredDataUpdateTime": { + "description": "Last updated timestamp for structured data.", + "format": "google-datetime", + "type": "string" + }, + "unstructuredDataSize": { + "description": "Data size for unstructured data in terms of bytes.", + "format": "int64", + "type": "string" + }, + "unstructuredDataUpdateTime": { + "description": "Last updated timestamp for unstructured data.", + "format": "google-datetime", + "type": "string" + }, + "websiteDataSize": { + "description": "Data size for websites in terms of bytes.", + "format": "int64", + "type": "string" + }, + "websiteDataUpdateTime": { + "description": "Last updated timestamp for websites.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1DeleteDataStoreMetadata": { "description": "Metadata related to the progress of the DataStoreService.DeleteDataStore operation. This will be returned by the google.longrunning.Operation.metadata field.", "id": "GoogleCloudDiscoveryengineV1DeleteDataStoreMetadata", @@ -11544,6 +11586,11 @@ "description": "Immutable. Whether data in the DataStore has ACL information. If set to `true`, the source data must have ACL. ACL will be ingested when data is ingested by DocumentService.ImportDocuments methods. When ACL is enabled for the DataStore, Document can't be accessed by calling DocumentService.GetDocument or DocumentService.ListDocuments. Currently ACL is only supported in `GENERIC` industry vertical with non-`PUBLIC_WEBSITE` content config.", "type": "boolean" }, + "billingEstimation": { + "$ref": "GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation", + "description": "Output only. Data size estimation for billing.", + "readOnly": true + }, "contentConfig": { "description": "Immutable. The content config of the data store. If this field is unset, the server behavior defaults to ContentConfig.NO_CONTENT.", "enum": [ @@ -11650,6 +11697,43 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation": { + "description": "Estimation of data size per data store.", + "id": "GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation", + "properties": { + "structuredDataSize": { + "description": "Data size for structured data in terms of bytes.", + "format": "int64", + "type": "string" + }, + "structuredDataUpdateTime": { + "description": "Last updated timestamp for structured data.", + "format": "google-datetime", + "type": "string" + }, + "unstructuredDataSize": { + "description": "Data size for unstructured data in terms of bytes.", + "format": "int64", + "type": "string" + }, + "unstructuredDataUpdateTime": { + "description": "Last updated timestamp for unstructured data.", + "format": "google-datetime", + "type": "string" + }, + "websiteDataSize": { + "description": "Data size for websites in terms of bytes.", + "format": "int64", + "type": "string" + }, + "websiteDataUpdateTime": { + "description": "Last updated timestamp for websites.", + "format": "google-datetime", + "type": "string" + } + }, + "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", @@ -12729,6 +12813,10 @@ "readOnly": true, "type": "string" }, + "metatagName": { + "description": "Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.", + "type": "string" + }, "recsFilterableOption": { "description": "If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.", "enum": [ @@ -14971,6 +15059,10 @@ "description": "Additional search parameters. For public website search only, supported values are: * `user_country_code`: string. Default empty. If set to non-empty, results are restricted or boosted based on the location provided. For example, `user_country_code: \"au\"` For available codes see [Country Codes](https://developers.google.com/custom-search/docs/json_api_reference#countryCodes) * `search_type`: double. Default empty. Enables non-webpage searching depending on the value. The only valid non-default value is 1, which enables image searching. For example, `search_type: 1`", "type": "object" }, + "personalizationSpec": { + "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec", + "description": "The specification for personalization. Notice that if both ServingConfig.personalization_spec and SearchRequest.personalization_spec are set, SearchRequest.personalization_spec overrides ServingConfig.personalization_spec." + }, "query": { "description": "Raw search query.", "type": "string" @@ -15325,6 +15417,10 @@ "dataStore": { "description": "Required. Full resource name of DataStore, such as `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`.", "type": "string" + }, + "filter": { + "description": "Optional. Filter specification to filter documents in the data store specified by data_store field. For more information on filtering, see [Filtering](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)", + "type": "string" } }, "type": "object" @@ -15475,6 +15571,27 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec": { + "description": "The specification for personalization.", + "id": "GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec", + "properties": { + "mode": { + "description": "The personalization mode of the search request. Defaults to Mode.AUTO.", + "enum": [ + "MODE_UNSPECIFIED", + "AUTO", + "DISABLED" + ], + "enumDescriptions": [ + "Default value. In this case, server behavior defaults to Mode.AUTO.", + "Personalization is enabled if data quality requirements are met.", + "Disable personalization." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaSearchRequestQueryExpansionSpec": { "description": "Specification to determine under which conditions query expansion should occur.", "id": "GoogleCloudDiscoveryengineV1alphaSearchRequestQueryExpansionSpec", @@ -16265,6 +16382,10 @@ }, "type": "array" }, + "personalizationSpec": { + "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec", + "description": "The specification for personalization spec. Notice that if both ServingConfig.personalization_spec and SearchRequest.personalization_spec are set, SearchRequest.personalization_spec overrides ServingConfig.personalization_spec." + }, "rankingExpression": { "description": "The ranking expression controls the customized ranking on retrieval documents. To leverage this, document embedding is required. The ranking expression setting in ServingConfig applies to all search requests served by the serving config. However, if SearchRequest.ranking_expression is specified, it overrides the ServingConfig ranking expression. The ranking expression is a single function or multiple functions that are joined by \"+\". * ranking_expression = function, { \" + \", function }; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between embedding_field_path and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`.", "type": "string" @@ -17392,6 +17513,11 @@ "description": "DataStore captures global settings and configs at the DataStore level.", "id": "GoogleCloudDiscoveryengineV1betaDataStore", "properties": { + "billingEstimation": { + "$ref": "GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation", + "description": "Output only. Data size estimation for billing.", + "readOnly": true + }, "contentConfig": { "description": "Immutable. The content config of the data store. If this field is unset, the server behavior defaults to ContentConfig.NO_CONTENT.", "enum": [ @@ -17493,6 +17619,43 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation": { + "description": "Estimation of data size per data store.", + "id": "GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation", + "properties": { + "structuredDataSize": { + "description": "Data size for structured data in terms of bytes.", + "format": "int64", + "type": "string" + }, + "structuredDataUpdateTime": { + "description": "Last updated timestamp for structured data.", + "format": "google-datetime", + "type": "string" + }, + "unstructuredDataSize": { + "description": "Data size for unstructured data in terms of bytes.", + "format": "int64", + "type": "string" + }, + "unstructuredDataUpdateTime": { + "description": "Last updated timestamp for unstructured data.", + "format": "google-datetime", + "type": "string" + }, + "websiteDataSize": { + "description": "Data size for websites in terms of bytes.", + "format": "int64", + "type": "string" + }, + "websiteDataUpdateTime": { + "description": "Last updated timestamp for websites.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaDeleteDataStoreMetadata": { "description": "Metadata related to the progress of the DataStoreService.DeleteDataStore operation. This will be returned by the google.longrunning.Operation.metadata field.", "id": "GoogleCloudDiscoveryengineV1betaDeleteDataStoreMetadata", @@ -18643,6 +18806,10 @@ "description": "Additional search parameters. For public website search only, supported values are: * `user_country_code`: string. Default empty. If set to non-empty, results are restricted or boosted based on the location provided. For example, `user_country_code: \"au\"` For available codes see [Country Codes](https://developers.google.com/custom-search/docs/json_api_reference#countryCodes) * `search_type`: double. Default empty. Enables non-webpage searching depending on the value. The only valid non-default value is 1, which enables image searching. For example, `search_type: 1`", "type": "object" }, + "personalizationSpec": { + "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec", + "description": "The specification for personalization. Notice that if both ServingConfig.personalization_spec and SearchRequest.personalization_spec are set, SearchRequest.personalization_spec overrides ServingConfig.personalization_spec." + }, "query": { "description": "Raw search query.", "type": "string" @@ -18997,6 +19164,10 @@ "dataStore": { "description": "Required. Full resource name of DataStore, such as `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`.", "type": "string" + }, + "filter": { + "description": "Optional. Filter specification to filter documents in the data store specified by data_store field. For more information on filtering, see [Filtering](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)", + "type": "string" } }, "type": "object" @@ -19147,6 +19318,27 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec": { + "description": "The specification for personalization.", + "id": "GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec", + "properties": { + "mode": { + "description": "The personalization mode of the search request. Defaults to Mode.AUTO.", + "enum": [ + "MODE_UNSPECIFIED", + "AUTO", + "DISABLED" + ], + "enumDescriptions": [ + "Default value. In this case, server behavior defaults to Mode.AUTO.", + "Personalization is enabled if data quality requirements are met.", + "Disable personalization." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaSearchRequestQueryExpansionSpec": { "description": "Specification to determine under which conditions query expansion should occur.", "id": "GoogleCloudDiscoveryengineV1betaSearchRequestQueryExpansionSpec", diff --git a/discoveryengine/v1alpha/discoveryengine-gen.go b/discoveryengine/v1alpha/discoveryengine-gen.go index ed9a87fb12e..0304e26ff58 100644 --- a/discoveryengine/v1alpha/discoveryengine-gen.go +++ b/discoveryengine/v1alpha/discoveryengine-gen.go @@ -2049,6 +2049,8 @@ func (s GoogleCloudDiscoveryengineV1CreateTargetSiteMetadata) MarshalJSON() ([]b // GoogleCloudDiscoveryengineV1DataStore: DataStore captures global settings // and configs at the DataStore level. type GoogleCloudDiscoveryengineV1DataStore struct { + // BillingEstimation: Output only. Data size estimation for billing. + BillingEstimation *GoogleCloudDiscoveryengineV1DataStoreBillingEstimation `json:"billingEstimation,omitempty"` // ContentConfig: Immutable. The content config of the data store. If this // field is unset, the server behavior defaults to ContentConfig.NO_CONTENT. // @@ -2118,15 +2120,15 @@ type GoogleCloudDiscoveryengineV1DataStore struct { // data. This must be set when DataStore.content_config is set as // DataStore.ContentConfig.GOOGLE_WORKSPACE. WorkspaceConfig *GoogleCloudDiscoveryengineV1WorkspaceConfig `json:"workspaceConfig,omitempty"` - // ForceSendFields is a list of field names (e.g. "ContentConfig") to + // ForceSendFields is a list of field names (e.g. "BillingEstimation") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ContentConfig") 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. "BillingEstimation") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -2136,6 +2138,39 @@ func (s GoogleCloudDiscoveryengineV1DataStore) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1DataStoreBillingEstimation: Estimation of data +// size per data store. +type GoogleCloudDiscoveryengineV1DataStoreBillingEstimation struct { + // StructuredDataSize: Data size for structured data in terms of bytes. + StructuredDataSize int64 `json:"structuredDataSize,omitempty,string"` + // StructuredDataUpdateTime: Last updated timestamp for structured data. + StructuredDataUpdateTime string `json:"structuredDataUpdateTime,omitempty"` + // UnstructuredDataSize: Data size for unstructured data in terms of bytes. + UnstructuredDataSize int64 `json:"unstructuredDataSize,omitempty,string"` + // UnstructuredDataUpdateTime: Last updated timestamp for unstructured data. + UnstructuredDataUpdateTime string `json:"unstructuredDataUpdateTime,omitempty"` + // WebsiteDataSize: Data size for websites in terms of bytes. + WebsiteDataSize int64 `json:"websiteDataSize,omitempty,string"` + // WebsiteDataUpdateTime: Last updated timestamp for websites. + WebsiteDataUpdateTime string `json:"websiteDataUpdateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "StructuredDataSize") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "StructuredDataSize") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1DataStoreBillingEstimation) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DataStoreBillingEstimation + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1DeleteDataStoreMetadata: Metadata related to the // progress of the DataStoreService.DeleteDataStore operation. This will be // returned by the google.longrunning.Operation.metadata field. @@ -6674,6 +6709,8 @@ type GoogleCloudDiscoveryengineV1alphaDataStore struct { // is only supported in `GENERIC` industry vertical with non-`PUBLIC_WEBSITE` // content config. AclEnabled bool `json:"aclEnabled,omitempty"` + // BillingEstimation: Output only. Data size estimation for billing. + BillingEstimation *GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation `json:"billingEstimation,omitempty"` // ContentConfig: Immutable. The content config of the data store. If this // field is unset, the server behavior defaults to ContentConfig.NO_CONTENT. // @@ -6771,6 +6808,39 @@ func (s GoogleCloudDiscoveryengineV1alphaDataStore) MarshalJSON() ([]byte, error return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation: Estimation of +// data size per data store. +type GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation struct { + // StructuredDataSize: Data size for structured data in terms of bytes. + StructuredDataSize int64 `json:"structuredDataSize,omitempty,string"` + // StructuredDataUpdateTime: Last updated timestamp for structured data. + StructuredDataUpdateTime string `json:"structuredDataUpdateTime,omitempty"` + // UnstructuredDataSize: Data size for unstructured data in terms of bytes. + UnstructuredDataSize int64 `json:"unstructuredDataSize,omitempty,string"` + // UnstructuredDataUpdateTime: Last updated timestamp for unstructured data. + UnstructuredDataUpdateTime string `json:"unstructuredDataUpdateTime,omitempty"` + // WebsiteDataSize: Data size for websites in terms of bytes. + WebsiteDataSize int64 `json:"websiteDataSize,omitempty,string"` + // WebsiteDataUpdateTime: Last updated timestamp for websites. + WebsiteDataUpdateTime string `json:"websiteDataUpdateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "StructuredDataSize") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "StructuredDataSize") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation + 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. @@ -8281,6 +8351,11 @@ type GoogleCloudDiscoveryengineV1alphaFieldConfig struct { // a `KeyPropertyMapping` annotation, `indexable_option` and // `searchable_option` of this field cannot be modified. KeyPropertyType string `json:"keyPropertyType,omitempty"` + // MetatagName: Optional. The metatag name found in the HTML page. If user + // defines this field, the value of this metatag name will be used to extract + // metatag. If the user does not define this field, the FieldConfig.field_path + // will be used to extract metatag. + MetatagName string `json:"metatagName,omitempty"` // RecsFilterableOption: If recs_filterable_option is FILTERABLE_ENABLED, field // values are filterable by filter expression in // RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is @@ -11596,6 +11671,12 @@ type GoogleCloudDiscoveryengineV1alphaSearchRequest struct { // depending on the value. The only valid non-default value is 1, which enables // image searching. For example, `search_type: 1` Params googleapi.RawMessage `json:"params,omitempty"` + // PersonalizationSpec: The specification for personalization. Notice that if + // both ServingConfig.personalization_spec and + // SearchRequest.personalization_spec are set, + // SearchRequest.personalization_spec overrides + // ServingConfig.personalization_spec. + PersonalizationSpec *GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec `json:"personalizationSpec,omitempty"` // Query: Raw search query. Query string `json:"query,omitempty"` // QueryExpansionSpec: The query expansion specification that specifies the @@ -12212,6 +12293,11 @@ type GoogleCloudDiscoveryengineV1alphaSearchRequestDataStoreSpec struct { // `projects/{project}/locations/{location}/collections/{collection_id}/dataStor // es/{data_store_id}`. DataStore string `json:"dataStore,omitempty"` + // Filter: Optional. Filter specification to filter documents in the data store + // specified by data_store field. For more information on filtering, see + // Filtering + // (https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata) + Filter string `json:"filter,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 @@ -12481,6 +12567,35 @@ func (s GoogleCloudDiscoveryengineV1alphaSearchRequestNaturalLanguageQueryUnders return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec: The +// specification for personalization. +type GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec struct { + // Mode: The personalization mode of the search request. Defaults to Mode.AUTO. + // + // Possible values: + // "MODE_UNSPECIFIED" - Default value. In this case, server behavior defaults + // to Mode.AUTO. + // "AUTO" - Personalization is enabled if data quality requirements are met. + // "DISABLED" - Disable personalization. + Mode string `json:"mode,omitempty"` + // ForceSendFields is a list of field names (e.g. "Mode") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Mode") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaSearchRequestQueryExpansionSpec: // Specification to determine under which conditions query expansion should // occur. @@ -13551,6 +13666,12 @@ type GoogleCloudDiscoveryengineV1alphaServingConfig struct { // controls in the list will execute. Maximum number of specifications is 100. // Can only be set if SolutionType is SOLUTION_TYPE_SEARCH. OnewaySynonymsControlIds []string `json:"onewaySynonymsControlIds,omitempty"` + // PersonalizationSpec: The specification for personalization spec. Notice that + // if both ServingConfig.personalization_spec and + // SearchRequest.personalization_spec are set, + // SearchRequest.personalization_spec overrides + // ServingConfig.personalization_spec. + PersonalizationSpec *GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec `json:"personalizationSpec,omitempty"` // RankingExpression: The ranking expression controls the customized ranking on // retrieval documents. To leverage this, document embedding is required. The // ranking expression setting in ServingConfig applies to all search requests @@ -15157,6 +15278,8 @@ func (s GoogleCloudDiscoveryengineV1betaCustomTuningModel) MarshalJSON() ([]byte // GoogleCloudDiscoveryengineV1betaDataStore: DataStore captures global // settings and configs at the DataStore level. type GoogleCloudDiscoveryengineV1betaDataStore struct { + // BillingEstimation: Output only. Data size estimation for billing. + BillingEstimation *GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation `json:"billingEstimation,omitempty"` // ContentConfig: Immutable. The content config of the data store. If this // field is unset, the server behavior defaults to ContentConfig.NO_CONTENT. // @@ -15231,15 +15354,15 @@ type GoogleCloudDiscoveryengineV1betaDataStore struct { // data. This must be set when DataStore.content_config is set as // DataStore.ContentConfig.GOOGLE_WORKSPACE. WorkspaceConfig *GoogleCloudDiscoveryengineV1betaWorkspaceConfig `json:"workspaceConfig,omitempty"` - // ForceSendFields is a list of field names (e.g. "ContentConfig") to + // ForceSendFields is a list of field names (e.g. "BillingEstimation") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ContentConfig") 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. "BillingEstimation") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -15249,6 +15372,39 @@ func (s GoogleCloudDiscoveryengineV1betaDataStore) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation: Estimation of +// data size per data store. +type GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation struct { + // StructuredDataSize: Data size for structured data in terms of bytes. + StructuredDataSize int64 `json:"structuredDataSize,omitempty,string"` + // StructuredDataUpdateTime: Last updated timestamp for structured data. + StructuredDataUpdateTime string `json:"structuredDataUpdateTime,omitempty"` + // UnstructuredDataSize: Data size for unstructured data in terms of bytes. + UnstructuredDataSize int64 `json:"unstructuredDataSize,omitempty,string"` + // UnstructuredDataUpdateTime: Last updated timestamp for unstructured data. + UnstructuredDataUpdateTime string `json:"unstructuredDataUpdateTime,omitempty"` + // WebsiteDataSize: Data size for websites in terms of bytes. + WebsiteDataSize int64 `json:"websiteDataSize,omitempty,string"` + // WebsiteDataUpdateTime: Last updated timestamp for websites. + WebsiteDataUpdateTime string `json:"websiteDataUpdateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "StructuredDataSize") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "StructuredDataSize") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1betaDeleteDataStoreMetadata: Metadata related to // the progress of the DataStoreService.DeleteDataStore operation. This will be // returned by the google.longrunning.Operation.metadata field. @@ -16831,6 +16987,12 @@ type GoogleCloudDiscoveryengineV1betaSearchRequest struct { // depending on the value. The only valid non-default value is 1, which enables // image searching. For example, `search_type: 1` Params googleapi.RawMessage `json:"params,omitempty"` + // PersonalizationSpec: The specification for personalization. Notice that if + // both ServingConfig.personalization_spec and + // SearchRequest.personalization_spec are set, + // SearchRequest.personalization_spec overrides + // ServingConfig.personalization_spec. + PersonalizationSpec *GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec `json:"personalizationSpec,omitempty"` // Query: Raw search query. Query string `json:"query,omitempty"` // QueryExpansionSpec: The query expansion specification that specifies the @@ -17447,6 +17609,11 @@ type GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec struct { // `projects/{project}/locations/{location}/collections/{collection_id}/dataStor // es/{data_store_id}`. DataStore string `json:"dataStore,omitempty"` + // Filter: Optional. Filter specification to filter documents in the data store + // specified by data_store field. For more information on filtering, see + // Filtering + // (https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata) + Filter string `json:"filter,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 @@ -17716,6 +17883,35 @@ func (s GoogleCloudDiscoveryengineV1betaSearchRequestNaturalLanguageQueryUnderst return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec: The +// specification for personalization. +type GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec struct { + // Mode: The personalization mode of the search request. Defaults to Mode.AUTO. + // + // Possible values: + // "MODE_UNSPECIFIED" - Default value. In this case, server behavior defaults + // to Mode.AUTO. + // "AUTO" - Personalization is enabled if data quality requirements are met. + // "DISABLED" - Disable personalization. + Mode string `json:"mode,omitempty"` + // ForceSendFields is a list of field names (e.g. "Mode") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Mode") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1betaSearchRequestQueryExpansionSpec: // Specification to determine under which conditions query expansion should // occur. diff --git a/discoveryengine/v1beta/discoveryengine-api.json b/discoveryengine/v1beta/discoveryengine-api.json index dbb78bba9de..a974c6f0372 100644 --- a/discoveryengine/v1beta/discoveryengine-api.json +++ b/discoveryengine/v1beta/discoveryengine-api.json @@ -6786,7 +6786,7 @@ } } }, - "revision": "20240912", + "revision": "20240920", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -7232,6 +7232,11 @@ "description": "DataStore captures global settings and configs at the DataStore level.", "id": "GoogleCloudDiscoveryengineV1DataStore", "properties": { + "billingEstimation": { + "$ref": "GoogleCloudDiscoveryengineV1DataStoreBillingEstimation", + "description": "Output only. Data size estimation for billing.", + "readOnly": true + }, "contentConfig": { "description": "Immutable. The content config of the data store. If this field is unset, the server behavior defaults to ContentConfig.NO_CONTENT.", "enum": [ @@ -7325,6 +7330,43 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1DataStoreBillingEstimation": { + "description": "Estimation of data size per data store.", + "id": "GoogleCloudDiscoveryengineV1DataStoreBillingEstimation", + "properties": { + "structuredDataSize": { + "description": "Data size for structured data in terms of bytes.", + "format": "int64", + "type": "string" + }, + "structuredDataUpdateTime": { + "description": "Last updated timestamp for structured data.", + "format": "google-datetime", + "type": "string" + }, + "unstructuredDataSize": { + "description": "Data size for unstructured data in terms of bytes.", + "format": "int64", + "type": "string" + }, + "unstructuredDataUpdateTime": { + "description": "Last updated timestamp for unstructured data.", + "format": "google-datetime", + "type": "string" + }, + "websiteDataSize": { + "description": "Data size for websites in terms of bytes.", + "format": "int64", + "type": "string" + }, + "websiteDataUpdateTime": { + "description": "Last updated timestamp for websites.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1DeleteDataStoreMetadata": { "description": "Metadata related to the progress of the DataStoreService.DeleteDataStore operation. This will be returned by the google.longrunning.Operation.metadata field.", "id": "GoogleCloudDiscoveryengineV1DeleteDataStoreMetadata", @@ -9288,6 +9330,11 @@ "description": "Immutable. Whether data in the DataStore has ACL information. If set to `true`, the source data must have ACL. ACL will be ingested when data is ingested by DocumentService.ImportDocuments methods. When ACL is enabled for the DataStore, Document can't be accessed by calling DocumentService.GetDocument or DocumentService.ListDocuments. Currently ACL is only supported in `GENERIC` industry vertical with non-`PUBLIC_WEBSITE` content config.", "type": "boolean" }, + "billingEstimation": { + "$ref": "GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation", + "description": "Output only. Data size estimation for billing.", + "readOnly": true + }, "contentConfig": { "description": "Immutable. The content config of the data store. If this field is unset, the server behavior defaults to ContentConfig.NO_CONTENT.", "enum": [ @@ -9394,6 +9441,43 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation": { + "description": "Estimation of data size per data store.", + "id": "GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation", + "properties": { + "structuredDataSize": { + "description": "Data size for structured data in terms of bytes.", + "format": "int64", + "type": "string" + }, + "structuredDataUpdateTime": { + "description": "Last updated timestamp for structured data.", + "format": "google-datetime", + "type": "string" + }, + "unstructuredDataSize": { + "description": "Data size for unstructured data in terms of bytes.", + "format": "int64", + "type": "string" + }, + "unstructuredDataUpdateTime": { + "description": "Last updated timestamp for unstructured data.", + "format": "google-datetime", + "type": "string" + }, + "websiteDataSize": { + "description": "Data size for websites in terms of bytes.", + "format": "int64", + "type": "string" + }, + "websiteDataUpdateTime": { + "description": "Last updated timestamp for websites.", + "format": "google-datetime", + "type": "string" + } + }, + "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", @@ -10130,6 +10214,10 @@ "readOnly": true, "type": "string" }, + "metatagName": { + "description": "Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.", + "type": "string" + }, "recsFilterableOption": { "description": "If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.", "enum": [ @@ -11107,6 +11195,10 @@ "description": "Additional search parameters. For public website search only, supported values are: * `user_country_code`: string. Default empty. If set to non-empty, results are restricted or boosted based on the location provided. For example, `user_country_code: \"au\"` For available codes see [Country Codes](https://developers.google.com/custom-search/docs/json_api_reference#countryCodes) * `search_type`: double. Default empty. Enables non-webpage searching depending on the value. The only valid non-default value is 1, which enables image searching. For example, `search_type: 1`", "type": "object" }, + "personalizationSpec": { + "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec", + "description": "The specification for personalization. Notice that if both ServingConfig.personalization_spec and SearchRequest.personalization_spec are set, SearchRequest.personalization_spec overrides ServingConfig.personalization_spec." + }, "query": { "description": "Raw search query.", "type": "string" @@ -11461,6 +11553,10 @@ "dataStore": { "description": "Required. Full resource name of DataStore, such as `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`.", "type": "string" + }, + "filter": { + "description": "Optional. Filter specification to filter documents in the data store specified by data_store field. For more information on filtering, see [Filtering](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)", + "type": "string" } }, "type": "object" @@ -11611,6 +11707,27 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec": { + "description": "The specification for personalization.", + "id": "GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec", + "properties": { + "mode": { + "description": "The personalization mode of the search request. Defaults to Mode.AUTO.", + "enum": [ + "MODE_UNSPECIFIED", + "AUTO", + "DISABLED" + ], + "enumDescriptions": [ + "Default value. In this case, server behavior defaults to Mode.AUTO.", + "Personalization is enabled if data quality requirements are met.", + "Disable personalization." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaSearchRequestQueryExpansionSpec": { "description": "Specification to determine under which conditions query expansion should occur.", "id": "GoogleCloudDiscoveryengineV1alphaSearchRequestQueryExpansionSpec", @@ -14165,6 +14282,11 @@ "description": "DataStore captures global settings and configs at the DataStore level.", "id": "GoogleCloudDiscoveryengineV1betaDataStore", "properties": { + "billingEstimation": { + "$ref": "GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation", + "description": "Output only. Data size estimation for billing.", + "readOnly": true + }, "contentConfig": { "description": "Immutable. The content config of the data store. If this field is unset, the server behavior defaults to ContentConfig.NO_CONTENT.", "enum": [ @@ -14266,6 +14388,43 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation": { + "description": "Estimation of data size per data store.", + "id": "GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation", + "properties": { + "structuredDataSize": { + "description": "Data size for structured data in terms of bytes.", + "format": "int64", + "type": "string" + }, + "structuredDataUpdateTime": { + "description": "Last updated timestamp for structured data.", + "format": "google-datetime", + "type": "string" + }, + "unstructuredDataSize": { + "description": "Data size for unstructured data in terms of bytes.", + "format": "int64", + "type": "string" + }, + "unstructuredDataUpdateTime": { + "description": "Last updated timestamp for unstructured data.", + "format": "google-datetime", + "type": "string" + }, + "websiteDataSize": { + "description": "Data size for websites in terms of bytes.", + "format": "int64", + "type": "string" + }, + "websiteDataUpdateTime": { + "description": "Last updated timestamp for websites.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaDeleteDataStoreMetadata": { "description": "Metadata related to the progress of the DataStoreService.DeleteDataStore operation. This will be returned by the google.longrunning.Operation.metadata field.", "id": "GoogleCloudDiscoveryengineV1betaDeleteDataStoreMetadata", @@ -16730,6 +16889,10 @@ "description": "Additional search parameters. For public website search only, supported values are: * `user_country_code`: string. Default empty. If set to non-empty, results are restricted or boosted based on the location provided. For example, `user_country_code: \"au\"` For available codes see [Country Codes](https://developers.google.com/custom-search/docs/json_api_reference#countryCodes) * `search_type`: double. Default empty. Enables non-webpage searching depending on the value. The only valid non-default value is 1, which enables image searching. For example, `search_type: 1`", "type": "object" }, + "personalizationSpec": { + "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec", + "description": "The specification for personalization. Notice that if both ServingConfig.personalization_spec and SearchRequest.personalization_spec are set, SearchRequest.personalization_spec overrides ServingConfig.personalization_spec." + }, "query": { "description": "Raw search query.", "type": "string" @@ -17084,6 +17247,10 @@ "dataStore": { "description": "Required. Full resource name of DataStore, such as `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`.", "type": "string" + }, + "filter": { + "description": "Optional. Filter specification to filter documents in the data store specified by data_store field. For more information on filtering, see [Filtering](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)", + "type": "string" } }, "type": "object" @@ -17234,6 +17401,27 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec": { + "description": "The specification for personalization.", + "id": "GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec", + "properties": { + "mode": { + "description": "The personalization mode of the search request. Defaults to Mode.AUTO.", + "enum": [ + "MODE_UNSPECIFIED", + "AUTO", + "DISABLED" + ], + "enumDescriptions": [ + "Default value. In this case, server behavior defaults to Mode.AUTO.", + "Personalization is enabled if data quality requirements are met.", + "Disable personalization." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaSearchRequestQueryExpansionSpec": { "description": "Specification to determine under which conditions query expansion should occur.", "id": "GoogleCloudDiscoveryengineV1betaSearchRequestQueryExpansionSpec", @@ -18016,6 +18204,10 @@ }, "type": "array" }, + "personalizationSpec": { + "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec", + "description": "The specification for personalization spec. Notice that if both ServingConfig.personalization_spec and SearchRequest.personalization_spec are set, SearchRequest.personalization_spec overrides ServingConfig.personalization_spec." + }, "rankingExpression": { "description": "The ranking expression controls the customized ranking on retrieval documents. To leverage this, document embedding is required. The ranking expression setting in ServingConfig applies to all search requests served by the serving config. However, if SearchRequest.ranking_expression is specified, it overrides the ServingConfig ranking expression. The ranking expression is a single function or multiple functions that are joined by \"+\". * ranking_expression = function, { \" + \", function }; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between embedding_field_path and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`.", "type": "string" diff --git a/discoveryengine/v1beta/discoveryengine-gen.go b/discoveryengine/v1beta/discoveryengine-gen.go index 4cdb3ac1de5..d738f40c081 100644 --- a/discoveryengine/v1beta/discoveryengine-gen.go +++ b/discoveryengine/v1beta/discoveryengine-gen.go @@ -1576,6 +1576,8 @@ func (s GoogleCloudDiscoveryengineV1CreateTargetSiteMetadata) MarshalJSON() ([]b // GoogleCloudDiscoveryengineV1DataStore: DataStore captures global settings // and configs at the DataStore level. type GoogleCloudDiscoveryengineV1DataStore struct { + // BillingEstimation: Output only. Data size estimation for billing. + BillingEstimation *GoogleCloudDiscoveryengineV1DataStoreBillingEstimation `json:"billingEstimation,omitempty"` // ContentConfig: Immutable. The content config of the data store. If this // field is unset, the server behavior defaults to ContentConfig.NO_CONTENT. // @@ -1645,15 +1647,15 @@ type GoogleCloudDiscoveryengineV1DataStore struct { // data. This must be set when DataStore.content_config is set as // DataStore.ContentConfig.GOOGLE_WORKSPACE. WorkspaceConfig *GoogleCloudDiscoveryengineV1WorkspaceConfig `json:"workspaceConfig,omitempty"` - // ForceSendFields is a list of field names (e.g. "ContentConfig") to + // ForceSendFields is a list of field names (e.g. "BillingEstimation") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ContentConfig") 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. "BillingEstimation") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -1663,6 +1665,39 @@ func (s GoogleCloudDiscoveryengineV1DataStore) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1DataStoreBillingEstimation: Estimation of data +// size per data store. +type GoogleCloudDiscoveryengineV1DataStoreBillingEstimation struct { + // StructuredDataSize: Data size for structured data in terms of bytes. + StructuredDataSize int64 `json:"structuredDataSize,omitempty,string"` + // StructuredDataUpdateTime: Last updated timestamp for structured data. + StructuredDataUpdateTime string `json:"structuredDataUpdateTime,omitempty"` + // UnstructuredDataSize: Data size for unstructured data in terms of bytes. + UnstructuredDataSize int64 `json:"unstructuredDataSize,omitempty,string"` + // UnstructuredDataUpdateTime: Last updated timestamp for unstructured data. + UnstructuredDataUpdateTime string `json:"unstructuredDataUpdateTime,omitempty"` + // WebsiteDataSize: Data size for websites in terms of bytes. + WebsiteDataSize int64 `json:"websiteDataSize,omitempty,string"` + // WebsiteDataUpdateTime: Last updated timestamp for websites. + WebsiteDataUpdateTime string `json:"websiteDataUpdateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "StructuredDataSize") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "StructuredDataSize") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1DataStoreBillingEstimation) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DataStoreBillingEstimation + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1DeleteDataStoreMetadata: Metadata related to the // progress of the DataStoreService.DeleteDataStore operation. This will be // returned by the google.longrunning.Operation.metadata field. @@ -4266,6 +4301,8 @@ type GoogleCloudDiscoveryengineV1alphaDataStore struct { // is only supported in `GENERIC` industry vertical with non-`PUBLIC_WEBSITE` // content config. AclEnabled bool `json:"aclEnabled,omitempty"` + // BillingEstimation: Output only. Data size estimation for billing. + BillingEstimation *GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation `json:"billingEstimation,omitempty"` // ContentConfig: Immutable. The content config of the data store. If this // field is unset, the server behavior defaults to ContentConfig.NO_CONTENT. // @@ -4360,6 +4397,39 @@ func (s GoogleCloudDiscoveryengineV1alphaDataStore) MarshalJSON() ([]byte, error return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation: Estimation of +// data size per data store. +type GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation struct { + // StructuredDataSize: Data size for structured data in terms of bytes. + StructuredDataSize int64 `json:"structuredDataSize,omitempty,string"` + // StructuredDataUpdateTime: Last updated timestamp for structured data. + StructuredDataUpdateTime string `json:"structuredDataUpdateTime,omitempty"` + // UnstructuredDataSize: Data size for unstructured data in terms of bytes. + UnstructuredDataSize int64 `json:"unstructuredDataSize,omitempty,string"` + // UnstructuredDataUpdateTime: Last updated timestamp for unstructured data. + UnstructuredDataUpdateTime string `json:"unstructuredDataUpdateTime,omitempty"` + // WebsiteDataSize: Data size for websites in terms of bytes. + WebsiteDataSize int64 `json:"websiteDataSize,omitempty,string"` + // WebsiteDataUpdateTime: Last updated timestamp for websites. + WebsiteDataUpdateTime string `json:"websiteDataUpdateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "StructuredDataSize") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "StructuredDataSize") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation + 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. @@ -5356,6 +5426,11 @@ type GoogleCloudDiscoveryengineV1alphaFieldConfig struct { // a `KeyPropertyMapping` annotation, `indexable_option` and // `searchable_option` of this field cannot be modified. KeyPropertyType string `json:"keyPropertyType,omitempty"` + // MetatagName: Optional. The metatag name found in the HTML page. If user + // defines this field, the value of this metatag name will be used to extract + // metatag. If the user does not define this field, the FieldConfig.field_path + // will be used to extract metatag. + MetatagName string `json:"metatagName,omitempty"` // RecsFilterableOption: If recs_filterable_option is FILTERABLE_ENABLED, field // values are filterable by filter expression in // RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is @@ -6668,6 +6743,12 @@ type GoogleCloudDiscoveryengineV1alphaSearchRequest struct { // depending on the value. The only valid non-default value is 1, which enables // image searching. For example, `search_type: 1` Params googleapi.RawMessage `json:"params,omitempty"` + // PersonalizationSpec: The specification for personalization. Notice that if + // both ServingConfig.personalization_spec and + // SearchRequest.personalization_spec are set, + // SearchRequest.personalization_spec overrides + // ServingConfig.personalization_spec. + PersonalizationSpec *GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec `json:"personalizationSpec,omitempty"` // Query: Raw search query. Query string `json:"query,omitempty"` // QueryExpansionSpec: The query expansion specification that specifies the @@ -7284,6 +7365,11 @@ type GoogleCloudDiscoveryengineV1alphaSearchRequestDataStoreSpec struct { // `projects/{project}/locations/{location}/collections/{collection_id}/dataStor // es/{data_store_id}`. DataStore string `json:"dataStore,omitempty"` + // Filter: Optional. Filter specification to filter documents in the data store + // specified by data_store field. For more information on filtering, see + // Filtering + // (https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata) + Filter string `json:"filter,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 @@ -7553,6 +7639,35 @@ func (s GoogleCloudDiscoveryengineV1alphaSearchRequestNaturalLanguageQueryUnders return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec: The +// specification for personalization. +type GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec struct { + // Mode: The personalization mode of the search request. Defaults to Mode.AUTO. + // + // Possible values: + // "MODE_UNSPECIFIED" - Default value. In this case, server behavior defaults + // to Mode.AUTO. + // "AUTO" - Personalization is enabled if data quality requirements are met. + // "DISABLED" - Disable personalization. + Mode string `json:"mode,omitempty"` + // ForceSendFields is a list of field names (e.g. "Mode") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Mode") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaSearchRequestQueryExpansionSpec: // Specification to determine under which conditions query expansion should // occur. @@ -11081,6 +11196,8 @@ func (s GoogleCloudDiscoveryengineV1betaCustomTuningModel) MarshalJSON() ([]byte // GoogleCloudDiscoveryengineV1betaDataStore: DataStore captures global // settings and configs at the DataStore level. type GoogleCloudDiscoveryengineV1betaDataStore struct { + // BillingEstimation: Output only. Data size estimation for billing. + BillingEstimation *GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation `json:"billingEstimation,omitempty"` // ContentConfig: Immutable. The content config of the data store. If this // field is unset, the server behavior defaults to ContentConfig.NO_CONTENT. // @@ -11158,15 +11275,15 @@ type GoogleCloudDiscoveryengineV1betaDataStore struct { // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "ContentConfig") to + // ForceSendFields is a list of field names (e.g. "BillingEstimation") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "ContentConfig") 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. "BillingEstimation") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -11176,6 +11293,39 @@ func (s GoogleCloudDiscoveryengineV1betaDataStore) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation: Estimation of +// data size per data store. +type GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation struct { + // StructuredDataSize: Data size for structured data in terms of bytes. + StructuredDataSize int64 `json:"structuredDataSize,omitempty,string"` + // StructuredDataUpdateTime: Last updated timestamp for structured data. + StructuredDataUpdateTime string `json:"structuredDataUpdateTime,omitempty"` + // UnstructuredDataSize: Data size for unstructured data in terms of bytes. + UnstructuredDataSize int64 `json:"unstructuredDataSize,omitempty,string"` + // UnstructuredDataUpdateTime: Last updated timestamp for unstructured data. + UnstructuredDataUpdateTime string `json:"unstructuredDataUpdateTime,omitempty"` + // WebsiteDataSize: Data size for websites in terms of bytes. + WebsiteDataSize int64 `json:"websiteDataSize,omitempty,string"` + // WebsiteDataUpdateTime: Last updated timestamp for websites. + WebsiteDataUpdateTime string `json:"websiteDataUpdateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "StructuredDataSize") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "StructuredDataSize") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1betaDeleteDataStoreMetadata: Metadata related to // the progress of the DataStoreService.DeleteDataStore operation. This will be // returned by the google.longrunning.Operation.metadata field. @@ -14806,6 +14956,12 @@ type GoogleCloudDiscoveryengineV1betaSearchRequest struct { // depending on the value. The only valid non-default value is 1, which enables // image searching. For example, `search_type: 1` Params googleapi.RawMessage `json:"params,omitempty"` + // PersonalizationSpec: The specification for personalization. Notice that if + // both ServingConfig.personalization_spec and + // SearchRequest.personalization_spec are set, + // SearchRequest.personalization_spec overrides + // ServingConfig.personalization_spec. + PersonalizationSpec *GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec `json:"personalizationSpec,omitempty"` // Query: Raw search query. Query string `json:"query,omitempty"` // QueryExpansionSpec: The query expansion specification that specifies the @@ -15422,6 +15578,11 @@ type GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec struct { // `projects/{project}/locations/{location}/collections/{collection_id}/dataStor // es/{data_store_id}`. DataStore string `json:"dataStore,omitempty"` + // Filter: Optional. Filter specification to filter documents in the data store + // specified by data_store field. For more information on filtering, see + // Filtering + // (https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata) + Filter string `json:"filter,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 @@ -15691,6 +15852,35 @@ func (s GoogleCloudDiscoveryengineV1betaSearchRequestNaturalLanguageQueryUnderst return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec: The +// specification for personalization. +type GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec struct { + // Mode: The personalization mode of the search request. Defaults to Mode.AUTO. + // + // Possible values: + // "MODE_UNSPECIFIED" - Default value. In this case, server behavior defaults + // to Mode.AUTO. + // "AUTO" - Personalization is enabled if data quality requirements are met. + // "DISABLED" - Disable personalization. + Mode string `json:"mode,omitempty"` + // ForceSendFields is a list of field names (e.g. "Mode") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Mode") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1betaSearchRequestQueryExpansionSpec: // Specification to determine under which conditions query expansion should // occur. @@ -16755,6 +16945,12 @@ type GoogleCloudDiscoveryengineV1betaServingConfig struct { // controls in the list will execute. Maximum number of specifications is 100. // Can only be set if SolutionType is SOLUTION_TYPE_SEARCH. OnewaySynonymsControlIds []string `json:"onewaySynonymsControlIds,omitempty"` + // PersonalizationSpec: The specification for personalization spec. Notice that + // if both ServingConfig.personalization_spec and + // SearchRequest.personalization_spec are set, + // SearchRequest.personalization_spec overrides + // ServingConfig.personalization_spec. + PersonalizationSpec *GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec `json:"personalizationSpec,omitempty"` // RankingExpression: The ranking expression controls the customized ranking on // retrieval documents. To leverage this, document embedding is required. The // ranking expression setting in ServingConfig applies to all search requests diff --git a/gkehub/v1alpha/gkehub-api.json b/gkehub/v1alpha/gkehub-api.json index 2202525aacc..559b026348c 100644 --- a/gkehub/v1alpha/gkehub-api.json +++ b/gkehub/v1alpha/gkehub-api.json @@ -2255,7 +2255,7 @@ } } }, - "revision": "20240909", + "revision": "20240920", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AnthosObservabilityFeatureSpec": { @@ -6714,6 +6714,8 @@ "CLUSTER_HAS_ZERO_NODES", "UNSUPPORTED_MULTIPLE_CONTROL_PLANES", "VPCSC_GA_SUPPORTED", + "DEPRECATED_SPEC_CONTROL_PLANE_MANAGEMENT", + "DEPRECATED_SPEC_CONTROL_PLANE_MANAGEMENT_SAFE", "CONFIG_APPLY_INTERNAL_ERROR", "CONFIG_VALIDATION_ERROR", "CONFIG_VALIDATION_WARNING", @@ -6731,7 +6733,11 @@ "QUOTA_EXCEEDED_SERVICE_LB_POLICIES", "QUOTA_EXCEEDED_HTTP_FILTERS", "QUOTA_EXCEEDED_TCP_FILTERS", - "QUOTA_EXCEEDED_NETWORK_ENDPOINT_GROUPS" + "QUOTA_EXCEEDED_NETWORK_ENDPOINT_GROUPS", + "MODERNIZATION_SCHEDULED", + "MODERNIZATION_IN_PROGRESS", + "MODERNIZATION_COMPLETED", + "MODERNIZATION_ABORTED" ], "enumDescriptions": [ "Default Unspecified code", @@ -6745,6 +6751,8 @@ "Cluster has zero node code", "Multiple control planes unsupported error code", "VPC-SC GA is supported for this control plane.", + "User is using deprecated ControlPlaneManagement and they have not yet set Management.", + "User is using deprecated ControlPlaneManagement and they have already set Management.", "Configuration (Istio/k8s resources) failed to apply due to internal error.", "Configuration failed to be applied due to being invalid.", "Encountered configuration(s) with possible unintended behavior or invalid configuration. These configs may not have been applied.", @@ -6762,7 +6770,11 @@ "ServiceLBPolicy quota exceeded error code.", "HTTPFilter quota exceeded error code.", "TCPFilter quota exceeded error code.", - "NetworkEndpointGroup quota exceeded error code." + "NetworkEndpointGroup quota exceeded error code.", + "Modernization is scheduled for a cluster.", + "Modernization is in progress for a cluster.", + "Modernization is completed for a cluster.", + "Modernization is aborted for a cluster." ], "type": "string" }, diff --git a/gkehub/v1alpha/gkehub-gen.go b/gkehub/v1alpha/gkehub-gen.go index 8d8cb2f6cf4..f777548bd51 100644 --- a/gkehub/v1alpha/gkehub-gen.go +++ b/gkehub/v1alpha/gkehub-gen.go @@ -5964,6 +5964,10 @@ type ServiceMeshCondition struct { // "UNSUPPORTED_MULTIPLE_CONTROL_PLANES" - Multiple control planes // unsupported error code // "VPCSC_GA_SUPPORTED" - VPC-SC GA is supported for this control plane. + // "DEPRECATED_SPEC_CONTROL_PLANE_MANAGEMENT" - User is using deprecated + // ControlPlaneManagement and they have not yet set Management. + // "DEPRECATED_SPEC_CONTROL_PLANE_MANAGEMENT_SAFE" - User is using deprecated + // ControlPlaneManagement and they have already set Management. // "CONFIG_APPLY_INTERNAL_ERROR" - Configuration (Istio/k8s resources) failed // to apply due to internal error. // "CONFIG_VALIDATION_ERROR" - Configuration failed to be applied due to @@ -5993,6 +5997,10 @@ type ServiceMeshCondition struct { // "QUOTA_EXCEEDED_TCP_FILTERS" - TCPFilter quota exceeded error code. // "QUOTA_EXCEEDED_NETWORK_ENDPOINT_GROUPS" - NetworkEndpointGroup quota // exceeded error code. + // "MODERNIZATION_SCHEDULED" - Modernization is scheduled for a cluster. + // "MODERNIZATION_IN_PROGRESS" - Modernization is in progress for a cluster. + // "MODERNIZATION_COMPLETED" - Modernization is completed for a cluster. + // "MODERNIZATION_ABORTED" - Modernization is aborted for a cluster. Code string `json:"code,omitempty"` // Details: A short summary about the issue. Details string `json:"details,omitempty"` diff --git a/gkehub/v1beta/gkehub-api.json b/gkehub/v1beta/gkehub-api.json index 219a3ad963b..fb7c321c86b 100644 --- a/gkehub/v1beta/gkehub-api.json +++ b/gkehub/v1beta/gkehub-api.json @@ -2111,7 +2111,7 @@ } } }, - "revision": "20240902", + "revision": "20240920", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AnthosObservabilityFeatureSpec": { @@ -6268,6 +6268,8 @@ "CLUSTER_HAS_ZERO_NODES", "UNSUPPORTED_MULTIPLE_CONTROL_PLANES", "VPCSC_GA_SUPPORTED", + "DEPRECATED_SPEC_CONTROL_PLANE_MANAGEMENT", + "DEPRECATED_SPEC_CONTROL_PLANE_MANAGEMENT_SAFE", "CONFIG_APPLY_INTERNAL_ERROR", "CONFIG_VALIDATION_ERROR", "CONFIG_VALIDATION_WARNING", @@ -6285,7 +6287,11 @@ "QUOTA_EXCEEDED_SERVICE_LB_POLICIES", "QUOTA_EXCEEDED_HTTP_FILTERS", "QUOTA_EXCEEDED_TCP_FILTERS", - "QUOTA_EXCEEDED_NETWORK_ENDPOINT_GROUPS" + "QUOTA_EXCEEDED_NETWORK_ENDPOINT_GROUPS", + "MODERNIZATION_SCHEDULED", + "MODERNIZATION_IN_PROGRESS", + "MODERNIZATION_COMPLETED", + "MODERNIZATION_ABORTED" ], "enumDescriptions": [ "Default Unspecified code", @@ -6299,6 +6305,8 @@ "Cluster has zero node code", "Multiple control planes unsupported error code", "VPC-SC GA is supported for this control plane.", + "User is using deprecated ControlPlaneManagement and they have not yet set Management.", + "User is using deprecated ControlPlaneManagement and they have already set Management.", "Configuration (Istio/k8s resources) failed to apply due to internal error.", "Configuration failed to be applied due to being invalid.", "Encountered configuration(s) with possible unintended behavior or invalid configuration. These configs may not have been applied.", @@ -6316,7 +6324,11 @@ "ServiceLBPolicy quota exceeded error code.", "HTTPFilter quota exceeded error code.", "TCPFilter quota exceeded error code.", - "NetworkEndpointGroup quota exceeded error code." + "NetworkEndpointGroup quota exceeded error code.", + "Modernization is scheduled for a cluster.", + "Modernization is in progress for a cluster.", + "Modernization is completed for a cluster.", + "Modernization is aborted for a cluster." ], "type": "string" }, diff --git a/gkehub/v1beta/gkehub-gen.go b/gkehub/v1beta/gkehub-gen.go index 06f4901b60a..45510a8f6b0 100644 --- a/gkehub/v1beta/gkehub-gen.go +++ b/gkehub/v1beta/gkehub-gen.go @@ -5580,6 +5580,10 @@ type ServiceMeshCondition struct { // "UNSUPPORTED_MULTIPLE_CONTROL_PLANES" - Multiple control planes // unsupported error code // "VPCSC_GA_SUPPORTED" - VPC-SC GA is supported for this control plane. + // "DEPRECATED_SPEC_CONTROL_PLANE_MANAGEMENT" - User is using deprecated + // ControlPlaneManagement and they have not yet set Management. + // "DEPRECATED_SPEC_CONTROL_PLANE_MANAGEMENT_SAFE" - User is using deprecated + // ControlPlaneManagement and they have already set Management. // "CONFIG_APPLY_INTERNAL_ERROR" - Configuration (Istio/k8s resources) failed // to apply due to internal error. // "CONFIG_VALIDATION_ERROR" - Configuration failed to be applied due to @@ -5609,6 +5613,10 @@ type ServiceMeshCondition struct { // "QUOTA_EXCEEDED_TCP_FILTERS" - TCPFilter quota exceeded error code. // "QUOTA_EXCEEDED_NETWORK_ENDPOINT_GROUPS" - NetworkEndpointGroup quota // exceeded error code. + // "MODERNIZATION_SCHEDULED" - Modernization is scheduled for a cluster. + // "MODERNIZATION_IN_PROGRESS" - Modernization is in progress for a cluster. + // "MODERNIZATION_COMPLETED" - Modernization is completed for a cluster. + // "MODERNIZATION_ABORTED" - Modernization is aborted for a cluster. Code string `json:"code,omitempty"` // Details: A short summary about the issue. Details string `json:"details,omitempty"` diff --git a/migrationcenter/v1alpha1/migrationcenter-api.json b/migrationcenter/v1alpha1/migrationcenter-api.json index 491194d60bd..bb59ccebc70 100644 --- a/migrationcenter/v1alpha1/migrationcenter-api.json +++ b/migrationcenter/v1alpha1/migrationcenter-api.json @@ -2548,7 +2548,7 @@ } } }, - "revision": "20240906", + "revision": "20240919", "rootUrl": "https://migrationcenter.googleapis.com/", "schemas": { "AddAssetsToGroupRequest": { @@ -3361,7 +3361,7 @@ "type": "object" }, "CloudSqlForPostgreSqlShape": { - "description": "Cloud SQL for Postgres database shape.", + "description": "Cloud SQL for PostgreSQL database shape.", "id": "CloudSqlForPostgreSqlShape", "properties": { "backupStorageGb": { @@ -7217,7 +7217,7 @@ "Unknown database type.", "SQL Server database.", "MySQL database.", - "Postgres database." + "PostgreSQL database." ], "readOnly": true, "type": "string" @@ -7304,7 +7304,7 @@ }, "monthlyCostOsLicense": { "$ref": "Money", - "description": "Output only. Operating system licensing monthly cost for this preference set. Only present for virtual machines.", + "description": "Output only. All operating systems licensing monthly cost for this preference set. Only present for virtual machines.", "readOnly": true }, "monthlyCostOther": { diff --git a/migrationcenter/v1alpha1/migrationcenter-gen.go b/migrationcenter/v1alpha1/migrationcenter-gen.go index 05a30a95153..1d2813565cc 100644 --- a/migrationcenter/v1alpha1/migrationcenter-gen.go +++ b/migrationcenter/v1alpha1/migrationcenter-gen.go @@ -1317,7 +1317,7 @@ func (s CloudSqlForMySqlShape) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// CloudSqlForPostgreSqlShape: Cloud SQL for Postgres database shape. +// CloudSqlForPostgreSqlShape: Cloud SQL for PostgreSQL database shape. type CloudSqlForPostgreSqlShape struct { // BackupStorageGb: Output only. Predicted backup storage size in GiB. BackupStorageGb int64 `json:"backupStorageGb,omitempty"` @@ -5734,7 +5734,7 @@ type ReportSummaryGroupFinding struct { // "DATABASE_TYPE_UNSPECIFIED" - Unknown database type. // "SQL_SERVER" - SQL Server database. // "MYSQL" - MySQL database. - // "POSTGRES" - Postgres database. + // "POSTGRES" - PostgreSQL database. DatabaseType string `json:"databaseType,omitempty"` // Description: Description for this group finding. Description string `json:"description,omitempty"` @@ -5797,8 +5797,8 @@ type ReportSummaryGroupPreferenceSetFinding struct { // MonthlyCostNetworkEgress: Output only. Network Egress monthly cost for this // preference set. Only present for virtual machines. MonthlyCostNetworkEgress *Money `json:"monthlyCostNetworkEgress,omitempty"` - // MonthlyCostOsLicense: Output only. Operating system licensing monthly cost - // for this preference set. Only present for virtual machines. + // MonthlyCostOsLicense: Output only. All operating systems licensing monthly + // cost for this preference set. Only present for virtual machines. MonthlyCostOsLicense *Money `json:"monthlyCostOsLicense,omitempty"` // MonthlyCostOther: Output only. Miscellaneous monthly cost for this // preference set. diff --git a/notebooks/v1/notebooks-api.json b/notebooks/v1/notebooks-api.json index f4341260943..88ac34d4d58 100644 --- a/notebooks/v1/notebooks-api.json +++ b/notebooks/v1/notebooks-api.json @@ -2008,7 +2008,7 @@ } } }, - "revision": "20240820", + "revision": "20240918", "rootUrl": "https://notebooks.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -2822,7 +2822,7 @@ "type": "string" }, "tags": { - "description": "Optional. The Compute Engine tags to add to runtime (see [Tagging instances](https://cloud.google.com/compute/docs/label-or-tag-resources#tags)).", + "description": "Optional. The Compute Engine network tags to add to runtime (see [Add network tags](https://cloud.google.com/vpc/docs/add-remove-network-tags)).", "items": { "type": "string" }, @@ -4561,7 +4561,7 @@ "type": "string" }, "tags": { - "description": "Optional. The Compute Engine tags to add to runtime (see [Tagging instances](https://cloud.google.com/compute/docs/label-or-tag-resources#tags)).", + "description": "Optional. The Compute Engine network tags to add to runtime (see [Add network tags](https://cloud.google.com/vpc/docs/add-remove-network-tags)).", "items": { "type": "string" }, diff --git a/notebooks/v1/notebooks-gen.go b/notebooks/v1/notebooks-gen.go index 75653bc72a9..f04d73f20f9 100644 --- a/notebooks/v1/notebooks-gen.go +++ b/notebooks/v1/notebooks-gen.go @@ -1183,9 +1183,8 @@ type Instance struct { // Subnet: The name of the subnet that this instance is in. Format: // `projects/{project_id}/regions/{region}/subnetworks/{subnetwork_id}` Subnet string `json:"subnet,omitempty"` - // Tags: Optional. The Compute Engine tags to add to runtime (see Tagging - // instances - // (https://cloud.google.com/compute/docs/label-or-tag-resources#tags)). + // Tags: Optional. The Compute Engine network tags to add to runtime (see Add + // network tags (https://cloud.google.com/vpc/docs/add-remove-network-tags)). Tags []string `json:"tags,omitempty"` // UpdateTime: Output only. Instance update time. UpdateTime string `json:"updateTime,omitempty"` @@ -3375,9 +3374,8 @@ type VirtualMachineConfig struct { // /subnetworks/sub0` * // `projects/[project_id]/regions/us-east1/subnetworks/sub0` Subnet string `json:"subnet,omitempty"` - // Tags: Optional. The Compute Engine tags to add to runtime (see Tagging - // instances - // (https://cloud.google.com/compute/docs/label-or-tag-resources#tags)). + // Tags: Optional. The Compute Engine network tags to add to runtime (see Add + // network tags (https://cloud.google.com/vpc/docs/add-remove-network-tags)). Tags []string `json:"tags,omitempty"` // Zone: Output only. The zone where the virtual machine is located. If using // regional request, the notebooks service will pick a location in the diff --git a/notebooks/v2/notebooks-api.json b/notebooks/v2/notebooks-api.json index 22a4dfac4a2..2de9e62dc9d 100644 --- a/notebooks/v2/notebooks-api.json +++ b/notebooks/v2/notebooks-api.json @@ -904,7 +904,7 @@ } } }, - "revision": "20240820", + "revision": "20240918", "rootUrl": "https://notebooks.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -1357,7 +1357,7 @@ "description": "Optional. Shielded VM configuration. [Images using supported Shielded VM features](https://cloud.google.com/compute/docs/instances/modifying-shielded-vm)." }, "tags": { - "description": "Optional. The Compute Engine tags to add to runtime (see [Tagging instances](https://cloud.google.com/compute/docs/label-or-tag-resources#tags)).", + "description": "Optional. The Compute Engine network tags to add to runtime (see [Add network tags](https://cloud.google.com/vpc/docs/add-remove-network-tags)).", "items": { "type": "string" }, diff --git a/notebooks/v2/notebooks-gen.go b/notebooks/v2/notebooks-gen.go index 3b13b939e21..01dfaec4d28 100644 --- a/notebooks/v2/notebooks-gen.go +++ b/notebooks/v2/notebooks-gen.go @@ -820,9 +820,8 @@ type GceSetup struct { // supported Shielded VM features // (https://cloud.google.com/compute/docs/instances/modifying-shielded-vm). ShieldedInstanceConfig *ShieldedInstanceConfig `json:"shieldedInstanceConfig,omitempty"` - // Tags: Optional. The Compute Engine tags to add to runtime (see Tagging - // instances - // (https://cloud.google.com/compute/docs/label-or-tag-resources#tags)). + // Tags: Optional. The Compute Engine network tags to add to runtime (see Add + // network tags (https://cloud.google.com/vpc/docs/add-remove-network-tags)). Tags []string `json:"tags,omitempty"` // VmImage: Optional. Use a Compute Engine VM image to start the notebook // instance. diff --git a/oracledatabase/v1/oracledatabase-api.json b/oracledatabase/v1/oracledatabase-api.json index bfc8b5e7c57..8f3cc2636d0 100644 --- a/oracledatabase/v1/oracledatabase-api.json +++ b/oracledatabase/v1/oracledatabase-api.json @@ -12,7 +12,7 @@ "baseUrl": "https://oracledatabase.googleapis.com/", "batchPath": "batch", "canonicalName": "Oracle Database", - "description": "The Oracle Database@Google Cloud API provides set of APIs to manage Oracle databases such as Exadata and Autonomous Databases.", + "description": "The Oracle Database@Google Cloud API provides a set of APIs to manage Oracle database services, such as Exadata and Autonomous Databases.", "discoveryVersion": "v1", "documentationLink": "https://cloud.google.com/oracle/database/docs", "fullyEncodeReservedExpansion": true, @@ -180,7 +180,7 @@ "autonomousDatabaseBackups": { "methods": { "list": { - "description": "Lists the long term and automatic backups of an Autonomous Database.", + "description": "Lists the long-term and automatic backups of an Autonomous Database.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/autonomousDatabaseBackups", "httpMethod": "GET", "id": "oracledatabase.projects.locations.autonomousDatabaseBackups.list", @@ -338,7 +338,7 @@ ] }, "generateWallet": { - "description": "Generates a wallet for a single Autonomous Database.", + "description": "Generates a wallet for an Autonomous Database.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/autonomousDatabases/{autonomousDatabasesId}:generateWallet", "httpMethod": "POST", "id": "oracledatabase.projects.locations.autonomousDatabases.generateWallet", @@ -934,7 +934,7 @@ "type": "string" }, "parent": { - "description": "Required. The parent value for Entitlement in the following format: projects/{project}/locations/{location}.", + "description": "Required. The parent value for the entitlement in the following format: projects/{project}/locations/{location}.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -1119,7 +1119,7 @@ } } }, - "revision": "20240913", + "revision": "20240918", "rootUrl": "https://oracledatabase.googleapis.com/", "schemas": { "AllConnectionStrings": { @@ -1187,7 +1187,7 @@ "type": "string" }, "network": { - "description": "Required. The name of the VPC network used by the Autonomous Database. Format: projects/{project}/global/networks/{network}", + "description": "Required. The name of the VPC network used by the Autonomous Database in the following format: projects/{project}/global/networks/{network}", "type": "string" }, "properties": { @@ -1325,12 +1325,12 @@ ], "enumDescriptions": [ "Default unspecified value.", - "Indicates that the resource is in Creating state.", - "Indicates that the resource is in Active state.", - "Indicates that the resource is in Deleting state.", - "Indicates that the resource is in Deleted state.", - "Indicates that the resource is in Failed state.", - "Indicates that the resource is in Updating state." + "Indicates that the resource is in creating state.", + "Indicates that the resource is in active state.", + "Indicates that the resource is in deleting state.", + "Indicates that the resource is in deleted state.", + "Indicates that the resource is in failed state.", + "Indicates that the resource is in updating state." ], "readOnly": true, "type": "string" @@ -1749,7 +1749,7 @@ ], "enumDescriptions": [ "Default unspecified value.", - "An EARLY maintenance schedule patches the database before the the regular scheduled maintenance.", + "An EARLY maintenance schedule patches the database before the regular scheduled maintenance.", "A REGULAR maintenance schedule follows the normal maintenance cycle." ], "type": "string" @@ -1960,27 +1960,27 @@ ], "enumDescriptions": [ "Default unspecified value.", - "Indicates that the Autonomous Database is in Provisioning state.", - "Indicates that the Autonomous Database is in Available state.", - "Indicates that the Autonomous Database is in Stopping state.", - "Indicates that the Autonomous Database is in Stopped state.", - "Indicates that the Autonomous Database is in Starting state.", - "Indicates that the Autonomous Database is in Terminating state.", - "Indicates that the Autonomous Database is in Terminated state.", - "Indicates that the Autonomous Database is in Unavailable state.", - "Indicates that the Autonomous Database Restore is in progress.", + "Indicates that the Autonomous Database is in provisioning state.", + "Indicates that the Autonomous Database is in available state.", + "Indicates that the Autonomous Database is in stopping state.", + "Indicates that the Autonomous Database is in stopped state.", + "Indicates that the Autonomous Database is in starting state.", + "Indicates that the Autonomous Database is in terminating state.", + "Indicates that the Autonomous Database is in terminated state.", + "Indicates that the Autonomous Database is in unavailable state.", + "Indicates that the Autonomous Database restore is in progress.", "Indicates that the Autonomous Database failed to restore.", "Indicates that the Autonomous Database backup is in progress.", "Indicates that the Autonomous Database scale is in progress.", - "Indicates that the Autonomous Database is in Available Needs Attention state.", - "Indicates that the Autonomous Database is in Updating state.", - "Indicates that the Autonomous Database is in Maintenance In Progress state.", - "Indicates that the Autonomous Database is in Restarting state.", - "Indicates that the Autonomous Database is in Recreating state.", - "Indicates that the Autonomous Database is in Role Change In Progress state.", - "Indicates that the Autonomous Database is in Upgrading state.", - "Indicates that the Autonomous Database is in Inaccessible state.", - "Indicates that the Autonomous Database is in Standby state." + "Indicates that the Autonomous Database is available but needs attention state.", + "Indicates that the Autonomous Database is in updating state.", + "Indicates that the Autonomous Database's maintenance is in progress state.", + "Indicates that the Autonomous Database is in restarting state.", + "Indicates that the Autonomous Database is in recreating state.", + "Indicates that the Autonomous Database's role change is in progress state.", + "Indicates that the Autonomous Database is in upgrading state.", + "Indicates that the Autonomous Database is in inaccessible state.", + "Indicates that the Autonomous Database is in standby state." ], "readOnly": true, "type": "string" @@ -2067,27 +2067,27 @@ ], "enumDescriptions": [ "Default unspecified value.", - "Indicates that the Autonomous Database is in Provisioning state.", - "Indicates that the Autonomous Database is in Available state.", - "Indicates that the Autonomous Database is in Stopping state.", - "Indicates that the Autonomous Database is in Stopped state.", - "Indicates that the Autonomous Database is in Starting state.", - "Indicates that the Autonomous Database is in Terminating state.", - "Indicates that the Autonomous Database is in Terminated state.", - "Indicates that the Autonomous Database is in Unavailable state.", - "Indicates that the Autonomous Database Restore is in progress.", + "Indicates that the Autonomous Database is in provisioning state.", + "Indicates that the Autonomous Database is in available state.", + "Indicates that the Autonomous Database is in stopping state.", + "Indicates that the Autonomous Database is in stopped state.", + "Indicates that the Autonomous Database is in starting state.", + "Indicates that the Autonomous Database is in terminating state.", + "Indicates that the Autonomous Database is in terminated state.", + "Indicates that the Autonomous Database is in unavailable state.", + "Indicates that the Autonomous Database restore is in progress.", "Indicates that the Autonomous Database failed to restore.", "Indicates that the Autonomous Database backup is in progress.", "Indicates that the Autonomous Database scale is in progress.", - "Indicates that the Autonomous Database is in Available Needs Attention state.", - "Indicates that the Autonomous Database is in Updating state.", - "Indicates that the Autonomous Database is in Maintenance In Progress state.", - "Indicates that the Autonomous Database is in Restarting state.", - "Indicates that the Autonomous Database is in Recreating state.", - "Indicates that the Autonomous Database is in Role Change In Progress state.", - "Indicates that the Autonomous Database is in Upgrading state.", - "Indicates that the Autonomous Database is in Inaccessible state.", - "Indicates that the Autonomous Database is in Standby state." + "Indicates that the Autonomous Database is available but needs attention state.", + "Indicates that the Autonomous Database is in updating state.", + "Indicates that the Autonomous Database's maintenance is in progress state.", + "Indicates that the Autonomous Database is in restarting state.", + "Indicates that the Autonomous Database is in recreating state.", + "Indicates that the Autonomous Database's role change is in progress state.", + "Indicates that the Autonomous Database is in upgrading state.", + "Indicates that the Autonomous Database is in inaccessible state.", + "Indicates that the Autonomous Database is in standby state." ], "readOnly": true, "type": "string" @@ -2188,7 +2188,7 @@ "type": "string" }, "gcpOracleZone": { - "description": "Optional. GCP location where Oracle Exadata is hosted.", + "description": "Optional. Google Cloud Platform location where Oracle Exadata is hosted.", "type": "string" }, "labels": { @@ -2408,7 +2408,7 @@ "type": "string" }, "gcpOracleZone": { - "description": "Output only. GCP location where Oracle Exadata is hosted. It is same as GCP Oracle zone of Exadata infrastructure.", + "description": "Output only. Google Cloud Platform location where Oracle Exadata is hosted. It is same as Google Cloud Platform Oracle zone of Exadata infrastructure.", "readOnly": true, "type": "string" }, @@ -2613,13 +2613,13 @@ ], "enumDescriptions": [ "Default unspecified value.", - "Indicates that the resource is in Provisioning state.", - "Indicates that the resource is in Available state.", - "Indicates that the resource is in Updating state.", - "Indicates that the resource is in Terminating state.", - "Indicates that the resource is in Terminated state.", - "Indicates that the resource is in Failed state.", - "Indicates that the resource is in Maintenance In Progress state." + "Indicates that the resource is in provisioning state.", + "Indicates that the resource is in available state.", + "Indicates that the resource is in updating state.", + "Indicates that the resource is in terminating state.", + "Indicates that the resource is in terminated state.", + "Indicates that the resource is in failed state.", + "Indicates that the resource is in maintenance in progress state." ], "readOnly": true, "type": "string" @@ -2855,15 +2855,15 @@ ], "enumDescriptions": [ "Default unspecified value.", - "Indicates that the resource is in Provisioning state.", - "Indicates that the resource is in Available state.", - "Indicates that the resource is in Updating state.", - "Indicates that the resource is in Stopping state.", - "Indicates that the resource is in Stopped state.", - "Indicates that the resource is in Starting state.", - "Indicates that the resource is in Terminating state.", - "Indicates that the resource is in Terminated state.", - "Indicates that the resource is in Failed state." + "Indicates that the resource is in provisioning state.", + "Indicates that the resource is in available state.", + "Indicates that the resource is in updating state.", + "Indicates that the resource is in stopping state.", + "Indicates that the resource is in stopped state.", + "Indicates that the resource is in starting state.", + "Indicates that the resource is in terminating state.", + "Indicates that the resource is in terminated state.", + "Indicates that the resource is in failed state." ], "readOnly": true, "type": "string" @@ -2954,11 +2954,11 @@ ], "enumDescriptions": [ "Default unspecified value.", - "Indicates that the resource is in Creating state.", - "Indicates that the resource is in Available state.", - "Indicates that the resource is in Unavailable state.", - "Indicates that the resource is in Deleting state.", - "Indicates that the resource is in Deleted state." + "Indicates that the resource is in creating state.", + "Indicates that the resource is in available state.", + "Indicates that the resource is in unavailable state.", + "Indicates that the resource is in deleting state.", + "Indicates that the resource is in deleted state." ], "readOnly": true, "type": "string" @@ -3409,7 +3409,7 @@ "id": "LocationMetadata", "properties": { "gcpOracleZones": { - "description": "Output only. GCP Oracle zones in a location.", + "description": "Output only. Google Cloud Platform Oracle zones in a location.", "items": { "type": "string" }, diff --git a/oracledatabase/v1/oracledatabase-gen.go b/oracledatabase/v1/oracledatabase-gen.go index a8af3191b3e..3f5a8d2eaa1 100644 --- a/oracledatabase/v1/oracledatabase-gen.go +++ b/oracledatabase/v1/oracledatabase-gen.go @@ -378,7 +378,8 @@ type AutonomousDatabase struct { // e} Name string `json:"name,omitempty"` // Network: Required. The name of the VPC network used by the Autonomous - // Database. Format: projects/{project}/global/networks/{network} + // Database in the following format: + // projects/{project}/global/networks/{network} Network string `json:"network,omitempty"` // Properties: Optional. The properties of the Autonomous Database. Properties *AutonomousDatabaseProperties `json:"properties,omitempty"` @@ -512,12 +513,12 @@ type AutonomousDatabaseBackupProperties struct { // // Possible values: // "STATE_UNSPECIFIED" - Default unspecified value. - // "CREATING" - Indicates that the resource is in Creating state. - // "ACTIVE" - Indicates that the resource is in Active state. - // "DELETING" - Indicates that the resource is in Deleting state. - // "DELETED" - Indicates that the resource is in Deleted state. - // "FAILED" - Indicates that the resource is in Failed state. - // "UPDATING" - Indicates that the resource is in Updating state. + // "CREATING" - Indicates that the resource is in creating state. + // "ACTIVE" - Indicates that the resource is in active state. + // "DELETING" - Indicates that the resource is in deleting state. + // "DELETED" - Indicates that the resource is in deleted state. + // "FAILED" - Indicates that the resource is in failed state. + // "UPDATING" - Indicates that the resource is in updating state. LifecycleState string `json:"lifecycleState,omitempty"` // Ocid: Output only. OCID of the Autonomous Database backup. // https://docs.oracle.com/en-us/iaas/Content/General/Concepts/identifiers.htm#Oracle @@ -840,7 +841,7 @@ type AutonomousDatabaseProperties struct { // Possible values: // "MAINTENANCE_SCHEDULE_TYPE_UNSPECIFIED" - Default unspecified value. // "EARLY" - An EARLY maintenance schedule patches the database before the - // the regular scheduled maintenance. + // regular scheduled maintenance. // "REGULAR" - A REGULAR maintenance schedule follows the normal maintenance // cycle. MaintenanceScheduleType string `json:"maintenanceScheduleType,omitempty"` @@ -945,20 +946,20 @@ type AutonomousDatabaseProperties struct { // // Possible values: // "STATE_UNSPECIFIED" - Default unspecified value. - // "PROVISIONING" - Indicates that the Autonomous Database is in Provisioning + // "PROVISIONING" - Indicates that the Autonomous Database is in provisioning // state. - // "AVAILABLE" - Indicates that the Autonomous Database is in Available + // "AVAILABLE" - Indicates that the Autonomous Database is in available // state. - // "STOPPING" - Indicates that the Autonomous Database is in Stopping state. - // "STOPPED" - Indicates that the Autonomous Database is in Stopped state. - // "STARTING" - Indicates that the Autonomous Database is in Starting state. - // "TERMINATING" - Indicates that the Autonomous Database is in Terminating + // "STOPPING" - Indicates that the Autonomous Database is in stopping state. + // "STOPPED" - Indicates that the Autonomous Database is in stopped state. + // "STARTING" - Indicates that the Autonomous Database is in starting state. + // "TERMINATING" - Indicates that the Autonomous Database is in terminating // state. - // "TERMINATED" - Indicates that the Autonomous Database is in Terminated + // "TERMINATED" - Indicates that the Autonomous Database is in terminated // state. - // "UNAVAILABLE" - Indicates that the Autonomous Database is in Unavailable + // "UNAVAILABLE" - Indicates that the Autonomous Database is in unavailable // state. - // "RESTORE_IN_PROGRESS" - Indicates that the Autonomous Database Restore is + // "RESTORE_IN_PROGRESS" - Indicates that the Autonomous Database restore is // in progress. // "RESTORE_FAILED" - Indicates that the Autonomous Database failed to // restore. @@ -966,22 +967,22 @@ type AutonomousDatabaseProperties struct { // progress. // "SCALE_IN_PROGRESS" - Indicates that the Autonomous Database scale is in // progress. - // "AVAILABLE_NEEDS_ATTENTION" - Indicates that the Autonomous Database is in - // Available Needs Attention state. - // "UPDATING" - Indicates that the Autonomous Database is in Updating state. - // "MAINTENANCE_IN_PROGRESS" - Indicates that the Autonomous Database is in - // Maintenance In Progress state. - // "RESTARTING" - Indicates that the Autonomous Database is in Restarting + // "AVAILABLE_NEEDS_ATTENTION" - Indicates that the Autonomous Database is + // available but needs attention state. + // "UPDATING" - Indicates that the Autonomous Database is in updating state. + // "MAINTENANCE_IN_PROGRESS" - Indicates that the Autonomous Database's + // maintenance is in progress state. + // "RESTARTING" - Indicates that the Autonomous Database is in restarting // state. - // "RECREATING" - Indicates that the Autonomous Database is in Recreating + // "RECREATING" - Indicates that the Autonomous Database is in recreating // state. - // "ROLE_CHANGE_IN_PROGRESS" - Indicates that the Autonomous Database is in - // Role Change In Progress state. - // "UPGRADING" - Indicates that the Autonomous Database is in Upgrading + // "ROLE_CHANGE_IN_PROGRESS" - Indicates that the Autonomous Database's role + // change is in progress state. + // "UPGRADING" - Indicates that the Autonomous Database is in upgrading // state. - // "INACCESSIBLE" - Indicates that the Autonomous Database is in Inaccessible + // "INACCESSIBLE" - Indicates that the Autonomous Database is in inaccessible // state. - // "STANDBY" - Indicates that the Autonomous Database is in Standby state. + // "STANDBY" - Indicates that the Autonomous Database is in standby state. State string `json:"state,omitempty"` // SupportedCloneRegions: Output only. The list of available regions that can // be used to create a clone for the Autonomous Database. @@ -1053,20 +1054,20 @@ type AutonomousDatabaseStandbySummary struct { // // Possible values: // "STATE_UNSPECIFIED" - Default unspecified value. - // "PROVISIONING" - Indicates that the Autonomous Database is in Provisioning + // "PROVISIONING" - Indicates that the Autonomous Database is in provisioning // state. - // "AVAILABLE" - Indicates that the Autonomous Database is in Available + // "AVAILABLE" - Indicates that the Autonomous Database is in available // state. - // "STOPPING" - Indicates that the Autonomous Database is in Stopping state. - // "STOPPED" - Indicates that the Autonomous Database is in Stopped state. - // "STARTING" - Indicates that the Autonomous Database is in Starting state. - // "TERMINATING" - Indicates that the Autonomous Database is in Terminating + // "STOPPING" - Indicates that the Autonomous Database is in stopping state. + // "STOPPED" - Indicates that the Autonomous Database is in stopped state. + // "STARTING" - Indicates that the Autonomous Database is in starting state. + // "TERMINATING" - Indicates that the Autonomous Database is in terminating // state. - // "TERMINATED" - Indicates that the Autonomous Database is in Terminated + // "TERMINATED" - Indicates that the Autonomous Database is in terminated // state. - // "UNAVAILABLE" - Indicates that the Autonomous Database is in Unavailable + // "UNAVAILABLE" - Indicates that the Autonomous Database is in unavailable // state. - // "RESTORE_IN_PROGRESS" - Indicates that the Autonomous Database Restore is + // "RESTORE_IN_PROGRESS" - Indicates that the Autonomous Database restore is // in progress. // "RESTORE_FAILED" - Indicates that the Autonomous Database failed to // restore. @@ -1074,22 +1075,22 @@ type AutonomousDatabaseStandbySummary struct { // progress. // "SCALE_IN_PROGRESS" - Indicates that the Autonomous Database scale is in // progress. - // "AVAILABLE_NEEDS_ATTENTION" - Indicates that the Autonomous Database is in - // Available Needs Attention state. - // "UPDATING" - Indicates that the Autonomous Database is in Updating state. - // "MAINTENANCE_IN_PROGRESS" - Indicates that the Autonomous Database is in - // Maintenance In Progress state. - // "RESTARTING" - Indicates that the Autonomous Database is in Restarting + // "AVAILABLE_NEEDS_ATTENTION" - Indicates that the Autonomous Database is + // available but needs attention state. + // "UPDATING" - Indicates that the Autonomous Database is in updating state. + // "MAINTENANCE_IN_PROGRESS" - Indicates that the Autonomous Database's + // maintenance is in progress state. + // "RESTARTING" - Indicates that the Autonomous Database is in restarting // state. - // "RECREATING" - Indicates that the Autonomous Database is in Recreating + // "RECREATING" - Indicates that the Autonomous Database is in recreating // state. - // "ROLE_CHANGE_IN_PROGRESS" - Indicates that the Autonomous Database is in - // Role Change In Progress state. - // "UPGRADING" - Indicates that the Autonomous Database is in Upgrading + // "ROLE_CHANGE_IN_PROGRESS" - Indicates that the Autonomous Database's role + // change is in progress state. + // "UPGRADING" - Indicates that the Autonomous Database is in upgrading // state. - // "INACCESSIBLE" - Indicates that the Autonomous Database is in Inaccessible + // "INACCESSIBLE" - Indicates that the Autonomous Database is in inaccessible // state. - // "STANDBY" - Indicates that the Autonomous Database is in Standby state. + // "STANDBY" - Indicates that the Autonomous Database is in standby state. State string `json:"state,omitempty"` // ForceSendFields is a list of field names (e.g. "DataGuardRoleChangedTime") // to unconditionally include in API requests. By default, fields with empty or @@ -1193,7 +1194,8 @@ type CloudExadataInfrastructure struct { // EntitlementId: Output only. Entitlement ID of the private offer against // which this infrastructure resource is provisioned. EntitlementId string `json:"entitlementId,omitempty"` - // GcpOracleZone: Optional. GCP location where Oracle Exadata is hosted. + // GcpOracleZone: Optional. Google Cloud Platform location where Oracle Exadata + // is hosted. GcpOracleZone string `json:"gcpOracleZone,omitempty"` // Labels: Optional. Labels or tags associated with the resource. Labels map[string]string `json:"labels,omitempty"` @@ -1359,8 +1361,9 @@ type CloudVmCluster struct { // projects/{project}/locations/{region}/cloudExadataInfrastuctures/{cloud_extra // data_infrastructure} ExadataInfrastructure string `json:"exadataInfrastructure,omitempty"` - // GcpOracleZone: Output only. GCP location where Oracle Exadata is hosted. It - // is same as GCP Oracle zone of Exadata infrastructure. + // GcpOracleZone: Output only. Google Cloud Platform location where Oracle + // Exadata is hosted. It is same as Google Cloud Platform Oracle zone of + // Exadata infrastructure. GcpOracleZone string `json:"gcpOracleZone,omitempty"` // Labels: Optional. Labels or tags associated with the VM Cluster. Labels map[string]string `json:"labels,omitempty"` @@ -1471,14 +1474,14 @@ type CloudVmClusterProperties struct { // // Possible values: // "STATE_UNSPECIFIED" - Default unspecified value. - // "PROVISIONING" - Indicates that the resource is in Provisioning state. - // "AVAILABLE" - Indicates that the resource is in Available state. - // "UPDATING" - Indicates that the resource is in Updating state. - // "TERMINATING" - Indicates that the resource is in Terminating state. - // "TERMINATED" - Indicates that the resource is in Terminated state. - // "FAILED" - Indicates that the resource is in Failed state. - // "MAINTENANCE_IN_PROGRESS" - Indicates that the resource is in Maintenance - // In Progress state. + // "PROVISIONING" - Indicates that the resource is in provisioning state. + // "AVAILABLE" - Indicates that the resource is in available state. + // "UPDATING" - Indicates that the resource is in updating state. + // "TERMINATING" - Indicates that the resource is in terminating state. + // "TERMINATED" - Indicates that the resource is in terminated state. + // "FAILED" - Indicates that the resource is in failed state. + // "MAINTENANCE_IN_PROGRESS" - Indicates that the resource is in maintenance + // in progress state. State string `json:"state,omitempty"` // StorageSizeGb: Output only. The storage allocation for the disk group, in // gigabytes (GB). @@ -1699,15 +1702,15 @@ type DbNodeProperties struct { // // Possible values: // "STATE_UNSPECIFIED" - Default unspecified value. - // "PROVISIONING" - Indicates that the resource is in Provisioning state. - // "AVAILABLE" - Indicates that the resource is in Available state. - // "UPDATING" - Indicates that the resource is in Updating state. - // "STOPPING" - Indicates that the resource is in Stopping state. - // "STOPPED" - Indicates that the resource is in Stopped state. - // "STARTING" - Indicates that the resource is in Starting state. - // "TERMINATING" - Indicates that the resource is in Terminating state. - // "TERMINATED" - Indicates that the resource is in Terminated state. - // "FAILED" - Indicates that the resource is in Failed state. + // "PROVISIONING" - Indicates that the resource is in provisioning state. + // "AVAILABLE" - Indicates that the resource is in available state. + // "UPDATING" - Indicates that the resource is in updating state. + // "STOPPING" - Indicates that the resource is in stopping state. + // "STOPPED" - Indicates that the resource is in stopped state. + // "STARTING" - Indicates that the resource is in starting state. + // "TERMINATING" - Indicates that the resource is in terminating state. + // "TERMINATED" - Indicates that the resource is in terminated state. + // "FAILED" - Indicates that the resource is in failed state. State string `json:"state,omitempty"` // TotalCpuCoreCount: Total CPU core count of the database node. TotalCpuCoreCount int64 `json:"totalCpuCoreCount,omitempty"` @@ -1782,11 +1785,11 @@ type DbServerProperties struct { // // Possible values: // "STATE_UNSPECIFIED" - Default unspecified value. - // "CREATING" - Indicates that the resource is in Creating state. - // "AVAILABLE" - Indicates that the resource is in Available state. - // "UNAVAILABLE" - Indicates that the resource is in Unavailable state. - // "DELETING" - Indicates that the resource is in Deleting state. - // "DELETED" - Indicates that the resource is in Deleted state. + // "CREATING" - Indicates that the resource is in creating state. + // "AVAILABLE" - Indicates that the resource is in available state. + // "UNAVAILABLE" - Indicates that the resource is in unavailable state. + // "DELETING" - Indicates that the resource is in deleting state. + // "DELETED" - Indicates that the resource is in deleted state. State string `json:"state,omitempty"` // VmCount: Optional. Vm count per database. VmCount int64 `json:"vmCount,omitempty"` @@ -2397,7 +2400,8 @@ func (s Location) MarshalJSON() ([]byte, error) { // LocationMetadata: Metadata for a given Location. type LocationMetadata struct { - // GcpOracleZones: Output only. GCP Oracle zones in a location. + // GcpOracleZones: Output only. Google Cloud Platform Oracle zones in a + // location. GcpOracleZones []string `json:"gcpOracleZones,omitempty"` // ForceSendFields is a list of field names (e.g. "GcpOracleZones") to // unconditionally include in API requests. By default, fields with empty or @@ -3035,7 +3039,7 @@ type ProjectsLocationsAutonomousDatabaseBackupsListCall struct { header_ http.Header } -// List: Lists the long term and automatic backups of an Autonomous Database. +// List: Lists the long-term and automatic backups of an Autonomous Database. // // - parent: The parent value for ListAutonomousDatabaseBackups in the // following format: projects/{project}/locations/{location}. @@ -3582,7 +3586,7 @@ type ProjectsLocationsAutonomousDatabasesGenerateWalletCall struct { header_ http.Header } -// GenerateWallet: Generates a wallet for a single Autonomous Database. +// GenerateWallet: Generates a wallet for an Autonomous Database. // // - name: The name of the Autonomous Database in the following format: // projects/{project}/locations/{location}/autonomousDatabases/{autonomous_dat @@ -5646,7 +5650,7 @@ type ProjectsLocationsEntitlementsListCall struct { // List: Lists the entitlements in a given project. // -// - parent: The parent value for Entitlement in the following format: +// - parent: The parent value for the entitlement in the following format: // projects/{project}/locations/{location}. func (r *ProjectsLocationsEntitlementsService) List(parent string) *ProjectsLocationsEntitlementsListCall { c := &ProjectsLocationsEntitlementsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} diff --git a/privateca/v1/privateca-api.json b/privateca/v1/privateca-api.json index dcd90fe2b1e..c9da9be98bb 100644 --- a/privateca/v1/privateca-api.json +++ b/privateca/v1/privateca-api.json @@ -392,7 +392,7 @@ ], "parameters": { "name": { - "description": "Output only. The resource name for this CaPool in the format `projects/*/locations/*/caPools/*`.", + "description": "Output only. Identifier. The resource name for this CaPool in the format `projects/*/locations/*/caPools/*`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/caPools/[^/]+$", "required": true, @@ -1605,7 +1605,7 @@ } } }, - "revision": "20240819", + "revision": "20240918", "rootUrl": "https://privateca.googleapis.com/", "schemas": { "AccessUrls": { @@ -1762,7 +1762,7 @@ "type": "object" }, "name": { - "description": "Output only. The resource name for this CaPool in the format `projects/*/locations/*/caPools/*`.", + "description": "Output only. Identifier. The resource name for this CaPool in the format `projects/*/locations/*/caPools/*`.", "readOnly": true, "type": "string" }, diff --git a/privateca/v1/privateca-gen.go b/privateca/v1/privateca-gen.go index ae4c8322986..14d4831ad36 100644 --- a/privateca/v1/privateca-gen.go +++ b/privateca/v1/privateca-gen.go @@ -556,8 +556,8 @@ type CaPool struct { IssuancePolicy *IssuancePolicy `json:"issuancePolicy,omitempty"` // Labels: Optional. Labels with user-defined metadata. Labels map[string]string `json:"labels,omitempty"` - // Name: Output only. The resource name for this CaPool in the format - // `projects/*/locations/*/caPools/*`. + // Name: Output only. Identifier. The resource name for this CaPool in the + // format `projects/*/locations/*/caPools/*`. Name string `json:"name,omitempty"` // PublishingOptions: Optional. The PublishingOptions to follow when issuing // Certificates from any CertificateAuthority in this CaPool. @@ -3920,8 +3920,8 @@ type ProjectsLocationsCaPoolsPatchCall struct { // Patch: Update a CaPool. // -// - name: Output only. The resource name for this CaPool in the format -// `projects/*/locations/*/caPools/*`. +// - name: Output only. Identifier. The resource name for this CaPool in the +// format `projects/*/locations/*/caPools/*`. func (r *ProjectsLocationsCaPoolsService) Patch(name string, capool *CaPool) *ProjectsLocationsCaPoolsPatchCall { c := &ProjectsLocationsCaPoolsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name diff --git a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-api.json b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-api.json index e25f3c48775..84559a1fa33 100644 --- a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-api.json +++ b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-api.json @@ -715,7 +715,7 @@ } } }, - "revision": "20240912", + "revision": "20240919", "rootUrl": "https://serviceconsumermanagement.googleapis.com/", "schemas": { "Api": { @@ -1073,6 +1073,10 @@ "deprecated": true, "description": "Link to automatically generated reference documentation. Example: https://cloud.google.com/nodejs/docs/reference/asset/latest", "type": "string" + }, + "selectiveGapicGeneration": { + "$ref": "SelectiveGapicGeneration", + "description": "Configuration for which RPCs should be generated in the GAPIC client." } }, "type": "object" @@ -2479,6 +2483,20 @@ }, "type": "object" }, + "SelectiveGapicGeneration": { + "description": "This message is used to configure the generation of a subset of the RPCs in a service for client libraries.", + "id": "SelectiveGapicGeneration", + "properties": { + "methods": { + "description": "An allowlist of the fully qualified names of RPCs that should be included on public client surfaces.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "Service": { "description": "`Service` is the root object of Google API service configuration (service config). It describes the basic information about a logical service, such as the service name and the user-facing title, and delegates other aspects to sub-sections. Each sub-section is either a proto message or a repeated proto message that configures a specific aspect, such as auth. For more information, see each proto message definition. Example: type: google.api.Service name: calendar.googleapis.com title: Google Calendar API apis: - name: google.calendar.v3.Calendar visibility: rules: - selector: \"google.calendar.v3.*\" restriction: PREVIEW backend: rules: - selector: \"google.calendar.v3.*\" address: calendar.example.com authentication: providers: - id: google_calendar_auth jwks_uri: https://www.googleapis.com/oauth2/v1/certs issuer: https://securetoken.google.com rules: - selector: \"*\" requirements: provider_id: google_calendar_auth", "id": "Service", diff --git a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go index 3624059ef88..1bdb8627361 100644 --- a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go +++ b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go @@ -745,6 +745,9 @@ type CommonLanguageSettings struct { // ReferenceDocsUri: Link to automatically generated reference documentation. // Example: https://cloud.google.com/nodejs/docs/reference/asset/latest ReferenceDocsUri string `json:"referenceDocsUri,omitempty"` + // SelectiveGapicGeneration: Configuration for which RPCs should be generated + // in the GAPIC client. + SelectiveGapicGeneration *SelectiveGapicGeneration `json:"selectiveGapicGeneration,omitempty"` // ForceSendFields is a list of field names (e.g. "Destinations") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -2919,6 +2922,30 @@ func (s RubySettings) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// SelectiveGapicGeneration: This message is used to configure the generation +// of a subset of the RPCs in a service for client libraries. +type SelectiveGapicGeneration struct { + // Methods: An allowlist of the fully qualified names of RPCs that should be + // included on public client surfaces. + Methods []string `json:"methods,omitempty"` + // ForceSendFields is a list of field names (e.g. "Methods") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Methods") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s SelectiveGapicGeneration) MarshalJSON() ([]byte, error) { + type NoMethod SelectiveGapicGeneration + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Service: `Service` is the root object of Google API service configuration // (service config). It describes the basic information about a logical // service, such as the service name and the user-facing title, and delegates diff --git a/serviceusage/v1/serviceusage-api.json b/serviceusage/v1/serviceusage-api.json index e3a375d544f..04c70538322 100644 --- a/serviceusage/v1/serviceusage-api.json +++ b/serviceusage/v1/serviceusage-api.json @@ -426,7 +426,7 @@ } } }, - "revision": "20240905", + "revision": "20240919", "rootUrl": "https://serviceusage.googleapis.com/", "schemas": { "AddEnableRulesMetadata": { @@ -1003,6 +1003,10 @@ "deprecated": true, "description": "Link to automatically generated reference documentation. Example: https://cloud.google.com/nodejs/docs/reference/asset/latest", "type": "string" + }, + "selectiveGapicGeneration": { + "$ref": "SelectiveGapicGeneration", + "description": "Configuration for which RPCs should be generated in the GAPIC client." } }, "type": "object" @@ -3142,6 +3146,20 @@ }, "type": "object" }, + "SelectiveGapicGeneration": { + "description": "This message is used to configure the generation of a subset of the RPCs in a service for client libraries.", + "id": "SelectiveGapicGeneration", + "properties": { + "methods": { + "description": "An allowlist of the fully qualified names of RPCs that should be included on public client surfaces.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "ServiceIdentity": { "description": "Service identity for a service. This is the identity that service producer should use to access consumer resources.", "id": "ServiceIdentity", diff --git a/serviceusage/v1/serviceusage-gen.go b/serviceusage/v1/serviceusage-gen.go index c2427353227..7ad6038e08c 100644 --- a/serviceusage/v1/serviceusage-gen.go +++ b/serviceusage/v1/serviceusage-gen.go @@ -1015,6 +1015,9 @@ type CommonLanguageSettings struct { // ReferenceDocsUri: Link to automatically generated reference documentation. // Example: https://cloud.google.com/nodejs/docs/reference/asset/latest ReferenceDocsUri string `json:"referenceDocsUri,omitempty"` + // SelectiveGapicGeneration: Configuration for which RPCs should be generated + // in the GAPIC client. + SelectiveGapicGeneration *SelectiveGapicGeneration `json:"selectiveGapicGeneration,omitempty"` // ForceSendFields is a list of field names (e.g. "Destinations") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -4097,6 +4100,30 @@ func (s RubySettings) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// SelectiveGapicGeneration: This message is used to configure the generation +// of a subset of the RPCs in a service for client libraries. +type SelectiveGapicGeneration struct { + // Methods: An allowlist of the fully qualified names of RPCs that should be + // included on public client surfaces. + Methods []string `json:"methods,omitempty"` + // ForceSendFields is a list of field names (e.g. "Methods") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Methods") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s SelectiveGapicGeneration) MarshalJSON() ([]byte, error) { + type NoMethod SelectiveGapicGeneration + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ServiceIdentity: Service identity for a service. This is the identity that // service producer should use to access consumer resources. type ServiceIdentity struct { diff --git a/serviceusage/v1beta1/serviceusage-api.json b/serviceusage/v1beta1/serviceusage-api.json index 91cfe83077d..268c01da8c3 100644 --- a/serviceusage/v1beta1/serviceusage-api.json +++ b/serviceusage/v1beta1/serviceusage-api.json @@ -964,7 +964,7 @@ } } }, - "revision": "20240905", + "revision": "20240919", "rootUrl": "https://serviceusage.googleapis.com/", "schemas": { "AddEnableRulesMetadata": { @@ -1521,6 +1521,10 @@ "deprecated": true, "description": "Link to automatically generated reference documentation. Example: https://cloud.google.com/nodejs/docs/reference/asset/latest", "type": "string" + }, + "selectiveGapicGeneration": { + "$ref": "SelectiveGapicGeneration", + "description": "Configuration for which RPCs should be generated in the GAPIC client." } }, "type": "object" @@ -3941,6 +3945,20 @@ }, "type": "object" }, + "SelectiveGapicGeneration": { + "description": "This message is used to configure the generation of a subset of the RPCs in a service for client libraries.", + "id": "SelectiveGapicGeneration", + "properties": { + "methods": { + "description": "An allowlist of the fully qualified names of RPCs that should be included on public client surfaces.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "Service": { "description": "A service that is available for use by the consumer.", "id": "Service", diff --git a/serviceusage/v1beta1/serviceusage-gen.go b/serviceusage/v1beta1/serviceusage-gen.go index 6e95959492e..0ec2e4502db 100644 --- a/serviceusage/v1beta1/serviceusage-gen.go +++ b/serviceusage/v1beta1/serviceusage-gen.go @@ -1034,6 +1034,9 @@ type CommonLanguageSettings struct { // ReferenceDocsUri: Link to automatically generated reference documentation. // Example: https://cloud.google.com/nodejs/docs/reference/asset/latest ReferenceDocsUri string `json:"referenceDocsUri,omitempty"` + // SelectiveGapicGeneration: Configuration for which RPCs should be generated + // in the GAPIC client. + SelectiveGapicGeneration *SelectiveGapicGeneration `json:"selectiveGapicGeneration,omitempty"` // ForceSendFields is a list of field names (e.g. "Destinations") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -4498,6 +4501,30 @@ func (s RubySettings) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// SelectiveGapicGeneration: This message is used to configure the generation +// of a subset of the RPCs in a service for client libraries. +type SelectiveGapicGeneration struct { + // Methods: An allowlist of the fully qualified names of RPCs that should be + // included on public client surfaces. + Methods []string `json:"methods,omitempty"` + // ForceSendFields is a list of field names (e.g. "Methods") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Methods") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s SelectiveGapicGeneration) MarshalJSON() ([]byte, error) { + type NoMethod SelectiveGapicGeneration + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Service: A service that is available for use by the consumer. type Service struct { // Config: The service configuration of the available service. Some fields may