From 5961a808339969bdfbe0f2eee836fe308000db29 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Sat, 1 Mar 2025 08:11:58 +0000 Subject: [PATCH] feat(all): auto-regenerate discovery clients --- alloydb/v1beta/alloydb-api.json | 308 +++- alloydb/v1beta/alloydb-gen.go | 260 +++- areainsights/v1/areainsights-api.json | 8 +- areainsights/v1/areainsights-gen.go | 8 +- .../v1/bigqueryreservation-api.json | 23 +- .../v1/bigqueryreservation-gen.go | 76 + datastream/v1/datastream-api.json | 4 +- datastream/v1/datastream-gen.go | 2 +- dialogflow/v3/dialogflow-api.json | 22 +- dialogflow/v3/dialogflow-gen.go | 28 +- dlp/v2/dlp-api.json | 6 +- dlp/v2/dlp-gen.go | 6 +- fcm/v1/fcm-api.json | 6 +- fcm/v1/fcm-gen.go | 12 +- firebase/v1beta1/firebase-api.json | 4 +- firebase/v1beta1/firebase-gen.go | 3 +- .../v1beta1/networksecurity-api.json | 573 +++++--- .../v1beta1/networksecurity-gen.go | 1303 +++++++++-------- pubsub/v1/pubsub-api.json | 12 +- pubsub/v1/pubsub-gen.go | 10 +- run/v2/run-api.json | 11 +- run/v2/run-gen.go | 4 + securitycenter/v1/securitycenter-api.json | 10 +- securitycenter/v1/securitycenter-gen.go | 4 + .../v1beta1/securitycenter-api.json | 10 +- securitycenter/v1beta1/securitycenter-gen.go | 4 + .../v1beta2/securitycenter-api.json | 10 +- securitycenter/v1beta2/securitycenter-gen.go | 4 + sqladmin/v1/sqladmin-api.json | 18 +- sqladmin/v1/sqladmin-gen.go | 15 +- storage/v1/storage-api.json | 12 +- storage/v1/storage-gen.go | 86 +- workspaceevents/v1/workspaceevents-api.json | 4 +- workspaceevents/v1/workspaceevents-gen.go | 6 +- 34 files changed, 1862 insertions(+), 1010 deletions(-) diff --git a/alloydb/v1beta/alloydb-api.json b/alloydb/v1beta/alloydb-api.json index ca6c5e02ea5..ba880e5d61d 100644 --- a/alloydb/v1beta/alloydb-api.json +++ b/alloydb/v1beta/alloydb-api.json @@ -1581,6 +1581,21 @@ "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "type": "string" + }, + "scope": { + "description": "Optional. The scope for which supported flags are requested. If not specified, default is DATABASE.", + "enum": [ + "SCOPE_UNSPECIFIED", + "DATABASE", + "CONNECTION_POOL" + ], + "enumDescriptions": [ + "The scope of the flag is not specified. Default is DATABASE.", + "The flag is a database flag.", + "The flag is a connection pool flag." + ], + "location": "query", + "type": "string" } }, "path": "v1beta/{+parent}/supportedDatabaseFlags", @@ -1598,7 +1613,7 @@ } } }, - "revision": "20250205", + "revision": "20250219", "rootUrl": "https://alloydb.googleapis.com/", "schemas": { "AuthorizedNetwork": { @@ -2291,7 +2306,7 @@ }, "encryptionConfig": { "$ref": "EncryptionConfig", - "description": "The encryption config can be specified to encrypt the backups with a customer-managed encryption key (CMEK). When this field is not specified, the backup will then use default encryption scheme to protect the user data." + "description": "The encryption config can be specified to encrypt the backups with a customer-managed encryption key (CMEK). When this field is not specified, the backup will use the cluster's encryption config." }, "recoveryWindowDays": { "description": "The number of days that are eligible to restore from using PITR. To support the entire recovery window, backups and logs are retained for one day more than the recovery window. If not set, defaults to 14 days.", @@ -3223,7 +3238,7 @@ "type": "object" }, "Node": { - "description": "Details of a single node in the instance. Nodes in an AlloyDB instance are ephemereal, they can change during update, failover, autohealing and resize operations.", + "description": "Details of a single node in the instance. Nodes in an AlloyDB instance are ephemeral, they can change during update, failover, autohealing and resize operations.", "id": "Node", "properties": { "id": { @@ -3366,6 +3381,11 @@ "readOnly": true, "type": "string" }, + "upgradeClusterStatus": { + "$ref": "UpgradeClusterStatus", + "description": "Output only. UpgradeClusterStatus related metadata.", + "readOnly": true + }, "verb": { "description": "Output only. Name of the verb executed by the operation.", "readOnly": true, @@ -3408,6 +3428,36 @@ }, "type": "object" }, + "PscAutoConnectionConfig": { + "description": "Configuration for setting up PSC service automation. Consumer projects in the configs will be allowlisted automatically for the instance.", + "id": "PscAutoConnectionConfig", + "properties": { + "consumerNetwork": { + "description": "The consumer network for the PSC service automation, example: \"projects/vpc-host-project/global/networks/default\". The consumer network might be hosted a different project than the consumer project.", + "type": "string" + }, + "consumerNetworkStatus": { + "description": "Output only. The status of the service connection policy.", + "readOnly": true, + "type": "string" + }, + "consumerProject": { + "description": "The consumer project to which the PSC service automation endpoint will be created.", + "type": "string" + }, + "ipAddress": { + "description": "Output only. The IP address of the PSC service automation endpoint.", + "readOnly": true, + "type": "string" + }, + "status": { + "description": "Output only. The status of the PSC service automation connection.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "PscConfig": { "description": "PscConfig contains PSC related configuration at a cluster level.", "id": "PscConfig", @@ -3436,6 +3486,13 @@ }, "type": "array" }, + "pscAutoConnections": { + "description": "Optional. Configurations for setting up PSC service automation.", + "items": { + "$ref": "PscAutoConnectionConfig" + }, + "type": "array" + }, "pscDnsName": { "description": "Output only. The DNS name of the instance for PSC connectivity. Name convention: ...alloydb-psc.goog", "readOnly": true, @@ -3535,6 +3592,17 @@ }, "type": "object" }, + "ReadPoolInstancesUpgradeStageStatus": { + "description": "Read pool instances upgrade specific status.", + "id": "ReadPoolInstancesUpgradeStageStatus", + "properties": { + "upgradeStats": { + "$ref": "Stats", + "description": "Read pool instances upgrade statistics." + } + }, + "type": "object" + }, "RestartInstanceRequest": { "id": "RestartInstanceRequest", "properties": { @@ -3755,6 +3823,92 @@ }, "type": "object" }, + "StageStatus": { + "description": "Status of an upgrade stage.", + "id": "StageStatus", + "properties": { + "readPoolInstancesUpgrade": { + "$ref": "ReadPoolInstancesUpgradeStageStatus", + "description": "Read pool instances upgrade metadata." + }, + "stage": { + "description": "Upgrade stage.", + "enum": [ + "STAGE_UNSPECIFIED", + "ALLOYDB_PRECHECK", + "PG_UPGRADE_CHECK", + "PREPARE_FOR_UPGRADE", + "PRIMARY_INSTANCE_UPGRADE", + "READ_POOL_INSTANCES_UPGRADE", + "ROLLBACK", + "CLEANUP" + ], + "enumDescriptions": [ + "Unspecified stage.", + "Pre-upgrade custom checks, not covered by pg_upgrade.", + "Pre-upgrade pg_upgrade checks.", + "Clone the original cluster.", + "Upgrade the primary instance(downtime).", + "This stage is read pool upgrade.", + "Rollback in case of critical failures.", + "Cleanup." + ], + "type": "string" + }, + "state": { + "description": "State of this stage.", + "enum": [ + "STATUS_UNSPECIFIED", + "NOT_STARTED", + "IN_PROGRESS", + "SUCCESS", + "FAILED", + "PARTIAL_SUCCESS", + "CANCEL_IN_PROGRESS", + "CANCELLED" + ], + "enumDescriptions": [ + "Unspecified status.", + "Not started.", + "In progress.", + "Operation succeeded.", + "Operation failed.", + "Operation partially succeeded.", + "Cancel is in progress.", + "Cancellation complete." + ], + "type": "string" + } + }, + "type": "object" + }, + "Stats": { + "description": "Upgrade stats for read pool instances.", + "id": "Stats", + "properties": { + "failed": { + "description": "Number of read pool instances which failed to upgrade.", + "format": "int32", + "type": "integer" + }, + "notStarted": { + "description": "Number of read pool instances for which upgrade has not started.", + "format": "int32", + "type": "integer" + }, + "ongoing": { + "description": "Number of read pool instances undergoing upgrade.", + "format": "int32", + "type": "integer" + }, + "success": { + "description": "Number of read pool instances successfully upgraded.", + "format": "int32", + "type": "integer" + } + }, + "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", @@ -4148,7 +4302,8 @@ "SIGNAL_TYPE_RESOURCE_SUSPENDED", "SIGNAL_TYPE_EXPENSIVE_COMMANDS", "SIGNAL_TYPE_NO_MAINTENANCE_POLICY_CONFIGURED", - "SIGNAL_TYPE_NO_DELETION_PROTECTION" + "SIGNAL_TYPE_NO_DELETION_PROTECTION", + "SIGNAL_TYPE_INEFFICIENT_QUERY" ], "enumDeprecated": [ false, @@ -4237,6 +4392,7 @@ false, false, false, + false, false ], "enumDescriptions": [ @@ -4326,7 +4482,8 @@ "Detects if a database instance/cluster is suspended.", "Detects that expensive commands are being run on a database instance impacting overall performance.", "Indicates that the instance does not have a maintenance policy configured.", - "Deletion Protection Disabled for the resource" + "Deletion Protection Disabled for the resource", + "Indicates that the instance has inefficient queries detected." ], "type": "string" }, @@ -4390,7 +4547,7 @@ "type": "object" }, "StorageDatabasecenterPartnerapiV1mainDatabaseResourceMetadata": { - "description": "Common model for database resource instance metadata. Next ID: 24", + "description": "Common model for database resource instance metadata. Next ID: 25", "id": "StorageDatabasecenterPartnerapiV1mainDatabaseResourceMetadata", "properties": { "availabilityConfiguration": { @@ -4475,6 +4632,10 @@ ], "type": "string" }, + "gcbdrConfiguration": { + "$ref": "StorageDatabasecenterPartnerapiV1mainGCBDRConfiguration", + "description": "GCBDR configuration for the resource." + }, "id": { "$ref": "StorageDatabasecenterPartnerapiV1mainDatabaseResourceId", "description": "Required. Unique identifier for a Database resource" @@ -4551,7 +4712,7 @@ "type": "string" }, "suspensionReason": { - "description": "Suspension reason for the resource.", + "description": "Optional. Suspension reason for the resource.", "enum": [ "SUSPENSION_REASON_UNSPECIFIED", "WIPEOUT_HIDE_EVENT", @@ -4730,7 +4891,8 @@ "SIGNAL_TYPE_RESOURCE_SUSPENDED", "SIGNAL_TYPE_EXPENSIVE_COMMANDS", "SIGNAL_TYPE_NO_MAINTENANCE_POLICY_CONFIGURED", - "SIGNAL_TYPE_NO_DELETION_PROTECTION" + "SIGNAL_TYPE_NO_DELETION_PROTECTION", + "SIGNAL_TYPE_INEFFICIENT_QUERY" ], "enumDeprecated": [ false, @@ -4819,6 +4981,7 @@ false, false, false, + false, false ], "enumDescriptions": [ @@ -4908,7 +5071,8 @@ "Detects if a database instance/cluster is suspended.", "Detects that expensive commands are being run on a database instance impacting overall performance.", "Indicates that the instance does not have a maintenance policy configured.", - "Deletion Protection Disabled for the resource" + "Deletion Protection Disabled for the resource", + "Indicates that the instance has inefficient queries detected." ], "type": "string" } @@ -4958,6 +5122,17 @@ }, "type": "object" }, + "StorageDatabasecenterPartnerapiV1mainGCBDRConfiguration": { + "description": "GCBDR Configuration for the resource.", + "id": "StorageDatabasecenterPartnerapiV1mainGCBDRConfiguration", + "properties": { + "gcbdrManaged": { + "description": "Whether the resource is managed by GCBDR.", + "type": "boolean" + } + }, + "type": "object" + }, "StorageDatabasecenterPartnerapiV1mainInternalResourceMetadata": { "description": "Metadata for individual internal resources in an instance. e.g. spanner instance can have multiple databases with unique configuration settings. Similarly bigtable can have multiple clusters within same bigtable instance.", "id": "StorageDatabasecenterPartnerapiV1mainInternalResourceMetadata", @@ -5358,10 +5533,33 @@ "description": "The name of the flag resource, following Google Cloud conventions, e.g.: * projects/{project}/locations/{location}/flags/{flag} This field currently has no semantic meaning.", "type": "string" }, + "recommendedIntegerValue": { + "description": "The recommended value for an INTEGER flag.", + "format": "int64", + "type": "string" + }, + "recommendedStringValue": { + "description": "The recommended value for a STRING flag.", + "type": "string" + }, "requiresDbRestart": { "description": "Whether setting or updating this flag on an Instance requires a database restart. If a flag that requires database restart is set, the backend will automatically restart the database (making sure to satisfy any availability SLO's).", "type": "boolean" }, + "scope": { + "description": "The scope of the flag.", + "enum": [ + "SCOPE_UNSPECIFIED", + "DATABASE", + "CONNECTION_POOL" + ], + "enumDescriptions": [ + "The scope of the flag is not specified. Default is DATABASE.", + "The flag is a database flag.", + "The flag is a connection pool flag." + ], + "type": "string" + }, "stringRestrictions": { "$ref": "StringRestrictions", "description": "Restriction on STRING type value." @@ -5575,6 +5773,98 @@ }, "type": "object" }, + "UpgradeClusterStatus": { + "description": "Message for current status of the Major Version Upgrade operation.", + "id": "UpgradeClusterStatus", + "properties": { + "cancellable": { + "description": "Whether the operation is cancellable.", + "type": "boolean" + }, + "sourceVersion": { + "description": "Source database major version.", + "enum": [ + "DATABASE_VERSION_UNSPECIFIED", + "POSTGRES_13", + "POSTGRES_14", + "POSTGRES_15", + "POSTGRES_16" + ], + "enumDeprecated": [ + false, + true, + false, + false, + false + ], + "enumDescriptions": [ + "This is an unknown database version.", + "DEPRECATED - The database version is Postgres 13.", + "The database version is Postgres 14.", + "The database version is Postgres 15.", + "The database version is Postgres 16." + ], + "type": "string" + }, + "stages": { + "description": "Status of all upgrade stages.", + "items": { + "$ref": "StageStatus" + }, + "type": "array" + }, + "state": { + "description": "Cluster Major Version Upgrade state.", + "enum": [ + "STATUS_UNSPECIFIED", + "NOT_STARTED", + "IN_PROGRESS", + "SUCCESS", + "FAILED", + "PARTIAL_SUCCESS", + "CANCEL_IN_PROGRESS", + "CANCELLED" + ], + "enumDescriptions": [ + "Unspecified status.", + "Not started.", + "In progress.", + "Operation succeeded.", + "Operation failed.", + "Operation partially succeeded.", + "Cancel is in progress.", + "Cancellation complete." + ], + "type": "string" + }, + "targetVersion": { + "description": "Target database major version.", + "enum": [ + "DATABASE_VERSION_UNSPECIFIED", + "POSTGRES_13", + "POSTGRES_14", + "POSTGRES_15", + "POSTGRES_16" + ], + "enumDeprecated": [ + false, + true, + false, + false, + false + ], + "enumDescriptions": [ + "This is an unknown database version.", + "DEPRECATED - The database version is Postgres 13.", + "The database version is Postgres 14.", + "The database version is Postgres 15.", + "The database version is Postgres 16." + ], + "type": "string" + } + }, + "type": "object" + }, "User": { "description": "Message describing User object.", "id": "User", diff --git a/alloydb/v1beta/alloydb-gen.go b/alloydb/v1beta/alloydb-gen.go index bb48f05165b..7c88339b1d8 100644 --- a/alloydb/v1beta/alloydb-gen.go +++ b/alloydb/v1beta/alloydb-gen.go @@ -842,8 +842,7 @@ type ContinuousBackupConfig struct { Enabled bool `json:"enabled,omitempty"` // EncryptionConfig: The encryption config can be specified to encrypt the // backups with a customer-managed encryption key (CMEK). When this field is - // not specified, the backup will then use default encryption scheme to protect - // the user data. + // not specified, the backup will use the cluster's encryption config. EncryptionConfig *EncryptionConfig `json:"encryptionConfig,omitempty"` // RecoveryWindowDays: The number of days that are eligible to restore from // using PITR. To support the entire recovery window, backups and logs are @@ -2027,7 +2026,7 @@ func (s NetworkConfig) MarshalJSON() ([]byte, error) { } // Node: Details of a single node in the instance. Nodes in an AlloyDB instance -// are ephemereal, they can change during update, failover, autohealing and +// are ephemeral, they can change during update, failover, autohealing and // resize operations. type Node struct { // Id: Output only. The identifier of the VM e.g. @@ -2175,6 +2174,8 @@ type OperationMetadata struct { // Target: Output only. Server-defined resource path for the target of the // operation. Target string `json:"target,omitempty"` + // UpgradeClusterStatus: Output only. UpgradeClusterStatus related metadata. + UpgradeClusterStatus *UpgradeClusterStatus `json:"upgradeClusterStatus,omitempty"` // Verb: Output only. Name of the verb executed by the operation. Verb string `json:"verb,omitempty"` // ForceSendFields is a list of field names (e.g. "ApiVersion") to @@ -2260,6 +2261,43 @@ func (s PromoteClusterRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// PscAutoConnectionConfig: Configuration for setting up PSC service +// automation. Consumer projects in the configs will be allowlisted +// automatically for the instance. +type PscAutoConnectionConfig struct { + // ConsumerNetwork: The consumer network for the PSC service automation, + // example: "projects/vpc-host-project/global/networks/default". The consumer + // network might be hosted a different project than the consumer project. + ConsumerNetwork string `json:"consumerNetwork,omitempty"` + // ConsumerNetworkStatus: Output only. The status of the service connection + // policy. + ConsumerNetworkStatus string `json:"consumerNetworkStatus,omitempty"` + // ConsumerProject: The consumer project to which the PSC service automation + // endpoint will be created. + ConsumerProject string `json:"consumerProject,omitempty"` + // IpAddress: Output only. The IP address of the PSC service automation + // endpoint. + IpAddress string `json:"ipAddress,omitempty"` + // Status: Output only. The status of the PSC service automation connection. + Status string `json:"status,omitempty"` + // ForceSendFields is a list of field names (e.g. "ConsumerNetwork") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ConsumerNetwork") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s PscAutoConnectionConfig) MarshalJSON() ([]byte, error) { + type NoMethod PscAutoConnectionConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // PscConfig: PscConfig contains PSC related configuration at a cluster level. type PscConfig struct { // PscEnabled: Optional. Create an instance that allows connections from @@ -2292,6 +2330,9 @@ type PscInstanceConfig struct { // AllowedConsumerProjects: Optional. List of consumer projects that are // allowed to create PSC endpoints to service-attachments to this instance. AllowedConsumerProjects []string `json:"allowedConsumerProjects,omitempty"` + // PscAutoConnections: Optional. Configurations for setting up PSC service + // automation. + PscAutoConnections []*PscAutoConnectionConfig `json:"pscAutoConnections,omitempty"` // PscDnsName: Output only. The DNS name of the instance for PSC connectivity. // Name convention: ...alloydb-psc.goog PscDnsName string `json:"pscDnsName,omitempty"` @@ -2462,6 +2503,29 @@ func (s ReadPoolConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ReadPoolInstancesUpgradeStageStatus: Read pool instances upgrade specific +// status. +type ReadPoolInstancesUpgradeStageStatus struct { + // UpgradeStats: Read pool instances upgrade statistics. + UpgradeStats *Stats `json:"upgradeStats,omitempty"` + // ForceSendFields is a list of field names (e.g. "UpgradeStats") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "UpgradeStats") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ReadPoolInstancesUpgradeStageStatus) MarshalJSON() ([]byte, error) { + type NoMethod ReadPoolInstancesUpgradeStageStatus + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type RestartInstanceRequest struct { // NodeIds: Optional. Full name of the nodes as obtained from // INSTANCE_VIEW_FULL to restart upon. Applicable only to read instances. @@ -2728,6 +2792,80 @@ func (s StageInfo) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// StageStatus: Status of an upgrade stage. +type StageStatus struct { + // ReadPoolInstancesUpgrade: Read pool instances upgrade metadata. + ReadPoolInstancesUpgrade *ReadPoolInstancesUpgradeStageStatus `json:"readPoolInstancesUpgrade,omitempty"` + // Stage: Upgrade stage. + // + // Possible values: + // "STAGE_UNSPECIFIED" - Unspecified stage. + // "ALLOYDB_PRECHECK" - Pre-upgrade custom checks, not covered by pg_upgrade. + // "PG_UPGRADE_CHECK" - Pre-upgrade pg_upgrade checks. + // "PREPARE_FOR_UPGRADE" - Clone the original cluster. + // "PRIMARY_INSTANCE_UPGRADE" - Upgrade the primary instance(downtime). + // "READ_POOL_INSTANCES_UPGRADE" - This stage is read pool upgrade. + // "ROLLBACK" - Rollback in case of critical failures. + // "CLEANUP" - Cleanup. + Stage string `json:"stage,omitempty"` + // State: State of this stage. + // + // Possible values: + // "STATUS_UNSPECIFIED" - Unspecified status. + // "NOT_STARTED" - Not started. + // "IN_PROGRESS" - In progress. + // "SUCCESS" - Operation succeeded. + // "FAILED" - Operation failed. + // "PARTIAL_SUCCESS" - Operation partially succeeded. + // "CANCEL_IN_PROGRESS" - Cancel is in progress. + // "CANCELLED" - Cancellation complete. + State string `json:"state,omitempty"` + // ForceSendFields is a list of field names (e.g. "ReadPoolInstancesUpgrade") + // to unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ReadPoolInstancesUpgrade") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s StageStatus) MarshalJSON() ([]byte, error) { + type NoMethod StageStatus + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// Stats: Upgrade stats for read pool instances. +type Stats struct { + // Failed: Number of read pool instances which failed to upgrade. + Failed int64 `json:"failed,omitempty"` + // NotStarted: Number of read pool instances for which upgrade has not started. + NotStarted int64 `json:"notStarted,omitempty"` + // Ongoing: Number of read pool instances undergoing upgrade. + Ongoing int64 `json:"ongoing,omitempty"` + // Success: Number of read pool instances successfully upgraded. + Success int64 `json:"success,omitempty"` + // ForceSendFields is a list of field names (e.g. "Failed") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Failed") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s Stats) MarshalJSON() ([]byte, error) { + type NoMethod Stats + 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 @@ -3248,6 +3386,8 @@ type StorageDatabasecenterPartnerapiV1mainDatabaseResourceHealthSignalData struc // instance does not have a maintenance policy configured. // "SIGNAL_TYPE_NO_DELETION_PROTECTION" - Deletion Protection Disabled for // the resource + // "SIGNAL_TYPE_INEFFICIENT_QUERY" - Indicates that the instance has + // inefficient queries detected. SignalType string `json:"signalType,omitempty"` // Possible values: // "STATE_UNSPECIFIED" - Unspecified state. @@ -3327,7 +3467,7 @@ func (s StorageDatabasecenterPartnerapiV1mainDatabaseResourceId) MarshalJSON() ( } // StorageDatabasecenterPartnerapiV1mainDatabaseResourceMetadata: Common model -// for database resource instance metadata. Next ID: 24 +// for database resource instance metadata. Next ID: 25 type StorageDatabasecenterPartnerapiV1mainDatabaseResourceMetadata struct { // AvailabilityConfiguration: Availability configuration for this instance AvailabilityConfiguration *StorageDatabasecenterPartnerapiV1mainAvailabilityConfiguration `json:"availabilityConfiguration,omitempty"` @@ -3376,6 +3516,8 @@ type StorageDatabasecenterPartnerapiV1mainDatabaseResourceMetadata struct { // "DELETED" - Instance is deleted. // "STATE_OTHER" - For rest of the other category ExpectedState string `json:"expectedState,omitempty"` + // GcbdrConfiguration: GCBDR configuration for the resource. + GcbdrConfiguration *StorageDatabasecenterPartnerapiV1mainGCBDRConfiguration `json:"gcbdrConfiguration,omitempty"` // Id: Required. Unique identifier for a Database resource Id *StorageDatabasecenterPartnerapiV1mainDatabaseResourceId `json:"id,omitempty"` // InstanceType: The type of the instance. Specified at creation time. @@ -3421,7 +3563,7 @@ type StorageDatabasecenterPartnerapiV1mainDatabaseResourceMetadata struct { // the same source. Resource name to follow CAIS resource_name format as noted // here go/condor-common-datamodel ResourceName string `json:"resourceName,omitempty"` - // SuspensionReason: Suspension reason for the resource. + // SuspensionReason: Optional. Suspension reason for the resource. // // Possible values: // "SUSPENSION_REASON_UNSPECIFIED" - Suspension reason is unspecified. @@ -3707,6 +3849,8 @@ type StorageDatabasecenterPartnerapiV1mainDatabaseResourceRecommendationSignalDa // instance does not have a maintenance policy configured. // "SIGNAL_TYPE_NO_DELETION_PROTECTION" - Deletion Protection Disabled for // the resource + // "SIGNAL_TYPE_INEFFICIENT_QUERY" - Indicates that the instance has + // inefficient queries detected. SignalType string `json:"signalType,omitempty"` // ForceSendFields is a list of field names (e.g. "AdditionalMetadata") to // unconditionally include in API requests. By default, fields with empty or @@ -3768,6 +3912,29 @@ func (s StorageDatabasecenterPartnerapiV1mainEntitlement) MarshalJSON() ([]byte, return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// StorageDatabasecenterPartnerapiV1mainGCBDRConfiguration: GCBDR Configuration +// for the resource. +type StorageDatabasecenterPartnerapiV1mainGCBDRConfiguration struct { + // GcbdrManaged: Whether the resource is managed by GCBDR. + GcbdrManaged bool `json:"gcbdrManaged,omitempty"` + // ForceSendFields is a list of field names (e.g. "GcbdrManaged") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "GcbdrManaged") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s StorageDatabasecenterPartnerapiV1mainGCBDRConfiguration) MarshalJSON() ([]byte, error) { + type NoMethod StorageDatabasecenterPartnerapiV1mainGCBDRConfiguration + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // StorageDatabasecenterPartnerapiV1mainInternalResourceMetadata: Metadata for // individual internal resources in an instance. e.g. spanner instance can have // multiple databases with unique configuration settings. Similarly bigtable @@ -4186,11 +4353,23 @@ type SupportedDatabaseFlag struct { // e.g.: * projects/{project}/locations/{location}/flags/{flag} This field // currently has no semantic meaning. Name string `json:"name,omitempty"` + // RecommendedIntegerValue: The recommended value for an INTEGER flag. + RecommendedIntegerValue int64 `json:"recommendedIntegerValue,omitempty,string"` + // RecommendedStringValue: The recommended value for a STRING flag. + RecommendedStringValue string `json:"recommendedStringValue,omitempty"` // RequiresDbRestart: Whether setting or updating this flag on an Instance // requires a database restart. If a flag that requires database restart is // set, the backend will automatically restart the database (making sure to // satisfy any availability SLO's). RequiresDbRestart bool `json:"requiresDbRestart,omitempty"` + // Scope: The scope of the flag. + // + // Possible values: + // "SCOPE_UNSPECIFIED" - The scope of the flag is not specified. Default is + // DATABASE. + // "DATABASE" - The flag is a database flag. + // "CONNECTION_POOL" - The flag is a connection pool flag. + Scope string `json:"scope,omitempty"` // StringRestrictions: Restriction on STRING type value. StringRestrictions *StringRestrictions `json:"stringRestrictions,omitempty"` // SupportedDbVersions: Major database engine versions for which this flag is @@ -4432,6 +4611,61 @@ func (s UpgradeClusterResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// UpgradeClusterStatus: Message for current status of the Major Version +// Upgrade operation. +type UpgradeClusterStatus struct { + // Cancellable: Whether the operation is cancellable. + Cancellable bool `json:"cancellable,omitempty"` + // SourceVersion: Source database major version. + // + // Possible values: + // "DATABASE_VERSION_UNSPECIFIED" - This is an unknown database version. + // "POSTGRES_13" - DEPRECATED - The database version is Postgres 13. + // "POSTGRES_14" - The database version is Postgres 14. + // "POSTGRES_15" - The database version is Postgres 15. + // "POSTGRES_16" - The database version is Postgres 16. + SourceVersion string `json:"sourceVersion,omitempty"` + // Stages: Status of all upgrade stages. + Stages []*StageStatus `json:"stages,omitempty"` + // State: Cluster Major Version Upgrade state. + // + // Possible values: + // "STATUS_UNSPECIFIED" - Unspecified status. + // "NOT_STARTED" - Not started. + // "IN_PROGRESS" - In progress. + // "SUCCESS" - Operation succeeded. + // "FAILED" - Operation failed. + // "PARTIAL_SUCCESS" - Operation partially succeeded. + // "CANCEL_IN_PROGRESS" - Cancel is in progress. + // "CANCELLED" - Cancellation complete. + State string `json:"state,omitempty"` + // TargetVersion: Target database major version. + // + // Possible values: + // "DATABASE_VERSION_UNSPECIFIED" - This is an unknown database version. + // "POSTGRES_13" - DEPRECATED - The database version is Postgres 13. + // "POSTGRES_14" - The database version is Postgres 14. + // "POSTGRES_15" - The database version is Postgres 15. + // "POSTGRES_16" - The database version is Postgres 16. + TargetVersion string `json:"targetVersion,omitempty"` + // ForceSendFields is a list of field names (e.g. "Cancellable") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Cancellable") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s UpgradeClusterStatus) MarshalJSON() ([]byte, error) { + type NoMethod UpgradeClusterStatus + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // User: Message describing User object. type User struct { // DatabaseRoles: Optional. List of database roles this user has. The database @@ -9534,6 +9768,22 @@ func (c *ProjectsLocationsSupportedDatabaseFlagsListCall) PageToken(pageToken st return c } +// Scope sets the optional parameter "scope": The scope for which supported +// flags are requested. If not specified, default is DATABASE. +// +// Possible values: +// +// "SCOPE_UNSPECIFIED" - The scope of the flag is not specified. Default is +// +// DATABASE. +// +// "DATABASE" - The flag is a database flag. +// "CONNECTION_POOL" - The flag is a connection pool flag. +func (c *ProjectsLocationsSupportedDatabaseFlagsListCall) Scope(scope string) *ProjectsLocationsSupportedDatabaseFlagsListCall { + c.urlParams_.Set("scope", scope) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. diff --git a/areainsights/v1/areainsights-api.json b/areainsights/v1/areainsights-api.json index 2d4492a94c4..0272455dd54 100644 --- a/areainsights/v1/areainsights-api.json +++ b/areainsights/v1/areainsights-api.json @@ -128,7 +128,7 @@ } } }, - "revision": "20250225", + "revision": "20250226", "rootUrl": "https://areainsights.googleapis.com/", "schemas": { "Circle": { @@ -227,7 +227,7 @@ "OPERATING_STATUS_TEMPORARILY_CLOSED" ], "enumDescriptions": [ - "Not specified. This placeholder value should not be used.", + "Not specified. This value should not be used.", "The place is operational and its open during its defined hours.", "The Place is no longer in business.", "The place is temporarily closed and expected to reopen in the future." @@ -237,7 +237,7 @@ "type": "array" }, "priceLevels": { - "description": "Optional. Restricts results to places whose price level is included on this list. If price_level is not set, all price levels are included in the results.", + "description": "Optional. Restricts results to places whose price level is included on this list. If `price_levels` is not set, all price levels are included in the results.", "items": { "enum": [ "PRICE_LEVEL_UNSPECIFIED", @@ -248,7 +248,7 @@ "PRICE_LEVEL_VERY_EXPENSIVE" ], "enumDescriptions": [ - "Place price level is unspecified or unknown.", + "Not specified. This value should not be used.", "Place provides free services.", "Place provides inexpensive services.", "Place provides moderately priced services.", diff --git a/areainsights/v1/areainsights-gen.go b/areainsights/v1/areainsights-gen.go index f1afc3caf45..7bf58de67f9 100644 --- a/areainsights/v1/areainsights-gen.go +++ b/areainsights/v1/areainsights-gen.go @@ -300,8 +300,8 @@ type Filter struct { // OPERATING_STATUS_OPERATIONAL is used as default. // // Possible values: - // "OPERATING_STATUS_UNSPECIFIED" - Not specified. This placeholder value - // should not be used. + // "OPERATING_STATUS_UNSPECIFIED" - Not specified. This value should not be + // used. // "OPERATING_STATUS_OPERATIONAL" - The place is operational and its open // during its defined hours. // "OPERATING_STATUS_PERMANENTLY_CLOSED" - The Place is no longer in @@ -310,11 +310,11 @@ type Filter struct { // and expected to reopen in the future. OperatingStatus []string `json:"operatingStatus,omitempty"` // PriceLevels: Optional. Restricts results to places whose price level is - // included on this list. If price_level is not set, all price levels are + // included on this list. If `price_levels` is not set, all price levels are // included in the results. // // Possible values: - // "PRICE_LEVEL_UNSPECIFIED" - Place price level is unspecified or unknown. + // "PRICE_LEVEL_UNSPECIFIED" - Not specified. This value should not be used. // "PRICE_LEVEL_FREE" - Place provides free services. // "PRICE_LEVEL_INEXPENSIVE" - Place provides inexpensive services. // "PRICE_LEVEL_MODERATE" - Place provides moderately priced services. diff --git a/bigqueryreservation/v1/bigqueryreservation-api.json b/bigqueryreservation/v1/bigqueryreservation-api.json index 4cf48929fef..d409461e0be 100644 --- a/bigqueryreservation/v1/bigqueryreservation-api.json +++ b/bigqueryreservation/v1/bigqueryreservation-api.json @@ -935,7 +935,7 @@ } } }, - "revision": "20250211", + "revision": "20250218", "rootUrl": "https://bigqueryreservation.googleapis.com/", "schemas": { "Assignment": { @@ -1367,6 +1367,11 @@ "description": "Optional. The labels associated with this reservation. You can use these to organize and group your reservations. You can set this property when inserting or updating a reservation.", "type": "object" }, + "maxSlots": { + "description": "Optional. The overall max slots for the reservation, covering slot_capacity (baseline), idle slots (if ignore_idle_slots is false) and scaled slots. If present, the reservation won't use more than the specified number of slots, even if there is demand and supply (from idle slots). NOTE: capping a reservation's idle slot usage is best effort and its usage may exceed the max_slots value. However, in terms of autoscale.current_slots (which accounts for the additional added slots), it will never exceed the max_slots - baseline. This field must be set together with the scaling_mode enum value, otherwise the request will be rejected with error code `google.rpc.Code.INVALID_ARGUMENT`. If the max_slots and scaling_mode are set, the autoscale or autoscale.max_slots field must be unset. Otherwise the request will be rejected with error code `google.rpc.Code.INVALID_ARGUMENT`. However, the autoscale field may still be in the output. The autopscale.max_slots will always show as 0 and the autoscaler.current_slots will represent the current slots from autoscaler excluding idle slots. For example, if the max_slots is 1000 and scaling_mode is AUTOSCALE_ONLY, then in the output, the autoscaler.max_slots will be 0 and the autoscaler.current_slots may be any value between 0 and 1000. If the max_slots is 1000, scaling_mode is ALL_SLOTS, the baseline is 100 and idle slots usage is 200, then in the output, the autoscaler.max_slots will be 0 and the autoscaler.current_slots will not be higher than 700. If the max_slots is 1000, scaling_mode is IDLE_SLOTS_ONLY, then in the output, the autoscaler field will be null. If the max_slots and scaling_mode are set, then the ignore_idle_slots field must be aligned with the scaling_mode enum value.(See details in ScalingMode comments). Otherwise the request will be rejected with error code `google.rpc.Code.INVALID_ARGUMENT`. Please note, the max_slots is for user to manage the part of slots greater than the baseline. Therefore, we don't allow users to set max_slots smaller or equal to the baseline as it will not be meaningful. If the field is present and slot_capacity\u003e=max_slots, requests will be rejected with error code `google.rpc.Code.INVALID_ARGUMENT`. Please note that if max_slots is set to 0, we will treat it as unset. Customers can set max_slots to 0 and set scaling_mode to SCALING_MODE_UNSPECIFIED to disable the max_slots feature.", + "format": "int64", + "type": "string" + }, "multiRegionAuxiliary": { "description": "Applicable only for reservations located within one of the BigQuery multi-regions (US or EU). If set to true, this reservation is placed in the organization's secondary region which is designated for disaster recovery purposes. If false, this reservation is placed in the organization's default region. NOTE: this is a preview feature. Project must be allow-listed in order to set this field.", "type": "boolean" @@ -1390,6 +1395,22 @@ "description": "Output only. The Disater Recovery(DR) replication status of the reservation. This is only available for the primary replica of DR/failover reservations and provides information about the both the staleness of the secondary and the last error encountered while trying to replicate changes from the primary to the secondary.", "readOnly": true }, + "scalingMode": { + "description": "The scaling mode for the reservation. If the field is present but max_slots is not present, requests will be rejected with error code `google.rpc.Code.INVALID_ARGUMENT`.", + "enum": [ + "SCALING_MODE_UNSPECIFIED", + "AUTOSCALE_ONLY", + "IDLE_SLOTS_ONLY", + "ALL_SLOTS" + ], + "enumDescriptions": [ + "Default value of ScalingMode.", + "The reservation will scale up only using slots from autoscaling. It will not use any idle slots even if there may be some available. The upper limit that autoscaling can scale up to will be max_slots - baseline. For example, if max_slots is 1000, baseline is 200 and customer sets ScalingMode to AUTOSCALE_ONLY, then autoscalerg will scale up to 800 slots and no idle slots will be used. Please note, in this mode, the ignore_idle_slots field must be set to true. Otherwise the request will be rejected with error code `google.rpc.Code.INVALID_ARGUMENT`.", + "The reservation will scale up using only idle slots contributed by other reservations or from unassigned commitments. If no idle slots are available it will not scale up further. If the idle slots which it is using are reclaimed by the contributing reservation(s) it may be forced to scale down. The max idle slots the reservation can be max_slots - baseline capacity. For example, if max_slots is 1000, baseline is 200 and customer sets ScalingMode to IDLE_SLOTS_ONLY, 1. if there are 1000 idle slots available in other reservations, the reservation will scale up to 1000 slots with 200 baseline and 800 idle slots. 2. if there are 500 idle slots available in other reservations, the reservation will scale up to 700 slots with 200 baseline and 300 idle slots. Please note, in this mode, the reservation might not be able to scale up to max_slots. Please note, in this mode, the ignore_idle_slots field must be set to false. Otherwise the request will be rejected with error code `google.rpc.Code.INVALID_ARGUMENT`.", + "The reservation will scale up using all slots available to it. It will use idle slots contributed by other reservations or from unassigned commitments first. If no idle slots are available it will scale up using autoscaling. For example, if max_slots is 1000, baseline is 200 and customer sets ScalingMode to ALL_SLOTS, 1. if there are 800 idle slots available in other reservations, the reservation will scale up to 1000 slots with 200 baseline and 800 idle slots. 2. if there are 500 idle slots available in other reservations, the reservation will scale up to 1000 slots with 200 baseline, 500 idle slots and 300 autoscaling slots. 3. if there are no idle slots available in other reservations, it will scale up to 1000 slots with 200 baseline and 800 autoscaling slots. Please note, in this mode, the ignore_idle_slots field must be set to false. Otherwise the request will be rejected with error code `google.rpc.Code.INVALID_ARGUMENT`." + ], + "type": "string" + }, "secondaryLocation": { "description": "Optional. The current location of the reservation's secondary replica. This field is only set for reservations using the managed disaster recovery feature. Users can set this in create reservation calls to create a failover reservation or in update reservation calls to convert a non-failover reservation to a failover reservation(or vice versa).", "type": "string" diff --git a/bigqueryreservation/v1/bigqueryreservation-gen.go b/bigqueryreservation/v1/bigqueryreservation-gen.go index 9c58d6a2019..429e027ebe9 100644 --- a/bigqueryreservation/v1/bigqueryreservation-gen.go +++ b/bigqueryreservation/v1/bigqueryreservation-gen.go @@ -727,6 +727,40 @@ type Reservation struct { // these to organize and group your reservations. You can set this property // when inserting or updating a reservation. Labels map[string]string `json:"labels,omitempty"` + // MaxSlots: Optional. The overall max slots for the reservation, covering + // slot_capacity (baseline), idle slots (if ignore_idle_slots is false) and + // scaled slots. If present, the reservation won't use more than the specified + // number of slots, even if there is demand and supply (from idle slots). NOTE: + // capping a reservation's idle slot usage is best effort and its usage may + // exceed the max_slots value. However, in terms of autoscale.current_slots + // (which accounts for the additional added slots), it will never exceed the + // max_slots - baseline. This field must be set together with the scaling_mode + // enum value, otherwise the request will be rejected with error code + // `google.rpc.Code.INVALID_ARGUMENT`. If the max_slots and scaling_mode are + // set, the autoscale or autoscale.max_slots field must be unset. Otherwise the + // request will be rejected with error code `google.rpc.Code.INVALID_ARGUMENT`. + // However, the autoscale field may still be in the output. The + // autopscale.max_slots will always show as 0 and the autoscaler.current_slots + // will represent the current slots from autoscaler excluding idle slots. For + // example, if the max_slots is 1000 and scaling_mode is AUTOSCALE_ONLY, then + // in the output, the autoscaler.max_slots will be 0 and the + // autoscaler.current_slots may be any value between 0 and 1000. If the + // max_slots is 1000, scaling_mode is ALL_SLOTS, the baseline is 100 and idle + // slots usage is 200, then in the output, the autoscaler.max_slots will be 0 + // and the autoscaler.current_slots will not be higher than 700. If the + // max_slots is 1000, scaling_mode is IDLE_SLOTS_ONLY, then in the output, the + // autoscaler field will be null. If the max_slots and scaling_mode are set, + // then the ignore_idle_slots field must be aligned with the scaling_mode enum + // value.(See details in ScalingMode comments). Otherwise the request will be + // rejected with error code `google.rpc.Code.INVALID_ARGUMENT`. Please note, + // the max_slots is for user to manage the part of slots greater than the + // baseline. Therefore, we don't allow users to set max_slots smaller or equal + // to the baseline as it will not be meaningful. If the field is present and + // slot_capacity>=max_slots, requests will be rejected with error code + // `google.rpc.Code.INVALID_ARGUMENT`. Please note that if max_slots is set to + // 0, we will treat it as unset. Customers can set max_slots to 0 and set + // scaling_mode to SCALING_MODE_UNSPECIFIED to disable the max_slots feature. + MaxSlots int64 `json:"maxSlots,omitempty,string"` // MultiRegionAuxiliary: Applicable only for reservations located within one of // the BigQuery multi-regions (US or EU). If set to true, this reservation is // placed in the organization's secondary region which is designated for @@ -755,6 +789,48 @@ type Reservation struct { // staleness of the secondary and the last error encountered while trying to // replicate changes from the primary to the secondary. ReplicationStatus *ReplicationStatus `json:"replicationStatus,omitempty"` + // ScalingMode: The scaling mode for the reservation. If the field is present + // but max_slots is not present, requests will be rejected with error code + // `google.rpc.Code.INVALID_ARGUMENT`. + // + // Possible values: + // "SCALING_MODE_UNSPECIFIED" - Default value of ScalingMode. + // "AUTOSCALE_ONLY" - The reservation will scale up only using slots from + // autoscaling. It will not use any idle slots even if there may be some + // available. The upper limit that autoscaling can scale up to will be + // max_slots - baseline. For example, if max_slots is 1000, baseline is 200 and + // customer sets ScalingMode to AUTOSCALE_ONLY, then autoscalerg will scale up + // to 800 slots and no idle slots will be used. Please note, in this mode, the + // ignore_idle_slots field must be set to true. Otherwise the request will be + // rejected with error code `google.rpc.Code.INVALID_ARGUMENT`. + // "IDLE_SLOTS_ONLY" - The reservation will scale up using only idle slots + // contributed by other reservations or from unassigned commitments. If no idle + // slots are available it will not scale up further. If the idle slots which it + // is using are reclaimed by the contributing reservation(s) it may be forced + // to scale down. The max idle slots the reservation can be max_slots - + // baseline capacity. For example, if max_slots is 1000, baseline is 200 and + // customer sets ScalingMode to IDLE_SLOTS_ONLY, 1. if there are 1000 idle + // slots available in other reservations, the reservation will scale up to 1000 + // slots with 200 baseline and 800 idle slots. 2. if there are 500 idle slots + // available in other reservations, the reservation will scale up to 700 slots + // with 200 baseline and 300 idle slots. Please note, in this mode, the + // reservation might not be able to scale up to max_slots. Please note, in this + // mode, the ignore_idle_slots field must be set to false. Otherwise the + // request will be rejected with error code `google.rpc.Code.INVALID_ARGUMENT`. + // "ALL_SLOTS" - The reservation will scale up using all slots available to + // it. It will use idle slots contributed by other reservations or from + // unassigned commitments first. If no idle slots are available it will scale + // up using autoscaling. For example, if max_slots is 1000, baseline is 200 and + // customer sets ScalingMode to ALL_SLOTS, 1. if there are 800 idle slots + // available in other reservations, the reservation will scale up to 1000 slots + // with 200 baseline and 800 idle slots. 2. if there are 500 idle slots + // available in other reservations, the reservation will scale up to 1000 slots + // with 200 baseline, 500 idle slots and 300 autoscaling slots. 3. if there are + // no idle slots available in other reservations, it will scale up to 1000 + // slots with 200 baseline and 800 autoscaling slots. Please note, in this + // mode, the ignore_idle_slots field must be set to false. Otherwise the + // request will be rejected with error code `google.rpc.Code.INVALID_ARGUMENT`. + ScalingMode string `json:"scalingMode,omitempty"` // SecondaryLocation: Optional. The current location of the reservation's // secondary replica. This field is only set for reservations using the managed // disaster recovery feature. Users can set this in create reservation calls to diff --git a/datastream/v1/datastream-api.json b/datastream/v1/datastream-api.json index 751bfc2d625..c313c6a9bbc 100644 --- a/datastream/v1/datastream-api.json +++ b/datastream/v1/datastream-api.json @@ -1250,7 +1250,7 @@ } } }, - "revision": "20250213", + "revision": "20250219", "rootUrl": "https://datastream.googleapis.com/", "schemas": { "AppendOnly": { @@ -3190,7 +3190,7 @@ "description": "Salesforce data source configuration." }, "sourceConnectionProfile": { - "description": "Required. Source connection profile resoource. Format: `projects/{project}/locations/{location}/connectionProfiles/{name}`", + "description": "Required. Source connection profile resource. Format: `projects/{project}/locations/{location}/connectionProfiles/{name}`", "type": "string" }, "sqlServerSourceConfig": { diff --git a/datastream/v1/datastream-gen.go b/datastream/v1/datastream-gen.go index 53403e979dd..19f74c8f83d 100644 --- a/datastream/v1/datastream-gen.go +++ b/datastream/v1/datastream-gen.go @@ -2517,7 +2517,7 @@ type SourceConfig struct { PostgresqlSourceConfig *PostgresqlSourceConfig `json:"postgresqlSourceConfig,omitempty"` // SalesforceSourceConfig: Salesforce data source configuration. SalesforceSourceConfig *SalesforceSourceConfig `json:"salesforceSourceConfig,omitempty"` - // SourceConnectionProfile: Required. Source connection profile resoource. + // SourceConnectionProfile: Required. Source connection profile resource. // Format: `projects/{project}/locations/{location}/connectionProfiles/{name}` SourceConnectionProfile string `json:"sourceConnectionProfile,omitempty"` // SqlServerSourceConfig: SQLServer data source configuration. diff --git a/dialogflow/v3/dialogflow-api.json b/dialogflow/v3/dialogflow-api.json index 8628b72ec59..d9f1c5bca36 100644 --- a/dialogflow/v3/dialogflow-api.json +++ b/dialogflow/v3/dialogflow-api.json @@ -4453,7 +4453,7 @@ } } }, - "revision": "20250213", + "revision": "20250227", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AdvancedSettings": { @@ -4550,7 +4550,7 @@ "type": "string" }, "useTimeoutBasedEndpointing": { - "description": "Use timeout based endpointing, interpreting endpointer sensitivy as seconds of timeout value.", + "description": "Use timeout based endpointing, interpreting endpointer sensitivity as seconds of timeout value.", "type": "boolean" } }, @@ -4921,7 +4921,7 @@ "id": "GoogleCloudDialogflowCxV3BoostSpec", "properties": { "conditionBoostSpecs": { - "description": "Optional. Condition boost specifications. If a document matches multiple conditions in the specifictions, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.", + "description": "Optional. Condition boost specifications. If a document matches multiple conditions in the specifications, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.", "items": { "$ref": "GoogleCloudDialogflowCxV3BoostSpecConditionBoostSpec" }, @@ -6523,7 +6523,7 @@ "type": "array" }, "transitionRoutes": { - "description": "A flow's transition routes serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition routes and can support use cases such as the user saying \"help\" or \"can I talk to a human?\", which can be handled in a common way regardless of the current page. Transition routes defined in the page have higher priority than those defined in the flow. TransitionRoutes are evalauted in the following order: * TransitionRoutes with intent specified. * TransitionRoutes with only condition specified. TransitionRoutes with intent specified are inherited by pages in the flow.", + "description": "A flow's transition routes serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition routes and can support use cases such as the user saying \"help\" or \"can I talk to a human?\", which can be handled in a common way regardless of the current page. Transition routes defined in the page have higher priority than those defined in the flow. TransitionRoutes are evaluated in the following order: * TransitionRoutes with intent specified. * TransitionRoutes with only condition specified. TransitionRoutes with intent specified are inherited by pages in the flow.", "items": { "$ref": "GoogleCloudDialogflowCxV3TransitionRoute" }, @@ -8167,7 +8167,7 @@ "type": "array" }, "transitionRoutes": { - "description": "A list of transitions for the transition rules of this page. They route the conversation to another page in the same flow, or another flow. When we are in a certain page, the TransitionRoutes are evalauted in the following order: * TransitionRoutes defined in the page with intent specified. * TransitionRoutes defined in the transition route groups with intent specified. * TransitionRoutes defined in flow with intent specified. * TransitionRoutes defined in the transition route groups with intent specified. * TransitionRoutes defined in the page with only condition specified. * TransitionRoutes defined in the transition route groups with only condition specified.", + "description": "A list of transitions for the transition rules of this page. They route the conversation to another page in the same flow, or another flow. When we are in a certain page, the TransitionRoutes are evaluated in the following order: * TransitionRoutes defined in the page with intent specified. * TransitionRoutes defined in the transition route groups with intent specified. * TransitionRoutes defined in flow with intent specified. * TransitionRoutes defined in the transition route groups with intent specified. * TransitionRoutes defined in the page with only condition specified. * TransitionRoutes defined in the transition route groups with only condition specified.", "items": { "$ref": "GoogleCloudDialogflowCxV3TransitionRoute" }, @@ -8920,14 +8920,14 @@ "id": "GoogleCloudDialogflowCxV3SearchConfig", "properties": { "boostSpecs": { - "description": "Optional. Boosting configuration for the datastores.", + "description": "Optional. Boosting configuration for the datastores. Maps from datastore name to their boost configuration. Do not specify more than one BoostSpecs for each datastore name. If multiple BoostSpecs are provided for the same datastore name, the behavior is undefined.", "items": { "$ref": "GoogleCloudDialogflowCxV3BoostSpecs" }, "type": "array" }, "filterSpecs": { - "description": "Optional. Filter configuration for the datastores.", + "description": "Optional. Filter configuration for the datastores. Maps from datastore name to the filter expression for that datastore. Do not specify more than one FilterSpecs for each datastore name. If multiple FilterSpecs are provided for the same datastore name, the behavior is undefined.", "items": { "$ref": "GoogleCloudDialogflowCxV3FilterSpecs" }, @@ -10374,7 +10374,7 @@ "type": "string" }, "useTimeoutBasedEndpointing": { - "description": "Use timeout based endpointing, interpreting endpointer sensitivy as seconds of timeout value.", + "description": "Use timeout based endpointing, interpreting endpointer sensitivity as seconds of timeout value.", "type": "boolean" } }, @@ -11541,7 +11541,7 @@ "type": "array" }, "transitionRoutes": { - "description": "A list of transitions for the transition rules of this page. They route the conversation to another page in the same flow, or another flow. When we are in a certain page, the TransitionRoutes are evalauted in the following order: * TransitionRoutes defined in the page with intent specified. * TransitionRoutes defined in the transition route groups with intent specified. * TransitionRoutes defined in flow with intent specified. * TransitionRoutes defined in the transition route groups with intent specified. * TransitionRoutes defined in the page with only condition specified. * TransitionRoutes defined in the transition route groups with only condition specified.", + "description": "A list of transitions for the transition rules of this page. They route the conversation to another page in the same flow, or another flow. When we are in a certain page, the TransitionRoutes are evaluated in the following order: * TransitionRoutes defined in the page with intent specified. * TransitionRoutes defined in the transition route groups with intent specified. * TransitionRoutes defined in flow with intent specified. * TransitionRoutes defined in the transition route groups with intent specified. * TransitionRoutes defined in the page with only condition specified. * TransitionRoutes defined in the transition route groups with only condition specified.", "items": { "$ref": "GoogleCloudDialogflowCxV3beta1TransitionRoute" }, @@ -14479,7 +14479,7 @@ "type": "string" }, "sendTime": { - "description": "Optional. The time when the message was sent.", + "description": "Optional. The time when the message was sent. For voice messages, this is the time when an utterance started.", "format": "google-datetime", "type": "string" }, @@ -17001,7 +17001,7 @@ "type": "array" }, "sendTime": { - "description": "Optional. The time when the message was sent.", + "description": "Optional. The time when the message was sent. For voice messages, this is the time when an utterance started.", "format": "google-datetime", "type": "string" }, diff --git a/dialogflow/v3/dialogflow-gen.go b/dialogflow/v3/dialogflow-gen.go index 7b583c98c5e..446ec441610 100644 --- a/dialogflow/v3/dialogflow-gen.go +++ b/dialogflow/v3/dialogflow-gen.go @@ -601,7 +601,7 @@ type GoogleCloudDialogflowCxV3AdvancedSettingsSpeechSettings struct { // NoSpeechTimeout: Timeout before detecting no speech. NoSpeechTimeout string `json:"noSpeechTimeout,omitempty"` // UseTimeoutBasedEndpointing: Use timeout based endpointing, interpreting - // endpointer sensitivy as seconds of timeout value. + // endpointer sensitivity as seconds of timeout value. UseTimeoutBasedEndpointing bool `json:"useTimeoutBasedEndpointing,omitempty"` // ForceSendFields is a list of field names (e.g. "EndpointerSensitivity") to // unconditionally include in API requests. By default, fields with empty or @@ -1158,7 +1158,7 @@ func (s GoogleCloudDialogflowCxV3BatchRunTestCasesResponse) MarshalJSON() ([]byt // https://cloud.google.com/generative-ai-app-builder/docs/reference/rest/v1alpha/BoostSpec type GoogleCloudDialogflowCxV3BoostSpec struct { // ConditionBoostSpecs: Optional. Condition boost specifications. If a document - // matches multiple conditions in the specifictions, boost scores from these + // matches multiple conditions in the specifications, boost scores from these // specifications are all applied and combined in a non-linear way. Maximum // number of specifications is 20. ConditionBoostSpecs []*GoogleCloudDialogflowCxV3BoostSpecConditionBoostSpec `json:"conditionBoostSpecs,omitempty"` @@ -3337,7 +3337,7 @@ type GoogleCloudDialogflowCxV3Flow struct { // as the user saying "help" or "can I talk to a human?", which can be handled // in a common way regardless of the current page. Transition routes defined in // the page have higher priority than those defined in the flow. - // TransitionRoutes are evalauted in the following order: * TransitionRoutes + // TransitionRoutes are evaluated in the following order: * TransitionRoutes // with intent specified. * TransitionRoutes with only condition specified. // TransitionRoutes with intent specified are inherited by pages in the flow. TransitionRoutes []*GoogleCloudDialogflowCxV3TransitionRoute `json:"transitionRoutes,omitempty"` @@ -5863,7 +5863,7 @@ type GoogleCloudDialogflowCxV3Page struct { // TransitionRoutes: A list of transitions for the transition rules of this // page. They route the conversation to another page in the same flow, or // another flow. When we are in a certain page, the TransitionRoutes are - // evalauted in the following order: * TransitionRoutes defined in the page + // evaluated in the following order: * TransitionRoutes defined in the page // with intent specified. * TransitionRoutes defined in the transition route // groups with intent specified. * TransitionRoutes defined in flow with intent // specified. * TransitionRoutes defined in the transition route groups with @@ -6942,9 +6942,15 @@ func (s GoogleCloudDialogflowCxV3SafetySettingsPhrase) MarshalJSON() ([]byte, er // GoogleCloudDialogflowCxV3SearchConfig: Search configuration for UCS search // queries. type GoogleCloudDialogflowCxV3SearchConfig struct { - // BoostSpecs: Optional. Boosting configuration for the datastores. + // BoostSpecs: Optional. Boosting configuration for the datastores. Maps from + // datastore name to their boost configuration. Do not specify more than one + // BoostSpecs for each datastore name. If multiple BoostSpecs are provided for + // the same datastore name, the behavior is undefined. BoostSpecs []*GoogleCloudDialogflowCxV3BoostSpecs `json:"boostSpecs,omitempty"` - // FilterSpecs: Optional. Filter configuration for the datastores. + // FilterSpecs: Optional. Filter configuration for the datastores. Maps from + // datastore name to the filter expression for that datastore. Do not specify + // more than one FilterSpecs for each datastore name. If multiple FilterSpecs + // are provided for the same datastore name, the behavior is undefined. FilterSpecs []*GoogleCloudDialogflowCxV3FilterSpecs `json:"filterSpecs,omitempty"` // ForceSendFields is a list of field names (e.g. "BoostSpecs") to // unconditionally include in API requests. By default, fields with empty or @@ -8920,7 +8926,7 @@ type GoogleCloudDialogflowCxV3beta1AdvancedSettingsSpeechSettings struct { // NoSpeechTimeout: Timeout before detecting no speech. NoSpeechTimeout string `json:"noSpeechTimeout,omitempty"` // UseTimeoutBasedEndpointing: Use timeout based endpointing, interpreting - // endpointer sensitivy as seconds of timeout value. + // endpointer sensitivity as seconds of timeout value. UseTimeoutBasedEndpointing bool `json:"useTimeoutBasedEndpointing,omitempty"` // ForceSendFields is a list of field names (e.g. "EndpointerSensitivity") to // unconditionally include in API requests. By default, fields with empty or @@ -10671,7 +10677,7 @@ type GoogleCloudDialogflowCxV3beta1Page struct { // TransitionRoutes: A list of transitions for the transition rules of this // page. They route the conversation to another page in the same flow, or // another flow. When we are in a certain page, the TransitionRoutes are - // evalauted in the following order: * TransitionRoutes defined in the page + // evaluated in the following order: * TransitionRoutes defined in the page // with intent specified. * TransitionRoutes defined in the transition route // groups with intent specified. * TransitionRoutes defined in flow with intent // specified. * TransitionRoutes defined in the transition route groups with @@ -14536,7 +14542,8 @@ type GoogleCloudDialogflowV2Message struct { // "END_USER" - Participant is an end user that has called or chatted with // Dialogflow services. ParticipantRole string `json:"participantRole,omitempty"` - // SendTime: Optional. The time when the message was sent. + // SendTime: Optional. The time when the message was sent. For voice messages, + // this is the time when an utterance started. SendTime string `json:"sendTime,omitempty"` // SentimentAnalysis: Output only. The sentiment analysis result for the // message. @@ -18041,7 +18048,8 @@ type GoogleCloudDialogflowV2beta1Message struct { ParticipantRole string `json:"participantRole,omitempty"` // ResponseMessages: Optional. Automated agent responses. ResponseMessages []*GoogleCloudDialogflowV2beta1ResponseMessage `json:"responseMessages,omitempty"` - // SendTime: Optional. The time when the message was sent. + // SendTime: Optional. The time when the message was sent. For voice messages, + // this is the time when an utterance started. SendTime string `json:"sendTime,omitempty"` // SentimentAnalysis: Output only. The sentiment analysis result for the // message. diff --git a/dlp/v2/dlp-api.json b/dlp/v2/dlp-api.json index be0f59caf9c..8c56dbcd753 100644 --- a/dlp/v2/dlp-api.json +++ b/dlp/v2/dlp-api.json @@ -2728,7 +2728,7 @@ "image": { "methods": { "redact": { - "description": "Redacts potentially sensitive info from an image. This method has limits on input size, processing time, and output size. See https://cloud.google.com/sensitive-data-protection/docs/redacting-sensitive-data-images to learn more. When no InfoTypes or CustomInfoTypes are specified in this request, the system will automatically choose what detectors to run. By default this may be all types, but may change over time as detectors are updated.", + "description": "Redacts potentially sensitive info from an image. This method has limits on input size, processing time, and output size. See https://cloud.google.com/sensitive-data-protection/docs/redacting-sensitive-data-images to learn more. When no InfoTypes or CustomInfoTypes are specified in this request, the system will automatically choose what detectors to run. By default this may be all types, but may change over time as detectors are updated. Only the first frame of each multiframe image is redacted. Metadata and other frames are omitted in the response.", "flatPath": "v2/projects/{projectsId}/image:redact", "httpMethod": "POST", "id": "dlp.projects.image.redact", @@ -4116,7 +4116,7 @@ "image": { "methods": { "redact": { - "description": "Redacts potentially sensitive info from an image. This method has limits on input size, processing time, and output size. See https://cloud.google.com/sensitive-data-protection/docs/redacting-sensitive-data-images to learn more. When no InfoTypes or CustomInfoTypes are specified in this request, the system will automatically choose what detectors to run. By default this may be all types, but may change over time as detectors are updated.", + "description": "Redacts potentially sensitive info from an image. This method has limits on input size, processing time, and output size. See https://cloud.google.com/sensitive-data-protection/docs/redacting-sensitive-data-images to learn more. When no InfoTypes or CustomInfoTypes are specified in this request, the system will automatically choose what detectors to run. By default this may be all types, but may change over time as detectors are updated. Only the first frame of each multiframe image is redacted. Metadata and other frames are omitted in the response.", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/image:redact", "httpMethod": "POST", "id": "dlp.projects.locations.image.redact", @@ -5025,7 +5025,7 @@ } } }, - "revision": "20250216", + "revision": "20250226", "rootUrl": "https://dlp.googleapis.com/", "schemas": { "GooglePrivacyDlpV2Action": { diff --git a/dlp/v2/dlp-gen.go b/dlp/v2/dlp-gen.go index 79116011a04..956826ef51a 100644 --- a/dlp/v2/dlp-gen.go +++ b/dlp/v2/dlp-gen.go @@ -20537,7 +20537,8 @@ type ProjectsImageRedactCall struct { // to learn more. When no InfoTypes or CustomInfoTypes are specified in this // request, the system will automatically choose what detectors to run. By // default this may be all types, but may change over time as detectors are -// updated. +// updated. Only the first frame of each multiframe image is redacted. Metadata +// and other frames are omitted in the response. // // - parent: Parent resource name. The format of this value varies depending on // whether you have specified a processing location @@ -25903,7 +25904,8 @@ type ProjectsLocationsImageRedactCall struct { // to learn more. When no InfoTypes or CustomInfoTypes are specified in this // request, the system will automatically choose what detectors to run. By // default this may be all types, but may change over time as detectors are -// updated. +// updated. Only the first frame of each multiframe image is redacted. Metadata +// and other frames are omitted in the response. // // - parent: Parent resource name. The format of this value varies depending on // whether you have specified a processing location diff --git a/fcm/v1/fcm-api.json b/fcm/v1/fcm-api.json index 1e2def6669c..a3a87835966 100644 --- a/fcm/v1/fcm-api.json +++ b/fcm/v1/fcm-api.json @@ -146,13 +146,17 @@ } } }, - "revision": "20241112", + "revision": "20250219", "rootUrl": "https://fcm.googleapis.com/", "schemas": { "AndroidConfig": { "description": "Android specific options for messages sent through [FCM connection server](https://goo.gl/4GLdUl).", "id": "AndroidConfig", "properties": { + "bandwidthConstrainedOk": { + "description": "Optional. If set to true, messages will be allowed to be delivered to the app while the device is in bandwidth constrained mode.", + "type": "boolean" + }, "collapseKey": { "description": "An identifier of a group of messages that can be collapsed, so that only the last message gets sent when delivery can be resumed. A maximum of 4 different collapse keys is allowed at any given time.", "type": "string" diff --git a/fcm/v1/fcm-gen.go b/fcm/v1/fcm-gen.go index 25318f77b58..847208b726b 100644 --- a/fcm/v1/fcm-gen.go +++ b/fcm/v1/fcm-gen.go @@ -191,6 +191,10 @@ type ProjectsMessagesService struct { // AndroidConfig: Android specific options for messages sent through FCM // connection server (https://goo.gl/4GLdUl). type AndroidConfig struct { + // BandwidthConstrainedOk: Optional. If set to true, messages will be allowed + // to be delivered to the app while the device is in bandwidth constrained + // mode. + BandwidthConstrainedOk bool `json:"bandwidthConstrainedOk,omitempty"` // CollapseKey: An identifier of a group of messages that can be collapsed, so // that only the last message gets sent when delivery can be resumed. A maximum // of 4 different collapse keys is allowed at any given time. @@ -239,15 +243,15 @@ type AndroidConfig struct { // expressed in JSON format as "3.000000001s". The ttl will be rounded down to // the nearest second. Ttl string `json:"ttl,omitempty"` - // ForceSendFields is a list of field names (e.g. "CollapseKey") to + // ForceSendFields is a list of field names (e.g. "BandwidthConstrainedOk") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "CollapseKey") 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. "BandwidthConstrainedOk") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } diff --git a/firebase/v1beta1/firebase-api.json b/firebase/v1beta1/firebase-api.json index 782d6fddaff..91d10a4dd21 100644 --- a/firebase/v1beta1/firebase-api.json +++ b/firebase/v1beta1/firebase-api.json @@ -1324,7 +1324,7 @@ } } }, - "revision": "20250113", + "revision": "20250226", "rootUrl": "https://firebase.googleapis.com/", "schemas": { "AddFirebaseRequest": { @@ -2170,7 +2170,7 @@ "description": "message_set associates an arbitrary proto message with the status. copybara:strip_begin(b/383363683) copybara:strip_end_and_replace optional proto2.bridge.MessageSet message_set = 5;" }, "space": { - "description": "The following are usually only present when code != 0 Space to which this status belongs copybara:strip_begin(b/383363683) copybara:strip_end_and_replace optional string space = 2;", + "description": "The following are usually only present when code != 0 Space to which this status belongs", "type": "string" } }, diff --git a/firebase/v1beta1/firebase-gen.go b/firebase/v1beta1/firebase-gen.go index 53f38ca5bc0..8648b2ab615 100644 --- a/firebase/v1beta1/firebase-gen.go +++ b/firebase/v1beta1/firebase-gen.go @@ -1610,8 +1610,7 @@ type StatusProto struct { // optional proto2.bridge.MessageSet message_set = 5; MessageSet *MessageSet `json:"messageSet,omitempty"` // Space: The following are usually only present when code != 0 Space to which - // this status belongs copybara:strip_begin(b/383363683) - // copybara:strip_end_and_replace optional string space = 2; + // this status belongs Space string `json:"space,omitempty"` // ForceSendFields is a list of field names (e.g. "CanonicalCode") to // unconditionally include in API requests. By default, fields with empty or diff --git a/networksecurity/v1beta1/networksecurity-api.json b/networksecurity/v1beta1/networksecurity-api.json index e64f2eba524..1c85bec6f7f 100644 --- a/networksecurity/v1beta1/networksecurity-api.json +++ b/networksecurity/v1beta1/networksecurity-api.json @@ -286,6 +286,11 @@ "pattern": "^organizations/[^/]+/locations/[^/]+$", "required": true, "type": "string" + }, + "returnPartialSuccess": { + "description": "Optional. If true, allow partial responses for multi-regional Aggregated List requests.", + "location": "query", + "type": "boolean" } }, "path": "v1beta1/{+parent}/addressGroups", @@ -1314,6 +1319,11 @@ "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "type": "string" + }, + "returnPartialSuccess": { + "description": "Optional. If true, allow partial responses for multi-regional Aggregated List requests.", + "location": "query", + "type": "boolean" } }, "path": "v1beta1/{+parent}/addressGroups", @@ -2905,7 +2915,7 @@ "interceptDeploymentGroups": { "methods": { "create": { - "description": "Creates a new InterceptDeploymentGroup in a given project and location.", + "description": "Creates a deployment group in a given project and location. See https://google.aip.dev/133.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/interceptDeploymentGroups", "httpMethod": "POST", "id": "networksecurity.projects.locations.interceptDeploymentGroups.create", @@ -2914,19 +2924,19 @@ ], "parameters": { "interceptDeploymentGroupId": { - "description": "Required. Id of the requesting object If auto-generating Id server-side, remove this field and intercept_deployment_group_id from the method_signature of Create RPC", + "description": "Required. The ID to use for the new deployment group, which will become the final component of the deployment group's resource name.", "location": "query", "type": "string" }, "parent": { - "description": "Required. Value for parent.", + "description": "Required. The parent resource where this deployment group will be created. Format: projects/{project}/locations/{location}", "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 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).", + "description": "Optional. A unique identifier for this request. Must be a UUID4. This request is only idempotent if a `request_id` is provided. See https://google.aip.dev/155 for more details.", "location": "query", "type": "string" } @@ -2943,7 +2953,7 @@ ] }, "delete": { - "description": "Deletes a single InterceptDeploymentGroup.", + "description": "Deletes a deployment group. See https://google.aip.dev/135.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/interceptDeploymentGroups/{interceptDeploymentGroupsId}", "httpMethod": "DELETE", "id": "networksecurity.projects.locations.interceptDeploymentGroups.delete", @@ -2952,14 +2962,14 @@ ], "parameters": { "name": { - "description": "Required. Name of the resource", + "description": "Required. The deployment group to delete.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/interceptDeploymentGroups/[^/]+$", "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).", + "description": "Optional. A unique identifier for this request. Must be a UUID4. This request is only idempotent if a `request_id` is provided. See https://google.aip.dev/155 for more details.", "location": "query", "type": "string" } @@ -2973,7 +2983,7 @@ ] }, "get": { - "description": "Gets details of a single InterceptDeploymentGroup.", + "description": "Gets a specific deployment group. See https://google.aip.dev/131.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/interceptDeploymentGroups/{interceptDeploymentGroupsId}", "httpMethod": "GET", "id": "networksecurity.projects.locations.interceptDeploymentGroups.get", @@ -2982,7 +2992,7 @@ ], "parameters": { "name": { - "description": "Required. Name of the resource", + "description": "Required. The name of the deployment group to retrieve. Format: projects/{project}/locations/{location}/interceptDeploymentGroups/{intercept_deployment_group}", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/interceptDeploymentGroups/[^/]+$", "required": true, @@ -2998,7 +3008,7 @@ ] }, "list": { - "description": "Lists InterceptDeploymentGroups in a given project and location.", + "description": "Lists deployment groups in a given project and location. See https://google.aip.dev/132.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/interceptDeploymentGroups", "httpMethod": "GET", "id": "networksecurity.projects.locations.interceptDeploymentGroups.list", @@ -3007,28 +3017,28 @@ ], "parameters": { "filter": { - "description": "Optional. Filtering results", + "description": "Optional. Filter expression. See https://google.aip.dev/160#filtering for more details.", "location": "query", "type": "string" }, "orderBy": { - "description": "Optional. Hint for how to order the results", + "description": "Optional. Sort expression. See https://google.aip.dev/132#ordering for more details.", "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.", + "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. See https://google.aip.dev/158 for more details.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { - "description": "Optional. A token identifying a page of results the server should return.", + "description": "Optional. A page token, received from a previous `ListInterceptDeploymentGroups` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListInterceptDeploymentGroups` must match the call that provided the page token. See https://google.aip.dev/158 for more details.", "location": "query", "type": "string" }, "parent": { - "description": "Required. Parent value for ListInterceptDeploymentGroupsRequest", + "description": "Required. The parent, which owns this collection of deployment groups. Example: `projects/123456789/locations/global`. See https://google.aip.dev/132 for more details.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -3044,7 +3054,7 @@ ] }, "patch": { - "description": "Updates a single InterceptDeploymentGroup.", + "description": "Updates a deployment group. See https://google.aip.dev/134.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/interceptDeploymentGroups/{interceptDeploymentGroupsId}", "httpMethod": "PATCH", "id": "networksecurity.projects.locations.interceptDeploymentGroups.patch", @@ -3053,19 +3063,19 @@ ], "parameters": { "name": { - "description": "Immutable. Identifier. Then name of the InterceptDeploymentGroup.", + "description": "Immutable. Identifier. The resource name of this deployment group, for example: `projects/123456789/locations/global/interceptDeploymentGroups/my-dg`. See https://google.aip.dev/122 for more details.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/interceptDeploymentGroups/[^/]+$", "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 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).", + "description": "Optional. A unique identifier for this request. Must be a UUID4. This request is only idempotent if a `request_id` is provided. See https://google.aip.dev/155 for more details.", "location": "query", "type": "string" }, "updateMask": { - "description": "Required. Field mask is used to specify the fields to be overwritten in the InterceptDeploymentGroup resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.", + "description": "Optional. The list of fields to update. Fields are specified relative to the deployment group (e.g. `description`; *not* `intercept_deployment_group.description`). See https://google.aip.dev/161 for more details.", "format": "google-fieldmask", "location": "query", "type": "string" @@ -3087,7 +3097,7 @@ "interceptDeployments": { "methods": { "create": { - "description": "Creates a new InterceptDeployment in a given project and location.", + "description": "Creates a deployment in a given project and location. See https://google.aip.dev/133.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/interceptDeployments", "httpMethod": "POST", "id": "networksecurity.projects.locations.interceptDeployments.create", @@ -3096,19 +3106,19 @@ ], "parameters": { "interceptDeploymentId": { - "description": "Required. Id of the requesting object If auto-generating Id server-side, remove this field and intercept_deployment_id from the method_signature of Create RPC", + "description": "Required. The ID to use for the new deployment, which will become the final component of the deployment's resource name.", "location": "query", "type": "string" }, "parent": { - "description": "Required. Value for parent.", + "description": "Required. The parent resource where this deployment will be created. Format: projects/{project}/locations/{location}", "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 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).", + "description": "Optional. A unique identifier for this request. Must be a UUID4. This request is only idempotent if a `request_id` is provided. See https://google.aip.dev/155 for more details.", "location": "query", "type": "string" } @@ -3125,7 +3135,7 @@ ] }, "delete": { - "description": "Deletes a single InterceptDeployment.", + "description": "Deletes a deployment. See https://google.aip.dev/135.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/interceptDeployments/{interceptDeploymentsId}", "httpMethod": "DELETE", "id": "networksecurity.projects.locations.interceptDeployments.delete", @@ -3141,7 +3151,7 @@ "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).", + "description": "Optional. A unique identifier for this request. Must be a UUID4. This request is only idempotent if a `request_id` is provided. See https://google.aip.dev/155 for more details.", "location": "query", "type": "string" } @@ -3155,7 +3165,7 @@ ] }, "get": { - "description": "Gets details of a single InterceptDeployment.", + "description": "Gets a specific deployment. See https://google.aip.dev/131.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/interceptDeployments/{interceptDeploymentsId}", "httpMethod": "GET", "id": "networksecurity.projects.locations.interceptDeployments.get", @@ -3164,7 +3174,7 @@ ], "parameters": { "name": { - "description": "Required. Name of the resource", + "description": "Required. The name of the deployment to retrieve. Format: projects/{project}/locations/{location}/interceptDeployments/{intercept_deployment}", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/interceptDeployments/[^/]+$", "required": true, @@ -3180,7 +3190,7 @@ ] }, "list": { - "description": "Lists InterceptDeployments in a given project and location.", + "description": "Lists deployments in a given project and location. See https://google.aip.dev/132.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/interceptDeployments", "httpMethod": "GET", "id": "networksecurity.projects.locations.interceptDeployments.list", @@ -3189,28 +3199,28 @@ ], "parameters": { "filter": { - "description": "Optional. Filtering results", + "description": "Optional. Filter expression. See https://google.aip.dev/160#filtering for more details.", "location": "query", "type": "string" }, "orderBy": { - "description": "Optional. Hint for how to order the results", + "description": "Optional. Sort expression. See https://google.aip.dev/132#ordering for more details.", "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.", + "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. See https://google.aip.dev/158 for more details.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { - "description": "Optional. A token identifying a page of results the server should return.", + "description": "Optional. A page token, received from a previous `ListInterceptDeployments` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListInterceptDeployments` must match the call that provided the page token. See https://google.aip.dev/158 for more details.", "location": "query", "type": "string" }, "parent": { - "description": "Required. Parent value for ListInterceptDeploymentsRequest", + "description": "Required. The parent, which owns this collection of deployments. Example: `projects/123456789/locations/us-central1-a`. See https://google.aip.dev/132 for more details.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -3226,7 +3236,7 @@ ] }, "patch": { - "description": "Updates a single InterceptDeployment.", + "description": "Updates a deployment. See https://google.aip.dev/134.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/interceptDeployments/{interceptDeploymentsId}", "httpMethod": "PATCH", "id": "networksecurity.projects.locations.interceptDeployments.patch", @@ -3235,19 +3245,19 @@ ], "parameters": { "name": { - "description": "Immutable. Identifier. The name of the InterceptDeployment.", + "description": "Immutable. Identifier. The resource name of this deployment, for example: `projects/123456789/locations/us-central1-a/interceptDeployments/my-dep`. See https://google.aip.dev/122 for more details.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/interceptDeployments/[^/]+$", "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 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).", + "description": "Optional. A unique identifier for this request. Must be a UUID4. This request is only idempotent if a `request_id` is provided. See https://google.aip.dev/155 for more details.", "location": "query", "type": "string" }, "updateMask": { - "description": "Required. Field mask is used to specify the fields to be overwritten in the InterceptDeployment resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.", + "description": "Optional. The list of fields to update. Fields are specified relative to the deployment (e.g. `description`; *not* `intercept_deployment.description`). See https://google.aip.dev/161 for more details.", "format": "google-fieldmask", "location": "query", "type": "string" @@ -3269,7 +3279,7 @@ "interceptEndpointGroupAssociations": { "methods": { "create": { - "description": "Creates a new InterceptEndpointGroupAssociation in a given project and location.", + "description": "Creates an association in a given project and location. See https://google.aip.dev/133.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/interceptEndpointGroupAssociations", "httpMethod": "POST", "id": "networksecurity.projects.locations.interceptEndpointGroupAssociations.create", @@ -3278,19 +3288,19 @@ ], "parameters": { "interceptEndpointGroupAssociationId": { - "description": "Optional. Id of the requesting object If auto-generating Id server-side, remove this field and intercept_endpoint_group_association_id from the method_signature of Create RPC", + "description": "Optional. The ID to use for the new association, which will become the final component of the endpoint group's resource name. If not provided, the server will generate a unique ID.", "location": "query", "type": "string" }, "parent": { - "description": "Required. Value for parent.", + "description": "Required. The parent resource where this association will be created. Format: projects/{project}/locations/{location}", "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 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).", + "description": "Optional. A unique identifier for this request. Must be a UUID4. This request is only idempotent if a `request_id` is provided. See https://google.aip.dev/155 for more details.", "location": "query", "type": "string" } @@ -3307,7 +3317,7 @@ ] }, "delete": { - "description": "Deletes a single InterceptEndpointGroupAssociation.", + "description": "Deletes an association. See https://google.aip.dev/135.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/interceptEndpointGroupAssociations/{interceptEndpointGroupAssociationsId}", "httpMethod": "DELETE", "id": "networksecurity.projects.locations.interceptEndpointGroupAssociations.delete", @@ -3316,14 +3326,14 @@ ], "parameters": { "name": { - "description": "Required. Name of the resource", + "description": "Required. The association to delete.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/interceptEndpointGroupAssociations/[^/]+$", "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).", + "description": "Optional. A unique identifier for this request. Must be a UUID4. This request is only idempotent if a `request_id` is provided. See https://google.aip.dev/155 for more details.", "location": "query", "type": "string" } @@ -3337,7 +3347,7 @@ ] }, "get": { - "description": "Gets details of a single InterceptEndpointGroupAssociation.", + "description": "Gets a specific association. See https://google.aip.dev/131.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/interceptEndpointGroupAssociations/{interceptEndpointGroupAssociationsId}", "httpMethod": "GET", "id": "networksecurity.projects.locations.interceptEndpointGroupAssociations.get", @@ -3346,7 +3356,7 @@ ], "parameters": { "name": { - "description": "Required. Name of the resource", + "description": "Required. The name of the association to retrieve. Format: projects/{project}/locations/{location}/interceptEndpointGroupAssociations/{intercept_endpoint_group_association}", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/interceptEndpointGroupAssociations/[^/]+$", "required": true, @@ -3362,7 +3372,7 @@ ] }, "list": { - "description": "Lists InterceptEndpointGroupAssociations in a given project and location.", + "description": "Lists associations in a given project and location. See https://google.aip.dev/132.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/interceptEndpointGroupAssociations", "httpMethod": "GET", "id": "networksecurity.projects.locations.interceptEndpointGroupAssociations.list", @@ -3371,28 +3381,28 @@ ], "parameters": { "filter": { - "description": "Optional. Filtering results", + "description": "Optional. Filter expression. See https://google.aip.dev/160#filtering for more details.", "location": "query", "type": "string" }, "orderBy": { - "description": "Optional. Hint for how to order the results", + "description": "Optional. Sort expression. See https://google.aip.dev/132#ordering for more details.", "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.", + "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. See https://google.aip.dev/158 for more details.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { - "description": "Optional. A token identifying a page of results the server should return.", + "description": "Optional. A page token, received from a previous `ListInterceptEndpointGroups` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListInterceptEndpointGroups` must match the call that provided the page token. See https://google.aip.dev/158 for more details.", "location": "query", "type": "string" }, "parent": { - "description": "Required. Parent value for ListInterceptEndpointGroupAssociationsRequest", + "description": "Required. The parent, which owns this collection of associations. Example: `projects/123456789/locations/global`. See https://google.aip.dev/132 for more details.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -3408,7 +3418,7 @@ ] }, "patch": { - "description": "Updates a single InterceptEndpointGroupAssociation.", + "description": "Updates an association. See https://google.aip.dev/134.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/interceptEndpointGroupAssociations/{interceptEndpointGroupAssociationsId}", "httpMethod": "PATCH", "id": "networksecurity.projects.locations.interceptEndpointGroupAssociations.patch", @@ -3417,19 +3427,19 @@ ], "parameters": { "name": { - "description": "Immutable. Identifier. The name of the InterceptEndpointGroupAssociation.", + "description": "Immutable. Identifier. The resource name of this endpoint group association, for example: `projects/123456789/locations/global/interceptEndpointGroupAssociations/my-eg-association`. See https://google.aip.dev/122 for more details.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/interceptEndpointGroupAssociations/[^/]+$", "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 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).", + "description": "Optional. A unique identifier for this request. Must be a UUID4. This request is only idempotent if a `request_id` is provided. See https://google.aip.dev/155 for more details.", "location": "query", "type": "string" }, "updateMask": { - "description": "Required. Field mask is used to specify the fields to be overwritten in the InterceptEndpointGroupAssociation resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.", + "description": "Optional. The list of fields to update. Fields are specified relative to the association (e.g. `description`; *not* `intercept_endpoint_group_association.description`). See https://google.aip.dev/161 for more details.", "format": "google-fieldmask", "location": "query", "type": "string" @@ -3451,7 +3461,7 @@ "interceptEndpointGroups": { "methods": { "create": { - "description": "Creates a new InterceptEndpointGroup in a given project and location.", + "description": "Creates an endpoint group in a given project and location. See https://google.aip.dev/133.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/interceptEndpointGroups", "httpMethod": "POST", "id": "networksecurity.projects.locations.interceptEndpointGroups.create", @@ -3460,19 +3470,19 @@ ], "parameters": { "interceptEndpointGroupId": { - "description": "Required. Id of the requesting object If auto-generating Id server-side, remove this field and intercept_endpoint_group_id from the method_signature of Create RPC", + "description": "Required. The ID to use for the endpoint group, which will become the final component of the endpoint group's resource name.", "location": "query", "type": "string" }, "parent": { - "description": "Required. Value for parent.", + "description": "Required. The parent resource where this endpoint group will be created. Format: projects/{project}/locations/{location}", "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 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).", + "description": "Optional. A unique identifier for this request. Must be a UUID4. This request is only idempotent if a `request_id` is provided. See https://google.aip.dev/155 for more details.", "location": "query", "type": "string" } @@ -3489,7 +3499,7 @@ ] }, "delete": { - "description": "Deletes a single InterceptEndpointGroup.", + "description": "Deletes an endpoint group. See https://google.aip.dev/135.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/interceptEndpointGroups/{interceptEndpointGroupsId}", "httpMethod": "DELETE", "id": "networksecurity.projects.locations.interceptEndpointGroups.delete", @@ -3498,14 +3508,14 @@ ], "parameters": { "name": { - "description": "Required. Name of the resource", + "description": "Required. The endpoint group to delete.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/interceptEndpointGroups/[^/]+$", "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).", + "description": "Optional. A unique identifier for this request. Must be a UUID4. This request is only idempotent if a `request_id` is provided. See https://google.aip.dev/155 for more details.", "location": "query", "type": "string" } @@ -3519,7 +3529,7 @@ ] }, "get": { - "description": "Gets details of a single InterceptEndpointGroup.", + "description": "Gets a specific endpoint group. See https://google.aip.dev/131.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/interceptEndpointGroups/{interceptEndpointGroupsId}", "httpMethod": "GET", "id": "networksecurity.projects.locations.interceptEndpointGroups.get", @@ -3528,7 +3538,7 @@ ], "parameters": { "name": { - "description": "Required. Name of the resource", + "description": "Required. The name of the endpoint group to retrieve. Format: projects/{project}/locations/{location}/interceptEndpointGroups/{intercept_endpoint_group}", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/interceptEndpointGroups/[^/]+$", "required": true, @@ -3544,7 +3554,7 @@ ] }, "list": { - "description": "Lists InterceptEndpointGroups in a given project and location.", + "description": "Lists endpoint groups in a given project and location. See https://google.aip.dev/132.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/interceptEndpointGroups", "httpMethod": "GET", "id": "networksecurity.projects.locations.interceptEndpointGroups.list", @@ -3553,28 +3563,28 @@ ], "parameters": { "filter": { - "description": "Optional. Filtering results", + "description": "Optional. Filter expression. See https://google.aip.dev/160#filtering for more details.", "location": "query", "type": "string" }, "orderBy": { - "description": "Optional. Hint for how to order the results", + "description": "Optional. Sort expression. See https://google.aip.dev/132#ordering for more details.", "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.", + "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. See https://google.aip.dev/158 for more details.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { - "description": "Optional. A token identifying a page of results the server should return.", + "description": "Optional. A page token, received from a previous `ListInterceptEndpointGroups` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListInterceptEndpointGroups` must match the call that provided the page token. See https://google.aip.dev/158 for more details.", "location": "query", "type": "string" }, "parent": { - "description": "Required. Parent value for ListInterceptEndpointGroupsRequest", + "description": "Required. The parent, which owns this collection of endpoint groups. Example: `projects/123456789/locations/global`. See https://google.aip.dev/132 for more details.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -3590,7 +3600,7 @@ ] }, "patch": { - "description": "Updates a single InterceptEndpointGroup.", + "description": "Updates an endpoint group. See https://google.aip.dev/134.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/interceptEndpointGroups/{interceptEndpointGroupsId}", "httpMethod": "PATCH", "id": "networksecurity.projects.locations.interceptEndpointGroups.patch", @@ -3599,19 +3609,19 @@ ], "parameters": { "name": { - "description": "Immutable. Identifier. The name of the InterceptEndpointGroup.", + "description": "Immutable. Identifier. The resource name of this endpoint group, for example: `projects/123456789/locations/global/interceptEndpointGroups/my-eg`. See https://google.aip.dev/122 for more details.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/interceptEndpointGroups/[^/]+$", "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 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).", + "description": "Optional. A unique identifier for this request. Must be a UUID4. This request is only idempotent if a `request_id` is provided. See https://google.aip.dev/155 for more details.", "location": "query", "type": "string" }, "updateMask": { - "description": "Required. Field mask is used to specify the fields to be overwritten in the InterceptEndpointGroup resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.", + "description": "Optional. The list of fields to update. Fields are specified relative to the endpoint group (e.g. `description`; *not* `intercept_endpoint_group.description`). See https://google.aip.dev/161 for more details.", "format": "google-fieldmask", "location": "query", "type": "string" @@ -3633,7 +3643,7 @@ "mirroringDeploymentGroups": { "methods": { "create": { - "description": "Creates a new MirroringDeploymentGroup in a given project and location.", + "description": "Creates a deployment group in a given project and location. See https://google.aip.dev/133.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/mirroringDeploymentGroups", "httpMethod": "POST", "id": "networksecurity.projects.locations.mirroringDeploymentGroups.create", @@ -3642,19 +3652,19 @@ ], "parameters": { "mirroringDeploymentGroupId": { - "description": "Required. Id of the requesting object If auto-generating Id server-side, remove this field and mirroring_deployment_group_id from the method_signature of Create RPC", + "description": "Required. The ID to use for the new deployment group, which will become the final component of the deployment group's resource name.", "location": "query", "type": "string" }, "parent": { - "description": "Required. Value for parent.", + "description": "Required. The parent resource where this deployment group will be created. Format: projects/{project}/locations/{location}", "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 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).", + "description": "Optional. A unique identifier for this request. Must be a UUID4. This request is only idempotent if a `request_id` is provided. See https://google.aip.dev/155 for more details.", "location": "query", "type": "string" } @@ -3671,7 +3681,7 @@ ] }, "delete": { - "description": "Deletes a single MirroringDeploymentGroup.", + "description": "Deletes a deployment group. See https://google.aip.dev/135.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/mirroringDeploymentGroups/{mirroringDeploymentGroupsId}", "httpMethod": "DELETE", "id": "networksecurity.projects.locations.mirroringDeploymentGroups.delete", @@ -3680,14 +3690,14 @@ ], "parameters": { "name": { - "description": "Required. Name of the resource", + "description": "Required. The deployment group to delete.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/mirroringDeploymentGroups/[^/]+$", "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).", + "description": "Optional. A unique identifier for this request. Must be a UUID4. This request is only idempotent if a `request_id` is provided. See https://google.aip.dev/155 for more details.", "location": "query", "type": "string" } @@ -3701,7 +3711,7 @@ ] }, "get": { - "description": "Gets details of a single MirroringDeploymentGroup.", + "description": "Gets a specific deployment group. See https://google.aip.dev/131.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/mirroringDeploymentGroups/{mirroringDeploymentGroupsId}", "httpMethod": "GET", "id": "networksecurity.projects.locations.mirroringDeploymentGroups.get", @@ -3710,7 +3720,7 @@ ], "parameters": { "name": { - "description": "Required. Name of the resource", + "description": "Required. The name of the deployment group to retrieve. Format: projects/{project}/locations/{location}/mirroringDeploymentGroups/{mirroring_deployment_group}", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/mirroringDeploymentGroups/[^/]+$", "required": true, @@ -3726,7 +3736,7 @@ ] }, "list": { - "description": "Lists MirroringDeploymentGroups in a given project and location.", + "description": "Lists deployment groups in a given project and location. See https://google.aip.dev/132.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/mirroringDeploymentGroups", "httpMethod": "GET", "id": "networksecurity.projects.locations.mirroringDeploymentGroups.list", @@ -3735,28 +3745,28 @@ ], "parameters": { "filter": { - "description": "Optional. Filtering results", + "description": "Optional. Filter expression. See https://google.aip.dev/160#filtering for more details.", "location": "query", "type": "string" }, "orderBy": { - "description": "Optional. Hint for how to order the results", + "description": "Optional. Sort expression. See https://google.aip.dev/132#ordering for more details.", "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.", + "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. See https://google.aip.dev/158 for more details.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { - "description": "Optional. A token identifying a page of results the server should return.", + "description": "Optional. A page token, received from a previous `ListMirroringDeploymentGroups` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListMirroringDeploymentGroups` must match the call that provided the page token. See https://google.aip.dev/158 for more details.", "location": "query", "type": "string" }, "parent": { - "description": "Required. Parent value for ListMirroringDeploymentGroupsRequest", + "description": "Required. The parent, which owns this collection of deployment groups. Example: `projects/123456789/locations/global`. See https://google.aip.dev/132 for more details.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -3772,7 +3782,7 @@ ] }, "patch": { - "description": "Updates a single MirroringDeploymentGroup.", + "description": "Updates a deployment group. See https://google.aip.dev/134.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/mirroringDeploymentGroups/{mirroringDeploymentGroupsId}", "httpMethod": "PATCH", "id": "networksecurity.projects.locations.mirroringDeploymentGroups.patch", @@ -3788,12 +3798,12 @@ "type": "string" }, "requestId": { - "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "description": "Optional. A unique identifier for this request. Must be a UUID4. This request is only idempotent if a `request_id` is provided. See https://google.aip.dev/155 for more details.", "location": "query", "type": "string" }, "updateMask": { - "description": "Required. Field mask is used to specify the fields to be overwritten in the MirroringDeploymentGroup resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.", + "description": "Optional. The list of fields to update. Fields are specified relative to the deployment group (e.g. `description`; *not* `mirroring_deployment_group.description`). See https://google.aip.dev/161 for more details.", "format": "google-fieldmask", "location": "query", "type": "string" @@ -3824,19 +3834,19 @@ ], "parameters": { "mirroringDeploymentId": { - "description": "Required. Id of the requesting object If auto-generating Id server-side, remove this field and mirroring_deployment_id from the method_signature of Create RPC", + "description": "Required. The ID to use for the new deployment, which will become the final component of the deployment's resource name.", "location": "query", "type": "string" }, "parent": { - "description": "Required. Value for parent.", + "description": "Required. The parent resource where this deployment will be created. Format: projects/{project}/locations/{location}", "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 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).", + "description": "Optional. A unique identifier for this request. Must be a UUID4. This request is only idempotent if a `request_id` is provided. See https://google.aip.dev/155 for more details.", "location": "query", "type": "string" } @@ -3869,7 +3879,7 @@ "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).", + "description": "Optional. A unique identifier for this request. Must be a UUID4. This request is only idempotent if a `request_id` is provided. See https://google.aip.dev/155 for more details.", "location": "query", "type": "string" } @@ -3892,7 +3902,7 @@ ], "parameters": { "name": { - "description": "Required. Name of the resource", + "description": "Required. The name of the deployment to retrieve. Format: projects/{project}/locations/{location}/mirroringDeployments/{mirroring_deployment}", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/mirroringDeployments/[^/]+$", "required": true, @@ -3917,28 +3927,28 @@ ], "parameters": { "filter": { - "description": "Optional. Filtering results", + "description": "Optional. Filter expression. See https://google.aip.dev/160#filtering for more details.", "location": "query", "type": "string" }, "orderBy": { - "description": "Optional. Hint for how to order the results", + "description": "Optional. Sort expression. See https://google.aip.dev/132#ordering for more details.", "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.", + "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. See https://google.aip.dev/158 for more details.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { - "description": "Optional. A token identifying a page of results the server should return.", + "description": "Optional. A page token, received from a previous `ListMirroringDeployments` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListMirroringDeployments` must match the call that provided the page token. See https://google.aip.dev/158 for more details.", "location": "query", "type": "string" }, "parent": { - "description": "Required. Parent value for ListMirroringDeploymentsRequest", + "description": "Required. The parent, which owns this collection of deployments. Example: `projects/123456789/locations/us-central1-a`. See https://google.aip.dev/132 for more details.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -3970,12 +3980,12 @@ "type": "string" }, "requestId": { - "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "description": "Optional. A unique identifier for this request. Must be a UUID4. This request is only idempotent if a `request_id` is provided. See https://google.aip.dev/155 for more details.", "location": "query", "type": "string" }, "updateMask": { - "description": "Required. Field mask is used to specify the fields to be overwritten in the MirroringDeployment resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.", + "description": "Optional. The list of fields to update. Fields are specified relative to the deployment (e.g. `description`; *not* `mirroring_deployment.description`). See https://google.aip.dev/161 for more details.", "format": "google-fieldmask", "location": "query", "type": "string" @@ -4006,19 +4016,19 @@ ], "parameters": { "mirroringEndpointGroupAssociationId": { - "description": "Optional. ID for the new association. If not provided, the server will generate a unique ID. The ID must be a valid RFC 1035 resource name. The ID must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a lowercase letter, and all following characters (except for the last character) must be a dash, lowercase letter, or digit. The last character must be a", + "description": "Optional. The ID to use for the new association, which will become the final component of the endpoint group's resource name. If not provided, the server will generate a unique ID.", "location": "query", "type": "string" }, "parent": { - "description": "Required. Container (project and location) where the association will be created, e.g. `projects/123456789/locations/global`.", + "description": "Required. The parent resource where this association will be created. Format: projects/{project}/locations/{location}", "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 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).", + "description": "Optional. A unique identifier for this request. Must be a UUID4. This request is only idempotent if a `request_id` is provided. See https://google.aip.dev/155 for more details.", "location": "query", "type": "string" } @@ -4035,7 +4045,7 @@ ] }, "delete": { - "description": "Deletes a single association. See https://google.aip.dev/135.", + "description": "Deletes an association. See https://google.aip.dev/135.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/mirroringEndpointGroupAssociations/{mirroringEndpointGroupAssociationsId}", "httpMethod": "DELETE", "id": "networksecurity.projects.locations.mirroringEndpointGroupAssociations.delete", @@ -4044,14 +4054,14 @@ ], "parameters": { "name": { - "description": "Required. Full resource name of the association to delete, e.g. projects/123456789/locations/global/mirroringEndpointGroupAssociations/my-eg-association.", + "description": "Required. The association to delete.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/mirroringEndpointGroupAssociations/[^/]+$", "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).", + "description": "Optional. A unique identifier for this request. Must be a UUID4. This request is only idempotent if a `request_id` is provided. See https://google.aip.dev/155 for more details.", "location": "query", "type": "string" } @@ -4074,7 +4084,7 @@ ], "parameters": { "name": { - "description": "Required. Full resource name of the association to get, e.g. projects/123456789/locations/global/mirroringEndpointGroupAssociations/my-eg-association.", + "description": "Required. The name of the association to retrieve. Format: projects/{project}/locations/{location}/mirroringEndpointGroupAssociations/{mirroring_endpoint_group_association}", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/mirroringEndpointGroupAssociations/[^/]+$", "required": true, @@ -4099,28 +4109,28 @@ ], "parameters": { "filter": { - "description": "Optional. A filter expression that filters the results listed in the response. See https://google.aip.dev/160.", + "description": "Optional. Filter expression. See https://google.aip.dev/160#filtering for more details.", "location": "query", "type": "string" }, "orderBy": { - "description": "Optional. Hint for how to order the results", + "description": "Optional. Sort expression. See https://google.aip.dev/132#ordering for more details.", "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. See https://google.aip.dev/158.", + "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. See https://google.aip.dev/158 for more details.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { - "description": "Optional. A token identifying a page of results the server should return. See https://google.aip.dev/158.", + "description": "Optional. A page token, received from a previous `ListMirroringEndpointGroups` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListMirroringEndpointGroups` must match the call that provided the page token. See https://google.aip.dev/158 for more details.", "location": "query", "type": "string" }, "parent": { - "description": "Required. Parent container (project and location) of the associations to list, e.g. `projects/123456789/locations/global`.", + "description": "Required. The parent, which owns this collection of associations. Example: `projects/123456789/locations/global`. See https://google.aip.dev/132 for more details.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -4152,12 +4162,12 @@ "type": "string" }, "requestId": { - "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "description": "Optional. A unique identifier for this request. Must be a UUID4. This request is only idempotent if a `request_id` is provided. See https://google.aip.dev/155 for more details.", "location": "query", "type": "string" }, "updateMask": { - "description": "Optional. Field mask is used to specify the fields to be overwritten in the association by the update. See https://google.aip.dev/161.", + "description": "Optional. The list of fields to update. Fields are specified relative to the association (e.g. `description`; *not* `mirroring_endpoint_group_association.description`). See https://google.aip.dev/161 for more details.", "format": "google-fieldmask", "location": "query", "type": "string" @@ -4188,19 +4198,19 @@ ], "parameters": { "mirroringEndpointGroupId": { - "description": "Required. Id of the requesting object If auto-generating Id server-side, remove this field and mirroring_endpoint_group_id from the method_signature of Create RPC", + "description": "Required. The ID to use for the endpoint group, which will become the final component of the endpoint group's resource name.", "location": "query", "type": "string" }, "parent": { - "description": "Required. Value for parent.", + "description": "Required. The parent resource where this endpoint group will be created. Format: projects/{project}/locations/{location}", "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 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).", + "description": "Optional. A unique identifier for this request. Must be a UUID4. This request is only idempotent if a `request_id` is provided. See https://google.aip.dev/155 for more details.", "location": "query", "type": "string" } @@ -4226,14 +4236,14 @@ ], "parameters": { "name": { - "description": "Required. Name of the resource", + "description": "Required. The endpoint group to delete.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/mirroringEndpointGroups/[^/]+$", "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).", + "description": "Optional. A unique identifier for this request. Must be a UUID4. This request is only idempotent if a `request_id` is provided. See https://google.aip.dev/155 for more details.", "location": "query", "type": "string" } @@ -4256,7 +4266,7 @@ ], "parameters": { "name": { - "description": "Required. Name of the resource", + "description": "Required. The name of the endpoint group to retrieve. Format: projects/{project}/locations/{location}/mirroringEndpointGroups/{mirroring_endpoint_group}", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/mirroringEndpointGroups/[^/]+$", "required": true, @@ -4281,28 +4291,28 @@ ], "parameters": { "filter": { - "description": "Optional. Filtering results", + "description": "Optional. Filter expression. See https://google.aip.dev/160#filtering for more details.", "location": "query", "type": "string" }, "orderBy": { - "description": "Optional. Hint for how to order the results", + "description": "Optional. Sort expression. See https://google.aip.dev/132#ordering for more details.", "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.", + "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. See https://google.aip.dev/158 for more details.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { - "description": "Optional. A token identifying a page of results the server should return.", + "description": "Optional. A page token, received from a previous `ListMirroringEndpointGroups` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListMirroringEndpointGroups` must match the call that provided the page token. See https://google.aip.dev/158 for more details.", "location": "query", "type": "string" }, "parent": { - "description": "Required. Parent value for ListMirroringEndpointGroupsRequest", + "description": "Required. The parent, which owns this collection of endpoint groups. Example: `projects/123456789/locations/global`. See https://google.aip.dev/132 for more details.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -4334,12 +4344,12 @@ "type": "string" }, "requestId": { - "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "description": "Optional. A unique identifier for this request. Must be a UUID4. This request is only idempotent if a `request_id` is provided. See https://google.aip.dev/155 for more details.", "location": "query", "type": "string" }, "updateMask": { - "description": "Required. Field mask is used to specify the fields to be overwritten in the MirroringEndpointGroup resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.", + "description": "Optional. The list of fields to update. Fields are specified relative to the endpoint group (e.g. `description`; *not* `mirroring_endpoint_group.description`). See https://google.aip.dev/161 for more details.", "format": "google-fieldmask", "location": "query", "type": "string" @@ -5049,7 +5059,7 @@ } } }, - "revision": "20250211", + "revision": "20250217", "rootUrl": "https://networksecurity.googleapis.com/", "schemas": { "AddAddressGroupItemsRequest": { @@ -5366,7 +5376,7 @@ "id": "AuthzPolicyAuthzRuleFromRequestSource", "properties": { "principals": { - "description": "Optional. A list of identities derived from the client's certificate. This field will not match on a request unless mutual TLS is enabled for the Forwarding rule or Gateway. Each identity is a string whose value is matched against the URI SAN, or DNS SAN or the subject field in the client's certificate. The match can be exact, prefix, suffix or a substring match. One of exact, prefix, suffix or contains must be specified. Limited to 5 principals.", + "description": "Optional. A list of identities derived from the client's certificate. This field will not match on a request unless mutual TLS is enabled for the forwarding rule or Gateway. For Application Load Balancers, each identity is a string whose value is matched against the URI SAN, or DNS SAN, or SPIFFE ID, or the subject field in the client's certificate. For Cloud Service Mesh, each identity is a string whose value is matched against the URI SAN, or DNS SAN, or the subject field in the client's certificate. The match can be exact, prefix, suffix, or a substring match. One of exact, prefix, suffix, or contains must be specified. Limited to 5 principals.", "items": { "$ref": "AuthzPolicyAuthzRuleStringMatch" }, @@ -6270,11 +6280,11 @@ "type": "object" }, "InterceptDeployment": { - "description": "Message describing InterceptDeployment object NEXT ID: 10", + "description": "A deployment represents a zonal intercept backend ready to accept GENEVE-encapsulated traffic, e.g. a zonal instance group fronted by an internal passthrough load balancer. Deployments are always part of a global deployment group which represents a global intercept service.", "id": "InterceptDeployment", "properties": { "createTime": { - "description": "Output only. [Output only] Create time stamp", + "description": "Output only. The timestamp when the resource was created. See https://google.aip.dev/148#timestamps.", "format": "google-datetime", "readOnly": true, "type": "string" @@ -6284,31 +6294,31 @@ "type": "string" }, "forwardingRule": { - "description": "Required. Immutable. The regional load balancer which the intercepted traffic should be forwarded to. Format is: projects/{project}/regions/{region}/forwardingRules/{forwardingRule}", + "description": "Required. Immutable. The regional forwarding rule that fronts the intercept collectors, for example: `projects/123456789/regions/us-central1/forwardingRules/my-rule`. See https://google.aip.dev/124.", "type": "string" }, "interceptDeploymentGroup": { - "description": "Required. Immutable. The Intercept Deployment Group that this resource is part of. Format is: `projects/{project}/locations/global/interceptDeploymentGroups/{interceptDeploymentGroup}`", + "description": "Required. Immutable. The deployment group that this deployment is a part of, for example: `projects/123456789/locations/global/interceptDeploymentGroups/my-dg`. See https://google.aip.dev/124.", "type": "string" }, "labels": { "additionalProperties": { "type": "string" }, - "description": "Optional. Labels as key value pairs", + "description": "Optional. Labels are key/value pairs that help to organize and filter resources.", "type": "object" }, "name": { - "description": "Immutable. Identifier. The name of the InterceptDeployment.", + "description": "Immutable. Identifier. The resource name of this deployment, for example: `projects/123456789/locations/us-central1-a/interceptDeployments/my-dep`. See https://google.aip.dev/122 for more details.", "type": "string" }, "reconciling": { - "description": "Output only. Whether reconciling is in progress, recommended per https://google.aip.dev/128.", + "description": "Output only. The current state of the resource does not match the user's intended state, and the system is working to reconcile them. This part of the normal operation (e.g. linking a new association to the parent group). See https://google.aip.dev/128.", "readOnly": true, "type": "boolean" }, "state": { - "description": "Output only. Current state of the deployment.", + "description": "Output only. The current state of the deployment. See https://google.aip.dev/216.", "enum": [ "STATE_UNSPECIFIED", "ACTIVE", @@ -6318,18 +6328,18 @@ "DELETE_FAILED" ], "enumDescriptions": [ - "Not set.", - "Ready.", - "Being created.", - "Being deleted.", - "The underlying data plane is out of sync with the deployment. The deployment is not expected to be usable. This state can result in undefined behavior.", - "An attempt to delete the deployment has failed. This is a terminal state and the deployment is not expected to be usable as some of its resources have been deleted. The only permitted operation is to retry deleting the deployment." + "State not set (this is not a valid state).", + "The deployment is ready and in sync with the parent group.", + "The deployment is being created.", + "The deployment is being deleted.", + "The deployment is out of sync with the parent group. In most cases, this is a result of a transient issue within the system (e.g. a delayed data-path config) and the system is expected to recover automatically. See the parent deployment group's state for more details.", + "An attempt to delete the deployment has failed. This is a terminal state and the deployment is not expected to recover. The only permitted operation is to retry deleting the deployment." ], "readOnly": true, "type": "string" }, "updateTime": { - "description": "Output only. [Output only] Update time stamp", + "description": "Output only. The timestamp when the resource was most recently updated. See https://google.aip.dev/148#timestamps.", "format": "google-datetime", "readOnly": true, "type": "string" @@ -6338,11 +6348,11 @@ "type": "object" }, "InterceptDeploymentGroup": { - "description": "Message describing InterceptDeploymentGroup object", + "description": "A deployment group aggregates many zonal intercept backends (deployments) into a single global intercept service. Consumers can connect this service using an endpoint group.", "id": "InterceptDeploymentGroup", "properties": { "connectedEndpointGroups": { - "description": "Output only. The list of Intercept Endpoint Groups that are connected to this resource.", + "description": "Output only. The list of endpoint groups that are connected to this resource.", "items": { "$ref": "InterceptDeploymentGroupConnectedEndpointGroup" }, @@ -6350,7 +6360,7 @@ "type": "array" }, "createTime": { - "description": "Output only. [Output only] Create time stamp", + "description": "Output only. The timestamp when the resource was created. See https://google.aip.dev/148#timestamps.", "format": "google-datetime", "readOnly": true, "type": "string" @@ -6363,24 +6373,32 @@ "additionalProperties": { "type": "string" }, - "description": "Optional. Labels as key value pairs", + "description": "Optional. Labels are key/value pairs that help to organize and filter resources.", "type": "object" }, "name": { - "description": "Immutable. Identifier. Then name of the InterceptDeploymentGroup.", + "description": "Immutable. Identifier. The resource name of this deployment group, for example: `projects/123456789/locations/global/interceptDeploymentGroups/my-dg`. See https://google.aip.dev/122 for more details.", "type": "string" }, + "nestedDeployments": { + "description": "Output only. The list of Intercept Deployments that belong to this group.", + "items": { + "$ref": "InterceptDeploymentGroupDeployment" + }, + "readOnly": true, + "type": "array" + }, "network": { - "description": "Required. Immutable. The network that is being used for the deployment. Format is: projects/{project}/global/networks/{network}.", + "description": "Required. Immutable. The network that will be used for all child deployments, for example: `projects/{project}/global/networks/{network}`. See https://google.aip.dev/124.", "type": "string" }, "reconciling": { - "description": "Output only. Whether reconciling is in progress, recommended per https://google.aip.dev/128.", + "description": "Output only. The current state of the resource does not match the user's intended state, and the system is working to reconcile them. This is part of the normal operation (e.g. adding a new deployment to the group) See https://google.aip.dev/128.", "readOnly": true, "type": "boolean" }, "state": { - "description": "Output only. Current state of the deployment group.", + "description": "Output only. The current state of the deployment group. See https://google.aip.dev/216.", "enum": [ "STATE_UNSPECIFIED", "ACTIVE", @@ -6388,16 +6406,16 @@ "DELETING" ], "enumDescriptions": [ - "Not set.", - "Ready.", - "Being created.", - "Being deleted." + "State not set (this is not a valid state).", + "The deployment group is ready.", + "The deployment group is being created.", + "The deployment group is being deleted." ], "readOnly": true, "type": "string" }, "updateTime": { - "description": "Output only. [Output only] Update time stamp", + "description": "Output only. The timestamp when the resource was most recently updated. See https://google.aip.dev/148#timestamps.", "format": "google-datetime", "readOnly": true, "type": "string" @@ -6410,7 +6428,40 @@ "id": "InterceptDeploymentGroupConnectedEndpointGroup", "properties": { "name": { - "description": "Output only. A connected intercept endpoint group.", + "description": "Output only. The connected endpoint group's resource name, for example: `projects/123456789/locations/global/interceptEndpointGroups/my-eg`. See https://google.aip.dev/124.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "InterceptDeploymentGroupDeployment": { + "description": "A deployment belonging to this deployment group.", + "id": "InterceptDeploymentGroupDeployment", + "properties": { + "name": { + "description": "Output only. The name of the Intercept Deployment, in the format: `projects/{project}/locations/{location}/interceptDeployments/{intercept_deployment}`.", + "readOnly": true, + "type": "string" + }, + "state": { + "description": "Output only. Most recent known state of the deployment.", + "enum": [ + "STATE_UNSPECIFIED", + "ACTIVE", + "CREATING", + "DELETING", + "OUT_OF_SYNC", + "DELETE_FAILED" + ], + "enumDescriptions": [ + "State not set (this is not a valid state).", + "The deployment is ready and in sync with the parent group.", + "The deployment is being created.", + "The deployment is being deleted.", + "The deployment is out of sync with the parent group. In most cases, this is a result of a transient issue within the system (e.g. a delayed data-path config) and the system is expected to recover automatically. See the parent deployment group's state for more details.", + "An attempt to delete the deployment has failed. This is a terminal state and the deployment is not expected to recover. The only permitted operation is to retry deleting the deployment." + ], "readOnly": true, "type": "string" } @@ -6418,11 +6469,11 @@ "type": "object" }, "InterceptEndpointGroup": { - "description": "Message describing InterceptEndpointGroup object.", + "description": "An endpoint group is a consumer frontend for a deployment group (backend). In order to configure intercept for a network, consumers must create: - An association between their network and the endpoint group. - A security profile that points to the endpoint group. - A firewall rule that references the security profile (group).", "id": "InterceptEndpointGroup", "properties": { "associations": { - "description": "Output only. List of Intercept Endpoint Group Associations that are associated to this endpoint group.", + "description": "Output only. List of associations to this endpoint group.", "items": { "$ref": "InterceptEndpointGroupAssociationDetails" }, @@ -6430,7 +6481,7 @@ "type": "array" }, "createTime": { - "description": "Output only. [Output only] Create time stamp", + "description": "Output only. The timestamp when the resource was created. See https://google.aip.dev/148#timestamps.", "format": "google-datetime", "readOnly": true, "type": "string" @@ -6440,27 +6491,27 @@ "type": "string" }, "interceptDeploymentGroup": { - "description": "Required. Immutable. The Intercept Deployment Group that this resource is connected to. Format is: `projects/{project}/locations/global/interceptDeploymentGroups/{interceptDeploymentGroup}`", + "description": "Immutable. The deployment group that this endpoint group is connected to, for example: `projects/123456789/locations/global/interceptDeploymentGroups/my-dg`. See https://google.aip.dev/124.", "type": "string" }, "labels": { "additionalProperties": { "type": "string" }, - "description": "Optional. Labels as key value pairs", + "description": "Optional. Labels are key/value pairs that help to organize and filter resources.", "type": "object" }, "name": { - "description": "Immutable. Identifier. The name of the InterceptEndpointGroup.", + "description": "Immutable. Identifier. The resource name of this endpoint group, for example: `projects/123456789/locations/global/interceptEndpointGroups/my-eg`. See https://google.aip.dev/122 for more details.", "type": "string" }, "reconciling": { - "description": "Output only. Whether reconciling is in progress, recommended per https://google.aip.dev/128.", + "description": "Output only. The current state of the resource does not match the user's intended state, and the system is working to reconcile them. This is part of the normal operation (e.g. adding a new association to the group). See https://google.aip.dev/128.", "readOnly": true, "type": "boolean" }, "state": { - "description": "Output only. Current state of the endpoint group.", + "description": "Output only. The current state of the endpoint group. See https://google.aip.dev/216.", "enum": [ "STATE_UNSPECIFIED", "ACTIVE", @@ -6471,19 +6522,19 @@ "DELETE_FAILED" ], "enumDescriptions": [ - "Not set.", - "Ready.", - "The deployment group has been deleted and intercept is disabled.", - "Being created.", - "Being deleted.", - "The underlying data plane is out of sync with the endpoint group. Some associations might not be usable.", - "An attempt to delete the endpoint group has failed. This is a terminal state and the endpoint group is not expected to be usable as some of its resources have been deleted. The only permitted operation is to retry deleting the endpoint group." + "State not set (this is not a valid state).", + "The endpoint group is ready and in sync with the target deployment group.", + "The deployment group backing this endpoint group has been force-deleted. This endpoint group cannot be used and interception is effectively disabled.", + "The endpoint group is being created.", + "The endpoint group is being deleted.", + "The endpoint group is out of sync with the backing deployment group. In most cases, this is a result of a transient issue within the system (e.g. an inaccessible location) and the system is expected to recover automatically. See the associations field for details per network and location.", + "An attempt to delete the endpoint group has failed. This is a terminal state and the endpoint group is not expected to recover. The only permitted operation is to retry deleting the endpoint group." ], "readOnly": true, "type": "string" }, "updateTime": { - "description": "Output only. [Output only] Update time stamp", + "description": "Output only. The timestamp when the resource was most recently updated. See https://google.aip.dev/148#timestamps.", "format": "google-datetime", "readOnly": true, "type": "string" @@ -6492,28 +6543,28 @@ "type": "object" }, "InterceptEndpointGroupAssociation": { - "description": "Message describing InterceptEndpointGroupAssociation object", + "description": "An endpoint group association represents a link between a network and an endpoint group in the organization. Creating an association creates the networking infrastructure linking the network to the endpoint group, but does not enable intercept by itself. To enable intercept, the user must also create a network firewall policy containing intercept rules and associate it with the network.", "id": "InterceptEndpointGroupAssociation", "properties": { "createTime": { - "description": "Output only. [Output only] Create time stamp", + "description": "Output only. The timestamp when the resource was created. See https://google.aip.dev/148#timestamps.", "format": "google-datetime", "readOnly": true, "type": "string" }, "interceptEndpointGroup": { - "description": "Required. Immutable. The Intercept Endpoint Group that this resource is connected to. Format is: `projects/{project}/locations/global/interceptEndpointGroups/{interceptEndpointGroup}`", + "description": "Immutable. The endpoint group that this association is connected to, for example: `projects/123456789/locations/global/interceptEndpointGroups/my-eg`. See https://google.aip.dev/124.", "type": "string" }, "labels": { "additionalProperties": { "type": "string" }, - "description": "Optional. Labels as key value pairs", + "description": "Optional. Labels are key/value pairs that help to organize and filter resources.", "type": "object" }, "locationsDetails": { - "description": "Output only. The list of locations that this association is in and its details.", + "description": "Output only. The list of locations where the association is present. This information is retrieved from the linked endpoint group, and not configured as part of the association itself.", "items": { "$ref": "InterceptEndpointGroupAssociationLocationDetails" }, @@ -6521,15 +6572,15 @@ "type": "array" }, "name": { - "description": "Immutable. Identifier. The name of the InterceptEndpointGroupAssociation.", + "description": "Immutable. Identifier. The resource name of this endpoint group association, for example: `projects/123456789/locations/global/interceptEndpointGroupAssociations/my-eg-association`. See https://google.aip.dev/122 for more details.", "type": "string" }, "network": { - "description": "Required. Immutable. The VPC network associated. Format: projects/{project}/global/networks/{network}.", + "description": "Immutable. The VPC network that is associated. for example: `projects/123456789/global/networks/my-network`. See https://google.aip.dev/124.", "type": "string" }, "reconciling": { - "description": "Output only. Whether reconciling is in progress, recommended per https://google.aip.dev/128.", + "description": "Output only. The current state of the resource does not match the user's intended state, and the system is working to reconcile them. This part of the normal operation (e.g. adding a new location to the target deployment group). See https://google.aip.dev/128.", "readOnly": true, "type": "boolean" }, @@ -6546,18 +6597,18 @@ ], "enumDescriptions": [ "Not set.", - "Ready.", - "Being created.", - "Being deleted.", - "Intercept is disabled due to an operation on another resource.", - "The underlying data plane is out of sync with the association. The association is not expected to be usable. This state can result in undefined behavior. See the `locations_details` field for more details.", + "The association is ready and in sync with the linked endpoint group.", + "The association is being created.", + "The association is being deleted.", + "The association is disabled due to a breaking change in another resource.", + "The association is out of sync with the linked endpoint group. In most cases, this is a result of a transient issue within the system (e.g. an inaccessible location) and the system is expected to recover automatically. Check the `locations_details` field for more details.", "An attempt to delete the association has failed. This is a terminal state and the association is not expected to be usable as some of its resources have been deleted. The only permitted operation is to retry deleting the association." ], "readOnly": true, "type": "string" }, "updateTime": { - "description": "Output only. [Output only] Update time stamp", + "description": "Output only. The timestamp when the resource was most recently updated. See https://google.aip.dev/148#timestamps.", "format": "google-datetime", "readOnly": true, "type": "string" @@ -6566,21 +6617,21 @@ "type": "object" }, "InterceptEndpointGroupAssociationDetails": { - "description": "This is a subset of the InterceptEndpointGroupAssociation message, containing fields to be used by the consumer.", + "description": "The endpoint group's view of a connected association.", "id": "InterceptEndpointGroupAssociationDetails", "properties": { "name": { - "description": "Output only. The resource name of the InterceptEndpointGroupAssociation. Format: projects/{project}/locations/{location}/interceptEndpointGroupAssociations/{interceptEndpointGroupAssociation}", + "description": "Output only. The connected association's resource name, for example: `projects/123456789/locations/global/interceptEndpointGroupAssociations/my-ega`. See https://google.aip.dev/124.", "readOnly": true, "type": "string" }, "network": { - "description": "Output only. The VPC network associated. Format: projects/{project}/global/networks/{name}.", + "description": "Output only. The associated network, for example: projects/123456789/global/networks/my-network. See https://google.aip.dev/124.", "readOnly": true, "type": "string" }, "state": { - "description": "Output only. Current state of the association.", + "description": "Output only. Most recent known state of the association.", "enum": [ "STATE_UNSPECIFIED", "ACTIVE", @@ -6592,11 +6643,11 @@ ], "enumDescriptions": [ "Not set.", - "Ready.", - "Being created.", - "Being deleted.", - "Intercept is disabled due to an operation on another resource.", - "The underlying data plane is out of sync with the association. The association is not expected to be usable. This state can result in undefined behavior. See the `locations_details` field for more details.", + "The association is ready and in sync with the linked endpoint group.", + "The association is being created.", + "The association is being deleted.", + "The association is disabled due to a breaking change in another resource.", + "The association is out of sync with the linked endpoint group. In most cases, this is a result of a transient issue within the system (e.g. an inaccessible location) and the system is expected to recover automatically. Check the `locations_details` field for more details.", "An attempt to delete the association has failed. This is a terminal state and the association is not expected to be usable as some of its resources have been deleted. The only permitted operation is to retry deleting the association." ], "readOnly": true, @@ -6606,16 +6657,16 @@ "type": "object" }, "InterceptEndpointGroupAssociationLocationDetails": { - "description": "Details about the association status in a specific cloud location.", + "description": "Contains details about the state of an association in a specific cloud location.", "id": "InterceptEndpointGroupAssociationLocationDetails", "properties": { "location": { - "description": "Output only. The cloud location.", + "description": "Output only. The cloud location, e.g. \"us-central1-a\" or \"asia-south1\".", "readOnly": true, "type": "string" }, "state": { - "description": "Output only. The association state in this location.", + "description": "Output only. The current state of the association in this location.", "enum": [ "STATE_UNSPECIFIED", "ACTIVE", @@ -6623,8 +6674,8 @@ ], "enumDescriptions": [ "Not set.", - "Ready.", - "The data plane is out of sync with the association in this location." + "The association is ready and in sync with the linked endpoint group.", + "The association is out of sync with the linked endpoint group. In most cases, this is a result of a transient issue within the system (e.g. an inaccessible location) and the system is expected to recover automatically." ], "readOnly": true, "type": "string" @@ -6684,6 +6735,13 @@ "nextPageToken": { "description": "If there might be more results than those appearing in this response, then `next_page_token` is included. To get the next set of results, call this method again using the value of `next_page_token` as `page_token`.", "type": "string" + }, + "unreachable": { + "description": "Locations that could not be reached.", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" @@ -6875,36 +6933,36 @@ "type": "object" }, "ListInterceptDeploymentGroupsResponse": { - "description": "Message for response to listing InterceptDeploymentGroups", + "description": "Response message for ListInterceptDeploymentGroups.", "id": "ListInterceptDeploymentGroupsResponse", "properties": { "interceptDeploymentGroups": { - "description": "The list of InterceptDeploymentGroup", + "description": "The deployment groups from the specified parent.", "items": { "$ref": "InterceptDeploymentGroup" }, "type": "array" }, "nextPageToken": { - "description": "A token identifying a page of results the server should return.", + "description": "A token that can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages. See https://google.aip.dev/158 for more details.", "type": "string" } }, "type": "object" }, "ListInterceptDeploymentsResponse": { - "description": "Message for response to listing InterceptDeployments", + "description": "Response message for ListInterceptDeployments.", "id": "ListInterceptDeploymentsResponse", "properties": { "interceptDeployments": { - "description": "The list of InterceptDeployment", + "description": "The deployments from the specified parent.", "items": { "$ref": "InterceptDeployment" }, "type": "array" }, "nextPageToken": { - "description": "A token identifying a page of results the server should return.", + "description": "A token that can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages. See https://google.aip.dev/158 for more details.", "type": "string" }, "unreachable": { @@ -6918,36 +6976,36 @@ "type": "object" }, "ListInterceptEndpointGroupAssociationsResponse": { - "description": "Message for response to listing InterceptEndpointGroupAssociations", + "description": "Response message for ListInterceptEndpointGroupAssociations.", "id": "ListInterceptEndpointGroupAssociationsResponse", "properties": { "interceptEndpointGroupAssociations": { - "description": "The list of InterceptEndpointGroupAssociation", + "description": "The associations from the specified parent.", "items": { "$ref": "InterceptEndpointGroupAssociation" }, "type": "array" }, "nextPageToken": { - "description": "A token identifying a page of results the server should return.", + "description": "A token that can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages. See https://google.aip.dev/158 for more details.", "type": "string" } }, "type": "object" }, "ListInterceptEndpointGroupsResponse": { - "description": "Message for response to listing InterceptEndpointGroups", + "description": "Response message for ListInterceptEndpointGroups.", "id": "ListInterceptEndpointGroupsResponse", "properties": { "interceptEndpointGroups": { - "description": "The list of InterceptEndpointGroup", + "description": "The endpoint groups from the specified parent.", "items": { "$ref": "InterceptEndpointGroup" }, "type": "array" }, "nextPageToken": { - "description": "A token identifying a page of results the server should return.", + "description": "A token that can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages. See https://google.aip.dev/158 for more details.", "type": "string" } }, @@ -6972,36 +7030,36 @@ "type": "object" }, "ListMirroringDeploymentGroupsResponse": { - "description": "Message for response to listing MirroringDeploymentGroups", + "description": "Response message for ListMirroringDeploymentGroups.", "id": "ListMirroringDeploymentGroupsResponse", "properties": { "mirroringDeploymentGroups": { - "description": "The list of MirroringDeploymentGroup", + "description": "The deployment groups from the specified parent.", "items": { "$ref": "MirroringDeploymentGroup" }, "type": "array" }, "nextPageToken": { - "description": "A token identifying a page of results the server should return.", + "description": "A token that can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages. See https://google.aip.dev/158 for more details.", "type": "string" } }, "type": "object" }, "ListMirroringDeploymentsResponse": { - "description": "Message for response to listing MirroringDeployments", + "description": "Response message for ListMirroringDeployments.", "id": "ListMirroringDeploymentsResponse", "properties": { "mirroringDeployments": { - "description": "The list of MirroringDeployment", + "description": "The deployments from the specified parent.", "items": { "$ref": "MirroringDeployment" }, "type": "array" }, "nextPageToken": { - "description": "A token identifying a page of results the server should return.", + "description": "A token that can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages. See https://google.aip.dev/158 for more details.", "type": "string" }, "unreachable": { @@ -7015,36 +7073,36 @@ "type": "object" }, "ListMirroringEndpointGroupAssociationsResponse": { - "description": "Response message for listing associations.", + "description": "Response message for ListMirroringEndpointGroupAssociations.", "id": "ListMirroringEndpointGroupAssociationsResponse", "properties": { "mirroringEndpointGroupAssociations": { - "description": "The list of associations returned.", + "description": "The associations from the specified parent.", "items": { "$ref": "MirroringEndpointGroupAssociation" }, "type": "array" }, "nextPageToken": { - "description": "A token identifying a page of results the server should return. See https://google.aip.dev/158.", + "description": "A token that can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages. See https://google.aip.dev/158 for more details.", "type": "string" } }, "type": "object" }, "ListMirroringEndpointGroupsResponse": { - "description": "Message for response to listing MirroringEndpointGroups", + "description": "Response message for ListMirroringEndpointGroups.", "id": "ListMirroringEndpointGroupsResponse", "properties": { "mirroringEndpointGroups": { - "description": "The list of MirroringEndpointGroup", + "description": "The endpoint groups from the specified parent.", "items": { "$ref": "MirroringEndpointGroup" }, "type": "array" }, "nextPageToken": { - "description": "A token identifying a page of results the server should return.", + "description": "A token that can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages. See https://google.aip.dev/158 for more details.", "type": "string" } }, @@ -7339,6 +7397,14 @@ "description": "Immutable. Identifier. The resource name of this deployment group, for example: `projects/123456789/locations/global/mirroringDeploymentGroups/my-dg`. See https://google.aip.dev/122 for more details.", "type": "string" }, + "nestedDeployments": { + "description": "Output only. The list of Mirroring Deployments that belong to this group.", + "items": { + "$ref": "MirroringDeploymentGroupDeployment" + }, + "readOnly": true, + "type": "array" + }, "network": { "description": "Required. Immutable. The network that will be used for all child deployments, for example: `projects/{project}/global/networks/{network}`. See https://google.aip.dev/124.", "type": "string" @@ -7386,6 +7452,39 @@ }, "type": "object" }, + "MirroringDeploymentGroupDeployment": { + "description": "A deployment belonging to this deployment group.", + "id": "MirroringDeploymentGroupDeployment", + "properties": { + "name": { + "description": "Output only. The name of the Mirroring Deployment, in the format: `projects/{project}/locations/{location}/mirroringDeployments/{mirroring_deployment}`.", + "readOnly": true, + "type": "string" + }, + "state": { + "description": "Output only. Most recent known state of the deployment.", + "enum": [ + "STATE_UNSPECIFIED", + "ACTIVE", + "CREATING", + "DELETING", + "OUT_OF_SYNC", + "DELETE_FAILED" + ], + "enumDescriptions": [ + "State not set (this is not a valid state).", + "The deployment is ready and in sync with the parent group.", + "The deployment is being created.", + "The deployment is being deleted.", + "The deployment is out of sync with the parent group. In most cases, this is a result of a transient issue within the system (e.g. a delayed data-path config) and the system is expected to recover automatically. See the parent deployment group's state for more details.", + "An attempt to delete the deployment has failed. This is a terminal state and the deployment is not expected to recover. The only permitted operation is to retry deleting the deployment." + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "MirroringEndpointGroup": { "description": "An endpoint group is a consumer frontend for a deployment group (backend). In order to configure mirroring for a network, consumers must create: - An association between their network and the endpoint group. - A security profile that points to the endpoint group. - A mirroring rule that references the security profile (group).", "id": "MirroringEndpointGroup", @@ -7516,9 +7615,9 @@ "enumDescriptions": [ "Not set.", "The association is ready and in sync with the linked endpoint group.", - "Being created.", - "Being deleted.", - "Mirroring is disabled due to an operation on another resource.", + "The association is being created.", + "The association is being deleted.", + "The association is disabled due to a breaking change in another resource.", "The association is out of sync with the linked endpoint group. In most cases, this is a result of a transient issue within the system (e.g. an inaccessible location) and the system is expected to recover automatically. Check the `locations_details` field for more details.", "An attempt to delete the association has failed. This is a terminal state and the association is not expected to be usable as some of its resources have been deleted. The only permitted operation is to retry deleting the association." ], @@ -7562,9 +7661,9 @@ "enumDescriptions": [ "Not set.", "The association is ready and in sync with the linked endpoint group.", - "Being created.", - "Being deleted.", - "Mirroring is disabled due to an operation on another resource.", + "The association is being created.", + "The association is being deleted.", + "The association is disabled due to a breaking change in another resource.", "The association is out of sync with the linked endpoint group. In most cases, this is a result of a transient issue within the system (e.g. an inaccessible location) and the system is expected to recover automatically. Check the `locations_details` field for more details.", "An attempt to delete the association has failed. This is a terminal state and the association is not expected to be usable as some of its resources have been deleted. The only permitted operation is to retry deleting the association." ], diff --git a/networksecurity/v1beta1/networksecurity-gen.go b/networksecurity/v1beta1/networksecurity-gen.go index 5f35df9e9c3..387ae61aa74 100644 --- a/networksecurity/v1beta1/networksecurity-gen.go +++ b/networksecurity/v1beta1/networksecurity-gen.go @@ -829,11 +829,13 @@ func (s AuthzPolicyAuthzRuleFrom) MarshalJSON() ([]byte, error) { type AuthzPolicyAuthzRuleFromRequestSource struct { // Principals: Optional. A list of identities derived from the client's // certificate. This field will not match on a request unless mutual TLS is - // enabled for the Forwarding rule or Gateway. Each identity is a string whose - // value is matched against the URI SAN, or DNS SAN or the subject field in the - // client's certificate. The match can be exact, prefix, suffix or a substring - // match. One of exact, prefix, suffix or contains must be specified. Limited - // to 5 principals. + // enabled for the forwarding rule or Gateway. For Application Load Balancers, + // each identity is a string whose value is matched against the URI SAN, or DNS + // SAN, or SPIFFE ID, or the subject field in the client's certificate. For + // Cloud Service Mesh, each identity is a string whose value is matched against + // the URI SAN, or DNS SAN, or the subject field in the client's certificate. + // The match can be exact, prefix, suffix, or a substring match. One of exact, + // prefix, suffix, or contains must be specified. Limited to 5 principals. Principals []*AuthzPolicyAuthzRuleStringMatch `json:"principals,omitempty"` // Resources: Optional. A list of resources to match against the resource of // the source VM of a request. Limited to 5 resources. @@ -2195,46 +2197,58 @@ func (s HttpHeaderMatch) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// InterceptDeployment: Message describing InterceptDeployment object NEXT ID: -// 10 +// InterceptDeployment: A deployment represents a zonal intercept backend ready +// to accept GENEVE-encapsulated traffic, e.g. a zonal instance group fronted +// by an internal passthrough load balancer. Deployments are always part of a +// global deployment group which represents a global intercept service. type InterceptDeployment struct { - // CreateTime: Output only. [Output only] Create time stamp + // CreateTime: Output only. The timestamp when the resource was created. See + // https://google.aip.dev/148#timestamps. CreateTime string `json:"createTime,omitempty"` // Description: Optional. User-provided description of the deployment. Used as // additional context for the deployment. Description string `json:"description,omitempty"` - // ForwardingRule: Required. Immutable. The regional load balancer which the - // intercepted traffic should be forwarded to. Format is: - // projects/{project}/regions/{region}/forwardingRules/{forwardingRule} + // ForwardingRule: Required. Immutable. The regional forwarding rule that + // fronts the intercept collectors, for example: + // `projects/123456789/regions/us-central1/forwardingRules/my-rule`. See + // https://google.aip.dev/124. ForwardingRule string `json:"forwardingRule,omitempty"` - // InterceptDeploymentGroup: Required. Immutable. The Intercept Deployment - // Group that this resource is part of. Format is: - // `projects/{project}/locations/global/interceptDeploymentGroups/{interceptDepl - // oymentGroup}` + // InterceptDeploymentGroup: Required. Immutable. The deployment group that + // this deployment is a part of, for example: + // `projects/123456789/locations/global/interceptDeploymentGroups/my-dg`. See + // https://google.aip.dev/124. InterceptDeploymentGroup string `json:"interceptDeploymentGroup,omitempty"` - // Labels: Optional. Labels as key value pairs + // Labels: Optional. Labels are key/value pairs that help to organize and + // filter resources. Labels map[string]string `json:"labels,omitempty"` - // Name: Immutable. Identifier. The name of the InterceptDeployment. + // Name: Immutable. Identifier. The resource name of this deployment, for + // example: + // `projects/123456789/locations/us-central1-a/interceptDeployments/my-dep`. + // See https://google.aip.dev/122 for more details. Name string `json:"name,omitempty"` - // Reconciling: Output only. Whether reconciling is in progress, recommended - // per https://google.aip.dev/128. + // Reconciling: Output only. The current state of the resource does not match + // the user's intended state, and the system is working to reconcile them. This + // part of the normal operation (e.g. linking a new association to the parent + // group). See https://google.aip.dev/128. Reconciling bool `json:"reconciling,omitempty"` - // State: Output only. Current state of the deployment. + // State: Output only. The current state of the deployment. See + // https://google.aip.dev/216. // // Possible values: - // "STATE_UNSPECIFIED" - Not set. - // "ACTIVE" - Ready. - // "CREATING" - Being created. - // "DELETING" - Being deleted. - // "OUT_OF_SYNC" - The underlying data plane is out of sync with the - // deployment. The deployment is not expected to be usable. This state can - // result in undefined behavior. + // "STATE_UNSPECIFIED" - State not set (this is not a valid state). + // "ACTIVE" - The deployment is ready and in sync with the parent group. + // "CREATING" - The deployment is being created. + // "DELETING" - The deployment is being deleted. + // "OUT_OF_SYNC" - The deployment is out of sync with the parent group. In + // most cases, this is a result of a transient issue within the system (e.g. a + // delayed data-path config) and the system is expected to recover + // automatically. See the parent deployment group's state for more details. // "DELETE_FAILED" - An attempt to delete the deployment has failed. This is - // a terminal state and the deployment is not expected to be usable as some of - // its resources have been deleted. The only permitted operation is to retry - // deleting the deployment. + // a terminal state and the deployment is not expected to recover. The only + // permitted operation is to retry deleting the deployment. State string `json:"state,omitempty"` - // UpdateTime: Output only. [Output only] Update time stamp + // UpdateTime: Output only. The timestamp when the resource was most recently + // updated. See https://google.aip.dev/148#timestamps. UpdateTime string `json:"updateTime,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -2257,35 +2271,50 @@ func (s InterceptDeployment) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// InterceptDeploymentGroup: Message describing InterceptDeploymentGroup object +// InterceptDeploymentGroup: A deployment group aggregates many zonal intercept +// backends (deployments) into a single global intercept service. Consumers can +// connect this service using an endpoint group. type InterceptDeploymentGroup struct { - // ConnectedEndpointGroups: Output only. The list of Intercept Endpoint Groups - // that are connected to this resource. + // ConnectedEndpointGroups: Output only. The list of endpoint groups that are + // connected to this resource. ConnectedEndpointGroups []*InterceptDeploymentGroupConnectedEndpointGroup `json:"connectedEndpointGroups,omitempty"` - // CreateTime: Output only. [Output only] Create time stamp + // CreateTime: Output only. The timestamp when the resource was created. See + // https://google.aip.dev/148#timestamps. CreateTime string `json:"createTime,omitempty"` // Description: Optional. User-provided description of the deployment group. // Used as additional context for the deployment group. Description string `json:"description,omitempty"` - // Labels: Optional. Labels as key value pairs + // Labels: Optional. Labels are key/value pairs that help to organize and + // filter resources. Labels map[string]string `json:"labels,omitempty"` - // Name: Immutable. Identifier. Then name of the InterceptDeploymentGroup. + // Name: Immutable. Identifier. The resource name of this deployment group, for + // example: + // `projects/123456789/locations/global/interceptDeploymentGroups/my-dg`. See + // https://google.aip.dev/122 for more details. Name string `json:"name,omitempty"` - // Network: Required. Immutable. The network that is being used for the - // deployment. Format is: projects/{project}/global/networks/{network}. + // NestedDeployments: Output only. The list of Intercept Deployments that + // belong to this group. + NestedDeployments []*InterceptDeploymentGroupDeployment `json:"nestedDeployments,omitempty"` + // Network: Required. Immutable. The network that will be used for all child + // deployments, for example: `projects/{project}/global/networks/{network}`. + // See https://google.aip.dev/124. Network string `json:"network,omitempty"` - // Reconciling: Output only. Whether reconciling is in progress, recommended - // per https://google.aip.dev/128. + // Reconciling: Output only. The current state of the resource does not match + // the user's intended state, and the system is working to reconcile them. This + // is part of the normal operation (e.g. adding a new deployment to the group) + // See https://google.aip.dev/128. Reconciling bool `json:"reconciling,omitempty"` - // State: Output only. Current state of the deployment group. + // State: Output only. The current state of the deployment group. See + // https://google.aip.dev/216. // // Possible values: - // "STATE_UNSPECIFIED" - Not set. - // "ACTIVE" - Ready. - // "CREATING" - Being created. - // "DELETING" - Being deleted. + // "STATE_UNSPECIFIED" - State not set (this is not a valid state). + // "ACTIVE" - The deployment group is ready. + // "CREATING" - The deployment group is being created. + // "DELETING" - The deployment group is being deleted. State string `json:"state,omitempty"` - // UpdateTime: Output only. [Output only] Update time stamp + // UpdateTime: Output only. The timestamp when the resource was most recently + // updated. See https://google.aip.dev/148#timestamps. UpdateTime string `json:"updateTime,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -2311,7 +2340,10 @@ func (s InterceptDeploymentGroup) MarshalJSON() ([]byte, error) { // InterceptDeploymentGroupConnectedEndpointGroup: An endpoint group connected // to this deployment group. type InterceptDeploymentGroupConnectedEndpointGroup struct { - // Name: Output only. A connected intercept endpoint group. + // Name: Output only. The connected endpoint group's resource name, for + // example: + // `projects/123456789/locations/global/interceptEndpointGroups/my-eg`. See + // https://google.aip.dev/124. Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "Name") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -2331,45 +2363,101 @@ func (s InterceptDeploymentGroupConnectedEndpointGroup) MarshalJSON() ([]byte, e return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// InterceptEndpointGroup: Message describing InterceptEndpointGroup object. +// InterceptDeploymentGroupDeployment: A deployment belonging to this +// deployment group. +type InterceptDeploymentGroupDeployment struct { + // Name: Output only. The name of the Intercept Deployment, in the format: + // `projects/{project}/locations/{location}/interceptDeployments/{intercept_depl + // oyment}`. + Name string `json:"name,omitempty"` + // State: Output only. Most recent known state of the deployment. + // + // Possible values: + // "STATE_UNSPECIFIED" - State not set (this is not a valid state). + // "ACTIVE" - The deployment is ready and in sync with the parent group. + // "CREATING" - The deployment is being created. + // "DELETING" - The deployment is being deleted. + // "OUT_OF_SYNC" - The deployment is out of sync with the parent group. In + // most cases, this is a result of a transient issue within the system (e.g. a + // delayed data-path config) and the system is expected to recover + // automatically. See the parent deployment group's state for more details. + // "DELETE_FAILED" - An attempt to delete the deployment has failed. This is + // a terminal state and the deployment is not expected to recover. The only + // permitted operation is to retry deleting the deployment. + State string `json:"state,omitempty"` + // ForceSendFields is a list of field names (e.g. "Name") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Name") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s InterceptDeploymentGroupDeployment) MarshalJSON() ([]byte, error) { + type NoMethod InterceptDeploymentGroupDeployment + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// InterceptEndpointGroup: An endpoint group is a consumer frontend for a +// deployment group (backend). In order to configure intercept for a network, +// consumers must create: - An association between their network and the +// endpoint group. - A security profile that points to the endpoint group. - A +// firewall rule that references the security profile (group). type InterceptEndpointGroup struct { - // Associations: Output only. List of Intercept Endpoint Group Associations - // that are associated to this endpoint group. + // Associations: Output only. List of associations to this endpoint group. Associations []*InterceptEndpointGroupAssociationDetails `json:"associations,omitempty"` - // CreateTime: Output only. [Output only] Create time stamp + // CreateTime: Output only. The timestamp when the resource was created. See + // https://google.aip.dev/148#timestamps. CreateTime string `json:"createTime,omitempty"` // Description: Optional. User-provided description of the endpoint group. Used // as additional context for the endpoint group. Description string `json:"description,omitempty"` - // InterceptDeploymentGroup: Required. Immutable. The Intercept Deployment - // Group that this resource is connected to. Format is: - // `projects/{project}/locations/global/interceptDeploymentGroups/{interceptDepl - // oymentGroup}` + // InterceptDeploymentGroup: Immutable. The deployment group that this endpoint + // group is connected to, for example: + // `projects/123456789/locations/global/interceptDeploymentGroups/my-dg`. See + // https://google.aip.dev/124. InterceptDeploymentGroup string `json:"interceptDeploymentGroup,omitempty"` - // Labels: Optional. Labels as key value pairs + // Labels: Optional. Labels are key/value pairs that help to organize and + // filter resources. Labels map[string]string `json:"labels,omitempty"` - // Name: Immutable. Identifier. The name of the InterceptEndpointGroup. + // Name: Immutable. Identifier. The resource name of this endpoint group, for + // example: + // `projects/123456789/locations/global/interceptEndpointGroups/my-eg`. See + // https://google.aip.dev/122 for more details. Name string `json:"name,omitempty"` - // Reconciling: Output only. Whether reconciling is in progress, recommended - // per https://google.aip.dev/128. + // Reconciling: Output only. The current state of the resource does not match + // the user's intended state, and the system is working to reconcile them. This + // is part of the normal operation (e.g. adding a new association to the + // group). See https://google.aip.dev/128. Reconciling bool `json:"reconciling,omitempty"` - // State: Output only. Current state of the endpoint group. + // State: Output only. The current state of the endpoint group. See + // https://google.aip.dev/216. // // Possible values: - // "STATE_UNSPECIFIED" - Not set. - // "ACTIVE" - Ready. - // "CLOSED" - The deployment group has been deleted and intercept is - // disabled. - // "CREATING" - Being created. - // "DELETING" - Being deleted. - // "OUT_OF_SYNC" - The underlying data plane is out of sync with the endpoint - // group. Some associations might not be usable. + // "STATE_UNSPECIFIED" - State not set (this is not a valid state). + // "ACTIVE" - The endpoint group is ready and in sync with the target + // deployment group. + // "CLOSED" - The deployment group backing this endpoint group has been + // force-deleted. This endpoint group cannot be used and interception is + // effectively disabled. + // "CREATING" - The endpoint group is being created. + // "DELETING" - The endpoint group is being deleted. + // "OUT_OF_SYNC" - The endpoint group is out of sync with the backing + // deployment group. In most cases, this is a result of a transient issue + // within the system (e.g. an inaccessible location) and the system is expected + // to recover automatically. See the associations field for details per network + // and location. // "DELETE_FAILED" - An attempt to delete the endpoint group has failed. This - // is a terminal state and the endpoint group is not expected to be usable as - // some of its resources have been deleted. The only permitted operation is to - // retry deleting the endpoint group. + // is a terminal state and the endpoint group is not expected to recover. The + // only permitted operation is to retry deleting the endpoint group. State string `json:"state,omitempty"` - // UpdateTime: Output only. [Output only] Update time stamp + // UpdateTime: Output only. The timestamp when the resource was most recently + // updated. See https://google.aip.dev/148#timestamps. UpdateTime string `json:"updateTime,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -2392,48 +2480,63 @@ func (s InterceptEndpointGroup) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// InterceptEndpointGroupAssociation: Message describing -// InterceptEndpointGroupAssociation object +// InterceptEndpointGroupAssociation: An endpoint group association represents +// a link between a network and an endpoint group in the organization. Creating +// an association creates the networking infrastructure linking the network to +// the endpoint group, but does not enable intercept by itself. To enable +// intercept, the user must also create a network firewall policy containing +// intercept rules and associate it with the network. type InterceptEndpointGroupAssociation struct { - // CreateTime: Output only. [Output only] Create time stamp + // CreateTime: Output only. The timestamp when the resource was created. See + // https://google.aip.dev/148#timestamps. CreateTime string `json:"createTime,omitempty"` - // InterceptEndpointGroup: Required. Immutable. The Intercept Endpoint Group - // that this resource is connected to. Format is: - // `projects/{project}/locations/global/interceptEndpointGroups/{interceptEndpoi - // ntGroup}` + // InterceptEndpointGroup: Immutable. The endpoint group that this association + // is connected to, for example: + // `projects/123456789/locations/global/interceptEndpointGroups/my-eg`. See + // https://google.aip.dev/124. InterceptEndpointGroup string `json:"interceptEndpointGroup,omitempty"` - // Labels: Optional. Labels as key value pairs + // Labels: Optional. Labels are key/value pairs that help to organize and + // filter resources. Labels map[string]string `json:"labels,omitempty"` - // LocationsDetails: Output only. The list of locations that this association - // is in and its details. + // LocationsDetails: Output only. The list of locations where the association + // is present. This information is retrieved from the linked endpoint group, + // and not configured as part of the association itself. LocationsDetails []*InterceptEndpointGroupAssociationLocationDetails `json:"locationsDetails,omitempty"` - // Name: Immutable. Identifier. The name of the - // InterceptEndpointGroupAssociation. + // Name: Immutable. Identifier. The resource name of this endpoint group + // association, for example: + // `projects/123456789/locations/global/interceptEndpointGroupAssociations/my-eg + // -association`. See https://google.aip.dev/122 for more details. Name string `json:"name,omitempty"` - // Network: Required. Immutable. The VPC network associated. Format: - // projects/{project}/global/networks/{network}. + // Network: Immutable. The VPC network that is associated. for example: + // `projects/123456789/global/networks/my-network`. See + // https://google.aip.dev/124. Network string `json:"network,omitempty"` - // Reconciling: Output only. Whether reconciling is in progress, recommended - // per https://google.aip.dev/128. + // Reconciling: Output only. The current state of the resource does not match + // the user's intended state, and the system is working to reconcile them. This + // part of the normal operation (e.g. adding a new location to the target + // deployment group). See https://google.aip.dev/128. Reconciling bool `json:"reconciling,omitempty"` // State: Output only. Current state of the endpoint group association. // // Possible values: // "STATE_UNSPECIFIED" - Not set. - // "ACTIVE" - Ready. - // "CREATING" - Being created. - // "DELETING" - Being deleted. - // "CLOSED" - Intercept is disabled due to an operation on another resource. - // "OUT_OF_SYNC" - The underlying data plane is out of sync with the - // association. The association is not expected to be usable. This state can - // result in undefined behavior. See the `locations_details` field for more - // details. + // "ACTIVE" - The association is ready and in sync with the linked endpoint + // group. + // "CREATING" - The association is being created. + // "DELETING" - The association is being deleted. + // "CLOSED" - The association is disabled due to a breaking change in another + // resource. + // "OUT_OF_SYNC" - The association is out of sync with the linked endpoint + // group. In most cases, this is a result of a transient issue within the + // system (e.g. an inaccessible location) and the system is expected to recover + // automatically. Check the `locations_details` field for more details. // "DELETE_FAILED" - An attempt to delete the association has failed. This is // a terminal state and the association is not expected to be usable as some of // its resources have been deleted. The only permitted operation is to retry // deleting the association. State string `json:"state,omitempty"` - // UpdateTime: Output only. [Output only] Update time stamp + // UpdateTime: Output only. The timestamp when the resource was most recently + // updated. See https://google.aip.dev/148#timestamps. UpdateTime string `json:"updateTime,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -2456,30 +2559,31 @@ func (s InterceptEndpointGroupAssociation) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// InterceptEndpointGroupAssociationDetails: This is a subset of the -// InterceptEndpointGroupAssociation message, containing fields to be used by -// the consumer. +// InterceptEndpointGroupAssociationDetails: The endpoint group's view of a +// connected association. type InterceptEndpointGroupAssociationDetails struct { - // Name: Output only. The resource name of the - // InterceptEndpointGroupAssociation. Format: - // projects/{project}/locations/{location}/interceptEndpointGroupAssociations/{i - // nterceptEndpointGroupAssociation} + // Name: Output only. The connected association's resource name, for example: + // `projects/123456789/locations/global/interceptEndpointGroupAssociations/my-eg + // a`. See https://google.aip.dev/124. Name string `json:"name,omitempty"` - // Network: Output only. The VPC network associated. Format: - // projects/{project}/global/networks/{name}. + // Network: Output only. The associated network, for example: + // projects/123456789/global/networks/my-network. See + // https://google.aip.dev/124. Network string `json:"network,omitempty"` - // State: Output only. Current state of the association. + // State: Output only. Most recent known state of the association. // // Possible values: // "STATE_UNSPECIFIED" - Not set. - // "ACTIVE" - Ready. - // "CREATING" - Being created. - // "DELETING" - Being deleted. - // "CLOSED" - Intercept is disabled due to an operation on another resource. - // "OUT_OF_SYNC" - The underlying data plane is out of sync with the - // association. The association is not expected to be usable. This state can - // result in undefined behavior. See the `locations_details` field for more - // details. + // "ACTIVE" - The association is ready and in sync with the linked endpoint + // group. + // "CREATING" - The association is being created. + // "DELETING" - The association is being deleted. + // "CLOSED" - The association is disabled due to a breaking change in another + // resource. + // "OUT_OF_SYNC" - The association is out of sync with the linked endpoint + // group. In most cases, this is a result of a transient issue within the + // system (e.g. an inaccessible location) and the system is expected to recover + // automatically. Check the `locations_details` field for more details. // "DELETE_FAILED" - An attempt to delete the association has failed. This is // a terminal state and the association is not expected to be usable as some of // its resources have been deleted. The only permitted operation is to retry @@ -2503,18 +2607,22 @@ func (s InterceptEndpointGroupAssociationDetails) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// InterceptEndpointGroupAssociationLocationDetails: Details about the -// association status in a specific cloud location. +// InterceptEndpointGroupAssociationLocationDetails: Contains details about the +// state of an association in a specific cloud location. type InterceptEndpointGroupAssociationLocationDetails struct { - // Location: Output only. The cloud location. + // Location: Output only. The cloud location, e.g. "us-central1-a" or + // "asia-south1". Location string `json:"location,omitempty"` - // State: Output only. The association state in this location. + // State: Output only. The current state of the association in this location. // // Possible values: // "STATE_UNSPECIFIED" - Not set. - // "ACTIVE" - Ready. - // "OUT_OF_SYNC" - The data plane is out of sync with the association in this - // location. + // "ACTIVE" - The association is ready and in sync with the linked endpoint + // group. + // "OUT_OF_SYNC" - The association is out of sync with the linked endpoint + // group. In most cases, this is a result of a transient issue within the + // system (e.g. an inaccessible location) and the system is expected to recover + // automatically. State string `json:"state,omitempty"` // ForceSendFields is a list of field names (e.g. "Location") to // unconditionally include in API requests. By default, fields with empty or @@ -2604,6 +2712,8 @@ type ListAddressGroupsResponse struct { // results, call this method again using the value of `next_page_token` as // `page_token`. 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:"-"` @@ -2878,13 +2988,14 @@ func (s ListGatewaySecurityPolicyRulesResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// ListInterceptDeploymentGroupsResponse: Message for response to listing -// InterceptDeploymentGroups +// ListInterceptDeploymentGroupsResponse: Response message for +// ListInterceptDeploymentGroups. type ListInterceptDeploymentGroupsResponse struct { - // InterceptDeploymentGroups: The list of InterceptDeploymentGroup + // InterceptDeploymentGroups: The deployment groups from the specified parent. InterceptDeploymentGroups []*InterceptDeploymentGroup `json:"interceptDeploymentGroups,omitempty"` - // NextPageToken: A token identifying a page of results the server should - // return. + // NextPageToken: A token that can be sent as `page_token` to retrieve the next + // page. If this field is omitted, there are no subsequent pages. See + // https://google.aip.dev/158 for more details. NextPageToken string `json:"nextPageToken,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -2907,13 +3018,14 @@ func (s ListInterceptDeploymentGroupsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// ListInterceptDeploymentsResponse: Message for response to listing -// InterceptDeployments +// ListInterceptDeploymentsResponse: Response message for +// ListInterceptDeployments. type ListInterceptDeploymentsResponse struct { - // InterceptDeployments: The list of InterceptDeployment + // InterceptDeployments: The deployments from the specified parent. InterceptDeployments []*InterceptDeployment `json:"interceptDeployments,omitempty"` - // NextPageToken: A token identifying a page of results the server should - // return. + // NextPageToken: A token that can be sent as `page_token` to retrieve the next + // page. If this field is omitted, there are no subsequent pages. See + // https://google.aip.dev/158 for more details. NextPageToken string `json:"nextPageToken,omitempty"` // Unreachable: Locations that could not be reached. Unreachable []string `json:"unreachable,omitempty"` @@ -2938,14 +3050,15 @@ func (s ListInterceptDeploymentsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// ListInterceptEndpointGroupAssociationsResponse: Message for response to -// listing InterceptEndpointGroupAssociations +// ListInterceptEndpointGroupAssociationsResponse: Response message for +// ListInterceptEndpointGroupAssociations. type ListInterceptEndpointGroupAssociationsResponse struct { - // InterceptEndpointGroupAssociations: The list of - // InterceptEndpointGroupAssociation + // InterceptEndpointGroupAssociations: The associations from the specified + // parent. InterceptEndpointGroupAssociations []*InterceptEndpointGroupAssociation `json:"interceptEndpointGroupAssociations,omitempty"` - // NextPageToken: A token identifying a page of results the server should - // return. + // NextPageToken: A token that can be sent as `page_token` to retrieve the next + // page. If this field is omitted, there are no subsequent pages. See + // https://google.aip.dev/158 for more details. NextPageToken string `json:"nextPageToken,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -2970,13 +3083,14 @@ func (s ListInterceptEndpointGroupAssociationsResponse) MarshalJSON() ([]byte, e return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// ListInterceptEndpointGroupsResponse: Message for response to listing -// InterceptEndpointGroups +// ListInterceptEndpointGroupsResponse: Response message for +// ListInterceptEndpointGroups. type ListInterceptEndpointGroupsResponse struct { - // InterceptEndpointGroups: The list of InterceptEndpointGroup + // InterceptEndpointGroups: The endpoint groups from the specified parent. InterceptEndpointGroups []*InterceptEndpointGroup `json:"interceptEndpointGroups,omitempty"` - // NextPageToken: A token identifying a page of results the server should - // return. + // NextPageToken: A token that can be sent as `page_token` to retrieve the next + // page. If this field is omitted, there are no subsequent pages. See + // https://google.aip.dev/158 for more details. NextPageToken string `json:"nextPageToken,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -3027,13 +3141,14 @@ func (s ListLocationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// ListMirroringDeploymentGroupsResponse: Message for response to listing -// MirroringDeploymentGroups +// ListMirroringDeploymentGroupsResponse: Response message for +// ListMirroringDeploymentGroups. type ListMirroringDeploymentGroupsResponse struct { - // MirroringDeploymentGroups: The list of MirroringDeploymentGroup + // MirroringDeploymentGroups: The deployment groups from the specified parent. MirroringDeploymentGroups []*MirroringDeploymentGroup `json:"mirroringDeploymentGroups,omitempty"` - // NextPageToken: A token identifying a page of results the server should - // return. + // NextPageToken: A token that can be sent as `page_token` to retrieve the next + // page. If this field is omitted, there are no subsequent pages. See + // https://google.aip.dev/158 for more details. NextPageToken string `json:"nextPageToken,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -3056,13 +3171,14 @@ func (s ListMirroringDeploymentGroupsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// ListMirroringDeploymentsResponse: Message for response to listing -// MirroringDeployments +// ListMirroringDeploymentsResponse: Response message for +// ListMirroringDeployments. type ListMirroringDeploymentsResponse struct { - // MirroringDeployments: The list of MirroringDeployment + // MirroringDeployments: The deployments from the specified parent. MirroringDeployments []*MirroringDeployment `json:"mirroringDeployments,omitempty"` - // NextPageToken: A token identifying a page of results the server should - // return. + // NextPageToken: A token that can be sent as `page_token` to retrieve the next + // page. If this field is omitted, there are no subsequent pages. See + // https://google.aip.dev/158 for more details. NextPageToken string `json:"nextPageToken,omitempty"` // Unreachable: Locations that could not be reached. Unreachable []string `json:"unreachable,omitempty"` @@ -3087,13 +3203,15 @@ func (s ListMirroringDeploymentsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// ListMirroringEndpointGroupAssociationsResponse: Response message for listing -// associations. +// ListMirroringEndpointGroupAssociationsResponse: Response message for +// ListMirroringEndpointGroupAssociations. type ListMirroringEndpointGroupAssociationsResponse struct { - // MirroringEndpointGroupAssociations: The list of associations returned. + // MirroringEndpointGroupAssociations: The associations from the specified + // parent. MirroringEndpointGroupAssociations []*MirroringEndpointGroupAssociation `json:"mirroringEndpointGroupAssociations,omitempty"` - // NextPageToken: A token identifying a page of results the server should - // return. See https://google.aip.dev/158. + // NextPageToken: A token that can be sent as `page_token` to retrieve the next + // page. If this field is omitted, there are no subsequent pages. See + // https://google.aip.dev/158 for more details. NextPageToken string `json:"nextPageToken,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -3118,13 +3236,14 @@ func (s ListMirroringEndpointGroupAssociationsResponse) MarshalJSON() ([]byte, e return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// ListMirroringEndpointGroupsResponse: Message for response to listing -// MirroringEndpointGroups +// ListMirroringEndpointGroupsResponse: Response message for +// ListMirroringEndpointGroups. type ListMirroringEndpointGroupsResponse struct { - // MirroringEndpointGroups: The list of MirroringEndpointGroup + // MirroringEndpointGroups: The endpoint groups from the specified parent. MirroringEndpointGroups []*MirroringEndpointGroup `json:"mirroringEndpointGroups,omitempty"` - // NextPageToken: A token identifying a page of results the server should - // return. + // NextPageToken: A token that can be sent as `page_token` to retrieve the next + // page. If this field is omitted, there are no subsequent pages. See + // https://google.aip.dev/158 for more details. NextPageToken string `json:"nextPageToken,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -3517,6 +3636,9 @@ type MirroringDeploymentGroup struct { // `projects/123456789/locations/global/mirroringDeploymentGroups/my-dg`. See // https://google.aip.dev/122 for more details. Name string `json:"name,omitempty"` + // NestedDeployments: Output only. The list of Mirroring Deployments that + // belong to this group. + NestedDeployments []*MirroringDeploymentGroupDeployment `json:"nestedDeployments,omitempty"` // Network: Required. Immutable. The network that will be used for all child // deployments, for example: `projects/{project}/global/networks/{network}`. // See https://google.aip.dev/124. @@ -3585,6 +3707,46 @@ func (s MirroringDeploymentGroupConnectedEndpointGroup) MarshalJSON() ([]byte, e return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// MirroringDeploymentGroupDeployment: A deployment belonging to this +// deployment group. +type MirroringDeploymentGroupDeployment struct { + // Name: Output only. The name of the Mirroring Deployment, in the format: + // `projects/{project}/locations/{location}/mirroringDeployments/{mirroring_depl + // oyment}`. + Name string `json:"name,omitempty"` + // State: Output only. Most recent known state of the deployment. + // + // Possible values: + // "STATE_UNSPECIFIED" - State not set (this is not a valid state). + // "ACTIVE" - The deployment is ready and in sync with the parent group. + // "CREATING" - The deployment is being created. + // "DELETING" - The deployment is being deleted. + // "OUT_OF_SYNC" - The deployment is out of sync with the parent group. In + // most cases, this is a result of a transient issue within the system (e.g. a + // delayed data-path config) and the system is expected to recover + // automatically. See the parent deployment group's state for more details. + // "DELETE_FAILED" - An attempt to delete the deployment has failed. This is + // a terminal state and the deployment is not expected to recover. The only + // permitted operation is to retry deleting the deployment. + State string `json:"state,omitempty"` + // ForceSendFields is a list of field names (e.g. "Name") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Name") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s MirroringDeploymentGroupDeployment) MarshalJSON() ([]byte, error) { + type NoMethod MirroringDeploymentGroupDeployment + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // MirroringEndpointGroup: An endpoint group is a consumer frontend for a // deployment group (backend). In order to configure mirroring for a network, // consumers must create: - An association between their network and the @@ -3704,9 +3866,10 @@ type MirroringEndpointGroupAssociation struct { // "STATE_UNSPECIFIED" - Not set. // "ACTIVE" - The association is ready and in sync with the linked endpoint // group. - // "CREATING" - Being created. - // "DELETING" - Being deleted. - // "CLOSED" - Mirroring is disabled due to an operation on another resource. + // "CREATING" - The association is being created. + // "DELETING" - The association is being deleted. + // "CLOSED" - The association is disabled due to a breaking change in another + // resource. // "OUT_OF_SYNC" - The association is out of sync with the linked endpoint // group. In most cases, this is a result of a transient issue within the // system (e.g. an inaccessible location) and the system is expected to recover @@ -3757,9 +3920,10 @@ type MirroringEndpointGroupAssociationDetails struct { // "STATE_UNSPECIFIED" - Not set. // "ACTIVE" - The association is ready and in sync with the linked endpoint // group. - // "CREATING" - Being created. - // "DELETING" - Being deleted. - // "CLOSED" - Mirroring is disabled due to an operation on another resource. + // "CREATING" - The association is being created. + // "DELETING" - The association is being deleted. + // "CLOSED" - The association is disabled due to a breaking change in another + // resource. // "OUT_OF_SYNC" - The association is out of sync with the linked endpoint // group. In most cases, this is a result of a transient issue within the // system (e.g. an inaccessible location) and the system is expected to recover @@ -5117,6 +5281,13 @@ func (c *OrganizationsLocationsAddressGroupsListCall) PageToken(pageToken string return c } +// ReturnPartialSuccess sets the optional parameter "returnPartialSuccess": If +// true, allow partial responses for multi-regional Aggregated List requests. +func (c *OrganizationsLocationsAddressGroupsListCall) ReturnPartialSuccess(returnPartialSuccess bool) *OrganizationsLocationsAddressGroupsListCall { + c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -8912,6 +9083,13 @@ func (c *ProjectsLocationsAddressGroupsListCall) PageToken(pageToken string) *Pr return c } +// ReturnPartialSuccess sets the optional parameter "returnPartialSuccess": If +// true, allow partial responses for multi-regional Aggregated List requests. +func (c *ProjectsLocationsAddressGroupsListCall) ReturnPartialSuccess(returnPartialSuccess bool) *ProjectsLocationsAddressGroupsListCall { + c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -14921,10 +15099,11 @@ type ProjectsLocationsInterceptDeploymentGroupsCreateCall struct { header_ http.Header } -// Create: Creates a new InterceptDeploymentGroup in a given project and -// location. +// Create: Creates a deployment group in a given project and location. See +// https://google.aip.dev/133. // -// - parent: Value for parent. +// - parent: The parent resource where this deployment group will be created. +// Format: projects/{project}/locations/{location}. func (r *ProjectsLocationsInterceptDeploymentGroupsService) Create(parent string, interceptdeploymentgroup *InterceptDeploymentGroup) *ProjectsLocationsInterceptDeploymentGroupsCreateCall { c := &ProjectsLocationsInterceptDeploymentGroupsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -14933,25 +15112,17 @@ func (r *ProjectsLocationsInterceptDeploymentGroupsService) Create(parent string } // InterceptDeploymentGroupId sets the optional parameter -// "interceptDeploymentGroupId": Required. Id of the requesting object If -// auto-generating Id server-side, remove this field and -// intercept_deployment_group_id from the method_signature of Create RPC +// "interceptDeploymentGroupId": Required. The ID to use for the new deployment +// group, which will become the final component of the deployment group's +// resource name. func (c *ProjectsLocationsInterceptDeploymentGroupsCreateCall) InterceptDeploymentGroupId(interceptDeploymentGroupId string) *ProjectsLocationsInterceptDeploymentGroupsCreateCall { c.urlParams_.Set("interceptDeploymentGroupId", interceptDeploymentGroupId) return c } -// RequestId sets the optional parameter "requestId": An optional request ID to -// identify requests. Specify a unique request ID so that if you must retry -// your request, the server will know to ignore the request if it has already -// been completed. The server will guarantee that for at least 60 minutes since -// the first request. For example, consider a situation where you make an -// initial request and the request times out. If you make the request again -// with the same request ID, the server can check if original operation with -// the same request ID was received, and if so, will ignore the second request. -// This prevents clients from accidentally creating duplicate commitments. The -// request ID must be a valid UUID with the exception that zero UUID is not -// supported (00000000-0000-0000-0000-000000000000). +// RequestId sets the optional parameter "requestId": A unique identifier for +// this request. Must be a UUID4. This request is only idempotent if a +// `request_id` is provided. See https://google.aip.dev/155 for more details. func (c *ProjectsLocationsInterceptDeploymentGroupsCreateCall) RequestId(requestId string) *ProjectsLocationsInterceptDeploymentGroupsCreateCall { c.urlParams_.Set("requestId", requestId) return c @@ -15049,26 +15220,18 @@ type ProjectsLocationsInterceptDeploymentGroupsDeleteCall struct { header_ http.Header } -// Delete: Deletes a single InterceptDeploymentGroup. +// Delete: Deletes a deployment group. See https://google.aip.dev/135. // -// - name: Name of the resource. +// - name: The deployment group to delete. func (r *ProjectsLocationsInterceptDeploymentGroupsService) Delete(name string) *ProjectsLocationsInterceptDeploymentGroupsDeleteCall { c := &ProjectsLocationsInterceptDeploymentGroupsDeleteCall{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). +// RequestId sets the optional parameter "requestId": A unique identifier for +// this request. Must be a UUID4. This request is only idempotent if a +// `request_id` is provided. See https://google.aip.dev/155 for more details. func (c *ProjectsLocationsInterceptDeploymentGroupsDeleteCall) RequestId(requestId string) *ProjectsLocationsInterceptDeploymentGroupsDeleteCall { c.urlParams_.Set("requestId", requestId) return c @@ -15163,9 +15326,11 @@ type ProjectsLocationsInterceptDeploymentGroupsGetCall struct { header_ http.Header } -// Get: Gets details of a single InterceptDeploymentGroup. +// Get: Gets a specific deployment group. See https://google.aip.dev/131. // -// - name: Name of the resource. +// - name: The name of the deployment group to retrieve. Format: +// projects/{project}/locations/{location}/interceptDeploymentGroups/{intercep +// t_deployment_group}. func (r *ProjectsLocationsInterceptDeploymentGroupsService) Get(name string) *ProjectsLocationsInterceptDeploymentGroupsGetCall { c := &ProjectsLocationsInterceptDeploymentGroupsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -15273,23 +15438,27 @@ type ProjectsLocationsInterceptDeploymentGroupsListCall struct { header_ http.Header } -// List: Lists InterceptDeploymentGroups in a given project and location. +// List: Lists deployment groups in a given project and location. See +// https://google.aip.dev/132. // -// - parent: Parent value for ListInterceptDeploymentGroupsRequest. +// - parent: The parent, which owns this collection of deployment groups. +// Example: `projects/123456789/locations/global`. See +// https://google.aip.dev/132 for more details. func (r *ProjectsLocationsInterceptDeploymentGroupsService) List(parent string) *ProjectsLocationsInterceptDeploymentGroupsListCall { c := &ProjectsLocationsInterceptDeploymentGroupsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent return c } -// Filter sets the optional parameter "filter": Filtering results +// Filter sets the optional parameter "filter": Filter expression. See +// https://google.aip.dev/160#filtering for more details. func (c *ProjectsLocationsInterceptDeploymentGroupsListCall) Filter(filter string) *ProjectsLocationsInterceptDeploymentGroupsListCall { c.urlParams_.Set("filter", filter) return c } -// OrderBy sets the optional parameter "orderBy": Hint for how to order the -// results +// OrderBy sets the optional parameter "orderBy": Sort expression. See +// https://google.aip.dev/132#ordering for more details. func (c *ProjectsLocationsInterceptDeploymentGroupsListCall) OrderBy(orderBy string) *ProjectsLocationsInterceptDeploymentGroupsListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -15297,14 +15466,17 @@ func (c *ProjectsLocationsInterceptDeploymentGroupsListCall) OrderBy(orderBy str // PageSize sets the optional parameter "pageSize": Requested page size. Server // may return fewer items than requested. If unspecified, server will pick an -// appropriate default. +// appropriate default. See https://google.aip.dev/158 for more details. func (c *ProjectsLocationsInterceptDeploymentGroupsListCall) PageSize(pageSize int64) *ProjectsLocationsInterceptDeploymentGroupsListCall { 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. +// PageToken sets the optional parameter "pageToken": A page token, received +// from a previous `ListInterceptDeploymentGroups` call. Provide this to +// retrieve the subsequent page. When paginating, all other parameters provided +// to `ListInterceptDeploymentGroups` must match the call that provided the +// page token. See https://google.aip.dev/158 for more details. func (c *ProjectsLocationsInterceptDeploymentGroupsListCall) PageToken(pageToken string) *ProjectsLocationsInterceptDeploymentGroupsListCall { c.urlParams_.Set("pageToken", pageToken) return c @@ -15432,9 +15604,12 @@ type ProjectsLocationsInterceptDeploymentGroupsPatchCall struct { header_ http.Header } -// Patch: Updates a single InterceptDeploymentGroup. +// Patch: Updates a deployment group. See https://google.aip.dev/134. // -// - name: Immutable. Identifier. Then name of the InterceptDeploymentGroup. +// - name: Immutable. Identifier. The resource name of this deployment group, +// for example: +// `projects/123456789/locations/global/interceptDeploymentGroups/my-dg`. See +// https://google.aip.dev/122 for more details. func (r *ProjectsLocationsInterceptDeploymentGroupsService) Patch(name string, interceptdeploymentgroup *InterceptDeploymentGroup) *ProjectsLocationsInterceptDeploymentGroupsPatchCall { c := &ProjectsLocationsInterceptDeploymentGroupsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -15442,28 +15617,18 @@ func (r *ProjectsLocationsInterceptDeploymentGroupsService) Patch(name string, i return c } -// RequestId sets the optional parameter "requestId": An optional request ID to -// identify requests. Specify a unique request ID so that if you must retry -// your request, the server will know to ignore the request if it has already -// been completed. The server will guarantee that for at least 60 minutes since -// the first request. For example, consider a situation where you make an -// initial request and the request times out. If you make the request again -// with the same request ID, the server can check if original operation with -// the same request ID was received, and if so, will ignore the second request. -// This prevents clients from accidentally creating duplicate commitments. The -// request ID must be a valid UUID with the exception that zero UUID is not -// supported (00000000-0000-0000-0000-000000000000). +// RequestId sets the optional parameter "requestId": A unique identifier for +// this request. Must be a UUID4. This request is only idempotent if a +// `request_id` is provided. See https://google.aip.dev/155 for more details. func (c *ProjectsLocationsInterceptDeploymentGroupsPatchCall) RequestId(requestId string) *ProjectsLocationsInterceptDeploymentGroupsPatchCall { c.urlParams_.Set("requestId", requestId) return c } -// UpdateMask sets the optional parameter "updateMask": Required. Field mask is -// used to specify the fields to be overwritten in the InterceptDeploymentGroup -// resource by the update. The fields specified in the update_mask are relative -// to the resource, not the full request. A field will be overwritten if it is -// in the mask. If the user does not provide a mask then all fields will be -// overwritten. +// UpdateMask sets the optional parameter "updateMask": The list of fields to +// update. Fields are specified relative to the deployment group (e.g. +// `description`; *not* `intercept_deployment_group.description`). See +// https://google.aip.dev/161 for more details. func (c *ProjectsLocationsInterceptDeploymentGroupsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsInterceptDeploymentGroupsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -15562,9 +15727,11 @@ type ProjectsLocationsInterceptDeploymentsCreateCall struct { header_ http.Header } -// Create: Creates a new InterceptDeployment in a given project and location. +// Create: Creates a deployment in a given project and location. See +// https://google.aip.dev/133. // -// - parent: Value for parent. +// - parent: The parent resource where this deployment will be created. Format: +// projects/{project}/locations/{location}. func (r *ProjectsLocationsInterceptDeploymentsService) Create(parent string, interceptdeployment *InterceptDeployment) *ProjectsLocationsInterceptDeploymentsCreateCall { c := &ProjectsLocationsInterceptDeploymentsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -15573,25 +15740,16 @@ func (r *ProjectsLocationsInterceptDeploymentsService) Create(parent string, int } // InterceptDeploymentId sets the optional parameter "interceptDeploymentId": -// Required. Id of the requesting object If auto-generating Id server-side, -// remove this field and intercept_deployment_id from the method_signature of -// Create RPC +// Required. The ID to use for the new deployment, which will become the final +// component of the deployment's resource name. func (c *ProjectsLocationsInterceptDeploymentsCreateCall) InterceptDeploymentId(interceptDeploymentId string) *ProjectsLocationsInterceptDeploymentsCreateCall { c.urlParams_.Set("interceptDeploymentId", interceptDeploymentId) return c } -// RequestId sets the optional parameter "requestId": An optional request ID to -// identify requests. Specify a unique request ID so that if you must retry -// your request, the server will know to ignore the request if it has already -// been completed. The server will guarantee that for at least 60 minutes since -// the first request. For example, consider a situation where you make an -// initial request and the request times out. If you make the request again -// with the same request ID, the server can check if original operation with -// the same request ID was received, and if so, will ignore the second request. -// This prevents clients from accidentally creating duplicate commitments. The -// request ID must be a valid UUID with the exception that zero UUID is not -// supported (00000000-0000-0000-0000-000000000000). +// RequestId sets the optional parameter "requestId": A unique identifier for +// this request. Must be a UUID4. This request is only idempotent if a +// `request_id` is provided. See https://google.aip.dev/155 for more details. func (c *ProjectsLocationsInterceptDeploymentsCreateCall) RequestId(requestId string) *ProjectsLocationsInterceptDeploymentsCreateCall { c.urlParams_.Set("requestId", requestId) return c @@ -15689,7 +15847,7 @@ type ProjectsLocationsInterceptDeploymentsDeleteCall struct { header_ http.Header } -// Delete: Deletes a single InterceptDeployment. +// Delete: Deletes a deployment. See https://google.aip.dev/135. // // - name: Name of the resource. func (r *ProjectsLocationsInterceptDeploymentsService) Delete(name string) *ProjectsLocationsInterceptDeploymentsDeleteCall { @@ -15698,17 +15856,9 @@ func (r *ProjectsLocationsInterceptDeploymentsService) Delete(name string) *Proj 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). +// RequestId sets the optional parameter "requestId": A unique identifier for +// this request. Must be a UUID4. This request is only idempotent if a +// `request_id` is provided. See https://google.aip.dev/155 for more details. func (c *ProjectsLocationsInterceptDeploymentsDeleteCall) RequestId(requestId string) *ProjectsLocationsInterceptDeploymentsDeleteCall { c.urlParams_.Set("requestId", requestId) return c @@ -15803,9 +15953,11 @@ type ProjectsLocationsInterceptDeploymentsGetCall struct { header_ http.Header } -// Get: Gets details of a single InterceptDeployment. +// Get: Gets a specific deployment. See https://google.aip.dev/131. // -// - name: Name of the resource. +// - name: The name of the deployment to retrieve. Format: +// projects/{project}/locations/{location}/interceptDeployments/{intercept_dep +// loyment}. func (r *ProjectsLocationsInterceptDeploymentsService) Get(name string) *ProjectsLocationsInterceptDeploymentsGetCall { c := &ProjectsLocationsInterceptDeploymentsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -15913,23 +16065,27 @@ type ProjectsLocationsInterceptDeploymentsListCall struct { header_ http.Header } -// List: Lists InterceptDeployments in a given project and location. +// List: Lists deployments in a given project and location. See +// https://google.aip.dev/132. // -// - parent: Parent value for ListInterceptDeploymentsRequest. +// - parent: The parent, which owns this collection of deployments. Example: +// `projects/123456789/locations/us-central1-a`. See +// https://google.aip.dev/132 for more details. func (r *ProjectsLocationsInterceptDeploymentsService) List(parent string) *ProjectsLocationsInterceptDeploymentsListCall { c := &ProjectsLocationsInterceptDeploymentsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent return c } -// Filter sets the optional parameter "filter": Filtering results +// Filter sets the optional parameter "filter": Filter expression. See +// https://google.aip.dev/160#filtering for more details. func (c *ProjectsLocationsInterceptDeploymentsListCall) Filter(filter string) *ProjectsLocationsInterceptDeploymentsListCall { c.urlParams_.Set("filter", filter) return c } -// OrderBy sets the optional parameter "orderBy": Hint for how to order the -// results +// OrderBy sets the optional parameter "orderBy": Sort expression. See +// https://google.aip.dev/132#ordering for more details. func (c *ProjectsLocationsInterceptDeploymentsListCall) OrderBy(orderBy string) *ProjectsLocationsInterceptDeploymentsListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -15937,14 +16093,17 @@ func (c *ProjectsLocationsInterceptDeploymentsListCall) OrderBy(orderBy string) // PageSize sets the optional parameter "pageSize": Requested page size. Server // may return fewer items than requested. If unspecified, server will pick an -// appropriate default. +// appropriate default. See https://google.aip.dev/158 for more details. func (c *ProjectsLocationsInterceptDeploymentsListCall) PageSize(pageSize int64) *ProjectsLocationsInterceptDeploymentsListCall { 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. +// PageToken sets the optional parameter "pageToken": A page token, received +// from a previous `ListInterceptDeployments` call. Provide this to retrieve +// the subsequent page. When paginating, all other parameters provided to +// `ListInterceptDeployments` must match the call that provided the page token. +// See https://google.aip.dev/158 for more details. func (c *ProjectsLocationsInterceptDeploymentsListCall) PageToken(pageToken string) *ProjectsLocationsInterceptDeploymentsListCall { c.urlParams_.Set("pageToken", pageToken) return c @@ -16072,9 +16231,12 @@ type ProjectsLocationsInterceptDeploymentsPatchCall struct { header_ http.Header } -// Patch: Updates a single InterceptDeployment. +// Patch: Updates a deployment. See https://google.aip.dev/134. // -// - name: Immutable. Identifier. The name of the InterceptDeployment. +// - name: Immutable. Identifier. The resource name of this deployment, for +// example: +// `projects/123456789/locations/us-central1-a/interceptDeployments/my-dep`. +// See https://google.aip.dev/122 for more details. func (r *ProjectsLocationsInterceptDeploymentsService) Patch(name string, interceptdeployment *InterceptDeployment) *ProjectsLocationsInterceptDeploymentsPatchCall { c := &ProjectsLocationsInterceptDeploymentsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -16082,28 +16244,18 @@ func (r *ProjectsLocationsInterceptDeploymentsService) Patch(name string, interc return c } -// RequestId sets the optional parameter "requestId": An optional request ID to -// identify requests. Specify a unique request ID so that if you must retry -// your request, the server will know to ignore the request if it has already -// been completed. The server will guarantee that for at least 60 minutes since -// the first request. For example, consider a situation where you make an -// initial request and the request times out. If you make the request again -// with the same request ID, the server can check if original operation with -// the same request ID was received, and if so, will ignore the second request. -// This prevents clients from accidentally creating duplicate commitments. The -// request ID must be a valid UUID with the exception that zero UUID is not -// supported (00000000-0000-0000-0000-000000000000). +// RequestId sets the optional parameter "requestId": A unique identifier for +// this request. Must be a UUID4. This request is only idempotent if a +// `request_id` is provided. See https://google.aip.dev/155 for more details. func (c *ProjectsLocationsInterceptDeploymentsPatchCall) RequestId(requestId string) *ProjectsLocationsInterceptDeploymentsPatchCall { c.urlParams_.Set("requestId", requestId) return c } -// UpdateMask sets the optional parameter "updateMask": Required. Field mask is -// used to specify the fields to be overwritten in the InterceptDeployment -// resource by the update. The fields specified in the update_mask are relative -// to the resource, not the full request. A field will be overwritten if it is -// in the mask. If the user does not provide a mask then all fields will be -// overwritten. +// UpdateMask sets the optional parameter "updateMask": The list of fields to +// update. Fields are specified relative to the deployment (e.g. `description`; +// *not* `intercept_deployment.description`). See https://google.aip.dev/161 +// for more details. func (c *ProjectsLocationsInterceptDeploymentsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsInterceptDeploymentsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -16202,10 +16354,11 @@ type ProjectsLocationsInterceptEndpointGroupAssociationsCreateCall struct { header_ http.Header } -// Create: Creates a new InterceptEndpointGroupAssociation in a given project -// and location. +// Create: Creates an association in a given project and location. See +// https://google.aip.dev/133. // -// - parent: Value for parent. +// - parent: The parent resource where this association will be created. +// Format: projects/{project}/locations/{location}. func (r *ProjectsLocationsInterceptEndpointGroupAssociationsService) Create(parent string, interceptendpointgroupassociation *InterceptEndpointGroupAssociation) *ProjectsLocationsInterceptEndpointGroupAssociationsCreateCall { c := &ProjectsLocationsInterceptEndpointGroupAssociationsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -16214,26 +16367,17 @@ func (r *ProjectsLocationsInterceptEndpointGroupAssociationsService) Create(pare } // InterceptEndpointGroupAssociationId sets the optional parameter -// "interceptEndpointGroupAssociationId": Id of the requesting object If -// auto-generating Id server-side, remove this field and -// intercept_endpoint_group_association_id from the method_signature of Create -// RPC +// "interceptEndpointGroupAssociationId": The ID to use for the new +// association, which will become the final component of the endpoint group's +// resource name. If not provided, the server will generate a unique ID. func (c *ProjectsLocationsInterceptEndpointGroupAssociationsCreateCall) InterceptEndpointGroupAssociationId(interceptEndpointGroupAssociationId string) *ProjectsLocationsInterceptEndpointGroupAssociationsCreateCall { c.urlParams_.Set("interceptEndpointGroupAssociationId", interceptEndpointGroupAssociationId) return c } -// RequestId sets the optional parameter "requestId": An optional request ID to -// identify requests. Specify a unique request ID so that if you must retry -// your request, the server will know to ignore the request if it has already -// been completed. The server will guarantee that for at least 60 minutes since -// the first request. For example, consider a situation where you make an -// initial request and the request times out. If you make the request again -// with the same request ID, the server can check if original operation with -// the same request ID was received, and if so, will ignore the second request. -// This prevents clients from accidentally creating duplicate commitments. The -// request ID must be a valid UUID with the exception that zero UUID is not -// supported (00000000-0000-0000-0000-000000000000). +// RequestId sets the optional parameter "requestId": A unique identifier for +// this request. Must be a UUID4. This request is only idempotent if a +// `request_id` is provided. See https://google.aip.dev/155 for more details. func (c *ProjectsLocationsInterceptEndpointGroupAssociationsCreateCall) RequestId(requestId string) *ProjectsLocationsInterceptEndpointGroupAssociationsCreateCall { c.urlParams_.Set("requestId", requestId) return c @@ -16331,26 +16475,18 @@ type ProjectsLocationsInterceptEndpointGroupAssociationsDeleteCall struct { header_ http.Header } -// Delete: Deletes a single InterceptEndpointGroupAssociation. +// Delete: Deletes an association. See https://google.aip.dev/135. // -// - name: Name of the resource. +// - name: The association to delete. func (r *ProjectsLocationsInterceptEndpointGroupAssociationsService) Delete(name string) *ProjectsLocationsInterceptEndpointGroupAssociationsDeleteCall { c := &ProjectsLocationsInterceptEndpointGroupAssociationsDeleteCall{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). +// RequestId sets the optional parameter "requestId": A unique identifier for +// this request. Must be a UUID4. This request is only idempotent if a +// `request_id` is provided. See https://google.aip.dev/155 for more details. func (c *ProjectsLocationsInterceptEndpointGroupAssociationsDeleteCall) RequestId(requestId string) *ProjectsLocationsInterceptEndpointGroupAssociationsDeleteCall { c.urlParams_.Set("requestId", requestId) return c @@ -16445,9 +16581,11 @@ type ProjectsLocationsInterceptEndpointGroupAssociationsGetCall struct { header_ http.Header } -// Get: Gets details of a single InterceptEndpointGroupAssociation. +// Get: Gets a specific association. See https://google.aip.dev/131. // -// - name: Name of the resource. +// - name: The name of the association to retrieve. Format: +// projects/{project}/locations/{location}/interceptEndpointGroupAssociations/ +// {intercept_endpoint_group_association}. func (r *ProjectsLocationsInterceptEndpointGroupAssociationsService) Get(name string) *ProjectsLocationsInterceptEndpointGroupAssociationsGetCall { c := &ProjectsLocationsInterceptEndpointGroupAssociationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -16555,24 +16693,27 @@ type ProjectsLocationsInterceptEndpointGroupAssociationsListCall struct { header_ http.Header } -// List: Lists InterceptEndpointGroupAssociations in a given project and -// location. +// List: Lists associations in a given project and location. See +// https://google.aip.dev/132. // -// - parent: Parent value for ListInterceptEndpointGroupAssociationsRequest. +// - parent: The parent, which owns this collection of associations. Example: +// `projects/123456789/locations/global`. See https://google.aip.dev/132 for +// more details. func (r *ProjectsLocationsInterceptEndpointGroupAssociationsService) List(parent string) *ProjectsLocationsInterceptEndpointGroupAssociationsListCall { c := &ProjectsLocationsInterceptEndpointGroupAssociationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent return c } -// Filter sets the optional parameter "filter": Filtering results +// Filter sets the optional parameter "filter": Filter expression. See +// https://google.aip.dev/160#filtering for more details. func (c *ProjectsLocationsInterceptEndpointGroupAssociationsListCall) Filter(filter string) *ProjectsLocationsInterceptEndpointGroupAssociationsListCall { c.urlParams_.Set("filter", filter) return c } -// OrderBy sets the optional parameter "orderBy": Hint for how to order the -// results +// OrderBy sets the optional parameter "orderBy": Sort expression. See +// https://google.aip.dev/132#ordering for more details. func (c *ProjectsLocationsInterceptEndpointGroupAssociationsListCall) OrderBy(orderBy string) *ProjectsLocationsInterceptEndpointGroupAssociationsListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -16580,14 +16721,17 @@ func (c *ProjectsLocationsInterceptEndpointGroupAssociationsListCall) OrderBy(or // PageSize sets the optional parameter "pageSize": Requested page size. Server // may return fewer items than requested. If unspecified, server will pick an -// appropriate default. +// appropriate default. See https://google.aip.dev/158 for more details. func (c *ProjectsLocationsInterceptEndpointGroupAssociationsListCall) PageSize(pageSize int64) *ProjectsLocationsInterceptEndpointGroupAssociationsListCall { 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. +// PageToken sets the optional parameter "pageToken": A page token, received +// from a previous `ListInterceptEndpointGroups` call. Provide this to retrieve +// the subsequent page. When paginating, all other parameters provided to +// `ListInterceptEndpointGroups` must match the call that provided the page +// token. See https://google.aip.dev/158 for more details. func (c *ProjectsLocationsInterceptEndpointGroupAssociationsListCall) PageToken(pageToken string) *ProjectsLocationsInterceptEndpointGroupAssociationsListCall { c.urlParams_.Set("pageToken", pageToken) return c @@ -16715,10 +16859,12 @@ type ProjectsLocationsInterceptEndpointGroupAssociationsPatchCall struct { header_ http.Header } -// Patch: Updates a single InterceptEndpointGroupAssociation. +// Patch: Updates an association. See https://google.aip.dev/134. // -// - name: Immutable. Identifier. The name of the -// InterceptEndpointGroupAssociation. +// - name: Immutable. Identifier. The resource name of this endpoint group +// association, for example: +// `projects/123456789/locations/global/interceptEndpointGroupAssociations/my- +// eg-association`. See https://google.aip.dev/122 for more details. func (r *ProjectsLocationsInterceptEndpointGroupAssociationsService) Patch(name string, interceptendpointgroupassociation *InterceptEndpointGroupAssociation) *ProjectsLocationsInterceptEndpointGroupAssociationsPatchCall { c := &ProjectsLocationsInterceptEndpointGroupAssociationsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -16726,28 +16872,18 @@ func (r *ProjectsLocationsInterceptEndpointGroupAssociationsService) Patch(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 since -// the first request. For example, consider a situation where you make an -// initial request and the request times out. If you make the request again -// with the same request ID, the server can check if original operation with -// the same request ID was received, and if so, will ignore the second request. -// This prevents clients from accidentally creating duplicate commitments. The -// request ID must be a valid UUID with the exception that zero UUID is not -// supported (00000000-0000-0000-0000-000000000000). +// RequestId sets the optional parameter "requestId": A unique identifier for +// this request. Must be a UUID4. This request is only idempotent if a +// `request_id` is provided. See https://google.aip.dev/155 for more details. func (c *ProjectsLocationsInterceptEndpointGroupAssociationsPatchCall) RequestId(requestId string) *ProjectsLocationsInterceptEndpointGroupAssociationsPatchCall { c.urlParams_.Set("requestId", requestId) return c } -// UpdateMask sets the optional parameter "updateMask": Required. Field mask is -// used to specify the fields to be overwritten in the -// InterceptEndpointGroupAssociation resource by the update. The fields -// specified in the update_mask are relative to the resource, not the full -// request. A field will be overwritten if it is in the mask. If the user does -// not provide a mask then all fields will be overwritten. +// UpdateMask sets the optional parameter "updateMask": The list of fields to +// update. Fields are specified relative to the association (e.g. +// `description`; *not* `intercept_endpoint_group_association.description`). +// See https://google.aip.dev/161 for more details. func (c *ProjectsLocationsInterceptEndpointGroupAssociationsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsInterceptEndpointGroupAssociationsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -16846,10 +16982,11 @@ type ProjectsLocationsInterceptEndpointGroupsCreateCall struct { header_ http.Header } -// Create: Creates a new InterceptEndpointGroup in a given project and -// location. +// Create: Creates an endpoint group in a given project and location. See +// https://google.aip.dev/133. // -// - parent: Value for parent. +// - parent: The parent resource where this endpoint group will be created. +// Format: projects/{project}/locations/{location}. func (r *ProjectsLocationsInterceptEndpointGroupsService) Create(parent string, interceptendpointgroup *InterceptEndpointGroup) *ProjectsLocationsInterceptEndpointGroupsCreateCall { c := &ProjectsLocationsInterceptEndpointGroupsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -16858,25 +16995,16 @@ func (r *ProjectsLocationsInterceptEndpointGroupsService) Create(parent string, } // InterceptEndpointGroupId sets the optional parameter -// "interceptEndpointGroupId": Required. Id of the requesting object If -// auto-generating Id server-side, remove this field and -// intercept_endpoint_group_id from the method_signature of Create RPC +// "interceptEndpointGroupId": Required. The ID to use for the endpoint group, +// which will become the final component of the endpoint group's resource name. func (c *ProjectsLocationsInterceptEndpointGroupsCreateCall) InterceptEndpointGroupId(interceptEndpointGroupId string) *ProjectsLocationsInterceptEndpointGroupsCreateCall { c.urlParams_.Set("interceptEndpointGroupId", interceptEndpointGroupId) return c } -// RequestId sets the optional parameter "requestId": An optional request ID to -// identify requests. Specify a unique request ID so that if you must retry -// your request, the server will know to ignore the request if it has already -// been completed. The server will guarantee that for at least 60 minutes since -// the first request. For example, consider a situation where you make an -// initial request and the request times out. If you make the request again -// with the same request ID, the server can check if original operation with -// the same request ID was received, and if so, will ignore the second request. -// This prevents clients from accidentally creating duplicate commitments. The -// request ID must be a valid UUID with the exception that zero UUID is not -// supported (00000000-0000-0000-0000-000000000000). +// RequestId sets the optional parameter "requestId": A unique identifier for +// this request. Must be a UUID4. This request is only idempotent if a +// `request_id` is provided. See https://google.aip.dev/155 for more details. func (c *ProjectsLocationsInterceptEndpointGroupsCreateCall) RequestId(requestId string) *ProjectsLocationsInterceptEndpointGroupsCreateCall { c.urlParams_.Set("requestId", requestId) return c @@ -16974,26 +17102,18 @@ type ProjectsLocationsInterceptEndpointGroupsDeleteCall struct { header_ http.Header } -// Delete: Deletes a single InterceptEndpointGroup. +// Delete: Deletes an endpoint group. See https://google.aip.dev/135. // -// - name: Name of the resource. +// - name: The endpoint group to delete. func (r *ProjectsLocationsInterceptEndpointGroupsService) Delete(name string) *ProjectsLocationsInterceptEndpointGroupsDeleteCall { c := &ProjectsLocationsInterceptEndpointGroupsDeleteCall{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). +// RequestId sets the optional parameter "requestId": A unique identifier for +// this request. Must be a UUID4. This request is only idempotent if a +// `request_id` is provided. See https://google.aip.dev/155 for more details. func (c *ProjectsLocationsInterceptEndpointGroupsDeleteCall) RequestId(requestId string) *ProjectsLocationsInterceptEndpointGroupsDeleteCall { c.urlParams_.Set("requestId", requestId) return c @@ -17088,9 +17208,11 @@ type ProjectsLocationsInterceptEndpointGroupsGetCall struct { header_ http.Header } -// Get: Gets details of a single InterceptEndpointGroup. +// Get: Gets a specific endpoint group. See https://google.aip.dev/131. // -// - name: Name of the resource. +// - name: The name of the endpoint group to retrieve. Format: +// projects/{project}/locations/{location}/interceptEndpointGroups/{intercept_ +// endpoint_group}. func (r *ProjectsLocationsInterceptEndpointGroupsService) Get(name string) *ProjectsLocationsInterceptEndpointGroupsGetCall { c := &ProjectsLocationsInterceptEndpointGroupsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -17198,23 +17320,27 @@ type ProjectsLocationsInterceptEndpointGroupsListCall struct { header_ http.Header } -// List: Lists InterceptEndpointGroups in a given project and location. +// List: Lists endpoint groups in a given project and location. See +// https://google.aip.dev/132. // -// - parent: Parent value for ListInterceptEndpointGroupsRequest. +// - parent: The parent, which owns this collection of endpoint groups. +// Example: `projects/123456789/locations/global`. See +// https://google.aip.dev/132 for more details. func (r *ProjectsLocationsInterceptEndpointGroupsService) List(parent string) *ProjectsLocationsInterceptEndpointGroupsListCall { c := &ProjectsLocationsInterceptEndpointGroupsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent return c } -// Filter sets the optional parameter "filter": Filtering results +// Filter sets the optional parameter "filter": Filter expression. See +// https://google.aip.dev/160#filtering for more details. func (c *ProjectsLocationsInterceptEndpointGroupsListCall) Filter(filter string) *ProjectsLocationsInterceptEndpointGroupsListCall { c.urlParams_.Set("filter", filter) return c } -// OrderBy sets the optional parameter "orderBy": Hint for how to order the -// results +// OrderBy sets the optional parameter "orderBy": Sort expression. See +// https://google.aip.dev/132#ordering for more details. func (c *ProjectsLocationsInterceptEndpointGroupsListCall) OrderBy(orderBy string) *ProjectsLocationsInterceptEndpointGroupsListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -17222,14 +17348,17 @@ func (c *ProjectsLocationsInterceptEndpointGroupsListCall) OrderBy(orderBy strin // PageSize sets the optional parameter "pageSize": Requested page size. Server // may return fewer items than requested. If unspecified, server will pick an -// appropriate default. +// appropriate default. See https://google.aip.dev/158 for more details. func (c *ProjectsLocationsInterceptEndpointGroupsListCall) PageSize(pageSize int64) *ProjectsLocationsInterceptEndpointGroupsListCall { 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. +// PageToken sets the optional parameter "pageToken": A page token, received +// from a previous `ListInterceptEndpointGroups` call. Provide this to retrieve +// the subsequent page. When paginating, all other parameters provided to +// `ListInterceptEndpointGroups` must match the call that provided the page +// token. See https://google.aip.dev/158 for more details. func (c *ProjectsLocationsInterceptEndpointGroupsListCall) PageToken(pageToken string) *ProjectsLocationsInterceptEndpointGroupsListCall { c.urlParams_.Set("pageToken", pageToken) return c @@ -17357,9 +17486,12 @@ type ProjectsLocationsInterceptEndpointGroupsPatchCall struct { header_ http.Header } -// Patch: Updates a single InterceptEndpointGroup. +// Patch: Updates an endpoint group. See https://google.aip.dev/134. // -// - name: Immutable. Identifier. The name of the InterceptEndpointGroup. +// - name: Immutable. Identifier. The resource name of this endpoint group, for +// example: +// `projects/123456789/locations/global/interceptEndpointGroups/my-eg`. See +// https://google.aip.dev/122 for more details. func (r *ProjectsLocationsInterceptEndpointGroupsService) Patch(name string, interceptendpointgroup *InterceptEndpointGroup) *ProjectsLocationsInterceptEndpointGroupsPatchCall { c := &ProjectsLocationsInterceptEndpointGroupsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -17367,28 +17499,18 @@ func (r *ProjectsLocationsInterceptEndpointGroupsService) Patch(name string, int return c } -// RequestId sets the optional parameter "requestId": An optional request ID to -// identify requests. Specify a unique request ID so that if you must retry -// your request, the server will know to ignore the request if it has already -// been completed. The server will guarantee that for at least 60 minutes since -// the first request. For example, consider a situation where you make an -// initial request and the request times out. If you make the request again -// with the same request ID, the server can check if original operation with -// the same request ID was received, and if so, will ignore the second request. -// This prevents clients from accidentally creating duplicate commitments. The -// request ID must be a valid UUID with the exception that zero UUID is not -// supported (00000000-0000-0000-0000-000000000000). +// RequestId sets the optional parameter "requestId": A unique identifier for +// this request. Must be a UUID4. This request is only idempotent if a +// `request_id` is provided. See https://google.aip.dev/155 for more details. func (c *ProjectsLocationsInterceptEndpointGroupsPatchCall) RequestId(requestId string) *ProjectsLocationsInterceptEndpointGroupsPatchCall { c.urlParams_.Set("requestId", requestId) return c } -// UpdateMask sets the optional parameter "updateMask": Required. Field mask is -// used to specify the fields to be overwritten in the InterceptEndpointGroup -// resource by the update. The fields specified in the update_mask are relative -// to the resource, not the full request. A field will be overwritten if it is -// in the mask. If the user does not provide a mask then all fields will be -// overwritten. +// UpdateMask sets the optional parameter "updateMask": The list of fields to +// update. Fields are specified relative to the endpoint group (e.g. +// `description`; *not* `intercept_endpoint_group.description`). See +// https://google.aip.dev/161 for more details. func (c *ProjectsLocationsInterceptEndpointGroupsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsInterceptEndpointGroupsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -17487,10 +17609,11 @@ type ProjectsLocationsMirroringDeploymentGroupsCreateCall struct { header_ http.Header } -// Create: Creates a new MirroringDeploymentGroup in a given project and -// location. +// Create: Creates a deployment group in a given project and location. See +// https://google.aip.dev/133. // -// - parent: Value for parent. +// - parent: The parent resource where this deployment group will be created. +// Format: projects/{project}/locations/{location}. func (r *ProjectsLocationsMirroringDeploymentGroupsService) Create(parent string, mirroringdeploymentgroup *MirroringDeploymentGroup) *ProjectsLocationsMirroringDeploymentGroupsCreateCall { c := &ProjectsLocationsMirroringDeploymentGroupsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -17499,25 +17622,17 @@ func (r *ProjectsLocationsMirroringDeploymentGroupsService) Create(parent string } // MirroringDeploymentGroupId sets the optional parameter -// "mirroringDeploymentGroupId": Required. Id of the requesting object If -// auto-generating Id server-side, remove this field and -// mirroring_deployment_group_id from the method_signature of Create RPC +// "mirroringDeploymentGroupId": Required. The ID to use for the new deployment +// group, which will become the final component of the deployment group's +// resource name. func (c *ProjectsLocationsMirroringDeploymentGroupsCreateCall) MirroringDeploymentGroupId(mirroringDeploymentGroupId string) *ProjectsLocationsMirroringDeploymentGroupsCreateCall { c.urlParams_.Set("mirroringDeploymentGroupId", mirroringDeploymentGroupId) return c } -// RequestId sets the optional parameter "requestId": An optional request ID to -// identify requests. Specify a unique request ID so that if you must retry -// your request, the server will know to ignore the request if it has already -// been completed. The server will guarantee that for at least 60 minutes since -// the first request. For example, consider a situation where you make an -// initial request and the request times out. If you make the request again -// with the same request ID, the server can check if original operation with -// the same request ID was received, and if so, will ignore the second request. -// This prevents clients from accidentally creating duplicate commitments. The -// request ID must be a valid UUID with the exception that zero UUID is not -// supported (00000000-0000-0000-0000-000000000000). +// RequestId sets the optional parameter "requestId": A unique identifier for +// this request. Must be a UUID4. This request is only idempotent if a +// `request_id` is provided. See https://google.aip.dev/155 for more details. func (c *ProjectsLocationsMirroringDeploymentGroupsCreateCall) RequestId(requestId string) *ProjectsLocationsMirroringDeploymentGroupsCreateCall { c.urlParams_.Set("requestId", requestId) return c @@ -17615,26 +17730,18 @@ type ProjectsLocationsMirroringDeploymentGroupsDeleteCall struct { header_ http.Header } -// Delete: Deletes a single MirroringDeploymentGroup. +// Delete: Deletes a deployment group. See https://google.aip.dev/135. // -// - name: Name of the resource. +// - name: The deployment group to delete. func (r *ProjectsLocationsMirroringDeploymentGroupsService) Delete(name string) *ProjectsLocationsMirroringDeploymentGroupsDeleteCall { c := &ProjectsLocationsMirroringDeploymentGroupsDeleteCall{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). +// RequestId sets the optional parameter "requestId": A unique identifier for +// this request. Must be a UUID4. This request is only idempotent if a +// `request_id` is provided. See https://google.aip.dev/155 for more details. func (c *ProjectsLocationsMirroringDeploymentGroupsDeleteCall) RequestId(requestId string) *ProjectsLocationsMirroringDeploymentGroupsDeleteCall { c.urlParams_.Set("requestId", requestId) return c @@ -17729,9 +17836,11 @@ type ProjectsLocationsMirroringDeploymentGroupsGetCall struct { header_ http.Header } -// Get: Gets details of a single MirroringDeploymentGroup. +// Get: Gets a specific deployment group. See https://google.aip.dev/131. // -// - name: Name of the resource. +// - name: The name of the deployment group to retrieve. Format: +// projects/{project}/locations/{location}/mirroringDeploymentGroups/{mirrorin +// g_deployment_group}. func (r *ProjectsLocationsMirroringDeploymentGroupsService) Get(name string) *ProjectsLocationsMirroringDeploymentGroupsGetCall { c := &ProjectsLocationsMirroringDeploymentGroupsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -17839,23 +17948,27 @@ type ProjectsLocationsMirroringDeploymentGroupsListCall struct { header_ http.Header } -// List: Lists MirroringDeploymentGroups in a given project and location. +// List: Lists deployment groups in a given project and location. See +// https://google.aip.dev/132. // -// - parent: Parent value for ListMirroringDeploymentGroupsRequest. +// - parent: The parent, which owns this collection of deployment groups. +// Example: `projects/123456789/locations/global`. See +// https://google.aip.dev/132 for more details. func (r *ProjectsLocationsMirroringDeploymentGroupsService) List(parent string) *ProjectsLocationsMirroringDeploymentGroupsListCall { c := &ProjectsLocationsMirroringDeploymentGroupsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent return c } -// Filter sets the optional parameter "filter": Filtering results +// Filter sets the optional parameter "filter": Filter expression. See +// https://google.aip.dev/160#filtering for more details. func (c *ProjectsLocationsMirroringDeploymentGroupsListCall) Filter(filter string) *ProjectsLocationsMirroringDeploymentGroupsListCall { c.urlParams_.Set("filter", filter) return c } -// OrderBy sets the optional parameter "orderBy": Hint for how to order the -// results +// OrderBy sets the optional parameter "orderBy": Sort expression. See +// https://google.aip.dev/132#ordering for more details. func (c *ProjectsLocationsMirroringDeploymentGroupsListCall) OrderBy(orderBy string) *ProjectsLocationsMirroringDeploymentGroupsListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -17863,14 +17976,17 @@ func (c *ProjectsLocationsMirroringDeploymentGroupsListCall) OrderBy(orderBy str // PageSize sets the optional parameter "pageSize": Requested page size. Server // may return fewer items than requested. If unspecified, server will pick an -// appropriate default. +// appropriate default. See https://google.aip.dev/158 for more details. func (c *ProjectsLocationsMirroringDeploymentGroupsListCall) PageSize(pageSize int64) *ProjectsLocationsMirroringDeploymentGroupsListCall { 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. +// PageToken sets the optional parameter "pageToken": A page token, received +// from a previous `ListMirroringDeploymentGroups` call. Provide this to +// retrieve the subsequent page. When paginating, all other parameters provided +// to `ListMirroringDeploymentGroups` must match the call that provided the +// page token. See https://google.aip.dev/158 for more details. func (c *ProjectsLocationsMirroringDeploymentGroupsListCall) PageToken(pageToken string) *ProjectsLocationsMirroringDeploymentGroupsListCall { c.urlParams_.Set("pageToken", pageToken) return c @@ -17998,7 +18114,7 @@ type ProjectsLocationsMirroringDeploymentGroupsPatchCall struct { header_ http.Header } -// Patch: Updates a single MirroringDeploymentGroup. +// Patch: Updates a deployment group. See https://google.aip.dev/134. // // - name: Immutable. Identifier. The resource name of this deployment group, // for example: @@ -18011,28 +18127,18 @@ func (r *ProjectsLocationsMirroringDeploymentGroupsService) Patch(name string, m return c } -// RequestId sets the optional parameter "requestId": An optional request ID to -// identify requests. Specify a unique request ID so that if you must retry -// your request, the server will know to ignore the request if it has already -// been completed. The server will guarantee that for at least 60 minutes since -// the first request. For example, consider a situation where you make an -// initial request and the request times out. If you make the request again -// with the same request ID, the server can check if original operation with -// the same request ID was received, and if so, will ignore the second request. -// This prevents clients from accidentally creating duplicate commitments. The -// request ID must be a valid UUID with the exception that zero UUID is not -// supported (00000000-0000-0000-0000-000000000000). +// RequestId sets the optional parameter "requestId": A unique identifier for +// this request. Must be a UUID4. This request is only idempotent if a +// `request_id` is provided. See https://google.aip.dev/155 for more details. func (c *ProjectsLocationsMirroringDeploymentGroupsPatchCall) RequestId(requestId string) *ProjectsLocationsMirroringDeploymentGroupsPatchCall { c.urlParams_.Set("requestId", requestId) return c } -// UpdateMask sets the optional parameter "updateMask": Required. Field mask is -// used to specify the fields to be overwritten in the MirroringDeploymentGroup -// resource by the update. The fields specified in the update_mask are relative -// to the resource, not the full request. A field will be overwritten if it is -// in the mask. If the user does not provide a mask then all fields will be -// overwritten. +// UpdateMask sets the optional parameter "updateMask": The list of fields to +// update. Fields are specified relative to the deployment group (e.g. +// `description`; *not* `mirroring_deployment_group.description`). See +// https://google.aip.dev/161 for more details. func (c *ProjectsLocationsMirroringDeploymentGroupsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsMirroringDeploymentGroupsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -18134,7 +18240,8 @@ type ProjectsLocationsMirroringDeploymentsCreateCall struct { // Create: Creates a deployment in a given project and location. See // https://google.aip.dev/133. // -// - parent: Value for parent. +// - parent: The parent resource where this deployment will be created. Format: +// projects/{project}/locations/{location}. func (r *ProjectsLocationsMirroringDeploymentsService) Create(parent string, mirroringdeployment *MirroringDeployment) *ProjectsLocationsMirroringDeploymentsCreateCall { c := &ProjectsLocationsMirroringDeploymentsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -18143,25 +18250,16 @@ func (r *ProjectsLocationsMirroringDeploymentsService) Create(parent string, mir } // MirroringDeploymentId sets the optional parameter "mirroringDeploymentId": -// Required. Id of the requesting object If auto-generating Id server-side, -// remove this field and mirroring_deployment_id from the method_signature of -// Create RPC +// Required. The ID to use for the new deployment, which will become the final +// component of the deployment's resource name. func (c *ProjectsLocationsMirroringDeploymentsCreateCall) MirroringDeploymentId(mirroringDeploymentId string) *ProjectsLocationsMirroringDeploymentsCreateCall { c.urlParams_.Set("mirroringDeploymentId", mirroringDeploymentId) return c } -// RequestId sets the optional parameter "requestId": An optional request ID to -// identify requests. Specify a unique request ID so that if you must retry -// your request, the server will know to ignore the request if it has already -// been completed. The server will guarantee that for at least 60 minutes since -// the first request. For example, consider a situation where you make an -// initial request and the request times out. If you make the request again -// with the same request ID, the server can check if original operation with -// the same request ID was received, and if so, will ignore the second request. -// This prevents clients from accidentally creating duplicate commitments. The -// request ID must be a valid UUID with the exception that zero UUID is not -// supported (00000000-0000-0000-0000-000000000000). +// RequestId sets the optional parameter "requestId": A unique identifier for +// this request. Must be a UUID4. This request is only idempotent if a +// `request_id` is provided. See https://google.aip.dev/155 for more details. func (c *ProjectsLocationsMirroringDeploymentsCreateCall) RequestId(requestId string) *ProjectsLocationsMirroringDeploymentsCreateCall { c.urlParams_.Set("requestId", requestId) return c @@ -18268,17 +18366,9 @@ func (r *ProjectsLocationsMirroringDeploymentsService) Delete(name string) *Proj 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). +// RequestId sets the optional parameter "requestId": A unique identifier for +// this request. Must be a UUID4. This request is only idempotent if a +// `request_id` is provided. See https://google.aip.dev/155 for more details. func (c *ProjectsLocationsMirroringDeploymentsDeleteCall) RequestId(requestId string) *ProjectsLocationsMirroringDeploymentsDeleteCall { c.urlParams_.Set("requestId", requestId) return c @@ -18375,7 +18465,9 @@ type ProjectsLocationsMirroringDeploymentsGetCall struct { // Get: Gets a specific deployment. See https://google.aip.dev/131. // -// - name: Name of the resource. +// - name: The name of the deployment to retrieve. Format: +// projects/{project}/locations/{location}/mirroringDeployments/{mirroring_dep +// loyment}. func (r *ProjectsLocationsMirroringDeploymentsService) Get(name string) *ProjectsLocationsMirroringDeploymentsGetCall { c := &ProjectsLocationsMirroringDeploymentsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -18486,21 +18578,24 @@ type ProjectsLocationsMirroringDeploymentsListCall struct { // List: Lists deployments in a given project and location. See // https://google.aip.dev/132. // -// - parent: Parent value for ListMirroringDeploymentsRequest. +// - parent: The parent, which owns this collection of deployments. Example: +// `projects/123456789/locations/us-central1-a`. See +// https://google.aip.dev/132 for more details. func (r *ProjectsLocationsMirroringDeploymentsService) List(parent string) *ProjectsLocationsMirroringDeploymentsListCall { c := &ProjectsLocationsMirroringDeploymentsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent return c } -// Filter sets the optional parameter "filter": Filtering results +// Filter sets the optional parameter "filter": Filter expression. See +// https://google.aip.dev/160#filtering for more details. func (c *ProjectsLocationsMirroringDeploymentsListCall) Filter(filter string) *ProjectsLocationsMirroringDeploymentsListCall { c.urlParams_.Set("filter", filter) return c } -// OrderBy sets the optional parameter "orderBy": Hint for how to order the -// results +// OrderBy sets the optional parameter "orderBy": Sort expression. See +// https://google.aip.dev/132#ordering for more details. func (c *ProjectsLocationsMirroringDeploymentsListCall) OrderBy(orderBy string) *ProjectsLocationsMirroringDeploymentsListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -18508,14 +18603,17 @@ func (c *ProjectsLocationsMirroringDeploymentsListCall) OrderBy(orderBy string) // PageSize sets the optional parameter "pageSize": Requested page size. Server // may return fewer items than requested. If unspecified, server will pick an -// appropriate default. +// appropriate default. See https://google.aip.dev/158 for more details. func (c *ProjectsLocationsMirroringDeploymentsListCall) PageSize(pageSize int64) *ProjectsLocationsMirroringDeploymentsListCall { 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. +// PageToken sets the optional parameter "pageToken": A page token, received +// from a previous `ListMirroringDeployments` call. Provide this to retrieve +// the subsequent page. When paginating, all other parameters provided to +// `ListMirroringDeployments` must match the call that provided the page token. +// See https://google.aip.dev/158 for more details. func (c *ProjectsLocationsMirroringDeploymentsListCall) PageToken(pageToken string) *ProjectsLocationsMirroringDeploymentsListCall { c.urlParams_.Set("pageToken", pageToken) return c @@ -18656,28 +18754,18 @@ func (r *ProjectsLocationsMirroringDeploymentsService) Patch(name string, mirror return c } -// RequestId sets the optional parameter "requestId": An optional request ID to -// identify requests. Specify a unique request ID so that if you must retry -// your request, the server will know to ignore the request if it has already -// been completed. The server will guarantee that for at least 60 minutes since -// the first request. For example, consider a situation where you make an -// initial request and the request times out. If you make the request again -// with the same request ID, the server can check if original operation with -// the same request ID was received, and if so, will ignore the second request. -// This prevents clients from accidentally creating duplicate commitments. The -// request ID must be a valid UUID with the exception that zero UUID is not -// supported (00000000-0000-0000-0000-000000000000). +// RequestId sets the optional parameter "requestId": A unique identifier for +// this request. Must be a UUID4. This request is only idempotent if a +// `request_id` is provided. See https://google.aip.dev/155 for more details. func (c *ProjectsLocationsMirroringDeploymentsPatchCall) RequestId(requestId string) *ProjectsLocationsMirroringDeploymentsPatchCall { c.urlParams_.Set("requestId", requestId) return c } -// UpdateMask sets the optional parameter "updateMask": Required. Field mask is -// used to specify the fields to be overwritten in the MirroringDeployment -// resource by the update. The fields specified in the update_mask are relative -// to the resource, not the full request. A field will be overwritten if it is -// in the mask. If the user does not provide a mask then all fields will be -// overwritten. +// UpdateMask sets the optional parameter "updateMask": The list of fields to +// update. Fields are specified relative to the deployment (e.g. `description`; +// *not* `mirroring_deployment.description`). See https://google.aip.dev/161 +// for more details. func (c *ProjectsLocationsMirroringDeploymentsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsMirroringDeploymentsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -18779,8 +18867,8 @@ type ProjectsLocationsMirroringEndpointGroupAssociationsCreateCall struct { // Create: Creates an association in a given project and location. See // https://google.aip.dev/133. // -// - parent: Container (project and location) where the association will be -// created, e.g. `projects/123456789/locations/global`. +// - parent: The parent resource where this association will be created. +// Format: projects/{project}/locations/{location}. func (r *ProjectsLocationsMirroringEndpointGroupAssociationsService) Create(parent string, mirroringendpointgroupassociation *MirroringEndpointGroupAssociation) *ProjectsLocationsMirroringEndpointGroupAssociationsCreateCall { c := &ProjectsLocationsMirroringEndpointGroupAssociationsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -18789,29 +18877,17 @@ func (r *ProjectsLocationsMirroringEndpointGroupAssociationsService) Create(pare } // MirroringEndpointGroupAssociationId sets the optional parameter -// "mirroringEndpointGroupAssociationId": ID for the new association. If not -// provided, the server will generate a unique ID. The ID must be a valid RFC -// 1035 resource name. The ID must be 1-63 characters long and match the -// regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be -// a lowercase letter, and all following characters (except for the last -// character) must be a dash, lowercase letter, or digit. The last character -// must be a +// "mirroringEndpointGroupAssociationId": The ID to use for the new +// association, which will become the final component of the endpoint group's +// resource name. If not provided, the server will generate a unique ID. func (c *ProjectsLocationsMirroringEndpointGroupAssociationsCreateCall) MirroringEndpointGroupAssociationId(mirroringEndpointGroupAssociationId string) *ProjectsLocationsMirroringEndpointGroupAssociationsCreateCall { c.urlParams_.Set("mirroringEndpointGroupAssociationId", mirroringEndpointGroupAssociationId) return c } -// RequestId sets the optional parameter "requestId": An optional request ID to -// identify requests. Specify a unique request ID so that if you must retry -// your request, the server will know to ignore the request if it has already -// been completed. The server will guarantee that for at least 60 minutes since -// the first request. For example, consider a situation where you make an -// initial request and the request times out. If you make the request again -// with the same request ID, the server can check if original operation with -// the same request ID was received, and if so, will ignore the second request. -// This prevents clients from accidentally creating duplicate commitments. The -// request ID must be a valid UUID with the exception that zero UUID is not -// supported (00000000-0000-0000-0000-000000000000). +// RequestId sets the optional parameter "requestId": A unique identifier for +// this request. Must be a UUID4. This request is only idempotent if a +// `request_id` is provided. See https://google.aip.dev/155 for more details. func (c *ProjectsLocationsMirroringEndpointGroupAssociationsCreateCall) RequestId(requestId string) *ProjectsLocationsMirroringEndpointGroupAssociationsCreateCall { c.urlParams_.Set("requestId", requestId) return c @@ -18909,28 +18985,18 @@ type ProjectsLocationsMirroringEndpointGroupAssociationsDeleteCall struct { header_ http.Header } -// Delete: Deletes a single association. See https://google.aip.dev/135. +// Delete: Deletes an association. See https://google.aip.dev/135. // -// - name: Full resource name of the association to delete, e.g. -// projects/123456789/locations/global/mirroringEndpointGroupAssociations/my-e -// g-association. +// - name: The association to delete. func (r *ProjectsLocationsMirroringEndpointGroupAssociationsService) Delete(name string) *ProjectsLocationsMirroringEndpointGroupAssociationsDeleteCall { c := &ProjectsLocationsMirroringEndpointGroupAssociationsDeleteCall{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). +// RequestId sets the optional parameter "requestId": A unique identifier for +// this request. Must be a UUID4. This request is only idempotent if a +// `request_id` is provided. See https://google.aip.dev/155 for more details. func (c *ProjectsLocationsMirroringEndpointGroupAssociationsDeleteCall) RequestId(requestId string) *ProjectsLocationsMirroringEndpointGroupAssociationsDeleteCall { c.urlParams_.Set("requestId", requestId) return c @@ -19027,9 +19093,9 @@ type ProjectsLocationsMirroringEndpointGroupAssociationsGetCall struct { // Get: Gets a specific association. See https://google.aip.dev/131. // -// - name: Full resource name of the association to get, e.g. -// projects/123456789/locations/global/mirroringEndpointGroupAssociations/my-e -// g-association. +// - name: The name of the association to retrieve. Format: +// projects/{project}/locations/{location}/mirroringEndpointGroupAssociations/ +// {mirroring_endpoint_group_association}. func (r *ProjectsLocationsMirroringEndpointGroupAssociationsService) Get(name string) *ProjectsLocationsMirroringEndpointGroupAssociationsGetCall { c := &ProjectsLocationsMirroringEndpointGroupAssociationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -19140,23 +19206,24 @@ type ProjectsLocationsMirroringEndpointGroupAssociationsListCall struct { // List: Lists associations in a given project and location. See // https://google.aip.dev/132. // -// - parent: Parent container (project and location) of the associations to -// list, e.g. `projects/123456789/locations/global`. +// - parent: The parent, which owns this collection of associations. Example: +// `projects/123456789/locations/global`. See https://google.aip.dev/132 for +// more details. func (r *ProjectsLocationsMirroringEndpointGroupAssociationsService) List(parent string) *ProjectsLocationsMirroringEndpointGroupAssociationsListCall { c := &ProjectsLocationsMirroringEndpointGroupAssociationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent return c } -// Filter sets the optional parameter "filter": A filter expression that -// filters the results listed in the response. See https://google.aip.dev/160. +// Filter sets the optional parameter "filter": Filter expression. See +// https://google.aip.dev/160#filtering for more details. func (c *ProjectsLocationsMirroringEndpointGroupAssociationsListCall) Filter(filter string) *ProjectsLocationsMirroringEndpointGroupAssociationsListCall { c.urlParams_.Set("filter", filter) return c } -// OrderBy sets the optional parameter "orderBy": Hint for how to order the -// results +// OrderBy sets the optional parameter "orderBy": Sort expression. See +// https://google.aip.dev/132#ordering for more details. func (c *ProjectsLocationsMirroringEndpointGroupAssociationsListCall) OrderBy(orderBy string) *ProjectsLocationsMirroringEndpointGroupAssociationsListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -19164,14 +19231,17 @@ func (c *ProjectsLocationsMirroringEndpointGroupAssociationsListCall) OrderBy(or // PageSize sets the optional parameter "pageSize": Requested page size. Server // may return fewer items than requested. If unspecified, server will pick an -// appropriate default. See https://google.aip.dev/158. +// appropriate default. See https://google.aip.dev/158 for more details. func (c *ProjectsLocationsMirroringEndpointGroupAssociationsListCall) PageSize(pageSize int64) *ProjectsLocationsMirroringEndpointGroupAssociationsListCall { 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. See https://google.aip.dev/158. +// PageToken sets the optional parameter "pageToken": A page token, received +// from a previous `ListMirroringEndpointGroups` call. Provide this to retrieve +// the subsequent page. When paginating, all other parameters provided to +// `ListMirroringEndpointGroups` must match the call that provided the page +// token. See https://google.aip.dev/158 for more details. func (c *ProjectsLocationsMirroringEndpointGroupAssociationsListCall) PageToken(pageToken string) *ProjectsLocationsMirroringEndpointGroupAssociationsListCall { c.urlParams_.Set("pageToken", pageToken) return c @@ -19312,25 +19382,18 @@ func (r *ProjectsLocationsMirroringEndpointGroupAssociationsService) Patch(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 since -// the first request. For example, consider a situation where you make an -// initial request and the request times out. If you make the request again -// with the same request ID, the server can check if original operation with -// the same request ID was received, and if so, will ignore the second request. -// This prevents clients from accidentally creating duplicate commitments. The -// request ID must be a valid UUID with the exception that zero UUID is not -// supported (00000000-0000-0000-0000-000000000000). +// RequestId sets the optional parameter "requestId": A unique identifier for +// this request. Must be a UUID4. This request is only idempotent if a +// `request_id` is provided. See https://google.aip.dev/155 for more details. func (c *ProjectsLocationsMirroringEndpointGroupAssociationsPatchCall) RequestId(requestId string) *ProjectsLocationsMirroringEndpointGroupAssociationsPatchCall { c.urlParams_.Set("requestId", requestId) return c } -// UpdateMask sets the optional parameter "updateMask": Field mask is used to -// specify the fields to be overwritten in the association by the update. See -// https://google.aip.dev/161. +// UpdateMask sets the optional parameter "updateMask": The list of fields to +// update. Fields are specified relative to the association (e.g. +// `description`; *not* `mirroring_endpoint_group_association.description`). +// See https://google.aip.dev/161 for more details. func (c *ProjectsLocationsMirroringEndpointGroupAssociationsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsMirroringEndpointGroupAssociationsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -19432,7 +19495,8 @@ type ProjectsLocationsMirroringEndpointGroupsCreateCall struct { // Create: Creates an endpoint group in a given project and location. See // https://google.aip.dev/133. // -// - parent: Value for parent. +// - parent: The parent resource where this endpoint group will be created. +// Format: projects/{project}/locations/{location}. func (r *ProjectsLocationsMirroringEndpointGroupsService) Create(parent string, mirroringendpointgroup *MirroringEndpointGroup) *ProjectsLocationsMirroringEndpointGroupsCreateCall { c := &ProjectsLocationsMirroringEndpointGroupsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -19441,25 +19505,16 @@ func (r *ProjectsLocationsMirroringEndpointGroupsService) Create(parent string, } // MirroringEndpointGroupId sets the optional parameter -// "mirroringEndpointGroupId": Required. Id of the requesting object If -// auto-generating Id server-side, remove this field and -// mirroring_endpoint_group_id from the method_signature of Create RPC +// "mirroringEndpointGroupId": Required. The ID to use for the endpoint group, +// which will become the final component of the endpoint group's resource name. func (c *ProjectsLocationsMirroringEndpointGroupsCreateCall) MirroringEndpointGroupId(mirroringEndpointGroupId string) *ProjectsLocationsMirroringEndpointGroupsCreateCall { c.urlParams_.Set("mirroringEndpointGroupId", mirroringEndpointGroupId) return c } -// RequestId sets the optional parameter "requestId": An optional request ID to -// identify requests. Specify a unique request ID so that if you must retry -// your request, the server will know to ignore the request if it has already -// been completed. The server will guarantee that for at least 60 minutes since -// the first request. For example, consider a situation where you make an -// initial request and the request times out. If you make the request again -// with the same request ID, the server can check if original operation with -// the same request ID was received, and if so, will ignore the second request. -// This prevents clients from accidentally creating duplicate commitments. The -// request ID must be a valid UUID with the exception that zero UUID is not -// supported (00000000-0000-0000-0000-000000000000). +// RequestId sets the optional parameter "requestId": A unique identifier for +// this request. Must be a UUID4. This request is only idempotent if a +// `request_id` is provided. See https://google.aip.dev/155 for more details. func (c *ProjectsLocationsMirroringEndpointGroupsCreateCall) RequestId(requestId string) *ProjectsLocationsMirroringEndpointGroupsCreateCall { c.urlParams_.Set("requestId", requestId) return c @@ -19559,24 +19614,16 @@ type ProjectsLocationsMirroringEndpointGroupsDeleteCall struct { // Delete: Deletes an endpoint group. See https://google.aip.dev/135. // -// - name: Name of the resource. +// - name: The endpoint group to delete. func (r *ProjectsLocationsMirroringEndpointGroupsService) Delete(name string) *ProjectsLocationsMirroringEndpointGroupsDeleteCall { c := &ProjectsLocationsMirroringEndpointGroupsDeleteCall{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). +// RequestId sets the optional parameter "requestId": A unique identifier for +// this request. Must be a UUID4. This request is only idempotent if a +// `request_id` is provided. See https://google.aip.dev/155 for more details. func (c *ProjectsLocationsMirroringEndpointGroupsDeleteCall) RequestId(requestId string) *ProjectsLocationsMirroringEndpointGroupsDeleteCall { c.urlParams_.Set("requestId", requestId) return c @@ -19673,7 +19720,9 @@ type ProjectsLocationsMirroringEndpointGroupsGetCall struct { // Get: Gets a specific endpoint group. See https://google.aip.dev/131. // -// - name: Name of the resource. +// - name: The name of the endpoint group to retrieve. Format: +// projects/{project}/locations/{location}/mirroringEndpointGroups/{mirroring_ +// endpoint_group}. func (r *ProjectsLocationsMirroringEndpointGroupsService) Get(name string) *ProjectsLocationsMirroringEndpointGroupsGetCall { c := &ProjectsLocationsMirroringEndpointGroupsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -19784,21 +19833,24 @@ type ProjectsLocationsMirroringEndpointGroupsListCall struct { // List: Lists endpoint groups in a given project and location. See // https://google.aip.dev/132. // -// - parent: Parent value for ListMirroringEndpointGroupsRequest. +// - parent: The parent, which owns this collection of endpoint groups. +// Example: `projects/123456789/locations/global`. See +// https://google.aip.dev/132 for more details. func (r *ProjectsLocationsMirroringEndpointGroupsService) List(parent string) *ProjectsLocationsMirroringEndpointGroupsListCall { c := &ProjectsLocationsMirroringEndpointGroupsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent return c } -// Filter sets the optional parameter "filter": Filtering results +// Filter sets the optional parameter "filter": Filter expression. See +// https://google.aip.dev/160#filtering for more details. func (c *ProjectsLocationsMirroringEndpointGroupsListCall) Filter(filter string) *ProjectsLocationsMirroringEndpointGroupsListCall { c.urlParams_.Set("filter", filter) return c } -// OrderBy sets the optional parameter "orderBy": Hint for how to order the -// results +// OrderBy sets the optional parameter "orderBy": Sort expression. See +// https://google.aip.dev/132#ordering for more details. func (c *ProjectsLocationsMirroringEndpointGroupsListCall) OrderBy(orderBy string) *ProjectsLocationsMirroringEndpointGroupsListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -19806,14 +19858,17 @@ func (c *ProjectsLocationsMirroringEndpointGroupsListCall) OrderBy(orderBy strin // PageSize sets the optional parameter "pageSize": Requested page size. Server // may return fewer items than requested. If unspecified, server will pick an -// appropriate default. +// appropriate default. See https://google.aip.dev/158 for more details. func (c *ProjectsLocationsMirroringEndpointGroupsListCall) PageSize(pageSize int64) *ProjectsLocationsMirroringEndpointGroupsListCall { 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. +// PageToken sets the optional parameter "pageToken": A page token, received +// from a previous `ListMirroringEndpointGroups` call. Provide this to retrieve +// the subsequent page. When paginating, all other parameters provided to +// `ListMirroringEndpointGroups` must match the call that provided the page +// token. See https://google.aip.dev/158 for more details. func (c *ProjectsLocationsMirroringEndpointGroupsListCall) PageToken(pageToken string) *ProjectsLocationsMirroringEndpointGroupsListCall { c.urlParams_.Set("pageToken", pageToken) return c @@ -19954,28 +20009,18 @@ func (r *ProjectsLocationsMirroringEndpointGroupsService) Patch(name string, mir return c } -// RequestId sets the optional parameter "requestId": An optional request ID to -// identify requests. Specify a unique request ID so that if you must retry -// your request, the server will know to ignore the request if it has already -// been completed. The server will guarantee that for at least 60 minutes since -// the first request. For example, consider a situation where you make an -// initial request and the request times out. If you make the request again -// with the same request ID, the server can check if original operation with -// the same request ID was received, and if so, will ignore the second request. -// This prevents clients from accidentally creating duplicate commitments. The -// request ID must be a valid UUID with the exception that zero UUID is not -// supported (00000000-0000-0000-0000-000000000000). +// RequestId sets the optional parameter "requestId": A unique identifier for +// this request. Must be a UUID4. This request is only idempotent if a +// `request_id` is provided. See https://google.aip.dev/155 for more details. func (c *ProjectsLocationsMirroringEndpointGroupsPatchCall) RequestId(requestId string) *ProjectsLocationsMirroringEndpointGroupsPatchCall { c.urlParams_.Set("requestId", requestId) return c } -// UpdateMask sets the optional parameter "updateMask": Required. Field mask is -// used to specify the fields to be overwritten in the MirroringEndpointGroup -// resource by the update. The fields specified in the update_mask are relative -// to the resource, not the full request. A field will be overwritten if it is -// in the mask. If the user does not provide a mask then all fields will be -// overwritten. +// UpdateMask sets the optional parameter "updateMask": The list of fields to +// update. Fields are specified relative to the endpoint group (e.g. +// `description`; *not* `mirroring_endpoint_group.description`). See +// https://google.aip.dev/161 for more details. func (c *ProjectsLocationsMirroringEndpointGroupsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsMirroringEndpointGroupsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c diff --git a/pubsub/v1/pubsub-api.json b/pubsub/v1/pubsub-api.json index bb995530e7c..61dd8a0c7f5 100644 --- a/pubsub/v1/pubsub-api.json +++ b/pubsub/v1/pubsub-api.json @@ -1638,7 +1638,7 @@ } } }, - "revision": "20250208", + "revision": "20250218", "rootUrl": "https://pubsub.googleapis.com/", "schemas": { "AcknowledgeRequest": { @@ -1996,7 +1996,7 @@ "type": "string" }, "maxDuration": { - "description": "Optional. The maximum duration that can elapse before a new Cloud Storage file is created. Min 1 minute, max 10 minutes, default 5 minutes. May not exceed the subscription's acknowledgement deadline.", + "description": "Optional. The maximum duration that can elapse before a new Cloud Storage file is created. Min 1 minute, max 10 minutes, default 5 minutes. May not exceed the subscription's acknowledgment deadline.", "format": "google-duration", "type": "string" }, @@ -2125,7 +2125,7 @@ "type": "string" }, "maxDeliveryAttempts": { - "description": "Optional. The maximum number of delivery attempts for any message. The value must be between 5 and 100. The number of delivery attempts is defined as 1 + (the sum of number of NACKs and number of times the acknowledgement deadline has been exceeded for the message). A NACK is any call to ModifyAckDeadline with a 0 deadline. Note that client libraries may automatically extend ack_deadlines. This field will be honored on a best effort basis. If this parameter is 0, a default value of 5 is used.", + "description": "Optional. The maximum number of delivery attempts for any message. The value must be between 5 and 100. The number of delivery attempts is defined as 1 + (the sum of number of NACKs and number of times the acknowledgment deadline has been exceeded for the message). A NACK is any call to ModifyAckDeadline with a 0 deadline. Note that client libraries may automatically extend ack_deadlines. This field will be honored on a best effort basis. If this parameter is 0, a default value of 5 is used.", "format": "int32", "type": "integer" } @@ -2645,7 +2645,7 @@ "type": "object" }, "RetryPolicy": { - "description": "A policy that specifies how Pub/Sub retries message delivery. Retry delay will be exponential based on provided minimum and maximum backoffs. https://en.wikipedia.org/wiki/Exponential_backoff. RetryPolicy will be triggered on NACKs or acknowledgement deadline exceeded events for a given message. Retry Policy is implemented on a best effort basis. At times, the delay between consecutive deliveries may not match the configuration. That is, delay can be more or less than configured backoff.", + "description": "A policy that specifies how Pub/Sub retries message delivery. Retry delay will be exponential based on provided minimum and maximum backoffs. https://en.wikipedia.org/wiki/Exponential_backoff. RetryPolicy will be triggered on NACKs or acknowledgment deadline exceeded events for a given message. Retry Policy is implemented on a best effort basis. At times, the delay between consecutive deliveries may not match the configuration. That is, delay can be more or less than configured backoff.", "id": "RetryPolicy", "properties": { "maximumBackoff": { @@ -2836,7 +2836,7 @@ "type": "boolean" }, "enableExactlyOnceDelivery": { - "description": "Optional. If true, Pub/Sub provides the following guarantees for the delivery of a message with a given value of `message_id` on this subscription: * The message sent to a subscriber is guaranteed not to be resent before the message's acknowledgement deadline expires. * An acknowledged message will not be resent to a subscriber. Note that subscribers may still receive multiple copies of a message when `enable_exactly_once_delivery` is true if the message was published multiple times by a publisher client. These copies are considered distinct by Pub/Sub and have distinct `message_id` values.", + "description": "Optional. If true, Pub/Sub provides the following guarantees for the delivery of a message with a given value of `message_id` on this subscription: * The message sent to a subscriber is guaranteed not to be resent before the message's acknowledgment deadline expires. * An acknowledged message will not be resent to a subscriber. Note that subscribers may still receive multiple copies of a message when `enable_exactly_once_delivery` is true if the message was published multiple times by a publisher client. These copies are considered distinct by Pub/Sub and have distinct `message_id` values.", "type": "boolean" }, "enableMessageOrdering": { @@ -2884,7 +2884,7 @@ }, "retryPolicy": { "$ref": "RetryPolicy", - "description": "Optional. A policy that specifies how Pub/Sub retries message delivery for this subscription. If not set, the default retry policy is applied. This generally implies that messages will be retried as soon as possible for healthy subscribers. RetryPolicy will be triggered on NACKs or acknowledgement deadline exceeded events for a given message." + "description": "Optional. A policy that specifies how Pub/Sub retries message delivery for this subscription. If not set, the default retry policy is applied. This generally implies that messages will be retried as soon as possible for healthy subscribers. RetryPolicy will be triggered on NACKs or acknowledgment deadline exceeded events for a given message." }, "state": { "description": "Output only. An output-only field indicating whether or not the subscription can receive messages.", diff --git a/pubsub/v1/pubsub-gen.go b/pubsub/v1/pubsub-gen.go index 9f341ea339d..1bf8976f988 100644 --- a/pubsub/v1/pubsub-gen.go +++ b/pubsub/v1/pubsub-gen.go @@ -764,7 +764,7 @@ type CloudStorageConfig struct { MaxBytes int64 `json:"maxBytes,omitempty,string"` // MaxDuration: Optional. The maximum duration that can elapse before a new // Cloud Storage file is created. Min 1 minute, max 10 minutes, default 5 - // minutes. May not exceed the subscription's acknowledgement deadline. + // minutes. May not exceed the subscription's acknowledgment deadline. MaxDuration string `json:"maxDuration,omitempty"` // MaxMessages: Optional. The maximum number of messages that can be written to // a Cloud Storage file before a new file is created. Min 1000 messages. @@ -935,7 +935,7 @@ type DeadLetterPolicy struct { // MaxDeliveryAttempts: Optional. The maximum number of delivery attempts for // any message. The value must be between 5 and 100. The number of delivery // attempts is defined as 1 + (the sum of number of NACKs and number of times - // the acknowledgement deadline has been exceeded for the message). A NACK is + // the acknowledgment deadline has been exceeded for the message). A NACK is // any call to ModifyAckDeadline with a 0 deadline. Note that client libraries // may automatically extend ack_deadlines. This field will be honored on a best // effort basis. If this parameter is 0, a default value of 5 is used. @@ -1889,7 +1889,7 @@ func (s ReceivedMessage) MarshalJSON() ([]byte, error) { // RetryPolicy: A policy that specifies how Pub/Sub retries message delivery. // Retry delay will be exponential based on provided minimum and maximum // backoffs. https://en.wikipedia.org/wiki/Exponential_backoff. RetryPolicy -// will be triggered on NACKs or acknowledgement deadline exceeded events for a +// will be triggered on NACKs or acknowledgment deadline exceeded events for a // given message. Retry Policy is implemented on a best effort basis. At times, // the delay between consecutive deliveries may not match the configuration. // That is, delay can be more or less than configured backoff. @@ -2185,7 +2185,7 @@ type Subscription struct { // EnableExactlyOnceDelivery: Optional. If true, Pub/Sub provides the following // guarantees for the delivery of a message with a given value of `message_id` // on this subscription: * The message sent to a subscriber is guaranteed not - // to be resent before the message's acknowledgement deadline expires. * An + // to be resent before the message's acknowledgment deadline expires. * An // acknowledged message will not be resent to a subscriber. Note that // subscribers may still receive multiple copies of a message when // `enable_exactly_once_delivery` is true if the message was published multiple @@ -2247,7 +2247,7 @@ type Subscription struct { // delivery for this subscription. If not set, the default retry policy is // applied. This generally implies that messages will be retried as soon as // possible for healthy subscribers. RetryPolicy will be triggered on NACKs or - // acknowledgement deadline exceeded events for a given message. + // acknowledgment deadline exceeded events for a given message. RetryPolicy *RetryPolicy `json:"retryPolicy,omitempty"` // State: Output only. An output-only field indicating whether or not the // subscription can receive messages. diff --git a/run/v2/run-api.json b/run/v2/run-api.json index 782ab949005..0c269b581b8 100644 --- a/run/v2/run-api.json +++ b/run/v2/run-api.json @@ -1912,7 +1912,7 @@ } } }, - "revision": "20250214", + "revision": "20250223", "rootUrl": "https://run.googleapis.com/", "schemas": { "GoogleCloudRunV2BinaryAuthorization": { @@ -4225,6 +4225,11 @@ "readOnly": true, "type": "string" }, + "nodeSelector": { + "$ref": "GoogleCloudRunV2NodeSelector", + "description": "Output only. The node selector for the task.", + "readOnly": true + }, "observedGeneration": { "description": "Output only. The generation of this Task. See comments in `Job.reconciling` for additional information on reconciliation process in Cloud Run.", "format": "int64", @@ -4346,6 +4351,10 @@ "format": "int32", "type": "integer" }, + "nodeSelector": { + "$ref": "GoogleCloudRunV2NodeSelector", + "description": "Optional. The node selector for the task template." + }, "serviceAccount": { "description": "Optional. Email address of the IAM service account associated with the Task of a Job. The service account represents the identity of the running task, and determines what permissions the task has. If not provided, the task will use the project's default service account.", "type": "string" diff --git a/run/v2/run-gen.go b/run/v2/run-gen.go index e1a5d10fb60..688671ac1d5 100644 --- a/run/v2/run-gen.go +++ b/run/v2/run-gen.go @@ -2870,6 +2870,8 @@ type GoogleCloudRunV2Task struct { MaxRetries int64 `json:"maxRetries,omitempty"` // Name: Output only. The unique name of this Task. Name string `json:"name,omitempty"` + // NodeSelector: Output only. The node selector for the task. + NodeSelector *GoogleCloudRunV2NodeSelector `json:"nodeSelector,omitempty"` // ObservedGeneration: Output only. The generation of this Task. See comments // in `Job.reconciling` for additional information on reconciliation process in // Cloud Run. @@ -2981,6 +2983,8 @@ type GoogleCloudRunV2TaskTemplate struct { // MaxRetries: Number of retries allowed per Task, before marking this Task // failed. Defaults to 3. MaxRetries int64 `json:"maxRetries,omitempty"` + // NodeSelector: Optional. The node selector for the task template. + NodeSelector *GoogleCloudRunV2NodeSelector `json:"nodeSelector,omitempty"` // ServiceAccount: Optional. Email address of the IAM service account // associated with the Task of a Job. The service account represents the // identity of the running task, and determines what permissions the task has. diff --git a/securitycenter/v1/securitycenter-api.json b/securitycenter/v1/securitycenter-api.json index 134ab4387a3..e53ef9be1f6 100644 --- a/securitycenter/v1/securitycenter-api.json +++ b/securitycenter/v1/securitycenter-api.json @@ -5938,7 +5938,7 @@ } } }, - "revision": "20250218", + "revision": "20250221", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -11577,6 +11577,7 @@ "MULTI_HOP_PROXY", "ACCOUNT_MANIPULATION", "ADDITIONAL_CLOUD_CREDENTIALS", + "ADDITIONAL_CLOUD_ROLES", "SSH_AUTHORIZED_KEYS", "ADDITIONAL_CONTAINER_CLUSTER_ROLES", "INGRESS_TOOL_TRANSFER", @@ -11646,6 +11647,7 @@ "T1090.003", "T1098", "T1098.001", + "T1098.003", "T1098.004", "T1098.006", "T1105", @@ -11760,6 +11762,7 @@ "MULTI_HOP_PROXY", "ACCOUNT_MANIPULATION", "ADDITIONAL_CLOUD_CREDENTIALS", + "ADDITIONAL_CLOUD_ROLES", "SSH_AUTHORIZED_KEYS", "ADDITIONAL_CONTAINER_CLUSTER_ROLES", "INGRESS_TOOL_TRANSFER", @@ -11829,6 +11832,7 @@ "T1090.003", "T1098", "T1098.001", + "T1098.003", "T1098.004", "T1098.006", "T1105", @@ -13790,6 +13794,7 @@ "MULTI_HOP_PROXY", "ACCOUNT_MANIPULATION", "ADDITIONAL_CLOUD_CREDENTIALS", + "ADDITIONAL_CLOUD_ROLES", "SSH_AUTHORIZED_KEYS", "ADDITIONAL_CONTAINER_CLUSTER_ROLES", "INGRESS_TOOL_TRANSFER", @@ -13859,6 +13864,7 @@ "T1090.003", "T1098", "T1098.001", + "T1098.003", "T1098.004", "T1098.006", "T1105", @@ -13973,6 +13979,7 @@ "MULTI_HOP_PROXY", "ACCOUNT_MANIPULATION", "ADDITIONAL_CLOUD_CREDENTIALS", + "ADDITIONAL_CLOUD_ROLES", "SSH_AUTHORIZED_KEYS", "ADDITIONAL_CONTAINER_CLUSTER_ROLES", "INGRESS_TOOL_TRANSFER", @@ -14042,6 +14049,7 @@ "T1090.003", "T1098", "T1098.001", + "T1098.003", "T1098.004", "T1098.006", "T1105", diff --git a/securitycenter/v1/securitycenter-gen.go b/securitycenter/v1/securitycenter-gen.go index 1a3d691975f..0755cfc90fe 100644 --- a/securitycenter/v1/securitycenter-gen.go +++ b/securitycenter/v1/securitycenter-gen.go @@ -7714,6 +7714,7 @@ type GoogleCloudSecuritycenterV2MitreAttack struct { // "MULTI_HOP_PROXY" - T1090.003 // "ACCOUNT_MANIPULATION" - T1098 // "ADDITIONAL_CLOUD_CREDENTIALS" - T1098.001 + // "ADDITIONAL_CLOUD_ROLES" - T1098.003 // "SSH_AUTHORIZED_KEYS" - T1098.004 // "ADDITIONAL_CONTAINER_CLUSTER_ROLES" - T1098.006 // "INGRESS_TOOL_TRANSFER" - T1105 @@ -7810,6 +7811,7 @@ type GoogleCloudSecuritycenterV2MitreAttack struct { // "MULTI_HOP_PROXY" - T1090.003 // "ACCOUNT_MANIPULATION" - T1098 // "ADDITIONAL_CLOUD_CREDENTIALS" - T1098.001 + // "ADDITIONAL_CLOUD_ROLES" - T1098.003 // "SSH_AUTHORIZED_KEYS" - T1098.004 // "ADDITIONAL_CONTAINER_CLUSTER_ROLES" - T1098.006 // "INGRESS_TOOL_TRANSFER" - T1105 @@ -10406,6 +10408,7 @@ type MitreAttack struct { // "MULTI_HOP_PROXY" - T1090.003 // "ACCOUNT_MANIPULATION" - T1098 // "ADDITIONAL_CLOUD_CREDENTIALS" - T1098.001 + // "ADDITIONAL_CLOUD_ROLES" - T1098.003 // "SSH_AUTHORIZED_KEYS" - T1098.004 // "ADDITIONAL_CONTAINER_CLUSTER_ROLES" - T1098.006 // "INGRESS_TOOL_TRANSFER" - T1105 @@ -10502,6 +10505,7 @@ type MitreAttack struct { // "MULTI_HOP_PROXY" - T1090.003 // "ACCOUNT_MANIPULATION" - T1098 // "ADDITIONAL_CLOUD_CREDENTIALS" - T1098.001 + // "ADDITIONAL_CLOUD_ROLES" - T1098.003 // "SSH_AUTHORIZED_KEYS" - T1098.004 // "ADDITIONAL_CONTAINER_CLUSTER_ROLES" - T1098.006 // "INGRESS_TOOL_TRANSFER" - T1105 diff --git a/securitycenter/v1beta1/securitycenter-api.json b/securitycenter/v1beta1/securitycenter-api.json index 58363538b8a..1a9cfce58ca 100644 --- a/securitycenter/v1beta1/securitycenter-api.json +++ b/securitycenter/v1beta1/securitycenter-api.json @@ -913,7 +913,7 @@ } } }, - "revision": "20250218", + "revision": "20250221", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -6248,6 +6248,7 @@ "MULTI_HOP_PROXY", "ACCOUNT_MANIPULATION", "ADDITIONAL_CLOUD_CREDENTIALS", + "ADDITIONAL_CLOUD_ROLES", "SSH_AUTHORIZED_KEYS", "ADDITIONAL_CONTAINER_CLUSTER_ROLES", "INGRESS_TOOL_TRANSFER", @@ -6317,6 +6318,7 @@ "T1090.003", "T1098", "T1098.001", + "T1098.003", "T1098.004", "T1098.006", "T1105", @@ -6431,6 +6433,7 @@ "MULTI_HOP_PROXY", "ACCOUNT_MANIPULATION", "ADDITIONAL_CLOUD_CREDENTIALS", + "ADDITIONAL_CLOUD_ROLES", "SSH_AUTHORIZED_KEYS", "ADDITIONAL_CONTAINER_CLUSTER_ROLES", "INGRESS_TOOL_TRANSFER", @@ -6500,6 +6503,7 @@ "T1090.003", "T1098", "T1098.001", + "T1098.003", "T1098.004", "T1098.006", "T1105", @@ -8180,6 +8184,7 @@ "MULTI_HOP_PROXY", "ACCOUNT_MANIPULATION", "ADDITIONAL_CLOUD_CREDENTIALS", + "ADDITIONAL_CLOUD_ROLES", "SSH_AUTHORIZED_KEYS", "ADDITIONAL_CONTAINER_CLUSTER_ROLES", "INGRESS_TOOL_TRANSFER", @@ -8249,6 +8254,7 @@ "T1090.003", "T1098", "T1098.001", + "T1098.003", "T1098.004", "T1098.006", "T1105", @@ -8363,6 +8369,7 @@ "MULTI_HOP_PROXY", "ACCOUNT_MANIPULATION", "ADDITIONAL_CLOUD_CREDENTIALS", + "ADDITIONAL_CLOUD_ROLES", "SSH_AUTHORIZED_KEYS", "ADDITIONAL_CONTAINER_CLUSTER_ROLES", "INGRESS_TOOL_TRANSFER", @@ -8432,6 +8439,7 @@ "T1090.003", "T1098", "T1098.001", + "T1098.003", "T1098.004", "T1098.006", "T1105", diff --git a/securitycenter/v1beta1/securitycenter-gen.go b/securitycenter/v1beta1/securitycenter-gen.go index e422ab1ca56..57f5f5c8070 100644 --- a/securitycenter/v1beta1/securitycenter-gen.go +++ b/securitycenter/v1beta1/securitycenter-gen.go @@ -6676,6 +6676,7 @@ type GoogleCloudSecuritycenterV2MitreAttack struct { // "MULTI_HOP_PROXY" - T1090.003 // "ACCOUNT_MANIPULATION" - T1098 // "ADDITIONAL_CLOUD_CREDENTIALS" - T1098.001 + // "ADDITIONAL_CLOUD_ROLES" - T1098.003 // "SSH_AUTHORIZED_KEYS" - T1098.004 // "ADDITIONAL_CONTAINER_CLUSTER_ROLES" - T1098.006 // "INGRESS_TOOL_TRANSFER" - T1105 @@ -6772,6 +6773,7 @@ type GoogleCloudSecuritycenterV2MitreAttack struct { // "MULTI_HOP_PROXY" - T1090.003 // "ACCOUNT_MANIPULATION" - T1098 // "ADDITIONAL_CLOUD_CREDENTIALS" - T1098.001 + // "ADDITIONAL_CLOUD_ROLES" - T1098.003 // "SSH_AUTHORIZED_KEYS" - T1098.004 // "ADDITIONAL_CONTAINER_CLUSTER_ROLES" - T1098.006 // "INGRESS_TOOL_TRANSFER" - T1105 @@ -8871,6 +8873,7 @@ type MitreAttack struct { // "MULTI_HOP_PROXY" - T1090.003 // "ACCOUNT_MANIPULATION" - T1098 // "ADDITIONAL_CLOUD_CREDENTIALS" - T1098.001 + // "ADDITIONAL_CLOUD_ROLES" - T1098.003 // "SSH_AUTHORIZED_KEYS" - T1098.004 // "ADDITIONAL_CONTAINER_CLUSTER_ROLES" - T1098.006 // "INGRESS_TOOL_TRANSFER" - T1105 @@ -8967,6 +8970,7 @@ type MitreAttack struct { // "MULTI_HOP_PROXY" - T1090.003 // "ACCOUNT_MANIPULATION" - T1098 // "ADDITIONAL_CLOUD_CREDENTIALS" - T1098.001 + // "ADDITIONAL_CLOUD_ROLES" - T1098.003 // "SSH_AUTHORIZED_KEYS" - T1098.004 // "ADDITIONAL_CONTAINER_CLUSTER_ROLES" - T1098.006 // "INGRESS_TOOL_TRANSFER" - T1105 diff --git a/securitycenter/v1beta2/securitycenter-api.json b/securitycenter/v1beta2/securitycenter-api.json index 76a38d3bb67..05f4927d107 100644 --- a/securitycenter/v1beta2/securitycenter-api.json +++ b/securitycenter/v1beta2/securitycenter-api.json @@ -2003,7 +2003,7 @@ } } }, - "revision": "20250218", + "revision": "20250221", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -7241,6 +7241,7 @@ "MULTI_HOP_PROXY", "ACCOUNT_MANIPULATION", "ADDITIONAL_CLOUD_CREDENTIALS", + "ADDITIONAL_CLOUD_ROLES", "SSH_AUTHORIZED_KEYS", "ADDITIONAL_CONTAINER_CLUSTER_ROLES", "INGRESS_TOOL_TRANSFER", @@ -7310,6 +7311,7 @@ "T1090.003", "T1098", "T1098.001", + "T1098.003", "T1098.004", "T1098.006", "T1105", @@ -7424,6 +7426,7 @@ "MULTI_HOP_PROXY", "ACCOUNT_MANIPULATION", "ADDITIONAL_CLOUD_CREDENTIALS", + "ADDITIONAL_CLOUD_ROLES", "SSH_AUTHORIZED_KEYS", "ADDITIONAL_CONTAINER_CLUSTER_ROLES", "INGRESS_TOOL_TRANSFER", @@ -7493,6 +7496,7 @@ "T1090.003", "T1098", "T1098.001", + "T1098.003", "T1098.004", "T1098.006", "T1105", @@ -8924,6 +8928,7 @@ "MULTI_HOP_PROXY", "ACCOUNT_MANIPULATION", "ADDITIONAL_CLOUD_CREDENTIALS", + "ADDITIONAL_CLOUD_ROLES", "SSH_AUTHORIZED_KEYS", "ADDITIONAL_CONTAINER_CLUSTER_ROLES", "INGRESS_TOOL_TRANSFER", @@ -8993,6 +8998,7 @@ "T1090.003", "T1098", "T1098.001", + "T1098.003", "T1098.004", "T1098.006", "T1105", @@ -9107,6 +9113,7 @@ "MULTI_HOP_PROXY", "ACCOUNT_MANIPULATION", "ADDITIONAL_CLOUD_CREDENTIALS", + "ADDITIONAL_CLOUD_ROLES", "SSH_AUTHORIZED_KEYS", "ADDITIONAL_CONTAINER_CLUSTER_ROLES", "INGRESS_TOOL_TRANSFER", @@ -9176,6 +9183,7 @@ "T1090.003", "T1098", "T1098.001", + "T1098.003", "T1098.004", "T1098.006", "T1105", diff --git a/securitycenter/v1beta2/securitycenter-gen.go b/securitycenter/v1beta2/securitycenter-gen.go index 109ed7fc8c8..29d0cb8d7a8 100644 --- a/securitycenter/v1beta2/securitycenter-gen.go +++ b/securitycenter/v1beta2/securitycenter-gen.go @@ -6627,6 +6627,7 @@ type GoogleCloudSecuritycenterV2MitreAttack struct { // "MULTI_HOP_PROXY" - T1090.003 // "ACCOUNT_MANIPULATION" - T1098 // "ADDITIONAL_CLOUD_CREDENTIALS" - T1098.001 + // "ADDITIONAL_CLOUD_ROLES" - T1098.003 // "SSH_AUTHORIZED_KEYS" - T1098.004 // "ADDITIONAL_CONTAINER_CLUSTER_ROLES" - T1098.006 // "INGRESS_TOOL_TRANSFER" - T1105 @@ -6723,6 +6724,7 @@ type GoogleCloudSecuritycenterV2MitreAttack struct { // "MULTI_HOP_PROXY" - T1090.003 // "ACCOUNT_MANIPULATION" - T1098 // "ADDITIONAL_CLOUD_CREDENTIALS" - T1098.001 + // "ADDITIONAL_CLOUD_ROLES" - T1098.003 // "SSH_AUTHORIZED_KEYS" - T1098.004 // "ADDITIONAL_CONTAINER_CLUSTER_ROLES" - T1098.006 // "INGRESS_TOOL_TRANSFER" - T1105 @@ -8460,6 +8462,7 @@ type MitreAttack struct { // "MULTI_HOP_PROXY" - T1090.003 // "ACCOUNT_MANIPULATION" - T1098 // "ADDITIONAL_CLOUD_CREDENTIALS" - T1098.001 + // "ADDITIONAL_CLOUD_ROLES" - T1098.003 // "SSH_AUTHORIZED_KEYS" - T1098.004 // "ADDITIONAL_CONTAINER_CLUSTER_ROLES" - T1098.006 // "INGRESS_TOOL_TRANSFER" - T1105 @@ -8556,6 +8559,7 @@ type MitreAttack struct { // "MULTI_HOP_PROXY" - T1090.003 // "ACCOUNT_MANIPULATION" - T1098 // "ADDITIONAL_CLOUD_CREDENTIALS" - T1098.001 + // "ADDITIONAL_CLOUD_ROLES" - T1098.003 // "SSH_AUTHORIZED_KEYS" - T1098.004 // "ADDITIONAL_CONTAINER_CLUSTER_ROLES" - T1098.006 // "INGRESS_TOOL_TRANSFER" - T1105 diff --git a/sqladmin/v1/sqladmin-api.json b/sqladmin/v1/sqladmin-api.json index f4b3a4c94dd..509f54b48a2 100644 --- a/sqladmin/v1/sqladmin-api.json +++ b/sqladmin/v1/sqladmin-api.json @@ -243,7 +243,7 @@ ], "parameters": { "name": { - "description": "Output only. The resource name of the backup. Format: projects/{project}/backups/{backup}", + "description": "Output only. The resource name of the backup. Format: projects/{project}/backups/{backup}.", "location": "path", "pattern": "^projects/[^/]+/backups/[^/]+$", "required": true, @@ -2550,7 +2550,7 @@ } } }, - "revision": "20250205", + "revision": "20250216", "rootUrl": "https://sqladmin.googleapis.com/", "schemas": { "AclEntry": { @@ -2738,7 +2738,7 @@ "type": "string" }, "name": { - "description": "Output only. The resource name of the backup. Format: projects/{project}/backups/{backup}", + "description": "Output only. The resource name of the backup. Format: projects/{project}/backups/{backup}.", "readOnly": true, "type": "string" }, @@ -2781,7 +2781,7 @@ "type": "string" }, "timeZone": { - "description": "Output only. This output contains a backup time zone. If a Cloud SQL for SQL Server instance has a different time zone from the backup's time zone, then restores to the instance won't happen.", + "description": "Output only. This output contains a backup time zone. If a Cloud SQL for SQL Server instance has a different time zone from the backup's time zone, then the restore to the instance doesn't happen.", "readOnly": true, "type": "string" }, @@ -5521,7 +5521,8 @@ "SWITCHOVER_TO_REPLICA", "MAJOR_VERSION_UPGRADE", "ADVANCED_BACKUP", - "MANAGE_BACKUP" + "MANAGE_BACKUP", + "ENHANCED_BACKUP" ], "enumDeprecated": [ false, @@ -5571,6 +5572,7 @@ true, false, false, + true, false, false ], @@ -5622,8 +5624,9 @@ "Indicates that the instance (and any of its replicas) are currently in maintenance. This is initiated as a self-service request by using SSM. Maintenance typically causes the instance to be unavailable for 1-3 minutes.", "Switches a primary instance to a replica. This operation runs as part of a switchover operation to the original primary instance.", "Updates the major version of a Cloud SQL instance.", - "Creates a backup for an Advanced BackupTier Cloud SQL instance.", - "Changes the BackupTier of a Cloud SQL instance." + "Deprecated: ADVANCED_BACKUP is deprecated. Use ENHANCED_BACKUP instead.", + "Changes the BackupTier of a Cloud SQL instance.", + "Creates a backup for an Enhanced BackupTier Cloud SQL instance." ], "type": "string" }, @@ -5657,6 +5660,7 @@ "description": "Optional. The sub operation based on the operation type." }, "targetId": { + "description": "Name of the resource on which this operation runs.", "type": "string" }, "targetLink": { diff --git a/sqladmin/v1/sqladmin-gen.go b/sqladmin/v1/sqladmin-gen.go index 84c53504262..22626f6400b 100644 --- a/sqladmin/v1/sqladmin-gen.go +++ b/sqladmin/v1/sqladmin-gen.go @@ -500,7 +500,7 @@ type Backup struct { // backup. MaxChargeableBytes int64 `json:"maxChargeableBytes,omitempty,string"` // Name: Output only. The resource name of the backup. Format: - // projects/{project}/backups/{backup} + // projects/{project}/backups/{backup}. Name string `json:"name,omitempty"` // SatisfiesPzi: Output only. This status indicates whether the backup // satisfies PZI. The status is reserved for future use. @@ -523,7 +523,7 @@ type Backup struct { State string `json:"state,omitempty"` // TimeZone: Output only. This output contains a backup time zone. If a Cloud // SQL for SQL Server instance has a different time zone from the backup's time - // zone, then restores to the instance won't happen. + // zone, then the restore to the instance doesn't happen. TimeZone string `json:"timeZone,omitempty"` // TtlDays: Input only. The time-to-live (TTL) interval for this resource (in // days). For example: ttlDays:7 means 7 days. @@ -3530,9 +3530,11 @@ type Operation struct { // instance. // "MAJOR_VERSION_UPGRADE" - Updates the major version of a Cloud SQL // instance. - // "ADVANCED_BACKUP" - Creates a backup for an Advanced BackupTier Cloud SQL - // instance. + // "ADVANCED_BACKUP" - Deprecated: ADVANCED_BACKUP is deprecated. Use + // ENHANCED_BACKUP instead. // "MANAGE_BACKUP" - Changes the BackupTier of a Cloud SQL instance. + // "ENHANCED_BACKUP" - Creates a backup for an Enhanced BackupTier Cloud SQL + // instance. OperationType string `json:"operationType,omitempty"` // SelfLink: The URI of this resource. SelfLink string `json:"selfLink,omitempty"` @@ -3551,8 +3553,9 @@ type Operation struct { Status string `json:"status,omitempty"` // SubOperationType: Optional. The sub operation based on the operation type. SubOperationType *SqlSubOperationType `json:"subOperationType,omitempty"` - TargetId string `json:"targetId,omitempty"` - TargetLink string `json:"targetLink,omitempty"` + // TargetId: Name of the resource on which this operation runs. + TargetId string `json:"targetId,omitempty"` + TargetLink string `json:"targetLink,omitempty"` // TargetProject: The project ID of the target instance related to this // operation. TargetProject string `json:"targetProject,omitempty"` diff --git a/storage/v1/storage-api.json b/storage/v1/storage-api.json index 992c4c0145a..1a550aa73a4 100644 --- a/storage/v1/storage-api.json +++ b/storage/v1/storage-api.json @@ -93,7 +93,7 @@ "location": "us-west4" } ], - "etag": "\"3133343838373034343130353038353234313337\"", + "etag": "\"323434373038373139383836363433393338\"", "icons": { "x16": "https://www.google.com/images/icons/product/cloud_storage-16.png", "x32": "https://www.google.com/images/icons/product/cloud_storage-32.png" @@ -1678,7 +1678,7 @@ "type": "string" }, "recursive": { - "description": "If true, any parent folder which doesn’t exist will be created automatically.", + "description": "If true, any parent folder which doesn't exist will be created automatically.", "location": "query", "type": "boolean" } @@ -4364,7 +4364,7 @@ } } }, - "revision": "20241206", + "revision": "20250224", "rootUrl": "https://storage.googleapis.com/", "schemas": { "AdvanceRelocateBucketOperationRequest": { @@ -6075,7 +6075,7 @@ "storage.managedFolders.setIamPolicy" ] }, - "description": "A collection of identifiers for members who may assume the provided role. Recognized identifiers are as follows: \n- allUsers — A special identifier that represents anyone on the internet; with or without a Google account. \n- allAuthenticatedUsers — A special identifier that represents anyone who is authenticated with a Google account or a service account. \n- user:emailid — An email address that represents a specific account. For example, user:alice@gmail.com or user:joe@example.com. \n- serviceAccount:emailid — An email address that represents a service account. For example, serviceAccount:my-other-app@appspot.gserviceaccount.com . \n- group:emailid — An email address that represents a Google group. For example, group:admins@example.com. \n- domain:domain — A Google Apps domain name that represents all the users of that domain. For example, domain:google.com or domain:example.com. \n- projectOwner:projectid — Owners of the given project. For example, projectOwner:my-example-project \n- projectEditor:projectid — Editors of the given project. For example, projectEditor:my-example-project \n- projectViewer:projectid — Viewers of the given project. For example, projectViewer:my-example-project", + "description": "A collection of identifiers for members who may assume the provided role. Recognized identifiers are as follows: \n- allUsers - A special identifier that represents anyone on the internet; with or without a Google account. \n- allAuthenticatedUsers - A special identifier that represents anyone who is authenticated with a Google account or a service account. \n- user:emailid - An email address that represents a specific account. For example, user:alice@gmail.com or user:joe@example.com. \n- serviceAccount:emailid - An email address that represents a service account. For example, serviceAccount:my-other-app@appspot.gserviceaccount.com . \n- group:emailid - An email address that represents a Google group. For example, group:admins@example.com. \n- domain:domain - A Google Apps domain name that represents all the users of that domain. For example, domain:google.com or domain:example.com. \n- projectOwner:projectid - Owners of the given project. For example, projectOwner:my-example-project \n- projectEditor:projectid - Editors of the given project. For example, projectEditor:my-example-project \n- projectViewer:projectid - Viewers of the given project. For example, projectViewer:my-example-project", "items": { "type": "string" }, @@ -6089,7 +6089,7 @@ "storage.managedFolders.setIamPolicy" ] }, - "description": "The role to which members belong. Two types of roles are supported: new IAM roles, which grant permissions that do not map directly to those provided by ACLs, and legacy IAM roles, which do map directly to ACL permissions. All roles are of the format roles/storage.specificRole.\nThe new IAM roles are: \n- roles/storage.admin — Full control of Google Cloud Storage resources. \n- roles/storage.objectViewer — Read-Only access to Google Cloud Storage objects. \n- roles/storage.objectCreator — Access to create objects in Google Cloud Storage. \n- roles/storage.objectAdmin — Full control of Google Cloud Storage objects. The legacy IAM roles are: \n- roles/storage.legacyObjectReader — Read-only access to objects without listing. Equivalent to an ACL entry on an object with the READER role. \n- roles/storage.legacyObjectOwner — Read/write access to existing objects without listing. Equivalent to an ACL entry on an object with the OWNER role. \n- roles/storage.legacyBucketReader — Read access to buckets with object listing. Equivalent to an ACL entry on a bucket with the READER role. \n- roles/storage.legacyBucketWriter — Read access to buckets with object listing/creation/deletion. Equivalent to an ACL entry on a bucket with the WRITER role. \n- roles/storage.legacyBucketOwner — Read and write access to existing buckets with object listing/creation/deletion. Equivalent to an ACL entry on a bucket with the OWNER role.", + "description": "The role to which members belong. Two types of roles are supported: new IAM roles, which grant permissions that do not map directly to those provided by ACLs, and legacy IAM roles, which do map directly to ACL permissions. All roles are of the format roles/storage.specificRole.\nThe new IAM roles are: \n- roles/storage.admin - Full control of Google Cloud Storage resources. \n- roles/storage.objectViewer - Read-Only access to Google Cloud Storage objects. \n- roles/storage.objectCreator - Access to create objects in Google Cloud Storage. \n- roles/storage.objectAdmin - Full control of Google Cloud Storage objects. The legacy IAM roles are: \n- roles/storage.legacyObjectReader - Read-only access to objects without listing. Equivalent to an ACL entry on an object with the READER role. \n- roles/storage.legacyObjectOwner - Read/write access to existing objects without listing. Equivalent to an ACL entry on an object with the OWNER role. \n- roles/storage.legacyBucketReader - Read access to buckets with object listing. Equivalent to an ACL entry on a bucket with the READER role. \n- roles/storage.legacyBucketWriter - Read access to buckets with object listing/creation/deletion. Equivalent to an ACL entry on a bucket with the WRITER role. \n- roles/storage.legacyBucketOwner - Read and write access to existing buckets with object listing/creation/deletion. Equivalent to an ACL entry on a bucket with the OWNER role.", "type": "string" } }, @@ -6207,7 +6207,7 @@ "type": "string" }, "permissions": { - "description": "The permissions held by the caller. Permissions are always of the format storage.resource.capability, where resource is one of buckets, objects, or managedFolders. The supported permissions are as follows: \n- storage.buckets.delete — Delete bucket. \n- storage.buckets.get — Read bucket metadata. \n- storage.buckets.getIamPolicy — Read bucket IAM policy. \n- storage.buckets.create — Create bucket. \n- storage.buckets.list — List buckets. \n- storage.buckets.setIamPolicy — Update bucket IAM policy. \n- storage.buckets.update — Update bucket metadata. \n- storage.objects.delete — Delete object. \n- storage.objects.get — Read object data and metadata. \n- storage.objects.getIamPolicy — Read object IAM policy. \n- storage.objects.create — Create object. \n- storage.objects.list — List objects. \n- storage.objects.setIamPolicy — Update object IAM policy. \n- storage.objects.update — Update object metadata. \n- storage.managedFolders.delete — Delete managed folder. \n- storage.managedFolders.get — Read managed folder metadata. \n- storage.managedFolders.getIamPolicy — Read managed folder IAM policy. \n- storage.managedFolders.create — Create managed folder. \n- storage.managedFolders.list — List managed folders. \n- storage.managedFolders.setIamPolicy — Update managed folder IAM policy.", + "description": "The permissions held by the caller. Permissions are always of the format storage.resource.capability, where resource is one of buckets, objects, or managedFolders. The supported permissions are as follows: \n- storage.buckets.delete - Delete bucket. \n- storage.buckets.get - Read bucket metadata. \n- storage.buckets.getIamPolicy - Read bucket IAM policy. \n- storage.buckets.create - Create bucket. \n- storage.buckets.list - List buckets. \n- storage.buckets.setIamPolicy - Update bucket IAM policy. \n- storage.buckets.update - Update bucket metadata. \n- storage.objects.delete - Delete object. \n- storage.objects.get - Read object data and metadata. \n- storage.objects.getIamPolicy - Read object IAM policy. \n- storage.objects.create - Create object. \n- storage.objects.list - List objects. \n- storage.objects.setIamPolicy - Update object IAM policy. \n- storage.objects.update - Update object metadata. \n- storage.managedFolders.delete - Delete managed folder. \n- storage.managedFolders.get - Read managed folder metadata. \n- storage.managedFolders.getIamPolicy - Read managed folder IAM policy. \n- storage.managedFolders.create - Create managed folder. \n- storage.managedFolders.list - List managed folders. \n- storage.managedFolders.setIamPolicy - Update managed folder IAM policy.", "items": { "type": "string" }, diff --git a/storage/v1/storage-gen.go b/storage/v1/storage-gen.go index 89f08a8d98b..79c9f1d6c11 100644 --- a/storage/v1/storage-gen.go +++ b/storage/v1/storage-gen.go @@ -2611,24 +2611,24 @@ type PolicyBindings struct { Condition *Expr `json:"condition,omitempty"` // Members: A collection of identifiers for members who may assume the provided // role. Recognized identifiers are as follows: - // - allUsers — A special identifier that represents anyone on the internet; + // - allUsers - A special identifier that represents anyone on the internet; // with or without a Google account. - // - allAuthenticatedUsers — A special identifier that represents anyone who - // is authenticated with a Google account or a service account. - // - user:emailid — An email address that represents a specific account. For + // - allAuthenticatedUsers - A special identifier that represents anyone who is + // authenticated with a Google account or a service account. + // - user:emailid - An email address that represents a specific account. For // example, user:alice@gmail.com or user:joe@example.com. - // - serviceAccount:emailid — An email address that represents a service + // - serviceAccount:emailid - An email address that represents a service // account. For example, // serviceAccount:my-other-app@appspot.gserviceaccount.com . - // - group:emailid — An email address that represents a Google group. For + // - group:emailid - An email address that represents a Google group. For // example, group:admins@example.com. - // - domain:domain — A Google Apps domain name that represents all the users - // of that domain. For example, domain:google.com or domain:example.com. - // - projectOwner:projectid — Owners of the given project. For example, + // - domain:domain - A Google Apps domain name that represents all the users of + // that domain. For example, domain:google.com or domain:example.com. + // - projectOwner:projectid - Owners of the given project. For example, // projectOwner:my-example-project - // - projectEditor:projectid — Editors of the given project. For example, + // - projectEditor:projectid - Editors of the given project. For example, // projectEditor:my-example-project - // - projectViewer:projectid — Viewers of the given project. For example, + // - projectViewer:projectid - Viewers of the given project. For example, // projectViewer:my-example-project Members []string `json:"members,omitempty"` // Role: The role to which members belong. Two types of roles are supported: @@ -2636,25 +2636,24 @@ type PolicyBindings struct { // provided by ACLs, and legacy IAM roles, which do map directly to ACL // permissions. All roles are of the format roles/storage.specificRole. // The new IAM roles are: - // - roles/storage.admin — Full control of Google Cloud Storage resources. - // - // - roles/storage.objectViewer — Read-Only access to Google Cloud Storage + // - roles/storage.admin - Full control of Google Cloud Storage resources. + // - roles/storage.objectViewer - Read-Only access to Google Cloud Storage // objects. - // - roles/storage.objectCreator — Access to create objects in Google Cloud + // - roles/storage.objectCreator - Access to create objects in Google Cloud // Storage. - // - roles/storage.objectAdmin — Full control of Google Cloud Storage - // objects. The legacy IAM roles are: - // - roles/storage.legacyObjectReader — Read-only access to objects without + // - roles/storage.objectAdmin - Full control of Google Cloud Storage objects. + // The legacy IAM roles are: + // - roles/storage.legacyObjectReader - Read-only access to objects without // listing. Equivalent to an ACL entry on an object with the READER role. - // - roles/storage.legacyObjectOwner — Read/write access to existing objects + // - roles/storage.legacyObjectOwner - Read/write access to existing objects // without listing. Equivalent to an ACL entry on an object with the OWNER // role. - // - roles/storage.legacyBucketReader — Read access to buckets with object + // - roles/storage.legacyBucketReader - Read access to buckets with object // listing. Equivalent to an ACL entry on a bucket with the READER role. - // - roles/storage.legacyBucketWriter — Read access to buckets with object + // - roles/storage.legacyBucketWriter - Read access to buckets with object // listing/creation/deletion. Equivalent to an ACL entry on a bucket with the // WRITER role. - // - roles/storage.legacyBucketOwner — Read and write access to existing + // - roles/storage.legacyBucketOwner - Read and write access to existing // buckets with object listing/creation/deletion. Equivalent to an ACL entry on // a bucket with the OWNER role. Role string `json:"role,omitempty"` @@ -2807,27 +2806,26 @@ type TestIamPermissionsResponse struct { // Permissions: The permissions held by the caller. Permissions are always of // the format storage.resource.capability, where resource is one of buckets, // objects, or managedFolders. The supported permissions are as follows: - // - storage.buckets.delete — Delete bucket. - // - storage.buckets.get — Read bucket metadata. - // - storage.buckets.getIamPolicy — Read bucket IAM policy. - // - storage.buckets.create — Create bucket. - // - storage.buckets.list — List buckets. - // - storage.buckets.setIamPolicy — Update bucket IAM policy. - // - storage.buckets.update — Update bucket metadata. - // - storage.objects.delete — Delete object. - // - storage.objects.get — Read object data and metadata. - // - storage.objects.getIamPolicy — Read object IAM policy. - // - storage.objects.create — Create object. - // - storage.objects.list — List objects. - // - storage.objects.setIamPolicy — Update object IAM policy. - // - storage.objects.update — Update object metadata. - // - storage.managedFolders.delete — Delete managed folder. - // - storage.managedFolders.get — Read managed folder metadata. - // - storage.managedFolders.getIamPolicy — Read managed folder IAM policy. - // - // - storage.managedFolders.create — Create managed folder. - // - storage.managedFolders.list — List managed folders. - // - storage.managedFolders.setIamPolicy — Update managed folder IAM policy. + // - storage.buckets.delete - Delete bucket. + // - storage.buckets.get - Read bucket metadata. + // - storage.buckets.getIamPolicy - Read bucket IAM policy. + // - storage.buckets.create - Create bucket. + // - storage.buckets.list - List buckets. + // - storage.buckets.setIamPolicy - Update bucket IAM policy. + // - storage.buckets.update - Update bucket metadata. + // - storage.objects.delete - Delete object. + // - storage.objects.get - Read object data and metadata. + // - storage.objects.getIamPolicy - Read object IAM policy. + // - storage.objects.create - Create object. + // - storage.objects.list - List objects. + // - storage.objects.setIamPolicy - Update object IAM policy. + // - storage.objects.update - Update object metadata. + // - storage.managedFolders.delete - Delete managed folder. + // - storage.managedFolders.get - Read managed folder metadata. + // - storage.managedFolders.getIamPolicy - Read managed folder IAM policy. + // - storage.managedFolders.create - Create managed folder. + // - storage.managedFolders.list - List managed folders. + // - storage.managedFolders.setIamPolicy - Update managed folder IAM policy. Permissions []string `json:"permissions,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -7116,7 +7114,7 @@ func (r *FoldersService) Insert(bucket string, folder *Folder) *FoldersInsertCal } // Recursive sets the optional parameter "recursive": If true, any parent -// folder which doesn’t exist will be created automatically. +// folder which doesn't exist will be created automatically. func (c *FoldersInsertCall) Recursive(recursive bool) *FoldersInsertCall { c.urlParams_.Set("recursive", fmt.Sprint(recursive)) return c diff --git a/workspaceevents/v1/workspaceevents-api.json b/workspaceevents/v1/workspaceevents-api.json index 3ee66e74b21..e10219a967c 100644 --- a/workspaceevents/v1/workspaceevents-api.json +++ b/workspaceevents/v1/workspaceevents-api.json @@ -474,7 +474,7 @@ } } }, - "revision": "20250114", + "revision": "20250225", "rootUrl": "https://workspaceevents.googleapis.com/", "schemas": { "ListSubscriptionsResponse": { @@ -500,7 +500,7 @@ "id": "NotificationEndpoint", "properties": { "pubsubTopic": { - "description": "Immutable. The Cloud Pub/Sub topic that receives events for the subscription. Format: `projects/{project}/topics/{topic}` You must create the topic in the same Google Cloud project where you create this subscription. When the topic receives events, the events are encoded as Cloud Pub/Sub messages. For details, see the [Google Cloud Pub/Sub Protocol Binding for CloudEvents](https://github.com/googleapis/google-cloudevents/blob/main/docs/spec/pubsub.md).", + "description": "Immutable. The Pub/Sub topic that receives events for the subscription. Format: `projects/{project}/topics/{topic}` You must create the topic in the same Google Cloud project where you create this subscription. When the topic receives events, the events are encoded as Pub/Sub messages. For details, see the [Google Cloud Pub/Sub Protocol Binding for CloudEvents](https://github.com/googleapis/google-cloudevents/blob/main/docs/spec/pubsub.md).", "type": "string" } }, diff --git a/workspaceevents/v1/workspaceevents-gen.go b/workspaceevents/v1/workspaceevents-gen.go index 3b2ee5cf58d..a13ddcb04df 100644 --- a/workspaceevents/v1/workspaceevents-gen.go +++ b/workspaceevents/v1/workspaceevents-gen.go @@ -279,12 +279,12 @@ func (s ListSubscriptionsResponse) MarshalJSON() ([]byte, error) { // NotificationEndpoint: The endpoint where the subscription delivers events. type NotificationEndpoint struct { - // PubsubTopic: Immutable. The Cloud Pub/Sub topic that receives events for the + // PubsubTopic: Immutable. The Pub/Sub topic that receives events for the // subscription. Format: `projects/{project}/topics/{topic}` You must create // the topic in the same Google Cloud project where you create this // subscription. When the topic receives events, the events are encoded as - // Cloud Pub/Sub messages. For details, see the Google Cloud Pub/Sub Protocol - // Binding for CloudEvents + // Pub/Sub messages. For details, see the Google Cloud Pub/Sub Protocol Binding + // for CloudEvents // (https://github.com/googleapis/google-cloudevents/blob/main/docs/spec/pubsub.md). PubsubTopic string `json:"pubsubTopic,omitempty"` // ForceSendFields is a list of field names (e.g. "PubsubTopic") to