From b3edb9028c78cfe0cf491f4ee7b1855ce54425ee Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Sat, 29 Jun 2024 07:09:15 +0000 Subject: [PATCH] feat(all): auto-regenerate discovery clients --- api-list.json | 15 - bigquery/v2/bigquery-api.json | 27 +- bigquery/v2/bigquery-gen.go | 37 +- chat/v1/chat-api.json | 51 +- chat/v1/chat-gen.go | 129 +- container/v1beta1/container-api.json | 8 +- container/v1beta1/container-gen.go | 6 +- file/v1/file-api.json | 85 +- file/v1/file-gen.go | 124 ++ file/v1beta1/file-api.json | 85 +- file/v1beta1/file-gen.go | 124 ++ healthcare/v1/healthcare-api.json | 6 +- healthcare/v1/healthcare-gen.go | 4 +- healthcare/v1beta1/healthcare-api.json | 6 +- healthcare/v1beta1/healthcare-gen.go | 14 +- logging/v2/logging-api.json | 306 ++++- logging/v2/logging-gen.go | 1214 +++++++++++++++++-- storage/v1/storage-api.json | 14 +- workloadmanager/v1/workloadmanager-api.json | 68 +- workloadmanager/v1/workloadmanager-gen.go | 107 +- workstations/v1/workstations-api.json | 14 +- workstations/v1/workstations-gen.go | 12 + workstations/v1beta/workstations-api.json | 21 +- workstations/v1beta/workstations-gen.go | 37 + 24 files changed, 2250 insertions(+), 264 deletions(-) diff --git a/api-list.json b/api-list.json index 9ba748f455d..555e1fd1c73 100644 --- a/api-list.json +++ b/api-list.json @@ -3291,21 +3291,6 @@ "documentationLink": "https://cloud.google.com/firestore", "preferred": true }, - { - "kind": "discovery#directoryItem", - "id": "fitness:v1", - "name": "fitness", - "version": "v1", - "title": "Fitness API", - "description": "The Fitness API for managing users' fitness tracking data.", - "discoveryRestUrl": "https://fitness.googleapis.com/$discovery/rest?version=v1", - "icons": { - "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png", - "x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png" - }, - "documentationLink": "https://developers.google.com/fit/rest/v1/get-started", - "preferred": true - }, { "kind": "discovery#directoryItem", "id": "forms:v1", diff --git a/bigquery/v2/bigquery-api.json b/bigquery/v2/bigquery-api.json index e1baac25f8d..1417f68a38b 100644 --- a/bigquery/v2/bigquery-api.json +++ b/bigquery/v2/bigquery-api.json @@ -34,11 +34,6 @@ "discoveryVersion": "v1", "documentationLink": "https://cloud.google.com/bigquery/", "endpoints": [ - { - "description": "Regional Endpoint", - "endpointUrl": "https://bigquery.me-central2.rep.googleapis.com/", - "location": "me-central2" - }, { "description": "Regional Endpoint", "endpointUrl": "https://bigquery.europe-west3.rep.googleapis.com/", @@ -49,6 +44,11 @@ "endpointUrl": "https://bigquery.europe-west9.rep.googleapis.com/", "location": "europe-west9" }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://bigquery.me-central2.rep.googleapis.com/", + "location": "me-central2" + }, { "description": "Regional Endpoint", "endpointUrl": "https://bigquery.us-east4.rep.googleapis.com/", @@ -1935,7 +1935,7 @@ } } }, - "revision": "20240526", + "revision": "20240616", "rootUrl": "https://bigquery.googleapis.com/", "schemas": { "AggregateClassificationMetrics": { @@ -2998,7 +2998,7 @@ "type": "object" }, "ConnectionProperty": { - "description": "A connection-level property to customize query behavior. Under JDBC, these correspond directly to connection properties passed to the DriverManager. Under ODBC, these correspond to properties in the connection string. Currently supported connection properties: * **dataset_project_id**: represents the default project for datasets that are used in the query. Setting the system variable `@@dataset_project_id` achieves the same behavior. For more information about system variables, see: https://cloud.google.com/bigquery/docs/reference/system-variables * **time_zone**: represents the default timezone used to run the query. * **session_id**: associates the query with a given session. * **query_label**: associates the query with a given job label. If set, all subsequent queries in a script or session will have this label. For the format in which a you can specify a query label, see labels in the JobConfiguration resource type: https://cloud.google.com/bigquery/docs/reference/rest/v2/Job#jobconfiguration Additional properties are allowed, but ignored. Specifying multiple connection properties with the same key returns an error.", + "description": "A connection-level property to customize query behavior. Under JDBC, these correspond directly to connection properties passed to the DriverManager. Under ODBC, these correspond to properties in the connection string. Currently supported connection properties: * **dataset_project_id**: represents the default project for datasets that are used in the query. Setting the system variable `@@dataset_project_id` achieves the same behavior. For more information about system variables, see: https://cloud.google.com/bigquery/docs/reference/system-variables * **time_zone**: represents the default timezone used to run the query. * **session_id**: associates the query with a given session. * **query_label**: associates the query with a given job label. If set, all subsequent queries in a script or session will have this label. For the format in which a you can specify a query label, see labels in the JobConfiguration resource type: https://cloud.google.com/bigquery/docs/reference/rest/v2/Job#jobconfiguration * **service_account**: indicates the service account to use to run a continuous query. If set, the query job uses the service account to access Google Cloud resources. Service account access is bounded by the IAM permissions that you have granted to the service account. Additional properties are allowed, but ignored. Specifying multiple connection properties with the same key returns an error.", "id": "ConnectionProperty", "properties": { "key": { @@ -6747,23 +6747,21 @@ "id": "PartitionedColumn", "properties": { "field": { - "description": "Output only. The name of the partition column.", - "readOnly": true, + "description": "Required. The name of the partition column.", "type": "string" } }, "type": "object" }, "PartitioningDefinition": { - "description": "The partitioning information, which includes managed table and external table partition information.", + "description": "The partitioning information, which includes managed table, external table and metastore partitioned table partition information.", "id": "PartitioningDefinition", "properties": { "partitionedColumn": { - "description": "Output only. Details about each partitioning column. BigQuery native tables only support 1 partitioning column. Other table types may support 0, 1 or more partitioning columns.", + "description": "Optional. Details about each partitioning column. This field is output only for all partitioning types other than metastore partitioned tables. BigQuery native tables only support 1 partitioning column. Other table types may support 0, 1 or more partitioning columns. For metastore partitioned tables, the order must match the definition order in the Hive Metastore, where it must match the physical layout of the table. For example, CREATE TABLE a_table(id BIGINT, name STRING) PARTITIONED BY (city STRING, state STRING). In this case the values must be ['city', 'state'] in that order.", "items": { "$ref": "PartitionedColumn" }, - "readOnly": true, "type": "array" } }, @@ -7281,7 +7279,7 @@ "id": "RangePartitioning", "properties": { "field": { - "description": "Required. [Experimental] The table is partitioned by this field. The field must be a top-level NULLABLE/REQUIRED field. The only supported type is INTEGER/INT64.", + "description": "Required. The name of the column to partition the table on. It must be a top-level, INT64 column whose mode is NULLABLE or REQUIRED.", "type": "string" }, "range": { @@ -8507,8 +8505,7 @@ }, "partitionDefinition": { "$ref": "PartitioningDefinition", - "description": "Output only. The partition information for all table formats, including managed partitioned tables, hive partitioned tables, and iceberg partitioned tables.", - "readOnly": true + "description": "Optional. The partition information for all table formats, including managed partitioned tables, hive partitioned tables, iceberg partitioned, and metastore partitioned tables. This field is only populated for metastore partitioned tables. For other table formats, this is an output only field." }, "rangePartitioning": { "$ref": "RangePartitioning", diff --git a/bigquery/v2/bigquery-gen.go b/bigquery/v2/bigquery-gen.go index 5e1d7bd25b3..193c23986b2 100644 --- a/bigquery/v2/bigquery-gen.go +++ b/bigquery/v2/bigquery-gen.go @@ -1743,8 +1743,12 @@ func (s *ConfusionMatrix) UnmarshalJSON(data []byte) error { // format in which a you can specify a query label, see labels in the // JobConfiguration resource type: // https://cloud.google.com/bigquery/docs/reference/rest/v2/Job#jobconfiguration -// Additional properties are allowed, but ignored. Specifying multiple -// connection properties with the same key returns an error. +// * **service_account**: indicates the service account to use to run a +// continuous query. If set, the query job uses the service account to access +// Google Cloud resources. Service account access is bounded by the IAM +// permissions that you have granted to the service account. Additional +// properties are allowed, but ignored. Specifying multiple connection +// properties with the same key returns an error. type ConnectionProperty struct { // Key: The key of the property to set. Key string `json:"key,omitempty"` @@ -6349,7 +6353,7 @@ func (s *PartitionSkew) MarshalJSON() ([]byte, error) { // PartitionedColumn: The partitioning column information. type PartitionedColumn struct { - // Field: Output only. The name of the partition column. + // Field: Required. The name of the partition column. Field string `json:"field,omitempty"` // ForceSendFields is a list of field names (e.g. "Field") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -6370,11 +6374,17 @@ func (s *PartitionedColumn) MarshalJSON() ([]byte, error) { } // PartitioningDefinition: The partitioning information, which includes managed -// table and external table partition information. +// table, external table and metastore partitioned table partition information. type PartitioningDefinition struct { - // PartitionedColumn: Output only. Details about each partitioning column. - // BigQuery native tables only support 1 partitioning column. Other table types - // may support 0, 1 or more partitioning columns. + // PartitionedColumn: Optional. Details about each partitioning column. This + // field is output only for all partitioning types other than metastore + // partitioned tables. BigQuery native tables only support 1 partitioning + // column. Other table types may support 0, 1 or more partitioning columns. For + // metastore partitioned tables, the order must match the definition order in + // the Hive Metastore, where it must match the physical layout of the table. + // For example, CREATE TABLE a_table(id BIGINT, name STRING) PARTITIONED BY + // (city STRING, state STRING). In this case the values must be ['city', + // 'state'] in that order. PartitionedColumn []*PartitionedColumn `json:"partitionedColumn,omitempty"` // ForceSendFields is a list of field names (e.g. "PartitionedColumn") to // unconditionally include in API requests. By default, fields with empty or @@ -7084,9 +7094,8 @@ func (s *QueryTimelineSample) MarshalJSON() ([]byte, error) { } type RangePartitioning struct { - // Field: Required. [Experimental] The table is partitioned by this field. The - // field must be a top-level NULLABLE/REQUIRED field. The only supported type - // is INTEGER/INT64. + // Field: Required. The name of the column to partition the table on. It must + // be a top-level, INT64 column whose mode is NULLABLE or REQUIRED. Field string `json:"field,omitempty"` // Range: [Experimental] Defines the ranges for range partitioning. Range *RangePartitioningRange `json:"range,omitempty"` @@ -8537,9 +8546,11 @@ type Table struct { // bytes. This also includes storage used for time travel. This data is not // kept in real time, and might be delayed by a few seconds to a few minutes. NumTotalPhysicalBytes int64 `json:"numTotalPhysicalBytes,omitempty,string"` - // PartitionDefinition: Output only. The partition information for all table - // formats, including managed partitioned tables, hive partitioned tables, and - // iceberg partitioned tables. + // PartitionDefinition: Optional. The partition information for all table + // formats, including managed partitioned tables, hive partitioned tables, + // iceberg partitioned, and metastore partitioned tables. This field is only + // populated for metastore partitioned tables. For other table formats, this is + // an output only field. PartitionDefinition *PartitioningDefinition `json:"partitionDefinition,omitempty"` // RangePartitioning: If specified, configures range partitioning for this // table. diff --git a/chat/v1/chat-api.json b/chat/v1/chat-api.json index 86f1a77fb23..9ac74ec57d6 100644 --- a/chat/v1/chat-api.json +++ b/chat/v1/chat-api.json @@ -433,7 +433,7 @@ "type": "string" }, "updateMask": { - "description": "Required. The updated field paths, comma separated if there are multiple. Currently supported field paths: - `display_name` (Only supports changing the display name of a space with the `SPACE` type, or when also including the `space_type` mask to change a `GROUP_CHAT` space type to `SPACE`. Trying to update the display name of a `GROUP_CHAT` or a `DIRECT_MESSAGE` space results in an invalid argument error. If you receive the error message `ALREADY_EXISTS` when updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name.) - `space_type` (Only supports changing a `GROUP_CHAT` space type to `SPACE`. Include `display_name` together with `space_type` in the update mask and ensure that the specified space has a non-empty display name and the `SPACE` space type. Including the `space_type` mask and the `SPACE` type in the specified space when updating the display name is optional if the existing space already has the `SPACE` type. Trying to update the space type in other ways results in an invalid argument error). `space_type` is not supported with admin access. - `space_details` - `space_history_state` (Supports [turning history on or off for the space](https://support.google.com/chat/answer/7664687) if [the organization allows users to change their history setting](https://support.google.com/a/answer/7664184). Warning: mutually exclusive with all other field paths.) `space_history_state` is not supported with admin access. - Developer Preview: `access_settings.audience` (Supports changing the [access setting](https://support.google.com/chat/answer/11971020) of a space. If no audience is specified in the access setting, the space's access setting is updated to restricted. Warning: mutually exclusive with all other field paths.) `access_settings.audience` is not supported with admin access. - Developer Preview: Supports changing the [permission settings](https://support.google.com/chat/answer/13340792) of a space, supported field paths include: `permission_settings.manage_members_and_groups`, `permission_settings.modify_space_details`, `permission_settings.toggle_history`, `permission_settings.use_at_mention_all`, `permission_settings.manage_apps`, `permission_settings.manage_webhooks`, `permission_settings.reply_messages` (Warning: mutually exclusive with all other non-permission settings field paths). `permission_settings` is not supported with admin access.", + "description": "Required. The updated field paths, comma separated if there are multiple. Currently supported field paths: - `display_name` (Only supports changing the display name of a space with the `SPACE` type, or when also including the `space_type` mask to change a `GROUP_CHAT` space type to `SPACE`. Trying to update the display name of a `GROUP_CHAT` or a `DIRECT_MESSAGE` space results in an invalid argument error. If you receive the error message `ALREADY_EXISTS` when updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name.) - `space_type` (Only supports changing a `GROUP_CHAT` space type to `SPACE`. Include `display_name` together with `space_type` in the update mask and ensure that the specified space has a non-empty display name and the `SPACE` space type. Including the `space_type` mask and the `SPACE` type in the specified space when updating the display name is optional if the existing space already has the `SPACE` type. Trying to update the space type in other ways results in an invalid argument error). `space_type` is not supported with admin access. - `space_details` - `space_history_state` (Supports [turning history on or off for the space](https://support.google.com/chat/answer/7664687) if [the organization allows users to change their history setting](https://support.google.com/a/answer/7664184). Warning: mutually exclusive with all other field paths.) `space_history_state` is not supported with admin access. - `access_settings.audience` (Supports changing the [access setting](https://support.google.com/chat/answer/11971020) of who can discover the space, join the space, and preview the messages in space. If no audience is specified in the access setting, the space's access setting is updated to private. Warning: mutually exclusive with all other field paths.) `access_settings.audience` is not supported with admin access. - Developer Preview: Supports changing the [permission settings](https://support.google.com/chat/answer/13340792) of a space, supported field paths include: `permission_settings.manage_members_and_groups`, `permission_settings.modify_space_details`, `permission_settings.toggle_history`, `permission_settings.use_at_mention_all`, `permission_settings.manage_apps`, `permission_settings.manage_webhooks`, `permission_settings.reply_messages` (Warning: mutually exclusive with all other non-permission settings field paths). `permission_settings` is not supported with admin access.", "format": "google-fieldmask", "location": "query", "type": "string" @@ -453,7 +453,7 @@ ] }, "setup": { - "description": "Creates a space and adds specified users to it. The calling user is automatically added to the space, and shouldn't be specified as a membership in the request. For an example, see [Set up a space with initial members](https://developers.google.com/workspace/chat/set-up-spaces). To specify the human members to add, add memberships with the appropriate `membership.member.name`. To add a human user, use `users/{user}`, where `{user}` can be the email address for the user. For users in the same Workspace organization `{user}` can also be the `id` for the person from the People API, or the `id` for the user in the Directory API. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can add the user to the space by setting the `membership.member.name` to `users/user@example.com` or `users/123456789`. For a named space or group chat, if the caller blocks, or is blocked by some members, or doesn't have permission to add some members, then those members aren't added to the created space. To create a direct message (DM) between the calling user and another human user, specify exactly one membership to represent the human user. If one user blocks the other, the request fails and the DM isn't created. To create a DM between the calling user and the calling app, set `Space.singleUserBotDm` to `true` and don't specify any memberships. You can only use this method to set up a DM with the calling app. To add the calling app as a member of a space or an existing DM between two human users, see [Invite or add a user or app to a space](https://developers.google.com/workspace/chat/create-members). If a DM already exists between two users, even when one user blocks the other at the time a request is made, then the existing DM is returned. Spaces with threaded replies aren't supported. If you receive the error message `ALREADY_EXISTS` when setting up a space, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).", + "description": "Creates a space and adds specified users to it. The calling user is automatically added to the space, and shouldn't be specified as a membership in the request. For an example, see [Set up a space with initial members](https://developers.google.com/workspace/chat/set-up-spaces). To specify the human members to add, add memberships with the appropriate `membership.member.name`. To add a human user, use `users/{user}`, where `{user}` can be the email address for the user. For users in the same Workspace organization `{user}` can also be the `id` for the person from the People API, or the `id` for the user in the Directory API. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can add the user to the space by setting the `membership.member.name` to `users/user@example.com` or `users/123456789`. To specify the Google groups to add, add memberships with the appropriate `membership.group_member.name`. To add or invite a Google group, use `groups/{group}`, where `{group}` is the `id` for the group from the Cloud Identity Groups API. For example, you can use [Cloud Identity Groups lookup API](https://cloud.google.com/identity/docs/reference/rest/v1/groups/lookup) to retrieve the ID `123456789` for group email `group@example.com`, then you can add the group to the space by setting the `membership.group_member.name` to `groups/123456789`. Group email is not supported, and Google groups can only be added as members in named spaces. For a named space or group chat, if the caller blocks, or is blocked by some members, or doesn't have permission to add some members, then those members aren't added to the created space. To create a direct message (DM) between the calling user and another human user, specify exactly one membership to represent the human user. If one user blocks the other, the request fails and the DM isn't created. To create a DM between the calling user and the calling app, set `Space.singleUserBotDm` to `true` and don't specify any memberships. You can only use this method to set up a DM with the calling app. To add the calling app as a member of a space or an existing DM between two human users, see [Invite or add a user or app to a space](https://developers.google.com/workspace/chat/create-members). If a DM already exists between two users, even when one user blocks the other at the time a request is made, then the existing DM is returned. Spaces with threaded replies aren't supported. If you receive the error message `ALREADY_EXISTS` when setting up a space, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).", "flatPath": "v1/spaces:setup", "httpMethod": "POST", "id": "chat.spaces.setup", @@ -476,7 +476,7 @@ "members": { "methods": { "create": { - "description": "Creates a human membership or app membership for the calling app. Creating memberships for other apps isn't supported. For an example, see [Invite or add a user or a Google Chat app to a space](https://developers.google.com/workspace/chat/create-members). When creating a membership, if the specified member has their auto-accept policy turned off, then they're invited, and must accept the space invitation before joining. Otherwise, creating a membership adds the member directly to the specified space. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). To specify the member to add, set the `membership.member.name` for the human or app member. - To add the calling app to a space or a direct message between two human users, use `users/app`. Unable to add other apps to the space. - To add a human user, use `users/{user}`, where `{user}` can be the email address for the user. For users in the same Workspace organization `{user}` can also be the `id` for the person from the People API, or the `id` for the user in the Directory API. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can add the user to the space by setting the `membership.member.name` to `users/user@example.com` or `users/123456789`.", + "description": "Creates a human membership or app membership for the calling app. Creating memberships for other apps isn't supported. For an example, see [Invite or add a user or a Google Chat app to a space](https://developers.google.com/workspace/chat/create-members). When creating a membership, if the specified member has their auto-accept policy turned off, then they're invited, and must accept the space invitation before joining. Otherwise, creating a membership adds the member directly to the specified space. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). To specify the member to add, set the `membership.member.name` for the human or app member, or set the `membership.group_member.name` for the group member. - To add the calling app to a space or a direct message between two human users, use `users/app`. Unable to add other apps to the space. - To add a human user, use `users/{user}`, where `{user}` can be the email address for the user. For users in the same Workspace organization `{user}` can also be the `id` for the person from the People API, or the `id` for the user in the Directory API. For example, if the People API Person profile ID for `user@example.com` is `123456789`, you can add the user to the space by setting the `membership.member.name` to `users/user@example.com` or `users/123456789`. - To add or invite a Google group in a named space, use `groups/{group}`, where `{group}` is the `id` for the group from the Cloud Identity Groups API. For example, you can use [Cloud Identity Groups lookup API](https://cloud.google.com/identity/docs/reference/rest/v1/groups/lookup) to retrieve the ID `123456789` for group email `group@example.com`, then you can add or invite the group to a named space by setting the `membership.group_member.name` to `groups/123456789`. Group email is not supported, and Google groups can only be added as members in named spaces.", "flatPath": "v1/spaces/{spacesId}/members", "httpMethod": "POST", "id": "chat.spaces.members.create", @@ -1241,9 +1241,35 @@ } } }, - "revision": "20240623", + "revision": "20240625", "rootUrl": "https://chat.googleapis.com/", "schemas": { + "AccessSettings": { + "description": "Represents the [access setting](https://support.google.com/chat/answer/11971020) of the space.", + "id": "AccessSettings", + "properties": { + "accessState": { + "description": "Output only. Indicates the access state of the space.", + "enum": [ + "ACCESS_STATE_UNSPECIFIED", + "PRIVATE", + "DISCOVERABLE" + ], + "enumDescriptions": [ + "Access state is unknown or not supported in this API.", + "Space is discoverable by added or invited members or groups.", + "Space is discoverable by the selected [target audience](https://support.google.com/a/answer/9934697), as well as added or invited members or groups." + ], + "readOnly": true, + "type": "string" + }, + "audience": { + "description": "Optional. The resource name of the [target audience](https://support.google.com/a/answer/9934697) who can discover the space, join the space, and preview the messages in the space. For details, see [Make a space discoverable to a target audience](https://developers.google.com/workspace/chat/space-target-audience). Format: `audiences/{audience}` To use the default target audience for the Google Workspace organization, set to `audiences/default`.", + "type": "string" + } + }, + "type": "object" + }, "AccessoryWidget": { "description": "One or more interactive widgets that appear at the bottom of a message. For details, see [Add interactive widgets at the bottom of a message](https://developers.google.com/workspace/chat/create-messages#add-accessory-widgets).", "id": "AccessoryWidget", @@ -2282,7 +2308,7 @@ "type": "object" }, "GoogleAppsCardV1Column": { - "description": "A column. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend): Columns for Google Workspace Add-ons are in Developer Preview.", + "description": "A column. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend)", "id": "GoogleAppsCardV1Column", "properties": { "horizontalAlignment": { @@ -3039,7 +3065,7 @@ "type": "object" }, "GoogleAppsCardV1Widgets": { - "description": "The supported widgets that you can include in a column. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend): Columns for Google Workspace Add-ons are in Developer Preview.", + "description": "The supported widgets that you can include in a column. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend)", "id": "GoogleAppsCardV1Widgets", "properties": { "buttonList": { @@ -3461,7 +3487,7 @@ }, "groupMember": { "$ref": "Group", - "description": "The Google Group the membership corresponds to. Only supports read operations. Other operations, like creating or updating a membership, aren't currently supported." + "description": "The Google Group the membership corresponds to." }, "member": { "$ref": "User", @@ -3982,7 +4008,7 @@ "id": "SetUpSpaceRequest", "properties": { "memberships": { - "description": "Optional. The Google Chat users to invite to join the space. Omit the calling user, as they are added automatically. The set currently allows up to 20 memberships (in addition to the caller). For human membership, the `Membership.member` field must contain a `user` with `name` populated (format: `users/{user}`) and `type` set to `User.Type.HUMAN`. You can only add human users when setting up a space (adding Chat apps is only supported for direct message setup with the calling app). You can also add members using the user's email as an alias for {user}. For example, the `user.name` can be `users/example@gmail.com`. To invite Gmail users or users from external Google Workspace domains, user's email must be used for `{user}`. Optional when setting `Space.spaceType` to `SPACE`. Required when setting `Space.spaceType` to `GROUP_CHAT`, along with at least two memberships. Required when setting `Space.spaceType` to `DIRECT_MESSAGE` with a human user, along with exactly one membership. Must be empty when creating a 1:1 conversation between a human and the calling Chat app (when setting `Space.spaceType` to `DIRECT_MESSAGE` and `Space.singleUserBotDm` to `true`).", + "description": "Optional. The Google Chat users or groups to invite to join the space. Omit the calling user, as they are added automatically. The set currently allows up to 20 memberships (in addition to the caller). For human membership, the `Membership.member` field must contain a `user` with `name` populated (format: `users/{user}`) and `type` set to `User.Type.HUMAN`. You can only add human users when setting up a space (adding Chat apps is only supported for direct message setup with the calling app). You can also add members using the user's email as an alias for {user}. For example, the `user.name` can be `users/example@gmail.com`. To invite Gmail users or users from external Google Workspace domains, user's email must be used for `{user}`. For Google group membership, the `Membership.group_member` field must contain a `group` with `name` populated (format `groups/{group}`). You can only add Google groups when setting `Space.spaceType` to `SPACE`. Optional when setting `Space.spaceType` to `SPACE`. Required when setting `Space.spaceType` to `GROUP_CHAT`, along with at least two memberships. Required when setting `Space.spaceType` to `DIRECT_MESSAGE` with a human user, along with exactly one membership. Must be empty when creating a 1:1 conversation between a human and the calling Chat app (when setting `Space.spaceType` to `DIRECT_MESSAGE` and `Space.singleUserBotDm` to `true`).", "items": { "$ref": "Membership" }, @@ -4053,6 +4079,10 @@ "description": "A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app.", "id": "Space", "properties": { + "accessSettings": { + "$ref": "AccessSettings", + "description": "Optional. Specifies the [access setting](https://support.google.com/chat/answer/11971020) of the space. Only populated when the `space_type` is `SPACE`." + }, "adminInstalled": { "description": "Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.", "readOnly": true, @@ -4134,6 +4164,11 @@ ], "type": "string" }, + "spaceUri": { + "description": "Output only. The URI for a user to access the space.", + "readOnly": true, + "type": "string" + }, "threaded": { "deprecated": true, "description": "Output only. Deprecated: Use `spaceThreadingState` instead. Whether messages are threaded in this space.", diff --git a/chat/v1/chat-gen.go b/chat/v1/chat-gen.go index a27f8cc4efc..b23cf5e82b4 100644 --- a/chat/v1/chat-gen.go +++ b/chat/v1/chat-gen.go @@ -366,6 +366,45 @@ type UsersSpacesThreadsService struct { s *Service } +// AccessSettings: Represents the access setting +// (https://support.google.com/chat/answer/11971020) of the space. +type AccessSettings struct { + // AccessState: Output only. Indicates the access state of the space. + // + // Possible values: + // "ACCESS_STATE_UNSPECIFIED" - Access state is unknown or not supported in + // this API. + // "PRIVATE" - Space is discoverable by added or invited members or groups. + // "DISCOVERABLE" - Space is discoverable by the selected [target + // audience](https://support.google.com/a/answer/9934697), as well as added or + // invited members or groups. + AccessState string `json:"accessState,omitempty"` + // Audience: Optional. The resource name of the target audience + // (https://support.google.com/a/answer/9934697) who can discover the space, + // join the space, and preview the messages in the space. For details, see Make + // a space discoverable to a target audience + // (https://developers.google.com/workspace/chat/space-target-audience). + // Format: `audiences/{audience}` To use the default target audience for the + // Google Workspace organization, set to `audiences/default`. + Audience string `json:"audience,omitempty"` + // ForceSendFields is a list of field names (e.g. "AccessState") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AccessState") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *AccessSettings) MarshalJSON() ([]byte, error) { + type NoMethod AccessSettings + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // AccessoryWidget: One or more interactive widgets that appear at the bottom // of a message. For details, see Add interactive widgets at the bottom of a // message @@ -1958,8 +1997,7 @@ func (s *GoogleAppsCardV1CardHeader) MarshalJSON() ([]byte, error) { } // GoogleAppsCardV1Column: A column. Google Workspace Add-ons and Chat apps -// (https://developers.google.com/workspace/extend): Columns for Google -// Workspace Add-ons are in Developer Preview. +// (https://developers.google.com/workspace/extend) type GoogleAppsCardV1Column struct { // HorizontalAlignment: Specifies whether widgets align to the left, right, or // center of a column. @@ -3122,8 +3160,7 @@ func (s *GoogleAppsCardV1Widget) MarshalJSON() ([]byte, error) { // GoogleAppsCardV1Widgets: The supported widgets that you can include in a // column. Google Workspace Add-ons and Chat apps -// (https://developers.google.com/workspace/extend): Columns for Google -// Workspace Add-ons are in Developer Preview. +// (https://developers.google.com/workspace/extend) type GoogleAppsCardV1Widgets struct { // ButtonList: ButtonList widget. ButtonList *GoogleAppsCardV1ButtonList `json:"buttonList,omitempty"` @@ -3646,9 +3683,7 @@ type Membership struct { // only, except when used to import historical memberships in import mode // spaces. DeleteTime string `json:"deleteTime,omitempty"` - // GroupMember: The Google Group the membership corresponds to. Only supports - // read operations. Other operations, like creating or updating a membership, - // aren't currently supported. + // GroupMember: The Google Group the membership corresponds to. GroupMember *Group `json:"groupMember,omitempty"` // Member: The Google Chat user or app the membership corresponds to. If your // Chat app authenticates as a user @@ -4428,9 +4463,9 @@ func (s *SelectionItems) MarshalJSON() ([]byte, error) { // SetUpSpaceRequest: Request to create a space and add specified users to it. type SetUpSpaceRequest struct { - // Memberships: Optional. The Google Chat users to invite to join the space. - // Omit the calling user, as they are added automatically. The set currently - // allows up to 20 memberships (in addition to the caller). For human + // Memberships: Optional. The Google Chat users or groups to invite to join the + // space. Omit the calling user, as they are added automatically. The set + // currently allows up to 20 memberships (in addition to the caller). For human // membership, the `Membership.member` field must contain a `user` with `name` // populated (format: `users/{user}`) and `type` set to `User.Type.HUMAN`. You // can only add human users when setting up a space (adding Chat apps is only @@ -4438,12 +4473,15 @@ type SetUpSpaceRequest struct { // members using the user's email as an alias for {user}. For example, the // `user.name` can be `users/example@gmail.com`. To invite Gmail users or users // from external Google Workspace domains, user's email must be used for - // `{user}`. Optional when setting `Space.spaceType` to `SPACE`. Required when - // setting `Space.spaceType` to `GROUP_CHAT`, along with at least two - // memberships. Required when setting `Space.spaceType` to `DIRECT_MESSAGE` - // with a human user, along with exactly one membership. Must be empty when - // creating a 1:1 conversation between a human and the calling Chat app (when - // setting `Space.spaceType` to `DIRECT_MESSAGE` and `Space.singleUserBotDm` to + // `{user}`. For Google group membership, the `Membership.group_member` field + // must contain a `group` with `name` populated (format `groups/{group}`). You + // can only add Google groups when setting `Space.spaceType` to `SPACE`. + // Optional when setting `Space.spaceType` to `SPACE`. Required when setting + // `Space.spaceType` to `GROUP_CHAT`, along with at least two memberships. + // Required when setting `Space.spaceType` to `DIRECT_MESSAGE` with a human + // user, along with exactly one membership. Must be empty when creating a 1:1 + // conversation between a human and the calling Chat app (when setting + // `Space.spaceType` to `DIRECT_MESSAGE` and `Space.singleUserBotDm` to // `true`). Memberships []*Membership `json:"memberships,omitempty"` // RequestId: Optional. A unique identifier for this request. A random UUID is @@ -4546,6 +4584,10 @@ func (s *SlashCommandMetadata) MarshalJSON() ([]byte, error) { // Space: A space in Google Chat. Spaces are conversations between two or more // users or 1:1 messages between a user and a Chat app. type Space struct { + // AccessSettings: Optional. Specifies the access setting + // (https://support.google.com/chat/answer/11971020) of the space. Only + // populated when the `space_type` is `SPACE`. + AccessSettings *AccessSettings `json:"accessSettings,omitempty"` // AdminInstalled: Output only. For direct message (DM) spaces with a Chat app, // whether the space was created by a Google Workspace administrator. // Administrators can install and set up a direct message with a Chat app on @@ -4626,6 +4668,8 @@ type Space struct { // "DIRECT_MESSAGE" - 1:1 messages between two humans or a human and a Chat // app. SpaceType string `json:"spaceType,omitempty"` + // SpaceUri: Output only. The URI for a user to access the space. + SpaceUri string `json:"spaceUri,omitempty"` // Threaded: Output only. Deprecated: Use `spaceThreadingState` instead. // Whether messages are threaded in this space. Threaded bool `json:"threaded,omitempty"` @@ -4642,13 +4686,13 @@ type Space struct { // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "AdminInstalled") to + // ForceSendFields is a list of field names (e.g. "AccessSettings") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "AdminInstalled") to include in + // NullFields is a list of field names (e.g. "AccessSettings") to include in // API requests with the JSON null value. By default, fields with empty values // are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. @@ -6400,11 +6444,11 @@ func (r *SpacesService) Patch(name string, space *Space) *SpacesPatchCall { // users to change their history setting // (https://support.google.com/a/answer/7664184). Warning: mutually exclusive // with all other field paths.) `space_history_state` is not supported with -// admin access. - Developer Preview: `access_settings.audience` (Supports -// changing the access setting -// (https://support.google.com/chat/answer/11971020) of a space. If no audience -// is specified in the access setting, the space's access setting is updated to -// restricted. Warning: mutually exclusive with all other field paths.) +// admin access. - `access_settings.audience` (Supports changing the access +// setting (https://support.google.com/chat/answer/11971020) of who can +// discover the space, join the space, and preview the messages in space. If no +// audience is specified in the access setting, the space's access setting is +// updated to private. Warning: mutually exclusive with all other field paths.) // `access_settings.audience` is not supported with admin access. - Developer // Preview: Supports changing the permission settings // (https://support.google.com/chat/answer/13340792) of a space, supported @@ -6521,8 +6565,17 @@ type SpacesSetupCall struct { // People API, or the `id` for the user in the Directory API. For example, if // the People API Person profile ID for `user@example.com` is `123456789`, you // can add the user to the space by setting the `membership.member.name` to -// `users/user@example.com` or `users/123456789`. For a named space or group -// chat, if the caller blocks, or is blocked by some members, or doesn't have +// `users/user@example.com` or `users/123456789`. To specify the Google groups +// to add, add memberships with the appropriate `membership.group_member.name`. +// To add or invite a Google group, use `groups/{group}`, where `{group}` is +// the `id` for the group from the Cloud Identity Groups API. For example, you +// can use Cloud Identity Groups lookup API +// (https://cloud.google.com/identity/docs/reference/rest/v1/groups/lookup) to +// retrieve the ID `123456789` for group email `group@example.com`, then you +// can add the group to the space by setting the `membership.group_member.name` +// to `groups/123456789`. Group email is not supported, and Google groups can +// only be added as members in named spaces. For a named space or group chat, +// if the caller blocks, or is blocked by some members, or doesn't have // permission to add some members, then those members aren't added to the // created space. To create a direct message (DM) between the calling user and // another human user, specify exactly one membership to represent the human @@ -6644,15 +6697,23 @@ type SpacesMembersCreateCall struct { // specified space. Requires user authentication // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). // To specify the member to add, set the `membership.member.name` for the human -// or app member. - To add the calling app to a space or a direct message -// between two human users, use `users/app`. Unable to add other apps to the -// space. - To add a human user, use `users/{user}`, where `{user}` can be the -// email address for the user. For users in the same Workspace organization -// `{user}` can also be the `id` for the person from the People API, or the -// `id` for the user in the Directory API. For example, if the People API -// Person profile ID for `user@example.com` is `123456789`, you can add the -// user to the space by setting the `membership.member.name` to -// `users/user@example.com` or `users/123456789`. +// or app member, or set the `membership.group_member.name` for the group +// member. - To add the calling app to a space or a direct message between two +// human users, use `users/app`. Unable to add other apps to the space. - To +// add a human user, use `users/{user}`, where `{user}` can be the email +// address for the user. For users in the same Workspace organization `{user}` +// can also be the `id` for the person from the People API, or the `id` for the +// user in the Directory API. For example, if the People API Person profile ID +// for `user@example.com` is `123456789`, you can add the user to the space by +// setting the `membership.member.name` to `users/user@example.com` or +// `users/123456789`. - To add or invite a Google group in a named space, use +// `groups/{group}`, where `{group}` is the `id` for the group from the Cloud +// Identity Groups API. For example, you can use Cloud Identity Groups lookup +// API (https://cloud.google.com/identity/docs/reference/rest/v1/groups/lookup) +// to retrieve the ID `123456789` for group email `group@example.com`, then you +// can add or invite the group to a named space by setting the +// `membership.group_member.name` to `groups/123456789`. Group email is not +// supported, and Google groups can only be added as members in named spaces. // // - parent: The resource name of the space for which to create the membership. // Format: spaces/{space}. diff --git a/container/v1beta1/container-api.json b/container/v1beta1/container-api.json index ac471b27d5a..f53a9899472 100644 --- a/container/v1beta1/container-api.json +++ b/container/v1beta1/container-api.json @@ -2565,7 +2565,7 @@ } } }, - "revision": "20240608", + "revision": "20240618", "rootUrl": "https://container.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -2623,14 +2623,14 @@ "properties": { "maxPodsPerNode": { "$ref": "MaxPodsConstraint", - "description": "The maximum number of pods per node which use this pod network" + "description": "The maximum number of pods per node which use this pod network." }, "secondaryPodRange": { - "description": "The name of the secondary range on the subnet which provides IP address for this pod range", + "description": "The name of the secondary range on the subnet which provides IP address for this pod range.", "type": "string" }, "subnetwork": { - "description": "Name of the subnetwork where the additional pod network belongs", + "description": "Name of the subnetwork where the additional pod network belongs.", "type": "string" } }, diff --git a/container/v1beta1/container-gen.go b/container/v1beta1/container-gen.go index 40f83a7990d..f3195ace7b7 100644 --- a/container/v1beta1/container-gen.go +++ b/container/v1beta1/container-gen.go @@ -364,12 +364,12 @@ func (s *AdditionalNodeNetworkConfig) MarshalJSON() ([]byte, error) { // for additional pod networks within the NodeNetworkConfig message type AdditionalPodNetworkConfig struct { // MaxPodsPerNode: The maximum number of pods per node which use this pod - // network + // network. MaxPodsPerNode *MaxPodsConstraint `json:"maxPodsPerNode,omitempty"` // SecondaryPodRange: The name of the secondary range on the subnet which - // provides IP address for this pod range + // provides IP address for this pod range. SecondaryPodRange string `json:"secondaryPodRange,omitempty"` - // Subnetwork: Name of the subnetwork where the additional pod network belongs + // Subnetwork: Name of the subnetwork where the additional pod network belongs. Subnetwork string `json:"subnetwork,omitempty"` // ForceSendFields is a list of field names (e.g. "MaxPodsPerNode") to // unconditionally include in API requests. By default, fields with empty or diff --git a/file/v1/file-api.json b/file/v1/file-api.json index fc1fef208b1..e6e834b277e 100644 --- a/file/v1/file-api.json +++ b/file/v1/file-api.json @@ -902,7 +902,7 @@ } } }, - "revision": "20240608", + "revision": "20240619", "rootUrl": "https://file.googleapis.com/", "schemas": { "Backup": { @@ -1118,6 +1118,15 @@ }, "type": "array" }, + "performanceConfig": { + "$ref": "PerformanceConfig", + "description": "Optional. Used to configure performance." + }, + "performanceLimits": { + "$ref": "PerformanceLimits", + "description": "Output only. Used for getting performance limits.", + "readOnly": true + }, "sourceBackup": { "description": "The resource name of the backup, in the format `projects/{project_number}/locations/{location_id}/backups/{backup_id}`, that this file share has been restored from.", "type": "string" @@ -1125,6 +1134,18 @@ }, "type": "object" }, + "FixedIOPS": { + "description": "Fixed IOPS parameters.", + "id": "FixedIOPS", + "properties": { + "maxReadIops": { + "description": "Required. Maximum raw read IOPS.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudSaasacceleratorManagementProvidersV1Instance": { "description": "Instance represents the interface for SLM services to actuate the state of control plane resources. Example Instance in JSON, where consumer-project-number=123456, producer-project-id=cloud-sql: ```json Instance: { \"name\": \"projects/123456/locations/us-east1/instances/prod-instance\", \"create_time\": { \"seconds\": 1526406431, }, \"labels\": { \"env\": \"prod\", \"foo\": \"bar\" }, \"state\": READY, \"software_versions\": { \"software_update\": \"cloud-sql-09-28-2018\", }, \"maintenance_policy_names\": { \"UpdatePolicy\": \"projects/123456/locations/us-east1/maintenancePolicies/prod-update-policy\", } \"tenant_project_id\": \"cloud-sql-test-tenant\", \"producer_metadata\": { \"cloud-sql-tier\": \"basic\", \"cloud-sql-instance-size\": \"1G\", }, \"provisioned_resources\": [ { \"resource-type\": \"compute-instance\", \"resource-url\": \"https://www.googleapis.com/compute/v1/projects/cloud-sql/zones/us-east1-b/instances/vm-1\", } ], \"maintenance_schedules\": { \"csa_rollout\": { \"start_time\": { \"seconds\": 1526406431, }, \"end_time\": { \"seconds\": 1535406431, }, }, \"ncsa_rollout\": { \"start_time\": { \"seconds\": 1526406431, }, \"end_time\": { \"seconds\": 1535406431, }, } }, \"consumer_defined_name\": \"my-sql-instance1\", } ``` LINT.IfChange", "id": "GoogleCloudSaasacceleratorManagementProvidersV1Instance", @@ -1400,6 +1421,18 @@ }, "type": "object" }, + "IOPSPerGB": { + "description": "IOPS per capacity parameters.", + "id": "IOPSPerGB", + "properties": { + "maxReadIopsPerGb": { + "description": "Required. Maximum read IOPS per GB.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, "Instance": { "description": "A Filestore instance.", "id": "Instance", @@ -1938,6 +1971,56 @@ }, "type": "object" }, + "PerformanceConfig": { + "description": "Performance configuration. Used for setting the performance configuration. Defaults to `iops_by_capacity` if unset in instance creation.", + "id": "PerformanceConfig", + "properties": { + "fixedIops": { + "$ref": "FixedIOPS", + "description": "Choose a fixed provisioned IOPS value for the instance, which will remain constant regardless of instance capacity. Value must be a multiple of 1000. If the chosen value is outside the supported range for the instance's capacity during instance creation, instance creation will fail with an `InvalidArgument` error. Similarly, if an instance capacity update would result in a value outside the supported range, the update will fail with an `InvalidArgument` error." + }, + "iopsByCapacity": { + "description": "Automatically provision maximum available IOPS based on the capacity of the instance. Larger instances will be granted more IOPS. If instance capacity is increased or decreased, IOPS will be automatically adjusted upwards or downwards accordingly. The maximum available IOPS for a given capacity is defined in Filestore documentation.", + "type": "boolean" + }, + "iopsPerGb": { + "$ref": "IOPSPerGB", + "description": "Provision IOPS dynamically based on the capacity of the instance. Provisioned read IOPS will be calculated by by multiplying the capacity of the instance in GiB by the `iops_per_gb` value, and rounding to the nearest 1000. For example, for a 1 TiB instance with an `iops_per_gb` value of 15, the provisioned read IOPS would be `1024 * 15 = 15,360`, rounded to `15,000`. If the calculated value is outside the supported range for the instance's capacity during instance creation, instance creation will fail with an `InvalidArgument` error. Similarly, if an instance capacity update would result in a value outside the supported range, the update will fail with an `InvalidArgument` error." + } + }, + "type": "object" + }, + "PerformanceLimits": { + "description": "The enforced performance limits, calculated from the instance's performance configuration.", + "id": "PerformanceLimits", + "properties": { + "maxReadIops": { + "description": "Output only. The max read IOPS.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "maxReadThroughput": { + "description": "Output only. The max read throughput.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "maxWriteIops": { + "description": "Output only. The max write IOPS.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "maxWriteThroughput": { + "description": "Output only. The max write throughput.", + "format": "int64", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "PromoteReplicaRequest": { "description": "PromoteReplicaRequest promotes a Filestore standby instance (replica).", "id": "PromoteReplicaRequest", diff --git a/file/v1/file-gen.go b/file/v1/file-gen.go index 23839bf6ac7..1348d415daf 100644 --- a/file/v1/file-gen.go +++ b/file/v1/file-gen.go @@ -443,6 +443,10 @@ type FileShareConfig struct { // NfsExportOptions: Nfs Export Options. There is a limit of 10 export options // per file share. NfsExportOptions []*NfsExportOptions `json:"nfsExportOptions,omitempty"` + // PerformanceConfig: Optional. Used to configure performance. + PerformanceConfig *PerformanceConfig `json:"performanceConfig,omitempty"` + // PerformanceLimits: Output only. Used for getting performance limits. + PerformanceLimits *PerformanceLimits `json:"performanceLimits,omitempty"` // SourceBackup: The resource name of the backup, in the format // `projects/{project_number}/locations/{location_id}/backups/{backup_id}`, // that this file share has been restored from. @@ -465,6 +469,28 @@ func (s *FileShareConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +// FixedIOPS: Fixed IOPS parameters. +type FixedIOPS struct { + // MaxReadIops: Required. Maximum raw read IOPS. + MaxReadIops int64 `json:"maxReadIops,omitempty,string"` + // ForceSendFields is a list of field names (e.g. "MaxReadIops") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "MaxReadIops") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *FixedIOPS) MarshalJSON() ([]byte, error) { + type NoMethod FixedIOPS + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudSaasacceleratorManagementProvidersV1Instance: Instance represents // the interface for SLM services to actuate the state of control plane // resources. Example Instance in JSON, where consumer-project-number=123456, @@ -843,6 +869,28 @@ func (s *GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata) MarshalJSON return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +// IOPSPerGB: IOPS per capacity parameters. +type IOPSPerGB struct { + // MaxReadIopsPerGb: Required. Maximum read IOPS per GB. + MaxReadIopsPerGb int64 `json:"maxReadIopsPerGb,omitempty,string"` + // ForceSendFields is a list of field names (e.g. "MaxReadIopsPerGb") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "MaxReadIopsPerGb") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *IOPSPerGB) MarshalJSON() ([]byte, error) { + type NoMethod IOPSPerGB + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // Instance: A Filestore instance. type Instance struct { // CreateTime: Output only. The time when the instance was created. @@ -1414,6 +1462,82 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +// PerformanceConfig: Performance configuration. Used for setting the +// performance configuration. Defaults to `iops_by_capacity` if unset in +// instance creation. +type PerformanceConfig struct { + // FixedIops: Choose a fixed provisioned IOPS value for the instance, which + // will remain constant regardless of instance capacity. Value must be a + // multiple of 1000. If the chosen value is outside the supported range for the + // instance's capacity during instance creation, instance creation will fail + // with an `InvalidArgument` error. Similarly, if an instance capacity update + // would result in a value outside the supported range, the update will fail + // with an `InvalidArgument` error. + FixedIops *FixedIOPS `json:"fixedIops,omitempty"` + // IopsByCapacity: Automatically provision maximum available IOPS based on the + // capacity of the instance. Larger instances will be granted more IOPS. If + // instance capacity is increased or decreased, IOPS will be automatically + // adjusted upwards or downwards accordingly. The maximum available IOPS for a + // given capacity is defined in Filestore documentation. + IopsByCapacity bool `json:"iopsByCapacity,omitempty"` + // IopsPerGb: Provision IOPS dynamically based on the capacity of the instance. + // Provisioned read IOPS will be calculated by by multiplying the capacity of + // the instance in GiB by the `iops_per_gb` value, and rounding to the nearest + // 1000. For example, for a 1 TiB instance with an `iops_per_gb` value of 15, + // the provisioned read IOPS would be `1024 * 15 = 15,360`, rounded to + // `15,000`. If the calculated value is outside the supported range for the + // instance's capacity during instance creation, instance creation will fail + // with an `InvalidArgument` error. Similarly, if an instance capacity update + // would result in a value outside the supported range, the update will fail + // with an `InvalidArgument` error. + IopsPerGb *IOPSPerGB `json:"iopsPerGb,omitempty"` + // ForceSendFields is a list of field names (e.g. "FixedIops") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "FixedIops") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *PerformanceConfig) MarshalJSON() ([]byte, error) { + type NoMethod PerformanceConfig + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + +// PerformanceLimits: The enforced performance limits, calculated from the +// instance's performance configuration. +type PerformanceLimits struct { + // MaxReadIops: Output only. The max read IOPS. + MaxReadIops int64 `json:"maxReadIops,omitempty,string"` + // MaxReadThroughput: Output only. The max read throughput. + MaxReadThroughput int64 `json:"maxReadThroughput,omitempty,string"` + // MaxWriteIops: Output only. The max write IOPS. + MaxWriteIops int64 `json:"maxWriteIops,omitempty,string"` + // MaxWriteThroughput: Output only. The max write throughput. + MaxWriteThroughput int64 `json:"maxWriteThroughput,omitempty,string"` + // ForceSendFields is a list of field names (e.g. "MaxReadIops") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "MaxReadIops") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *PerformanceLimits) MarshalJSON() ([]byte, error) { + type NoMethod PerformanceLimits + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // PromoteReplicaRequest: PromoteReplicaRequest promotes a Filestore standby // instance (replica). type PromoteReplicaRequest struct { diff --git a/file/v1beta1/file-api.json b/file/v1beta1/file-api.json index 572c163770d..6c63bca5f37 100644 --- a/file/v1beta1/file-api.json +++ b/file/v1beta1/file-api.json @@ -1069,7 +1069,7 @@ } } }, - "revision": "20240608", + "revision": "20240619", "rootUrl": "https://file.googleapis.com/", "schemas": { "Backup": { @@ -1296,6 +1296,15 @@ }, "type": "array" }, + "performanceConfig": { + "$ref": "PerformanceConfig", + "description": "Optional. Used to configure performance." + }, + "performanceLimits": { + "$ref": "PerformanceLimits", + "description": "Output only. Used for getting performance limits.", + "readOnly": true + }, "sourceBackup": { "description": "The resource name of the backup, in the format `projects/{project_id}/locations/{location_id}/backups/{backup_id}`, that this file share has been restored from.", "type": "string" @@ -1303,6 +1312,18 @@ }, "type": "object" }, + "FixedIOPS": { + "description": "Fixed IOPS parameters.", + "id": "FixedIOPS", + "properties": { + "maxReadIops": { + "description": "Required. Maximum raw read IOPS.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudSaasacceleratorManagementProvidersV1Instance": { "description": "Instance represents the interface for SLM services to actuate the state of control plane resources. Example Instance in JSON, where consumer-project-number=123456, producer-project-id=cloud-sql: ```json Instance: { \"name\": \"projects/123456/locations/us-east1/instances/prod-instance\", \"create_time\": { \"seconds\": 1526406431, }, \"labels\": { \"env\": \"prod\", \"foo\": \"bar\" }, \"state\": READY, \"software_versions\": { \"software_update\": \"cloud-sql-09-28-2018\", }, \"maintenance_policy_names\": { \"UpdatePolicy\": \"projects/123456/locations/us-east1/maintenancePolicies/prod-update-policy\", } \"tenant_project_id\": \"cloud-sql-test-tenant\", \"producer_metadata\": { \"cloud-sql-tier\": \"basic\", \"cloud-sql-instance-size\": \"1G\", }, \"provisioned_resources\": [ { \"resource-type\": \"compute-instance\", \"resource-url\": \"https://www.googleapis.com/compute/v1/projects/cloud-sql/zones/us-east1-b/instances/vm-1\", } ], \"maintenance_schedules\": { \"csa_rollout\": { \"start_time\": { \"seconds\": 1526406431, }, \"end_time\": { \"seconds\": 1535406431, }, }, \"ncsa_rollout\": { \"start_time\": { \"seconds\": 1526406431, }, \"end_time\": { \"seconds\": 1535406431, }, } }, \"consumer_defined_name\": \"my-sql-instance1\", } ``` LINT.IfChange", "id": "GoogleCloudSaasacceleratorManagementProvidersV1Instance", @@ -1578,6 +1599,18 @@ }, "type": "object" }, + "IOPSPerGB": { + "description": "IOPS per capacity parameters.", + "id": "IOPSPerGB", + "properties": { + "maxReadIopsPerGb": { + "description": "Required. Maximum read IOPS per GB.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, "Instance": { "description": "A Filestore instance.", "id": "Instance", @@ -2221,6 +2254,56 @@ }, "type": "object" }, + "PerformanceConfig": { + "description": "Performance configuration. Used for setting the performance configuration. Defaults to `iops_by_capacity` if unset in instance creation.", + "id": "PerformanceConfig", + "properties": { + "fixedIops": { + "$ref": "FixedIOPS", + "description": "Choose a fixed provisioned IOPS value for the instance, which will remain constant regardless of instance capacity. Value must be a multiple of 1000. If the chosen value is outside the supported range for the instance's capacity during instance creation, instance creation will fail with an `InvalidArgument` error. Similarly, if an instance capacity update would result in a value outside the supported range, the update will fail with an `InvalidArgument` error." + }, + "iopsByCapacity": { + "description": "Automatically provision maximum available IOPS based on the capacity of the instance. Larger instances will be granted more IOPS. If instance capacity is increased or decreased, IOPS will be automatically adjusted upwards or downwards accordingly. The maximum available IOPS for a given capacity is defined in Filestore documentation.", + "type": "boolean" + }, + "iopsPerGb": { + "$ref": "IOPSPerGB", + "description": "Provision IOPS dynamically based on the capacity of the instance. Provisioned read IOPS will be calculated by by multiplying the capacity of the instance in GiB by the `iops_per_gb` value, and rounding to the nearest 1000. For example, for a 1 TiB instance with an `iops_per_gb` value of 15, the provisioned read IOPS would be `1024 * 15 = 15,360`, rounded to `15,000`. If the calculated value is outside the supported range for the instance's capacity during instance creation, instance creation will fail with an `InvalidArgument` error. Similarly, if an instance capacity update would result in a value outside the supported range, the update will fail with an `InvalidArgument` error." + } + }, + "type": "object" + }, + "PerformanceLimits": { + "description": "The enforced performance limits, calculated from the instance's performance configuration.", + "id": "PerformanceLimits", + "properties": { + "maxReadIops": { + "description": "Output only. The max read IOPS.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "maxReadThroughput": { + "description": "Output only. The max read throughput.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "maxWriteIops": { + "description": "Output only. The max write IOPS.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "maxWriteThroughput": { + "description": "Output only. The max write throughput.", + "format": "int64", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "PromoteReplicaRequest": { "description": "PromoteReplicaRequest promotes a Filestore standby instance (replica).", "id": "PromoteReplicaRequest", diff --git a/file/v1beta1/file-gen.go b/file/v1beta1/file-gen.go index 9f1b30fb8b5..f3572a334f0 100644 --- a/file/v1beta1/file-gen.go +++ b/file/v1beta1/file-gen.go @@ -478,6 +478,10 @@ type FileShareConfig struct { // NfsExportOptions: Nfs Export Options. There is a limit of 10 export options // per file share. NfsExportOptions []*NfsExportOptions `json:"nfsExportOptions,omitempty"` + // PerformanceConfig: Optional. Used to configure performance. + PerformanceConfig *PerformanceConfig `json:"performanceConfig,omitempty"` + // PerformanceLimits: Output only. Used for getting performance limits. + PerformanceLimits *PerformanceLimits `json:"performanceLimits,omitempty"` // SourceBackup: The resource name of the backup, in the format // `projects/{project_id}/locations/{location_id}/backups/{backup_id}`, that // this file share has been restored from. @@ -500,6 +504,28 @@ func (s *FileShareConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +// FixedIOPS: Fixed IOPS parameters. +type FixedIOPS struct { + // MaxReadIops: Required. Maximum raw read IOPS. + MaxReadIops int64 `json:"maxReadIops,omitempty,string"` + // ForceSendFields is a list of field names (e.g. "MaxReadIops") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "MaxReadIops") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *FixedIOPS) MarshalJSON() ([]byte, error) { + type NoMethod FixedIOPS + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudSaasacceleratorManagementProvidersV1Instance: Instance represents // the interface for SLM services to actuate the state of control plane // resources. Example Instance in JSON, where consumer-project-number=123456, @@ -878,6 +904,28 @@ func (s *GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata) MarshalJSON return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +// IOPSPerGB: IOPS per capacity parameters. +type IOPSPerGB struct { + // MaxReadIopsPerGb: Required. Maximum read IOPS per GB. + MaxReadIopsPerGb int64 `json:"maxReadIopsPerGb,omitempty,string"` + // ForceSendFields is a list of field names (e.g. "MaxReadIopsPerGb") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "MaxReadIopsPerGb") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *IOPSPerGB) MarshalJSON() ([]byte, error) { + type NoMethod IOPSPerGB + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // Instance: A Filestore instance. type Instance struct { // CapacityGb: The storage capacity of the instance in gigabytes (GB = 1024^3 @@ -1548,6 +1596,82 @@ func (s *OperationMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +// PerformanceConfig: Performance configuration. Used for setting the +// performance configuration. Defaults to `iops_by_capacity` if unset in +// instance creation. +type PerformanceConfig struct { + // FixedIops: Choose a fixed provisioned IOPS value for the instance, which + // will remain constant regardless of instance capacity. Value must be a + // multiple of 1000. If the chosen value is outside the supported range for the + // instance's capacity during instance creation, instance creation will fail + // with an `InvalidArgument` error. Similarly, if an instance capacity update + // would result in a value outside the supported range, the update will fail + // with an `InvalidArgument` error. + FixedIops *FixedIOPS `json:"fixedIops,omitempty"` + // IopsByCapacity: Automatically provision maximum available IOPS based on the + // capacity of the instance. Larger instances will be granted more IOPS. If + // instance capacity is increased or decreased, IOPS will be automatically + // adjusted upwards or downwards accordingly. The maximum available IOPS for a + // given capacity is defined in Filestore documentation. + IopsByCapacity bool `json:"iopsByCapacity,omitempty"` + // IopsPerGb: Provision IOPS dynamically based on the capacity of the instance. + // Provisioned read IOPS will be calculated by by multiplying the capacity of + // the instance in GiB by the `iops_per_gb` value, and rounding to the nearest + // 1000. For example, for a 1 TiB instance with an `iops_per_gb` value of 15, + // the provisioned read IOPS would be `1024 * 15 = 15,360`, rounded to + // `15,000`. If the calculated value is outside the supported range for the + // instance's capacity during instance creation, instance creation will fail + // with an `InvalidArgument` error. Similarly, if an instance capacity update + // would result in a value outside the supported range, the update will fail + // with an `InvalidArgument` error. + IopsPerGb *IOPSPerGB `json:"iopsPerGb,omitempty"` + // ForceSendFields is a list of field names (e.g. "FixedIops") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "FixedIops") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *PerformanceConfig) MarshalJSON() ([]byte, error) { + type NoMethod PerformanceConfig + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + +// PerformanceLimits: The enforced performance limits, calculated from the +// instance's performance configuration. +type PerformanceLimits struct { + // MaxReadIops: Output only. The max read IOPS. + MaxReadIops int64 `json:"maxReadIops,omitempty,string"` + // MaxReadThroughput: Output only. The max read throughput. + MaxReadThroughput int64 `json:"maxReadThroughput,omitempty,string"` + // MaxWriteIops: Output only. The max write IOPS. + MaxWriteIops int64 `json:"maxWriteIops,omitempty,string"` + // MaxWriteThroughput: Output only. The max write throughput. + MaxWriteThroughput int64 `json:"maxWriteThroughput,omitempty,string"` + // ForceSendFields is a list of field names (e.g. "MaxReadIops") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "MaxReadIops") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *PerformanceLimits) MarshalJSON() ([]byte, error) { + type NoMethod PerformanceLimits + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // PromoteReplicaRequest: PromoteReplicaRequest promotes a Filestore standby // instance (replica). type PromoteReplicaRequest struct { diff --git a/healthcare/v1/healthcare-api.json b/healthcare/v1/healthcare-api.json index b5a840dd6cd..b61f965be53 100644 --- a/healthcare/v1/healthcare-api.json +++ b/healthcare/v1/healthcare-api.json @@ -4380,7 +4380,7 @@ ], "parameters": { "name": { - "description": "Output only. Resource name of the Message, of the form `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/hl7V2Stores/{hl7_v2_store_id}/messages/{message_id}`. Assigned by the server.", + "description": "Output only. Resource name of the Message, of the form `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/hl7V2Stores/{hl7_v2_store_id}/messages/{message_id}`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/hl7V2Stores/[^/]+/messages/[^/]+$", "required": true, @@ -4554,7 +4554,7 @@ } } }, - "revision": "20240605", + "revision": "20240619", "rootUrl": "https://healthcare.googleapis.com/", "schemas": { "ActivateConsentRequest": { @@ -6747,7 +6747,7 @@ "type": "string" }, "name": { - "description": "Output only. Resource name of the Message, of the form `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/hl7V2Stores/{hl7_v2_store_id}/messages/{message_id}`. Assigned by the server.", + "description": "Output only. Resource name of the Message, of the form `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/hl7V2Stores/{hl7_v2_store_id}/messages/{message_id}`.", "readOnly": true, "type": "string" }, diff --git a/healthcare/v1/healthcare-gen.go b/healthcare/v1/healthcare-gen.go index 9ea7f2ff1f1..281902f44ff 100644 --- a/healthcare/v1/healthcare-gen.go +++ b/healthcare/v1/healthcare-gen.go @@ -4008,7 +4008,7 @@ type Message struct { MessageType string `json:"messageType,omitempty"` // Name: Output only. Resource name of the Message, of the form // `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/hl7V2Sto - // res/{hl7_v2_store_id}/messages/{message_id}`. Assigned by the server. + // res/{hl7_v2_store_id}/messages/{message_id}`. Name string `json:"name,omitempty"` // ParsedData: Output only. The parsed version of the raw message data. ParsedData *ParsedData `json:"parsedData,omitempty"` @@ -20132,7 +20132,7 @@ type ProjectsLocationsDatasetsHl7V2StoresMessagesPatchCall struct { // // - name: Output only. Resource name of the Message, of the form // `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/hl7V2S -// tores/{hl7_v2_store_id}/messages/{message_id}`. Assigned by the server. +// tores/{hl7_v2_store_id}/messages/{message_id}`. func (r *ProjectsLocationsDatasetsHl7V2StoresMessagesService) Patch(name string, message *Message) *ProjectsLocationsDatasetsHl7V2StoresMessagesPatchCall { c := &ProjectsLocationsDatasetsHl7V2StoresMessagesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name diff --git a/healthcare/v1beta1/healthcare-api.json b/healthcare/v1beta1/healthcare-api.json index 3d372508452..a292484c3ce 100644 --- a/healthcare/v1beta1/healthcare-api.json +++ b/healthcare/v1beta1/healthcare-api.json @@ -2869,7 +2869,7 @@ ], "parameters": { "resource": { - "description": "Required. The path of the resource for which the storage info is requested (for exaxmple for a DICOM Instance: `projects/{projectID}/locations/{locationID}/datasets/{datasetID}/dicomStores/{dicomStoreId}/dicomWeb/studies/{study_uid}/series/{series_uid}/instances/{instance_uid}`)", + "description": "Required. The path of the instance to return storage info for, in the form: `projects/{projectID}/locations/{locationID}/datasets/{datasetID}/dicomStores/{dicomStoreID}/dicomWeb/studies/{studyUID}/series/{seriesUID}/instances/{instanceUID}`", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/dicomStores/[^/]+/dicomWeb/studies/[^/]+/series/[^/]+/instances/[^/]+$", "required": true, @@ -5672,7 +5672,7 @@ } } }, - "revision": "20240605", + "revision": "20240619", "rootUrl": "https://healthcare.googleapis.com/", "schemas": { "AccessDeterminationLogConfig": { @@ -9930,7 +9930,7 @@ "description": "Info about the data stored in blob storage for the resource." }, "referencedResource": { - "description": "The resource whose storage info is returned. For example, to specify the resource path of a DICOM Instance: `projects/{projectID}/locations/{locationID}/datasets/{datasetID}/dicomStores/{dicom_store_id}/dicomWeb/studi/{study_uid}/series/{series_uid}/instances/{instance_uid}`", + "description": "The resource whose storage info is returned. For example: `projects/{projectID}/locations/{locationID}/datasets/{datasetID}/dicomStores/{dicomStoreID}/dicomWeb/studies/{studyUID}/series/{seriesUID}/instances/{instanceUID}`", "type": "string" }, "structuredStorageInfo": { diff --git a/healthcare/v1beta1/healthcare-gen.go b/healthcare/v1beta1/healthcare-gen.go index 22d3af3dd23..e94e658e9e1 100644 --- a/healthcare/v1beta1/healthcare-gen.go +++ b/healthcare/v1beta1/healthcare-gen.go @@ -7107,10 +7107,10 @@ type StorageInfo struct { // resource. BlobStorageInfo *BlobStorageInfo `json:"blobStorageInfo,omitempty"` // ReferencedResource: The resource whose storage info is returned. For - // example, to specify the resource path of a DICOM Instance: + // example: // `projects/{projectID}/locations/{locationID}/datasets/{datasetID}/dicomStores - // /{dicom_store_id}/dicomWeb/studi/{study_uid}/series/{series_uid}/instances/{i - // nstance_uid}` + // /{dicomStoreID}/dicomWeb/studies/{studyUID}/series/{seriesUID}/instances/{ins + // tanceUID}` ReferencedResource string `json:"referencedResource,omitempty"` // StructuredStorageInfo: Info about the data stored in structured storage for // the resource. @@ -17638,11 +17638,11 @@ type ProjectsLocationsDatasetsDicomStoresDicomWebStudiesSeriesInstancesGetStorag // GetStorageInfo: GetStorageInfo returns the storage info of the specified // resource. // -// - resource: The path of the resource for which the storage info is requested -// (for exaxmple for a DICOM Instance: +// - resource: The path of the instance to return storage info for, in the +// form: // `projects/{projectID}/locations/{locationID}/datasets/{datasetID}/dicomStor -// es/{dicomStoreId}/dicomWeb/studies/{study_uid}/series/{series_uid}/instance -// s/{instance_uid}`). +// es/{dicomStoreID}/dicomWeb/studies/{studyUID}/series/{seriesUID}/instances/ +// {instanceUID}`. func (r *ProjectsLocationsDatasetsDicomStoresDicomWebStudiesSeriesInstancesService) GetStorageInfo(resource string) *ProjectsLocationsDatasetsDicomStoresDicomWebStudiesSeriesInstancesGetStorageInfoCall { c := &ProjectsLocationsDatasetsDicomStoresDicomWebStudiesSeriesInstancesGetStorageInfoCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.resource = resource diff --git a/logging/v2/logging-api.json b/logging/v2/logging-api.json index 4ef28e6247f..dd84b619a1d 100644 --- a/logging/v2/logging-api.json +++ b/logging/v2/logging-api.json @@ -1226,6 +1226,11 @@ "parent" ], "parameters": { + "filter": { + "description": "Optional. Specifies the type (\"Logging\" or \"OpsAnalytics\") of the recent queries to list. The only valid value for this field is one of the two allowable type function calls, which are the following: type(\"Logging\") type(\"OpsAnalytics\")", + "location": "query", + "type": "string" + }, "pageSize": { "description": "Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.", "format": "int32", @@ -1320,6 +1325,34 @@ "https://www.googleapis.com/auth/logging.admin" ] }, + "get": { + "description": "Returns all data associated with the requested query.", + "flatPath": "v2/billingAccounts/{billingAccountsId}/locations/{locationsId}/savedQueries/{savedQueriesId}", + "httpMethod": "GET", + "id": "logging.billingAccounts.locations.savedQueries.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource name of the saved query. \"projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" \"organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" \"billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" \"folders/[FOLDER_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" For example: \"projects/my-project/locations/global/savedQueries/my-saved-query\" ", + "location": "path", + "pattern": "^billingAccounts/[^/]+/locations/[^/]+/savedQueries/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+name}", + "response": { + "$ref": "SavedQuery" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only", + "https://www.googleapis.com/auth/logging.admin", + "https://www.googleapis.com/auth/logging.read" + ] + }, "list": { "description": "Lists the SavedQueries that were created by the user making the request.", "flatPath": "v2/billingAccounts/{billingAccountsId}/locations/{locationsId}/savedQueries", @@ -1358,6 +1391,41 @@ "https://www.googleapis.com/auth/logging.admin", "https://www.googleapis.com/auth/logging.read" ] + }, + "patch": { + "description": "Updates an existing SavedQuery.", + "flatPath": "v2/billingAccounts/{billingAccountsId}/locations/{locationsId}/savedQueries/{savedQueriesId}", + "httpMethod": "PATCH", + "id": "logging.billingAccounts.locations.savedQueries.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Output only. Resource name of the saved query.In the format: \"projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" For a list of supported locations, see Supported Regions (https://cloud.google.com/logging/docs/region-support#bucket-regions)After the saved query is created, the location cannot be changed.If the user doesn't provide a QUERY_ID, the system will generate an alphanumeric ID.", + "location": "path", + "pattern": "^billingAccounts/[^/]+/locations/[^/]+/savedQueries/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Required. A non-empty list of fields to change in the existing saved query. Fields are relative to the saved_query and new values for the fields are taken from the corresponding fields in the SavedQuery included in this request. Fields not mentioned in update_mask are not changed and are ignored in the request.To update all mutable fields, specify an update_mask of *.For example, to change the description and query filter text of a saved query, specify an update_mask of \"description, query.filter\".", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v2/{+name}", + "request": { + "$ref": "SavedQuery" + }, + "response": { + "$ref": "SavedQuery" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/logging.admin" + ] } } } @@ -1450,7 +1518,7 @@ ], "parameters": { "customWriterIdentity": { - "description": "Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated.", + "description": "Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated.", "location": "query", "type": "string" }, @@ -1587,7 +1655,7 @@ ], "parameters": { "customWriterIdentity": { - "description": "Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated.", + "description": "Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated.", "location": "query", "type": "string" }, @@ -1632,7 +1700,7 @@ ], "parameters": { "customWriterIdentity": { - "description": "Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated.", + "description": "Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated.", "location": "query", "type": "string" }, @@ -3070,6 +3138,11 @@ "parent" ], "parameters": { + "filter": { + "description": "Optional. Specifies the type (\"Logging\" or \"OpsAnalytics\") of the recent queries to list. The only valid value for this field is one of the two allowable type function calls, which are the following: type(\"Logging\") type(\"OpsAnalytics\")", + "location": "query", + "type": "string" + }, "pageSize": { "description": "Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.", "format": "int32", @@ -3164,6 +3237,34 @@ "https://www.googleapis.com/auth/logging.admin" ] }, + "get": { + "description": "Returns all data associated with the requested query.", + "flatPath": "v2/folders/{foldersId}/locations/{locationsId}/savedQueries/{savedQueriesId}", + "httpMethod": "GET", + "id": "logging.folders.locations.savedQueries.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource name of the saved query. \"projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" \"organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" \"billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" \"folders/[FOLDER_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" For example: \"projects/my-project/locations/global/savedQueries/my-saved-query\" ", + "location": "path", + "pattern": "^folders/[^/]+/locations/[^/]+/savedQueries/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+name}", + "response": { + "$ref": "SavedQuery" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only", + "https://www.googleapis.com/auth/logging.admin", + "https://www.googleapis.com/auth/logging.read" + ] + }, "list": { "description": "Lists the SavedQueries that were created by the user making the request.", "flatPath": "v2/folders/{foldersId}/locations/{locationsId}/savedQueries", @@ -3202,6 +3303,41 @@ "https://www.googleapis.com/auth/logging.admin", "https://www.googleapis.com/auth/logging.read" ] + }, + "patch": { + "description": "Updates an existing SavedQuery.", + "flatPath": "v2/folders/{foldersId}/locations/{locationsId}/savedQueries/{savedQueriesId}", + "httpMethod": "PATCH", + "id": "logging.folders.locations.savedQueries.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Output only. Resource name of the saved query.In the format: \"projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" For a list of supported locations, see Supported Regions (https://cloud.google.com/logging/docs/region-support#bucket-regions)After the saved query is created, the location cannot be changed.If the user doesn't provide a QUERY_ID, the system will generate an alphanumeric ID.", + "location": "path", + "pattern": "^folders/[^/]+/locations/[^/]+/savedQueries/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Required. A non-empty list of fields to change in the existing saved query. Fields are relative to the saved_query and new values for the fields are taken from the corresponding fields in the SavedQuery included in this request. Fields not mentioned in update_mask are not changed and are ignored in the request.To update all mutable fields, specify an update_mask of *.For example, to change the description and query filter text of a saved query, specify an update_mask of \"description, query.filter\".", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v2/{+name}", + "request": { + "$ref": "SavedQuery" + }, + "response": { + "$ref": "SavedQuery" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/logging.admin" + ] } } } @@ -3294,7 +3430,7 @@ ], "parameters": { "customWriterIdentity": { - "description": "Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated.", + "description": "Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated.", "location": "query", "type": "string" }, @@ -3431,7 +3567,7 @@ ], "parameters": { "customWriterIdentity": { - "description": "Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated.", + "description": "Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated.", "location": "query", "type": "string" }, @@ -3476,7 +3612,7 @@ ], "parameters": { "customWriterIdentity": { - "description": "Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated.", + "description": "Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated.", "location": "query", "type": "string" }, @@ -5649,6 +5785,11 @@ "parent" ], "parameters": { + "filter": { + "description": "Optional. Specifies the type (\"Logging\" or \"OpsAnalytics\") of the recent queries to list. The only valid value for this field is one of the two allowable type function calls, which are the following: type(\"Logging\") type(\"OpsAnalytics\")", + "location": "query", + "type": "string" + }, "pageSize": { "description": "Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.", "format": "int32", @@ -5743,6 +5884,34 @@ "https://www.googleapis.com/auth/logging.admin" ] }, + "get": { + "description": "Returns all data associated with the requested query.", + "flatPath": "v2/organizations/{organizationsId}/locations/{locationsId}/savedQueries/{savedQueriesId}", + "httpMethod": "GET", + "id": "logging.organizations.locations.savedQueries.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource name of the saved query. \"projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" \"organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" \"billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" \"folders/[FOLDER_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" For example: \"projects/my-project/locations/global/savedQueries/my-saved-query\" ", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+/savedQueries/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+name}", + "response": { + "$ref": "SavedQuery" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only", + "https://www.googleapis.com/auth/logging.admin", + "https://www.googleapis.com/auth/logging.read" + ] + }, "list": { "description": "Lists the SavedQueries that were created by the user making the request.", "flatPath": "v2/organizations/{organizationsId}/locations/{locationsId}/savedQueries", @@ -5781,6 +5950,41 @@ "https://www.googleapis.com/auth/logging.admin", "https://www.googleapis.com/auth/logging.read" ] + }, + "patch": { + "description": "Updates an existing SavedQuery.", + "flatPath": "v2/organizations/{organizationsId}/locations/{locationsId}/savedQueries/{savedQueriesId}", + "httpMethod": "PATCH", + "id": "logging.organizations.locations.savedQueries.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Output only. Resource name of the saved query.In the format: \"projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" For a list of supported locations, see Supported Regions (https://cloud.google.com/logging/docs/region-support#bucket-regions)After the saved query is created, the location cannot be changed.If the user doesn't provide a QUERY_ID, the system will generate an alphanumeric ID.", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+/savedQueries/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Required. A non-empty list of fields to change in the existing saved query. Fields are relative to the saved_query and new values for the fields are taken from the corresponding fields in the SavedQuery included in this request. Fields not mentioned in update_mask are not changed and are ignored in the request.To update all mutable fields, specify an update_mask of *.For example, to change the description and query filter text of a saved query, specify an update_mask of \"description, query.filter\".", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v2/{+name}", + "request": { + "$ref": "SavedQuery" + }, + "response": { + "$ref": "SavedQuery" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/logging.admin" + ] } } } @@ -5873,7 +6077,7 @@ ], "parameters": { "customWriterIdentity": { - "description": "Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated.", + "description": "Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated.", "location": "query", "type": "string" }, @@ -6010,7 +6214,7 @@ ], "parameters": { "customWriterIdentity": { - "description": "Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated.", + "description": "Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated.", "location": "query", "type": "string" }, @@ -6055,7 +6259,7 @@ ], "parameters": { "customWriterIdentity": { - "description": "Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated.", + "description": "Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated.", "location": "query", "type": "string" }, @@ -7212,6 +7416,11 @@ "parent" ], "parameters": { + "filter": { + "description": "Optional. Specifies the type (\"Logging\" or \"OpsAnalytics\") of the recent queries to list. The only valid value for this field is one of the two allowable type function calls, which are the following: type(\"Logging\") type(\"OpsAnalytics\")", + "location": "query", + "type": "string" + }, "pageSize": { "description": "Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.", "format": "int32", @@ -7306,6 +7515,34 @@ "https://www.googleapis.com/auth/logging.admin" ] }, + "get": { + "description": "Returns all data associated with the requested query.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/savedQueries/{savedQueriesId}", + "httpMethod": "GET", + "id": "logging.projects.locations.savedQueries.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource name of the saved query. \"projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" \"organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" \"billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" \"folders/[FOLDER_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" For example: \"projects/my-project/locations/global/savedQueries/my-saved-query\" ", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/savedQueries/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+name}", + "response": { + "$ref": "SavedQuery" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only", + "https://www.googleapis.com/auth/logging.admin", + "https://www.googleapis.com/auth/logging.read" + ] + }, "list": { "description": "Lists the SavedQueries that were created by the user making the request.", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/savedQueries", @@ -7344,6 +7581,41 @@ "https://www.googleapis.com/auth/logging.admin", "https://www.googleapis.com/auth/logging.read" ] + }, + "patch": { + "description": "Updates an existing SavedQuery.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/savedQueries/{savedQueriesId}", + "httpMethod": "PATCH", + "id": "logging.projects.locations.savedQueries.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Output only. Resource name of the saved query.In the format: \"projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]\" For a list of supported locations, see Supported Regions (https://cloud.google.com/logging/docs/region-support#bucket-regions)After the saved query is created, the location cannot be changed.If the user doesn't provide a QUERY_ID, the system will generate an alphanumeric ID.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/savedQueries/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Required. A non-empty list of fields to change in the existing saved query. Fields are relative to the saved_query and new values for the fields are taken from the corresponding fields in the SavedQuery included in this request. Fields not mentioned in update_mask are not changed and are ignored in the request.To update all mutable fields, specify an update_mask of *.For example, to change the description and query filter text of a saved query, specify an update_mask of \"description, query.filter\".", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v2/{+name}", + "request": { + "$ref": "SavedQuery" + }, + "response": { + "$ref": "SavedQuery" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/logging.admin" + ] } } } @@ -7594,7 +7866,7 @@ ], "parameters": { "customWriterIdentity": { - "description": "Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated.", + "description": "Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated.", "location": "query", "type": "string" }, @@ -7731,7 +8003,7 @@ ], "parameters": { "customWriterIdentity": { - "description": "Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated.", + "description": "Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated.", "location": "query", "type": "string" }, @@ -7776,7 +8048,7 @@ ], "parameters": { "customWriterIdentity": { - "description": "Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated.", + "description": "Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated.", "location": "query", "type": "string" }, @@ -7827,7 +8099,7 @@ ], "parameters": { "customWriterIdentity": { - "description": "Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated.", + "description": "Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated.", "location": "query", "type": "string" }, @@ -7964,7 +8236,7 @@ ], "parameters": { "customWriterIdentity": { - "description": "Optional. A service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified if you are routing logs to a destination outside this sink's project. If not specified, a Logging service account will automatically be generated.", + "description": "Optional. The service account provided by the caller that will be used to write the log entries. The format must be serviceAccount:some@email. This field can only be specified when you are routing logs to a log bucket that is in a different project than the sink. When not specified, a Logging service account will automatically be generated.", "location": "query", "type": "string" }, @@ -8132,7 +8404,7 @@ } } }, - "revision": "20240503", + "revision": "20240620", "rootUrl": "https://logging.googleapis.com/", "schemas": { "AuditConfig": { @@ -8629,12 +8901,12 @@ "type": "boolean" }, "latency": { - "description": "The request processing latency on the server, from the time the request was received until the response was sent.", + "description": "The request processing latency on the server, from the time the request was received until the response was sent. For WebSocket connections, this field refers to the entire time duration of the connection.", "format": "google-duration", "type": "string" }, "protocol": { - "description": "Protocol used for the request. Examples: \"HTTP/1.1\", \"HTTP/2\", \"websocket\"", + "description": "Protocol used for the request. Examples: \"HTTP/1.1\", \"HTTP/2\"", "type": "string" }, "referer": { diff --git a/logging/v2/logging-gen.go b/logging/v2/logging-gen.go index 0acca196a04..15a0d1b011b 100644 --- a/logging/v2/logging-gen.go +++ b/logging/v2/logging-gen.go @@ -1755,10 +1755,10 @@ type HttpRequest struct { // meaningful if cache_hit is True. CacheValidatedWithOriginServer bool `json:"cacheValidatedWithOriginServer,omitempty"` // Latency: The request processing latency on the server, from the time the - // request was received until the response was sent. + // request was received until the response was sent. For WebSocket connections, + // this field refers to the entire time duration of the connection. Latency string `json:"latency,omitempty"` - // Protocol: Protocol used for the request. Examples: "HTTP/1.1", "HTTP/2", - // "websocket" + // Protocol: Protocol used for the request. Examples: "HTTP/1.1", "HTTP/2" Protocol string `json:"protocol,omitempty"` // Referer: The referer URL of the request, as defined in HTTP/1.1 Header Field // Definitions (https://datatracker.ietf.org/doc/html/rfc2616#section-14.36). @@ -8255,6 +8255,15 @@ func (r *BillingAccountsLocationsRecentQueriesService) List(parent string) *Bill return c } +// Filter sets the optional parameter "filter": Specifies the type ("Logging" +// or "OpsAnalytics") of the recent queries to list. The only valid value for +// this field is one of the two allowable type function calls, which are the +// following: type("Logging") type("OpsAnalytics") +func (c *BillingAccountsLocationsRecentQueriesListCall) Filter(filter string) *BillingAccountsLocationsRecentQueriesListCall { + c.urlParams_.Set("filter", filter) + return c +} + // PageSize sets the optional parameter "pageSize": The maximum number of // results to return from this request. Non-positive values are ignored. The // presence of nextPageToken in the response indicates that more results might @@ -8607,6 +8616,121 @@ func (c *BillingAccountsLocationsSavedQueriesDeleteCall) Do(opts ...googleapi.Ca return ret, nil } +type BillingAccountsLocationsSavedQueriesGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Returns all data associated with the requested query. +// +// - name: The resource name of the saved query. +// "projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" +// "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/savedQueries/[QUER +// Y_ID]" +// "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/savedQueries/ +// [QUERY_ID]" +// "folders/[FOLDER_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" For +// example: +// "projects/my-project/locations/global/savedQueries/my-saved-query". +func (r *BillingAccountsLocationsSavedQueriesService) Get(name string) *BillingAccountsLocationsSavedQueriesGetCall { + c := &BillingAccountsLocationsSavedQueriesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *BillingAccountsLocationsSavedQueriesGetCall) Fields(s ...googleapi.Field) *BillingAccountsLocationsSavedQueriesGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *BillingAccountsLocationsSavedQueriesGetCall) IfNoneMatch(entityTag string) *BillingAccountsLocationsSavedQueriesGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *BillingAccountsLocationsSavedQueriesGetCall) Context(ctx context.Context) *BillingAccountsLocationsSavedQueriesGetCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *BillingAccountsLocationsSavedQueriesGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *BillingAccountsLocationsSavedQueriesGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "logging.billingAccounts.locations.savedQueries.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *SavedQuery.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *BillingAccountsLocationsSavedQueriesGetCall) Do(opts ...googleapi.CallOption) (*SavedQuery, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &SavedQuery{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil +} + type BillingAccountsLocationsSavedQueriesListCall struct { s *Service parent string @@ -8763,6 +8887,125 @@ func (c *BillingAccountsLocationsSavedQueriesListCall) Pages(ctx context.Context } } +type BillingAccountsLocationsSavedQueriesPatchCall struct { + s *Service + name string + savedquery *SavedQuery + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates an existing SavedQuery. +// +// - name: Output only. Resource name of the saved query.In the format: +// "projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" +// For a list of supported locations, see Supported Regions +// (https://cloud.google.com/logging/docs/region-support#bucket-regions)After +// the saved query is created, the location cannot be changed.If the user +// doesn't provide a QUERY_ID, the system will generate an alphanumeric ID. +func (r *BillingAccountsLocationsSavedQueriesService) Patch(name string, savedquery *SavedQuery) *BillingAccountsLocationsSavedQueriesPatchCall { + c := &BillingAccountsLocationsSavedQueriesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.savedquery = savedquery + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. A non-empty +// list of fields to change in the existing saved query. Fields are relative to +// the saved_query and new values for the fields are taken from the +// corresponding fields in the SavedQuery included in this request. Fields not +// mentioned in update_mask are not changed and are ignored in the request.To +// update all mutable fields, specify an update_mask of *.For example, to +// change the description and query filter text of a saved query, specify an +// update_mask of "description, query.filter". +func (c *BillingAccountsLocationsSavedQueriesPatchCall) UpdateMask(updateMask string) *BillingAccountsLocationsSavedQueriesPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *BillingAccountsLocationsSavedQueriesPatchCall) Fields(s ...googleapi.Field) *BillingAccountsLocationsSavedQueriesPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *BillingAccountsLocationsSavedQueriesPatchCall) Context(ctx context.Context) *BillingAccountsLocationsSavedQueriesPatchCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *BillingAccountsLocationsSavedQueriesPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *BillingAccountsLocationsSavedQueriesPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.savedquery) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "logging.billingAccounts.locations.savedQueries.patch" call. +// Any non-2xx status code is an error. Response headers are in either +// *SavedQuery.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *BillingAccountsLocationsSavedQueriesPatchCall) Do(opts ...googleapi.CallOption) (*SavedQuery, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &SavedQuery{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil +} + type BillingAccountsLogsDeleteCall struct { s *Service logName string @@ -9061,12 +9304,12 @@ func (r *BillingAccountsSinksService) Create(parent string, logsink *LogSink) *B return c } -// CustomWriterIdentity sets the optional parameter "customWriterIdentity": A +// CustomWriterIdentity sets the optional parameter "customWriterIdentity": The // service account provided by the caller that will be used to write the log // entries. The format must be serviceAccount:some@email. This field can only -// be specified if you are routing logs to a destination outside this sink's -// project. If not specified, a Logging service account will automatically be -// generated. +// be specified when you are routing logs to a log bucket that is in a +// different project than the sink. When not specified, a Logging service +// account will automatically be generated. func (c *BillingAccountsSinksCreateCall) CustomWriterIdentity(customWriterIdentity string) *BillingAccountsSinksCreateCall { c.urlParams_.Set("customWriterIdentity", customWriterIdentity) return c @@ -9575,12 +9818,12 @@ func (r *BillingAccountsSinksService) Patch(sinkNameid string, logsink *LogSink) return c } -// CustomWriterIdentity sets the optional parameter "customWriterIdentity": A +// CustomWriterIdentity sets the optional parameter "customWriterIdentity": The // service account provided by the caller that will be used to write the log // entries. The format must be serviceAccount:some@email. This field can only -// be specified if you are routing logs to a destination outside this sink's -// project. If not specified, a Logging service account will automatically be -// generated. +// be specified when you are routing logs to a log bucket that is in a +// different project than the sink. When not specified, a Logging service +// account will automatically be generated. func (c *BillingAccountsSinksPatchCall) CustomWriterIdentity(customWriterIdentity string) *BillingAccountsSinksPatchCall { c.urlParams_.Set("customWriterIdentity", customWriterIdentity) return c @@ -9726,12 +9969,12 @@ func (r *BillingAccountsSinksService) Update(sinkNameid string, logsink *LogSink return c } -// CustomWriterIdentity sets the optional parameter "customWriterIdentity": A +// CustomWriterIdentity sets the optional parameter "customWriterIdentity": The // service account provided by the caller that will be used to write the log // entries. The format must be serviceAccount:some@email. This field can only -// be specified if you are routing logs to a destination outside this sink's -// project. If not specified, a Logging service account will automatically be -// generated. +// be specified when you are routing logs to a log bucket that is in a +// different project than the sink. When not specified, a Logging service +// account will automatically be generated. func (c *BillingAccountsSinksUpdateCall) CustomWriterIdentity(customWriterIdentity string) *BillingAccountsSinksUpdateCall { c.urlParams_.Set("customWriterIdentity", customWriterIdentity) return c @@ -14952,6 +15195,15 @@ func (r *FoldersLocationsRecentQueriesService) List(parent string) *FoldersLocat return c } +// Filter sets the optional parameter "filter": Specifies the type ("Logging" +// or "OpsAnalytics") of the recent queries to list. The only valid value for +// this field is one of the two allowable type function calls, which are the +// following: type("Logging") type("OpsAnalytics") +func (c *FoldersLocationsRecentQueriesListCall) Filter(filter string) *FoldersLocationsRecentQueriesListCall { + c.urlParams_.Set("filter", filter) + return c +} + // PageSize sets the optional parameter "pageSize": The maximum number of // results to return from this request. Non-positive values are ignored. The // presence of nextPageToken in the response indicates that more results might @@ -15304,55 +15556,36 @@ func (c *FoldersLocationsSavedQueriesDeleteCall) Do(opts ...googleapi.CallOption return ret, nil } -type FoldersLocationsSavedQueriesListCall struct { +type FoldersLocationsSavedQueriesGetCall struct { s *Service - parent string + name string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } -// List: Lists the SavedQueries that were created by the user making the -// request. +// Get: Returns all data associated with the requested query. // -// - parent: The resource to which the listed queries belong. -// "projects/[PROJECT_ID]/locations/[LOCATION_ID]" -// "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]" -// "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]" -// "folders/[FOLDER_ID]/locations/[LOCATION_ID]" For example: -// "projects/my-project/locations/us-central1" Note: The locations portion of -// the resource must be specified. To get a list of all saved queries, a -// wildcard character - can be used for LOCATION_ID, for example: -// "projects/my-project/locations/-". -func (r *FoldersLocationsSavedQueriesService) List(parent string) *FoldersLocationsSavedQueriesListCall { - c := &FoldersLocationsSavedQueriesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - return c -} - -// PageSize sets the optional parameter "pageSize": The maximum number of -// results to return from this request.Non-positive values are ignored. The -// presence of nextPageToken in the response indicates that more results might -// be available. -func (c *FoldersLocationsSavedQueriesListCall) PageSize(pageSize int64) *FoldersLocationsSavedQueriesListCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) - return c -} - -// PageToken sets the optional parameter "pageToken": If present, then retrieve -// the next batch of results from the preceding call to this method. pageToken -// must be the value of nextPageToken from the previous response. The values of -// other method parameters should be identical to those in the previous call. -func (c *FoldersLocationsSavedQueriesListCall) PageToken(pageToken string) *FoldersLocationsSavedQueriesListCall { - c.urlParams_.Set("pageToken", pageToken) +// - name: The resource name of the saved query. +// "projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" +// "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/savedQueries/[QUER +// Y_ID]" +// "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/savedQueries/ +// [QUERY_ID]" +// "folders/[FOLDER_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" For +// example: +// "projects/my-project/locations/global/savedQueries/my-saved-query". +func (r *FoldersLocationsSavedQueriesService) Get(name string) *FoldersLocationsSavedQueriesGetCall { + c := &FoldersLocationsSavedQueriesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name return c } // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *FoldersLocationsSavedQueriesListCall) Fields(s ...googleapi.Field) *FoldersLocationsSavedQueriesListCall { +func (c *FoldersLocationsSavedQueriesGetCall) Fields(s ...googleapi.Field) *FoldersLocationsSavedQueriesGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -15360,27 +15593,161 @@ func (c *FoldersLocationsSavedQueriesListCall) Fields(s ...googleapi.Field) *Fol // IfNoneMatch sets an optional parameter which makes the operation fail if the // object's ETag matches the given value. This is useful for getting updates // only after the object has changed since the last request. -func (c *FoldersLocationsSavedQueriesListCall) IfNoneMatch(entityTag string) *FoldersLocationsSavedQueriesListCall { +func (c *FoldersLocationsSavedQueriesGetCall) IfNoneMatch(entityTag string) *FoldersLocationsSavedQueriesGetCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *FoldersLocationsSavedQueriesListCall) Context(ctx context.Context) *FoldersLocationsSavedQueriesListCall { +func (c *FoldersLocationsSavedQueriesGetCall) Context(ctx context.Context) *FoldersLocationsSavedQueriesGetCall { c.ctx_ = ctx return c } // Header returns a http.Header that can be modified by the caller to add // headers to the request. -func (c *FoldersLocationsSavedQueriesListCall) Header() http.Header { +func (c *FoldersLocationsSavedQueriesGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *FoldersLocationsSavedQueriesListCall) doRequest(alt string) (*http.Response, error) { +func (c *FoldersLocationsSavedQueriesGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "logging.folders.locations.savedQueries.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *SavedQuery.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *FoldersLocationsSavedQueriesGetCall) Do(opts ...googleapi.CallOption) (*SavedQuery, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &SavedQuery{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil +} + +type FoldersLocationsSavedQueriesListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists the SavedQueries that were created by the user making the +// request. +// +// - parent: The resource to which the listed queries belong. +// "projects/[PROJECT_ID]/locations/[LOCATION_ID]" +// "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]" +// "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]" +// "folders/[FOLDER_ID]/locations/[LOCATION_ID]" For example: +// "projects/my-project/locations/us-central1" Note: The locations portion of +// the resource must be specified. To get a list of all saved queries, a +// wildcard character - can be used for LOCATION_ID, for example: +// "projects/my-project/locations/-". +func (r *FoldersLocationsSavedQueriesService) List(parent string) *FoldersLocationsSavedQueriesListCall { + c := &FoldersLocationsSavedQueriesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number of +// results to return from this request.Non-positive values are ignored. The +// presence of nextPageToken in the response indicates that more results might +// be available. +func (c *FoldersLocationsSavedQueriesListCall) PageSize(pageSize int64) *FoldersLocationsSavedQueriesListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": If present, then retrieve +// the next batch of results from the preceding call to this method. pageToken +// must be the value of nextPageToken from the previous response. The values of +// other method parameters should be identical to those in the previous call. +func (c *FoldersLocationsSavedQueriesListCall) PageToken(pageToken string) *FoldersLocationsSavedQueriesListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *FoldersLocationsSavedQueriesListCall) Fields(s ...googleapi.Field) *FoldersLocationsSavedQueriesListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *FoldersLocationsSavedQueriesListCall) IfNoneMatch(entityTag string) *FoldersLocationsSavedQueriesListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *FoldersLocationsSavedQueriesListCall) Context(ctx context.Context) *FoldersLocationsSavedQueriesListCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *FoldersLocationsSavedQueriesListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *FoldersLocationsSavedQueriesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) @@ -15460,6 +15827,125 @@ func (c *FoldersLocationsSavedQueriesListCall) Pages(ctx context.Context, f func } } +type FoldersLocationsSavedQueriesPatchCall struct { + s *Service + name string + savedquery *SavedQuery + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates an existing SavedQuery. +// +// - name: Output only. Resource name of the saved query.In the format: +// "projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" +// For a list of supported locations, see Supported Regions +// (https://cloud.google.com/logging/docs/region-support#bucket-regions)After +// the saved query is created, the location cannot be changed.If the user +// doesn't provide a QUERY_ID, the system will generate an alphanumeric ID. +func (r *FoldersLocationsSavedQueriesService) Patch(name string, savedquery *SavedQuery) *FoldersLocationsSavedQueriesPatchCall { + c := &FoldersLocationsSavedQueriesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.savedquery = savedquery + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. A non-empty +// list of fields to change in the existing saved query. Fields are relative to +// the saved_query and new values for the fields are taken from the +// corresponding fields in the SavedQuery included in this request. Fields not +// mentioned in update_mask are not changed and are ignored in the request.To +// update all mutable fields, specify an update_mask of *.For example, to +// change the description and query filter text of a saved query, specify an +// update_mask of "description, query.filter". +func (c *FoldersLocationsSavedQueriesPatchCall) UpdateMask(updateMask string) *FoldersLocationsSavedQueriesPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *FoldersLocationsSavedQueriesPatchCall) Fields(s ...googleapi.Field) *FoldersLocationsSavedQueriesPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *FoldersLocationsSavedQueriesPatchCall) Context(ctx context.Context) *FoldersLocationsSavedQueriesPatchCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *FoldersLocationsSavedQueriesPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *FoldersLocationsSavedQueriesPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.savedquery) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "logging.folders.locations.savedQueries.patch" call. +// Any non-2xx status code is an error. Response headers are in either +// *SavedQuery.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *FoldersLocationsSavedQueriesPatchCall) Do(opts ...googleapi.CallOption) (*SavedQuery, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &SavedQuery{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil +} + type FoldersLogsDeleteCall struct { s *Service logName string @@ -15758,12 +16244,12 @@ func (r *FoldersSinksService) Create(parent string, logsink *LogSink) *FoldersSi return c } -// CustomWriterIdentity sets the optional parameter "customWriterIdentity": A +// CustomWriterIdentity sets the optional parameter "customWriterIdentity": The // service account provided by the caller that will be used to write the log // entries. The format must be serviceAccount:some@email. This field can only -// be specified if you are routing logs to a destination outside this sink's -// project. If not specified, a Logging service account will automatically be -// generated. +// be specified when you are routing logs to a log bucket that is in a +// different project than the sink. When not specified, a Logging service +// account will automatically be generated. func (c *FoldersSinksCreateCall) CustomWriterIdentity(customWriterIdentity string) *FoldersSinksCreateCall { c.urlParams_.Set("customWriterIdentity", customWriterIdentity) return c @@ -16272,12 +16758,12 @@ func (r *FoldersSinksService) Patch(sinkNameid string, logsink *LogSink) *Folder return c } -// CustomWriterIdentity sets the optional parameter "customWriterIdentity": A +// CustomWriterIdentity sets the optional parameter "customWriterIdentity": The // service account provided by the caller that will be used to write the log // entries. The format must be serviceAccount:some@email. This field can only -// be specified if you are routing logs to a destination outside this sink's -// project. If not specified, a Logging service account will automatically be -// generated. +// be specified when you are routing logs to a log bucket that is in a +// different project than the sink. When not specified, a Logging service +// account will automatically be generated. func (c *FoldersSinksPatchCall) CustomWriterIdentity(customWriterIdentity string) *FoldersSinksPatchCall { c.urlParams_.Set("customWriterIdentity", customWriterIdentity) return c @@ -16423,12 +16909,12 @@ func (r *FoldersSinksService) Update(sinkNameid string, logsink *LogSink) *Folde return c } -// CustomWriterIdentity sets the optional parameter "customWriterIdentity": A +// CustomWriterIdentity sets the optional parameter "customWriterIdentity": The // service account provided by the caller that will be used to write the log // entries. The format must be serviceAccount:some@email. This field can only -// be specified if you are routing logs to a destination outside this sink's -// project. If not specified, a Logging service account will automatically be -// generated. +// be specified when you are routing logs to a log bucket that is in a +// different project than the sink. When not specified, a Logging service +// account will automatically be generated. func (c *FoldersSinksUpdateCall) CustomWriterIdentity(customWriterIdentity string) *FoldersSinksUpdateCall { c.urlParams_.Set("customWriterIdentity", customWriterIdentity) return c @@ -24161,6 +24647,15 @@ func (r *OrganizationsLocationsRecentQueriesService) List(parent string) *Organi return c } +// Filter sets the optional parameter "filter": Specifies the type ("Logging" +// or "OpsAnalytics") of the recent queries to list. The only valid value for +// this field is one of the two allowable type function calls, which are the +// following: type("Logging") type("OpsAnalytics") +func (c *OrganizationsLocationsRecentQueriesListCall) Filter(filter string) *OrganizationsLocationsRecentQueriesListCall { + c.urlParams_.Set("filter", filter) + return c +} + // PageSize sets the optional parameter "pageSize": The maximum number of // results to return from this request. Non-positive values are ignored. The // presence of nextPageToken in the response indicates that more results might @@ -24513,37 +25008,152 @@ func (c *OrganizationsLocationsSavedQueriesDeleteCall) Do(opts ...googleapi.Call return ret, nil } -type OrganizationsLocationsSavedQueriesListCall struct { +type OrganizationsLocationsSavedQueriesGetCall struct { s *Service - parent string + name string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } -// List: Lists the SavedQueries that were created by the user making the -// request. +// Get: Returns all data associated with the requested query. // -// - parent: The resource to which the listed queries belong. -// "projects/[PROJECT_ID]/locations/[LOCATION_ID]" -// "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]" -// "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]" -// "folders/[FOLDER_ID]/locations/[LOCATION_ID]" For example: -// "projects/my-project/locations/us-central1" Note: The locations portion of -// the resource must be specified. To get a list of all saved queries, a -// wildcard character - can be used for LOCATION_ID, for example: -// "projects/my-project/locations/-". -func (r *OrganizationsLocationsSavedQueriesService) List(parent string) *OrganizationsLocationsSavedQueriesListCall { - c := &OrganizationsLocationsSavedQueriesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - return c -} - -// PageSize sets the optional parameter "pageSize": The maximum number of -// results to return from this request.Non-positive values are ignored. The -// presence of nextPageToken in the response indicates that more results might -// be available. +// - name: The resource name of the saved query. +// "projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" +// "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/savedQueries/[QUER +// Y_ID]" +// "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/savedQueries/ +// [QUERY_ID]" +// "folders/[FOLDER_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" For +// example: +// "projects/my-project/locations/global/savedQueries/my-saved-query". +func (r *OrganizationsLocationsSavedQueriesService) Get(name string) *OrganizationsLocationsSavedQueriesGetCall { + c := &OrganizationsLocationsSavedQueriesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *OrganizationsLocationsSavedQueriesGetCall) Fields(s ...googleapi.Field) *OrganizationsLocationsSavedQueriesGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *OrganizationsLocationsSavedQueriesGetCall) IfNoneMatch(entityTag string) *OrganizationsLocationsSavedQueriesGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsLocationsSavedQueriesGetCall) Context(ctx context.Context) *OrganizationsLocationsSavedQueriesGetCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *OrganizationsLocationsSavedQueriesGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsSavedQueriesGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "logging.organizations.locations.savedQueries.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *SavedQuery.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *OrganizationsLocationsSavedQueriesGetCall) Do(opts ...googleapi.CallOption) (*SavedQuery, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &SavedQuery{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil +} + +type OrganizationsLocationsSavedQueriesListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists the SavedQueries that were created by the user making the +// request. +// +// - parent: The resource to which the listed queries belong. +// "projects/[PROJECT_ID]/locations/[LOCATION_ID]" +// "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]" +// "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]" +// "folders/[FOLDER_ID]/locations/[LOCATION_ID]" For example: +// "projects/my-project/locations/us-central1" Note: The locations portion of +// the resource must be specified. To get a list of all saved queries, a +// wildcard character - can be used for LOCATION_ID, for example: +// "projects/my-project/locations/-". +func (r *OrganizationsLocationsSavedQueriesService) List(parent string) *OrganizationsLocationsSavedQueriesListCall { + c := &OrganizationsLocationsSavedQueriesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number of +// results to return from this request.Non-positive values are ignored. The +// presence of nextPageToken in the response indicates that more results might +// be available. func (c *OrganizationsLocationsSavedQueriesListCall) PageSize(pageSize int64) *OrganizationsLocationsSavedQueriesListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c @@ -24669,6 +25279,125 @@ func (c *OrganizationsLocationsSavedQueriesListCall) Pages(ctx context.Context, } } +type OrganizationsLocationsSavedQueriesPatchCall struct { + s *Service + name string + savedquery *SavedQuery + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates an existing SavedQuery. +// +// - name: Output only. Resource name of the saved query.In the format: +// "projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" +// For a list of supported locations, see Supported Regions +// (https://cloud.google.com/logging/docs/region-support#bucket-regions)After +// the saved query is created, the location cannot be changed.If the user +// doesn't provide a QUERY_ID, the system will generate an alphanumeric ID. +func (r *OrganizationsLocationsSavedQueriesService) Patch(name string, savedquery *SavedQuery) *OrganizationsLocationsSavedQueriesPatchCall { + c := &OrganizationsLocationsSavedQueriesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.savedquery = savedquery + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. A non-empty +// list of fields to change in the existing saved query. Fields are relative to +// the saved_query and new values for the fields are taken from the +// corresponding fields in the SavedQuery included in this request. Fields not +// mentioned in update_mask are not changed and are ignored in the request.To +// update all mutable fields, specify an update_mask of *.For example, to +// change the description and query filter text of a saved query, specify an +// update_mask of "description, query.filter". +func (c *OrganizationsLocationsSavedQueriesPatchCall) UpdateMask(updateMask string) *OrganizationsLocationsSavedQueriesPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *OrganizationsLocationsSavedQueriesPatchCall) Fields(s ...googleapi.Field) *OrganizationsLocationsSavedQueriesPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *OrganizationsLocationsSavedQueriesPatchCall) Context(ctx context.Context) *OrganizationsLocationsSavedQueriesPatchCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *OrganizationsLocationsSavedQueriesPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsSavedQueriesPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.savedquery) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "logging.organizations.locations.savedQueries.patch" call. +// Any non-2xx status code is an error. Response headers are in either +// *SavedQuery.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *OrganizationsLocationsSavedQueriesPatchCall) Do(opts ...googleapi.CallOption) (*SavedQuery, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &SavedQuery{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil +} + type OrganizationsLogsDeleteCall struct { s *Service logName string @@ -24967,12 +25696,12 @@ func (r *OrganizationsSinksService) Create(parent string, logsink *LogSink) *Org return c } -// CustomWriterIdentity sets the optional parameter "customWriterIdentity": A +// CustomWriterIdentity sets the optional parameter "customWriterIdentity": The // service account provided by the caller that will be used to write the log // entries. The format must be serviceAccount:some@email. This field can only -// be specified if you are routing logs to a destination outside this sink's -// project. If not specified, a Logging service account will automatically be -// generated. +// be specified when you are routing logs to a log bucket that is in a +// different project than the sink. When not specified, a Logging service +// account will automatically be generated. func (c *OrganizationsSinksCreateCall) CustomWriterIdentity(customWriterIdentity string) *OrganizationsSinksCreateCall { c.urlParams_.Set("customWriterIdentity", customWriterIdentity) return c @@ -25481,12 +26210,12 @@ func (r *OrganizationsSinksService) Patch(sinkNameid string, logsink *LogSink) * return c } -// CustomWriterIdentity sets the optional parameter "customWriterIdentity": A +// CustomWriterIdentity sets the optional parameter "customWriterIdentity": The // service account provided by the caller that will be used to write the log // entries. The format must be serviceAccount:some@email. This field can only -// be specified if you are routing logs to a destination outside this sink's -// project. If not specified, a Logging service account will automatically be -// generated. +// be specified when you are routing logs to a log bucket that is in a +// different project than the sink. When not specified, a Logging service +// account will automatically be generated. func (c *OrganizationsSinksPatchCall) CustomWriterIdentity(customWriterIdentity string) *OrganizationsSinksPatchCall { c.urlParams_.Set("customWriterIdentity", customWriterIdentity) return c @@ -25632,12 +26361,12 @@ func (r *OrganizationsSinksService) Update(sinkNameid string, logsink *LogSink) return c } -// CustomWriterIdentity sets the optional parameter "customWriterIdentity": A +// CustomWriterIdentity sets the optional parameter "customWriterIdentity": The // service account provided by the caller that will be used to write the log // entries. The format must be serviceAccount:some@email. This field can only -// be specified if you are routing logs to a destination outside this sink's -// project. If not specified, a Logging service account will automatically be -// generated. +// be specified when you are routing logs to a log bucket that is in a +// different project than the sink. When not specified, a Logging service +// account will automatically be generated. func (c *OrganizationsSinksUpdateCall) CustomWriterIdentity(customWriterIdentity string) *OrganizationsSinksUpdateCall { c.urlParams_.Set("customWriterIdentity", customWriterIdentity) return c @@ -29739,6 +30468,15 @@ func (r *ProjectsLocationsRecentQueriesService) List(parent string) *ProjectsLoc return c } +// Filter sets the optional parameter "filter": Specifies the type ("Logging" +// or "OpsAnalytics") of the recent queries to list. The only valid value for +// this field is one of the two allowable type function calls, which are the +// following: type("Logging") type("OpsAnalytics") +func (c *ProjectsLocationsRecentQueriesListCall) Filter(filter string) *ProjectsLocationsRecentQueriesListCall { + c.urlParams_.Set("filter", filter) + return c +} + // PageSize sets the optional parameter "pageSize": The maximum number of // results to return from this request. Non-positive values are ignored. The // presence of nextPageToken in the response indicates that more results might @@ -30091,6 +30829,121 @@ func (c *ProjectsLocationsSavedQueriesDeleteCall) Do(opts ...googleapi.CallOptio return ret, nil } +type ProjectsLocationsSavedQueriesGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Returns all data associated with the requested query. +// +// - name: The resource name of the saved query. +// "projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" +// "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/savedQueries/[QUER +// Y_ID]" +// "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/savedQueries/ +// [QUERY_ID]" +// "folders/[FOLDER_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" For +// example: +// "projects/my-project/locations/global/savedQueries/my-saved-query". +func (r *ProjectsLocationsSavedQueriesService) Get(name string) *ProjectsLocationsSavedQueriesGetCall { + c := &ProjectsLocationsSavedQueriesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsSavedQueriesGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsSavedQueriesGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsSavedQueriesGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsSavedQueriesGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsSavedQueriesGetCall) Context(ctx context.Context) *ProjectsLocationsSavedQueriesGetCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsSavedQueriesGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsSavedQueriesGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "logging.projects.locations.savedQueries.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *SavedQuery.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsSavedQueriesGetCall) Do(opts ...googleapi.CallOption) (*SavedQuery, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &SavedQuery{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil +} + type ProjectsLocationsSavedQueriesListCall struct { s *Service parent string @@ -30247,6 +31100,125 @@ func (c *ProjectsLocationsSavedQueriesListCall) Pages(ctx context.Context, f fun } } +type ProjectsLocationsSavedQueriesPatchCall struct { + s *Service + name string + savedquery *SavedQuery + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates an existing SavedQuery. +// +// - name: Output only. Resource name of the saved query.In the format: +// "projects/[PROJECT_ID]/locations/[LOCATION_ID]/savedQueries/[QUERY_ID]" +// For a list of supported locations, see Supported Regions +// (https://cloud.google.com/logging/docs/region-support#bucket-regions)After +// the saved query is created, the location cannot be changed.If the user +// doesn't provide a QUERY_ID, the system will generate an alphanumeric ID. +func (r *ProjectsLocationsSavedQueriesService) Patch(name string, savedquery *SavedQuery) *ProjectsLocationsSavedQueriesPatchCall { + c := &ProjectsLocationsSavedQueriesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.savedquery = savedquery + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. A non-empty +// list of fields to change in the existing saved query. Fields are relative to +// the saved_query and new values for the fields are taken from the +// corresponding fields in the SavedQuery included in this request. Fields not +// mentioned in update_mask are not changed and are ignored in the request.To +// update all mutable fields, specify an update_mask of *.For example, to +// change the description and query filter text of a saved query, specify an +// update_mask of "description, query.filter". +func (c *ProjectsLocationsSavedQueriesPatchCall) UpdateMask(updateMask string) *ProjectsLocationsSavedQueriesPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsSavedQueriesPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsSavedQueriesPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsSavedQueriesPatchCall) Context(ctx context.Context) *ProjectsLocationsSavedQueriesPatchCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsSavedQueriesPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsSavedQueriesPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.savedquery) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "logging.projects.locations.savedQueries.patch" call. +// Any non-2xx status code is an error. Response headers are in either +// *SavedQuery.ServerResponse.Header or (if a response was returned at all) in +// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// whether the returned error was because http.StatusNotModified was returned. +func (c *ProjectsLocationsSavedQueriesPatchCall) Do(opts ...googleapi.CallOption) (*SavedQuery, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &SavedQuery{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil +} + type ProjectsLogsDeleteCall struct { s *Service logName string @@ -31104,12 +32076,12 @@ func (r *ProjectsSinksService) Create(parent string, logsink *LogSink) *Projects return c } -// CustomWriterIdentity sets the optional parameter "customWriterIdentity": A +// CustomWriterIdentity sets the optional parameter "customWriterIdentity": The // service account provided by the caller that will be used to write the log // entries. The format must be serviceAccount:some@email. This field can only -// be specified if you are routing logs to a destination outside this sink's -// project. If not specified, a Logging service account will automatically be -// generated. +// be specified when you are routing logs to a log bucket that is in a +// different project than the sink. When not specified, a Logging service +// account will automatically be generated. func (c *ProjectsSinksCreateCall) CustomWriterIdentity(customWriterIdentity string) *ProjectsSinksCreateCall { c.urlParams_.Set("customWriterIdentity", customWriterIdentity) return c @@ -31618,12 +32590,12 @@ func (r *ProjectsSinksService) Patch(sinkNameid string, logsink *LogSink) *Proje return c } -// CustomWriterIdentity sets the optional parameter "customWriterIdentity": A +// CustomWriterIdentity sets the optional parameter "customWriterIdentity": The // service account provided by the caller that will be used to write the log // entries. The format must be serviceAccount:some@email. This field can only -// be specified if you are routing logs to a destination outside this sink's -// project. If not specified, a Logging service account will automatically be -// generated. +// be specified when you are routing logs to a log bucket that is in a +// different project than the sink. When not specified, a Logging service +// account will automatically be generated. func (c *ProjectsSinksPatchCall) CustomWriterIdentity(customWriterIdentity string) *ProjectsSinksPatchCall { c.urlParams_.Set("customWriterIdentity", customWriterIdentity) return c @@ -31769,12 +32741,12 @@ func (r *ProjectsSinksService) Update(sinkNameid string, logsink *LogSink) *Proj return c } -// CustomWriterIdentity sets the optional parameter "customWriterIdentity": A +// CustomWriterIdentity sets the optional parameter "customWriterIdentity": The // service account provided by the caller that will be used to write the log // entries. The format must be serviceAccount:some@email. This field can only -// be specified if you are routing logs to a destination outside this sink's -// project. If not specified, a Logging service account will automatically be -// generated. +// be specified when you are routing logs to a log bucket that is in a +// different project than the sink. When not specified, a Logging service +// account will automatically be generated. func (c *ProjectsSinksUpdateCall) CustomWriterIdentity(customWriterIdentity string) *ProjectsSinksUpdateCall { c.urlParams_.Set("customWriterIdentity", customWriterIdentity) return c @@ -31917,12 +32889,12 @@ func (r *SinksService) Create(parent string, logsink *LogSink) *SinksCreateCall return c } -// CustomWriterIdentity sets the optional parameter "customWriterIdentity": A +// CustomWriterIdentity sets the optional parameter "customWriterIdentity": The // service account provided by the caller that will be used to write the log // entries. The format must be serviceAccount:some@email. This field can only -// be specified if you are routing logs to a destination outside this sink's -// project. If not specified, a Logging service account will automatically be -// generated. +// be specified when you are routing logs to a log bucket that is in a +// different project than the sink. When not specified, a Logging service +// account will automatically be generated. func (c *SinksCreateCall) CustomWriterIdentity(customWriterIdentity string) *SinksCreateCall { c.urlParams_.Set("customWriterIdentity", customWriterIdentity) return c @@ -32431,12 +33403,12 @@ func (r *SinksService) Update(sinkNameid string, logsink *LogSink) *SinksUpdateC return c } -// CustomWriterIdentity sets the optional parameter "customWriterIdentity": A +// CustomWriterIdentity sets the optional parameter "customWriterIdentity": The // service account provided by the caller that will be used to write the log // entries. The format must be serviceAccount:some@email. This field can only -// be specified if you are routing logs to a destination outside this sink's -// project. If not specified, a Logging service account will automatically be -// generated. +// be specified when you are routing logs to a log bucket that is in a +// different project than the sink. When not specified, a Logging service +// account will automatically be generated. func (c *SinksUpdateCall) CustomWriterIdentity(customWriterIdentity string) *SinksUpdateCall { c.urlParams_.Set("customWriterIdentity", customWriterIdentity) return c diff --git a/storage/v1/storage-api.json b/storage/v1/storage-api.json index d336c44cccf..9c06c5ede4e 100644 --- a/storage/v1/storage-api.json +++ b/storage/v1/storage-api.json @@ -27,13 +27,23 @@ "discoveryVersion": "v1", "documentationLink": "https://developers.google.com/storage/docs/json_api/", "endpoints": [ + { + "description": "Regional Endpoint", + "endpointUrl": "https://storage.europe-west3.rep.googleapis.com/", + "location": "europe-west3" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://storage.europe-west9.rep.googleapis.com/", + "location": "europe-west9" + }, { "description": "Regional Endpoint", "endpointUrl": "https://storage.me-central2.rep.googleapis.com/", "location": "me-central2" } ], - "etag": "\"39393431363637393939313737343036323439\"", + "etag": "\"39393931363036383932333134343736343437\"", "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" @@ -4075,7 +4085,7 @@ } } }, - "revision": "20240621", + "revision": "20240625", "rootUrl": "https://storage.googleapis.com/", "schemas": { "AnywhereCache": { diff --git a/workloadmanager/v1/workloadmanager-api.json b/workloadmanager/v1/workloadmanager-api.json index e20d8816f07..d05d42980dd 100644 --- a/workloadmanager/v1/workloadmanager-api.json +++ b/workloadmanager/v1/workloadmanager-api.json @@ -772,9 +772,27 @@ } } }, - "revision": "20240616", + "revision": "20240619", "rootUrl": "https://workloadmanager.googleapis.com/", "schemas": { + "AgentCommand": { + "description": "* An AgentCommand specifies a one-time executable program for the agent to run.", + "id": "AgentCommand", + "properties": { + "command": { + "description": "command is the name of the agent one-time executable that will be invoked.", + "type": "string" + }, + "parameters": { + "additionalProperties": { + "type": "string" + }, + "description": "parameters is a map of key/value pairs that can be used to specify additional one-time executable settings.", + "type": "object" + } + }, + "type": "object" + }, "AssetLocation": { "description": "Provides the mapping of a cloud asset to a direct physical location or to a proxy that defines the location on its behalf.", "id": "AssetLocation", @@ -865,6 +883,21 @@ }, "type": "object" }, + "Command": { + "description": "* Command specifies the type of command to execute.", + "id": "Command", + "properties": { + "agentCommand": { + "$ref": "AgentCommand", + "description": "AgentCommand specifies a one-time executable program for the agent to run." + }, + "shellCommand": { + "$ref": "ShellCommand", + "description": "ShellCommand is invoked via the agent's command line executor." + } + }, + "type": "object" + }, "DirectLocationAssignment": { "id": "DirectLocationAssignment", "properties": { @@ -1036,6 +1069,13 @@ "description": "Message describing the result of an execution", "id": "ExecutionResult", "properties": { + "commands": { + "description": "The commands to remediate the violation.", + "items": { + "$ref": "Command" + }, + "type": "array" + }, "documentationUrl": { "description": "The URL for the documentation of the rule.", "type": "string" @@ -1067,8 +1107,12 @@ "description": "Message for external data sources", "id": "ExternalDataSources", "properties": { + "assetType": { + "description": "Required. The asset type of the external data source must be one of go/cai-asset-types", + "type": "string" + }, "name": { - "description": "Required. Name of external data source. The name will be used inside the rego/sql to refer the external data", + "description": "Optional. Name of external data source. The name will be used inside the rego/sql to refer the external data", "type": "string" }, "type": { @@ -2251,6 +2295,26 @@ }, "type": "object" }, + "ShellCommand": { + "description": "* A ShellCommand is invoked via the agent's command line executor", + "id": "ShellCommand", + "properties": { + "args": { + "description": "args is a string of arguments to be passed to the command.", + "type": "string" + }, + "command": { + "description": "command is the name of the command to be executed.", + "type": "string" + }, + "timeoutSeconds": { + "description": "Optional. If not specified, the default timeout is 60 seconds.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, "SpannerLocation": { "id": "SpannerLocation", "properties": { diff --git a/workloadmanager/v1/workloadmanager-gen.go b/workloadmanager/v1/workloadmanager-gen.go index f13f6fc969e..6a2ba1de72d 100644 --- a/workloadmanager/v1/workloadmanager-gen.go +++ b/workloadmanager/v1/workloadmanager-gen.go @@ -259,6 +259,33 @@ type ProjectsLocationsRulesService struct { s *Service } +// AgentCommand: * An AgentCommand specifies a one-time executable program for +// the agent to run. +type AgentCommand struct { + // Command: command is the name of the agent one-time executable that will be + // invoked. + Command string `json:"command,omitempty"` + // Parameters: parameters is a map of key/value pairs that can be used to + // specify additional one-time executable settings. + Parameters map[string]string `json:"parameters,omitempty"` + // ForceSendFields is a list of field names (e.g. "Command") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Command") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *AgentCommand) MarshalJSON() ([]byte, error) { + type NoMethod AgentCommand + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // AssetLocation: Provides the mapping of a cloud asset to a direct physical // location or to a proxy that defines the location on its behalf. type AssetLocation struct { @@ -383,6 +410,31 @@ func (s *CloudAssetComposition) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +// Command: * Command specifies the type of command to execute. +type Command struct { + // AgentCommand: AgentCommand specifies a one-time executable program for the + // agent to run. + AgentCommand *AgentCommand `json:"agentCommand,omitempty"` + // ShellCommand: ShellCommand is invoked via the agent's command line executor. + ShellCommand *ShellCommand `json:"shellCommand,omitempty"` + // ForceSendFields is a list of field names (e.g. "AgentCommand") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AgentCommand") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *Command) MarshalJSON() ([]byte, error) { + type NoMethod Command + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + type DirectLocationAssignment struct { Location []*LocationAssignment `json:"location,omitempty"` // ForceSendFields is a list of field names (e.g. "Location") to @@ -519,6 +571,8 @@ func (s *Execution) MarshalJSON() ([]byte, error) { // ExecutionResult: Message describing the result of an execution type ExecutionResult struct { + // Commands: The commands to remediate the violation. + Commands []*Command `json:"commands,omitempty"` // DocumentationUrl: The URL for the documentation of the rule. DocumentationUrl string `json:"documentationUrl,omitempty"` // Resource: The resource that violates the rule. @@ -531,15 +585,15 @@ type ExecutionResult struct { ViolationDetails *ViolationDetails `json:"violationDetails,omitempty"` // ViolationMessage: The violation message of an execution. ViolationMessage string `json:"violationMessage,omitempty"` - // ForceSendFields is a list of field names (e.g. "DocumentationUrl") to + // ForceSendFields is a list of field names (e.g. "Commands") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "DocumentationUrl") 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. "Commands") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -551,7 +605,10 @@ func (s *ExecutionResult) MarshalJSON() ([]byte, error) { // ExternalDataSources: Message for external data sources type ExternalDataSources struct { - // Name: Required. Name of external data source. The name will be used inside + // AssetType: Required. The asset type of the external data source must be one + // of go/cai-asset-types + AssetType string `json:"assetType,omitempty"` + // Name: Optional. Name of external data source. The name will be used inside // the rego/sql to refer the external data Name string `json:"name,omitempty"` // Type: Required. Type of external data source @@ -563,15 +620,15 @@ type ExternalDataSources struct { // Uri: Required. URI of external data source. example of bq table // {project_ID}.{dataset_ID}.{table_ID} Uri string `json:"uri,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 + // ForceSendFields is a list of field names (e.g. "AssetType") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See // https://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 + // NullFields is a list of field names (e.g. "AssetType") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -1830,6 +1887,34 @@ func (s *ScannedResource) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +// ShellCommand: * A ShellCommand is invoked via the agent's command line +// executor +type ShellCommand struct { + // Args: args is a string of arguments to be passed to the command. + Args string `json:"args,omitempty"` + // Command: command is the name of the command to be executed. + Command string `json:"command,omitempty"` + // TimeoutSeconds: Optional. If not specified, the default timeout is 60 + // seconds. + TimeoutSeconds int64 `json:"timeoutSeconds,omitempty"` + // ForceSendFields is a list of field names (e.g. "Args") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Args") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *ShellCommand) MarshalJSON() ([]byte, error) { + type NoMethod ShellCommand + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + type SpannerLocation struct { DbName []string `json:"dbName,omitempty"` // ForceSendFields is a list of field names (e.g. "DbName") to unconditionally diff --git a/workstations/v1/workstations-api.json b/workstations/v1/workstations-api.json index 3d2e409b873..e94f55aea79 100644 --- a/workstations/v1/workstations-api.json +++ b/workstations/v1/workstations-api.json @@ -1195,7 +1195,7 @@ } } }, - "revision": "20240528", + "revision": "20240619", "rootUrl": "https://workstations.googleapis.com/", "schemas": { "Accelerator": { @@ -1474,6 +1474,13 @@ "type": "string" }, "type": "array" + }, + "vmTags": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Resource manager tags to be bound to this instance. Tag keys and values have the same definition as https://cloud.google.com/resource-manager/docs/tags/tags-overview Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`.", + "type": "object" } }, "type": "object" @@ -1567,6 +1574,11 @@ "format": "google-datetime", "type": "string" }, + "port": { + "description": "Optional. Port for which the access token should be generated. If specified, the generated access token grants access only to the specified port of the workstation. If specified, values must be within the range [1 - 65535]. If not specified, the generated access token grants access to all ports of the workstation.", + "format": "int32", + "type": "integer" + }, "ttl": { "description": "Desired lifetime duration of the access token. This value must be at most 24 hours. If a value is not specified, the token's lifetime will be set to a default value of 1 hour.", "format": "google-duration", diff --git a/workstations/v1/workstations-gen.go b/workstations/v1/workstations-gen.go index 74b5f4538ec..53294165590 100644 --- a/workstations/v1/workstations-gen.go +++ b/workstations/v1/workstations-gen.go @@ -715,6 +715,12 @@ type GceInstance struct { // with this configuration. These network tags enable the creation of firewall // rules (https://cloud.google.com/workstations/docs/configure-firewall-rules). Tags []string `json:"tags,omitempty"` + // VmTags: Optional. Resource manager tags to be bound to this instance. Tag + // keys and values have the same definition as + // https://cloud.google.com/resource-manager/docs/tags/tags-overview Keys must + // be in the format `tagKeys/{tag_key_id}`, and values are in the format + // `tagValues/456`. + VmTags map[string]string `json:"vmTags,omitempty"` // ForceSendFields is a list of field names (e.g. "Accelerators") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -856,6 +862,12 @@ type GenerateAccessTokenRequest struct { // at most 24 hours in the future. If a value is not specified, the token's // expiration time will be set to a default value of 1 hour in the future. ExpireTime string `json:"expireTime,omitempty"` + // Port: Optional. Port for which the access token should be generated. If + // specified, the generated access token grants access only to the specified + // port of the workstation. If specified, values must be within the range [1 - + // 65535]. If not specified, the generated access token grants access to all + // ports of the workstation. + Port int64 `json:"port,omitempty"` // Ttl: Desired lifetime duration of the access token. This value must be at // most 24 hours. If a value is not specified, the token's lifetime will be set // to a default value of 1 hour. diff --git a/workstations/v1beta/workstations-api.json b/workstations/v1beta/workstations-api.json index fbef1a917f7..ee1a0716dde 100644 --- a/workstations/v1beta/workstations-api.json +++ b/workstations/v1beta/workstations-api.json @@ -1127,7 +1127,7 @@ } } }, - "revision": "20240528", + "revision": "20240619", "rootUrl": "https://workstations.googleapis.com/", "schemas": { "Accelerator": { @@ -1595,6 +1595,17 @@ }, "type": "object" }, + "HttpOptions": { + "description": "Http options for the running workstations.", + "id": "HttpOptions", + "properties": { + "allowedUnauthenticatedCorsPreflightRequests": { + "description": "Optional. By default, the workstations service makes sure that all requests to the workstation are authenticated. CORS preflight requests do not include cookies or custom headers, and so are considered unauthenticated and blocked by the workstations service. Enabling this option allows these unauthenticated CORS preflight requests through to the workstation, where it becomes the responsibility of the destination server in the workstation to validate the request.", + "type": "boolean" + } + }, + "type": "object" + }, "ListOperationsResponse": { "description": "The response message for Operations.ListOperations.", "id": "ListOperationsResponse", @@ -2088,6 +2099,10 @@ "readOnly": true, "type": "boolean" }, + "sourceWorkstation": { + "description": "Optional. The source workstation from which this workstations persistent directories were cloned on creation.", + "type": "string" + }, "startTime": { "description": "Output only. Time when this workstation was most recently successfully started, regardless of the workstation's initial state.", "format": "google-datetime", @@ -2300,6 +2315,10 @@ "$ref": "Host", "description": "Optional. Runtime host for the workstation." }, + "httpOptions": { + "$ref": "HttpOptions", + "description": "Optional. Http options that customize the behavior of the workstation service's http proxy." + }, "idleTimeout": { "description": "Optional. Number of seconds to wait before automatically stopping a workstation after it last received user traffic. A value of `\"0s\"` indicates that Cloud Workstations VMs created with this configuration should never time out due to idleness. Provide [duration](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#duration) terminated by `s` for seconds—for example, `\"7200s\"` (2 hours). The default is `\"1200s\"` (20 minutes).", "format": "google-duration", diff --git a/workstations/v1beta/workstations-gen.go b/workstations/v1beta/workstations-gen.go index fc41fc54c65..442009514e5 100644 --- a/workstations/v1beta/workstations-gen.go +++ b/workstations/v1beta/workstations-gen.go @@ -1017,6 +1017,37 @@ func (s *Host) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +// HttpOptions: Http options for the running workstations. +type HttpOptions struct { + // AllowedUnauthenticatedCorsPreflightRequests: Optional. By default, the + // workstations service makes sure that all requests to the workstation are + // authenticated. CORS preflight requests do not include cookies or custom + // headers, and so are considered unauthenticated and blocked by the + // workstations service. Enabling this option allows these unauthenticated CORS + // preflight requests through to the workstation, where it becomes the + // responsibility of the destination server in the workstation to validate the + // request. + AllowedUnauthenticatedCorsPreflightRequests bool `json:"allowedUnauthenticatedCorsPreflightRequests,omitempty"` + // ForceSendFields is a list of field names (e.g. + // "AllowedUnauthenticatedCorsPreflightRequests") to unconditionally include in + // API requests. By default, fields with empty or default values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. + // "AllowedUnauthenticatedCorsPreflightRequests") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *HttpOptions) MarshalJSON() ([]byte, error) { + type NoMethod HttpOptions + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // ListOperationsResponse: The response message for Operations.ListOperations. type ListOperationsResponse struct { // NextPageToken: The standard List next-page token. @@ -1676,6 +1707,9 @@ type Workstation struct { // Reconciling: Output only. Indicates whether this workstation is currently // being updated to match its intended state. Reconciling bool `json:"reconciling,omitempty"` + // SourceWorkstation: Optional. The source workstation from which this + // workstations persistent directories were cloned on creation. + SourceWorkstation string `json:"sourceWorkstation,omitempty"` // StartTime: Output only. Time when this workstation was most recently // successfully started, regardless of the workstation's initial state. StartTime string `json:"startTime,omitempty"` @@ -1862,6 +1896,9 @@ type WorkstationConfig struct { Etag string `json:"etag,omitempty"` // Host: Optional. Runtime host for the workstation. Host *Host `json:"host,omitempty"` + // HttpOptions: Optional. Http options that customize the behavior of the + // workstation service's http proxy. + HttpOptions *HttpOptions `json:"httpOptions,omitempty"` // IdleTimeout: Optional. Number of seconds to wait before automatically // stopping a workstation after it last received user traffic. A value of // "0s" indicates that Cloud Workstations VMs created with this configuration