From b2c7c055546c29cdf5e58cc6d7269ec87786badc Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Thu, 8 Aug 2024 00:26:21 -0700 Subject: [PATCH] feat(all): auto-regenerate discovery clients (#2725) --- androidpublisher/v3/androidpublisher-api.json | 4 +- androidpublisher/v3/androidpublisher-gen.go | 2 +- backupdr/v1/backupdr-api.json | 1227 ++++++++- backupdr/v1/backupdr-gen.go | 2336 ++++++++++++++++- beyondcorp/v1/beyondcorp-api.json | 50 +- beyondcorp/v1/beyondcorp-gen.go | 147 ++ .../v1/cloudcontrolspartner-api.json | 11 +- .../v1/cloudcontrolspartner-gen.go | 6 +- .../v1beta/cloudcontrolspartner-api.json | 11 +- .../v1beta/cloudcontrolspartner-gen.go | 6 +- discoveryengine/v1/discoveryengine-api.json | 68 +- discoveryengine/v1/discoveryengine-gen.go | 74 +- .../v1alpha/discoveryengine-api.json | 72 +- .../v1alpha/discoveryengine-gen.go | 81 +- .../v1beta/discoveryengine-api.json | 78 +- discoveryengine/v1beta/discoveryengine-gen.go | 82 +- .../v2/doubleclickbidmanager-api.json | 144 +- .../v2/doubleclickbidmanager-gen.go | 228 +- firebaseml/v2beta/firebaseml-api.json | 7 +- firebaseml/v2beta/firebaseml-gen.go | 2 + networksecurity/v1/networksecurity-api.json | 116 +- networksecurity/v1/networksecurity-gen.go | 369 ++- realtimebidding/v1/realtimebidding-api.json | 23 +- realtimebidding/v1/realtimebidding-gen.go | 15 + spanner/v1/spanner-api.json | 43 +- spanner/v1/spanner-gen.go | 87 +- 26 files changed, 4564 insertions(+), 725 deletions(-) diff --git a/androidpublisher/v3/androidpublisher-api.json b/androidpublisher/v3/androidpublisher-api.json index cbdb4e79bb9..84125b463e4 100644 --- a/androidpublisher/v3/androidpublisher-api.json +++ b/androidpublisher/v3/androidpublisher-api.json @@ -4731,7 +4731,7 @@ } } }, - "revision": "20240805", + "revision": "20240806", "rootUrl": "https://androidpublisher.googleapis.com/", "schemas": { "Abi": { @@ -7513,7 +7513,7 @@ "type": "object" }, "MultiAbi": { - "description": "Represents a list of apis.", + "description": "Represents a list of ABIs.", "id": "MultiAbi", "properties": { "abi": { diff --git a/androidpublisher/v3/androidpublisher-gen.go b/androidpublisher/v3/androidpublisher-gen.go index e065f2992dd..4fce2fefc03 100644 --- a/androidpublisher/v3/androidpublisher-gen.go +++ b/androidpublisher/v3/androidpublisher-gen.go @@ -4203,7 +4203,7 @@ func (s Money) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// MultiAbi: Represents a list of apis. +// MultiAbi: Represents a list of ABIs. type MultiAbi struct { // Abi: A list of targeted ABIs, as represented by the Android Platform Abi []*Abi `json:"abi,omitempty"` diff --git a/backupdr/v1/backupdr-api.json b/backupdr/v1/backupdr-api.json index 579db803eed..fc1f9421ed2 100644 --- a/backupdr/v1/backupdr-api.json +++ b/backupdr/v1/backupdr-api.json @@ -177,6 +177,315 @@ } }, "resources": { + "backupPlanAssociations": { + "methods": { + "create": { + "description": "Create a BackupPlanAssociation", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlanAssociations", + "httpMethod": "POST", + "id": "backupdr.projects.locations.backupPlanAssociations.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "backupPlanAssociationId": { + "description": "Required. The name of the backup plan association to create. The name must be unique for the specified project and location.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The backup plan association project and location in the format `projects/{project_id}/locations/{location}`. In Cloud BackupDR locations map to GCP regions, for example **us-central1**.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "requestId": { + "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+parent}/backupPlanAssociations", + "request": { + "$ref": "BackupPlanAssociation" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes a single BackupPlanAssociation.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlanAssociations/{backupPlanAssociationsId}", + "httpMethod": "DELETE", + "id": "backupdr.projects.locations.backupPlanAssociations.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Name of the backup plan association resource, in the format `projects/{project}/locations/{location}/backupPlanAssociations/{backupPlanAssociationId}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/backupPlanAssociations/[^/]+$", + "required": true, + "type": "string" + }, + "requestId": { + "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets details of a single BackupPlanAssociation.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlanAssociations/{backupPlanAssociationsId}", + "httpMethod": "GET", + "id": "backupdr.projects.locations.backupPlanAssociations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Name of the backup plan association resource, in the format `projects/{project}/locations/{location}/backupPlanAssociations/{backupPlanAssociationId}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/backupPlanAssociations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "BackupPlanAssociation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists BackupPlanAssociations in a given project and location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlanAssociations", + "httpMethod": "GET", + "id": "backupdr.projects.locations.backupPlanAssociations.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "Optional. Filtering results", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. A token identifying a page of results the server should return.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The project and location for which to retrieve backup Plan Associations information, in the format `projects/{project_id}/locations/{location}`. In Cloud BackupDR, locations map to GCP regions, for example **us-central1**. To retrieve backup plan associations for all locations, use \"-\" for the `{location}` value.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/backupPlanAssociations", + "response": { + "$ref": "ListBackupPlanAssociationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "triggerBackup": { + "description": "Triggers a new Backup.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlanAssociations/{backupPlanAssociationsId}:triggerBackup", + "httpMethod": "POST", + "id": "backupdr.projects.locations.backupPlanAssociations.triggerBackup", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Name of the backup plan association resource, in the format `projects/{project}/locations/{location}/backupPlanAssociations/{backupPlanAssociationId}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/backupPlanAssociations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}:triggerBackup", + "request": { + "$ref": "TriggerBackupRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, + "backupPlans": { + "methods": { + "create": { + "description": "Create a BackupPlan", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans", + "httpMethod": "POST", + "id": "backupdr.projects.locations.backupPlans.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "backupPlanId": { + "description": "Required. The name of the `BackupPlan` to create. The name must be unique for the specified project and location.The name must start with a lowercase letter followed by up to 62 lowercase letters, numbers, or hyphens. Pattern, /a-z{,62}/.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The `BackupPlan` project and location in the format `projects/{project}/locations/{location}`. In Cloud BackupDR locations map to GCP regions, for example **us-central1**.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "requestId": { + "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+parent}/backupPlans", + "request": { + "$ref": "BackupPlan" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes a single BackupPlan.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}", + "httpMethod": "DELETE", + "id": "backupdr.projects.locations.backupPlans.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource name of the `BackupPlan` to delete. Format: `projects/{project}/locations/{location}/backupPlans/{backup_plan}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+$", + "required": true, + "type": "string" + }, + "requestId": { + "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets details of a single BackupPlan.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}", + "httpMethod": "GET", + "id": "backupdr.projects.locations.backupPlans.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource name of the `BackupPlan` to retrieve. Format: `projects/{project}/locations/{location}/backupPlans/{backup_plan}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "BackupPlan" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists BackupPlans in a given project and location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans", + "httpMethod": "GET", + "id": "backupdr.projects.locations.backupPlans.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "Optional. Field match expression used to filter the results.", + "location": "query", + "type": "string" + }, + "orderBy": { + "description": "Optional. Field by which to sort the results.", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Optional. The maximum number of `BackupPlans` to return in a single response. If not specified, a default value will be chosen by the service. Note that the response may include a partial list and a caller should only rely on the response's next_page_token to determine if there are more instances left to be queried.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. The value of next_page_token received from a previous `ListBackupPlans` call. Provide this to retrieve the subsequent page in a multi-page list of results. When paginating, all other parameters provided to `ListBackupPlans` must match the call that provided the page token.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The project and location for which to retrieve `BackupPlans` information. Format: `projects/{project}/locations/{location}`. In Cloud BackupDR, locations map to GCP regions, for e.g. **us-central1**. To retrieve backup plans for all locations, use \"-\" for the `{location}` value.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/backupPlans", + "response": { + "$ref": "ListBackupPlansResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "backupVaults": { "methods": { "create": { @@ -896,20 +1205,48 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] - } - } - } - } - } - } - }, - "managementServers": { - "methods": { - "create": { - "description": "Creates a new ManagementServer in a given project and location.", - "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/managementServers", - "httpMethod": "POST", - "id": "backupdr.projects.locations.managementServers.create", + }, + "restore": { + "description": "Restore from a Backup", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupVaults/{backupVaultsId}/dataSources/{dataSourcesId}/backups/{backupsId}:restore", + "httpMethod": "POST", + "id": "backupdr.projects.locations.backupVaults.dataSources.backups.restore", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource name of the Backup instance, in the format 'projects/*/locations/*/backupVaults/*/dataSources/*/backups/'.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/backupVaults/[^/]+/dataSources/[^/]+/backups/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}:restore", + "request": { + "$ref": "RestoreBackupRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + } + } + }, + "managementServers": { + "methods": { + "create": { + "description": "Creates a new ManagementServer in a given project and location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/managementServers", + "httpMethod": "POST", + "id": "backupdr.projects.locations.managementServers.create", "parameterOrder": [ "parent" ], @@ -1261,7 +1598,7 @@ } } }, - "revision": "20240725", + "revision": "20240731", "rootUrl": "https://backupdr.googleapis.com/", "schemas": { "AbandonBackupRequest": { @@ -1351,6 +1688,31 @@ }, "type": "object" }, + "AdvancedMachineFeatures": { + "description": "Specifies options for controlling advanced machine features.", + "id": "AdvancedMachineFeatures", + "properties": { + "enableNestedVirtualization": { + "description": "Optional. Whether to enable nested virtualization or not (default is false).", + "type": "boolean" + }, + "enableUefiNetworking": { + "description": "Optional. Whether to enable UEFI networking for instance creation.", + "type": "boolean" + }, + "threadsPerCore": { + "description": "Optional. The number of threads per physical core. To disable simultaneous multithreading (SMT) set this to 1. If unset, the maximum number of threads supported per core by the underlying processor is assumed.", + "format": "int32", + "type": "integer" + }, + "visibleCoreCount": { + "description": "Optional. The number of physical cores to expose to an instance. Multiply by the number of threads per core to compute the total number of virtual CPUs to expose to the instance. If unset, the number of cores is inferred from the instance's nominal CPU count and the underlying platform's SMT width.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, "AliasIpRange": { "description": "An alias IP range attached to an instance's network interface.", "id": "AliasIpRange", @@ -1366,6 +1728,40 @@ }, "type": "object" }, + "AllocationAffinity": { + "description": "Specifies the reservations that this instance can consume from.", + "id": "AllocationAffinity", + "properties": { + "consumeReservationType": { + "description": "Optional. Specifies the type of reservation from which this instance can consume", + "enum": [ + "TYPE_UNSPECIFIED", + "NO_RESERVATION", + "ANY_RESERVATION", + "SPECIFIC_RESERVATION" + ], + "enumDescriptions": [ + "Default value. This value is unused.", + "Do not consume from any allocated capacity.", + "Consume any allocation available.", + "Must consume from a specific reservation. Must specify key value fields for specifying the reservations." + ], + "type": "string" + }, + "key": { + "description": "Optional. Corresponds to the label key of a reservation resource.", + "type": "string" + }, + "values": { + "description": "Optional. Corresponds to the label values of a reservation resource.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "AssetLocation": { "description": "Provides the mapping of a cloud asset to a direct physical location or to a proxy that defines the location on its behalf.", "id": "AssetLocation", @@ -1881,6 +2277,184 @@ }, "type": "object" }, + "BackupPlan": { + "description": "A `BackupPlan` specifies some common fields, such as `display_name` as well as one or more `BackupRule` messages. Each `BackupRule` has a retention policy and defines a schedule by which the system is to perform backup workloads.", + "id": "BackupPlan", + "properties": { + "backupRules": { + "description": "Required. The backup rules for this `BackupPlan`. There must be at least one `BackupRule` message.", + "items": { + "$ref": "BackupRule" + }, + "type": "array" + }, + "backupVault": { + "description": "Required. Resource name of backup vault which will be used as storage location for backups. Format: projects/{project}/locations/{location}/backupVaults/{backupvault}", + "type": "string" + }, + "backupVaultServiceAccount": { + "description": "Output only. The Google Cloud Platform Service Account to be used by the BackupVault for taking backups. Specify the email address of the Backup Vault Service Account.", + "readOnly": true, + "type": "string" + }, + "createTime": { + "description": "Output only. When the `BackupPlan` was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "Optional. The description of the `BackupPlan` resource. The description allows for additional details about `BackupPlan` and its use cases to be provided. An example description is the following: \"This is a backup plan that performs a daily backup at 6pm and retains data for 3 months\". The description must be at most 2048 characters.", + "type": "string" + }, + "etag": { + "description": "Optional. `etag` is returned from the service in the response. As a user of the service, you may provide an etag value in this field to prevent stale resources.", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. This collection of key/value pairs allows for custom labels to be supplied by the user. Example, {\"tag\": \"Weekly\"}.", + "type": "object" + }, + "name": { + "description": "Output only. Identifier. The resource name of the `BackupPlan`. Format: `projects/{project}/locations/{location}/backupPlans/{backup_plan}`", + "readOnly": true, + "type": "string" + }, + "resourceType": { + "description": "Required. The resource type to which the `BackupPlan` will be applied. Examples include, \"compute.googleapis.com/Instance\" and \"storage.googleapis.com/Bucket\".", + "type": "string" + }, + "state": { + "description": "Output only. The `State` for the `BackupPlan`.", + "enum": [ + "STATE_UNSPECIFIED", + "CREATING", + "ACTIVE", + "DELETING", + "INACTIVE" + ], + "enumDescriptions": [ + "State not set.", + "The resource is being created.", + "The resource has been created and is fully usable.", + "The resource is being deleted.", + "The resource has been created but is not usable." + ], + "readOnly": true, + "type": "string" + }, + "updateTime": { + "description": "Output only. When the `BackupPlan` was last updated.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "BackupPlanAssociation": { + "description": "A BackupPlanAssociation represents a single BackupPlanAssociation which contains details like workload, backup plan etc", + "id": "BackupPlanAssociation", + "properties": { + "backupPlan": { + "description": "Required. Resource name of backup plan which needs to be applied on workload. Format: projects/{project}/locations/{location}/backupPlans/{backupPlanId}", + "type": "string" + }, + "createTime": { + "description": "Output only. The time when the instance was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "dataSource": { + "description": "Output only. Output Only. Resource name of data source which will be used as storage location for backups taken. Format : projects/{project}/locations/{location}/backupVaults/{backupvault}/dataSources/{datasource}", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Output only. Identifier. The resource name of BackupPlanAssociation in below format Format : projects/{project}/locations/{location}/backupPlanAssociations/{backupPlanAssociationId}", + "readOnly": true, + "type": "string" + }, + "resource": { + "description": "Required. Immutable. Resource name of workload on which backupplan is applied", + "type": "string" + }, + "resourceType": { + "description": "Output only. Output Only. Resource type of workload on which backupplan is applied", + "readOnly": true, + "type": "string" + }, + "rulesConfigInfo": { + "description": "Output only. The config info related to backup rules.", + "items": { + "$ref": "RuleConfigInfo" + }, + "readOnly": true, + "type": "array" + }, + "state": { + "description": "Output only. The BackupPlanAssociation resource state.", + "enum": [ + "STATE_UNSPECIFIED", + "CREATING", + "ACTIVE", + "DELETING", + "INACTIVE" + ], + "enumDescriptions": [ + "State not set.", + "The resource is being created.", + "The resource has been created and is fully usable.", + "The resource is being deleted.", + "The resource has been created but is not usable." + ], + "readOnly": true, + "type": "string" + }, + "updateTime": { + "description": "Output only. The time when the instance was updated.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "BackupRule": { + "description": "`BackupRule` binds the backup schedule to a retention policy.", + "id": "BackupRule", + "properties": { + "backupRetentionDays": { + "description": "Required. Configures the duration for which backup data will be kept. It is defined in “days”. The value should be greater than or equal to minimum enforced retention of the backup vault.", + "format": "int32", + "type": "integer" + }, + "backupVault": { + "deprecated": true, + "description": "Optional. TODO b/341576760: Remove deprecated BV and Datasource field form BP and BPA once UI removed all dependencies on them Required. Resource name of backup vault which will be used as storage location for backups. Format: projects/{project}/locations/{location}/backupVaults/{backupvault}", + "type": "string" + }, + "backupVaultServiceAccount": { + "deprecated": true, + "description": "Output only. TODO b/341576760: Remove deprecated BV and Datasource field form BP and BPA once UI removed all dependencies on them Output only. The Google Cloud Platform Service Account to be used by the BackupVault for taking backups. Specify the email address of the Backup Vault Service Account.", + "readOnly": true, + "type": "string" + }, + "ruleId": { + "description": "Required. Immutable. The unique id of this `BackupRule`. The `rule_id` is unique per `BackupPlan`.The `rule_id` must start with a lowercase letter followed by up to 62 lowercase letters, numbers, or hyphens. Pattern, /a-z{,62}/.", + "type": "string" + }, + "standardSchedule": { + "$ref": "StandardSchedule", + "description": "Required. Defines a schedule that runs within the confines of a defined window of time." + } + }, + "type": "object" + }, "BackupVault": { "description": "Message describing a BackupVault object.", "id": "BackupVault", @@ -1988,6 +2562,23 @@ }, "type": "object" }, + "BackupWindow": { + "description": "`BackupWindow` defines a window of the day during which backup jobs will run.", + "id": "BackupWindow", + "properties": { + "endHourOfDay": { + "description": "Required. The hour of day (1-24) when the window end for e.g. if value of end hour of day is 10 that mean backup window end time is 10:00. End hour of day should be greater than start hour of day. 0 \u003c= start_hour_of_day \u003c end_hour_of_day \u003c= 24 End hour of day is not include in backup window that mean if end_hour_of_day= 10 jobs should start before 10:00.", + "format": "int32", + "type": "integer" + }, + "startHourOfDay": { + "description": "Required. The hour of day (0-23) when the window starts for e.g. if value of start hour of day is 6 that mean backup window start at 6:00.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, "Binding": { "description": "Associates `members`, or principals, with a `role`.", "id": "Binding", @@ -2053,34 +2644,168 @@ }, "type": "object" }, - "ComputeInstanceBackupProperties": { - "description": "ComputeInstanceBackupProperties represents Compute Engine instance backup properties.", - "id": "ComputeInstanceBackupProperties", + "ComputeInstanceBackupProperties": { + "description": "ComputeInstanceBackupProperties represents Compute Engine instance backup properties.", + "id": "ComputeInstanceBackupProperties", + "properties": { + "canIpForward": { + "description": "Enables instances created based on these properties to send packets with source IP addresses other than their own and receive packets with destination IP addresses other than their own. If these instances will be used as an IP gateway or it will be set as the next-hop in a Route resource, specify `true`. If unsure, leave this set to `false`. See the https://cloud.google.com/vpc/docs/using-routes#canipforward documentation for more information.", + "type": "boolean" + }, + "description": { + "description": "An optional text description for the instances that are created from these properties.", + "type": "string" + }, + "disk": { + "description": "An array of disks that are associated with the instances that are created from these properties.", + "items": { + "$ref": "AttachedDisk" + }, + "type": "array" + }, + "guestAccelerator": { + "description": "A list of guest accelerator cards' type and count to use for instances created from these properties.", + "items": { + "$ref": "AcceleratorConfig" + }, + "type": "array" + }, + "keyRevocationActionType": { + "description": "KeyRevocationActionType of the instance. Supported options are \"STOP\" and \"NONE\". The default value is \"NONE\" if it is not specified.", + "enum": [ + "KEY_REVOCATION_ACTION_TYPE_UNSPECIFIED", + "NONE", + "STOP" + ], + "enumDescriptions": [ + "Default value. This value is unused.", + "Indicates user chose no operation.", + "Indicates user chose to opt for VM shutdown on key revocation." + ], + "type": "string" + }, + "machineType": { + "description": "The machine type to use for instances that are created from these properties.", + "type": "string" + }, + "metadata": { + "$ref": "Metadata", + "description": "The metadata key/value pairs to assign to instances that are created from these properties. These pairs can consist of custom metadata or predefined keys. See https://cloud.google.com/compute/docs/metadata/overview for more information." + }, + "minCpuPlatform": { + "description": "Minimum cpu/platform to be used by instances. The instance may be scheduled on the specified or newer cpu/platform. Applicable values are the friendly names of CPU platforms, such as `minCpuPlatform: Intel Haswell` or `minCpuPlatform: Intel Sandy Bridge`. For more information, read https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform.", + "type": "string" + }, + "networkInterface": { + "description": "An array of network access configurations for this interface.", + "items": { + "$ref": "NetworkInterface" + }, + "type": "array" + }, + "scheduling": { + "$ref": "Scheduling", + "description": "Specifies the scheduling options for the instances that are created from these properties." + }, + "serviceAccount": { + "description": "A list of service accounts with specified scopes. Access tokens for these service accounts are available to the instances that are created from these properties. Use metadata queries to obtain the access tokens for these instances.", + "items": { + "$ref": "ServiceAccount" + }, + "type": "array" + }, + "sourceInstance": { + "description": "The source instance used to create this backup. This can be a partial or full URL to the resource. For example, the following are valid values: -https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance -projects/project/zones/zone/instances/instance", + "type": "string" + }, + "tags": { + "$ref": "Tags", + "description": "A list of tags to apply to the instances that are created from these properties. The tags identify valid sources or targets for network firewalls. The setTags method can modify this list of tags. Each tag within the list must comply with RFC1035 (https://www.ietf.org/rfc/rfc1035.txt)." + } + }, + "type": "object" + }, + "ComputeInstanceDataSourceProperties": { + "description": "ComputeInstanceDataSourceProperties represents the properties of a ComputeEngine resource that are stored in the DataSource.", + "id": "ComputeInstanceDataSourceProperties", + "properties": { + "description": { + "description": "The description of the Compute Engine instance.", + "type": "string" + }, + "machineType": { + "description": "The machine type of the instance.", + "type": "string" + }, + "name": { + "description": "Name of the compute instance backed up by the datasource.", + "type": "string" + }, + "totalDiskCount": { + "description": "The total number of disks attached to the Instance.", + "format": "int64", + "type": "string" + }, + "totalDiskSizeGb": { + "description": "The sum of all the disk sizes.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, + "ComputeInstanceRestoreProperties": { + "description": "ComputeInstanceRestoreProperties represents Compute Engine instance properties to be overridden during restore.", + "id": "ComputeInstanceRestoreProperties", "properties": { + "advancedMachineFeatures": { + "$ref": "AdvancedMachineFeatures", + "description": "Optional. Controls for advanced machine-related behavior features." + }, "canIpForward": { - "description": "Enables instances created based on these properties to send packets with source IP addresses other than their own and receive packets with destination IP addresses other than their own. If these instances will be used as an IP gateway or it will be set as the next-hop in a Route resource, specify `true`. If unsure, leave this set to `false`. See the https://cloud.google.com/vpc/docs/using-routes#canipforward documentation for more information.", + "description": "Optional. Allows this instance to send and receive packets with non-matching destination or source IPs.", + "type": "boolean" + }, + "confidentialInstanceConfig": { + "$ref": "ConfidentialInstanceConfig", + "description": "Optional. Controls Confidential compute options on the instance" + }, + "deletionProtection": { + "description": "Optional. Whether the resource should be protected against deletion.", "type": "boolean" }, "description": { - "description": "An optional text description for the instances that are created from these properties.", + "description": "Optional. An optional description of this resource. Provide this property when you create the resource.", "type": "string" }, - "disk": { - "description": "An array of disks that are associated with the instances that are created from these properties.", + "disks": { + "description": "Optional. Array of disks associated with this instance. Persistent disks must be created before you can assign them.", "items": { "$ref": "AttachedDisk" }, "type": "array" }, - "guestAccelerator": { - "description": "A list of guest accelerator cards' type and count to use for instances created from these properties.", + "displayDevice": { + "$ref": "DisplayDevice", + "description": "Optional. Enables display device for the instance." + }, + "guestAccelerators": { + "description": "Optional. A list of the type and count of accelerator cards attached to the instance.", "items": { "$ref": "AcceleratorConfig" }, "type": "array" }, + "hostname": { + "description": "Optional. Specifies the hostname of the instance. The specified hostname must be RFC1035 compliant. If hostname is not specified, the default hostname is [INSTANCE_NAME].c.[PROJECT_ID].internal when using the global DNS, and [INSTANCE_NAME].[ZONE].c.[PROJECT_ID].internal when using zonal DNS.", + "type": "string" + }, + "instanceEncryptionKey": { + "$ref": "CustomerEncryptionKey", + "description": "Optional. Encrypts suspended data for an instance with a customer-managed encryption key." + }, "keyRevocationActionType": { - "description": "KeyRevocationActionType of the instance. Supported options are \"STOP\" and \"NONE\". The default value is \"NONE\" if it is not specified.", + "description": "Optional. KeyRevocationActionType of the instance.", "enum": [ "KEY_REVOCATION_ACTION_TYPE_UNSPECIFIED", "NONE", @@ -2093,76 +2818,115 @@ ], "type": "string" }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Labels to apply to this instance.", + "type": "object" + }, "machineType": { - "description": "The machine type to use for instances that are created from these properties.", + "description": "Optional. Full or partial URL of the machine type resource to use for this instance.", "type": "string" }, "metadata": { "$ref": "Metadata", - "description": "The metadata key/value pairs to assign to instances that are created from these properties. These pairs can consist of custom metadata or predefined keys. See https://cloud.google.com/compute/docs/metadata/overview for more information." + "description": "Optional. This includes custom metadata and predefined keys." }, "minCpuPlatform": { - "description": "Minimum cpu/platform to be used by instances. The instance may be scheduled on the specified or newer cpu/platform. Applicable values are the friendly names of CPU platforms, such as `minCpuPlatform: Intel Haswell` or `minCpuPlatform: Intel Sandy Bridge`. For more information, read https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform.", + "description": "Optional. Minimum CPU platform to use for this instance.", "type": "string" }, - "networkInterface": { - "description": "An array of network access configurations for this interface.", + "name": { + "description": "Required. Name of the compute instance.", + "type": "string" + }, + "networkInterfaces": { + "description": "Optional. An array of network configurations for this instance. These specify how interfaces are configured to interact with other network services, such as connecting to the internet. Multiple interfaces are supported per instance.", "items": { "$ref": "NetworkInterface" }, "type": "array" }, + "networkPerformanceConfig": { + "$ref": "NetworkPerformanceConfig", + "description": "Optional. Configure network performance such as egress bandwidth tier." + }, + "params": { + "$ref": "InstanceParams", + "description": "Input only. Additional params passed with the request, but not persisted as part of resource payload." + }, + "privateIpv6GoogleAccess": { + "description": "Optional. The private IPv6 google access type for the VM. If not specified, use INHERIT_FROM_SUBNETWORK as default.", + "enum": [ + "INSTANCE_PRIVATE_IPV6_GOOGLE_ACCESS_UNSPECIFIED", + "INHERIT_FROM_SUBNETWORK", + "ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE", + "ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE" + ], + "enumDescriptions": [ + "Default value. This value is unused.", + "Each network interface inherits PrivateIpv6GoogleAccess from its subnetwork.", + "Outbound private IPv6 access from VMs in this subnet to Google services. If specified, the subnetwork who is attached to the instance's default network interface will be assigned an internal IPv6 prefix if it doesn't have before.", + "Bidirectional private IPv6 access to/from Google services. If specified, the subnetwork who is attached to the instance's default network interface will be assigned an internal IPv6 prefix if it doesn't have before." + ], + "type": "string" + }, + "reservationAffinity": { + "$ref": "AllocationAffinity", + "description": "Optional. Specifies the reservations that this instance can consume from." + }, + "resourcePolicies": { + "description": "Optional. Resource policies applied to this instance.", + "items": { + "type": "string" + }, + "type": "array" + }, "scheduling": { "$ref": "Scheduling", - "description": "Specifies the scheduling options for the instances that are created from these properties." + "description": "Optional. Sets the scheduling options for this instance." }, - "serviceAccount": { - "description": "A list of service accounts with specified scopes. Access tokens for these service accounts are available to the instances that are created from these properties. Use metadata queries to obtain the access tokens for these instances.", + "serviceAccounts": { + "description": "Optional. A list of service accounts, with their specified scopes, authorized for this instance. Only one service account per VM instance is supported.", "items": { "$ref": "ServiceAccount" }, "type": "array" }, - "sourceInstance": { - "description": "The source instance used to create this backup. This can be a partial or full URL to the resource. For example, the following are valid values: -https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance -projects/project/zones/zone/instances/instance", - "type": "string" - }, "tags": { "$ref": "Tags", - "description": "A list of tags to apply to the instances that are created from these properties. The tags identify valid sources or targets for network firewalls. The setTags method can modify this list of tags. Each tag within the list must comply with RFC1035 (https://www.ietf.org/rfc/rfc1035.txt)." + "description": "Optional. Tags to apply to this instance. Tags are used to identify valid sources or targets for network firewalls and are specified by the client during instance creation." } }, "type": "object" }, - "ComputeInstanceDataSourceProperties": { - "description": "ComputeInstanceDataSourceProperties represents the properties of a ComputeEngine resource that are stored in the DataSource.", - "id": "ComputeInstanceDataSourceProperties", + "ComputeInstanceTargetEnvironment": { + "description": "ComputeInstanceTargetEnvironment represents Compute Engine target environment to be used during restore.", + "id": "ComputeInstanceTargetEnvironment", "properties": { - "description": { - "description": "The description of the Compute Engine instance.", - "type": "string" - }, - "machineType": { - "description": "The machine type of the instance.", - "type": "string" - }, - "name": { - "description": "Name of the compute instance backed up by the datasource.", + "project": { + "description": "Required. Target project for the Compute Engine instance.", "type": "string" }, - "totalDiskCount": { - "description": "The total number of disks attached to the Instance.", - "format": "int64", - "type": "string" - }, - "totalDiskSizeGb": { - "description": "The sum of all the disk sizes.", - "format": "int64", + "zone": { + "description": "Required. The zone of the Compute Engine instance.", "type": "string" } }, "type": "object" }, + "ConfidentialInstanceConfig": { + "description": "A set of Confidential Instance options.", + "id": "ConfidentialInstanceConfig", + "properties": { + "enableConfidentialCompute": { + "description": "Optional. Defines whether the instance should have confidential compute enabled.", + "type": "boolean" + } + }, + "type": "object" + }, "CustomerEncryptionKey": { "description": "A customer-supplied encryption key.", "id": "CustomerEncryptionKey", @@ -2352,6 +3116,17 @@ }, "type": "object" }, + "DisplayDevice": { + "description": "A set of Display Device options", + "id": "DisplayDevice", + "properties": { + "enableDisplay": { + "description": "Optional. Enables display for the Compute Engine VM", + "type": "boolean" + } + }, + "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", @@ -2647,6 +3422,20 @@ }, "type": "object" }, + "InstanceParams": { + "description": "Additional instance params.", + "id": "InstanceParams", + "properties": { + "resourceManagerTags": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Resource manager tags to be bound to the instance.", + "type": "object" + } + }, + "type": "object" + }, "IsolationExpectations": { "id": "IsolationExpectations", "properties": { @@ -2772,6 +3561,56 @@ }, "type": "object" }, + "ListBackupPlanAssociationsResponse": { + "description": "Response message for List BackupPlanAssociation", + "id": "ListBackupPlanAssociationsResponse", + "properties": { + "backupPlanAssociations": { + "description": "The list of Backup Plan Associations in the project for the specified location. If the `{location}` value in the request is \"-\", the response contains a list of instances from all locations. In case any location is unreachable, the response will only return backup plan associations in reachable locations and the 'unreachable' field will be populated with a list of unreachable locations.", + "items": { + "$ref": "BackupPlanAssociation" + }, + "type": "array" + }, + "nextPageToken": { + "description": "A token identifying a page of results the server should return.", + "type": "string" + }, + "unreachable": { + "description": "Locations that could not be reached.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "ListBackupPlansResponse": { + "description": "The response message for getting a list of `BackupPlan`.", + "id": "ListBackupPlansResponse", + "properties": { + "backupPlans": { + "description": "The list of `BackupPlans` in the project for the specified location. If the `{location}` value in the request is \"-\", the response contains a list of resources from all locations. In case any location is unreachable, the response will only return backup plans in reachable locations and the 'unreachable' field will be populated with a list of unreachable locations. BackupPlan", + "items": { + "$ref": "BackupPlan" + }, + "type": "array" + }, + "nextPageToken": { + "description": "A token which may be sent as page_token in a subsequent `ListBackupPlans` call to retrieve the next page of results. If this field is omitted or empty, then there are no more results to return.", + "type": "string" + }, + "unreachable": { + "description": "Locations that could not be reached.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "ListBackupVaultsResponse": { "description": "Response message for listing BackupVaults.", "id": "ListBackupVaultsResponse", @@ -3280,6 +4119,27 @@ }, "type": "object" }, + "NetworkPerformanceConfig": { + "description": "Network performance configuration.", + "id": "NetworkPerformanceConfig", + "properties": { + "totalEgressBandwidthTier": { + "description": "Optional. The tier of the total egress bandwidth.", + "enum": [ + "TIER_UNSPECIFIED", + "DEFAULT", + "TIER_1" + ], + "enumDescriptions": [ + "This value is unused.", + "Default network performance config.", + "Tier 1 network performance config." + ], + "type": "string" + } + }, + "type": "object" + }, "NodeAffinity": { "description": "Node Affinity: the configuration of desired nodes onto which this Instance could be scheduled.", "id": "NodeAffinity", @@ -3509,6 +4369,73 @@ }, "type": "object" }, + "RestoreBackupRequest": { + "description": "Request message for restoring from a Backup.", + "id": "RestoreBackupRequest", + "properties": { + "computeInstanceRestoreProperties": { + "$ref": "ComputeInstanceRestoreProperties", + "description": "Compute Engine instance properties to be overridden during restore." + }, + "computeInstanceTargetEnvironment": { + "$ref": "ComputeInstanceTargetEnvironment", + "description": "Compute Engine target environment to be used during restore." + }, + "requestId": { + "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "type": "string" + } + }, + "type": "object" + }, + "RuleConfigInfo": { + "description": "Message for rules config info.", + "id": "RuleConfigInfo", + "properties": { + "dataSource": { + "deprecated": true, + "description": "Output only. TODO b/341576760: Remove deprecated BV and Datasource field form BP and BPA once UI removed all dependencies on them Output Only. Resource name of data source which will be used as storage location for backups taken by specified rule. Format : projects/{project}/locations/{location}/backupVaults/{backupvault}/dataSources/{datasource}", + "readOnly": true, + "type": "string" + }, + "lastBackupError": { + "$ref": "Status", + "description": "Output only. Output Only. google.rpc.Status object to store the last backup error.", + "readOnly": true + }, + "lastBackupState": { + "description": "Output only. The last backup state for rule.", + "enum": [ + "LAST_BACKUP_STATE_UNSPECIFIED", + "FIRST_BACKUP_PENDING", + "PERMISSION_DENIED", + "SUCCEEDED", + "FAILED" + ], + "enumDescriptions": [ + "State not set.", + "The first backup is pending.", + "The most recent backup could not be run/failed because of the lack of permissions.", + "The last backup operation succeeded.", + "The last backup operation failed." + ], + "readOnly": true, + "type": "string" + }, + "lastSuccessfulBackupConsistencyTime": { + "description": "Output only. The point in time when the last successful backup was captured from the source.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "ruleId": { + "description": "Output only. Output Only. Backup Rule id fetched from backup plan.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "Scheduling": { "description": "Sets the scheduling options for an Instance.", "id": "Scheduling", @@ -3696,6 +4623,122 @@ }, "type": "object" }, + "StandardSchedule": { + "description": "`StandardSchedule` defines a schedule that run within the confines of a defined window of days. We can define recurrence type for schedule as HOURLY, DAILY, WEEKLY, MONTHLY or YEARLY.", + "id": "StandardSchedule", + "properties": { + "backupWindow": { + "$ref": "BackupWindow", + "description": "Required. A BackupWindow defines the window of day during which backup jobs will run. Jobs are queued at the beginning of the window and will be marked as `NOT_RUN` if they do not start by the end of the window. Note: running jobs will not be cancelled at the end of the window." + }, + "daysOfMonth": { + "description": "Optional. Specifies days of months like 1, 5, or 14 on which jobs will run. Values for `days_of_month` are only applicable for `recurrence_type`, `MONTHLY` and `YEARLY`. A validation error will occur if other values are supplied.", + "items": { + "format": "int32", + "type": "integer" + }, + "type": "array" + }, + "daysOfWeek": { + "description": "Optional. Specifies days of week like, MONDAY or TUESDAY, on which jobs will run. This is required for `recurrence_type`, `WEEKLY` and is not applicable otherwise. A validation error will occur if a value is supplied and `recurrence_type` is not `WEEKLY`.", + "items": { + "enum": [ + "DAY_OF_WEEK_UNSPECIFIED", + "MONDAY", + "TUESDAY", + "WEDNESDAY", + "THURSDAY", + "FRIDAY", + "SATURDAY", + "SUNDAY" + ], + "enumDescriptions": [ + "The day of the week is unspecified.", + "Monday", + "Tuesday", + "Wednesday", + "Thursday", + "Friday", + "Saturday", + "Sunday" + ], + "type": "string" + }, + "type": "array" + }, + "hourlyFrequency": { + "description": "Optional. Specifies frequency for hourly backups. A hourly frequency of 2 means jobs will run every 2 hours from start time till end time defined. This is required for `recurrence_type`, `HOURLY` and is not applicable otherwise. A validation error will occur if a value is supplied and `recurrence_type` is not `HOURLY`. Value of hourly frequency should be between 6 and 23. Reason for limit : We found that there is bandwidth limitation of 3GB/S for GMI while taking a backup and 5GB/S while doing a restore. Given the amount of parallel backups and restore we are targeting, this will potentially take the backup time to mins and hours (in worst case scenario).", + "format": "int32", + "type": "integer" + }, + "months": { + "description": "Optional. Specifies the months of year, like `FEBRUARY` and/or `MAY`, on which jobs will run. This field is only applicable when `recurrence_type` is `YEARLY`. A validation error will occur if other values are supplied.", + "items": { + "enum": [ + "MONTH_UNSPECIFIED", + "JANUARY", + "FEBRUARY", + "MARCH", + "APRIL", + "MAY", + "JUNE", + "JULY", + "AUGUST", + "SEPTEMBER", + "OCTOBER", + "NOVEMBER", + "DECEMBER" + ], + "enumDescriptions": [ + "The unspecified month.", + "The month of January.", + "The month of February.", + "The month of March.", + "The month of April.", + "The month of May.", + "The month of June.", + "The month of July.", + "The month of August.", + "The month of September.", + "The month of October.", + "The month of November.", + "The month of December." + ], + "type": "string" + }, + "type": "array" + }, + "recurrenceType": { + "description": "Required. Specifies the `RecurrenceType` for the schedule.", + "enum": [ + "RECURRENCE_TYPE_UNSPECIFIED", + "HOURLY", + "DAILY", + "WEEKLY", + "MONTHLY", + "YEARLY" + ], + "enumDescriptions": [ + "recurrence type not set", + "The `BackupRule` is to be applied hourly.", + "The `BackupRule` is to be applied daily.", + "The `BackupRule` is to be applied weekly.", + "The `BackupRule` is to be applied monthly.", + "The `BackupRule` is to be applied yearly." + ], + "type": "string" + }, + "timeZone": { + "description": "Required. The time zone to be used when interpreting the schedule. The value of this field must be a time zone name from the IANA tz database. See https://en.wikipedia.org/wiki/List_of_tz_database_time_zones for the list of valid timezone names. For e.g., Europe/Paris.", + "type": "string" + }, + "weekDayOfMonth": { + "$ref": "WeekDayOfMonth", + "description": "Optional. Specifies a week day of the month like, FIRST SUNDAY or LAST MONDAY, on which jobs will run. This will be specified by two fields in `WeekDayOfMonth`, one for the day, e.g. `MONDAY`, and one for the week, e.g. `LAST`. This field is only applicable for `recurrence_type`, `MONTHLY` and `YEARLY`. A validation error will occur if other values are supplied." + } + }, + "type": "object" + }, "Status": { "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", "id": "Status", @@ -3777,6 +4820,72 @@ }, "type": "object" }, + "TriggerBackupRequest": { + "description": "Request message for triggering a backup.", + "id": "TriggerBackupRequest", + "properties": { + "requestId": { + "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "type": "string" + }, + "ruleId": { + "description": "Required. backup rule_id for which a backup needs to be triggered.", + "type": "string" + } + }, + "type": "object" + }, + "WeekDayOfMonth": { + "description": "`WeekDayOfMonth` defines the week day of the month on which the backups will run. The message combines a `WeekOfMonth` and `DayOfWeek` to produce values like `FIRST`/`MONDAY` or `LAST`/`FRIDAY`.", + "id": "WeekDayOfMonth", + "properties": { + "dayOfWeek": { + "description": "Required. Specifies the day of the week.", + "enum": [ + "DAY_OF_WEEK_UNSPECIFIED", + "MONDAY", + "TUESDAY", + "WEDNESDAY", + "THURSDAY", + "FRIDAY", + "SATURDAY", + "SUNDAY" + ], + "enumDescriptions": [ + "The day of the week is unspecified.", + "Monday", + "Tuesday", + "Wednesday", + "Thursday", + "Friday", + "Saturday", + "Sunday" + ], + "type": "string" + }, + "weekOfMonth": { + "description": "Required. Specifies the week of the month.", + "enum": [ + "WEEK_OF_MONTH_UNSPECIFIED", + "FIRST", + "SECOND", + "THIRD", + "FOURTH", + "LAST" + ], + "enumDescriptions": [ + "The zero value. Do not use.", + "The first week of the month.", + "The second week of the month.", + "The third week of the month.", + "The fourth week of the month.", + "The last week of the month." + ], + "type": "string" + } + }, + "type": "object" + }, "WorkforceIdentityBasedManagementURI": { "description": "ManagementURI depending on the Workforce Identity i.e. either 1p or 3p.", "id": "WorkforceIdentityBasedManagementURI", diff --git a/backupdr/v1/backupdr-gen.go b/backupdr/v1/backupdr-gen.go index f316b47492e..98b367901fc 100644 --- a/backupdr/v1/backupdr-gen.go +++ b/backupdr/v1/backupdr-gen.go @@ -168,6 +168,8 @@ type ProjectsService struct { func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { rs := &ProjectsLocationsService{s: s} + rs.BackupPlanAssociations = NewProjectsLocationsBackupPlanAssociationsService(s) + rs.BackupPlans = NewProjectsLocationsBackupPlansService(s) rs.BackupVaults = NewProjectsLocationsBackupVaultsService(s) rs.ManagementServers = NewProjectsLocationsManagementServersService(s) rs.Operations = NewProjectsLocationsOperationsService(s) @@ -177,6 +179,10 @@ func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { type ProjectsLocationsService struct { s *Service + BackupPlanAssociations *ProjectsLocationsBackupPlanAssociationsService + + BackupPlans *ProjectsLocationsBackupPlansService + BackupVaults *ProjectsLocationsBackupVaultsService ManagementServers *ProjectsLocationsManagementServersService @@ -184,6 +190,24 @@ type ProjectsLocationsService struct { Operations *ProjectsLocationsOperationsService } +func NewProjectsLocationsBackupPlanAssociationsService(s *Service) *ProjectsLocationsBackupPlanAssociationsService { + rs := &ProjectsLocationsBackupPlanAssociationsService{s: s} + return rs +} + +type ProjectsLocationsBackupPlanAssociationsService struct { + s *Service +} + +func NewProjectsLocationsBackupPlansService(s *Service) *ProjectsLocationsBackupPlansService { + rs := &ProjectsLocationsBackupPlansService{s: s} + return rs +} + +type ProjectsLocationsBackupPlansService struct { + s *Service +} + func NewProjectsLocationsBackupVaultsService(s *Service) *ProjectsLocationsBackupVaultsService { rs := &ProjectsLocationsBackupVaultsService{s: s} rs.DataSources = NewProjectsLocationsBackupVaultsDataSourcesService(s) @@ -351,6 +375,44 @@ func (s AccessConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// AdvancedMachineFeatures: Specifies options for controlling advanced machine +// features. +type AdvancedMachineFeatures struct { + // EnableNestedVirtualization: Optional. Whether to enable nested + // virtualization or not (default is false). + EnableNestedVirtualization bool `json:"enableNestedVirtualization,omitempty"` + // EnableUefiNetworking: Optional. Whether to enable UEFI networking for + // instance creation. + EnableUefiNetworking bool `json:"enableUefiNetworking,omitempty"` + // ThreadsPerCore: Optional. The number of threads per physical core. To + // disable simultaneous multithreading (SMT) set this to 1. If unset, the + // maximum number of threads supported per core by the underlying processor is + // assumed. + ThreadsPerCore int64 `json:"threadsPerCore,omitempty"` + // VisibleCoreCount: Optional. The number of physical cores to expose to an + // instance. Multiply by the number of threads per core to compute the total + // number of virtual CPUs to expose to the instance. If unset, the number of + // cores is inferred from the instance's nominal CPU count and the underlying + // platform's SMT width. + VisibleCoreCount int64 `json:"visibleCoreCount,omitempty"` + // ForceSendFields is a list of field names (e.g. "EnableNestedVirtualization") + // to unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "EnableNestedVirtualization") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s AdvancedMachineFeatures) MarshalJSON() ([]byte, error) { + type NoMethod AdvancedMachineFeatures + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // AliasIpRange: An alias IP range attached to an instance's network interface. type AliasIpRange struct { // IpCidrRange: Optional. The IP alias ranges to allocate for this interface. @@ -377,6 +439,41 @@ func (s AliasIpRange) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// AllocationAffinity: Specifies the reservations that this instance can +// consume from. +type AllocationAffinity struct { + // ConsumeReservationType: Optional. Specifies the type of reservation from + // which this instance can consume + // + // Possible values: + // "TYPE_UNSPECIFIED" - Default value. This value is unused. + // "NO_RESERVATION" - Do not consume from any allocated capacity. + // "ANY_RESERVATION" - Consume any allocation available. + // "SPECIFIC_RESERVATION" - Must consume from a specific reservation. Must + // specify key value fields for specifying the reservations. + ConsumeReservationType string `json:"consumeReservationType,omitempty"` + // Key: Optional. Corresponds to the label key of a reservation resource. + Key string `json:"key,omitempty"` + // Values: Optional. Corresponds to the label values of a reservation resource. + Values []string `json:"values,omitempty"` + // ForceSendFields is a list of field names (e.g. "ConsumeReservationType") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ConsumeReservationType") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s AllocationAffinity) MarshalJSON() ([]byte, error) { + type NoMethod AllocationAffinity + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // AssetLocation: Provides the mapping of a cloud asset to a direct physical // location or to a proxy that defines the location on its behalf. type AssetLocation struct { @@ -846,6 +943,179 @@ func (s BackupLock) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// BackupPlan: A `BackupPlan` specifies some common fields, such as +// `display_name` as well as one or more `BackupRule` messages. Each +// `BackupRule` has a retention policy and defines a schedule by which the +// system is to perform backup workloads. +type BackupPlan struct { + // BackupRules: Required. The backup rules for this `BackupPlan`. There must be + // at least one `BackupRule` message. + BackupRules []*BackupRule `json:"backupRules,omitempty"` + // BackupVault: Required. Resource name of backup vault which will be used as + // storage location for backups. Format: + // projects/{project}/locations/{location}/backupVaults/{backupvault} + BackupVault string `json:"backupVault,omitempty"` + // BackupVaultServiceAccount: Output only. The Google Cloud Platform Service + // Account to be used by the BackupVault for taking backups. Specify the email + // address of the Backup Vault Service Account. + BackupVaultServiceAccount string `json:"backupVaultServiceAccount,omitempty"` + // CreateTime: Output only. When the `BackupPlan` was created. + CreateTime string `json:"createTime,omitempty"` + // Description: Optional. The description of the `BackupPlan` resource. The + // description allows for additional details about `BackupPlan` and its use + // cases to be provided. An example description is the following: "This is a + // backup plan that performs a daily backup at 6pm and retains data for 3 + // months". The description must be at most 2048 characters. + Description string `json:"description,omitempty"` + // Etag: Optional. `etag` is returned from the service in the response. As a + // user of the service, you may provide an etag value in this field to prevent + // stale resources. + Etag string `json:"etag,omitempty"` + // Labels: Optional. This collection of key/value pairs allows for custom + // labels to be supplied by the user. Example, {"tag": "Weekly"}. + Labels map[string]string `json:"labels,omitempty"` + // Name: Output only. Identifier. The resource name of the `BackupPlan`. + // Format: `projects/{project}/locations/{location}/backupPlans/{backup_plan}` + Name string `json:"name,omitempty"` + // ResourceType: Required. The resource type to which the `BackupPlan` will be + // applied. Examples include, "compute.googleapis.com/Instance" and + // "storage.googleapis.com/Bucket". + ResourceType string `json:"resourceType,omitempty"` + // State: Output only. The `State` for the `BackupPlan`. + // + // Possible values: + // "STATE_UNSPECIFIED" - State not set. + // "CREATING" - The resource is being created. + // "ACTIVE" - The resource has been created and is fully usable. + // "DELETING" - The resource is being deleted. + // "INACTIVE" - The resource has been created but is not usable. + State string `json:"state,omitempty"` + // UpdateTime: Output only. When the `BackupPlan` was last updated. + UpdateTime string `json:"updateTime,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "BackupRules") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BackupRules") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s BackupPlan) MarshalJSON() ([]byte, error) { + type NoMethod BackupPlan + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// BackupPlanAssociation: A BackupPlanAssociation represents a single +// BackupPlanAssociation which contains details like workload, backup plan etc +type BackupPlanAssociation struct { + // BackupPlan: Required. Resource name of backup plan which needs to be applied + // on workload. Format: + // projects/{project}/locations/{location}/backupPlans/{backupPlanId} + BackupPlan string `json:"backupPlan,omitempty"` + // CreateTime: Output only. The time when the instance was created. + CreateTime string `json:"createTime,omitempty"` + // DataSource: Output only. Output Only. Resource name of data source which + // will be used as storage location for backups taken. Format : + // projects/{project}/locations/{location}/backupVaults/{backupvault}/dataSource + // s/{datasource} + DataSource string `json:"dataSource,omitempty"` + // Name: Output only. Identifier. The resource name of BackupPlanAssociation in + // below format Format : + // projects/{project}/locations/{location}/backupPlanAssociations/{backupPlanAss + // ociationId} + Name string `json:"name,omitempty"` + // Resource: Required. Immutable. Resource name of workload on which backupplan + // is applied + Resource string `json:"resource,omitempty"` + // ResourceType: Output only. Output Only. Resource type of workload on which + // backupplan is applied + ResourceType string `json:"resourceType,omitempty"` + // RulesConfigInfo: Output only. The config info related to backup rules. + RulesConfigInfo []*RuleConfigInfo `json:"rulesConfigInfo,omitempty"` + // State: Output only. The BackupPlanAssociation resource state. + // + // Possible values: + // "STATE_UNSPECIFIED" - State not set. + // "CREATING" - The resource is being created. + // "ACTIVE" - The resource has been created and is fully usable. + // "DELETING" - The resource is being deleted. + // "INACTIVE" - The resource has been created but is not usable. + State string `json:"state,omitempty"` + // UpdateTime: Output only. The time when the instance was updated. + UpdateTime string `json:"updateTime,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "BackupPlan") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BackupPlan") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s BackupPlanAssociation) MarshalJSON() ([]byte, error) { + type NoMethod BackupPlanAssociation + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// BackupRule: `BackupRule` binds the backup schedule to a retention policy. +type BackupRule struct { + // BackupRetentionDays: Required. Configures the duration for which backup data + // will be kept. It is defined in “days”. The value should be greater than + // or equal to minimum enforced retention of the backup vault. + BackupRetentionDays int64 `json:"backupRetentionDays,omitempty"` + // BackupVault: Optional. TODO b/341576760: Remove deprecated BV and Datasource + // field form BP and BPA once UI removed all dependencies on them Required. + // Resource name of backup vault which will be used as storage location for + // backups. Format: + // projects/{project}/locations/{location}/backupVaults/{backupvault} + BackupVault string `json:"backupVault,omitempty"` + // BackupVaultServiceAccount: Output only. TODO b/341576760: Remove deprecated + // BV and Datasource field form BP and BPA once UI removed all dependencies on + // them Output only. The Google Cloud Platform Service Account to be used by + // the BackupVault for taking backups. Specify the email address of the Backup + // Vault Service Account. + BackupVaultServiceAccount string `json:"backupVaultServiceAccount,omitempty"` + // RuleId: Required. Immutable. The unique id of this `BackupRule`. The + // `rule_id` is unique per `BackupPlan`.The `rule_id` must start with a + // lowercase letter followed by up to 62 lowercase letters, numbers, or + // hyphens. Pattern, /a-z{,62}/. + RuleId string `json:"ruleId,omitempty"` + // StandardSchedule: Required. Defines a schedule that runs within the confines + // of a defined window of time. + StandardSchedule *StandardSchedule `json:"standardSchedule,omitempty"` + // ForceSendFields is a list of field names (e.g. "BackupRetentionDays") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BackupRetentionDays") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s BackupRule) MarshalJSON() ([]byte, error) { + type NoMethod BackupRule + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // BackupVault: Message describing a BackupVault object. type BackupVault struct { // Annotations: Optional. User annotations. See @@ -923,6 +1193,38 @@ func (s BackupVault) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// BackupWindow: `BackupWindow` defines a window of the day during which backup +// jobs will run. +type BackupWindow struct { + // EndHourOfDay: Required. The hour of day (1-24) when the window end for e.g. + // if value of end hour of day is 10 that mean backup window end time is 10:00. + // End hour of day should be greater than start hour of day. 0 <= + // start_hour_of_day < end_hour_of_day <= 24 End hour of day is not include in + // backup window that mean if end_hour_of_day= 10 jobs should start before + // 10:00. + EndHourOfDay int64 `json:"endHourOfDay,omitempty"` + // StartHourOfDay: Required. The hour of day (0-23) when the window starts for + // e.g. if value of start hour of day is 6 that mean backup window start at + // 6:00. + StartHourOfDay int64 `json:"startHourOfDay,omitempty"` + // ForceSendFields is a list of field names (e.g. "EndHourOfDay") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "EndHourOfDay") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s BackupWindow) MarshalJSON() ([]byte, error) { + type NoMethod BackupWindow + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Binding: Associates `members`, or principals, with a `role`. type Binding struct { // Condition: The condition that is associated with this binding. If the @@ -1205,6 +1507,170 @@ func (s ComputeInstanceDataSourceProperties) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ComputeInstanceRestoreProperties: ComputeInstanceRestoreProperties +// represents Compute Engine instance properties to be overridden during +// restore. +type ComputeInstanceRestoreProperties struct { + // AdvancedMachineFeatures: Optional. Controls for advanced machine-related + // behavior features. + AdvancedMachineFeatures *AdvancedMachineFeatures `json:"advancedMachineFeatures,omitempty"` + // CanIpForward: Optional. Allows this instance to send and receive packets + // with non-matching destination or source IPs. + CanIpForward bool `json:"canIpForward,omitempty"` + // ConfidentialInstanceConfig: Optional. Controls Confidential compute options + // on the instance + ConfidentialInstanceConfig *ConfidentialInstanceConfig `json:"confidentialInstanceConfig,omitempty"` + // DeletionProtection: Optional. Whether the resource should be protected + // against deletion. + DeletionProtection bool `json:"deletionProtection,omitempty"` + // Description: Optional. An optional description of this resource. Provide + // this property when you create the resource. + Description string `json:"description,omitempty"` + // Disks: Optional. Array of disks associated with this instance. Persistent + // disks must be created before you can assign them. + Disks []*AttachedDisk `json:"disks,omitempty"` + // DisplayDevice: Optional. Enables display device for the instance. + DisplayDevice *DisplayDevice `json:"displayDevice,omitempty"` + // GuestAccelerators: Optional. A list of the type and count of accelerator + // cards attached to the instance. + GuestAccelerators []*AcceleratorConfig `json:"guestAccelerators,omitempty"` + // Hostname: Optional. Specifies the hostname of the instance. The specified + // hostname must be RFC1035 compliant. If hostname is not specified, the + // default hostname is [INSTANCE_NAME].c.[PROJECT_ID].internal when using the + // global DNS, and [INSTANCE_NAME].[ZONE].c.[PROJECT_ID].internal when using + // zonal DNS. + Hostname string `json:"hostname,omitempty"` + // InstanceEncryptionKey: Optional. Encrypts suspended data for an instance + // with a customer-managed encryption key. + InstanceEncryptionKey *CustomerEncryptionKey `json:"instanceEncryptionKey,omitempty"` + // KeyRevocationActionType: Optional. KeyRevocationActionType of the instance. + // + // Possible values: + // "KEY_REVOCATION_ACTION_TYPE_UNSPECIFIED" - Default value. This value is + // unused. + // "NONE" - Indicates user chose no operation. + // "STOP" - Indicates user chose to opt for VM shutdown on key revocation. + KeyRevocationActionType string `json:"keyRevocationActionType,omitempty"` + // Labels: Optional. Labels to apply to this instance. + Labels map[string]string `json:"labels,omitempty"` + // MachineType: Optional. Full or partial URL of the machine type resource to + // use for this instance. + MachineType string `json:"machineType,omitempty"` + // Metadata: Optional. This includes custom metadata and predefined keys. + Metadata *Metadata `json:"metadata,omitempty"` + // MinCpuPlatform: Optional. Minimum CPU platform to use for this instance. + MinCpuPlatform string `json:"minCpuPlatform,omitempty"` + // Name: Required. Name of the compute instance. + Name string `json:"name,omitempty"` + // NetworkInterfaces: Optional. An array of network configurations for this + // instance. These specify how interfaces are configured to interact with other + // network services, such as connecting to the internet. Multiple interfaces + // are supported per instance. + NetworkInterfaces []*NetworkInterface `json:"networkInterfaces,omitempty"` + // NetworkPerformanceConfig: Optional. Configure network performance such as + // egress bandwidth tier. + NetworkPerformanceConfig *NetworkPerformanceConfig `json:"networkPerformanceConfig,omitempty"` + // Params: Input only. Additional params passed with the request, but not + // persisted as part of resource payload. + Params *InstanceParams `json:"params,omitempty"` + // PrivateIpv6GoogleAccess: Optional. The private IPv6 google access type for + // the VM. If not specified, use INHERIT_FROM_SUBNETWORK as default. + // + // Possible values: + // "INSTANCE_PRIVATE_IPV6_GOOGLE_ACCESS_UNSPECIFIED" - Default value. This + // value is unused. + // "INHERIT_FROM_SUBNETWORK" - Each network interface inherits + // PrivateIpv6GoogleAccess from its subnetwork. + // "ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE" - Outbound private IPv6 access from + // VMs in this subnet to Google services. If specified, the subnetwork who is + // attached to the instance's default network interface will be assigned an + // internal IPv6 prefix if it doesn't have before. + // "ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE" - Bidirectional private IPv6 + // access to/from Google services. If specified, the subnetwork who is attached + // to the instance's default network interface will be assigned an internal + // IPv6 prefix if it doesn't have before. + PrivateIpv6GoogleAccess string `json:"privateIpv6GoogleAccess,omitempty"` + // ReservationAffinity: Optional. Specifies the reservations that this instance + // can consume from. + ReservationAffinity *AllocationAffinity `json:"reservationAffinity,omitempty"` + // ResourcePolicies: Optional. Resource policies applied to this instance. + ResourcePolicies []string `json:"resourcePolicies,omitempty"` + // Scheduling: Optional. Sets the scheduling options for this instance. + Scheduling *Scheduling `json:"scheduling,omitempty"` + // ServiceAccounts: Optional. A list of service accounts, with their specified + // scopes, authorized for this instance. Only one service account per VM + // instance is supported. + ServiceAccounts []*ServiceAccount `json:"serviceAccounts,omitempty"` + // Tags: Optional. Tags to apply to this instance. Tags are used to identify + // valid sources or targets for network firewalls and are specified by the + // client during instance creation. + Tags *Tags `json:"tags,omitempty"` + // ForceSendFields is a list of field names (e.g. "AdvancedMachineFeatures") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AdvancedMachineFeatures") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ComputeInstanceRestoreProperties) MarshalJSON() ([]byte, error) { + type NoMethod ComputeInstanceRestoreProperties + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ComputeInstanceTargetEnvironment: ComputeInstanceTargetEnvironment +// represents Compute Engine target environment to be used during restore. +type ComputeInstanceTargetEnvironment struct { + // Project: Required. Target project for the Compute Engine instance. + Project string `json:"project,omitempty"` + // Zone: Required. The zone of the Compute Engine instance. + Zone string `json:"zone,omitempty"` + // ForceSendFields is a list of field names (e.g. "Project") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Project") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ComputeInstanceTargetEnvironment) MarshalJSON() ([]byte, error) { + type NoMethod ComputeInstanceTargetEnvironment + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ConfidentialInstanceConfig: A set of Confidential Instance options. +type ConfidentialInstanceConfig struct { + // EnableConfidentialCompute: Optional. Defines whether the instance should + // have confidential compute enabled. + EnableConfidentialCompute bool `json:"enableConfidentialCompute,omitempty"` + // ForceSendFields is a list of field names (e.g. "EnableConfidentialCompute") + // to unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "EnableConfidentialCompute") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ConfidentialInstanceConfig) MarshalJSON() ([]byte, error) { + type NoMethod ConfidentialInstanceConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // CustomerEncryptionKey: A customer-supplied encryption key. type CustomerEncryptionKey struct { // KmsKeyName: Optional. The name of the encryption key that is stored in @@ -1401,6 +1867,28 @@ func (s DirectLocationAssignment) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// DisplayDevice: A set of Display Device options +type DisplayDevice struct { + // EnableDisplay: Optional. Enables display for the Compute Engine VM + EnableDisplay bool `json:"enableDisplay,omitempty"` + // ForceSendFields is a list of field names (e.g. "EnableDisplay") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "EnableDisplay") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s DisplayDevice) MarshalJSON() ([]byte, error) { + type NoMethod DisplayDevice + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Empty: A generic empty message that you can re-use to avoid defining // duplicated empty messages in your APIs. A typical example is to use it as // the request or the response type of an API method. For instance: service Foo @@ -1839,6 +2327,29 @@ func (s InitiateBackupResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// InstanceParams: Additional instance params. +type InstanceParams struct { + // ResourceManagerTags: Optional. Resource manager tags to be bound to the + // instance. + ResourceManagerTags map[string]string `json:"resourceManagerTags,omitempty"` + // ForceSendFields is a list of field names (e.g. "ResourceManagerTags") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ResourceManagerTags") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s InstanceParams) MarshalJSON() ([]byte, error) { + type NoMethod InstanceParams + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type IsolationExpectations struct { // RequirementOverride: Explicit overrides for ZI and ZS requirements to be // used for resources that should be excluded from ZI/ZS verification logic. @@ -1914,15 +2425,16 @@ func (s IsolationExpectations) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// ListBackupVaultsResponse: Response message for listing BackupVaults. -type ListBackupVaultsResponse struct { - // BackupVaults: The list of BackupVault instances in the project for the - // specified location. If the '{location}' value in the request is "-", the - // response contains a list of instances from all locations. In case any - // location is unreachable, the response will only return backup vaults in - // reachable locations and the 'unreachable' field will be populated with a - // list of unreachable locations. - BackupVaults []*BackupVault `json:"backupVaults,omitempty"` +// ListBackupPlanAssociationsResponse: Response message for List +// BackupPlanAssociation +type ListBackupPlanAssociationsResponse struct { + // BackupPlanAssociations: The list of Backup Plan Associations in the project + // for the specified location. If the `{location}` value in the request is "-", + // the response contains a list of instances from all locations. In case any + // location is unreachable, the response will only return backup plan + // associations in reachable locations and the 'unreachable' field will be + // populated with a list of unreachable locations. + BackupPlanAssociations []*BackupPlanAssociation `json:"backupPlanAssociations,omitempty"` // NextPageToken: A token identifying a page of results the server should // return. NextPageToken string `json:"nextPageToken,omitempty"` @@ -1931,55 +2443,127 @@ type ListBackupVaultsResponse struct { // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "BackupVaults") to + // ForceSendFields is a list of field names (e.g. "BackupPlanAssociations") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "BackupVaults") 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. "BackupPlanAssociations") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s ListBackupVaultsResponse) MarshalJSON() ([]byte, error) { - type NoMethod ListBackupVaultsResponse +func (s ListBackupPlanAssociationsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListBackupPlanAssociationsResponse return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// ListBackupsResponse: Response message for listing Backups. -type ListBackupsResponse struct { - // Backups: The list of Backup instances in the project for the specified - // location. If the '{location}' value in the request is "-", the response - // contains a list of instances from all locations. In case any location is - // unreachable, the response will only return data sources in reachable +// ListBackupPlansResponse: The response message for getting a list of +// `BackupPlan`. +type ListBackupPlansResponse struct { + // BackupPlans: The list of `BackupPlans` in the project for the specified + // location. If the `{location}` value in the request is "-", the response + // contains a list of resources from all locations. In case any location is + // unreachable, the response will only return backup plans in reachable // locations and the 'unreachable' field will be populated with a list of - // unreachable locations. - Backups []*Backup `json:"backups,omitempty"` - // NextPageToken: A token identifying a page of results the server should - // return. + // unreachable locations. BackupPlan + BackupPlans []*BackupPlan `json:"backupPlans,omitempty"` + // NextPageToken: A token which may be sent as page_token in a subsequent + // `ListBackupPlans` call to retrieve the next page of results. If this field + // is omitted or empty, then there are no more results to return. NextPageToken string `json:"nextPageToken,omitempty"` // Unreachable: Locations that could not be reached. Unreachable []string `json:"unreachable,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "Backups") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See + // ForceSendFields is a list of field names (e.g. "BackupPlans") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Backups") to include in API + // NullFields is a list of field names (e.g. "BackupPlans") to include in API // requests with the JSON null value. By default, fields with empty values are // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } -func (s ListBackupsResponse) MarshalJSON() ([]byte, error) { +func (s ListBackupPlansResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListBackupPlansResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ListBackupVaultsResponse: Response message for listing BackupVaults. +type ListBackupVaultsResponse struct { + // BackupVaults: The list of BackupVault instances in the project for the + // specified location. If the '{location}' value in the request is "-", the + // response contains a list of instances from all locations. In case any + // location is unreachable, the response will only return backup vaults in + // reachable locations and the 'unreachable' field will be populated with a + // list of unreachable locations. + BackupVaults []*BackupVault `json:"backupVaults,omitempty"` + // NextPageToken: A token identifying a page of results the server should + // return. + NextPageToken string `json:"nextPageToken,omitempty"` + // Unreachable: Locations that could not be reached. + Unreachable []string `json:"unreachable,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "BackupVaults") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BackupVaults") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ListBackupVaultsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListBackupVaultsResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ListBackupsResponse: Response message for listing Backups. +type ListBackupsResponse struct { + // Backups: The list of Backup instances in the project for the specified + // location. If the '{location}' value in the request is "-", the response + // contains a list of instances from all locations. In case any location is + // unreachable, the response will only return data sources in reachable + // locations and the 'unreachable' field will be populated with a list of + // unreachable locations. + Backups []*Backup `json:"backups,omitempty"` + // NextPageToken: A token identifying a page of results the server should + // return. + NextPageToken string `json:"nextPageToken,omitempty"` + // Unreachable: Locations that could not be reached. + Unreachable []string `json:"unreachable,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Backups") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Backups") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ListBackupsResponse) MarshalJSON() ([]byte, error) { type NoMethod ListBackupsResponse return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } @@ -2460,6 +3044,33 @@ func (s NetworkInterface) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// NetworkPerformanceConfig: Network performance configuration. +type NetworkPerformanceConfig struct { + // TotalEgressBandwidthTier: Optional. The tier of the total egress bandwidth. + // + // Possible values: + // "TIER_UNSPECIFIED" - This value is unused. + // "DEFAULT" - Default network performance config. + // "TIER_1" - Tier 1 network performance config. + TotalEgressBandwidthTier string `json:"totalEgressBandwidthTier,omitempty"` + // ForceSendFields is a list of field names (e.g. "TotalEgressBandwidthTier") + // to unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "TotalEgressBandwidthTier") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s NetworkPerformanceConfig) MarshalJSON() ([]byte, error) { + type NoMethod NetworkPerformanceConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // NodeAffinity: Node Affinity: the configuration of desired nodes onto which // this Instance could be scheduled. type NodeAffinity struct { @@ -2787,6 +3398,91 @@ func (s RequirementOverride) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// RestoreBackupRequest: Request message for restoring from a Backup. +type RestoreBackupRequest struct { + // ComputeInstanceRestoreProperties: Compute Engine instance properties to be + // overridden during restore. + ComputeInstanceRestoreProperties *ComputeInstanceRestoreProperties `json:"computeInstanceRestoreProperties,omitempty"` + // ComputeInstanceTargetEnvironment: Compute Engine target environment to be + // used during restore. + ComputeInstanceTargetEnvironment *ComputeInstanceTargetEnvironment `json:"computeInstanceTargetEnvironment,omitempty"` + // RequestId: Optional. An optional request ID to identify requests. Specify a + // unique request ID so that if you must retry your request, the server will + // know to ignore the request if it has already been completed. The server will + // guarantee that for at least 60 minutes after the first request. For example, + // consider a situation where you make an initial request and the request times + // out. If you make the request again with the same request ID, the server can + // check if original operation with the same request ID was received, and if + // so, will ignore the second request. This prevents clients from accidentally + // creating duplicate commitments. The request ID must be a valid UUID with the + // exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + RequestId string `json:"requestId,omitempty"` + // ForceSendFields is a list of field names (e.g. + // "ComputeInstanceRestoreProperties") to unconditionally include in API + // requests. By default, fields with empty or default values are omitted from + // API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. + // "ComputeInstanceRestoreProperties") to include in API requests with the JSON + // null value. By default, fields with empty values are omitted from API + // requests. See https://pkg.go.dev/google.golang.org/api#hdr-NullFields for + // more details. + NullFields []string `json:"-"` +} + +func (s RestoreBackupRequest) MarshalJSON() ([]byte, error) { + type NoMethod RestoreBackupRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// RuleConfigInfo: Message for rules config info. +type RuleConfigInfo struct { + // DataSource: Output only. TODO b/341576760: Remove deprecated BV and + // Datasource field form BP and BPA once UI removed all dependencies on them + // Output Only. Resource name of data source which will be used as storage + // location for backups taken by specified rule. Format : + // projects/{project}/locations/{location}/backupVaults/{backupvault}/dataSource + // s/{datasource} + DataSource string `json:"dataSource,omitempty"` + // LastBackupError: Output only. Output Only. google.rpc.Status object to store + // the last backup error. + LastBackupError *Status `json:"lastBackupError,omitempty"` + // LastBackupState: Output only. The last backup state for rule. + // + // Possible values: + // "LAST_BACKUP_STATE_UNSPECIFIED" - State not set. + // "FIRST_BACKUP_PENDING" - The first backup is pending. + // "PERMISSION_DENIED" - The most recent backup could not be run/failed + // because of the lack of permissions. + // "SUCCEEDED" - The last backup operation succeeded. + // "FAILED" - The last backup operation failed. + LastBackupState string `json:"lastBackupState,omitempty"` + // LastSuccessfulBackupConsistencyTime: Output only. The point in time when the + // last successful backup was captured from the source. + LastSuccessfulBackupConsistencyTime string `json:"lastSuccessfulBackupConsistencyTime,omitempty"` + // RuleId: Output only. Output Only. Backup Rule id fetched from backup plan. + RuleId string `json:"ruleId,omitempty"` + // ForceSendFields is a list of field names (e.g. "DataSource") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "DataSource") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s RuleConfigInfo) MarshalJSON() ([]byte, error) { + type NoMethod RuleConfigInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Scheduling: Sets the scheduling options for an Instance. type Scheduling struct { // AutomaticRestart: Optional. Specifies whether the instance should be @@ -3027,6 +3723,106 @@ func (s SpannerLocation) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// StandardSchedule: `StandardSchedule` defines a schedule that run within the +// confines of a defined window of days. We can define recurrence type for +// schedule as HOURLY, DAILY, WEEKLY, MONTHLY or YEARLY. +type StandardSchedule struct { + // BackupWindow: Required. A BackupWindow defines the window of day during + // which backup jobs will run. Jobs are queued at the beginning of the window + // and will be marked as `NOT_RUN` if they do not start by the end of the + // window. Note: running jobs will not be cancelled at the end of the window. + BackupWindow *BackupWindow `json:"backupWindow,omitempty"` + // DaysOfMonth: Optional. Specifies days of months like 1, 5, or 14 on which + // jobs will run. Values for `days_of_month` are only applicable for + // `recurrence_type`, `MONTHLY` and `YEARLY`. A validation error will occur if + // other values are supplied. + DaysOfMonth []int64 `json:"daysOfMonth,omitempty"` + // DaysOfWeek: Optional. Specifies days of week like, MONDAY or TUESDAY, on + // which jobs will run. This is required for `recurrence_type`, `WEEKLY` and is + // not applicable otherwise. A validation error will occur if a value is + // supplied and `recurrence_type` is not `WEEKLY`. + // + // Possible values: + // "DAY_OF_WEEK_UNSPECIFIED" - The day of the week is unspecified. + // "MONDAY" - Monday + // "TUESDAY" - Tuesday + // "WEDNESDAY" - Wednesday + // "THURSDAY" - Thursday + // "FRIDAY" - Friday + // "SATURDAY" - Saturday + // "SUNDAY" - Sunday + DaysOfWeek []string `json:"daysOfWeek,omitempty"` + // HourlyFrequency: Optional. Specifies frequency for hourly backups. A hourly + // frequency of 2 means jobs will run every 2 hours from start time till end + // time defined. This is required for `recurrence_type`, `HOURLY` and is not + // applicable otherwise. A validation error will occur if a value is supplied + // and `recurrence_type` is not `HOURLY`. Value of hourly frequency should be + // between 6 and 23. Reason for limit : We found that there is bandwidth + // limitation of 3GB/S for GMI while taking a backup and 5GB/S while doing a + // restore. Given the amount of parallel backups and restore we are targeting, + // this will potentially take the backup time to mins and hours (in worst case + // scenario). + HourlyFrequency int64 `json:"hourlyFrequency,omitempty"` + // Months: Optional. Specifies the months of year, like `FEBRUARY` and/or + // `MAY`, on which jobs will run. This field is only applicable when + // `recurrence_type` is `YEARLY`. A validation error will occur if other values + // are supplied. + // + // Possible values: + // "MONTH_UNSPECIFIED" - The unspecified month. + // "JANUARY" - The month of January. + // "FEBRUARY" - The month of February. + // "MARCH" - The month of March. + // "APRIL" - The month of April. + // "MAY" - The month of May. + // "JUNE" - The month of June. + // "JULY" - The month of July. + // "AUGUST" - The month of August. + // "SEPTEMBER" - The month of September. + // "OCTOBER" - The month of October. + // "NOVEMBER" - The month of November. + // "DECEMBER" - The month of December. + Months []string `json:"months,omitempty"` + // RecurrenceType: Required. Specifies the `RecurrenceType` for the schedule. + // + // Possible values: + // "RECURRENCE_TYPE_UNSPECIFIED" - recurrence type not set + // "HOURLY" - The `BackupRule` is to be applied hourly. + // "DAILY" - The `BackupRule` is to be applied daily. + // "WEEKLY" - The `BackupRule` is to be applied weekly. + // "MONTHLY" - The `BackupRule` is to be applied monthly. + // "YEARLY" - The `BackupRule` is to be applied yearly. + RecurrenceType string `json:"recurrenceType,omitempty"` + // TimeZone: Required. The time zone to be used when interpreting the schedule. + // The value of this field must be a time zone name from the IANA tz database. + // See https://en.wikipedia.org/wiki/List_of_tz_database_time_zones for the + // list of valid timezone names. For e.g., Europe/Paris. + TimeZone string `json:"timeZone,omitempty"` + // WeekDayOfMonth: Optional. Specifies a week day of the month like, FIRST + // SUNDAY or LAST MONDAY, on which jobs will run. This will be specified by two + // fields in `WeekDayOfMonth`, one for the day, e.g. `MONDAY`, and one for the + // week, e.g. `LAST`. This field is only applicable for `recurrence_type`, + // `MONTHLY` and `YEARLY`. A validation error will occur if other values are + // supplied. + WeekDayOfMonth *WeekDayOfMonth `json:"weekDayOfMonth,omitempty"` + // ForceSendFields is a list of field names (e.g. "BackupWindow") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BackupWindow") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s StandardSchedule) MarshalJSON() ([]byte, error) { + type NoMethod StandardSchedule + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Status: The `Status` type defines a logical error model that is suitable for // different programming environments, including REST APIs and RPC APIs. It is // used by gRPC (https://github.com/grpc). Each `Status` message contains three @@ -3156,6 +3952,84 @@ func (s TestIamPermissionsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// TriggerBackupRequest: Request message for triggering a backup. +type TriggerBackupRequest struct { + // RequestId: Optional. An optional request ID to identify requests. Specify a + // unique request ID so that if you must retry your request, the server will + // know to ignore the request if it has already been completed. The server will + // guarantee that for at least 60 minutes after the first request. For example, + // consider a situation where you make an initial request and the request times + // out. If you make the request again with the same request ID, the server can + // check if original operation with the same request ID was received, and if + // so, will ignore the second request. This prevents clients from accidentally + // creating duplicate commitments. The request ID must be a valid UUID with the + // exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + RequestId string `json:"requestId,omitempty"` + // RuleId: Required. backup rule_id for which a backup needs to be triggered. + RuleId string `json:"ruleId,omitempty"` + // ForceSendFields is a list of field names (e.g. "RequestId") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "RequestId") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s TriggerBackupRequest) MarshalJSON() ([]byte, error) { + type NoMethod TriggerBackupRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// WeekDayOfMonth: `WeekDayOfMonth` defines the week day of the month on which +// the backups will run. The message combines a `WeekOfMonth` and `DayOfWeek` +// to produce values like `FIRST`/`MONDAY` or `LAST`/`FRIDAY`. +type WeekDayOfMonth struct { + // DayOfWeek: Required. Specifies the day of the week. + // + // Possible values: + // "DAY_OF_WEEK_UNSPECIFIED" - The day of the week is unspecified. + // "MONDAY" - Monday + // "TUESDAY" - Tuesday + // "WEDNESDAY" - Wednesday + // "THURSDAY" - Thursday + // "FRIDAY" - Friday + // "SATURDAY" - Saturday + // "SUNDAY" - Sunday + DayOfWeek string `json:"dayOfWeek,omitempty"` + // WeekOfMonth: Required. Specifies the week of the month. + // + // Possible values: + // "WEEK_OF_MONTH_UNSPECIFIED" - The zero value. Do not use. + // "FIRST" - The first week of the month. + // "SECOND" - The second week of the month. + // "THIRD" - The third week of the month. + // "FOURTH" - The fourth week of the month. + // "LAST" - The last week of the month. + WeekOfMonth string `json:"weekOfMonth,omitempty"` + // ForceSendFields is a list of field names (e.g. "DayOfWeek") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "DayOfWeek") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s WeekDayOfMonth) MarshalJSON() ([]byte, error) { + type NoMethod WeekDayOfMonth + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // WorkforceIdentityBasedManagementURI: ManagementURI depending on the // Workforce Identity i.e. either 1p or 3p. type WorkforceIdentityBasedManagementURI struct { @@ -3178,59 +4052,1166 @@ type WorkforceIdentityBasedManagementURI struct { NullFields []string `json:"-"` } -func (s WorkforceIdentityBasedManagementURI) MarshalJSON() ([]byte, error) { - type NoMethod WorkforceIdentityBasedManagementURI - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +func (s WorkforceIdentityBasedManagementURI) MarshalJSON() ([]byte, error) { + type NoMethod WorkforceIdentityBasedManagementURI + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// WorkforceIdentityBasedOAuth2ClientID: OAuth Client ID depending on the +// Workforce Identity i.e. either 1p or 3p, +type WorkforceIdentityBasedOAuth2ClientID struct { + // FirstPartyOauth2ClientId: Output only. First party OAuth Client ID for + // Google Identities. + FirstPartyOauth2ClientId string `json:"firstPartyOauth2ClientId,omitempty"` + // ThirdPartyOauth2ClientId: Output only. Third party OAuth Client ID for + // External Identity Providers. + ThirdPartyOauth2ClientId string `json:"thirdPartyOauth2ClientId,omitempty"` + // ForceSendFields is a list of field names (e.g. "FirstPartyOauth2ClientId") + // to unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "FirstPartyOauth2ClientId") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s WorkforceIdentityBasedOAuth2ClientID) MarshalJSON() ([]byte, error) { + type NoMethod WorkforceIdentityBasedOAuth2ClientID + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type ZoneConfiguration struct { + Zone string `json:"zone,omitempty"` + // ForceSendFields is a list of field names (e.g. "Zone") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Zone") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ZoneConfiguration) MarshalJSON() ([]byte, error) { + type NoMethod ZoneConfiguration + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type ProjectsLocationsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets information about a location. +// +// - name: Resource name for the location. +func (r *ProjectsLocationsService) Get(name string) *ProjectsLocationsGetCall { + c := &ProjectsLocationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGetCall) Context(ctx context.Context) *ProjectsLocationsGetCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "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 "backupdr.projects.locations.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *Location.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsGetCall) Do(opts ...googleapi.CallOption) (*Location, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &Location{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil +} + +type ProjectsLocationsListCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists information about the supported locations for this service. +// +// - name: The resource that owns the locations collection, if applicable. +func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall { + c := &ProjectsLocationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Filter sets the optional parameter "filter": A filter to narrow down results +// to a preferred subset. The filtering language accepts strings like +// "displayName=tokyo", and is documented in more detail in AIP-160 +// (https://google.aip.dev/160). +func (c *ProjectsLocationsListCall) Filter(filter string) *ProjectsLocationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number of +// results to return. If not set, the service selects a default. +func (c *ProjectsLocationsListCall) PageSize(pageSize int64) *ProjectsLocationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A page token received +// from the `next_page_token` field in the response. Send that page token to +// receive the subsequent page. +func (c *ProjectsLocationsListCall) PageToken(pageToken string) *ProjectsLocationsListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsListCall) Context(ctx context.Context) *ProjectsLocationsListCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}/locations") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "backupdr.projects.locations.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *ListLocationsResponse.ServerResponse.Header or (if a response was returned +// at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified was +// returned. +func (c *ProjectsLocationsListCall) Do(opts ...googleapi.CallOption) (*ListLocationsResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &ListLocationsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *ProjectsLocationsListCall) Pages(ctx context.Context, f func(*ListLocationsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + +type ProjectsLocationsBackupPlanAssociationsCreateCall struct { + s *Service + parent string + backupplanassociation *BackupPlanAssociation + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Create a BackupPlanAssociation +// +// - parent: The backup plan association project and location in the format +// `projects/{project_id}/locations/{location}`. In Cloud BackupDR locations +// map to GCP regions, for example **us-central1**. +func (r *ProjectsLocationsBackupPlanAssociationsService) Create(parent string, backupplanassociation *BackupPlanAssociation) *ProjectsLocationsBackupPlanAssociationsCreateCall { + c := &ProjectsLocationsBackupPlanAssociationsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.backupplanassociation = backupplanassociation + return c +} + +// BackupPlanAssociationId sets the optional parameter +// "backupPlanAssociationId": Required. The name of the backup plan association +// to create. The name must be unique for the specified project and location. +func (c *ProjectsLocationsBackupPlanAssociationsCreateCall) BackupPlanAssociationId(backupPlanAssociationId string) *ProjectsLocationsBackupPlanAssociationsCreateCall { + c.urlParams_.Set("backupPlanAssociationId", backupPlanAssociationId) + return c +} + +// RequestId sets the optional parameter "requestId": An optional request ID to +// identify requests. Specify a unique request ID so that if you must retry +// your request, the server will know to ignore the request if it has already +// been completed. The server will guarantee that for at least 60 minutes since +// the first request. For example, consider a situation where you make an +// initial request and t he request times out. If you make the request again +// with the same request ID, the server can check if original operation with +// the same request ID was received, and if so, will ignore the second request. +// This prevents clients from accidentally creating duplicate commitments. The +// request ID must be a valid UUID with the exception that zero UUID is not +// supported (00000000-0000-0000-0000-000000000000). +func (c *ProjectsLocationsBackupPlanAssociationsCreateCall) RequestId(requestId string) *ProjectsLocationsBackupPlanAssociationsCreateCall { + c.urlParams_.Set("requestId", requestId) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsBackupPlanAssociationsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsBackupPlanAssociationsCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsBackupPlanAssociationsCreateCall) Context(ctx context.Context) *ProjectsLocationsBackupPlanAssociationsCreateCall { + 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 *ProjectsLocationsBackupPlanAssociationsCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBackupPlanAssociationsCreateCall) 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.backupplanassociation) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/backupPlanAssociations") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "backupdr.projects.locations.backupPlanAssociations.create" call. +// Any non-2xx status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsBackupPlanAssociationsCreateCall) 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 ProjectsLocationsBackupPlanAssociationsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes a single BackupPlanAssociation. +// +// - name: Name of the backup plan association resource, in the format +// `projects/{project}/locations/{location}/backupPlanAssociations/{backupPlan +// AssociationId}`. +func (r *ProjectsLocationsBackupPlanAssociationsService) Delete(name string) *ProjectsLocationsBackupPlanAssociationsDeleteCall { + c := &ProjectsLocationsBackupPlanAssociationsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// RequestId sets the optional parameter "requestId": An optional request ID to +// identify requests. Specify a unique request ID so that if you must retry +// your request, the server will know to ignore the request if it has already +// been completed. The server will guarantee that for at least 60 minutes after +// the first request. For example, consider a situation where you make an +// initial request and the request times out. If you make the request again +// with the same request ID, the server can check if original operation with +// the same request ID was received, and if so, will ignore the second request. +// This prevents clients from accidentally creating duplicate commitments. The +// request ID must be a valid UUID with the exception that zero UUID is not +// supported (00000000-0000-0000-0000-000000000000). +func (c *ProjectsLocationsBackupPlanAssociationsDeleteCall) RequestId(requestId string) *ProjectsLocationsBackupPlanAssociationsDeleteCall { + c.urlParams_.Set("requestId", requestId) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsBackupPlanAssociationsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsBackupPlanAssociationsDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsBackupPlanAssociationsDeleteCall) Context(ctx context.Context) *ProjectsLocationsBackupPlanAssociationsDeleteCall { + 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 *ProjectsLocationsBackupPlanAssociationsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBackupPlanAssociationsDeleteCall) 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 "backupdr.projects.locations.backupPlanAssociations.delete" call. +// Any non-2xx status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsBackupPlanAssociationsDeleteCall) 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 ProjectsLocationsBackupPlanAssociationsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets details of a single BackupPlanAssociation. +// +// - name: Name of the backup plan association resource, in the format +// `projects/{project}/locations/{location}/backupPlanAssociations/{backupPlan +// AssociationId}`. +func (r *ProjectsLocationsBackupPlanAssociationsService) Get(name string) *ProjectsLocationsBackupPlanAssociationsGetCall { + c := &ProjectsLocationsBackupPlanAssociationsGetCall{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 *ProjectsLocationsBackupPlanAssociationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsBackupPlanAssociationsGetCall { + 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 *ProjectsLocationsBackupPlanAssociationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsBackupPlanAssociationsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsBackupPlanAssociationsGetCall) Context(ctx context.Context) *ProjectsLocationsBackupPlanAssociationsGetCall { + 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 *ProjectsLocationsBackupPlanAssociationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBackupPlanAssociationsGetCall) 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 "backupdr.projects.locations.backupPlanAssociations.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *BackupPlanAssociation.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 *ProjectsLocationsBackupPlanAssociationsGetCall) Do(opts ...googleapi.CallOption) (*BackupPlanAssociation, 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 := &BackupPlanAssociation{ + 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 ProjectsLocationsBackupPlanAssociationsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists BackupPlanAssociations in a given project and location. +// +// - parent: The project and location for which to retrieve backup Plan +// Associations information, in the format +// `projects/{project_id}/locations/{location}`. In Cloud BackupDR, locations +// map to GCP regions, for example **us-central1**. To retrieve backup plan +// associations for all locations, use "-" for the `{location}` value. +func (r *ProjectsLocationsBackupPlanAssociationsService) List(parent string) *ProjectsLocationsBackupPlanAssociationsListCall { + c := &ProjectsLocationsBackupPlanAssociationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Filter sets the optional parameter "filter": Filtering results +func (c *ProjectsLocationsBackupPlanAssociationsListCall) Filter(filter string) *ProjectsLocationsBackupPlanAssociationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": Requested page size. Server +// may return fewer items than requested. If unspecified, server will pick an +// appropriate default. +func (c *ProjectsLocationsBackupPlanAssociationsListCall) PageSize(pageSize int64) *ProjectsLocationsBackupPlanAssociationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A token identifying a +// page of results the server should return. +func (c *ProjectsLocationsBackupPlanAssociationsListCall) PageToken(pageToken string) *ProjectsLocationsBackupPlanAssociationsListCall { + 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 *ProjectsLocationsBackupPlanAssociationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsBackupPlanAssociationsListCall { + 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 *ProjectsLocationsBackupPlanAssociationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsBackupPlanAssociationsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsBackupPlanAssociationsListCall) Context(ctx context.Context) *ProjectsLocationsBackupPlanAssociationsListCall { + 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 *ProjectsLocationsBackupPlanAssociationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBackupPlanAssociationsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/backupPlanAssociations") + 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 "backupdr.projects.locations.backupPlanAssociations.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *ListBackupPlanAssociationsResponse.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 *ProjectsLocationsBackupPlanAssociationsListCall) Do(opts ...googleapi.CallOption) (*ListBackupPlanAssociationsResponse, 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 := &ListBackupPlanAssociationsResponse{ + 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 *ProjectsLocationsBackupPlanAssociationsListCall) Pages(ctx context.Context, f func(*ListBackupPlanAssociationsResponse) 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 ProjectsLocationsBackupPlanAssociationsTriggerBackupCall struct { + s *Service + name string + triggerbackuprequest *TriggerBackupRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// TriggerBackup: Triggers a new Backup. +// +// - name: Name of the backup plan association resource, in the format +// `projects/{project}/locations/{location}/backupPlanAssociations/{backupPlan +// AssociationId}`. +func (r *ProjectsLocationsBackupPlanAssociationsService) TriggerBackup(name string, triggerbackuprequest *TriggerBackupRequest) *ProjectsLocationsBackupPlanAssociationsTriggerBackupCall { + c := &ProjectsLocationsBackupPlanAssociationsTriggerBackupCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.triggerbackuprequest = triggerbackuprequest + 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 *ProjectsLocationsBackupPlanAssociationsTriggerBackupCall) Fields(s ...googleapi.Field) *ProjectsLocationsBackupPlanAssociationsTriggerBackupCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsBackupPlanAssociationsTriggerBackupCall) Context(ctx context.Context) *ProjectsLocationsBackupPlanAssociationsTriggerBackupCall { + 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 *ProjectsLocationsBackupPlanAssociationsTriggerBackupCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBackupPlanAssociationsTriggerBackupCall) 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.triggerbackuprequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:triggerBackup") + 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 "backupdr.projects.locations.backupPlanAssociations.triggerBackup" 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 *ProjectsLocationsBackupPlanAssociationsTriggerBackupCall) 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 ProjectsLocationsBackupPlansCreateCall struct { + s *Service + parent string + backupplan *BackupPlan + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Create a BackupPlan +// +// - parent: The `BackupPlan` project and location in the format +// `projects/{project}/locations/{location}`. In Cloud BackupDR locations map +// to GCP regions, for example **us-central1**. +func (r *ProjectsLocationsBackupPlansService) Create(parent string, backupplan *BackupPlan) *ProjectsLocationsBackupPlansCreateCall { + c := &ProjectsLocationsBackupPlansCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.backupplan = backupplan + return c +} + +// BackupPlanId sets the optional parameter "backupPlanId": Required. The name +// of the `BackupPlan` to create. The name must be unique for the specified +// project and location.The name must start with a lowercase letter followed by +// up to 62 lowercase letters, numbers, or hyphens. Pattern, /a-z{,62}/. +func (c *ProjectsLocationsBackupPlansCreateCall) BackupPlanId(backupPlanId string) *ProjectsLocationsBackupPlansCreateCall { + c.urlParams_.Set("backupPlanId", backupPlanId) + return c +} + +// RequestId sets the optional parameter "requestId": An optional request ID to +// identify requests. Specify a unique request ID so that if you must retry +// your request, the server will know to ignore the request if it has already +// been completed. The server will guarantee that for at least 60 minutes since +// the first request. For example, consider a situation where you make an +// initial request and t he request times out. If you make the request again +// with the same request ID, the server can check if original operation with +// the same request ID was received, and if so, will ignore the second request. +// This prevents clients from accidentally creating duplicate commitments. The +// request ID must be a valid UUID with the exception that zero UUID is not +// supported (00000000-0000-0000-0000-000000000000). +func (c *ProjectsLocationsBackupPlansCreateCall) RequestId(requestId string) *ProjectsLocationsBackupPlansCreateCall { + c.urlParams_.Set("requestId", requestId) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsBackupPlansCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsBackupPlansCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsBackupPlansCreateCall) Context(ctx context.Context) *ProjectsLocationsBackupPlansCreateCall { + 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 *ProjectsLocationsBackupPlansCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBackupPlansCreateCall) 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.backupplan) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/backupPlans") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "backupdr.projects.locations.backupPlans.create" call. +// Any non-2xx status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsBackupPlansCreateCall) 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 ProjectsLocationsBackupPlansDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes a single BackupPlan. +// +// - name: The resource name of the `BackupPlan` to delete. Format: +// `projects/{project}/locations/{location}/backupPlans/{backup_plan}`. +func (r *ProjectsLocationsBackupPlansService) Delete(name string) *ProjectsLocationsBackupPlansDeleteCall { + c := &ProjectsLocationsBackupPlansDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// RequestId sets the optional parameter "requestId": An optional request ID to +// identify requests. Specify a unique request ID so that if you must retry +// your request, the server will know to ignore the request if it has already +// been completed. The server will guarantee that for at least 60 minutes after +// the first request. For example, consider a situation where you make an +// initial request and the request times out. If you make the request again +// with the same request ID, the server can check if original operation with +// the same request ID was received, and if so, will ignore the second request. +// This prevents clients from accidentally creating duplicate commitments. The +// request ID must be a valid UUID with the exception that zero UUID is not +// supported (00000000-0000-0000-0000-000000000000). +func (c *ProjectsLocationsBackupPlansDeleteCall) RequestId(requestId string) *ProjectsLocationsBackupPlansDeleteCall { + c.urlParams_.Set("requestId", requestId) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsBackupPlansDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsBackupPlansDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c } -// WorkforceIdentityBasedOAuth2ClientID: OAuth Client ID depending on the -// Workforce Identity i.e. either 1p or 3p, -type WorkforceIdentityBasedOAuth2ClientID struct { - // FirstPartyOauth2ClientId: Output only. First party OAuth Client ID for - // Google Identities. - FirstPartyOauth2ClientId string `json:"firstPartyOauth2ClientId,omitempty"` - // ThirdPartyOauth2ClientId: Output only. Third party OAuth Client ID for - // External Identity Providers. - ThirdPartyOauth2ClientId string `json:"thirdPartyOauth2ClientId,omitempty"` - // ForceSendFields is a list of field names (e.g. "FirstPartyOauth2ClientId") - // to unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "FirstPartyOauth2ClientId") to - // include in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsBackupPlansDeleteCall) Context(ctx context.Context) *ProjectsLocationsBackupPlansDeleteCall { + c.ctx_ = ctx + return c } -func (s WorkforceIdentityBasedOAuth2ClientID) MarshalJSON() ([]byte, error) { - type NoMethod WorkforceIdentityBasedOAuth2ClientID - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsBackupPlansDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ } -type ZoneConfiguration struct { - Zone string `json:"zone,omitempty"` - // ForceSendFields is a list of field names (e.g. "Zone") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Zone") to include in API requests - // with the JSON null value. By default, fields with empty values are omitted - // from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` +func (c *ProjectsLocationsBackupPlansDeleteCall) 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) } -func (s ZoneConfiguration) MarshalJSON() ([]byte, error) { - type NoMethod ZoneConfiguration - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +// Do executes the "backupdr.projects.locations.backupPlans.delete" call. +// Any non-2xx status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsBackupPlansDeleteCall) 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 ProjectsLocationsGetCall struct { +type ProjectsLocationsBackupPlansGetCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -3239,11 +5220,12 @@ type ProjectsLocationsGetCall struct { header_ http.Header } -// Get: Gets information about a location. +// Get: Gets details of a single BackupPlan. // -// - name: Resource name for the location. -func (r *ProjectsLocationsService) Get(name string) *ProjectsLocationsGetCall { - c := &ProjectsLocationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The resource name of the `BackupPlan` to retrieve. Format: +// `projects/{project}/locations/{location}/backupPlans/{backup_plan}`. +func (r *ProjectsLocationsBackupPlansService) Get(name string) *ProjectsLocationsBackupPlansGetCall { + c := &ProjectsLocationsBackupPlansGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } @@ -3251,7 +5233,7 @@ func (r *ProjectsLocationsService) Get(name string) *ProjectsLocationsGetCall { // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsGetCall { +func (c *ProjectsLocationsBackupPlansGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsBackupPlansGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -3259,27 +5241,27 @@ func (c *ProjectsLocationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocatio // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsGetCall { +func (c *ProjectsLocationsBackupPlansGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsBackupPlansGetCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsGetCall) Context(ctx context.Context) *ProjectsLocationsGetCall { +func (c *ProjectsLocationsBackupPlansGetCall) Context(ctx context.Context) *ProjectsLocationsBackupPlansGetCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsGetCall) Header() http.Header { +func (c *ProjectsLocationsBackupPlansGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsGetCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsBackupPlansGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) @@ -3300,12 +5282,12 @@ func (c *ProjectsLocationsGetCall) doRequest(alt string) (*http.Response, error) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "backupdr.projects.locations.get" call. +// Do executes the "backupdr.projects.locations.backupPlans.get" call. // Any non-2xx status code is an error. Response headers are in either -// *Location.ServerResponse.Header or (if a response was returned at all) in +// *BackupPlan.ServerResponse.Header or (if a response was returned at all) in // error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check // whether the returned error was because http.StatusNotModified was returned. -func (c *ProjectsLocationsGetCall) Do(opts ...googleapi.CallOption) (*Location, error) { +func (c *ProjectsLocationsBackupPlansGetCall) Do(opts ...googleapi.CallOption) (*BackupPlan, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -3324,7 +5306,7 @@ func (c *ProjectsLocationsGetCall) Do(opts ...googleapi.CallOption) (*Location, if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Location{ + ret := &BackupPlan{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -3337,44 +5319,58 @@ func (c *ProjectsLocationsGetCall) Do(opts ...googleapi.CallOption) (*Location, return ret, nil } -type ProjectsLocationsListCall struct { +type ProjectsLocationsBackupPlansListCall struct { s *Service - name string + parent string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } -// List: Lists information about the supported locations for this service. +// List: Lists BackupPlans in a given project and location. // -// - name: The resource that owns the locations collection, if applicable. -func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall { - c := &ProjectsLocationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name +// - parent: The project and location for which to retrieve `BackupPlans` +// information. Format: `projects/{project}/locations/{location}`. In Cloud +// BackupDR, locations map to GCP regions, for e.g. **us-central1**. To +// retrieve backup plans for all locations, use "-" for the `{location}` +// value. +func (r *ProjectsLocationsBackupPlansService) List(parent string) *ProjectsLocationsBackupPlansListCall { + c := &ProjectsLocationsBackupPlansListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent return c } -// Filter sets the optional parameter "filter": A filter to narrow down results -// to a preferred subset. The filtering language accepts strings like -// "displayName=tokyo", and is documented in more detail in AIP-160 -// (https://google.aip.dev/160). -func (c *ProjectsLocationsListCall) Filter(filter string) *ProjectsLocationsListCall { +// Filter sets the optional parameter "filter": Field match expression used to +// filter the results. +func (c *ProjectsLocationsBackupPlansListCall) Filter(filter string) *ProjectsLocationsBackupPlansListCall { c.urlParams_.Set("filter", filter) return c } +// OrderBy sets the optional parameter "orderBy": Field by which to sort the +// results. +func (c *ProjectsLocationsBackupPlansListCall) OrderBy(orderBy string) *ProjectsLocationsBackupPlansListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + // PageSize sets the optional parameter "pageSize": The maximum number of -// results to return. If not set, the service selects a default. -func (c *ProjectsLocationsListCall) PageSize(pageSize int64) *ProjectsLocationsListCall { +// `BackupPlans` to return in a single response. If not specified, a default +// value will be chosen by the service. Note that the response may include a +// partial list and a caller should only rely on the response's next_page_token +// to determine if there are more instances left to be queried. +func (c *ProjectsLocationsBackupPlansListCall) PageSize(pageSize int64) *ProjectsLocationsBackupPlansListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c } -// PageToken sets the optional parameter "pageToken": A page token received -// from the `next_page_token` field in the response. Send that page token to -// receive the subsequent page. -func (c *ProjectsLocationsListCall) PageToken(pageToken string) *ProjectsLocationsListCall { +// PageToken sets the optional parameter "pageToken": The value of +// next_page_token received from a previous `ListBackupPlans` call. Provide +// this to retrieve the subsequent page in a multi-page list of results. When +// paginating, all other parameters provided to `ListBackupPlans` must match +// the call that provided the page token. +func (c *ProjectsLocationsBackupPlansListCall) PageToken(pageToken string) *ProjectsLocationsBackupPlansListCall { c.urlParams_.Set("pageToken", pageToken) return c } @@ -3382,7 +5378,7 @@ func (c *ProjectsLocationsListCall) PageToken(pageToken string) *ProjectsLocatio // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsListCall { +func (c *ProjectsLocationsBackupPlansListCall) Fields(s ...googleapi.Field) *ProjectsLocationsBackupPlansListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -3390,27 +5386,27 @@ func (c *ProjectsLocationsListCall) Fields(s ...googleapi.Field) *ProjectsLocati // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *ProjectsLocationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsListCall { +func (c *ProjectsLocationsBackupPlansListCall) IfNoneMatch(entityTag string) *ProjectsLocationsBackupPlansListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsListCall) Context(ctx context.Context) *ProjectsLocationsListCall { +func (c *ProjectsLocationsBackupPlansListCall) Context(ctx context.Context) *ProjectsLocationsBackupPlansListCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *ProjectsLocationsListCall) Header() http.Header { +func (c *ProjectsLocationsBackupPlansListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsListCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsBackupPlansListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) @@ -3418,7 +5414,7 @@ func (c *ProjectsLocationsListCall) doRequest(alt string) (*http.Response, error var body io.Reader = nil c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}/locations") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/backupPlans") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, body) if err != nil { @@ -3426,18 +5422,18 @@ func (c *ProjectsLocationsListCall) doRequest(alt string) (*http.Response, error } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "parent": c.parent, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "backupdr.projects.locations.list" call. +// Do executes the "backupdr.projects.locations.backupPlans.list" call. // Any non-2xx status code is an error. Response headers are in either -// *ListLocationsResponse.ServerResponse.Header or (if a response was returned -// at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to -// check whether the returned error was because http.StatusNotModified was -// returned. -func (c *ProjectsLocationsListCall) Do(opts ...googleapi.CallOption) (*ListLocationsResponse, error) { +// *ListBackupPlansResponse.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 *ProjectsLocationsBackupPlansListCall) Do(opts ...googleapi.CallOption) (*ListBackupPlansResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -3456,7 +5452,7 @@ func (c *ProjectsLocationsListCall) Do(opts ...googleapi.CallOption) (*ListLocat if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &ListLocationsResponse{ + ret := &ListBackupPlansResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -3472,7 +5468,7 @@ func (c *ProjectsLocationsListCall) Do(opts ...googleapi.CallOption) (*ListLocat // Pages invokes f for each page of results. // A non-nil error returned from f will halt the iteration. // The provided context supersedes any context provided to the Context method. -func (c *ProjectsLocationsListCall) Pages(ctx context.Context, f func(*ListLocationsResponse) error) error { +func (c *ProjectsLocationsBackupPlansListCall) Pages(ctx context.Context, f func(*ListBackupPlansResponse) error) error { c.ctx_ = ctx defer c.PageToken(c.urlParams_.Get("pageToken")) for { @@ -5971,6 +7967,108 @@ func (c *ProjectsLocationsBackupVaultsDataSourcesBackupsPatchCall) Do(opts ...go return ret, nil } +type ProjectsLocationsBackupVaultsDataSourcesBackupsRestoreCall struct { + s *Service + name string + restorebackuprequest *RestoreBackupRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Restore: Restore from a Backup +// +// - name: The resource name of the Backup instance, in the format +// 'projects/*/locations/*/backupVaults/*/dataSources/*/backups/'. +func (r *ProjectsLocationsBackupVaultsDataSourcesBackupsService) Restore(name string, restorebackuprequest *RestoreBackupRequest) *ProjectsLocationsBackupVaultsDataSourcesBackupsRestoreCall { + c := &ProjectsLocationsBackupVaultsDataSourcesBackupsRestoreCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.restorebackuprequest = restorebackuprequest + 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 *ProjectsLocationsBackupVaultsDataSourcesBackupsRestoreCall) Fields(s ...googleapi.Field) *ProjectsLocationsBackupVaultsDataSourcesBackupsRestoreCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsBackupVaultsDataSourcesBackupsRestoreCall) Context(ctx context.Context) *ProjectsLocationsBackupVaultsDataSourcesBackupsRestoreCall { + 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 *ProjectsLocationsBackupVaultsDataSourcesBackupsRestoreCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBackupVaultsDataSourcesBackupsRestoreCall) 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.restorebackuprequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:restore") + 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 "backupdr.projects.locations.backupVaults.dataSources.backups.restore" 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 *ProjectsLocationsBackupVaultsDataSourcesBackupsRestoreCall) 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 ProjectsLocationsManagementServersCreateCall struct { s *Service parent string diff --git a/beyondcorp/v1/beyondcorp-api.json b/beyondcorp/v1/beyondcorp-api.json index 2d717a2d8db..0f86faa5e2f 100644 --- a/beyondcorp/v1/beyondcorp-api.json +++ b/beyondcorp/v1/beyondcorp-api.json @@ -1464,6 +1464,43 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "shouldThrottle": { + "description": "Calls the Bouncer method ShouldThrottle to check if a request should be throttled.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/appGateways/{appGatewaysId}:shouldThrottle", + "httpMethod": "GET", + "id": "beyondcorp.projects.locations.appGateways.shouldThrottle", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Name of the resource", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/appGateways/[^/]+$", + "required": true, + "type": "string" + }, + "port": { + "description": "Optional. The port that is being throttled", + "format": "int32", + "location": "query", + "type": "integer" + }, + "requestedAmount": { + "description": "Optional. The current throughput through the port (mbps)", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}:shouldThrottle", + "response": { + "$ref": "ShouldThrottleResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "testIamPermissions": { "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/appGateways/{appGatewaysId}:testIamPermissions", @@ -1804,7 +1841,7 @@ } } }, - "revision": "20240424", + "revision": "20240802", "rootUrl": "https://beyondcorp.googleapis.com/", "schemas": { "AllocatedConnection": { @@ -3410,6 +3447,17 @@ }, "type": "object" }, + "ShouldThrottleResponse": { + "description": "Response message for calling ShouldThrottle", + "id": "ShouldThrottleResponse", + "properties": { + "shouldThrottle": { + "description": "Whether the port should be throttled", + "type": "boolean" + } + }, + "type": "object" + }, "Tunnelv1ProtoTunnelerError": { "description": "TunnelerError is an error proto for errors returned by the connection manager.", "id": "Tunnelv1ProtoTunnelerError", diff --git a/beyondcorp/v1/beyondcorp-gen.go b/beyondcorp/v1/beyondcorp-gen.go index 8aec9baca27..94f86e737b7 100644 --- a/beyondcorp/v1/beyondcorp-gen.go +++ b/beyondcorp/v1/beyondcorp-gen.go @@ -2264,6 +2264,31 @@ func (s ListAppGatewaysResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ShouldThrottleResponse: Response message for calling ShouldThrottle +type ShouldThrottleResponse struct { + // ShouldThrottle: Whether the port should be throttled + ShouldThrottle bool `json:"shouldThrottle,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "ShouldThrottle") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ShouldThrottle") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ShouldThrottleResponse) MarshalJSON() ([]byte, error) { + type NoMethod ShouldThrottleResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Tunnelv1ProtoTunnelerError: TunnelerError is an error proto for errors // returned by the connection manager. type Tunnelv1ProtoTunnelerError struct { @@ -7245,6 +7270,128 @@ func (c *ProjectsLocationsAppGatewaysSetIamPolicyCall) Do(opts ...googleapi.Call return ret, nil } +type ProjectsLocationsAppGatewaysShouldThrottleCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// ShouldThrottle: Calls the Bouncer method ShouldThrottle to check if a +// request should be throttled. +// +// - name: Name of the resource. +func (r *ProjectsLocationsAppGatewaysService) ShouldThrottle(name string) *ProjectsLocationsAppGatewaysShouldThrottleCall { + c := &ProjectsLocationsAppGatewaysShouldThrottleCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Port sets the optional parameter "port": The port that is being throttled +func (c *ProjectsLocationsAppGatewaysShouldThrottleCall) Port(port int64) *ProjectsLocationsAppGatewaysShouldThrottleCall { + c.urlParams_.Set("port", fmt.Sprint(port)) + return c +} + +// RequestedAmount sets the optional parameter "requestedAmount": The current +// throughput through the port (mbps) +func (c *ProjectsLocationsAppGatewaysShouldThrottleCall) RequestedAmount(requestedAmount int64) *ProjectsLocationsAppGatewaysShouldThrottleCall { + c.urlParams_.Set("requestedAmount", fmt.Sprint(requestedAmount)) + 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 *ProjectsLocationsAppGatewaysShouldThrottleCall) Fields(s ...googleapi.Field) *ProjectsLocationsAppGatewaysShouldThrottleCall { + 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 *ProjectsLocationsAppGatewaysShouldThrottleCall) IfNoneMatch(entityTag string) *ProjectsLocationsAppGatewaysShouldThrottleCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsAppGatewaysShouldThrottleCall) Context(ctx context.Context) *ProjectsLocationsAppGatewaysShouldThrottleCall { + 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 *ProjectsLocationsAppGatewaysShouldThrottleCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsAppGatewaysShouldThrottleCall) 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}:shouldThrottle") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "beyondcorp.projects.locations.appGateways.shouldThrottle" call. +// Any non-2xx status code is an error. Response headers are in either +// *ShouldThrottleResponse.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 *ProjectsLocationsAppGatewaysShouldThrottleCall) Do(opts ...googleapi.CallOption) (*ShouldThrottleResponse, 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 := &ShouldThrottleResponse{ + 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 ProjectsLocationsAppGatewaysTestIamPermissionsCall struct { s *Service resource string diff --git a/cloudcontrolspartner/v1/cloudcontrolspartner-api.json b/cloudcontrolspartner/v1/cloudcontrolspartner-api.json index 74cf0d08539..650444a3e2e 100644 --- a/cloudcontrolspartner/v1/cloudcontrolspartner-api.json +++ b/cloudcontrolspartner/v1/cloudcontrolspartner-api.json @@ -484,7 +484,7 @@ } } }, - "revision": "20240717", + "revision": "20240731", "rootUrl": "https://cloudcontrolspartner.googleapis.com/", "schemas": { "AccessApprovalRequest": { @@ -598,8 +598,7 @@ "readOnly": true }, "displayName": { - "description": "Output only. The customer organization's display name. E.g. \"google.com\".", - "readOnly": true, + "description": "Optional. The customer organization's display name. E.g. \"Google\".", "type": "string" }, "isOnboarded": { @@ -1010,14 +1009,16 @@ "ACCESS_TRANSPARENCY_AND_EMERGENCY_ACCESS_LOGS", "ASSURED_WORKLOADS_MONITORING", "ACCESS_APPROVAL_REQUESTS", - "ASSURED_WORKLOADS_EKM_CONNECTION_STATUS" + "ASSURED_WORKLOADS_EKM_CONNECTION_STATUS", + "ACCESS_TRANSPARENCY_LOGS_SUPPORT_CASE_VIEWER" ], "enumDescriptions": [ "Unspecified partner permission", "Permission for Access Transparency and emergency logs", "Permission for Assured Workloads monitoring violations", "Permission for Access Approval requests", - "Permission for External Key Manager connection status" + "Permission for External Key Manager connection status", + "Permission for support case details for Access Transparency log entries" ], "type": "string" }, diff --git a/cloudcontrolspartner/v1/cloudcontrolspartner-gen.go b/cloudcontrolspartner/v1/cloudcontrolspartner-gen.go index 50cfad6eb20..8bde6530964 100644 --- a/cloudcontrolspartner/v1/cloudcontrolspartner-gen.go +++ b/cloudcontrolspartner/v1/cloudcontrolspartner-gen.go @@ -360,8 +360,8 @@ type Customer struct { // CustomerOnboardingState: Output only. Container for customer onboarding // steps CustomerOnboardingState *CustomerOnboardingState `json:"customerOnboardingState,omitempty"` - // DisplayName: Output only. The customer organization's display name. E.g. - // "google.com". + // DisplayName: Optional. The customer organization's display name. E.g. + // "Google". DisplayName string `json:"displayName,omitempty"` // IsOnboarded: Output only. Indicates whether a customer is fully onboarded IsOnboarded bool `json:"isOnboarded,omitempty"` @@ -821,6 +821,8 @@ type PartnerPermissions struct { // "ACCESS_APPROVAL_REQUESTS" - Permission for Access Approval requests // "ASSURED_WORKLOADS_EKM_CONNECTION_STATUS" - Permission for External Key // Manager connection status + // "ACCESS_TRANSPARENCY_LOGS_SUPPORT_CASE_VIEWER" - Permission for support + // case details for Access Transparency log entries PartnerPermissions []string `json:"partnerPermissions,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. diff --git a/cloudcontrolspartner/v1beta/cloudcontrolspartner-api.json b/cloudcontrolspartner/v1beta/cloudcontrolspartner-api.json index aab2955b8a0..8cb6223cdec 100644 --- a/cloudcontrolspartner/v1beta/cloudcontrolspartner-api.json +++ b/cloudcontrolspartner/v1beta/cloudcontrolspartner-api.json @@ -484,7 +484,7 @@ } } }, - "revision": "20240717", + "revision": "20240731", "rootUrl": "https://cloudcontrolspartner.googleapis.com/", "schemas": { "AccessApprovalRequest": { @@ -598,8 +598,7 @@ "readOnly": true }, "displayName": { - "description": "Output only. The customer organization's display name. E.g. \"google.com\".", - "readOnly": true, + "description": "Optional. The customer organization's display name. E.g. \"Google\".", "type": "string" }, "isOnboarded": { @@ -1010,14 +1009,16 @@ "ACCESS_TRANSPARENCY_AND_EMERGENCY_ACCESS_LOGS", "ASSURED_WORKLOADS_MONITORING", "ACCESS_APPROVAL_REQUESTS", - "ASSURED_WORKLOADS_EKM_CONNECTION_STATUS" + "ASSURED_WORKLOADS_EKM_CONNECTION_STATUS", + "ACCESS_TRANSPARENCY_LOGS_SUPPORT_CASE_VIEWER" ], "enumDescriptions": [ "Unspecified partner permission", "Permission for Access Transparency and emergency logs", "Permission for Assured Workloads monitoring violations", "Permission for Access Approval requests", - "Permission for External Key Manager connection status" + "Permission for External Key Manager connection status", + "Permission for support case details for Access Transparency log entries" ], "type": "string" }, diff --git a/cloudcontrolspartner/v1beta/cloudcontrolspartner-gen.go b/cloudcontrolspartner/v1beta/cloudcontrolspartner-gen.go index 8c984bd066b..57a3e92e1ea 100644 --- a/cloudcontrolspartner/v1beta/cloudcontrolspartner-gen.go +++ b/cloudcontrolspartner/v1beta/cloudcontrolspartner-gen.go @@ -360,8 +360,8 @@ type Customer struct { // CustomerOnboardingState: Output only. Container for customer onboarding // steps CustomerOnboardingState *CustomerOnboardingState `json:"customerOnboardingState,omitempty"` - // DisplayName: Output only. The customer organization's display name. E.g. - // "google.com". + // DisplayName: Optional. The customer organization's display name. E.g. + // "Google". DisplayName string `json:"displayName,omitempty"` // IsOnboarded: Output only. Indicates whether a customer is fully onboarded IsOnboarded bool `json:"isOnboarded,omitempty"` @@ -821,6 +821,8 @@ type PartnerPermissions struct { // "ACCESS_APPROVAL_REQUESTS" - Permission for Access Approval requests // "ASSURED_WORKLOADS_EKM_CONNECTION_STATUS" - Permission for External Key // Manager connection status + // "ACCESS_TRANSPARENCY_LOGS_SUPPORT_CASE_VIEWER" - Permission for support + // case details for Access Transparency log entries PartnerPermissions []string `json:"partnerPermissions,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. diff --git a/discoveryengine/v1/discoveryengine-api.json b/discoveryengine/v1/discoveryengine-api.json index 33ee40d7636..1ea9c272493 100644 --- a/discoveryengine/v1/discoveryengine-api.json +++ b/discoveryengine/v1/discoveryengine-api.json @@ -5851,7 +5851,7 @@ } } }, - "revision": "20240729", + "revision": "20240801", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -6298,12 +6298,14 @@ "enum": [ "TYPE_UNSPECIFIED", "ADVERSARIAL_QUERY", - "NON_ANSWER_SEEKING_QUERY" + "NON_ANSWER_SEEKING_QUERY", + "JAIL_BREAKING_QUERY" ], "enumDescriptions": [ "Unspecified query classification type.", "Adversarial query classification type.", - "Non-answer-seeking query classification type." + "Non-answer-seeking query classification type.", + "Jail-breaking query classification type." ], "type": "string" }, @@ -6585,12 +6587,14 @@ "enum": [ "TYPE_UNSPECIFIED", "ADVERSARIAL_QUERY", - "NON_ANSWER_SEEKING_QUERY" + "NON_ANSWER_SEEKING_QUERY", + "JAIL_BREAKING_QUERY" ], "enumDescriptions": [ "Unspecified query classification type.", "Adversarial query classification type.", - "Non-answer-seeking query classification type." + "Non-answer-seeking query classification type.", + "Jail-breaking query classification type." ], "type": "string" } @@ -8178,6 +8182,11 @@ "description": "The Document resource ID.", "type": "string" }, + "joined": { + "description": "Output only. Whether the referenced Document can be found in the data store.", + "readOnly": true, + "type": "boolean" + }, "name": { "description": "The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`", "type": "string" @@ -8221,7 +8230,7 @@ "additionalProperties": { "$ref": "GoogleCloudDiscoveryengineV1DocumentProcessingConfigParsingConfig" }, - "description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported.", + "description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.", "type": "object" } }, @@ -8575,6 +8584,13 @@ "gcsStagingDir": { "description": "Intermediate Cloud Storage directory used for the import with a length limit of 2,000 characters. Can be specified if one wants to have the FhirStore export to a specific Cloud Storage directory.", "type": "string" + }, + "resourceTypes": { + "description": "The FHIR resource types to import. The resource types should be a subset of all [supported FHIR resource types](https://cloud.google.com/generative-ai-app-builder/docs/fhir-schema-reference#resource-level-specification). Default to all supported FHIR resource types if empty.", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" @@ -11271,12 +11287,14 @@ "enum": [ "TYPE_UNSPECIFIED", "ADVERSARIAL_QUERY", - "NON_ANSWER_SEEKING_QUERY" + "NON_ANSWER_SEEKING_QUERY", + "JAIL_BREAKING_QUERY" ], "enumDescriptions": [ "Unspecified query classification type.", "Adversarial query classification type.", - "Non-answer-seeking query classification type." + "Non-answer-seeking query classification type.", + "Jail-breaking query classification type." ], "type": "string" } @@ -12165,7 +12183,7 @@ "additionalProperties": { "$ref": "GoogleCloudDiscoveryengineV1alphaDocumentProcessingConfigParsingConfig" }, - "description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported.", + "description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.", "type": "object" } }, @@ -12689,34 +12707,6 @@ }, "type": "object" }, - "GoogleCloudDiscoveryengineV1alphaExportUserEventsMetadata": { - "description": "Metadata related to the progress of the Export operation. This is returned by the google.longrunning.Operation.metadata field.", - "id": "GoogleCloudDiscoveryengineV1alphaExportUserEventsMetadata", - "properties": { - "createTime": { - "description": "Operation create time.", - "format": "google-datetime", - "type": "string" - }, - "updateTime": { - "description": "Operation last update time. If the operation is done, this is also the finish time.", - "format": "google-datetime", - "type": "string" - } - }, - "type": "object" - }, - "GoogleCloudDiscoveryengineV1alphaExportUserEventsResponse": { - "description": "Response of the ExportUserEventsRequest. If the long running operation was successful, then this message is returned by the google.longrunning.Operations.response field.", - "id": "GoogleCloudDiscoveryengineV1alphaExportUserEventsResponse", - "properties": { - "status": { - "$ref": "GoogleRpcStatus", - "description": "The status of the export operation." - } - }, - "type": "object" - }, "GoogleCloudDiscoveryengineV1alphaFieldConfig": { "description": "Configurations for fields of a schema. For example, configuring a field is indexable, or searchable.", "id": "GoogleCloudDiscoveryengineV1alphaFieldConfig", @@ -12728,12 +12718,14 @@ "ADVANCED_SITE_SEARCH_DATA_SOURCE_UNSPECIFIED", "METATAGS", "PAGEMAP", + "URI_PATTERN_MAPPING", "SCHEMA_ORG" ], "enumDescriptions": [ "Value used when unset.", "Retrieve value from meta tag.", "Retrieve value from page map.", + "Retrieve value from the attributes set by SiteSearchEngineService.SetUriPatternDocumentData API.", "Retrieve value from schema.org data." ], "type": "string" @@ -15248,7 +15240,7 @@ "additionalProperties": { "$ref": "GoogleCloudDiscoveryengineV1betaDocumentProcessingConfigParsingConfig" }, - "description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported.", + "description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.", "type": "object" } }, diff --git a/discoveryengine/v1/discoveryengine-gen.go b/discoveryengine/v1/discoveryengine-gen.go index 683eb107849..115e9f2e142 100644 --- a/discoveryengine/v1/discoveryengine-gen.go +++ b/discoveryengine/v1/discoveryengine-gen.go @@ -1449,6 +1449,7 @@ type GoogleCloudDiscoveryengineV1AnswerQueryRequestQueryUnderstandingSpecQueryCl // "TYPE_UNSPECIFIED" - Unspecified query classification type. // "ADVERSARIAL_QUERY" - Adversarial query classification type. // "NON_ANSWER_SEEKING_QUERY" - Non-answer-seeking query classification type. + // "JAIL_BREAKING_QUERY" - Jail-breaking query classification type. Types []string `json:"types,omitempty"` // ForceSendFields is a list of field names (e.g. "Types") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -1879,6 +1880,7 @@ type GoogleCloudDiscoveryengineV1AnswerQueryUnderstandingInfoQueryClassification // "TYPE_UNSPECIFIED" - Unspecified query classification type. // "ADVERSARIAL_QUERY" - Adversarial query classification type. // "NON_ANSWER_SEEKING_QUERY" - Non-answer-seeking query classification type. + // "JAIL_BREAKING_QUERY" - Jail-breaking query classification type. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Positive") to // unconditionally include in API requests. By default, fields with empty or @@ -4101,6 +4103,9 @@ func (s GoogleCloudDiscoveryengineV1DocumentContent) MarshalJSON() ([]byte, erro type GoogleCloudDiscoveryengineV1DocumentInfo struct { // Id: The Document resource ID. Id string `json:"id,omitempty"` + // Joined: Output only. Whether the referenced Document can be found in the + // data store. + Joined bool `json:"joined,omitempty"` // Name: The Document resource full name, of the form: // `projects/{project_id}/locations/{location}/collections/{collection_id}/dataS // tores/{data_store_id}/branches/{branch_id}/documents/{document_id}` @@ -4156,7 +4161,8 @@ type GoogleCloudDiscoveryengineV1DocumentProcessingConfig struct { // digital parsing and layout parsing are supported. * `docx`: Override parsing // config for DOCX files, only digital parsing and layout parsing are // supported. * `pptx`: Override parsing config for PPTX files, only digital - // parsing and layout parsing are supported. + // parsing and layout parsing are supported. * `xlsx`: Override parsing config + // for XLSX files, only digital parsing and layout parsing are supported. ParsingConfigOverrides map[string]GoogleCloudDiscoveryengineV1DocumentProcessingConfigParsingConfig `json:"parsingConfigOverrides,omitempty"` // ForceSendFields is a list of field names (e.g. "ChunkingConfig") to // unconditionally include in API requests. By default, fields with empty or @@ -4650,6 +4656,11 @@ type GoogleCloudDiscoveryengineV1FhirStoreSource struct { // a length limit of 2,000 characters. Can be specified if one wants to have // the FhirStore export to a specific Cloud Storage directory. GcsStagingDir string `json:"gcsStagingDir,omitempty"` + // ResourceTypes: The FHIR resource types to import. The resource types should + // be a subset of all supported FHIR resource types + // (https://cloud.google.com/generative-ai-app-builder/docs/fhir-schema-reference#resource-level-specification). + // Default to all supported FHIR resource types if empty. + ResourceTypes []string `json:"resourceTypes,omitempty"` // ForceSendFields is a list of field names (e.g. "FhirStore") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -8689,6 +8700,7 @@ type GoogleCloudDiscoveryengineV1alphaAnswerQueryUnderstandingInfoQueryClassific // "TYPE_UNSPECIFIED" - Unspecified query classification type. // "ADVERSARIAL_QUERY" - Adversarial query classification type. // "NON_ANSWER_SEEKING_QUERY" - Non-answer-seeking query classification type. + // "JAIL_BREAKING_QUERY" - Jail-breaking query classification type. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Positive") to // unconditionally include in API requests. By default, fields with empty or @@ -9894,7 +9906,8 @@ type GoogleCloudDiscoveryengineV1alphaDocumentProcessingConfig struct { // digital parsing and layout parsing are supported. * `docx`: Override parsing // config for DOCX files, only digital parsing and layout parsing are // supported. * `pptx`: Override parsing config for PPTX files, only digital - // parsing and layout parsing are supported. + // parsing and layout parsing are supported. * `xlsx`: Override parsing config + // for XLSX files, only digital parsing and layout parsing are supported. ParsingConfigOverrides map[string]GoogleCloudDiscoveryengineV1alphaDocumentProcessingConfigParsingConfig `json:"parsingConfigOverrides,omitempty"` // ForceSendFields is a list of field names (e.g. "ChunkingConfig") to // unconditionally include in API requests. By default, fields with empty or @@ -10628,58 +10641,6 @@ func (s GoogleCloudDiscoveryengineV1alphaEvaluationEvaluationSpecQuerySetSpec) M return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDiscoveryengineV1alphaExportUserEventsMetadata: Metadata related -// to the progress of the Export operation. This is returned by the -// google.longrunning.Operation.metadata field. -type GoogleCloudDiscoveryengineV1alphaExportUserEventsMetadata struct { - // CreateTime: Operation create time. - CreateTime string `json:"createTime,omitempty"` - // UpdateTime: Operation last update time. If the operation is done, this is - // also the finish time. - UpdateTime string `json:"updateTime,omitempty"` - // ForceSendFields is a list of field names (e.g. "CreateTime") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "CreateTime") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s GoogleCloudDiscoveryengineV1alphaExportUserEventsMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDiscoveryengineV1alphaExportUserEventsMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDiscoveryengineV1alphaExportUserEventsResponse: Response of the -// ExportUserEventsRequest. If the long running operation was successful, then -// this message is returned by the google.longrunning.Operations.response -// field. -type GoogleCloudDiscoveryengineV1alphaExportUserEventsResponse struct { - // Status: The status of the export operation. - Status *GoogleRpcStatus `json:"status,omitempty"` - // ForceSendFields is a list of field names (e.g. "Status") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Status") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s GoogleCloudDiscoveryengineV1alphaExportUserEventsResponse) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDiscoveryengineV1alphaExportUserEventsResponse - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDiscoveryengineV1alphaFieldConfig: Configurations for fields of a // schema. For example, configuring a field is indexable, or searchable. type GoogleCloudDiscoveryengineV1alphaFieldConfig struct { @@ -10693,6 +10654,8 @@ type GoogleCloudDiscoveryengineV1alphaFieldConfig struct { // "ADVANCED_SITE_SEARCH_DATA_SOURCE_UNSPECIFIED" - Value used when unset. // "METATAGS" - Retrieve value from meta tag. // "PAGEMAP" - Retrieve value from page map. + // "URI_PATTERN_MAPPING" - Retrieve value from the attributes set by + // SiteSearchEngineService.SetUriPatternDocumentData API. // "SCHEMA_ORG" - Retrieve value from schema.org data. AdvancedSiteSearchDataSources []string `json:"advancedSiteSearchDataSources,omitempty"` // CompletableOption: If completable_option is COMPLETABLE_ENABLED, field @@ -14241,7 +14204,8 @@ type GoogleCloudDiscoveryengineV1betaDocumentProcessingConfig struct { // digital parsing and layout parsing are supported. * `docx`: Override parsing // config for DOCX files, only digital parsing and layout parsing are // supported. * `pptx`: Override parsing config for PPTX files, only digital - // parsing and layout parsing are supported. + // parsing and layout parsing are supported. * `xlsx`: Override parsing config + // for XLSX files, only digital parsing and layout parsing are supported. ParsingConfigOverrides map[string]GoogleCloudDiscoveryengineV1betaDocumentProcessingConfigParsingConfig `json:"parsingConfigOverrides,omitempty"` // ForceSendFields is a list of field names (e.g. "ChunkingConfig") to // unconditionally include in API requests. By default, fields with empty or diff --git a/discoveryengine/v1alpha/discoveryengine-api.json b/discoveryengine/v1alpha/discoveryengine-api.json index cac602c4aee..b1d715facca 100644 --- a/discoveryengine/v1alpha/discoveryengine-api.json +++ b/discoveryengine/v1alpha/discoveryengine-api.json @@ -7365,7 +7365,7 @@ } } }, - "revision": "20240729", + "revision": "20240801", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiDistribution": { @@ -8191,7 +8191,7 @@ "additionalProperties": { "$ref": "GoogleCloudDiscoveryengineV1DocumentProcessingConfigParsingConfig" }, - "description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported.", + "description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.", "type": "object" } }, @@ -9381,12 +9381,14 @@ "enum": [ "TYPE_UNSPECIFIED", "ADVERSARIAL_QUERY", - "NON_ANSWER_SEEKING_QUERY" + "NON_ANSWER_SEEKING_QUERY", + "JAIL_BREAKING_QUERY" ], "enumDescriptions": [ "Unspecified query classification type.", "Adversarial query classification type.", - "Non-answer-seeking query classification type." + "Non-answer-seeking query classification type.", + "Jail-breaking query classification type." ], "type": "string" }, @@ -9672,12 +9674,14 @@ "enum": [ "TYPE_UNSPECIFIED", "ADVERSARIAL_QUERY", - "NON_ANSWER_SEEKING_QUERY" + "NON_ANSWER_SEEKING_QUERY", + "JAIL_BREAKING_QUERY" ], "enumDescriptions": [ "Unspecified query classification type.", "Adversarial query classification type.", - "Non-answer-seeking query classification type." + "Non-answer-seeking query classification type.", + "Jail-breaking query classification type." ], "type": "string" } @@ -11488,6 +11492,11 @@ "description": "The Document resource ID.", "type": "string" }, + "joined": { + "description": "Output only. Whether the referenced Document can be found in the data store.", + "readOnly": true, + "type": "boolean" + }, "name": { "description": "The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`", "type": "string" @@ -11531,7 +11540,7 @@ "additionalProperties": { "$ref": "GoogleCloudDiscoveryengineV1alphaDocumentProcessingConfigParsingConfig" }, - "description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported.", + "description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.", "type": "object" } }, @@ -12150,34 +12159,6 @@ }, "type": "object" }, - "GoogleCloudDiscoveryengineV1alphaExportUserEventsMetadata": { - "description": "Metadata related to the progress of the Export operation. This is returned by the google.longrunning.Operation.metadata field.", - "id": "GoogleCloudDiscoveryengineV1alphaExportUserEventsMetadata", - "properties": { - "createTime": { - "description": "Operation create time.", - "format": "google-datetime", - "type": "string" - }, - "updateTime": { - "description": "Operation last update time. If the operation is done, this is also the finish time.", - "format": "google-datetime", - "type": "string" - } - }, - "type": "object" - }, - "GoogleCloudDiscoveryengineV1alphaExportUserEventsResponse": { - "description": "Response of the ExportUserEventsRequest. If the long running operation was successful, then this message is returned by the google.longrunning.Operations.response field.", - "id": "GoogleCloudDiscoveryengineV1alphaExportUserEventsResponse", - "properties": { - "status": { - "$ref": "GoogleRpcStatus", - "description": "The status of the export operation." - } - }, - "type": "object" - }, "GoogleCloudDiscoveryengineV1alphaFactChunk": { "description": "Fact Chunk.", "id": "GoogleCloudDiscoveryengineV1alphaFactChunk", @@ -12239,6 +12220,13 @@ "gcsStagingDir": { "description": "Intermediate Cloud Storage directory used for the import with a length limit of 2,000 characters. Can be specified if one wants to have the FhirStore export to a specific Cloud Storage directory.", "type": "string" + }, + "resourceTypes": { + "description": "The FHIR resource types to import. The resource types should be a subset of all [supported FHIR resource types](https://cloud.google.com/generative-ai-app-builder/docs/fhir-schema-reference#resource-level-specification). Default to all supported FHIR resource types if empty.", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" @@ -12254,12 +12242,14 @@ "ADVANCED_SITE_SEARCH_DATA_SOURCE_UNSPECIFIED", "METATAGS", "PAGEMAP", + "URI_PATTERN_MAPPING", "SCHEMA_ORG" ], "enumDescriptions": [ "Value used when unset.", "Retrieve value from meta tag.", "Retrieve value from page map.", + "Retrieve value from the attributes set by SiteSearchEngineService.SetUriPatternDocumentData API.", "Retrieve value from schema.org data." ], "type": "string" @@ -15400,6 +15390,16 @@ "description": "The name of the geolocation field as defined in the schema.", "type": "string" }, + "latitude": { + "description": "The latitude of the geolocation inferred from the input query.", + "format": "double", + "type": "number" + }, + "longitude": { + "description": "The longitude of the geolocation inferred from the input query.", + "format": "double", + "type": "number" + }, "radiusInMeters": { "description": "The radius in meters around the address. The record is returned if the location of the geolocation field is within the radius.", "format": "float", @@ -17102,7 +17102,7 @@ "additionalProperties": { "$ref": "GoogleCloudDiscoveryengineV1betaDocumentProcessingConfigParsingConfig" }, - "description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported.", + "description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.", "type": "object" } }, diff --git a/discoveryengine/v1alpha/discoveryengine-gen.go b/discoveryengine/v1alpha/discoveryengine-gen.go index 901514c05cb..911b0337829 100644 --- a/discoveryengine/v1alpha/discoveryengine-gen.go +++ b/discoveryengine/v1alpha/discoveryengine-gen.go @@ -2267,7 +2267,8 @@ type GoogleCloudDiscoveryengineV1DocumentProcessingConfig struct { // digital parsing and layout parsing are supported. * `docx`: Override parsing // config for DOCX files, only digital parsing and layout parsing are // supported. * `pptx`: Override parsing config for PPTX files, only digital - // parsing and layout parsing are supported. + // parsing and layout parsing are supported. * `xlsx`: Override parsing config + // for XLSX files, only digital parsing and layout parsing are supported. ParsingConfigOverrides map[string]GoogleCloudDiscoveryengineV1DocumentProcessingConfigParsingConfig `json:"parsingConfigOverrides,omitempty"` // ForceSendFields is a list of field names (e.g. "ChunkingConfig") to // unconditionally include in API requests. By default, fields with empty or @@ -3822,6 +3823,7 @@ type GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestQueryUnderstandingSpecQu // "TYPE_UNSPECIFIED" - Unspecified query classification type. // "ADVERSARIAL_QUERY" - Adversarial query classification type. // "NON_ANSWER_SEEKING_QUERY" - Non-answer-seeking query classification type. + // "JAIL_BREAKING_QUERY" - Jail-breaking query classification type. Types []string `json:"types,omitempty"` // ForceSendFields is a list of field names (e.g. "Types") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -4256,6 +4258,7 @@ type GoogleCloudDiscoveryengineV1alphaAnswerQueryUnderstandingInfoQueryClassific // "TYPE_UNSPECIFIED" - Unspecified query classification type. // "ADVERSARIAL_QUERY" - Adversarial query classification type. // "NON_ANSWER_SEEKING_QUERY" - Non-answer-seeking query classification type. + // "JAIL_BREAKING_QUERY" - Jail-breaking query classification type. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Positive") to // unconditionally include in API requests. By default, fields with empty or @@ -6752,6 +6755,9 @@ func (s GoogleCloudDiscoveryengineV1alphaDocumentContent) MarshalJSON() ([]byte, type GoogleCloudDiscoveryengineV1alphaDocumentInfo struct { // Id: The Document resource ID. Id string `json:"id,omitempty"` + // Joined: Output only. Whether the referenced Document can be found in the + // data store. + Joined bool `json:"joined,omitempty"` // Name: The Document resource full name, of the form: // `projects/{project_id}/locations/{location}/collections/{collection_id}/dataS // tores/{data_store_id}/branches/{branch_id}/documents/{document_id}` @@ -6807,7 +6813,8 @@ type GoogleCloudDiscoveryengineV1alphaDocumentProcessingConfig struct { // digital parsing and layout parsing are supported. * `docx`: Override parsing // config for DOCX files, only digital parsing and layout parsing are // supported. * `pptx`: Override parsing config for PPTX files, only digital - // parsing and layout parsing are supported. + // parsing and layout parsing are supported. * `xlsx`: Override parsing config + // for XLSX files, only digital parsing and layout parsing are supported. ParsingConfigOverrides map[string]GoogleCloudDiscoveryengineV1alphaDocumentProcessingConfigParsingConfig `json:"parsingConfigOverrides,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -7723,58 +7730,6 @@ func (s GoogleCloudDiscoveryengineV1alphaEvaluationEvaluationSpecQuerySetSpec) M return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDiscoveryengineV1alphaExportUserEventsMetadata: Metadata related -// to the progress of the Export operation. This is returned by the -// google.longrunning.Operation.metadata field. -type GoogleCloudDiscoveryengineV1alphaExportUserEventsMetadata struct { - // CreateTime: Operation create time. - CreateTime string `json:"createTime,omitempty"` - // UpdateTime: Operation last update time. If the operation is done, this is - // also the finish time. - UpdateTime string `json:"updateTime,omitempty"` - // ForceSendFields is a list of field names (e.g. "CreateTime") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "CreateTime") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s GoogleCloudDiscoveryengineV1alphaExportUserEventsMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDiscoveryengineV1alphaExportUserEventsMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDiscoveryengineV1alphaExportUserEventsResponse: Response of the -// ExportUserEventsRequest. If the long running operation was successful, then -// this message is returned by the google.longrunning.Operations.response -// field. -type GoogleCloudDiscoveryengineV1alphaExportUserEventsResponse struct { - // Status: The status of the export operation. - Status *GoogleRpcStatus `json:"status,omitempty"` - // ForceSendFields is a list of field names (e.g. "Status") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Status") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s GoogleCloudDiscoveryengineV1alphaExportUserEventsResponse) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDiscoveryengineV1alphaExportUserEventsResponse - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDiscoveryengineV1alphaFactChunk: Fact Chunk. type GoogleCloudDiscoveryengineV1alphaFactChunk struct { // ChunkText: Text content of the fact chunk. Can be at most 10K characters @@ -7851,6 +7806,11 @@ type GoogleCloudDiscoveryengineV1alphaFhirStoreSource struct { // a length limit of 2,000 characters. Can be specified if one wants to have // the FhirStore export to a specific Cloud Storage directory. GcsStagingDir string `json:"gcsStagingDir,omitempty"` + // ResourceTypes: The FHIR resource types to import. The resource types should + // be a subset of all supported FHIR resource types + // (https://cloud.google.com/generative-ai-app-builder/docs/fhir-schema-reference#resource-level-specification). + // Default to all supported FHIR resource types if empty. + ResourceTypes []string `json:"resourceTypes,omitempty"` // ForceSendFields is a list of field names (e.g. "FhirStore") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -7882,6 +7842,8 @@ type GoogleCloudDiscoveryengineV1alphaFieldConfig struct { // "ADVANCED_SITE_SEARCH_DATA_SOURCE_UNSPECIFIED" - Value used when unset. // "METATAGS" - Retrieve value from meta tag. // "PAGEMAP" - Retrieve value from page map. + // "URI_PATTERN_MAPPING" - Retrieve value from the attributes set by + // SiteSearchEngineService.SetUriPatternDocumentData API. // "SCHEMA_ORG" - Retrieve value from schema.org data. AdvancedSiteSearchDataSources []string `json:"advancedSiteSearchDataSources,omitempty"` // CompletableOption: If completable_option is COMPLETABLE_ENABLED, field @@ -12582,6 +12544,10 @@ type GoogleCloudDiscoveryengineV1alphaSearchResponseNaturalLanguageQueryUndersta Address string `json:"address,omitempty"` // FieldName: The name of the geolocation field as defined in the schema. FieldName string `json:"fieldName,omitempty"` + // Latitude: The latitude of the geolocation inferred from the input query. + Latitude float64 `json:"latitude,omitempty"` + // Longitude: The longitude of the geolocation inferred from the input query. + Longitude float64 `json:"longitude,omitempty"` // RadiusInMeters: The radius in meters around the address. The record is // returned if the location of the geolocation field is within the radius. RadiusInMeters float64 `json:"radiusInMeters,omitempty"` @@ -12606,6 +12572,8 @@ func (s GoogleCloudDiscoveryengineV1alphaSearchResponseNaturalLanguageQueryUnder func (s *GoogleCloudDiscoveryengineV1alphaSearchResponseNaturalLanguageQueryUnderstandingInfoStructuredExtractedFilterGeolocationConstraint) UnmarshalJSON(data []byte) error { type NoMethod GoogleCloudDiscoveryengineV1alphaSearchResponseNaturalLanguageQueryUnderstandingInfoStructuredExtractedFilterGeolocationConstraint var s1 struct { + Latitude gensupport.JSONFloat64 `json:"latitude"` + Longitude gensupport.JSONFloat64 `json:"longitude"` RadiusInMeters gensupport.JSONFloat64 `json:"radiusInMeters"` *NoMethod } @@ -12613,6 +12581,8 @@ func (s *GoogleCloudDiscoveryengineV1alphaSearchResponseNaturalLanguageQueryUnde if err := json.Unmarshal(data, &s1); err != nil { return err } + s.Latitude = float64(s1.Latitude) + s.Longitude = float64(s1.Longitude) s.RadiusInMeters = float64(s1.RadiusInMeters) return nil } @@ -14953,7 +14923,8 @@ type GoogleCloudDiscoveryengineV1betaDocumentProcessingConfig struct { // digital parsing and layout parsing are supported. * `docx`: Override parsing // config for DOCX files, only digital parsing and layout parsing are // supported. * `pptx`: Override parsing config for PPTX files, only digital - // parsing and layout parsing are supported. + // parsing and layout parsing are supported. * `xlsx`: Override parsing config + // for XLSX files, only digital parsing and layout parsing are supported. ParsingConfigOverrides map[string]GoogleCloudDiscoveryengineV1betaDocumentProcessingConfigParsingConfig `json:"parsingConfigOverrides,omitempty"` // ForceSendFields is a list of field names (e.g. "ChunkingConfig") to // unconditionally include in API requests. By default, fields with empty or diff --git a/discoveryengine/v1beta/discoveryengine-api.json b/discoveryengine/v1beta/discoveryengine-api.json index e1df27d77f8..31200a9968d 100644 --- a/discoveryengine/v1beta/discoveryengine-api.json +++ b/discoveryengine/v1beta/discoveryengine-api.json @@ -6708,7 +6708,7 @@ } } }, - "revision": "20240729", + "revision": "20240801", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -7348,7 +7348,7 @@ "additionalProperties": { "$ref": "GoogleCloudDiscoveryengineV1DocumentProcessingConfigParsingConfig" }, - "description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported.", + "description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.", "type": "object" } }, @@ -8402,12 +8402,14 @@ "enum": [ "TYPE_UNSPECIFIED", "ADVERSARIAL_QUERY", - "NON_ANSWER_SEEKING_QUERY" + "NON_ANSWER_SEEKING_QUERY", + "JAIL_BREAKING_QUERY" ], "enumDescriptions": [ "Unspecified query classification type.", "Adversarial query classification type.", - "Non-answer-seeking query classification type." + "Non-answer-seeking query classification type.", + "Jail-breaking query classification type." ], "type": "string" } @@ -9296,7 +9298,7 @@ "additionalProperties": { "$ref": "GoogleCloudDiscoveryengineV1alphaDocumentProcessingConfigParsingConfig" }, - "description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported.", + "description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.", "type": "object" } }, @@ -9820,34 +9822,6 @@ }, "type": "object" }, - "GoogleCloudDiscoveryengineV1alphaExportUserEventsMetadata": { - "description": "Metadata related to the progress of the Export operation. This is returned by the google.longrunning.Operation.metadata field.", - "id": "GoogleCloudDiscoveryengineV1alphaExportUserEventsMetadata", - "properties": { - "createTime": { - "description": "Operation create time.", - "format": "google-datetime", - "type": "string" - }, - "updateTime": { - "description": "Operation last update time. If the operation is done, this is also the finish time.", - "format": "google-datetime", - "type": "string" - } - }, - "type": "object" - }, - "GoogleCloudDiscoveryengineV1alphaExportUserEventsResponse": { - "description": "Response of the ExportUserEventsRequest. If the long running operation was successful, then this message is returned by the google.longrunning.Operations.response field.", - "id": "GoogleCloudDiscoveryengineV1alphaExportUserEventsResponse", - "properties": { - "status": { - "$ref": "GoogleRpcStatus", - "description": "The status of the export operation." - } - }, - "type": "object" - }, "GoogleCloudDiscoveryengineV1alphaFieldConfig": { "description": "Configurations for fields of a schema. For example, configuring a field is indexable, or searchable.", "id": "GoogleCloudDiscoveryengineV1alphaFieldConfig", @@ -9859,12 +9833,14 @@ "ADVANCED_SITE_SEARCH_DATA_SOURCE_UNSPECIFIED", "METATAGS", "PAGEMAP", + "URI_PATTERN_MAPPING", "SCHEMA_ORG" ], "enumDescriptions": [ "Value used when unset.", "Retrieve value from meta tag.", "Retrieve value from page map.", + "Retrieve value from the attributes set by SiteSearchEngineService.SetUriPatternDocumentData API.", "Retrieve value from schema.org data." ], "type": "string" @@ -12115,12 +12091,14 @@ "enum": [ "TYPE_UNSPECIFIED", "ADVERSARIAL_QUERY", - "NON_ANSWER_SEEKING_QUERY" + "NON_ANSWER_SEEKING_QUERY", + "JAIL_BREAKING_QUERY" ], "enumDescriptions": [ "Unspecified query classification type.", "Adversarial query classification type.", - "Non-answer-seeking query classification type." + "Non-answer-seeking query classification type.", + "Jail-breaking query classification type." ], "type": "string" }, @@ -12402,12 +12380,14 @@ "enum": [ "TYPE_UNSPECIFIED", "ADVERSARIAL_QUERY", - "NON_ANSWER_SEEKING_QUERY" + "NON_ANSWER_SEEKING_QUERY", + "JAIL_BREAKING_QUERY" ], "enumDescriptions": [ "Unspecified query classification type.", "Adversarial query classification type.", - "Non-answer-seeking query classification type." + "Non-answer-seeking query classification type.", + "Jail-breaking query classification type." ], "type": "string" } @@ -14073,6 +14053,11 @@ "description": "The Document resource ID.", "type": "string" }, + "joined": { + "description": "Output only. Whether the referenced Document can be found in the data store.", + "readOnly": true, + "type": "boolean" + }, "name": { "description": "The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`", "type": "string" @@ -14116,7 +14101,7 @@ "additionalProperties": { "$ref": "GoogleCloudDiscoveryengineV1betaDocumentProcessingConfigParsingConfig" }, - "description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported.", + "description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.", "type": "object" } }, @@ -14586,6 +14571,13 @@ "gcsStagingDir": { "description": "Intermediate Cloud Storage directory used for the import with a length limit of 2,000 characters. Can be specified if one wants to have the FhirStore export to a specific Cloud Storage directory.", "type": "string" + }, + "resourceTypes": { + "description": "The FHIR resource types to import. The resource types should be a subset of all [supported FHIR resource types](https://cloud.google.com/generative-ai-app-builder/docs/fhir-schema-reference#resource-level-specification). Default to all supported FHIR resource types if empty.", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" @@ -17120,6 +17112,16 @@ "description": "The name of the geolocation field as defined in the schema.", "type": "string" }, + "latitude": { + "description": "The latitude of the geolocation inferred from the input query.", + "format": "double", + "type": "number" + }, + "longitude": { + "description": "The longitude of the geolocation inferred from the input query.", + "format": "double", + "type": "number" + }, "radiusInMeters": { "description": "The radius in meters around the address. The record is returned if the location of the geolocation field is within the radius.", "format": "float", diff --git a/discoveryengine/v1beta/discoveryengine-gen.go b/discoveryengine/v1beta/discoveryengine-gen.go index 346065e4e53..2e08a729962 100644 --- a/discoveryengine/v1beta/discoveryengine-gen.go +++ b/discoveryengine/v1beta/discoveryengine-gen.go @@ -1818,7 +1818,8 @@ type GoogleCloudDiscoveryengineV1DocumentProcessingConfig struct { // digital parsing and layout parsing are supported. * `docx`: Override parsing // config for DOCX files, only digital parsing and layout parsing are // supported. * `pptx`: Override parsing config for PPTX files, only digital - // parsing and layout parsing are supported. + // parsing and layout parsing are supported. * `xlsx`: Override parsing config + // for XLSX files, only digital parsing and layout parsing are supported. ParsingConfigOverrides map[string]GoogleCloudDiscoveryengineV1DocumentProcessingConfigParsingConfig `json:"parsingConfigOverrides,omitempty"` // ForceSendFields is a list of field names (e.g. "ChunkingConfig") to // unconditionally include in API requests. By default, fields with empty or @@ -3159,6 +3160,7 @@ type GoogleCloudDiscoveryengineV1alphaAnswerQueryUnderstandingInfoQueryClassific // "TYPE_UNSPECIFIED" - Unspecified query classification type. // "ADVERSARIAL_QUERY" - Adversarial query classification type. // "NON_ANSWER_SEEKING_QUERY" - Non-answer-seeking query classification type. + // "JAIL_BREAKING_QUERY" - Jail-breaking query classification type. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Positive") to // unconditionally include in API requests. By default, fields with empty or @@ -4364,7 +4366,8 @@ type GoogleCloudDiscoveryengineV1alphaDocumentProcessingConfig struct { // digital parsing and layout parsing are supported. * `docx`: Override parsing // config for DOCX files, only digital parsing and layout parsing are // supported. * `pptx`: Override parsing config for PPTX files, only digital - // parsing and layout parsing are supported. + // parsing and layout parsing are supported. * `xlsx`: Override parsing config + // for XLSX files, only digital parsing and layout parsing are supported. ParsingConfigOverrides map[string]GoogleCloudDiscoveryengineV1alphaDocumentProcessingConfigParsingConfig `json:"parsingConfigOverrides,omitempty"` // ForceSendFields is a list of field names (e.g. "ChunkingConfig") to // unconditionally include in API requests. By default, fields with empty or @@ -5098,58 +5101,6 @@ func (s GoogleCloudDiscoveryengineV1alphaEvaluationEvaluationSpecQuerySetSpec) M return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDiscoveryengineV1alphaExportUserEventsMetadata: Metadata related -// to the progress of the Export operation. This is returned by the -// google.longrunning.Operation.metadata field. -type GoogleCloudDiscoveryengineV1alphaExportUserEventsMetadata struct { - // CreateTime: Operation create time. - CreateTime string `json:"createTime,omitempty"` - // UpdateTime: Operation last update time. If the operation is done, this is - // also the finish time. - UpdateTime string `json:"updateTime,omitempty"` - // ForceSendFields is a list of field names (e.g. "CreateTime") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "CreateTime") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s GoogleCloudDiscoveryengineV1alphaExportUserEventsMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDiscoveryengineV1alphaExportUserEventsMetadata - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// GoogleCloudDiscoveryengineV1alphaExportUserEventsResponse: Response of the -// ExportUserEventsRequest. If the long running operation was successful, then -// this message is returned by the google.longrunning.Operations.response -// field. -type GoogleCloudDiscoveryengineV1alphaExportUserEventsResponse struct { - // Status: The status of the export operation. - Status *GoogleRpcStatus `json:"status,omitempty"` - // ForceSendFields is a list of field names (e.g. "Status") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Status") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s GoogleCloudDiscoveryengineV1alphaExportUserEventsResponse) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDiscoveryengineV1alphaExportUserEventsResponse - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudDiscoveryengineV1alphaFieldConfig: Configurations for fields of a // schema. For example, configuring a field is indexable, or searchable. type GoogleCloudDiscoveryengineV1alphaFieldConfig struct { @@ -5163,6 +5114,8 @@ type GoogleCloudDiscoveryengineV1alphaFieldConfig struct { // "ADVANCED_SITE_SEARCH_DATA_SOURCE_UNSPECIFIED" - Value used when unset. // "METATAGS" - Retrieve value from meta tag. // "PAGEMAP" - Retrieve value from page map. + // "URI_PATTERN_MAPPING" - Retrieve value from the attributes set by + // SiteSearchEngineService.SetUriPatternDocumentData API. // "SCHEMA_ORG" - Retrieve value from schema.org data. AdvancedSiteSearchDataSources []string `json:"advancedSiteSearchDataSources,omitempty"` // CompletableOption: If completable_option is COMPLETABLE_ENABLED, field @@ -8334,6 +8287,7 @@ type GoogleCloudDiscoveryengineV1betaAnswerQueryRequestQueryUnderstandingSpecQue // "TYPE_UNSPECIFIED" - Unspecified query classification type. // "ADVERSARIAL_QUERY" - Adversarial query classification type. // "NON_ANSWER_SEEKING_QUERY" - Non-answer-seeking query classification type. + // "JAIL_BREAKING_QUERY" - Jail-breaking query classification type. Types []string `json:"types,omitempty"` // ForceSendFields is a list of field names (e.g. "Types") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -8767,6 +8721,7 @@ type GoogleCloudDiscoveryengineV1betaAnswerQueryUnderstandingInfoQueryClassifica // "TYPE_UNSPECIFIED" - Unspecified query classification type. // "ADVERSARIAL_QUERY" - Adversarial query classification type. // "NON_ANSWER_SEEKING_QUERY" - Non-answer-seeking query classification type. + // "JAIL_BREAKING_QUERY" - Jail-breaking query classification type. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Positive") to // unconditionally include in API requests. By default, fields with empty or @@ -11047,6 +11002,9 @@ func (s GoogleCloudDiscoveryengineV1betaDocumentContent) MarshalJSON() ([]byte, type GoogleCloudDiscoveryengineV1betaDocumentInfo struct { // Id: The Document resource ID. Id string `json:"id,omitempty"` + // Joined: Output only. Whether the referenced Document can be found in the + // data store. + Joined bool `json:"joined,omitempty"` // Name: The Document resource full name, of the form: // `projects/{project_id}/locations/{location}/collections/{collection_id}/dataS // tores/{data_store_id}/branches/{branch_id}/documents/{document_id}` @@ -11102,7 +11060,8 @@ type GoogleCloudDiscoveryengineV1betaDocumentProcessingConfig struct { // digital parsing and layout parsing are supported. * `docx`: Override parsing // config for DOCX files, only digital parsing and layout parsing are // supported. * `pptx`: Override parsing config for PPTX files, only digital - // parsing and layout parsing are supported. + // parsing and layout parsing are supported. * `xlsx`: Override parsing config + // for XLSX files, only digital parsing and layout parsing are supported. ParsingConfigOverrides map[string]GoogleCloudDiscoveryengineV1betaDocumentProcessingConfigParsingConfig `json:"parsingConfigOverrides,omitempty"` // ForceSendFields is a list of field names (e.g. "ChunkingConfig") to // unconditionally include in API requests. By default, fields with empty or @@ -11769,6 +11728,11 @@ type GoogleCloudDiscoveryengineV1betaFhirStoreSource struct { // a length limit of 2,000 characters. Can be specified if one wants to have // the FhirStore export to a specific Cloud Storage directory. GcsStagingDir string `json:"gcsStagingDir,omitempty"` + // ResourceTypes: The FHIR resource types to import. The resource types should + // be a subset of all supported FHIR resource types + // (https://cloud.google.com/generative-ai-app-builder/docs/fhir-schema-reference#resource-level-specification). + // Default to all supported FHIR resource types if empty. + ResourceTypes []string `json:"resourceTypes,omitempty"` // ForceSendFields is a list of field names (e.g. "FhirStore") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -15678,6 +15642,10 @@ type GoogleCloudDiscoveryengineV1betaSearchResponseNaturalLanguageQueryUnderstan Address string `json:"address,omitempty"` // FieldName: The name of the geolocation field as defined in the schema. FieldName string `json:"fieldName,omitempty"` + // Latitude: The latitude of the geolocation inferred from the input query. + Latitude float64 `json:"latitude,omitempty"` + // Longitude: The longitude of the geolocation inferred from the input query. + Longitude float64 `json:"longitude,omitempty"` // RadiusInMeters: The radius in meters around the address. The record is // returned if the location of the geolocation field is within the radius. RadiusInMeters float64 `json:"radiusInMeters,omitempty"` @@ -15702,6 +15670,8 @@ func (s GoogleCloudDiscoveryengineV1betaSearchResponseNaturalLanguageQueryUnders func (s *GoogleCloudDiscoveryengineV1betaSearchResponseNaturalLanguageQueryUnderstandingInfoStructuredExtractedFilterGeolocationConstraint) UnmarshalJSON(data []byte) error { type NoMethod GoogleCloudDiscoveryengineV1betaSearchResponseNaturalLanguageQueryUnderstandingInfoStructuredExtractedFilterGeolocationConstraint var s1 struct { + Latitude gensupport.JSONFloat64 `json:"latitude"` + Longitude gensupport.JSONFloat64 `json:"longitude"` RadiusInMeters gensupport.JSONFloat64 `json:"radiusInMeters"` *NoMethod } @@ -15709,6 +15679,8 @@ func (s *GoogleCloudDiscoveryengineV1betaSearchResponseNaturalLanguageQueryUnder if err := json.Unmarshal(data, &s1); err != nil { return err } + s.Latitude = float64(s1.Latitude) + s.Longitude = float64(s1.Longitude) s.RadiusInMeters = float64(s1.RadiusInMeters) return nil } diff --git a/doubleclickbidmanager/v2/doubleclickbidmanager-api.json b/doubleclickbidmanager/v2/doubleclickbidmanager-api.json index a707f5d7d5c..50ea71e658d 100644 --- a/doubleclickbidmanager/v2/doubleclickbidmanager-api.json +++ b/doubleclickbidmanager/v2/doubleclickbidmanager-api.json @@ -107,7 +107,7 @@ "queries": { "methods": { "create": { - "description": "Creates a query.", + "description": "Creates a new query.", "flatPath": "queries", "httpMethod": "POST", "id": "doubleclickbidmanager.queries.create", @@ -125,7 +125,7 @@ ] }, "delete": { - "description": "Deletes a query as well as the associated reports.", + "description": "Deletes an existing query as well as its generated reports.", "flatPath": "queries/{queryId}", "httpMethod": "DELETE", "id": "doubleclickbidmanager.queries.delete", @@ -134,7 +134,7 @@ ], "parameters": { "queryId": { - "description": "Required. ID of query to delete.", + "description": "Required. The ID of the query to delete.", "format": "int64", "location": "path", "required": true, @@ -156,7 +156,7 @@ ], "parameters": { "queryId": { - "description": "Required. ID of query to retrieve.", + "description": "Required. The ID of the query to retrieve.", "format": "int64", "location": "path", "required": true, @@ -179,7 +179,7 @@ "parameterOrder": [], "parameters": { "orderBy": { - "description": "Name of a field used to order results. The default sorting order is ascending. To specify descending order for a field, append a \" desc\" suffix. For example \"metadata.title desc\". Sorting is only supported for the following fields: * `queryId` * `metadata.title`", + "description": "Field to sort the list by. Accepts the following values: * `queryId` (default) * `metadata.title` The default sorting order is ascending. To specify descending order for a field, add the suffix `desc` to the field name. For example, `queryId desc`.", "location": "query", "type": "string" }, @@ -190,7 +190,7 @@ "type": "integer" }, "pageToken": { - "description": "A page token, received from a previous list call. Provide this to retrieve the subsequent page of queries.", + "description": "A token identifying which page of results the server should return. Typically, this is the value of nextPageToken, returned from the previous call to the `queries.list` method. If unspecified, the first page of results is returned.", "location": "query", "type": "string" } @@ -204,7 +204,7 @@ ] }, "run": { - "description": "Runs a stored query to generate a report.", + "description": "Runs an existing query to generate a report.", "flatPath": "queries/{queryId}:run", "httpMethod": "POST", "id": "doubleclickbidmanager.queries.run", @@ -213,14 +213,14 @@ ], "parameters": { "queryId": { - "description": "Required. ID of query to run.", + "description": "Required. The ID of the query to run.", "format": "int64", "location": "path", "required": true, "type": "string" }, "synchronous": { - "description": "Whether the query should be run synchronously. When true, this method will not return until the query has finished running. When false or not specified, this method will return immediately.", + "description": "Whether the query should be run synchronously. When `true`, the request won't return until the resulting report has finished running. This parameter is `false` by default. Setting this parameter to `true` is **not recommended**.", "location": "query", "type": "boolean" } @@ -251,14 +251,14 @@ ], "parameters": { "queryId": { - "description": "Required. ID of the query the report is associated with.", + "description": "Required. The ID of the query that generated the report.", "format": "int64", "location": "path", "required": true, "type": "string" }, "reportId": { - "description": "Required. ID of the report to retrieve.", + "description": "Required. The ID of the query to retrieve.", "format": "int64", "location": "path", "required": true, @@ -274,7 +274,7 @@ ] }, "list": { - "description": "Lists reports associated with a query.", + "description": "Lists reports generated by the provided query.", "flatPath": "queries/{queryId}/reports", "httpMethod": "GET", "id": "doubleclickbidmanager.queries.reports.list", @@ -283,7 +283,7 @@ ], "parameters": { "orderBy": { - "description": "Name of a field used to order results. The default sorting order is ascending. To specify descending order for a field, append a \" desc\" suffix. For example \"key.reportId desc\". Sorting is only supported for the following fields: * `key.reportId`", + "description": "Field to sort the list by. Accepts the following values: * `key.reportId` (default) The default sorting order is ascending. To specify descending order for a field, add the suffix `desc` to the field name. For example, `key.reportId desc`.", "location": "query", "type": "string" }, @@ -294,12 +294,12 @@ "type": "integer" }, "pageToken": { - "description": "A page token, received from a previous list call. Provide this to retrieve the subsequent page of reports.", + "description": "A token identifying which page of results the server should return. Typically, this is the value of nextPageToken returned from the previous call to the `queries.reports.list` method. If unspecified, the first page of results is returned.", "location": "query", "type": "string" }, "queryId": { - "description": "Required. ID of the query with which the reports are associated.", + "description": "Required. The ID of the query that generated the reports.", "format": "int64", "location": "path", "required": true, @@ -319,23 +319,23 @@ } } }, - "revision": "20240626", + "revision": "20240731", "rootUrl": "https://doubleclickbidmanager.googleapis.com/", "schemas": { "DataRange": { - "description": "Report data range.", + "description": "The date range to be reported on.", "id": "DataRange", "properties": { "customEndDate": { "$ref": "Date", - "description": "The ending date for the data that is shown in the report. Note, `customEndDate` is required if `range` is `CUSTOM_DATES` and ignored otherwise." + "description": "If `CUSTOM_DATES` is assigned to range, this field specifies the end date for the date range that is reported on. This field is required if using `CUSTOM_DATES` range and will be ignored otherwise." }, "customStartDate": { "$ref": "Date", - "description": "The starting data for the data that is shown in the report. Note, `customStartDate` is required if `range` is `CUSTOM_DATES` and ignored otherwise." + "description": "If `CUSTOM_DATES` is assigned to range, this field specifies the starting date for the date range that is reported on. This field is required if using `CUSTOM_DATES` range and will be ignored otherwise." }, "range": { - "description": "Report data range used to generate the report.", + "description": "The preset date range to be reported on. If `CUSTOM_DATES` is assigned to this field, fields custom_start_date and custom_end_date must be set to specify the custom date range.", "enum": [ "RANGE_UNSPECIFIED", "CUSTOM_DATES", @@ -359,7 +359,7 @@ ], "enumDescriptions": [ "Default value when range is not specified or is unknown in this version.", - "Custom range specified by custom_start_date and custom_end_date fields.", + "Custom date range.", "Current day.", "Previous day.", "All days, including the current day, since the most recent Sunday.", @@ -406,15 +406,15 @@ "type": "object" }, "FilterPair": { - "description": "Filter used to match traffic data in your report.", + "description": "Represents a single filter rule.", "id": "FilterPair", "properties": { "type": { - "description": "Filter type.", + "description": "The type of value to filter by. Defined by a [Filter](/bid-manager/reference/rest/v2/filters-metrics#filters) value.", "type": "string" }, "value": { - "description": "Filter value.", + "description": "The identifying value to filter by, such as a relevant resource ID.", "type": "string" } }, @@ -424,11 +424,11 @@ "id": "ListQueriesResponse", "properties": { "nextPageToken": { - "description": "A token, which can be sent as page_token to retrieve the next page of queries. If this field is omitted, there are no subsequent pages.", + "description": "A token to retrieve the next page of results. Pass this value in the page_token field in the subsequent call to `queries.list` method to retrieve the next page of results.", "type": "string" }, "queries": { - "description": "The list of queries.", + "description": "The list of queries. This field will be absent if empty.", "items": { "$ref": "Query" }, @@ -441,11 +441,11 @@ "id": "ListReportsResponse", "properties": { "nextPageToken": { - "description": "A token, which can be sent as page_token to retrieve the next page of reports. If this field is omitted, there are no subsequent pages.", + "description": "A token to retrieve the next page of results. Pass this value in the page_token field in the subsequent call to `queries.reports.list` method to retrieve the next page of results.", "type": "string" }, "reports": { - "description": "Retrieved reports.", + "description": "The list of reports. This field will be absent if empty.", "items": { "$ref": "Report" }, @@ -455,36 +455,36 @@ "type": "object" }, "Options": { - "description": "Additional query options.", + "description": "Report parameter options.", "id": "Options", "properties": { "includeOnlyTargetedUserLists": { - "description": "Set to true and filter your report by `FILTER_INSERTION_ORDER` or `FILTER_LINE_ITEM` to include data for audience lists specifically targeted by those items.", + "description": "Whether to include data for audience lists specifically targeted by filtered line items or insertion orders. Requires the use of `FILTER_INSERTION_ORDER` or `FILTER_LINE_ITEM` filters.", "type": "boolean" } }, "type": "object" }, "Parameters": { - "description": "Parameters of a query or report.", + "description": "Parameters of a generated report.", "id": "Parameters", "properties": { "filters": { - "description": "Filters used to match traffic data in your report.", + "description": "Filters to limit the scope of reported data.", "items": { "$ref": "FilterPair" }, "type": "array" }, "groupBys": { - "description": "Data is grouped by the filters listed in this field.", + "description": "Dimensions by which to segment and group the data. Defined by [Filter](/bid-manager/reference/rest/v2/filters-metrics#filters) values.", "items": { "type": "string" }, "type": "array" }, "metrics": { - "description": "Metrics to include as columns in your report.", + "description": "Metrics to define the data populating the report. Defined by [Metric](/bid-manager/reference/rest/v2/filters-metrics#metrics) values.", "items": { "type": "string" }, @@ -492,10 +492,10 @@ }, "options": { "$ref": "Options", - "description": "Additional query options." + "description": "Additional report parameter options." }, "type": { - "description": "The type of the report. The type of the report will dictate what dimesions, filters, and metrics can be used.", + "description": "The type of the report. The type of the report determines the dimesions, filters, and metrics that can be used.", "enum": [ "REPORT_TYPE_UNSPECIFIED", "STANDARD", @@ -544,40 +544,40 @@ "type": "object" }, "Query": { - "description": "Represents a query.", + "description": "A single query used to generate a report.", "id": "Query", "properties": { "metadata": { "$ref": "QueryMetadata", - "description": "Query metadata." + "description": "The metadata of the query." }, "params": { "$ref": "Parameters", - "description": "Query parameters." + "description": "The parameters of the report generated by the query." }, "queryId": { - "description": "Output only. Query ID.", + "description": "Output only. The unique ID of the query.", "format": "int64", "readOnly": true, "type": "string" }, "schedule": { "$ref": "QuerySchedule", - "description": "Information on how often and when to run a query. If `ONE_TIME` is set to the frequency field, the query will only be run at the time of creation." + "description": "When and how often the query is scheduled to run. If the frequency field is set to `ONE_TIME`, the query will only run when queries.run is called." } }, "type": "object" }, "QueryMetadata": { - "description": "Query metadata.", + "description": "The metadata of the query.", "id": "QueryMetadata", "properties": { "dataRange": { "$ref": "DataRange", - "description": "Range of report data. All reports will be based on the same time zone as used by the advertiser." + "description": "The date range the report generated by the query will report on. This date range will be defined by the time zone as used by the advertiser." }, "format": { - "description": "Format of the generated report.", + "description": "The format of the report generated by the query.", "enum": [ "FORMAT_UNSPECIFIED", "CSV", @@ -591,33 +591,33 @@ "type": "string" }, "sendNotification": { - "description": "Whether to send an email notification when a report is ready. Defaults to false.", + "description": "Whether an email notification is sent to the query creator when a report generated by the query is ready. This value is `false` by default.", "type": "boolean" }, "shareEmailAddress": { - "description": "List of email addresses which are sent email notifications when the report is finished. Separate from send_notification.", + "description": "List of additional email addresses with which to share the query. If send_notification is `true`, these email addresses will receive a notification when a report generated by the query is ready. If these email addresses are connected to Display \u0026 Video 360 users, the query will be available to them in the Display \u0026 Video 360 interface.", "items": { "type": "string" }, "type": "array" }, "title": { - "description": "Query title. It is used to name the reports generated from this query.", + "description": "The display name of the query. This value will be used in the file name of reports generated by the query.", "type": "string" } }, "type": "object" }, "QuerySchedule": { - "description": "Information on when and how frequently to run a query.", + "description": "Settings on when and how frequently to run a query.", "id": "QuerySchedule", "properties": { "endDate": { "$ref": "Date", - "description": "Date to periodically run the query until. Not applicable to `ONE_TIME` frequency." + "description": "The date on which to end the scheduled runs. This field is required if frequency is not set to `ONE_TIME`. Otherwise, it will be ignored." }, "frequency": { - "description": "How often the query is run.", + "description": "How frequently to run the query. If set to `ONE_TIME`, the query will only be run when queries.run is called.", "enum": [ "FREQUENCY_UNSPECIFIED", "ONE_TIME", @@ -630,58 +630,58 @@ ], "enumDescriptions": [ "Default value when frequency is not specified or is unknown in this version.", - "Only once.", + "Only when the query is run manually.", "Once a day.", "Once a week.", "Twice a month.", "Once a month.", - "Once a quarter", + "Once a quarter.", "Once a year." ], "type": "string" }, "nextRunTimezoneCode": { - "description": "Canonical timezone code for report generation time. Defaults to `America/New_York`.", + "description": "The canonical code for the timezone the query schedule is based on. Scheduled runs are usually conducted in the morning of a given day. Defaults to `America/New_York`.", "type": "string" }, "startDate": { "$ref": "Date", - "description": "When to start running the query. Not applicable to `ONE_TIME` frequency." + "description": "The date on which to begin the scheduled runs. This field is required if frequency is not set to `ONE_TIME`. Otherwise, it will be ignored." } }, "type": "object" }, "Report": { - "description": "Represents a report.", + "description": "A single report generated by its parent report.", "id": "Report", "properties": { "key": { "$ref": "ReportKey", - "description": "Key used to identify a report." + "description": "The key information identifying the report." }, "metadata": { "$ref": "ReportMetadata", - "description": "Report metadata." + "description": "The metadata of the report." }, "params": { "$ref": "Parameters", - "description": "Report parameters." + "description": "The parameters of the report." } }, "type": "object" }, "ReportKey": { - "description": "Key used to identify a report.", + "description": "Identifying information of a report.", "id": "ReportKey", "properties": { "queryId": { - "description": "Output only. Query ID.", + "description": "Output only. The unique ID of the query that generated the report.", "format": "int64", "readOnly": true, "type": "string" }, "reportId": { - "description": "Output only. Report ID.", + "description": "Output only. The unique ID of the report.", "format": "int64", "readOnly": true, "type": "string" @@ -690,41 +690,41 @@ "type": "object" }, "ReportMetadata": { - "description": "Report metadata.", + "description": "The metadata of a report.", "id": "ReportMetadata", "properties": { "googleCloudStoragePath": { - "description": "Output only. The path to the location in Google Cloud Storage where the report is stored.", + "description": "Output only. The location of the generated report file in Google Cloud Storage. This field will be absent if status.state is not `DONE`.", "readOnly": true, "type": "string" }, "reportDataEndDate": { "$ref": "Date", - "description": "The ending time for the data that is shown in the report." + "description": "The end date of the report data date range." }, "reportDataStartDate": { "$ref": "Date", - "description": "The starting time for the data that is shown in the report." + "description": "The start date of the report data date range." }, "status": { "$ref": "ReportStatus", - "description": "Report status." + "description": "The status of the report." } }, "type": "object" }, "ReportStatus": { - "description": "Report status.", + "description": "The status of a report.", "id": "ReportStatus", "properties": { "finishTime": { - "description": "Output only. The time when this report either completed successfully or failed.", + "description": "Output only. The timestamp of when report generation finished successfully or in failure. This field will not be set unless state is `DONE` or `FAILED`.", "format": "google-datetime", "readOnly": true, "type": "string" }, "format": { - "description": "The file type of the report.", + "description": "The format of the generated report file.", "enum": [ "FORMAT_UNSPECIFIED", "CSV", @@ -738,7 +738,7 @@ "type": "string" }, "state": { - "description": "Output only. The state of the report.", + "description": "Output only. The state of the report generation.", "enum": [ "STATE_UNSPECIFIED", "QUEUED", @@ -760,12 +760,12 @@ "type": "object" }, "RunQueryRequest": { - "description": "Request to run a stored query to generate a report.", + "description": "Details specifying how to run a query.", "id": "RunQueryRequest", "properties": { "dataRange": { "$ref": "DataRange", - "description": "Report data range used to generate the report. If unspecified, the original parent query's data range is used." + "description": "The date range used by the query to generate the report. If unspecified, the query's original data_range is used." } }, "type": "object" diff --git a/doubleclickbidmanager/v2/doubleclickbidmanager-gen.go b/doubleclickbidmanager/v2/doubleclickbidmanager-gen.go index 7315a016bc3..7da311ab382 100644 --- a/doubleclickbidmanager/v2/doubleclickbidmanager-gen.go +++ b/doubleclickbidmanager/v2/doubleclickbidmanager-gen.go @@ -174,23 +174,25 @@ type QueriesReportsService struct { s *Service } -// DataRange: Report data range. +// DataRange: The date range to be reported on. type DataRange struct { - // CustomEndDate: The ending date for the data that is shown in the report. - // Note, `customEndDate` is required if `range` is `CUSTOM_DATES` and ignored - // otherwise. + // CustomEndDate: If `CUSTOM_DATES` is assigned to range, this field specifies + // the end date for the date range that is reported on. This field is required + // if using `CUSTOM_DATES` range and will be ignored otherwise. CustomEndDate *Date `json:"customEndDate,omitempty"` - // CustomStartDate: The starting data for the data that is shown in the report. - // Note, `customStartDate` is required if `range` is `CUSTOM_DATES` and ignored + // CustomStartDate: If `CUSTOM_DATES` is assigned to range, this field + // specifies the starting date for the date range that is reported on. This + // field is required if using `CUSTOM_DATES` range and will be ignored // otherwise. CustomStartDate *Date `json:"customStartDate,omitempty"` - // Range: Report data range used to generate the report. + // Range: The preset date range to be reported on. If `CUSTOM_DATES` is + // assigned to this field, fields custom_start_date and custom_end_date must be + // set to specify the custom date range. // // Possible values: // "RANGE_UNSPECIFIED" - Default value when range is not specified or is // unknown in this version. - // "CUSTOM_DATES" - Custom range specified by custom_start_date and - // custom_end_date fields. + // "CUSTOM_DATES" - Custom date range. // "CURRENT_DAY" - Current day. // "PREVIOUS_DAY" - Previous day. // "WEEK_TO_DATE" - All days, including the current day, since the most @@ -270,11 +272,12 @@ func (s Date) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// FilterPair: Filter used to match traffic data in your report. +// FilterPair: Represents a single filter rule. type FilterPair struct { - // Type: Filter type. + // Type: The type of value to filter by. Defined by a Filter + // (/bid-manager/reference/rest/v2/filters-metrics#filters) value. Type string `json:"type,omitempty"` - // Value: Filter value. + // Value: The identifying value to filter by, such as a relevant resource ID. Value string `json:"value,omitempty"` // ForceSendFields is a list of field names (e.g. "Type") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -295,10 +298,11 @@ func (s FilterPair) MarshalJSON() ([]byte, error) { } type ListQueriesResponse struct { - // NextPageToken: A token, which can be sent as page_token to retrieve the next - // page of queries. If this field is omitted, there are no subsequent pages. + // NextPageToken: A token to retrieve the next page of results. Pass this value + // in the page_token field in the subsequent call to `queries.list` method to + // retrieve the next page of results. NextPageToken string `json:"nextPageToken,omitempty"` - // Queries: The list of queries. + // Queries: The list of queries. This field will be absent if empty. Queries []*Query `json:"queries,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -322,10 +326,11 @@ func (s ListQueriesResponse) MarshalJSON() ([]byte, error) { } type ListReportsResponse struct { - // NextPageToken: A token, which can be sent as page_token to retrieve the next - // page of reports. If this field is omitted, there are no subsequent pages. + // NextPageToken: A token to retrieve the next page of results. Pass this value + // in the page_token field in the subsequent call to `queries.reports.list` + // method to retrieve the next page of results. NextPageToken string `json:"nextPageToken,omitempty"` - // Reports: Retrieved reports. + // Reports: The list of reports. This field will be absent if empty. Reports []*Report `json:"reports,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -348,11 +353,11 @@ func (s ListReportsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Options: Additional query options. +// Options: Report parameter options. type Options struct { - // IncludeOnlyTargetedUserLists: Set to true and filter your report by - // `FILTER_INSERTION_ORDER` or `FILTER_LINE_ITEM` to include data for audience - // lists specifically targeted by those items. + // IncludeOnlyTargetedUserLists: Whether to include data for audience lists + // specifically targeted by filtered line items or insertion orders. Requires + // the use of `FILTER_INSERTION_ORDER` or `FILTER_LINE_ITEM` filters. IncludeOnlyTargetedUserLists bool `json:"includeOnlyTargetedUserLists,omitempty"` // ForceSendFields is a list of field names (e.g. // "IncludeOnlyTargetedUserLists") to unconditionally include in API requests. @@ -372,18 +377,20 @@ func (s Options) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Parameters: Parameters of a query or report. +// Parameters: Parameters of a generated report. type Parameters struct { - // Filters: Filters used to match traffic data in your report. + // Filters: Filters to limit the scope of reported data. Filters []*FilterPair `json:"filters,omitempty"` - // GroupBys: Data is grouped by the filters listed in this field. + // GroupBys: Dimensions by which to segment and group the data. Defined by + // Filter (/bid-manager/reference/rest/v2/filters-metrics#filters) values. GroupBys []string `json:"groupBys,omitempty"` - // Metrics: Metrics to include as columns in your report. + // Metrics: Metrics to define the data populating the report. Defined by Metric + // (/bid-manager/reference/rest/v2/filters-metrics#metrics) values. Metrics []string `json:"metrics,omitempty"` - // Options: Additional query options. + // Options: Additional report parameter options. Options *Options `json:"options,omitempty"` - // Type: The type of the report. The type of the report will dictate what - // dimesions, filters, and metrics can be used. + // Type: The type of the report. The type of the report determines the + // dimesions, filters, and metrics that can be used. // // Possible values: // "REPORT_TYPE_UNSPECIFIED" - Default value when report type is not @@ -419,17 +426,17 @@ func (s Parameters) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Query: Represents a query. +// Query: A single query used to generate a report. type Query struct { - // Metadata: Query metadata. + // Metadata: The metadata of the query. Metadata *QueryMetadata `json:"metadata,omitempty"` - // Params: Query parameters. + // Params: The parameters of the report generated by the query. Params *Parameters `json:"params,omitempty"` - // QueryId: Output only. Query ID. + // QueryId: Output only. The unique ID of the query. QueryId int64 `json:"queryId,omitempty,string"` - // Schedule: Information on how often and when to run a query. If `ONE_TIME` is - // set to the frequency field, the query will only be run at the time of - // creation. + // Schedule: When and how often the query is scheduled to run. If the frequency + // field is set to `ONE_TIME`, the query will only run when queries.run is + // called. Schedule *QuerySchedule `json:"schedule,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -452,12 +459,12 @@ func (s Query) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// QueryMetadata: Query metadata. +// QueryMetadata: The metadata of the query. type QueryMetadata struct { - // DataRange: Range of report data. All reports will be based on the same time - // zone as used by the advertiser. + // DataRange: The date range the report generated by the query will report on. + // This date range will be defined by the time zone as used by the advertiser. DataRange *DataRange `json:"dataRange,omitempty"` - // Format: Format of the generated report. + // Format: The format of the report generated by the query. // // Possible values: // "FORMAT_UNSPECIFIED" - Default value when format is not specified or is @@ -465,14 +472,18 @@ type QueryMetadata struct { // "CSV" - CSV. // "XLSX" - Excel. Format string `json:"format,omitempty"` - // SendNotification: Whether to send an email notification when a report is - // ready. Defaults to false. + // SendNotification: Whether an email notification is sent to the query creator + // when a report generated by the query is ready. This value is `false` by + // default. SendNotification bool `json:"sendNotification,omitempty"` - // ShareEmailAddress: List of email addresses which are sent email - // notifications when the report is finished. Separate from send_notification. + // ShareEmailAddress: List of additional email addresses with which to share + // the query. If send_notification is `true`, these email addresses will + // receive a notification when a report generated by the query is ready. If + // these email addresses are connected to Display & Video 360 users, the query + // will be available to them in the Display & Video 360 interface. ShareEmailAddress []string `json:"shareEmailAddress,omitempty"` - // Title: Query title. It is used to name the reports generated from this - // query. + // Title: The display name of the query. This value will be used in the file + // name of reports generated by the query. Title string `json:"title,omitempty"` // ForceSendFields is a list of field names (e.g. "DataRange") to // unconditionally include in API requests. By default, fields with empty or @@ -492,29 +503,32 @@ func (s QueryMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// QuerySchedule: Information on when and how frequently to run a query. +// QuerySchedule: Settings on when and how frequently to run a query. type QuerySchedule struct { - // EndDate: Date to periodically run the query until. Not applicable to - // `ONE_TIME` frequency. + // EndDate: The date on which to end the scheduled runs. This field is required + // if frequency is not set to `ONE_TIME`. Otherwise, it will be ignored. EndDate *Date `json:"endDate,omitempty"` - // Frequency: How often the query is run. + // Frequency: How frequently to run the query. If set to `ONE_TIME`, the query + // will only be run when queries.run is called. // // Possible values: // "FREQUENCY_UNSPECIFIED" - Default value when frequency is not specified or // is unknown in this version. - // "ONE_TIME" - Only once. + // "ONE_TIME" - Only when the query is run manually. // "DAILY" - Once a day. // "WEEKLY" - Once a week. // "SEMI_MONTHLY" - Twice a month. // "MONTHLY" - Once a month. - // "QUARTERLY" - Once a quarter + // "QUARTERLY" - Once a quarter. // "YEARLY" - Once a year. Frequency string `json:"frequency,omitempty"` - // NextRunTimezoneCode: Canonical timezone code for report generation time. - // Defaults to `America/New_York`. + // NextRunTimezoneCode: The canonical code for the timezone the query schedule + // is based on. Scheduled runs are usually conducted in the morning of a given + // day. Defaults to `America/New_York`. NextRunTimezoneCode string `json:"nextRunTimezoneCode,omitempty"` - // StartDate: When to start running the query. Not applicable to `ONE_TIME` - // frequency. + // StartDate: The date on which to begin the scheduled runs. This field is + // required if frequency is not set to `ONE_TIME`. Otherwise, it will be + // ignored. StartDate *Date `json:"startDate,omitempty"` // ForceSendFields is a list of field names (e.g. "EndDate") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -534,13 +548,13 @@ func (s QuerySchedule) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Report: Represents a report. +// Report: A single report generated by its parent report. type Report struct { - // Key: Key used to identify a report. + // Key: The key information identifying the report. Key *ReportKey `json:"key,omitempty"` - // Metadata: Report metadata. + // Metadata: The metadata of the report. Metadata *ReportMetadata `json:"metadata,omitempty"` - // Params: Report parameters. + // Params: The parameters of the report. Params *Parameters `json:"params,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -563,11 +577,11 @@ func (s Report) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// ReportKey: Key used to identify a report. +// ReportKey: Identifying information of a report. type ReportKey struct { - // QueryId: Output only. Query ID. + // QueryId: Output only. The unique ID of the query that generated the report. QueryId int64 `json:"queryId,omitempty,string"` - // ReportId: Output only. Report ID. + // ReportId: Output only. The unique ID of the report. ReportId int64 `json:"reportId,omitempty,string"` // ForceSendFields is a list of field names (e.g. "QueryId") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -587,17 +601,17 @@ func (s ReportKey) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// ReportMetadata: Report metadata. +// ReportMetadata: The metadata of a report. type ReportMetadata struct { - // GoogleCloudStoragePath: Output only. The path to the location in Google - // Cloud Storage where the report is stored. + // GoogleCloudStoragePath: Output only. The location of the generated report + // file in Google Cloud Storage. This field will be absent if status.state is + // not `DONE`. GoogleCloudStoragePath string `json:"googleCloudStoragePath,omitempty"` - // ReportDataEndDate: The ending time for the data that is shown in the report. + // ReportDataEndDate: The end date of the report data date range. ReportDataEndDate *Date `json:"reportDataEndDate,omitempty"` - // ReportDataStartDate: The starting time for the data that is shown in the - // report. + // ReportDataStartDate: The start date of the report data date range. ReportDataStartDate *Date `json:"reportDataStartDate,omitempty"` - // Status: Report status. + // Status: The status of the report. Status *ReportStatus `json:"status,omitempty"` // ForceSendFields is a list of field names (e.g. "GoogleCloudStoragePath") to // unconditionally include in API requests. By default, fields with empty or @@ -617,12 +631,13 @@ func (s ReportMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// ReportStatus: Report status. +// ReportStatus: The status of a report. type ReportStatus struct { - // FinishTime: Output only. The time when this report either completed - // successfully or failed. + // FinishTime: Output only. The timestamp of when report generation finished + // successfully or in failure. This field will not be set unless state is + // `DONE` or `FAILED`. FinishTime string `json:"finishTime,omitempty"` - // Format: The file type of the report. + // Format: The format of the generated report file. // // Possible values: // "FORMAT_UNSPECIFIED" - Default value when format is not specified or is @@ -630,7 +645,7 @@ type ReportStatus struct { // "CSV" - CSV. // "XLSX" - Excel. Format string `json:"format,omitempty"` - // State: Output only. The state of the report. + // State: Output only. The state of the report generation. // // Possible values: // "STATE_UNSPECIFIED" - Default value when state is not specified or is @@ -658,10 +673,10 @@ func (s ReportStatus) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// RunQueryRequest: Request to run a stored query to generate a report. +// RunQueryRequest: Details specifying how to run a query. type RunQueryRequest struct { - // DataRange: Report data range used to generate the report. If unspecified, - // the original parent query's data range is used. + // DataRange: The date range used by the query to generate the report. If + // unspecified, the query's original data_range is used. DataRange *DataRange `json:"dataRange,omitempty"` // ForceSendFields is a list of field names (e.g. "DataRange") to // unconditionally include in API requests. By default, fields with empty or @@ -689,7 +704,7 @@ type QueriesCreateCall struct { header_ http.Header } -// Create: Creates a query. +// Create: Creates a new query. func (r *QueriesService) Create(query *Query) *QueriesCreateCall { c := &QueriesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.query = query @@ -783,9 +798,9 @@ type QueriesDeleteCall struct { header_ http.Header } -// Delete: Deletes a query as well as the associated reports. +// Delete: Deletes an existing query as well as its generated reports. // -// - queryId: ID of query to delete. +// - queryId: The ID of the query to delete. func (r *QueriesService) Delete(queryId int64) *QueriesDeleteCall { c := &QueriesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.queryId = queryId @@ -858,7 +873,7 @@ type QueriesGetCall struct { // Get: Retrieves a query. // -// - queryId: ID of query to retrieve. +// - queryId: The ID of the query to retrieve. func (r *QueriesService) Get(queryId int64) *QueriesGetCall { c := &QueriesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.queryId = queryId @@ -968,11 +983,10 @@ func (r *QueriesService) List() *QueriesListCall { return c } -// OrderBy sets the optional parameter "orderBy": Name of a field used to order -// results. The default sorting order is ascending. To specify descending order -// for a field, append a " desc" suffix. For example "metadata.title desc". -// Sorting is only supported for the following fields: * `queryId` * -// `metadata.title` +// OrderBy sets the optional parameter "orderBy": Field to sort the list by. +// Accepts the following values: * `queryId` (default) * `metadata.title` The +// default sorting order is ascending. To specify descending order for a field, +// add the suffix `desc` to the field name. For example, `queryId desc`. func (c *QueriesListCall) OrderBy(orderBy string) *QueriesListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -985,9 +999,10 @@ func (c *QueriesListCall) PageSize(pageSize int64) *QueriesListCall { return c } -// PageToken sets the optional parameter "pageToken": A page token, received -// from a previous list call. Provide this to retrieve the subsequent page of -// queries. +// PageToken sets the optional parameter "pageToken": A token identifying which +// page of results the server should return. Typically, this is the value of +// nextPageToken, returned from the previous call to the `queries.list` method. +// If unspecified, the first page of results is returned. func (c *QueriesListCall) PageToken(pageToken string) *QueriesListCall { c.urlParams_.Set("pageToken", pageToken) return c @@ -1110,9 +1125,9 @@ type QueriesRunCall struct { header_ http.Header } -// Run: Runs a stored query to generate a report. +// Run: Runs an existing query to generate a report. // -// - queryId: ID of query to run. +// - queryId: The ID of the query to run. func (r *QueriesService) Run(queryId int64, runqueryrequest *RunQueryRequest) *QueriesRunCall { c := &QueriesRunCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.queryId = queryId @@ -1121,9 +1136,9 @@ func (r *QueriesService) Run(queryId int64, runqueryrequest *RunQueryRequest) *Q } // Synchronous sets the optional parameter "synchronous": Whether the query -// should be run synchronously. When true, this method will not return until -// the query has finished running. When false or not specified, this method -// will return immediately. +// should be run synchronously. When `true`, the request won't return until the +// resulting report has finished running. This parameter is `false` by default. +// Setting this parameter to `true` is **not recommended**. func (c *QueriesRunCall) Synchronous(synchronous bool) *QueriesRunCall { c.urlParams_.Set("synchronous", fmt.Sprint(synchronous)) return c @@ -1223,8 +1238,8 @@ type QueriesReportsGetCall struct { // Get: Retrieves a report. // -// - queryId: ID of the query the report is associated with. -// - reportId: ID of the report to retrieve. +// - queryId: The ID of the query that generated the report. +// - reportId: The ID of the query to retrieve. func (r *QueriesReportsService) Get(queryId int64, reportId int64) *QueriesReportsGetCall { c := &QueriesReportsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.queryId = queryId @@ -1331,19 +1346,19 @@ type QueriesReportsListCall struct { header_ http.Header } -// List: Lists reports associated with a query. +// List: Lists reports generated by the provided query. // -// - queryId: ID of the query with which the reports are associated. +// - queryId: The ID of the query that generated the reports. func (r *QueriesReportsService) List(queryId int64) *QueriesReportsListCall { c := &QueriesReportsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.queryId = queryId return c } -// OrderBy sets the optional parameter "orderBy": Name of a field used to order -// results. The default sorting order is ascending. To specify descending order -// for a field, append a " desc" suffix. For example "key.reportId desc". -// Sorting is only supported for the following fields: * `key.reportId` +// OrderBy sets the optional parameter "orderBy": Field to sort the list by. +// Accepts the following values: * `key.reportId` (default) The default sorting +// order is ascending. To specify descending order for a field, add the suffix +// `desc` to the field name. For example, `key.reportId desc`. func (c *QueriesReportsListCall) OrderBy(orderBy string) *QueriesReportsListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -1356,9 +1371,10 @@ func (c *QueriesReportsListCall) PageSize(pageSize int64) *QueriesReportsListCal return c } -// PageToken sets the optional parameter "pageToken": A page token, received -// from a previous list call. Provide this to retrieve the subsequent page of -// reports. +// PageToken sets the optional parameter "pageToken": A token identifying which +// page of results the server should return. Typically, this is the value of +// nextPageToken returned from the previous call to the `queries.reports.list` +// method. If unspecified, the first page of results is returned. func (c *QueriesReportsListCall) PageToken(pageToken string) *QueriesReportsListCall { c.urlParams_.Set("pageToken", pageToken) return c diff --git a/firebaseml/v2beta/firebaseml-api.json b/firebaseml/v2beta/firebaseml-api.json index 20a4890141d..52d353c2b9f 100644 --- a/firebaseml/v2beta/firebaseml-api.json +++ b/firebaseml/v2beta/firebaseml-api.json @@ -206,7 +206,7 @@ } } }, - "revision": "20240802", + "revision": "20240805", "rootUrl": "https://firebaseml.googleapis.com/", "schemas": { "Date": { @@ -718,6 +718,11 @@ "$ref": "GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfig", "description": "Optional. Routing configuration." }, + "seed": { + "description": "Optional. Seed.", + "format": "int32", + "type": "integer" + }, "stopSequences": { "description": "Optional. Stop sequences.", "items": { diff --git a/firebaseml/v2beta/firebaseml-gen.go b/firebaseml/v2beta/firebaseml-gen.go index 6503768c7ad..21cb5912020 100644 --- a/firebaseml/v2beta/firebaseml-gen.go +++ b/firebaseml/v2beta/firebaseml-gen.go @@ -829,6 +829,8 @@ type GoogleCloudAiplatformV1beta1GenerationConfig struct { ResponseSchema *GoogleCloudAiplatformV1beta1Schema `json:"responseSchema,omitempty"` // RoutingConfig: Optional. Routing configuration. RoutingConfig *GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfig `json:"routingConfig,omitempty"` + // Seed: Optional. Seed. + Seed int64 `json:"seed,omitempty"` // StopSequences: Optional. Stop sequences. StopSequences []string `json:"stopSequences,omitempty"` // Temperature: Optional. Controls the randomness of predictions. diff --git a/networksecurity/v1/networksecurity-api.json b/networksecurity/v1/networksecurity-api.json index 50b3eae2f42..8c16ba9a9a7 100644 --- a/networksecurity/v1/networksecurity-api.json +++ b/networksecurity/v1/networksecurity-api.json @@ -1729,6 +1729,97 @@ } } }, + "authzPolicies": { + "methods": { + "getIamPolicy": { + "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/authzPolicies/{authzPoliciesId}:getIamPolicy", + "httpMethod": "GET", + "id": "networksecurity.projects.locations.authzPolicies.getIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "options.requestedPolicyVersion": { + "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", + "format": "int32", + "location": "query", + "type": "integer" + }, + "resource": { + "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/authzPolicies/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:getIamPolicy", + "response": { + "$ref": "GoogleIamV1Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/authzPolicies/{authzPoliciesId}:setIamPolicy", + "httpMethod": "POST", + "id": "networksecurity.projects.locations.authzPolicies.setIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/authzPolicies/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:setIamPolicy", + "request": { + "$ref": "GoogleIamV1SetIamPolicyRequest" + }, + "response": { + "$ref": "GoogleIamV1Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/authzPolicies/{authzPoliciesId}:testIamPermissions", + "httpMethod": "POST", + "id": "networksecurity.projects.locations.authzPolicies.testIamPermissions", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/authzPolicies/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:testIamPermissions", + "request": { + "$ref": "GoogleIamV1TestIamPermissionsRequest" + }, + "response": { + "$ref": "GoogleIamV1TestIamPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "clientTlsPolicies": { "methods": { "create": { @@ -3162,7 +3253,7 @@ } } }, - "revision": "20240626", + "revision": "20240803", "rootUrl": "https://networksecurity.googleapis.com/", "schemas": { "AddAddressGroupItemsRequest": { @@ -3220,6 +3311,23 @@ "description": "Required. Name of the AddressGroup resource. It matches pattern `projects/*/locations/{location}/addressGroups/`.", "type": "string" }, + "purpose": { + "description": "Optional. List of supported purposes of the Address Group.", + "items": { + "enum": [ + "PURPOSE_UNSPECIFIED", + "DEFAULT", + "CLOUD_ARMOR" + ], + "enumDescriptions": [ + "Default value. Should never happen.", + "Address Group is distributed to VMC, and is usable in Firewall Policies and other systems that rely on VMC.", + "Address Group is usable in Cloud Armor." + ], + "type": "string" + }, + "type": "array" + }, "selfLink": { "description": "Output only. Server-defined fully-qualified URL for this resource.", "readOnly": true, @@ -4408,7 +4516,7 @@ "type": "object" }, "SecurityProfile": { - "description": "SecurityProfile is a resource that defines the behavior for one of many ProfileTypes. Next ID: 11", + "description": "SecurityProfile is a resource that defines the behavior for one of many ProfileTypes. Next ID: 12", "id": "SecurityProfile", "properties": { "createTime": { @@ -4463,7 +4571,7 @@ "type": "object" }, "SecurityProfileGroup": { - "description": "SecurityProfileGroup is a resource that defines the behavior for various ProfileTypes. Next ID: 10", + "description": "SecurityProfileGroup is a resource that defines the behavior for various ProfileTypes. Next ID: 11", "id": "SecurityProfileGroup", "properties": { "createTime": { @@ -4493,7 +4601,7 @@ "type": "string" }, "threatPreventionProfile": { - "description": "Optional. Reference to a SecurityProfile with the threat prevention configuration for the SecurityProfileGroup.", + "description": "Optional. Reference to a SecurityProfile with the ThreatPrevention configuration.", "type": "string" }, "updateTime": { diff --git a/networksecurity/v1/networksecurity-gen.go b/networksecurity/v1/networksecurity-gen.go index dc124d1042e..dbec869f975 100644 --- a/networksecurity/v1/networksecurity-gen.go +++ b/networksecurity/v1/networksecurity-gen.go @@ -254,6 +254,7 @@ func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { rs := &ProjectsLocationsService{s: s} rs.AddressGroups = NewProjectsLocationsAddressGroupsService(s) rs.AuthorizationPolicies = NewProjectsLocationsAuthorizationPoliciesService(s) + rs.AuthzPolicies = NewProjectsLocationsAuthzPoliciesService(s) rs.ClientTlsPolicies = NewProjectsLocationsClientTlsPoliciesService(s) rs.FirewallEndpointAssociations = NewProjectsLocationsFirewallEndpointAssociationsService(s) rs.GatewaySecurityPolicies = NewProjectsLocationsGatewaySecurityPoliciesService(s) @@ -271,6 +272,8 @@ type ProjectsLocationsService struct { AuthorizationPolicies *ProjectsLocationsAuthorizationPoliciesService + AuthzPolicies *ProjectsLocationsAuthzPoliciesService + ClientTlsPolicies *ProjectsLocationsClientTlsPoliciesService FirewallEndpointAssociations *ProjectsLocationsFirewallEndpointAssociationsService @@ -304,6 +307,15 @@ type ProjectsLocationsAuthorizationPoliciesService struct { s *Service } +func NewProjectsLocationsAuthzPoliciesService(s *Service) *ProjectsLocationsAuthzPoliciesService { + rs := &ProjectsLocationsAuthzPoliciesService{s: s} + return rs +} + +type ProjectsLocationsAuthzPoliciesService struct { + s *Service +} + func NewProjectsLocationsClientTlsPoliciesService(s *Service) *ProjectsLocationsClientTlsPoliciesService { rs := &ProjectsLocationsClientTlsPoliciesService{s: s} return rs @@ -431,6 +443,14 @@ type AddressGroup struct { // Name: Required. Name of the AddressGroup resource. It matches pattern // `projects/*/locations/{location}/addressGroups/`. Name string `json:"name,omitempty"` + // Purpose: Optional. List of supported purposes of the Address Group. + // + // Possible values: + // "PURPOSE_UNSPECIFIED" - Default value. Should never happen. + // "DEFAULT" - Address Group is distributed to VMC, and is usable in Firewall + // Policies and other systems that rely on VMC. + // "CLOUD_ARMOR" - Address Group is usable in Cloud Armor. + Purpose []string `json:"purpose,omitempty"` // SelfLink: Output only. Server-defined fully-qualified URL for this resource. SelfLink string `json:"selfLink,omitempty"` // Type: Required. The type of the Address Group. Possible values are "IPv4" or @@ -2134,7 +2154,7 @@ func (s Rule) MarshalJSON() ([]byte, error) { } // SecurityProfile: SecurityProfile is a resource that defines the behavior for -// one of many ProfileTypes. Next ID: 11 +// one of many ProfileTypes. Next ID: 12 type SecurityProfile struct { // CreateTime: Output only. Resource creation timestamp. CreateTime string `json:"createTime,omitempty"` @@ -2186,7 +2206,7 @@ func (s SecurityProfile) MarshalJSON() ([]byte, error) { } // SecurityProfileGroup: SecurityProfileGroup is a resource that defines the -// behavior for various ProfileTypes. Next ID: 10 +// behavior for various ProfileTypes. Next ID: 11 type SecurityProfileGroup struct { // CreateTime: Output only. Resource creation timestamp. CreateTime string `json:"createTime,omitempty"` @@ -2205,7 +2225,7 @@ type SecurityProfileGroup struct { // y_profile_group}`. Name string `json:"name,omitempty"` // ThreatPreventionProfile: Optional. Reference to a SecurityProfile with the - // threat prevention configuration for the SecurityProfileGroup. + // ThreatPrevention configuration. ThreatPreventionProfile string `json:"threatPreventionProfile,omitempty"` // UpdateTime: Output only. Last resource update timestamp. UpdateTime string `json:"updateTime,omitempty"` @@ -8604,6 +8624,349 @@ func (c *ProjectsLocationsAuthorizationPoliciesTestIamPermissionsCall) Do(opts . return ret, nil } +type ProjectsLocationsAuthzPoliciesGetIamPolicyCall struct { + s *Service + resource string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetIamPolicy: Gets the access control policy for a resource. Returns an +// empty policy if the resource exists and does not have a policy set. +// +// - resource: REQUIRED: The resource for which the policy is being requested. +// See Resource names (https://cloud.google.com/apis/design/resource_names) +// for the appropriate value for this field. +func (r *ProjectsLocationsAuthzPoliciesService) GetIamPolicy(resource string) *ProjectsLocationsAuthzPoliciesGetIamPolicyCall { + c := &ProjectsLocationsAuthzPoliciesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + return c +} + +// OptionsRequestedPolicyVersion sets the optional parameter +// "options.requestedPolicyVersion": The maximum policy version that will be +// used to format the policy. Valid values are 0, 1, and 3. Requests specifying +// an invalid value will be rejected. Requests for policies with any +// conditional role bindings must specify version 3. Policies with no +// conditional role bindings may specify any valid value or leave the field +// unset. The policy in the response might use the policy version that you +// specified, or it might use a lower policy version. For example, if you +// specify version 3, but the policy has no conditional role bindings, the +// response uses version 1. To learn which resources support conditions in +// their IAM policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +func (c *ProjectsLocationsAuthzPoliciesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsAuthzPoliciesGetIamPolicyCall { + c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsAuthzPoliciesGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsAuthzPoliciesGetIamPolicyCall { + 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 *ProjectsLocationsAuthzPoliciesGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsAuthzPoliciesGetIamPolicyCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsAuthzPoliciesGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsAuthzPoliciesGetIamPolicyCall { + 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 *ProjectsLocationsAuthzPoliciesGetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsAuthzPoliciesGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:getIamPolicy") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "networksecurity.projects.locations.authzPolicies.getIamPolicy" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleIamV1Policy.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified was +// returned. +func (c *ProjectsLocationsAuthzPoliciesGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleIamV1Policy{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil +} + +type ProjectsLocationsAuthzPoliciesSetIamPolicyCall struct { + s *Service + resource string + googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetIamPolicy: Sets the access control policy on the specified resource. +// Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, +// and `PERMISSION_DENIED` errors. +// +// - resource: REQUIRED: The resource for which the policy is being specified. +// See Resource names (https://cloud.google.com/apis/design/resource_names) +// for the appropriate value for this field. +func (r *ProjectsLocationsAuthzPoliciesService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *ProjectsLocationsAuthzPoliciesSetIamPolicyCall { + c := &ProjectsLocationsAuthzPoliciesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.googleiamv1setiampolicyrequest = googleiamv1setiampolicyrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsAuthzPoliciesSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsAuthzPoliciesSetIamPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsAuthzPoliciesSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsAuthzPoliciesSetIamPolicyCall { + 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 *ProjectsLocationsAuthzPoliciesSetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsAuthzPoliciesSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleiamv1setiampolicyrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:setIamPolicy") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "networksecurity.projects.locations.authzPolicies.setIamPolicy" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleIamV1Policy.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified was +// returned. +func (c *ProjectsLocationsAuthzPoliciesSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1Policy, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleIamV1Policy{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil +} + +type ProjectsLocationsAuthzPoliciesTestIamPermissionsCall struct { + s *Service + resource string + googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// TestIamPermissions: Returns permissions that a caller has on the specified +// resource. If the resource does not exist, this will return an empty set of +// permissions, not a `NOT_FOUND` error. Note: This operation is designed to be +// used for building permission-aware UIs and command-line tools, not for +// authorization checking. This operation may "fail open" without warning. +// +// - resource: REQUIRED: The resource for which the policy detail is being +// requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the appropriate +// value for this field. +func (r *ProjectsLocationsAuthzPoliciesService) TestIamPermissions(resource string, googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest) *ProjectsLocationsAuthzPoliciesTestIamPermissionsCall { + c := &ProjectsLocationsAuthzPoliciesTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.googleiamv1testiampermissionsrequest = googleiamv1testiampermissionsrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsAuthzPoliciesTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsAuthzPoliciesTestIamPermissionsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsAuthzPoliciesTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsAuthzPoliciesTestIamPermissionsCall { + 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 *ProjectsLocationsAuthzPoliciesTestIamPermissionsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsAuthzPoliciesTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleiamv1testiampermissionsrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:testIamPermissions") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "networksecurity.projects.locations.authzPolicies.testIamPermissions" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleIamV1TestIamPermissionsResponse.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsAuthzPoliciesTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*GoogleIamV1TestIamPermissionsResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &GoogleIamV1TestIamPermissionsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil +} + type ProjectsLocationsClientTlsPoliciesCreateCall struct { s *Service parent string diff --git a/realtimebidding/v1/realtimebidding-api.json b/realtimebidding/v1/realtimebidding-api.json index e46105cab4d..a7a7b824ac6 100644 --- a/realtimebidding/v1/realtimebidding-api.json +++ b/realtimebidding/v1/realtimebidding-api.json @@ -1305,7 +1305,7 @@ } } }, - "revision": "20240801", + "revision": "20240806", "rootUrl": "https://realtimebidding.googleapis.com/", "schemas": { "ActivatePretargetingConfigRequest": { @@ -1969,6 +1969,27 @@ }, "type": "array" }, + "detectedCategories": { + "description": "Output only. IDs of the detected categories, if any. The taxonomy in which the categories are expressed is specified by the detected_categories_taxonomy field. Can be used to filter the response of the creatives.list method.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "detectedCategoriesTaxonomy": { + "description": "Output only. The taxonomy in which the detected_categories field is expressed.", + "enum": [ + "AD_CATEGORY_TAXONOMY_UNSPECIFIED", + "IAB_CONTENT_1_0" + ], + "enumDescriptions": [ + "Default value that should never be used.", + "IAB Content Taxonomy 1.0. See https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Content%20Taxonomies/Content%20Taxonomy%201.0.tsv for more details." + ], + "readOnly": true, + "type": "string" + }, "detectedClickThroughUrls": { "description": "The set of detected destination URLs for the creative. Can be used to filter the response of the creatives.list method.", "items": { diff --git a/realtimebidding/v1/realtimebidding-gen.go b/realtimebidding/v1/realtimebidding-gen.go index dca027540c6..d583d9dd456 100644 --- a/realtimebidding/v1/realtimebidding-gen.go +++ b/realtimebidding/v1/realtimebidding-gen.go @@ -976,6 +976,21 @@ type CreativeServingDecision struct { // "RENDERING_PLAYABLE" - The creative is considered a playable display // creative. DetectedAttributes []string `json:"detectedAttributes,omitempty"` + // DetectedCategories: Output only. IDs of the detected categories, if any. The + // taxonomy in which the categories are expressed is specified by the + // detected_categories_taxonomy field. Can be used to filter the response of + // the creatives.list method. + DetectedCategories []string `json:"detectedCategories,omitempty"` + // DetectedCategoriesTaxonomy: Output only. The taxonomy in which the + // detected_categories field is expressed. + // + // Possible values: + // "AD_CATEGORY_TAXONOMY_UNSPECIFIED" - Default value that should never be + // used. + // "IAB_CONTENT_1_0" - IAB Content Taxonomy 1.0. See + // https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Content%20Taxonomies/Content%20Taxonomy%201.0.tsv + // for more details. + DetectedCategoriesTaxonomy string `json:"detectedCategoriesTaxonomy,omitempty"` // DetectedClickThroughUrls: The set of detected destination URLs for the // creative. Can be used to filter the response of the creatives.list method. DetectedClickThroughUrls []string `json:"detectedClickThroughUrls,omitempty"` diff --git a/spanner/v1/spanner-api.json b/spanner/v1/spanner-api.json index 627c055d578..6669f96f8e0 100644 --- a/spanner/v1/spanner-api.json +++ b/spanner/v1/spanner-api.json @@ -1397,7 +1397,7 @@ "databases": { "methods": { "changequorum": { - "description": "ChangeQuorum is strictly restricted to databases that use dual region instance configurations. Initiates a background operation to change quorum a database from dual-region mode to single-region mode and vice versa. The returned long-running operation will have a name of the format `projects//instances//databases//operations/` and can be used to track execution of the ChangeQuorum. The metadata field type is ChangeQuorumMetadata. Authorization requires `spanner.databases.changequorum` permission on the resource database.", + "description": "`ChangeQuorum` is strictly restricted to databases that use dual-region instance configurations. Initiates a background operation to change the quorum of a database from dual-region mode to single-region mode or vice versa. The returned long-running operation has a name of the format `projects//instances//databases//operations/` and can be used to track execution of the `ChangeQuorum`. The metadata field type is ChangeQuorumMetadata. Authorization requires `spanner.databases.changequorum` permission on the resource database.", "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/databases/{databasesId}:changequorum", "httpMethod": "POST", "id": "spanner.projects.instances.databases.changequorum", @@ -1406,7 +1406,7 @@ ], "parameters": { "name": { - "description": "Required. Name of the database in which to apply the ChangeQuorum. Values are of the form `projects//instances//databases/`.", + "description": "Required. Name of the database in which to apply `ChangeQuorum`. Values are of the form `projects//instances//databases/`.", "location": "path", "pattern": "^projects/[^/]+/instances/[^/]+/databases/[^/]+$", "required": true, @@ -3254,7 +3254,7 @@ } } }, - "revision": "20240719", + "revision": "20240731", "rootUrl": "https://spanner.googleapis.com/", "schemas": { "AutoscalingConfig": { @@ -3635,16 +3635,16 @@ "id": "ChangeQuorumRequest", "properties": { "etag": { - "description": "Optional. The etag is the hash of the QuorumInfo. The ChangeQuorum operation will only be performed if the etag matches that of the QuorumInfo in the current database resource. Otherwise the API will return an `ABORTED` error. The etag is used for optimistic concurrency control as a way to help prevent simultaneous change quorum requests that could create a race condition.", + "description": "Optional. The etag is the hash of the `QuorumInfo`. The `ChangeQuorum` operation is only performed if the etag matches that of the `QuorumInfo` in the current database resource. Otherwise the API returns an `ABORTED` error. The etag is used for optimistic concurrency control as a way to help prevent simultaneous change quorum requests that could create a race condition.", "type": "string" }, "name": { - "description": "Required. Name of the database in which to apply the ChangeQuorum. Values are of the form `projects//instances//databases/`.", + "description": "Required. Name of the database in which to apply `ChangeQuorum`. Values are of the form `projects//instances//databases/`.", "type": "string" }, "quorumType": { "$ref": "QuorumType", - "description": "Required. The type of this Quorum." + "description": "Required. The type of this quorum." } }, "type": "object" @@ -4190,7 +4190,7 @@ }, "quorumInfo": { "$ref": "QuorumInfo", - "description": "Output only. Applicable only for databases that use dual region instance configurations. Contains information about the quorum.", + "description": "Output only. Applicable only for databases that use dual-region instance configurations. Contains information about the quorum.", "readOnly": true }, "reconciling": { @@ -4905,10 +4905,10 @@ "MULTI_REGION" ], "enumDescriptions": [ - "Not specified.", - "An instance configuration tagged with REGION quorum type forms a write quorum in a single region.", - "An instance configuration tagged with DUAL_REGION quorum type forms a write quorums with exactly two read-write regions in a multi-region configuration. This instance configurations requires reconfiguration in the event of regional failures.", - "An instance configuration tagged with MULTI_REGION quorum type forms a write quorums from replicas are spread across more than one region in a multi-region configuration." + "Quorum type not specified.", + "An instance configuration tagged with `REGION` quorum type forms a write quorum in a single region.", + "An instance configuration tagged with the `DUAL_REGION` quorum type forms a write quorum with exactly two read-write regions in a multi-region configuration. This instance configuration requires failover in the event of regional failures.", + "An instance configuration tagged with the `MULTI_REGION` quorum type forms a write quorum from replicas that are spread across more than one region in a multi-region configuration." ], "readOnly": true, "type": "string" @@ -5008,7 +5008,8 @@ "type": "integer" }, "referencingBackups": { - "description": "Output only. The names of the backups that reference this instance partition. Referencing backups should share the parent instance. The existence of any referencing backup prevents the instance partition from being deleted.", + "deprecated": true, + "description": "Output only. Deprecated: This field is not populated. Output only. The names of the backups that reference this instance partition. Referencing backups should share the parent instance. The existence of any referencing backup prevents the instance partition from being deleted.", "items": { "type": "string" }, @@ -6011,16 +6012,16 @@ "type": "object" }, "QuorumInfo": { - "description": "Information about the dual region quorum.", + "description": "Information about the dual-region quorum.", "id": "QuorumInfo", "properties": { "etag": { - "description": "Output only. The etag is used for optimistic concurrency control as a way to help prevent simultaneous ChangeQuorum requests that could create a race condition.", + "description": "Output only. The etag is used for optimistic concurrency control as a way to help prevent simultaneous `ChangeQuorum` requests that might create a race condition.", "readOnly": true, "type": "string" }, "initiator": { - "description": "Output only. Whether this ChangeQuorum is a Google or User initiated.", + "description": "Output only. Whether this `ChangeQuorum` is Google or User initiated.", "enum": [ "INITIATOR_UNSPECIFIED", "GOOGLE", @@ -6028,8 +6029,8 @@ ], "enumDescriptions": [ "Unspecified.", - "ChangeQuorum initiated by Google.", - "ChangeQuorum initiated by User." + "`ChangeQuorum` initiated by Google.", + "`ChangeQuorum` initiated by User." ], "readOnly": true, "type": "string" @@ -6049,16 +6050,16 @@ "type": "object" }, "QuorumType": { - "description": "Information about the database quorum type. this applies only for dual region instance configs.", + "description": "Information about the database quorum type. This only applies to dual-region instance configs.", "id": "QuorumType", "properties": { "dualRegion": { "$ref": "DualRegionQuorum", - "description": "Dual region quorum type." + "description": "Dual-region quorum type." }, "singleRegion": { "$ref": "SingleRegionQuorum", - "description": "Single region quorum type." + "description": "Single-region quorum type." } }, "type": "object" @@ -6620,7 +6621,7 @@ "id": "SingleRegionQuorum", "properties": { "servingLocation": { - "description": "Required. The location of the serving region, e.g. \"us-central1\". The location must be one of the regions within the dual region instance configuration of your database. The list of valid locations is available via [GetInstanceConfig[InstanceAdmin.GetInstanceConfig] API. This should only be used if you plan to change quorum in single-region quorum type.", + "description": "Required. The location of the serving region, e.g. \"us-central1\". The location must be one of the regions within the dual-region instance configuration of your database. The list of valid locations is available using the GetInstanceConfig API. This should only be used if you plan to change quorum to the single-region quorum type.", "type": "string" } }, diff --git a/spanner/v1/spanner-gen.go b/spanner/v1/spanner-gen.go index 7e44d0125ad..1f91797c0a5 100644 --- a/spanner/v1/spanner-gen.go +++ b/spanner/v1/spanner-gen.go @@ -997,17 +997,16 @@ func (s ChangeQuorumMetadata) MarshalJSON() ([]byte, error) { // ChangeQuorumRequest: The request for ChangeQuorum. type ChangeQuorumRequest struct { - // Etag: Optional. The etag is the hash of the QuorumInfo. The ChangeQuorum - // operation will only be performed if the etag matches that of the QuorumInfo - // in the current database resource. Otherwise the API will return an `ABORTED` - // error. The etag is used for optimistic concurrency control as a way to help - // prevent simultaneous change quorum requests that could create a race - // condition. + // Etag: Optional. The etag is the hash of the `QuorumInfo`. The `ChangeQuorum` + // operation is only performed if the etag matches that of the `QuorumInfo` in + // the current database resource. Otherwise the API returns an `ABORTED` error. + // The etag is used for optimistic concurrency control as a way to help prevent + // simultaneous change quorum requests that could create a race condition. Etag string `json:"etag,omitempty"` - // Name: Required. Name of the database in which to apply the ChangeQuorum. + // Name: Required. Name of the database in which to apply `ChangeQuorum`. // Values are of the form `projects//instances//databases/`. Name string `json:"name,omitempty"` - // QuorumType: Required. The type of this Quorum. + // QuorumType: Required. The type of this quorum. QuorumType *QuorumType `json:"quorumType,omitempty"` // ForceSendFields is a list of field names (e.g. "Etag") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -1814,7 +1813,7 @@ type Database struct { // DATABASE` statement. This name can be passed to other API methods to // identify the database. Name string `json:"name,omitempty"` - // QuorumInfo: Output only. Applicable only for databases that use dual region + // QuorumInfo: Output only. Applicable only for databases that use dual-region // instance configurations. Contains information about the quorum. QuorumInfo *QuorumInfo `json:"quorumInfo,omitempty"` // Reconciling: Output only. If true, the database is being updated. If false, @@ -2860,16 +2859,16 @@ type InstanceConfig struct { // QuorumType: Output only. The `QuorumType` of the instance configuration. // // Possible values: - // "QUORUM_TYPE_UNSPECIFIED" - Not specified. - // "REGION" - An instance configuration tagged with REGION quorum type forms - // a write quorum in a single region. - // "DUAL_REGION" - An instance configuration tagged with DUAL_REGION quorum - // type forms a write quorums with exactly two read-write regions in a - // multi-region configuration. This instance configurations requires - // reconfiguration in the event of regional failures. - // "MULTI_REGION" - An instance configuration tagged with MULTI_REGION quorum - // type forms a write quorums from replicas are spread across more than one - // region in a multi-region configuration. + // "QUORUM_TYPE_UNSPECIFIED" - Quorum type not specified. + // "REGION" - An instance configuration tagged with `REGION` quorum type + // forms a write quorum in a single region. + // "DUAL_REGION" - An instance configuration tagged with the `DUAL_REGION` + // quorum type forms a write quorum with exactly two read-write regions in a + // multi-region configuration. This instance configuration requires failover in + // the event of regional failures. + // "MULTI_REGION" - An instance configuration tagged with the `MULTI_REGION` + // quorum type forms a write quorum from replicas that are spread across more + // than one region in a multi-region configuration. QuorumType string `json:"quorumType,omitempty"` // Reconciling: Output only. If true, the instance configuration is being // created or updated. If false, there are no ongoing operations for the @@ -2985,10 +2984,11 @@ type InstancePartition struct { // be zero in API responses for instance partitions that are not yet in the // `READY` state. ProcessingUnits int64 `json:"processingUnits,omitempty"` - // ReferencingBackups: Output only. The names of the backups that reference - // this instance partition. Referencing backups should share the parent - // instance. The existence of any referencing backup prevents the instance - // partition from being deleted. + // ReferencingBackups: Output only. Deprecated: This field is not populated. + // Output only. The names of the backups that reference this instance + // partition. Referencing backups should share the parent instance. The + // existence of any referencing backup prevents the instance partition from + // being deleted. ReferencingBackups []string `json:"referencingBackups,omitempty"` // ReferencingDatabases: Output only. The names of the databases that reference // this instance partition. Referencing databases should share the parent @@ -4542,19 +4542,19 @@ func (s QueryPlan) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// QuorumInfo: Information about the dual region quorum. +// QuorumInfo: Information about the dual-region quorum. type QuorumInfo struct { // Etag: Output only. The etag is used for optimistic concurrency control as a - // way to help prevent simultaneous ChangeQuorum requests that could create a + // way to help prevent simultaneous `ChangeQuorum` requests that might create a // race condition. Etag string `json:"etag,omitempty"` - // Initiator: Output only. Whether this ChangeQuorum is a Google or User + // Initiator: Output only. Whether this `ChangeQuorum` is Google or User // initiated. // // Possible values: // "INITIATOR_UNSPECIFIED" - Unspecified. - // "GOOGLE" - ChangeQuorum initiated by Google. - // "USER" - ChangeQuorum initiated by User. + // "GOOGLE" - `ChangeQuorum` initiated by Google. + // "USER" - `ChangeQuorum` initiated by User. Initiator string `json:"initiator,omitempty"` // QuorumType: Output only. The type of this quorum. See QuorumType for more // information about quorum type specifications. @@ -4579,12 +4579,12 @@ func (s QuorumInfo) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// QuorumType: Information about the database quorum type. this applies only -// for dual region instance configs. +// QuorumType: Information about the database quorum type. This only applies to +// dual-region instance configs. type QuorumType struct { - // DualRegion: Dual region quorum type. + // DualRegion: Dual-region quorum type. DualRegion *DualRegionQuorum `json:"dualRegion,omitempty"` - // SingleRegion: Single region quorum type. + // SingleRegion: Single-region quorum type. SingleRegion *SingleRegionQuorum `json:"singleRegion,omitempty"` // ForceSendFields is a list of field names (e.g. "DualRegion") to // unconditionally include in API requests. By default, fields with empty or @@ -5408,11 +5408,10 @@ func (s ShortRepresentation) MarshalJSON() ([]byte, error) { // SingleRegionQuorum: Message type for a single-region quorum. type SingleRegionQuorum struct { // ServingLocation: Required. The location of the serving region, e.g. - // "us-central1". The location must be one of the regions within the dual - // region instance configuration of your database. The list of valid locations - // is available via [GetInstanceConfig[InstanceAdmin.GetInstanceConfig] API. - // This should only be used if you plan to change quorum in single-region - // quorum type. + // "us-central1". The location must be one of the regions within the + // dual-region instance configuration of your database. The list of valid + // locations is available using the GetInstanceConfig API. This should only be + // used if you plan to change quorum to the single-region quorum type. ServingLocation string `json:"servingLocation,omitempty"` // ForceSendFields is a list of field names (e.g. "ServingLocation") to // unconditionally include in API requests. By default, fields with empty or @@ -11164,17 +11163,17 @@ type ProjectsInstancesDatabasesChangequorumCall struct { header_ http.Header } -// Changequorum: ChangeQuorum is strictly restricted to databases that use dual -// region instance configurations. Initiates a background operation to change -// quorum a database from dual-region mode to single-region mode and vice -// versa. The returned long-running operation will have a name of the format +// Changequorum: `ChangeQuorum` is strictly restricted to databases that use +// dual-region instance configurations. Initiates a background operation to +// change the quorum of a database from dual-region mode to single-region mode +// or vice versa. The returned long-running operation has a name of the format // `projects//instances//databases//operations/` and can be used to track -// execution of the ChangeQuorum. The metadata field type is +// execution of the `ChangeQuorum`. The metadata field type is // ChangeQuorumMetadata. Authorization requires // `spanner.databases.changequorum` permission on the resource database. // -// - name: Name of the database in which to apply the ChangeQuorum. Values are -// of the form `projects//instances//databases/`. +// - name: Name of the database in which to apply `ChangeQuorum`. Values are of +// the form `projects//instances//databases/`. func (r *ProjectsInstancesDatabasesService) Changequorum(name string, changequorumrequest *ChangeQuorumRequest) *ProjectsInstancesDatabasesChangequorumCall { c := &ProjectsInstancesDatabasesChangequorumCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name