diff --git a/chat/v1/chat-api.json b/chat/v1/chat-api.json index 62ce8ed92ed..030e2e3b065 100644 --- a/chat/v1/chat-api.json +++ b/chat/v1/chat-api.json @@ -334,7 +334,7 @@ "type": "string" }, "useAdminAccess": { - "description": "When `true`, the method runs using the user's Google Workspace administrator privileges. The calling user must be a Google Workspace administrator with the [manage chat and spaces conversations privilege](https://support.google.com/a/answer/13369245). Requires the `chat.admin.delete` [OAuth 2.0 scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes).", + "description": "Optional. When `true`, the method runs using the user's Google Workspace administrator privileges. The calling user must be a Google Workspace administrator with the [manage chat and spaces conversations privilege](https://support.google.com/a/answer/13369245). Requires the `chat.admin.delete` [OAuth 2.0 scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes).", "location": "query", "type": "boolean" } @@ -390,7 +390,7 @@ "type": "string" }, "useAdminAccess": { - "description": "When `true`, the method runs using the user's Google Workspace administrator privileges. The calling user must be a Google Workspace administrator with the [manage chat and spaces conversations privilege](https://support.google.com/a/answer/13369245). Requires the `chat.admin.spaces` or `chat.admin.spaces.readonly` [OAuth 2.0 scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes).", + "description": "Optional. When `true`, the method runs using the user's Google Workspace administrator privileges. The calling user must be a Google Workspace administrator with the [manage chat and spaces conversations privilege](https://support.google.com/a/answer/13369245). Requires the `chat.admin.spaces` or `chat.admin.spaces.readonly` [OAuth 2.0 scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes).", "location": "query", "type": "boolean" } @@ -452,7 +452,7 @@ ], "parameters": { "name": { - "description": "Resource name of the space. Format: `spaces/{space}` Where `{space}` represents the system-assigned ID for the space. You can obtain the space ID by calling the [`spaces.list()`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/list) method or from the space URL. For example, if the space URL is `https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA`, the space ID is `AAAAAAAAA`.", + "description": "Identifier. Resource name of the space. Format: `spaces/{space}` Where `{space}` represents the system-assigned ID for the space. You can obtain the space ID by calling the [`spaces.list()`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/list) method or from the space URL. For example, if the space URL is `https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA`, the space ID is `AAAAAAAAA`.", "location": "path", "pattern": "^spaces/[^/]+$", "required": true, @@ -465,7 +465,7 @@ "type": "string" }, "useAdminAccess": { - "description": "When `true`, the method runs using the user's Google Workspace administrator privileges. The calling user must be a Google Workspace administrator with the [manage chat and spaces conversations privilege](https://support.google.com/a/answer/13369245). Requires the `chat.admin.spaces` [OAuth 2.0 scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes). Some `FieldMask` values are not supported using admin access. For details, see the description of `update_mask`.", + "description": "Optional. When `true`, the method runs using the user's Google Workspace administrator privileges. The calling user must be a Google Workspace administrator with the [manage chat and spaces conversations privilege](https://support.google.com/a/answer/13369245). Requires the `chat.admin.spaces` [OAuth 2.0 scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes). Some `FieldMask` values are not supported using admin access. For details, see the description of `update_mask`.", "location": "query", "type": "boolean" } @@ -834,7 +834,7 @@ ], "parameters": { "force": { - "description": "When `true`, deleting a message also deletes its threaded replies. When `false`, if a message has threaded replies, deletion fails. Only applies when [authenticating as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). Has no effect when [authenticating as a Chat app] (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).", + "description": "Optional. When `true`, deleting a message also deletes its threaded replies. When `false`, if a message has threaded replies, deletion fails. Only applies when [authenticating as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). Has no effect when [authenticating as a Chat app] (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).", "location": "query", "type": "boolean" }, @@ -893,23 +893,23 @@ ], "parameters": { "filter": { - "description": "A query filter. You can filter messages by date (`create_time`) and thread (`thread.name`). To filter messages by the date they were created, specify the `create_time` with a timestamp in [RFC-3339](https://www.rfc-editor.org/rfc/rfc3339) format and double quotation marks. For example, `\"2023-04-21T11:30:00-04:00\"`. You can use the greater than operator `\u003e` to list messages that were created after a timestamp, or the less than operator `\u003c` to list messages that were created before a timestamp. To filter messages within a time interval, use the `AND` operator between two timestamps. To filter by thread, specify the `thread.name`, formatted as `spaces/{space}/threads/{thread}`. You can only specify one `thread.name` per query. To filter by both thread and date, use the `AND` operator in your query. For example, the following queries are valid: ``` create_time \u003e \"2012-04-21T11:30:00-04:00\" create_time \u003e \"2012-04-21T11:30:00-04:00\" AND thread.name = spaces/AAAAAAAAAAA/threads/123 create_time \u003e \"2012-04-21T11:30:00+00:00\" AND create_time \u003c \"2013-01-01T00:00:00+00:00\" AND thread.name = spaces/AAAAAAAAAAA/threads/123 thread.name = spaces/AAAAAAAAAAA/threads/123 ``` Invalid queries are rejected by the server with an `INVALID_ARGUMENT` error.", + "description": "Optional. A query filter. You can filter messages by date (`create_time`) and thread (`thread.name`). To filter messages by the date they were created, specify the `create_time` with a timestamp in [RFC-3339](https://www.rfc-editor.org/rfc/rfc3339) format and double quotation marks. For example, `\"2023-04-21T11:30:00-04:00\"`. You can use the greater than operator `\u003e` to list messages that were created after a timestamp, or the less than operator `\u003c` to list messages that were created before a timestamp. To filter messages within a time interval, use the `AND` operator between two timestamps. To filter by thread, specify the `thread.name`, formatted as `spaces/{space}/threads/{thread}`. You can only specify one `thread.name` per query. To filter by both thread and date, use the `AND` operator in your query. For example, the following queries are valid: ``` create_time \u003e \"2012-04-21T11:30:00-04:00\" create_time \u003e \"2012-04-21T11:30:00-04:00\" AND thread.name = spaces/AAAAAAAAAAA/threads/123 create_time \u003e \"2012-04-21T11:30:00+00:00\" AND create_time \u003c \"2013-01-01T00:00:00+00:00\" AND thread.name = spaces/AAAAAAAAAAA/threads/123 thread.name = spaces/AAAAAAAAAAA/threads/123 ``` Invalid queries are rejected by the server with an `INVALID_ARGUMENT` error.", "location": "query", "type": "string" }, "orderBy": { - "description": "Optional, if resuming from a previous query. How the list of messages is ordered. Specify a value to order by an ordering operation. Valid ordering operation values are as follows: - `ASC` for ascending. - `DESC` for descending. The default ordering is `create_time ASC`.", + "description": "Optional. Optional, if resuming from a previous query. How the list of messages is ordered. Specify a value to order by an ordering operation. Valid ordering operation values are as follows: - `ASC` for ascending. - `DESC` for descending. The default ordering is `create_time ASC`.", "location": "query", "type": "string" }, "pageSize": { - "description": "The maximum number of messages returned. The service might return fewer messages than this value. If unspecified, at most 25 are returned. The maximum value is 1000. If you use a value more than 1000, it's automatically changed to 1000. Negative values return an `INVALID_ARGUMENT` error.", + "description": "Optional. The maximum number of messages returned. The service might return fewer messages than this value. If unspecified, at most 25 are returned. The maximum value is 1000. If you use a value more than 1000, it's automatically changed to 1000. Negative values return an `INVALID_ARGUMENT` error.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { - "description": "Optional, if resuming from a previous query. A page token received from a previous list messages call. Provide this parameter to retrieve the subsequent page. When paginating, all other parameters provided should match the call that provided the page token. Passing different values to the other parameters might lead to unexpected results.", + "description": "Optional. Optional, if resuming from a previous query. A page token received from a previous list messages call. Provide this parameter to retrieve the subsequent page. When paginating, all other parameters provided should match the call that provided the page token. Passing different values to the other parameters might lead to unexpected results.", "location": "query", "type": "string" }, @@ -921,7 +921,7 @@ "type": "string" }, "showDeleted": { - "description": "Whether to include deleted messages. Deleted messages include deleted time and metadata about their deletion, but message content is unavailable.", + "description": "Optional. Whether to include deleted messages. Deleted messages include deleted time and metadata about their deletion, but message content is unavailable.", "location": "query", "type": "boolean" } @@ -951,7 +951,7 @@ "type": "boolean" }, "name": { - "description": "Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).", + "description": "Identifier. Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).", "location": "path", "pattern": "^spaces/[^/]+/messages/[^/]+$", "required": true, @@ -992,7 +992,7 @@ "type": "boolean" }, "name": { - "description": "Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).", + "description": "Identifier. Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).", "location": "path", "pattern": "^spaces/[^/]+/messages/[^/]+$", "required": true, @@ -1344,7 +1344,7 @@ } } }, - "revision": "20241031", + "revision": "20241103", "rootUrl": "https://chat.googleapis.com/", "schemas": { "AccessSettings": { @@ -3867,13 +3867,15 @@ "id": "MembershipCount", "properties": { "joinedDirectHumanUserCount": { - "description": "Count of human users that have directly joined the space, not counting users joined by having membership in a joined group.", + "description": "Output only. Count of human users that have directly joined the space, not counting users joined by having membership in a joined group.", "format": "int32", + "readOnly": true, "type": "integer" }, "joinedGroupCount": { - "description": "Count of all groups that have directly joined the space.", + "description": "Output only. Count of all groups that have directly joined the space.", "format": "int32", + "readOnly": true, "type": "integer" } }, @@ -3917,7 +3919,7 @@ "id": "Message", "properties": { "accessoryWidgets": { - "description": "One or more interactive widgets that appear at the bottom of a message. You can add accessory widgets to messages that contain text, cards, or both text and cards. Not supported for messages that contain dialogs. For details, see [Add interactive widgets at the bottom of a message](https://developers.google.com/workspace/chat/create-messages#add-accessory-widgets). Creating a message with accessory widgets requires [app authentication] (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).", + "description": "Optional. One or more interactive widgets that appear at the bottom of a message. You can add accessory widgets to messages that contain text, cards, or both text and cards. Not supported for messages that contain dialogs. For details, see [Add interactive widgets at the bottom of a message](https://developers.google.com/workspace/chat/create-messages#add-accessory-widgets). Creating a message with accessory widgets requires [app authentication] (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).", "items": { "$ref": "AccessoryWidget" }, @@ -3949,7 +3951,7 @@ "type": "array" }, "attachment": { - "description": "User-uploaded attachment.", + "description": "Optional. User-uploaded attachment.", "items": { "$ref": "Attachment" }, @@ -3964,14 +3966,14 @@ "type": "array" }, "cardsV2": { - "description": "An array of [cards](https://developers.google.com/workspace/chat/api/reference/rest/v1/cards). Only Chat apps can create cards. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the messages can't contain cards. To learn how to create a message that contains cards, see [Send a message](https://developers.google.com/workspace/chat/create-messages). [Card builder](https://addons.gsuite.google.com/uikit/builder)", + "description": "Optional. An array of [cards](https://developers.google.com/workspace/chat/api/reference/rest/v1/cards). Only Chat apps can create cards. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the messages can't contain cards. To learn how to create a message that contains cards, see [Send a message](https://developers.google.com/workspace/chat/create-messages). [Card builder](https://addons.gsuite.google.com/uikit/builder)", "items": { "$ref": "CardWithId" }, "type": "array" }, "clientAssignedMessageId": { - "description": "Optional. A custom ID for the message. You can use field to identify a message, or to get, delete, or update a message. To set a custom ID, specify the [`messageId`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages/create#body.QUERY_PARAMETERS.message_id) field when you create the message. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).", + "description": "Optional. Optional. A custom ID for the message. You can use field to identify a message, or to get, delete, or update a message. To set a custom ID, specify the [`messageId`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages/create#body.QUERY_PARAMETERS.message_id) field when you create the message. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).", "type": "string" }, "createTime": { @@ -3999,7 +4001,7 @@ "type": "array" }, "fallbackText": { - "description": "A plain-text description of the message's cards, used when the actual cards can't be displayed—for example, mobile notifications.", + "description": "Optional. A plain-text description of the message's cards, used when the actual cards can't be displayed—for example, mobile notifications.", "type": "string" }, "formattedText": { @@ -4019,12 +4021,12 @@ "readOnly": true }, "name": { - "description": "Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).", + "description": "Identifier. Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).", "type": "string" }, "privateMessageViewer": { "$ref": "User", - "description": "Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) * [Accessory widgets](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages#Message.AccessoryWidget) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private)." + "description": "Optional. Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) * [Accessory widgets](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages#Message.AccessoryWidget) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private)." }, "quotedMessageMetadata": { "$ref": "QuotedMessageMetadata", @@ -4043,10 +4045,11 @@ }, "space": { "$ref": "Space", - "description": "If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output populates the [space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces) `name`." + "description": "Output only. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output only populates the [space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces) `name`.", + "readOnly": true }, "text": { - "description": "Plain-text body of the message. The first link to an image, video, or web page generates a [preview chip](https://developers.google.com/workspace/chat/preview-links). You can also [@mention a Google Chat user](https://developers.google.com/workspace/chat/format-messages#messages-@mention), or everyone in the space. To learn about creating text messages, see [Send a message](https://developers.google.com/workspace/chat/create-messages).", + "description": "Optional. Plain-text body of the message. The first link to an image, video, or web page generates a [preview chip](https://developers.google.com/workspace/chat/preview-links). You can also [@mention a Google Chat user](https://developers.google.com/workspace/chat/format-messages#messages-@mention), or everyone in the space. To learn about creating text messages, see [Send a message](https://developers.google.com/workspace/chat/create-messages).", "type": "string" }, "thread": { @@ -4167,11 +4170,11 @@ "id": "PermissionSetting", "properties": { "managersAllowed": { - "description": "Whether spaces managers have this permission.", + "description": "Optional. Whether spaces managers have this permission.", "type": "boolean" }, "membersAllowed": { - "description": "Whether non-manager members have this permission.", + "description": "Optional. Whether non-manager members have this permission.", "type": "boolean" } }, @@ -4183,19 +4186,19 @@ "properties": { "manageApps": { "$ref": "PermissionSetting", - "description": "Setting for managing apps in a space." + "description": "Optional. Setting for managing apps in a space." }, "manageMembersAndGroups": { "$ref": "PermissionSetting", - "description": "Setting for managing members and groups in a space." + "description": "Optional. Setting for managing members and groups in a space." }, "manageWebhooks": { "$ref": "PermissionSetting", - "description": "Setting for managing webhooks in a space." + "description": "Optional. Setting for managing webhooks in a space." }, "modifySpaceDetails": { "$ref": "PermissionSetting", - "description": "Setting for updating space name, avatar, description and guidelines." + "description": "Optional. Setting for updating space name, avatar, description and guidelines." }, "postMessages": { "$ref": "PermissionSetting", @@ -4204,15 +4207,15 @@ }, "replyMessages": { "$ref": "PermissionSetting", - "description": "Setting for replying to messages in a space." + "description": "Optional. Setting for replying to messages in a space." }, "toggleHistory": { "$ref": "PermissionSetting", - "description": "Setting for toggling space history on and off." + "description": "Optional. Setting for toggling space history on and off." }, "useAtMentionAll": { "$ref": "PermissionSetting", - "description": "Setting for using @all in a space." + "description": "Optional. Setting for using @all in a space." } }, "type": "object" @@ -4484,11 +4487,11 @@ "type": "string" }, "displayName": { - "description": "The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.", + "description": "Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.", "type": "string" }, "externalUserAllowed": { - "description": "Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only.", + "description": "Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only.", "type": "boolean" }, "importMode": { @@ -4507,7 +4510,7 @@ "readOnly": true }, "name": { - "description": "Resource name of the space. Format: `spaces/{space}` Where `{space}` represents the system-assigned ID for the space. You can obtain the space ID by calling the [`spaces.list()`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/list) method or from the space URL. For example, if the space URL is `https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA`, the space ID is `AAAAAAAAA`.", + "description": "Identifier. Resource name of the space. Format: `spaces/{space}` Where `{space}` represents the system-assigned ID for the space. You can obtain the space ID by calling the [`spaces.list()`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/list) method or from the space URL. For example, if the space URL is `https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA`, the space ID is `AAAAAAAAA`.", "type": "string" }, "permissionSettings": { @@ -4534,10 +4537,10 @@ }, "spaceDetails": { "$ref": "SpaceDetails", - "description": "Details about the space including description and rules." + "description": "Optional. Details about the space including description and rules." }, "spaceHistoryState": { - "description": "The message history state for messages and threads in this space.", + "description": "Optional. The message history state for messages and threads in this space.", "enum": [ "HISTORY_STATE_UNSPECIFIED", "HISTORY_OFF", @@ -4568,7 +4571,7 @@ "type": "string" }, "spaceType": { - "description": "The type of space. Required when creating a space or updating the space type of a space. Output only for other usage.", + "description": "Optional. The type of space. Required when creating a space or updating the space type of a space. Output only for other usage.", "enum": [ "SPACE_TYPE_UNSPECIFIED", "SPACE", @@ -4843,7 +4846,7 @@ "id": "Thread", "properties": { "name": { - "description": "Resource name of the thread. Example: `spaces/{space}/threads/{thread}`", + "description": "Identifier. Resource name of the thread. Example: `spaces/{space}/threads/{thread}`", "type": "string" }, "threadKey": { diff --git a/chat/v1/chat-gen.go b/chat/v1/chat-gen.go index fc8af65bd0f..29ad6d42d84 100644 --- a/chat/v1/chat-gen.go +++ b/chat/v1/chat-gen.go @@ -4144,10 +4144,12 @@ func (s MembershipBatchUpdatedEventData) MarshalJSON() ([]byte, error) { // MembershipCount: Represents the count of memberships of a space, grouped // into categories. type MembershipCount struct { - // JoinedDirectHumanUserCount: Count of human users that have directly joined - // the space, not counting users joined by having membership in a joined group. + // JoinedDirectHumanUserCount: Output only. Count of human users that have + // directly joined the space, not counting users joined by having membership in + // a joined group. JoinedDirectHumanUserCount int64 `json:"joinedDirectHumanUserCount,omitempty"` - // JoinedGroupCount: Count of all groups that have directly joined the space. + // JoinedGroupCount: Output only. Count of all groups that have directly joined + // the space. JoinedGroupCount int64 `json:"joinedGroupCount,omitempty"` // ForceSendFields is a list of field names (e.g. "JoinedDirectHumanUserCount") // to unconditionally include in API requests. By default, fields with empty or @@ -4239,10 +4241,11 @@ func (s MembershipUpdatedEventData) MarshalJSON() ([]byte, error) { // Message: A message in a Google Chat space. type Message struct { - // AccessoryWidgets: One or more interactive widgets that appear at the bottom - // of a message. You can add accessory widgets to messages that contain text, - // cards, or both text and cards. Not supported for messages that contain - // dialogs. For details, see Add interactive widgets at the bottom of a message + // AccessoryWidgets: Optional. One or more interactive widgets that appear at + // the bottom of a message. You can add accessory widgets to messages that + // contain text, cards, or both text and cards. Not supported for messages that + // contain dialogs. For details, see Add interactive widgets at the bottom of a + // message // (https://developers.google.com/workspace/chat/create-messages#add-accessory-widgets). // Creating a message with accessory widgets requires [app authentication] // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). @@ -4258,7 +4261,7 @@ type Message struct { ArgumentText string `json:"argumentText,omitempty"` // AttachedGifs: Output only. GIF images that are attached to the message. AttachedGifs []*AttachedGif `json:"attachedGifs,omitempty"` - // Attachment: User-uploaded attachment. + // Attachment: Optional. User-uploaded attachment. Attachment []*Attachment `json:"attachment,omitempty"` // Cards: Deprecated: Use `cards_v2` instead. Rich, formatted, and interactive // cards that you can use to display UI elements such as: formatted texts, @@ -4266,7 +4269,7 @@ type Message struct { // plain-text body of the message. `cards` and `cards_v2` can have a maximum // size of 32 KB. Cards []*Card `json:"cards,omitempty"` - // CardsV2: An array of cards + // CardsV2: Optional. An array of cards // (https://developers.google.com/workspace/chat/api/reference/rest/v1/cards). // Only Chat apps can create cards. If your Chat app authenticates as a user // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), @@ -4275,9 +4278,9 @@ type Message struct { // (https://developers.google.com/workspace/chat/create-messages). Card builder // (https://addons.gsuite.google.com/uikit/builder) CardsV2 []*CardWithId `json:"cardsV2,omitempty"` - // ClientAssignedMessageId: Optional. A custom ID for the message. You can use - // field to identify a message, or to get, delete, or update a message. To set - // a custom ID, specify the `messageId` + // ClientAssignedMessageId: Optional. Optional. A custom ID for the message. + // You can use field to identify a message, or to get, delete, or update a + // message. To set a custom ID, specify the `messageId` // (https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages/create#body.QUERY_PARAMETERS.message_id) // field when you create the message. For details, see Name a message // (https://developers.google.com/workspace/chat/create-messages#name_a_created_message). @@ -4297,8 +4300,9 @@ type Message struct { // EmojiReactionSummaries: Output only. The list of emoji reaction summaries on // the message. EmojiReactionSummaries []*EmojiReactionSummary `json:"emojiReactionSummaries,omitempty"` - // FallbackText: A plain-text description of the message's cards, used when the - // actual cards can't be displayed—for example, mobile notifications. + // FallbackText: Optional. A plain-text description of the message's cards, + // used when the actual cards can't be displayed—for example, mobile + // notifications. FallbackText string `json:"fallbackText,omitempty"` // FormattedText: Output only. Contains the message `text` with markups added // to communicate formatting. This field might not capture all formatting @@ -4322,7 +4326,7 @@ type Message struct { // preview pattern. For more information, see Preview links // (https://developers.google.com/workspace/chat/preview-links). MatchedUrl *MatchedUrl `json:"matchedUrl,omitempty"` - // Name: Resource name of the message. Format: + // Name: Identifier. Resource name of the message. Format: // `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space // where the message is posted and `{message}` is a system-assigned ID for the // message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. @@ -4333,10 +4337,10 @@ type Message struct { // message // (https://developers.google.com/workspace/chat/create-messages#name_a_created_message). Name string `json:"name,omitempty"` - // PrivateMessageViewer: Immutable. Input for creating a message, otherwise - // output only. The user that can view the message. When set, the message is - // private and only visible to the specified user and the Chat app. To include - // this field in your request, you must call the Chat API using app + // PrivateMessageViewer: Optional. Immutable. Input for creating a message, + // otherwise output only. The user that can view the message. When set, the + // message is private and only visible to the specified user and the Chat app. + // To include this field in your request, you must call the Chat API using app // authentication // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) // and omit the following: * Attachments @@ -4359,14 +4363,14 @@ type Message struct { Sender *User `json:"sender,omitempty"` // SlashCommand: Output only. Slash command information, if applicable. SlashCommand *SlashCommand `json:"slashCommand,omitempty"` - // Space: If your Chat app authenticates as a user + // Space: Output only. If your Chat app authenticates as a user // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), - // the output populates the space + // the output only populates the space // (https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces) // `name`. Space *Space `json:"space,omitempty"` - // Text: Plain-text body of the message. The first link to an image, video, or - // web page generates a preview chip + // Text: Optional. Plain-text body of the message. The first link to an image, + // video, or web page generates a preview chip // (https://developers.google.com/workspace/chat/preview-links). You can also // @mention a Google Chat user // (https://developers.google.com/workspace/chat/format-messages#messages-@mention), @@ -4591,9 +4595,9 @@ func (s OpenLink) MarshalJSON() ([]byte, error) { // PermissionSetting: Represents a space permission setting. type PermissionSetting struct { - // ManagersAllowed: Whether spaces managers have this permission. + // ManagersAllowed: Optional. Whether spaces managers have this permission. ManagersAllowed bool `json:"managersAllowed,omitempty"` - // MembersAllowed: Whether non-manager members have this permission. + // MembersAllowed: Optional. Whether non-manager members have this permission. MembersAllowed bool `json:"membersAllowed,omitempty"` // ForceSendFields is a list of field names (e.g. "ManagersAllowed") to // unconditionally include in API requests. By default, fields with empty or @@ -4618,22 +4622,23 @@ func (s PermissionSetting) MarshalJSON() ([]byte, error) { // updating an existing named space. To set permission settings when creating a // space, specify the `PredefinedPermissionSettings` field in your request. type PermissionSettings struct { - // ManageApps: Setting for managing apps in a space. + // ManageApps: Optional. Setting for managing apps in a space. ManageApps *PermissionSetting `json:"manageApps,omitempty"` - // ManageMembersAndGroups: Setting for managing members and groups in a space. + // ManageMembersAndGroups: Optional. Setting for managing members and groups in + // a space. ManageMembersAndGroups *PermissionSetting `json:"manageMembersAndGroups,omitempty"` - // ManageWebhooks: Setting for managing webhooks in a space. + // ManageWebhooks: Optional. Setting for managing webhooks in a space. ManageWebhooks *PermissionSetting `json:"manageWebhooks,omitempty"` - // ModifySpaceDetails: Setting for updating space name, avatar, description and - // guidelines. + // ModifySpaceDetails: Optional. Setting for updating space name, avatar, + // description and guidelines. ModifySpaceDetails *PermissionSetting `json:"modifySpaceDetails,omitempty"` // PostMessages: Output only. Setting for posting messages in a space. PostMessages *PermissionSetting `json:"postMessages,omitempty"` - // ReplyMessages: Setting for replying to messages in a space. + // ReplyMessages: Optional. Setting for replying to messages in a space. ReplyMessages *PermissionSetting `json:"replyMessages,omitempty"` - // ToggleHistory: Setting for toggling space history on and off. + // ToggleHistory: Optional. Setting for toggling space history on and off. ToggleHistory *PermissionSetting `json:"toggleHistory,omitempty"` - // UseAtMentionAll: Setting for using @all in a space. + // UseAtMentionAll: Optional. Setting for using @all in a space. UseAtMentionAll *PermissionSetting `json:"useAtMentionAll,omitempty"` // ForceSendFields is a list of field names (e.g. "ManageApps") to // unconditionally include in API requests. By default, fields with empty or @@ -5060,7 +5065,8 @@ type Space struct { // the original creation time. Only populated in the output when `spaceType` is // `GROUP_CHAT` or `SPACE`. CreateTime string `json:"createTime,omitempty"` - // DisplayName: The space's display name. Required when creating a space + // DisplayName: Optional. The space's display name. Required when creating a + // space // (https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) // with a `spaceType` of `SPACE`. If you receive the error message // `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a @@ -5068,12 +5074,13 @@ type Space struct { // organization might already use this display name. For direct messages, this // field might be empty. Supports up to 128 characters. DisplayName string `json:"displayName,omitempty"` - // ExternalUserAllowed: Immutable. Whether this space permits any Google Chat - // user as a member. Input when creating a space in a Google Workspace - // organization. Omit this field when creating spaces in the following - // conditions: * The authenticated user uses a consumer account (unmanaged user - // account). By default, a space created by a consumer account permits any - // Google Chat user. For existing spaces, this field is output only. + // ExternalUserAllowed: Optional. Immutable. Whether this space permits any + // Google Chat user as a member. Input when creating a space in a Google + // Workspace organization. Omit this field when creating spaces in the + // following conditions: * The authenticated user uses a consumer account + // (unmanaged user account). By default, a space created by a consumer account + // permits any Google Chat user. For existing spaces, this field is output + // only. ExternalUserAllowed bool `json:"externalUserAllowed,omitempty"` // ImportMode: Optional. Whether this space is created in `Import Mode` as part // of a data migration into Google Workspace. While spaces are being imported, @@ -5087,9 +5094,9 @@ type Space struct { // member type. Populated when the `space_type` is `SPACE`, `DIRECT_MESSAGE` or // `GROUP_CHAT`. MembershipCount *MembershipCount `json:"membershipCount,omitempty"` - // Name: Resource name of the space. Format: `spaces/{space}` Where `{space}` - // represents the system-assigned ID for the space. You can obtain the space ID - // by calling the `spaces.list()` + // Name: Identifier. Resource name of the space. Format: `spaces/{space}` Where + // `{space}` represents the system-assigned ID for the space. You can obtain + // the space ID by calling the `spaces.list()` // (https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/list) // method or from the space URL. For example, if the space URL is // `https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA`, the space ID is @@ -5114,10 +5121,11 @@ type Space struct { // SingleUserBotDm: Optional. Whether the space is a DM between a Chat app and // a single human. SingleUserBotDm bool `json:"singleUserBotDm,omitempty"` - // SpaceDetails: Details about the space including description and rules. + // SpaceDetails: Optional. Details about the space including description and + // rules. SpaceDetails *SpaceDetails `json:"spaceDetails,omitempty"` - // SpaceHistoryState: The message history state for messages and threads in - // this space. + // SpaceHistoryState: Optional. The message history state for messages and + // threads in this space. // // Possible values: // "HISTORY_STATE_UNSPECIFIED" - Default value. Do not use. @@ -5139,8 +5147,8 @@ type Space struct { // "UNTHREADED_MESSAGES" - Direct messages (DMs) between two people and group // conversations between 3 or more people. SpaceThreadingState string `json:"spaceThreadingState,omitempty"` - // SpaceType: The type of space. Required when creating a space or updating the - // space type of a space. Output only for other usage. + // SpaceType: Optional. The type of space. Required when creating a space or + // updating the space type of a space. Output only for other usage. // // Possible values: // "SPACE_TYPE_UNSPECIFIED" - Reserved. @@ -5549,7 +5557,7 @@ func (s TextParagraph) MarshalJSON() ([]byte, error) { // (https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages/create#messagereplyoption) // field to determine what happens if no matching thread is found. type Thread struct { - // Name: Resource name of the thread. Example: + // Name: Identifier. Resource name of the thread. Example: // `spaces/{space}/threads/{thread}` Name string `json:"name,omitempty"` // ThreadKey: Optional. Input for creating or updating a thread. Otherwise, @@ -6951,9 +6959,9 @@ type SpacesPatchCall struct { // You can authenticate and authorize this method with administrator privileges // by setting the `use_admin_access` field in the request. // -// - name: Resource name of the space. Format: `spaces/{space}` Where `{space}` -// represents the system-assigned ID for the space. You can obtain the space -// ID by calling the `spaces.list()` +// - name: Identifier. Resource name of the space. Format: `spaces/{space}` +// Where `{space}` represents the system-assigned ID for the space. You can +// obtain the space ID by calling the `spaces.list()` // (https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/list) // method or from the space URL. For example, if the space URL is // `https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA`, the space ID is @@ -8863,7 +8871,7 @@ type SpacesMessagesPatchCall struct { // When using app authentication, requests can only update messages created by // the calling Chat app. // -// - name: Resource name of the message. Format: +// - name: Identifier. Resource name of the message. Format: // `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space // where the message is posted and `{message}` is a system-assigned ID for // the message. For example, @@ -9009,7 +9017,7 @@ type SpacesMessagesUpdateCall struct { // When using app authentication, requests can only update messages created by // the calling Chat app. // -// - name: Resource name of the message. Format: +// - name: Identifier. Resource name of the message. Format: // `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space // where the message is posted and `{message}` is a system-assigned ID for // the message. For example, diff --git a/container/v1/container-api.json b/container/v1/container-api.json index 9c16cd53c47..82c83c8c627 100644 --- a/container/v1/container-api.json +++ b/container/v1/container-api.json @@ -2540,7 +2540,7 @@ } } }, - "revision": "20241017", + "revision": "20241024", "rootUrl": "https://container.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -3747,6 +3747,10 @@ "$ref": "NodeKubeletConfig", "description": "The desired node kubelet config for all auto-provisioned node pools in autopilot clusters and node auto-provisioning enabled clusters." }, + "desiredNodePoolAutoConfigLinuxNodeConfig": { + "$ref": "LinuxNodeConfig", + "description": "The desired Linux node config for all auto-provisioned node pools in autopilot clusters and node auto-provisioning enabled clusters. Currently only `cgroup_mode` can be set here." + }, "desiredNodePoolAutoConfigNetworkTags": { "$ref": "NetworkTags", "description": "The desired network tags that apply to all auto-provisioned node pools in autopilot clusters and node auto-provisioning enabled clusters." @@ -5631,6 +5635,20 @@ "format": "int32", "type": "integer" }, + "localSsdEncryptionMode": { + "description": "Specifies which method should be used for encrypting the Local SSDs attahced to the node.", + "enum": [ + "LOCAL_SSD_ENCRYPTION_MODE_UNSPECIFIED", + "STANDARD_ENCRYPTION", + "EPHEMERAL_KEY_ENCRYPTION" + ], + "enumDescriptions": [ + "The given node will be encrypted using keys managed by Google infrastructure and the keys will be deleted when the node is deleted.", + "The given node will be encrypted using keys managed by Google infrastructure and the keys will be deleted when the node is deleted.", + "The given node will opt-in for using ephemeral key for encryption of Local SSDs. The Local SSDs will not be able to recover data in case of node crash." + ], + "type": "string" + }, "loggingConfig": { "$ref": "NodePoolLoggingConfig", "description": "Logging configuration." @@ -6009,6 +6027,11 @@ "description": "Node pool configs that apply to all auto-provisioned node pools in autopilot clusters and node auto-provisioning enabled clusters.", "id": "NodePoolAutoConfig", "properties": { + "linuxNodeConfig": { + "$ref": "LinuxNodeConfig", + "description": "Output only. Configuration options for Linux nodes.", + "readOnly": true + }, "networkTags": { "$ref": "NetworkTags", "description": "The list of instance tags applied to all nodes. Tags are used to identify valid sources or targets for network firewalls and are specified by the client during cluster creation. Each tag within the list must comply with RFC1035." @@ -6051,22 +6074,22 @@ "type": "string" }, "maxNodeCount": { - "description": "Maximum number of nodes for one location in the NodePool. Must be \u003e= min_node_count. There has to be enough quota to scale up the cluster.", + "description": "Maximum number of nodes for one location in the node pool. Must be \u003e= min_node_count. There has to be enough quota to scale up the cluster.", "format": "int32", "type": "integer" }, "minNodeCount": { - "description": "Minimum number of nodes for one location in the NodePool. Must be \u003e= 1 and \u003c= max_node_count.", + "description": "Minimum number of nodes for one location in the node pool. Must be greater than or equal to 0 and less than or equal to max_node_count.", "format": "int32", "type": "integer" }, "totalMaxNodeCount": { - "description": "Maximum number of nodes in the node pool. Must be greater than total_min_node_count. There has to be enough quota to scale up the cluster. The total_*_node_count fields are mutually exclusive with the *_node_count fields.", + "description": "Maximum number of nodes in the node pool. Must be greater than or equal to total_min_node_count. There has to be enough quota to scale up the cluster. The total_*_node_count fields are mutually exclusive with the *_node_count fields.", "format": "int32", "type": "integer" }, "totalMinNodeCount": { - "description": "Minimum number of nodes in the node pool. Must be greater than 1 less than total_max_node_count. The total_*_node_count fields are mutually exclusive with the *_node_count fields.", + "description": "Minimum number of nodes in the node pool. Must be greater than or equal to 0 and less than or equal to total_max_node_count. The total_*_node_count fields are mutually exclusive with the *_node_count fields.", "format": "int32", "type": "integer" } @@ -7974,6 +7997,76 @@ }, "type": "object" }, + "UpgradeInfoEvent": { + "description": "UpgradeInfoEvent is a notification sent to customers about the upgrade information of a resource.", + "id": "UpgradeInfoEvent", + "properties": { + "currentVersion": { + "description": "The current version before the upgrade.", + "type": "string" + }, + "description": { + "description": "A brief description of the event.", + "type": "string" + }, + "endTime": { + "description": "The time when the operation ended.", + "format": "google-datetime", + "type": "string" + }, + "operation": { + "description": "The operation associated with this upgrade.", + "type": "string" + }, + "resource": { + "description": "Optional relative path to the resource. For example in node pool upgrades, the relative path of the node pool.", + "type": "string" + }, + "resourceType": { + "description": "The resource type associated with the upgrade.", + "enum": [ + "UPGRADE_RESOURCE_TYPE_UNSPECIFIED", + "MASTER", + "NODE_POOL" + ], + "enumDescriptions": [ + "Default value. This shouldn't be used.", + "Master / control plane", + "Node pool" + ], + "type": "string" + }, + "startTime": { + "description": "The time when the operation was started.", + "format": "google-datetime", + "type": "string" + }, + "state": { + "description": "Output only. The state of the upgrade.", + "enum": [ + "STATE_UNSPECIFIED", + "STARTED", + "SUCCEEDED", + "FAILED", + "CANCELED" + ], + "enumDescriptions": [ + "STATE_UNSPECIFIED indicates the state is unspecified.", + "STARTED indicates the upgrade has started.", + "SUCCEEDED indicates the upgrade has completed successfully.", + "FAILED indicates the upgrade has failed.", + "CANCELED indicates the upgrade has canceled." + ], + "readOnly": true, + "type": "string" + }, + "targetVersion": { + "description": "The target version for the upgrade.", + "type": "string" + } + }, + "type": "object" + }, "UpgradeSettings": { "description": "These upgrade settings control the level of parallelism and the level of disruption caused by an upgrade. maxUnavailable controls the number of nodes that can be simultaneously unavailable. maxSurge controls the number of additional nodes that can be added to the node pool temporarily for the time of the upgrade to increase the number of available nodes. (maxUnavailable + maxSurge) determines the level of parallelism (how many nodes are being upgraded at the same time). Note: upgrades inevitably introduce some disruption since workloads need to be moved from old nodes to new, upgraded ones. Even if maxUnavailable=0, this holds true. (Disruption stays within the limits of PodDisruptionBudget, if it is configured.) Consider a hypothetical node pool with 5 nodes having maxSurge=2, maxUnavailable=1. This means the upgrade process upgrades 3 nodes simultaneously. It creates 2 additional (upgraded) nodes, then it brings down 3 old (not yet upgraded) nodes at the same time. This ensures that there are always at least 4 nodes available. These upgrade settings configure the upgrade strategy for the node pool. Use strategy to switch between the strategies applied to the node pool. If the strategy is ROLLING, use max_surge and max_unavailable to control the level of parallelism and the level of disruption caused by upgrade. 1. maxSurge controls the number of additional nodes that can be added to the node pool temporarily for the time of the upgrade to increase the number of available nodes. 2. maxUnavailable controls the number of nodes that can be simultaneously unavailable. 3. (maxUnavailable + maxSurge) determines the level of parallelism (how many nodes are being upgraded at the same time). If the strategy is BLUE_GREEN, use blue_green_settings to configure the blue-green upgrade related settings. 1. standard_rollout_policy is the default policy. The policy is used to control the way blue pool gets drained. The draining is executed in the batch mode. The batch size could be specified as either percentage of the node pool size or the number of nodes. batch_soak_duration is the soak time after each batch gets drained. 2. node_pool_soak_duration is the soak time after all blue nodes are drained. After this period, the blue pool nodes will be deleted.", "id": "UpgradeSettings", diff --git a/container/v1/container-gen.go b/container/v1/container-gen.go index 15ff073bb8d..c0e1f81665a 100644 --- a/container/v1/container-gen.go +++ b/container/v1/container-gen.go @@ -1594,6 +1594,11 @@ type ClusterUpdate struct { // all auto-provisioned node pools in autopilot clusters and node // auto-provisioning enabled clusters. DesiredNodePoolAutoConfigKubeletConfig *NodeKubeletConfig `json:"desiredNodePoolAutoConfigKubeletConfig,omitempty"` + // DesiredNodePoolAutoConfigLinuxNodeConfig: The desired Linux node config for + // all auto-provisioned node pools in autopilot clusters and node + // auto-provisioning enabled clusters. Currently only `cgroup_mode` can be set + // here. + DesiredNodePoolAutoConfigLinuxNodeConfig *LinuxNodeConfig `json:"desiredNodePoolAutoConfigLinuxNodeConfig,omitempty"` // DesiredNodePoolAutoConfigNetworkTags: The desired network tags that apply to // all auto-provisioned node pools in autopilot clusters and node // auto-provisioning enabled clusters. @@ -4153,6 +4158,20 @@ type NodeConfig struct { // on a machine per zone. See: // https://cloud.google.com/compute/docs/disks/local-ssd for more information. LocalSsdCount int64 `json:"localSsdCount,omitempty"` + // LocalSsdEncryptionMode: Specifies which method should be used for encrypting + // the Local SSDs attahced to the node. + // + // Possible values: + // "LOCAL_SSD_ENCRYPTION_MODE_UNSPECIFIED" - The given node will be encrypted + // using keys managed by Google infrastructure and the keys will be deleted + // when the node is deleted. + // "STANDARD_ENCRYPTION" - The given node will be encrypted using keys + // managed by Google infrastructure and the keys will be deleted when the node + // is deleted. + // "EPHEMERAL_KEY_ENCRYPTION" - The given node will opt-in for using + // ephemeral key for encryption of Local SSDs. The Local SSDs will not be able + // to recover data in case of node crash. + LocalSsdEncryptionMode string `json:"localSsdEncryptionMode,omitempty"` // LoggingConfig: Logging configuration. LoggingConfig *NodePoolLoggingConfig `json:"loggingConfig,omitempty"` // MachineType: The name of a Google Compute Engine machine type @@ -4598,6 +4617,8 @@ func (s NodePool) MarshalJSON() ([]byte, error) { // node pools in autopilot clusters and node auto-provisioning enabled // clusters. type NodePoolAutoConfig struct { + // LinuxNodeConfig: Output only. Configuration options for Linux nodes. + LinuxNodeConfig *LinuxNodeConfig `json:"linuxNodeConfig,omitempty"` // NetworkTags: The list of instance tags applied to all nodes. Tags are used // to identify valid sources or targets for network firewalls and are specified // by the client during cluster creation. Each tag within the list must comply @@ -4611,15 +4632,15 @@ type NodePoolAutoConfig struct { // the nodes for managing Compute Engine firewalls using Network Firewall // Policies. ResourceManagerTags *ResourceManagerTags `json:"resourceManagerTags,omitempty"` - // ForceSendFields is a list of field names (e.g. "NetworkTags") to + // ForceSendFields is a list of field names (e.g. "LinuxNodeConfig") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "NetworkTags") 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. "LinuxNodeConfig") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -4645,20 +4666,22 @@ type NodePoolAutoscaling struct { // sizes of different zones. // "ANY" - ANY policy picks zones that have the highest capacity available. LocationPolicy string `json:"locationPolicy,omitempty"` - // MaxNodeCount: Maximum number of nodes for one location in the NodePool. Must - // be >= min_node_count. There has to be enough quota to scale up the cluster. + // MaxNodeCount: Maximum number of nodes for one location in the node pool. + // Must be >= min_node_count. There has to be enough quota to scale up the + // cluster. MaxNodeCount int64 `json:"maxNodeCount,omitempty"` - // MinNodeCount: Minimum number of nodes for one location in the NodePool. Must - // be >= 1 and <= max_node_count. + // MinNodeCount: Minimum number of nodes for one location in the node pool. + // Must be greater than or equal to 0 and less than or equal to max_node_count. MinNodeCount int64 `json:"minNodeCount,omitempty"` // TotalMaxNodeCount: Maximum number of nodes in the node pool. Must be greater - // than total_min_node_count. There has to be enough quota to scale up the - // cluster. The total_*_node_count fields are mutually exclusive with the - // *_node_count fields. + // than or equal to total_min_node_count. There has to be enough quota to scale + // up the cluster. The total_*_node_count fields are mutually exclusive with + // the *_node_count fields. TotalMaxNodeCount int64 `json:"totalMaxNodeCount,omitempty"` // TotalMinNodeCount: Minimum number of nodes in the node pool. Must be greater - // than 1 less than total_max_node_count. The total_*_node_count fields are - // mutually exclusive with the *_node_count fields. + // than or equal to 0 and less than or equal to total_max_node_count. The + // total_*_node_count fields are mutually exclusive with the *_node_count + // fields. TotalMinNodeCount int64 `json:"totalMinNodeCount,omitempty"` // ForceSendFields is a list of field names (e.g. "Autoprovisioned") to // unconditionally include in API requests. By default, fields with empty or @@ -7190,6 +7213,60 @@ func (s UpgradeEvent) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// UpgradeInfoEvent: UpgradeInfoEvent is a notification sent to customers about +// the upgrade information of a resource. +type UpgradeInfoEvent struct { + // CurrentVersion: The current version before the upgrade. + CurrentVersion string `json:"currentVersion,omitempty"` + // Description: A brief description of the event. + Description string `json:"description,omitempty"` + // EndTime: The time when the operation ended. + EndTime string `json:"endTime,omitempty"` + // Operation: The operation associated with this upgrade. + Operation string `json:"operation,omitempty"` + // Resource: Optional relative path to the resource. For example in node pool + // upgrades, the relative path of the node pool. + Resource string `json:"resource,omitempty"` + // ResourceType: The resource type associated with the upgrade. + // + // Possible values: + // "UPGRADE_RESOURCE_TYPE_UNSPECIFIED" - Default value. This shouldn't be + // used. + // "MASTER" - Master / control plane + // "NODE_POOL" - Node pool + ResourceType string `json:"resourceType,omitempty"` + // StartTime: The time when the operation was started. + StartTime string `json:"startTime,omitempty"` + // State: Output only. The state of the upgrade. + // + // Possible values: + // "STATE_UNSPECIFIED" - STATE_UNSPECIFIED indicates the state is + // unspecified. + // "STARTED" - STARTED indicates the upgrade has started. + // "SUCCEEDED" - SUCCEEDED indicates the upgrade has completed successfully. + // "FAILED" - FAILED indicates the upgrade has failed. + // "CANCELED" - CANCELED indicates the upgrade has canceled. + State string `json:"state,omitempty"` + // TargetVersion: The target version for the upgrade. + TargetVersion string `json:"targetVersion,omitempty"` + // ForceSendFields is a list of field names (e.g. "CurrentVersion") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CurrentVersion") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s UpgradeInfoEvent) MarshalJSON() ([]byte, error) { + type NoMethod UpgradeInfoEvent + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // UpgradeSettings: These upgrade settings control the level of parallelism and // the level of disruption caused by an upgrade. maxUnavailable controls the // number of nodes that can be simultaneously unavailable. maxSurge controls diff --git a/dataplex/v1/dataplex-api.json b/dataplex/v1/dataplex-api.json index 5a82a3c5422..faca4745fa3 100644 --- a/dataplex/v1/dataplex-api.json +++ b/dataplex/v1/dataplex-api.json @@ -6224,7 +6224,7 @@ } } }, - "revision": "20241019", + "revision": "20241027", "rootUrl": "https://dataplex.googleapis.com/", "schemas": { "Empty": { @@ -8534,7 +8534,7 @@ "type": "object" }, "GoogleCloudDataplexV1DataScanEvent": { - "description": "These messages contain information about the execution of a datascan. The monitored resource is 'DataScan' Next ID: 13", + "description": "These messages contain information about the execution of a datascan. The monitored resource is 'DataScan'", "id": "GoogleCloudDataplexV1DataScanEvent", "properties": { "createTime": { @@ -8641,12 +8641,14 @@ "enum": [ "SCAN_TYPE_UNSPECIFIED", "DATA_PROFILE", - "DATA_QUALITY" + "DATA_QUALITY", + "DATA_DISCOVERY" ], "enumDescriptions": [ "An unspecified data scan type.", "Data scan for data profile.", - "Data scan for data quality." + "Data scan for data quality.", + "Data scan for data discovery." ], "type": "string" } @@ -9059,7 +9061,11 @@ "ENTITY_DELETED", "PARTITION_CREATED", "PARTITION_UPDATED", - "PARTITION_DELETED" + "PARTITION_DELETED", + "TABLE_PUBLISHED", + "TABLE_UPDATED", + "TABLE_IGNORED", + "TABLE_DELETED" ], "enumDescriptions": [ "An unspecified event type.", @@ -9069,7 +9075,11 @@ "An event representing a metadata entity being deleted.", "An event representing a partition being created.", "An event representing a partition being updated.", - "An event representing a partition being deleted." + "An event representing a partition being deleted.", + "An event representing a table being published.", + "An event representing a table being updated.", + "An event representing a table being skipped in publishing.", + "An event representing a table being deleted." ], "type": "string" }, diff --git a/dataplex/v1/dataplex-gen.go b/dataplex/v1/dataplex-gen.go index 5f5c01cb07f..f1862c4552d 100644 --- a/dataplex/v1/dataplex-gen.go +++ b/dataplex/v1/dataplex-gen.go @@ -3539,8 +3539,7 @@ func (s GoogleCloudDataplexV1DataScan) MarshalJSON() ([]byte, error) { } // GoogleCloudDataplexV1DataScanEvent: These messages contain information about -// the execution of a datascan. The monitored resource is 'DataScan' Next ID: -// 13 +// the execution of a datascan. The monitored resource is 'DataScan' type GoogleCloudDataplexV1DataScanEvent struct { // CreateTime: The time when the data scan job was created. CreateTime string `json:"createTime,omitempty"` @@ -3597,6 +3596,7 @@ type GoogleCloudDataplexV1DataScanEvent struct { // "SCAN_TYPE_UNSPECIFIED" - An unspecified data scan type. // "DATA_PROFILE" - Data scan for data profile. // "DATA_QUALITY" - Data scan for data quality. + // "DATA_DISCOVERY" - Data scan for data discovery. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "CreateTime") to // unconditionally include in API requests. By default, fields with empty or @@ -4082,6 +4082,11 @@ type GoogleCloudDataplexV1DiscoveryEvent struct { // "PARTITION_CREATED" - An event representing a partition being created. // "PARTITION_UPDATED" - An event representing a partition being updated. // "PARTITION_DELETED" - An event representing a partition being deleted. + // "TABLE_PUBLISHED" - An event representing a table being published. + // "TABLE_UPDATED" - An event representing a table being updated. + // "TABLE_IGNORED" - An event representing a table being skipped in + // publishing. + // "TABLE_DELETED" - An event representing a table being deleted. Type string `json:"type,omitempty"` // ZoneId: The id of the associated zone. ZoneId string `json:"zoneId,omitempty"` diff --git a/deploymentmanager/v0.alpha/deploymentmanager-api.json b/deploymentmanager/v0.alpha/deploymentmanager-api.json index 24162c3b34d..45f006258d3 100644 --- a/deploymentmanager/v0.alpha/deploymentmanager-api.json +++ b/deploymentmanager/v0.alpha/deploymentmanager-api.json @@ -132,6 +132,10 @@ "required": true, "type": "string" }, + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "The project ID for this request.", "location": "path", @@ -166,6 +170,10 @@ "required": true, "type": "string" }, + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "The project ID for this request.", "location": "path", @@ -194,6 +202,10 @@ "project" ], "parameters": { + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "The project ID for this request.", "location": "path", @@ -282,6 +294,10 @@ "required": true, "type": "string" }, + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "The project ID for this request.", "location": "path", @@ -319,6 +335,10 @@ "required": true, "type": "string" }, + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "The project ID for this request.", "location": "path", @@ -410,6 +430,10 @@ "required": true, "type": "string" }, + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "The project ID for this request.", "location": "path", @@ -444,6 +468,10 @@ "required": true, "type": "string" }, + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "The project ID for this request.", "location": "path", @@ -473,6 +501,10 @@ "resource" ], "parameters": { + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "optionsRequestedPolicyVersion": { "description": "Requested IAM Policy version.", "format": "int32", @@ -528,6 +560,10 @@ "location": "query", "type": "string" }, + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "preview": { "description": "If set to true, creates a deployment and creates \"shell\" resources but does not actually instantiate these resources. This allows you to preview what your deployment looks like. After previewing a deployment, you can deploy your resources by making a request with the `update()` method or you can use the `cancelPreview()` method to cancel the preview altogether. Note that the deployment will still exist after you cancel the preview and you must separately delete this deployment if you want to remove it.", "location": "query", @@ -651,6 +687,10 @@ "required": true, "type": "string" }, + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "preview": { "default": "false", "description": "If set to true, updates the deployment and creates and updates the \"shell\" resources but does not actually alter or instantiate these resources. This allows you to preview what your deployment will look like. You can use this intent to preview how an update would affect your deployment. You must provide a `target.config` with a configuration if this is set to true. After previewing a deployment, you can deploy your resources by making a request with the `update()` or you can `cancelPreview()` to remove the preview altogether. Note that the deployment will still exist after you cancel the preview and you must separately delete this deployment if you want to remove it.", @@ -761,6 +801,10 @@ "resource" ], "parameters": { + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "Project ID for this request.", "location": "path", @@ -835,6 +879,10 @@ "required": true, "type": "string" }, + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "preview": { "default": "false", "description": "If set to true, updates the deployment and creates and updates the \"shell\" resources but does not actually alter or instantiate these resources. This allows you to preview what your deployment will look like. You can use this intent to preview how an update would affect your deployment. You must provide a `target.config` with a configuration if this is set to true. After previewing a deployment, you can deploy your resources by making a request with the `update()` or you can `cancelPreview()` to remove the preview altogether. Note that the deployment will still exist after you cancel the preview and you must separately delete this deployment if you want to remove it.", @@ -883,6 +931,10 @@ "required": true, "type": "string" }, + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "manifest": { "description": "The name of the manifest for this request.", "location": "path", @@ -982,6 +1034,10 @@ "operation" ], "parameters": { + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "operation": { "description": "The name of the operation for this request.", "location": "path", @@ -1080,6 +1136,10 @@ "required": true, "type": "string" }, + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "The project ID for this request.", "location": "path", @@ -1178,6 +1238,10 @@ "typeProvider" ], "parameters": { + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "The project ID for this request.", "location": "path", @@ -1212,6 +1276,10 @@ "typeProvider" ], "parameters": { + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "The project ID for this request.", "location": "path", @@ -1249,6 +1317,10 @@ "type" ], "parameters": { + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "The project ID for this request.", "location": "path", @@ -1290,6 +1362,10 @@ "project" ], "parameters": { + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "The project ID for this request.", "location": "path", @@ -1430,6 +1506,10 @@ "typeProvider" ], "parameters": { + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "The project ID for this request.", "location": "path", @@ -1467,6 +1547,10 @@ "typeProvider" ], "parameters": { + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "The project ID for this request.", "location": "path", @@ -1508,6 +1592,10 @@ "type" ], "parameters": { + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "The project ID for this request.", "location": "path", @@ -1588,7 +1676,7 @@ } } }, - "revision": "20240214", + "revision": "20241031", "rootUrl": "https://deploymentmanager.googleapis.com/", "schemas": { "AsyncOptions": { @@ -1895,6 +1983,24 @@ }, "type": "object" }, + "DebugInfo": { + "description": "Describes additional debugging info.", + "id": "DebugInfo", + "properties": { + "detail": { + "description": "Additional debugging information provided by the server.", + "type": "string" + }, + "stackEntries": { + "description": "The stack trace entries indicating where the error occurred.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "Deployment": { "id": "Deployment", "properties": { @@ -2100,6 +2206,28 @@ }, "type": "object" }, + "ErrorInfo": { + "description": "Describes the cause of the error with structured details. Example of an error when contacting the \"pubsub.googleapis.com\" API when it is not enabled: { \"reason\": \"API_DISABLED\" \"domain\": \"googleapis.com\" \"metadata\": { \"resource\": \"projects/123\", \"service\": \"pubsub.googleapis.com\" } } This response indicates that the pubsub.googleapis.com API is not enabled. Example of an error that is returned when attempting to create a Spanner instance in a region that is out of stock: { \"reason\": \"STOCKOUT\" \"domain\": \"spanner.googleapis.com\", \"metadata\": { \"availableRegions\": \"us-central1,us-east2\" } }", + "id": "ErrorInfo", + "properties": { + "domain": { + "description": "The logical grouping to which the \"reason\" belongs. The error domain is typically the registered service name of the tool or product that generates the error. Example: \"pubsub.googleapis.com\". If the error is generated by some common infrastructure, the error domain must be a globally unique value that identifies the infrastructure. For Google API infrastructure, the error domain is \"googleapis.com\".", + "type": "string" + }, + "metadata": { + "additionalProperties": { + "type": "string" + }, + "description": "Additional structured details about this error. Keys must match /a-z+/ but should ideally be lowerCamelCase. Also they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than {\"instanceLimit\": \"100/request\"}, should be returned as, {\"instanceLimitPerRequest\": \"100\"}, if the client exceeds the number of instances that can be created in a single (batch) request.", + "type": "object" + }, + "reason": { + "description": "The reason of the error. This is a constant value that identifies the proximate cause of the error. Error reasons are unique within a particular domain of errors. This should be at most 63 characters and match a regular expression of `A-Z+[A-Z0-9]`, which represents UPPER_SNAKE_CASE.", + "type": "string" + } + }, + "type": "object" + }, "Expr": { "description": "Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: \"Summary size limit\" description: \"Determines if a summary is less than 100 chars\" expression: \"document.summary.size() \u003c 100\" Example (Equality): title: \"Requestor is owner\" description: \"Determines if requestor is the document owner\" expression: \"document.owner == request.auth.claims.email\" Example (Logic): title: \"Public documents\" description: \"Determine whether the document should be publicly visible\" expression: \"document.type != 'private' \u0026\u0026 document.type != 'internal'\" Example (Data Manipulation): title: \"Notification string\" description: \"Create a notification string with a timestamp.\" expression: \"'New message received at ' + string(document.create_time)\" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information.", "id": "Expr", @@ -2141,6 +2269,39 @@ "policy": { "$ref": "Policy", "description": "REQUIRED: The complete policy to be applied to the 'resource'. The size of the policy is limited to a few 10s of KB. An empty policy is in general a valid policy but certain services (like Projects) might reject them." + }, + "updateMask": { + "format": "google-fieldmask", + "type": "string" + } + }, + "type": "object" + }, + "Help": { + "description": "Provides links to documentation or for performing an out of band action. For example, if a quota check failed with an error indicating the calling project hasn't enabled the accessed service, this can contain a URL pointing directly to the right place in the developer console to flip the bit.", + "id": "Help", + "properties": { + "links": { + "description": "URL(s) pointing to additional information on handling the current error.", + "items": { + "$ref": "HelpLink" + }, + "type": "array" + } + }, + "type": "object" + }, + "HelpLink": { + "description": "Describes a URL link.", + "id": "HelpLink", + "properties": { + "description": { + "description": "Describes what the link offers.", + "type": "string" + }, + "url": { + "description": "The URL of the link.", + "type": "string" } }, "type": "object" @@ -2209,6 +2370,21 @@ }, "type": "object" }, + "LocalizedMessage": { + "description": "Provides a localized error message that is safe to return to the user which can be attached to an RPC error.", + "id": "LocalizedMessage", + "properties": { + "locale": { + "description": "The locale used following the specification defined at https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: \"en-US\", \"fr-CH\", \"es-MX\"", + "type": "string" + }, + "message": { + "description": "The localized error message in the above locale.", + "type": "string" + } + }, + "type": "object" + }, "Manifest": { "id": "Manifest", "properties": { @@ -2332,10 +2508,41 @@ "description": "[Output Only] The array of errors encountered while processing this operation.", "items": { "properties": { + "arguments": { + "description": "[Output Only] Optional error details WARNING: DO NOT MAKE VISIBLE This is for internal use-only (like componentization) (thus the visibility \"none\") and in case of public exposure it is strongly recommended to follow pattern of: https://aip.dev/193 and expose as details field.", + "items": { + "type": "string" + }, + "type": "array" + }, "code": { "description": "[Output Only] The error type identifier for this error.", "type": "string" }, + "debugInfo": { + "$ref": "DebugInfo" + }, + "errorDetails": { + "description": "[Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED.", + "items": { + "properties": { + "errorInfo": { + "$ref": "ErrorInfo" + }, + "help": { + "$ref": "Help" + }, + "localizedMessage": { + "$ref": "LocalizedMessage" + }, + "quotaInfo": { + "$ref": "QuotaExceededInfo" + } + }, + "type": "object" + }, + "type": "array" + }, "location": { "description": "[Output Only] Indicates the field in the request that caused the error. This property is optional.", "type": "string" @@ -2403,6 +2610,10 @@ "description": "[Output Only] Server-defined URL for the resource.", "type": "string" }, + "selfLinkWithId": { + "description": "[Output Only] Server-defined URL for this resource with the resource id.", + "type": "string" + }, "setCommonInstanceMetadataOperationMetadata": { "$ref": "SetCommonInstanceMetadataOperationMetadata", "description": "[Output Only] If the operation is for projects.setCommonInstanceMetadata, this field will contain information on all underlying zonal actions and their state." @@ -2435,7 +2646,7 @@ "type": "string" }, "targetLink": { - "description": "[Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.", + "description": "[Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the disk that the snapshot was created from.", "type": "string" }, "user": { @@ -2466,6 +2677,10 @@ "CLEANUP_FAILED", "FIELD_VALUE_OVERRIDEN", "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "NETWORK_ENDPOINT_NOT_DETACHED", + "PAGE_MISSING_RESULTS", + "SSL_POLICY_ENABLED_FEATURES_NOT_FETCHED", + "RESOURCE_NOT_FOUND_WARNING", "MISSING_TYPE_DEPENDENCY", "EXTERNAL_API_WARNING", "SCHEMA_VALIDATION_IGNORED", @@ -2476,7 +2691,14 @@ "LARGE_DEPLOYMENT_WARNING", "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LIST_OVERHEAD_QUOTA_EXCEED" + "LIST_OVERHEAD_QUOTA_EXCEED", + "QUOTA_INFO_UNAVAILABLE", + "RESOURCE_USES_GLOBAL_DNS", + "RESERVED_ENTRY_134", + "RESERVED_ENTRY_135", + "RESERVED_ENTRY_136", + "RESERVED_ENTRY_139", + "RESERVED_ENTRY_141" ], "enumDeprecated": [ false, @@ -2506,6 +2728,17 @@ false, false, false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, false ], "enumDescriptions": [ @@ -2526,6 +2759,10 @@ "Warning about failed cleanup of transient changes made by a failed operation.", "Warning that value of a field has been overridden. Deprecated unused field.", "Warning that a resource is in use.", + "Warning that network endpoint was not detached.", + "Current page contains less results than requested but a next page token exists.", + "Warning that SSL policy resource in the response does not contain information about the list of enabled features.", + "Warning that a resource is not found.", "A resource depends on a missing type", "Warning that is present in an external api call", "When a resource schema validation is ignored.", @@ -2536,7 +2773,14 @@ "When deploying a deployment with a exceedingly large number of resources", "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter." + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "Quota information is not available to client requests (e.g: regions.list).", + "Indicates that a VM is using global DNS. Can also be used to indicate that a resource has attributes that could result in the creation of a VM that uses global DNS.", + "Reserved entries for quickly adding new warnings without breaking dependent clients.", + "", + "", + "", + "" ], "type": "string" }, @@ -2680,6 +2924,50 @@ }, "type": "object" }, + "QuotaExceededInfo": { + "description": "Additional details for quota exceeded error for resource quota.", + "id": "QuotaExceededInfo", + "properties": { + "dimensions": { + "additionalProperties": { + "type": "string" + }, + "description": "The map holding related quota dimensions.", + "type": "object" + }, + "futureLimit": { + "description": "Future quota limit being rolled out. The limit's unit depends on the quota type or metric.", + "format": "double", + "type": "number" + }, + "limit": { + "description": "Current effective quota limit. The limit's unit depends on the quota type or metric.", + "format": "double", + "type": "number" + }, + "limitName": { + "description": "The name of the quota limit.", + "type": "string" + }, + "metricName": { + "description": "The Compute Engine quota metric name.", + "type": "string" + }, + "rolloutStatus": { + "description": "Rollout status of the future quota limit.", + "enum": [ + "ROLLOUT_STATUS_UNSPECIFIED", + "IN_PROGRESS" + ], + "enumDescriptions": [ + "ROLLOUT_STATUS_UNSPECIFIED - Rollout status is not specified. The default value.", + "IN_PROGRESS - A rollout is in process which will change the limit value to future limit." + ], + "type": "string" + } + }, + "type": "object" + }, "Resource": { "id": "Resource", "properties": { @@ -2774,6 +3062,10 @@ "CLEANUP_FAILED", "FIELD_VALUE_OVERRIDEN", "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "NETWORK_ENDPOINT_NOT_DETACHED", + "PAGE_MISSING_RESULTS", + "SSL_POLICY_ENABLED_FEATURES_NOT_FETCHED", + "RESOURCE_NOT_FOUND_WARNING", "MISSING_TYPE_DEPENDENCY", "EXTERNAL_API_WARNING", "SCHEMA_VALIDATION_IGNORED", @@ -2784,7 +3076,14 @@ "LARGE_DEPLOYMENT_WARNING", "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LIST_OVERHEAD_QUOTA_EXCEED" + "LIST_OVERHEAD_QUOTA_EXCEED", + "QUOTA_INFO_UNAVAILABLE", + "RESOURCE_USES_GLOBAL_DNS", + "RESERVED_ENTRY_134", + "RESERVED_ENTRY_135", + "RESERVED_ENTRY_136", + "RESERVED_ENTRY_139", + "RESERVED_ENTRY_141" ], "enumDeprecated": [ false, @@ -2814,6 +3113,17 @@ false, false, false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, false ], "enumDescriptions": [ @@ -2834,6 +3144,10 @@ "Warning about failed cleanup of transient changes made by a failed operation.", "Warning that value of a field has been overridden. Deprecated unused field.", "Warning that a resource is in use.", + "Warning that network endpoint was not detached.", + "Current page contains less results than requested but a next page token exists.", + "Warning that SSL policy resource in the response does not contain information about the list of enabled features.", + "Warning that a resource is not found.", "A resource depends on a missing type", "Warning that is present in an external api call", "When a resource schema validation is ignored.", @@ -2844,7 +3158,14 @@ "When deploying a deployment with a exceedingly large number of resources", "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter." + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "Quota information is not available to client requests (e.g: regions.list).", + "Indicates that a VM is using global DNS. Can also be used to indicate that a resource has attributes that could result in the creation of a VM that uses global DNS.", + "Reserved entries for quickly adding new warnings without breaking dependent clients.", + "", + "", + "", + "" ], "type": "string" }, @@ -2906,10 +3227,41 @@ "description": "[Output Only] The array of errors encountered while processing this operation.", "items": { "properties": { + "arguments": { + "description": "[Output Only] Optional error details WARNING: DO NOT MAKE VISIBLE This is for internal use-only (like componentization) (thus the visibility \"none\") and in case of public exposure it is strongly recommended to follow pattern of: https://aip.dev/193 and expose as details field.", + "items": { + "type": "string" + }, + "type": "array" + }, "code": { "description": "[Output Only] The error type identifier for this error.", "type": "string" }, + "debugInfo": { + "$ref": "DebugInfo" + }, + "errorDetails": { + "description": "[Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED.", + "items": { + "properties": { + "errorInfo": { + "$ref": "ErrorInfo" + }, + "help": { + "$ref": "Help" + }, + "localizedMessage": { + "$ref": "LocalizedMessage" + }, + "quotaInfo": { + "$ref": "QuotaExceededInfo" + } + }, + "type": "object" + }, + "type": "array" + }, "location": { "description": "[Output Only] Indicates the field in the request that caused the error. This property is optional.", "type": "string" @@ -3019,6 +3371,10 @@ "CLEANUP_FAILED", "FIELD_VALUE_OVERRIDEN", "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "NETWORK_ENDPOINT_NOT_DETACHED", + "PAGE_MISSING_RESULTS", + "SSL_POLICY_ENABLED_FEATURES_NOT_FETCHED", + "RESOURCE_NOT_FOUND_WARNING", "MISSING_TYPE_DEPENDENCY", "EXTERNAL_API_WARNING", "SCHEMA_VALIDATION_IGNORED", @@ -3029,7 +3385,14 @@ "LARGE_DEPLOYMENT_WARNING", "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LIST_OVERHEAD_QUOTA_EXCEED" + "LIST_OVERHEAD_QUOTA_EXCEED", + "QUOTA_INFO_UNAVAILABLE", + "RESOURCE_USES_GLOBAL_DNS", + "RESERVED_ENTRY_134", + "RESERVED_ENTRY_135", + "RESERVED_ENTRY_136", + "RESERVED_ENTRY_139", + "RESERVED_ENTRY_141" ], "enumDeprecated": [ false, @@ -3059,6 +3422,17 @@ false, false, false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, false ], "enumDescriptions": [ @@ -3079,6 +3453,10 @@ "Warning about failed cleanup of transient changes made by a failed operation.", "Warning that value of a field has been overridden. Deprecated unused field.", "Warning that a resource is in use.", + "Warning that network endpoint was not detached.", + "Current page contains less results than requested but a next page token exists.", + "Warning that SSL policy resource in the response does not contain information about the list of enabled features.", + "Warning that a resource is not found.", "A resource depends on a missing type", "Warning that is present in an external api call", "When a resource schema validation is ignored.", @@ -3089,7 +3467,14 @@ "When deploying a deployment with a exceedingly large number of resources", "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter." + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "Quota information is not available to client requests (e.g: regions.list).", + "Indicates that a VM is using global DNS. Can also be used to indicate that a resource has attributes that could result in the creation of a VM that uses global DNS.", + "Reserved entries for quickly adding new warnings without breaking dependent clients.", + "", + "", + "", + "" ], "type": "string" }, diff --git a/deploymentmanager/v0.alpha/deploymentmanager-gen.go b/deploymentmanager/v0.alpha/deploymentmanager-gen.go index c664340a2bc..5866d5c3f29 100644 --- a/deploymentmanager/v0.alpha/deploymentmanager-gen.go +++ b/deploymentmanager/v0.alpha/deploymentmanager-gen.go @@ -725,6 +725,30 @@ func (s Credential) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// DebugInfo: Describes additional debugging info. +type DebugInfo struct { + // Detail: Additional debugging information provided by the server. + Detail string `json:"detail,omitempty"` + // StackEntries: The stack trace entries indicating where the error occurred. + StackEntries []string `json:"stackEntries,omitempty"` + // ForceSendFields is a list of field names (e.g. "Detail") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Detail") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s DebugInfo) MarshalJSON() ([]byte, error) { + type NoMethod DebugInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type Deployment struct { // Credential: User provided default credential for the deployment. Credential *Credential `json:"credential,omitempty"` @@ -1025,6 +1049,54 @@ func (s Diagnostic) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ErrorInfo: Describes the cause of the error with structured details. Example +// of an error when contacting the "pubsub.googleapis.com" API when it is not +// enabled: { "reason": "API_DISABLED" "domain": "googleapis.com" "metadata": { +// "resource": "projects/123", "service": "pubsub.googleapis.com" } } This +// response indicates that the pubsub.googleapis.com API is not enabled. +// Example of an error that is returned when attempting to create a Spanner +// instance in a region that is out of stock: { "reason": "STOCKOUT" "domain": +// "spanner.googleapis.com", "metadata": { "availableRegions": +// "us-central1,us-east2" } } +type ErrorInfo struct { + // Domain: The logical grouping to which the "reason" belongs. The error domain + // is typically the registered service name of the tool or product that + // generates the error. Example: "pubsub.googleapis.com". If the error is + // generated by some common infrastructure, the error domain must be a globally + // unique value that identifies the infrastructure. For Google API + // infrastructure, the error domain is "googleapis.com". + Domain string `json:"domain,omitempty"` + // Metadata: Additional structured details about this error. Keys must match + // /a-z+/ but should ideally be lowerCamelCase. Also they must be limited to 64 + // characters in length. When identifying the current value of an exceeded + // limit, the units should be contained in the key, not the value. For example, + // rather than {"instanceLimit": "100/request"}, should be returned as, + // {"instanceLimitPerRequest": "100"}, if the client exceeds the number of + // instances that can be created in a single (batch) request. + Metadata map[string]string `json:"metadata,omitempty"` + // Reason: The reason of the error. This is a constant value that identifies + // the proximate cause of the error. Error reasons are unique within a + // particular domain of errors. This should be at most 63 characters and match + // a regular expression of `A-Z+[A-Z0-9]`, which represents UPPER_SNAKE_CASE. + Reason string `json:"reason,omitempty"` + // ForceSendFields is a list of field names (e.g. "Domain") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Domain") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ErrorInfo) MarshalJSON() ([]byte, error) { + type NoMethod ErrorInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Expr: Represents a textual expression in the Common Expression Language // (CEL) syntax. CEL is a C-like expression language. The syntax and semantics // of CEL are documented at https://github.com/google/cel-spec. Example @@ -1084,7 +1156,8 @@ type GlobalSetPolicyRequest struct { // size of the policy is limited to a few 10s of KB. An empty policy is in // general a valid policy but certain services (like Projects) might reject // them. - Policy *Policy `json:"policy,omitempty"` + Policy *Policy `json:"policy,omitempty"` + UpdateMask string `json:"updateMask,omitempty"` // ForceSendFields is a list of field names (e.g. "Bindings") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -1103,6 +1176,57 @@ func (s GlobalSetPolicyRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// Help: Provides links to documentation or for performing an out of band +// action. For example, if a quota check failed with an error indicating the +// calling project hasn't enabled the accessed service, this can contain a URL +// pointing directly to the right place in the developer console to flip the +// bit. +type Help struct { + // Links: URL(s) pointing to additional information on handling the current + // error. + Links []*HelpLink `json:"links,omitempty"` + // ForceSendFields is a list of field names (e.g. "Links") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Links") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s Help) MarshalJSON() ([]byte, error) { + type NoMethod Help + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// HelpLink: Describes a URL link. +type HelpLink struct { + // Description: Describes what the link offers. + Description string `json:"description,omitempty"` + // Url: The URL of the link. + Url string `json:"url,omitempty"` + // ForceSendFields is a list of field names (e.g. "Description") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Description") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s HelpLink) MarshalJSON() ([]byte, error) { + type NoMethod HelpLink + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type ImportFile struct { // Content: The contents of the file. Content string `json:"content,omitempty"` @@ -1185,6 +1309,33 @@ func (s InstancesBulkInsertOperationMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// LocalizedMessage: Provides a localized error message that is safe to return +// to the user which can be attached to an RPC error. +type LocalizedMessage struct { + // Locale: The locale used following the specification defined at + // https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: "en-US", + // "fr-CH", "es-MX" + Locale string `json:"locale,omitempty"` + // Message: The localized error message in the above locale. + Message string `json:"message,omitempty"` + // ForceSendFields is a list of field names (e.g. "Locale") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Locale") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s LocalizedMessage) MarshalJSON() ([]byte, error) { + type NoMethod LocalizedMessage + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type Manifest struct { // Config: Output only. The YAML configuration for this manifest. Config *ConfigFile `json:"config,omitempty"` @@ -1357,6 +1508,9 @@ type Operation struct { Region string `json:"region,omitempty"` // SelfLink: [Output Only] Server-defined URL for the resource. SelfLink string `json:"selfLink,omitempty"` + // SelfLinkWithId: [Output Only] Server-defined URL for this resource with the + // resource id. + SelfLinkWithId string `json:"selfLinkWithId,omitempty"` // SetCommonInstanceMetadataOperationMetadata: [Output Only] If the operation // is for projects.setCommonInstanceMetadata, this field will contain // information on all underlying zonal actions and their state. @@ -1380,7 +1534,7 @@ type Operation struct { TargetId uint64 `json:"targetId,omitempty,string"` // TargetLink: [Output Only] The URL of the resource that the operation // modifies. For operations related to creating a snapshot, this points to the - // persistent disk that the snapshot was created from. + // disk that the snapshot was created from. TargetLink string `json:"targetLink,omitempty"` // User: [Output Only] User who requested the operation, for example: // `user@example.com` or `alice_smith_identifier @@ -1438,22 +1592,33 @@ func (s OperationError) MarshalJSON() ([]byte, error) { } type OperationErrorErrors struct { + // Arguments: [Output Only] Optional error details WARNING: DO NOT MAKE VISIBLE + // This is for internal use-only (like componentization) (thus the visibility + // "none") and in case of public exposure it is strongly recommended to follow + // pattern of: https://aip.dev/193 and expose as details field. + Arguments []string `json:"arguments,omitempty"` // Code: [Output Only] The error type identifier for this error. - Code string `json:"code,omitempty"` + Code string `json:"code,omitempty"` + DebugInfo *DebugInfo `json:"debugInfo,omitempty"` + // ErrorDetails: [Output Only] An optional list of messages that contain the + // error details. There is a set of defined message types to use for providing + // details.The syntax depends on the error code. For example, QuotaExceededInfo + // will have details when the error code is QUOTA_EXCEEDED. + ErrorDetails []*OperationErrorErrorsErrorDetails `json:"errorDetails,omitempty"` // Location: [Output Only] Indicates the field in the request that caused the // error. This property is optional. Location string `json:"location,omitempty"` // Message: [Output Only] An optional, human-readable error message. Message string `json:"message,omitempty"` - // ForceSendFields is a list of field names (e.g. "Code") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See + // ForceSendFields is a list of field names (e.g. "Arguments") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Code") to include in API requests - // with the JSON null value. By default, fields with empty values are omitted - // from API requests. See + // NullFields is a list of field names (e.g. "Arguments") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -1463,6 +1628,29 @@ func (s OperationErrorErrors) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type OperationErrorErrorsErrorDetails struct { + ErrorInfo *ErrorInfo `json:"errorInfo,omitempty"` + Help *Help `json:"help,omitempty"` + LocalizedMessage *LocalizedMessage `json:"localizedMessage,omitempty"` + QuotaInfo *QuotaExceededInfo `json:"quotaInfo,omitempty"` + // ForceSendFields is a list of field names (e.g. "ErrorInfo") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ErrorInfo") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s OperationErrorErrorsErrorDetails) MarshalJSON() ([]byte, error) { + type NoMethod OperationErrorErrorsErrorDetails + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type OperationWarnings struct { // Code: [Output Only] A warning code, if applicable. For example, Compute // Engine returns NO_RESULTS_ON_PAGE if there are no results in the response. @@ -1500,6 +1688,14 @@ type OperationWarnings struct { // overridden. Deprecated unused field. // "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING" - Warning that a resource is // in use. + // "NETWORK_ENDPOINT_NOT_DETACHED" - Warning that network endpoint was not + // detached. + // "PAGE_MISSING_RESULTS" - Current page contains less results than requested + // but a next page token exists. + // "SSL_POLICY_ENABLED_FEATURES_NOT_FETCHED" - Warning that SSL policy + // resource in the response does not contain information about the list of + // enabled features. + // "RESOURCE_NOT_FOUND_WARNING" - Warning that a resource is not found. // "MISSING_TYPE_DEPENDENCY" - A resource depends on a missing type // "EXTERNAL_API_WARNING" - Warning that is present in an external api call // "SCHEMA_VALIDATION_IGNORED" - When a resource schema validation is @@ -1523,6 +1719,17 @@ type OperationWarnings struct { // "LIST_OVERHEAD_QUOTA_EXCEED" - Resource can't be retrieved due to list // overhead quota exceed which captures the amount of resources filtered out by // user-defined list filter. + // "QUOTA_INFO_UNAVAILABLE" - Quota information is not available to client + // requests (e.g: regions.list). + // "RESOURCE_USES_GLOBAL_DNS" - Indicates that a VM is using global DNS. Can + // also be used to indicate that a resource has attributes that could result in + // the creation of a VM that uses global DNS. + // "RESERVED_ENTRY_134" - Reserved entries for quickly adding new warnings + // without breaking dependent clients. + // "RESERVED_ENTRY_135" + // "RESERVED_ENTRY_136" + // "RESERVED_ENTRY_139" + // "RESERVED_ENTRY_141" Code string `json:"code,omitempty"` // Data: [Output Only] Metadata about this warning in key: value format. For // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } @@ -1762,6 +1969,63 @@ func (s PollingOptions) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// QuotaExceededInfo: Additional details for quota exceeded error for resource +// quota. +type QuotaExceededInfo struct { + // Dimensions: The map holding related quota dimensions. + Dimensions map[string]string `json:"dimensions,omitempty"` + // FutureLimit: Future quota limit being rolled out. The limit's unit depends + // on the quota type or metric. + FutureLimit float64 `json:"futureLimit,omitempty"` + // Limit: Current effective quota limit. The limit's unit depends on the quota + // type or metric. + Limit float64 `json:"limit,omitempty"` + // LimitName: The name of the quota limit. + LimitName string `json:"limitName,omitempty"` + // MetricName: The Compute Engine quota metric name. + MetricName string `json:"metricName,omitempty"` + // RolloutStatus: Rollout status of the future quota limit. + // + // Possible values: + // "ROLLOUT_STATUS_UNSPECIFIED" - ROLLOUT_STATUS_UNSPECIFIED - Rollout status + // is not specified. The default value. + // "IN_PROGRESS" - IN_PROGRESS - A rollout is in process which will change + // the limit value to future limit. + RolloutStatus string `json:"rolloutStatus,omitempty"` + // ForceSendFields is a list of field names (e.g. "Dimensions") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Dimensions") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s QuotaExceededInfo) MarshalJSON() ([]byte, error) { + type NoMethod QuotaExceededInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *QuotaExceededInfo) UnmarshalJSON(data []byte) error { + type NoMethod QuotaExceededInfo + var s1 struct { + FutureLimit gensupport.JSONFloat64 `json:"futureLimit"` + Limit gensupport.JSONFloat64 `json:"limit"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.FutureLimit = float64(s1.FutureLimit) + s.Limit = float64(s1.Limit) + return nil +} + type Resource struct { // AccessControl: The Access Control Policy set on this resource. AccessControl *ResourceAccessControl `json:"accessControl,omitempty"` @@ -1867,6 +2131,14 @@ type ResourceWarnings struct { // overridden. Deprecated unused field. // "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING" - Warning that a resource is // in use. + // "NETWORK_ENDPOINT_NOT_DETACHED" - Warning that network endpoint was not + // detached. + // "PAGE_MISSING_RESULTS" - Current page contains less results than requested + // but a next page token exists. + // "SSL_POLICY_ENABLED_FEATURES_NOT_FETCHED" - Warning that SSL policy + // resource in the response does not contain information about the list of + // enabled features. + // "RESOURCE_NOT_FOUND_WARNING" - Warning that a resource is not found. // "MISSING_TYPE_DEPENDENCY" - A resource depends on a missing type // "EXTERNAL_API_WARNING" - Warning that is present in an external api call // "SCHEMA_VALIDATION_IGNORED" - When a resource schema validation is @@ -1890,6 +2162,17 @@ type ResourceWarnings struct { // "LIST_OVERHEAD_QUOTA_EXCEED" - Resource can't be retrieved due to list // overhead quota exceed which captures the amount of resources filtered out by // user-defined list filter. + // "QUOTA_INFO_UNAVAILABLE" - Quota information is not available to client + // requests (e.g: regions.list). + // "RESOURCE_USES_GLOBAL_DNS" - Indicates that a VM is using global DNS. Can + // also be used to indicate that a resource has attributes that could result in + // the creation of a VM that uses global DNS. + // "RESERVED_ENTRY_134" - Reserved entries for quickly adding new warnings + // without breaking dependent clients. + // "RESERVED_ENTRY_135" + // "RESERVED_ENTRY_136" + // "RESERVED_ENTRY_139" + // "RESERVED_ENTRY_141" Code string `json:"code,omitempty"` // Data: [Output Only] Metadata about this warning in key: value format. For // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } @@ -2063,22 +2346,33 @@ func (s ResourceUpdateError) MarshalJSON() ([]byte, error) { } type ResourceUpdateErrorErrors struct { + // Arguments: [Output Only] Optional error details WARNING: DO NOT MAKE VISIBLE + // This is for internal use-only (like componentization) (thus the visibility + // "none") and in case of public exposure it is strongly recommended to follow + // pattern of: https://aip.dev/193 and expose as details field. + Arguments []string `json:"arguments,omitempty"` // Code: [Output Only] The error type identifier for this error. - Code string `json:"code,omitempty"` + Code string `json:"code,omitempty"` + DebugInfo *DebugInfo `json:"debugInfo,omitempty"` + // ErrorDetails: [Output Only] An optional list of messages that contain the + // error details. There is a set of defined message types to use for providing + // details.The syntax depends on the error code. For example, QuotaExceededInfo + // will have details when the error code is QUOTA_EXCEEDED. + ErrorDetails []*ResourceUpdateErrorErrorsErrorDetails `json:"errorDetails,omitempty"` // Location: [Output Only] Indicates the field in the request that caused the // error. This property is optional. Location string `json:"location,omitempty"` // Message: [Output Only] An optional, human-readable error message. Message string `json:"message,omitempty"` - // ForceSendFields is a list of field names (e.g. "Code") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See + // ForceSendFields is a list of field names (e.g. "Arguments") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Code") to include in API requests - // with the JSON null value. By default, fields with empty values are omitted - // from API requests. See + // NullFields is a list of field names (e.g. "Arguments") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -2088,6 +2382,29 @@ func (s ResourceUpdateErrorErrors) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type ResourceUpdateErrorErrorsErrorDetails struct { + ErrorInfo *ErrorInfo `json:"errorInfo,omitempty"` + Help *Help `json:"help,omitempty"` + LocalizedMessage *LocalizedMessage `json:"localizedMessage,omitempty"` + QuotaInfo *QuotaExceededInfo `json:"quotaInfo,omitempty"` + // ForceSendFields is a list of field names (e.g. "ErrorInfo") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ErrorInfo") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ResourceUpdateErrorErrorsErrorDetails) MarshalJSON() ([]byte, error) { + type NoMethod ResourceUpdateErrorErrorsErrorDetails + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type ResourceUpdateWarnings struct { // Code: [Output Only] A warning code, if applicable. For example, Compute // Engine returns NO_RESULTS_ON_PAGE if there are no results in the response. @@ -2125,6 +2442,14 @@ type ResourceUpdateWarnings struct { // overridden. Deprecated unused field. // "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING" - Warning that a resource is // in use. + // "NETWORK_ENDPOINT_NOT_DETACHED" - Warning that network endpoint was not + // detached. + // "PAGE_MISSING_RESULTS" - Current page contains less results than requested + // but a next page token exists. + // "SSL_POLICY_ENABLED_FEATURES_NOT_FETCHED" - Warning that SSL policy + // resource in the response does not contain information about the list of + // enabled features. + // "RESOURCE_NOT_FOUND_WARNING" - Warning that a resource is not found. // "MISSING_TYPE_DEPENDENCY" - A resource depends on a missing type // "EXTERNAL_API_WARNING" - Warning that is present in an external api call // "SCHEMA_VALIDATION_IGNORED" - When a resource schema validation is @@ -2148,6 +2473,17 @@ type ResourceUpdateWarnings struct { // "LIST_OVERHEAD_QUOTA_EXCEED" - Resource can't be retrieved due to list // overhead quota exceed which captures the amount of resources filtered out by // user-defined list filter. + // "QUOTA_INFO_UNAVAILABLE" - Quota information is not available to client + // requests (e.g: regions.list). + // "RESOURCE_USES_GLOBAL_DNS" - Indicates that a VM is using global DNS. Can + // also be used to indicate that a resource has attributes that could result in + // the creation of a VM that uses global DNS. + // "RESERVED_ENTRY_134" - Reserved entries for quickly adding new warnings + // without breaking dependent clients. + // "RESERVED_ENTRY_135" + // "RESERVED_ENTRY_136" + // "RESERVED_ENTRY_139" + // "RESERVED_ENTRY_141" Code string `json:"code,omitempty"` // Data: [Output Only] Metadata about this warning in key: value format. For // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } @@ -2827,6 +3163,13 @@ func (r *CompositeTypesService) Delete(project string, compositeType string) *Co return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *CompositeTypesDeleteCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *CompositeTypesDeleteCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -2927,6 +3270,13 @@ func (r *CompositeTypesService) Get(project string, compositeType string) *Compo return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *CompositeTypesGetCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *CompositeTypesGetCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -3036,6 +3386,13 @@ func (r *CompositeTypesService) Insert(project string, compositetype *CompositeT return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *CompositeTypesInsertCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *CompositeTypesInsertCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -3337,6 +3694,13 @@ func (r *CompositeTypesService) Patch(project string, compositeType string, comp return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *CompositeTypesPatchCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *CompositeTypesPatchCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -3442,6 +3806,13 @@ func (r *CompositeTypesService) Update(project string, compositeType string, com return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *CompositeTypesUpdateCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *CompositeTypesUpdateCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -3663,6 +4034,13 @@ func (c *DeploymentsDeleteCall) DeletePolicy(deletePolicy string) *DeploymentsDe return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *DeploymentsDeleteCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *DeploymentsDeleteCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -3763,6 +4141,13 @@ func (r *DeploymentsService) Get(project string, deployment string) *Deployments return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *DeploymentsGetCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *DeploymentsGetCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -3875,6 +4260,13 @@ func (r *DeploymentsService) GetIamPolicy(project string, resource string) *Depl return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *DeploymentsGetIamPolicyCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *DeploymentsGetIamPolicyCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // OptionsRequestedPolicyVersion sets the optional parameter // "optionsRequestedPolicyVersion": Requested IAM Policy version. func (c *DeploymentsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *DeploymentsGetIamPolicyCall { @@ -4005,6 +4397,13 @@ func (c *DeploymentsInsertCall) CreatePolicy(createPolicy string) *DeploymentsIn return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *DeploymentsInsertCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *DeploymentsInsertCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Preview sets the optional parameter "preview": If set to true, creates a // deployment and creates "shell" resources but does not actually instantiate // these resources. This allows you to preview what your deployment looks like. @@ -4345,6 +4744,13 @@ func (c *DeploymentsPatchCall) DeletePolicy(deletePolicy string) *DeploymentsPat return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *DeploymentsPatchCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *DeploymentsPatchCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Preview sets the optional parameter "preview": If set to true, updates the // deployment and creates and updates the "shell" resources but does not // actually alter or instantiate these resources. This allows you to preview @@ -4678,6 +5084,13 @@ func (r *DeploymentsService) TestIamPermissions(project string, resource string, return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *DeploymentsTestIamPermissionsCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *DeploymentsTestIamPermissionsCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -4810,6 +5223,13 @@ func (c *DeploymentsUpdateCall) DeletePolicy(deletePolicy string) *DeploymentsUp return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *DeploymentsUpdateCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *DeploymentsUpdateCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Preview sets the optional parameter "preview": If set to true, updates the // deployment and creates and updates the "shell" resources but does not // actually alter or instantiate these resources. This allows you to preview @@ -4932,6 +5352,13 @@ func (r *ManifestsService) Get(project string, deployment string, manifest strin return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *ManifestsGetCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *ManifestsGetCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -5245,6 +5672,13 @@ func (r *OperationsService) Get(project string, operation string) *OperationsGet return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *OperationsGetCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *OperationsGetCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -5556,6 +5990,13 @@ func (r *ResourcesService) Get(project string, deployment string, resource strin return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *ResourcesGetCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *ResourcesGetCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -5868,6 +6309,13 @@ func (r *TypeProvidersService) Delete(project string, typeProvider string) *Type return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *TypeProvidersDeleteCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *TypeProvidersDeleteCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -5968,6 +6416,13 @@ func (r *TypeProvidersService) Get(project string, typeProvider string) *TypePro return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *TypeProvidersGetCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *TypeProvidersGetCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -6082,6 +6537,13 @@ func (r *TypeProvidersService) GetType(project string, typeProvider string, type return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *TypeProvidersGetTypeCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *TypeProvidersGetTypeCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -6192,6 +6654,13 @@ func (r *TypeProvidersService) Insert(project string, typeprovider *TypeProvider return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *TypeProvidersInsertCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *TypeProvidersInsertCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -6694,6 +7163,13 @@ func (r *TypeProvidersService) Patch(project string, typeProvider string, typepr return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *TypeProvidersPatchCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *TypeProvidersPatchCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -6799,6 +7275,13 @@ func (r *TypeProvidersService) Update(project string, typeProvider string, typep return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *TypeProvidersUpdateCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *TypeProvidersUpdateCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -6903,6 +7386,13 @@ func (r *TypesService) Get(project string, type_ string) *TypesGetCall { return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *TypesGetCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *TypesGetCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. diff --git a/deploymentmanager/v2/deploymentmanager-api.json b/deploymentmanager/v2/deploymentmanager-api.json index 6ddcf6e4eaf..64c0e4ba955 100644 --- a/deploymentmanager/v2/deploymentmanager-api.json +++ b/deploymentmanager/v2/deploymentmanager-api.json @@ -182,6 +182,10 @@ "required": true, "type": "string" }, + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "The project ID for this request.", "location": "path", @@ -216,6 +220,10 @@ "required": true, "type": "string" }, + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "The project ID for this request.", "location": "path", @@ -245,6 +253,10 @@ "resource" ], "parameters": { + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "optionsRequestedPolicyVersion": { "description": "Requested IAM Policy version.", "format": "int32", @@ -298,6 +310,10 @@ "location": "query", "type": "string" }, + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "preview": { "description": "If set to true, creates a deployment and creates \"shell\" resources but does not actually instantiate these resources. This allows you to preview what your deployment looks like. After previewing a deployment, you can deploy your resources by making a request with the `update()` method or you can use the `cancelPreview()` method to cancel the preview altogether. Note that the deployment will still exist after you cancel the preview and you must separately delete this deployment if you want to remove it.", "location": "query", @@ -419,6 +435,10 @@ "required": true, "type": "string" }, + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "preview": { "default": "false", "description": "If set to true, updates the deployment and creates and updates the \"shell\" resources but does not actually alter or instantiate these resources. This allows you to preview what your deployment will look like. You can use this intent to preview how an update would affect your deployment. You must provide a `target.config` with a configuration if this is set to true. After previewing a deployment, you can deploy your resources by making a request with the `update()` or you can `cancelPreview()` to remove the preview altogether. Note that the deployment will still exist after you cancel the preview and you must separately delete this deployment if you want to remove it.", @@ -529,6 +549,10 @@ "resource" ], "parameters": { + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "Project ID for this request.", "location": "path", @@ -601,6 +625,10 @@ "required": true, "type": "string" }, + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "preview": { "default": "false", "description": "If set to true, updates the deployment and creates and updates the \"shell\" resources but does not actually alter or instantiate these resources. This allows you to preview what your deployment will look like. You can use this intent to preview how an update would affect your deployment. You must provide a `target.config` with a configuration if this is set to true. After previewing a deployment, you can deploy your resources by making a request with the `update()` or you can `cancelPreview()` to remove the preview altogether. Note that the deployment will still exist after you cancel the preview and you must separately delete this deployment if you want to remove it.", @@ -649,6 +677,10 @@ "required": true, "type": "string" }, + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "manifest": { "description": "The name of the manifest for this request.", "location": "path", @@ -748,6 +780,10 @@ "operation" ], "parameters": { + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "operation": { "description": "The name of the operation for this request.", "location": "path", @@ -846,6 +882,10 @@ "required": true, "type": "string" }, + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "The project ID for this request.", "location": "path", @@ -988,7 +1028,7 @@ } } }, - "revision": "20240214", + "revision": "20241031", "rootUrl": "https://deploymentmanager.googleapis.com/", "schemas": { "AuditConfig": { @@ -1113,6 +1153,24 @@ }, "type": "object" }, + "DebugInfo": { + "description": "Describes additional debugging info.", + "id": "DebugInfo", + "properties": { + "detail": { + "description": "Additional debugging information provided by the server.", + "type": "string" + }, + "stackEntries": { + "description": "The stack trace entries indicating where the error occurred.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "Deployment": { "id": "Deployment", "properties": { @@ -1262,6 +1320,28 @@ }, "type": "object" }, + "ErrorInfo": { + "description": "Describes the cause of the error with structured details. Example of an error when contacting the \"pubsub.googleapis.com\" API when it is not enabled: { \"reason\": \"API_DISABLED\" \"domain\": \"googleapis.com\" \"metadata\": { \"resource\": \"projects/123\", \"service\": \"pubsub.googleapis.com\" } } This response indicates that the pubsub.googleapis.com API is not enabled. Example of an error that is returned when attempting to create a Spanner instance in a region that is out of stock: { \"reason\": \"STOCKOUT\" \"domain\": \"spanner.googleapis.com\", \"metadata\": { \"availableRegions\": \"us-central1,us-east2\" } }", + "id": "ErrorInfo", + "properties": { + "domain": { + "description": "The logical grouping to which the \"reason\" belongs. The error domain is typically the registered service name of the tool or product that generates the error. Example: \"pubsub.googleapis.com\". If the error is generated by some common infrastructure, the error domain must be a globally unique value that identifies the infrastructure. For Google API infrastructure, the error domain is \"googleapis.com\".", + "type": "string" + }, + "metadata": { + "additionalProperties": { + "type": "string" + }, + "description": "Additional structured details about this error. Keys must match /a-z+/ but should ideally be lowerCamelCase. Also they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than {\"instanceLimit\": \"100/request\"}, should be returned as, {\"instanceLimitPerRequest\": \"100\"}, if the client exceeds the number of instances that can be created in a single (batch) request.", + "type": "object" + }, + "reason": { + "description": "The reason of the error. This is a constant value that identifies the proximate cause of the error. Error reasons are unique within a particular domain of errors. This should be at most 63 characters and match a regular expression of `A-Z+[A-Z0-9]`, which represents UPPER_SNAKE_CASE.", + "type": "string" + } + }, + "type": "object" + }, "Expr": { "description": "Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: \"Summary size limit\" description: \"Determines if a summary is less than 100 chars\" expression: \"document.summary.size() \u003c 100\" Example (Equality): title: \"Requestor is owner\" description: \"Determines if requestor is the document owner\" expression: \"document.owner == request.auth.claims.email\" Example (Logic): title: \"Public documents\" description: \"Determine whether the document should be publicly visible\" expression: \"document.type != 'private' \u0026\u0026 document.type != 'internal'\" Example (Data Manipulation): title: \"Notification string\" description: \"Create a notification string with a timestamp.\" expression: \"'New message received at ' + string(document.create_time)\" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information.", "id": "Expr", @@ -1303,6 +1383,39 @@ "policy": { "$ref": "Policy", "description": "REQUIRED: The complete policy to be applied to the 'resource'. The size of the policy is limited to a few 10s of KB. An empty policy is in general a valid policy but certain services (like Projects) might reject them." + }, + "updateMask": { + "format": "google-fieldmask", + "type": "string" + } + }, + "type": "object" + }, + "Help": { + "description": "Provides links to documentation or for performing an out of band action. For example, if a quota check failed with an error indicating the calling project hasn't enabled the accessed service, this can contain a URL pointing directly to the right place in the developer console to flip the bit.", + "id": "Help", + "properties": { + "links": { + "description": "URL(s) pointing to additional information on handling the current error.", + "items": { + "$ref": "HelpLink" + }, + "type": "array" + } + }, + "type": "object" + }, + "HelpLink": { + "description": "Describes a URL link.", + "id": "HelpLink", + "properties": { + "description": { + "description": "Describes what the link offers.", + "type": "string" + }, + "url": { + "description": "The URL of the link.", + "type": "string" } }, "type": "object" @@ -1334,6 +1447,21 @@ }, "type": "object" }, + "LocalizedMessage": { + "description": "Provides a localized error message that is safe to return to the user which can be attached to an RPC error.", + "id": "LocalizedMessage", + "properties": { + "locale": { + "description": "The locale used following the specification defined at https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: \"en-US\", \"fr-CH\", \"es-MX\"", + "type": "string" + }, + "message": { + "description": "The localized error message in the above locale.", + "type": "string" + } + }, + "type": "object" + }, "Manifest": { "id": "Manifest", "properties": { @@ -1430,10 +1558,41 @@ "description": "[Output Only] The array of errors encountered while processing this operation.", "items": { "properties": { + "arguments": { + "description": "[Output Only] Optional error details WARNING: DO NOT MAKE VISIBLE This is for internal use-only (like componentization) (thus the visibility \"none\") and in case of public exposure it is strongly recommended to follow pattern of: https://aip.dev/193 and expose as details field.", + "items": { + "type": "string" + }, + "type": "array" + }, "code": { "description": "[Output Only] The error type identifier for this error.", "type": "string" }, + "debugInfo": { + "$ref": "DebugInfo" + }, + "errorDetails": { + "description": "[Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED.", + "items": { + "properties": { + "errorInfo": { + "$ref": "ErrorInfo" + }, + "help": { + "$ref": "Help" + }, + "localizedMessage": { + "$ref": "LocalizedMessage" + }, + "quotaInfo": { + "$ref": "QuotaExceededInfo" + } + }, + "type": "object" + }, + "type": "array" + }, "location": { "description": "[Output Only] Indicates the field in the request that caused the error. This property is optional.", "type": "string" @@ -1501,6 +1660,10 @@ "description": "[Output Only] Server-defined URL for the resource.", "type": "string" }, + "selfLinkWithId": { + "description": "[Output Only] Server-defined URL for this resource with the resource id.", + "type": "string" + }, "setCommonInstanceMetadataOperationMetadata": { "$ref": "SetCommonInstanceMetadataOperationMetadata", "description": "[Output Only] If the operation is for projects.setCommonInstanceMetadata, this field will contain information on all underlying zonal actions and their state." @@ -1533,7 +1696,7 @@ "type": "string" }, "targetLink": { - "description": "[Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.", + "description": "[Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the disk that the snapshot was created from.", "type": "string" }, "user": { @@ -1564,6 +1727,10 @@ "CLEANUP_FAILED", "FIELD_VALUE_OVERRIDEN", "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "NETWORK_ENDPOINT_NOT_DETACHED", + "PAGE_MISSING_RESULTS", + "SSL_POLICY_ENABLED_FEATURES_NOT_FETCHED", + "RESOURCE_NOT_FOUND_WARNING", "MISSING_TYPE_DEPENDENCY", "EXTERNAL_API_WARNING", "SCHEMA_VALIDATION_IGNORED", @@ -1574,7 +1741,14 @@ "LARGE_DEPLOYMENT_WARNING", "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LIST_OVERHEAD_QUOTA_EXCEED" + "LIST_OVERHEAD_QUOTA_EXCEED", + "QUOTA_INFO_UNAVAILABLE", + "RESOURCE_USES_GLOBAL_DNS", + "RESERVED_ENTRY_134", + "RESERVED_ENTRY_135", + "RESERVED_ENTRY_136", + "RESERVED_ENTRY_139", + "RESERVED_ENTRY_141" ], "enumDeprecated": [ false, @@ -1604,6 +1778,17 @@ false, false, false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, false ], "enumDescriptions": [ @@ -1624,6 +1809,10 @@ "Warning about failed cleanup of transient changes made by a failed operation.", "Warning that value of a field has been overridden. Deprecated unused field.", "Warning that a resource is in use.", + "Warning that network endpoint was not detached.", + "Current page contains less results than requested but a next page token exists.", + "Warning that SSL policy resource in the response does not contain information about the list of enabled features.", + "Warning that a resource is not found.", "A resource depends on a missing type", "Warning that is present in an external api call", "When a resource schema validation is ignored.", @@ -1634,7 +1823,14 @@ "When deploying a deployment with a exceedingly large number of resources", "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter." + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "Quota information is not available to client requests (e.g: regions.list).", + "Indicates that a VM is using global DNS. Can also be used to indicate that a resource has attributes that could result in the creation of a VM that uses global DNS.", + "Reserved entries for quickly adding new warnings without breaking dependent clients.", + "", + "", + "", + "" ], "type": "string" }, @@ -1720,6 +1916,50 @@ }, "type": "object" }, + "QuotaExceededInfo": { + "description": "Additional details for quota exceeded error for resource quota.", + "id": "QuotaExceededInfo", + "properties": { + "dimensions": { + "additionalProperties": { + "type": "string" + }, + "description": "The map holding related quota dimensions.", + "type": "object" + }, + "futureLimit": { + "description": "Future quota limit being rolled out. The limit's unit depends on the quota type or metric.", + "format": "double", + "type": "number" + }, + "limit": { + "description": "Current effective quota limit. The limit's unit depends on the quota type or metric.", + "format": "double", + "type": "number" + }, + "limitName": { + "description": "The name of the quota limit.", + "type": "string" + }, + "metricName": { + "description": "The Compute Engine quota metric name.", + "type": "string" + }, + "rolloutStatus": { + "description": "Rollout status of the future quota limit.", + "enum": [ + "ROLLOUT_STATUS_UNSPECIFIED", + "IN_PROGRESS" + ], + "enumDescriptions": [ + "ROLLOUT_STATUS_UNSPECIFIED - Rollout status is not specified. The default value.", + "IN_PROGRESS - A rollout is in process which will change the limit value to future limit." + ], + "type": "string" + } + }, + "type": "object" + }, "Resource": { "id": "Resource", "properties": { @@ -1791,6 +2031,10 @@ "CLEANUP_FAILED", "FIELD_VALUE_OVERRIDEN", "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "NETWORK_ENDPOINT_NOT_DETACHED", + "PAGE_MISSING_RESULTS", + "SSL_POLICY_ENABLED_FEATURES_NOT_FETCHED", + "RESOURCE_NOT_FOUND_WARNING", "MISSING_TYPE_DEPENDENCY", "EXTERNAL_API_WARNING", "SCHEMA_VALIDATION_IGNORED", @@ -1801,7 +2045,14 @@ "LARGE_DEPLOYMENT_WARNING", "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LIST_OVERHEAD_QUOTA_EXCEED" + "LIST_OVERHEAD_QUOTA_EXCEED", + "QUOTA_INFO_UNAVAILABLE", + "RESOURCE_USES_GLOBAL_DNS", + "RESERVED_ENTRY_134", + "RESERVED_ENTRY_135", + "RESERVED_ENTRY_136", + "RESERVED_ENTRY_139", + "RESERVED_ENTRY_141" ], "enumDeprecated": [ false, @@ -1831,6 +2082,17 @@ false, false, false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, false ], "enumDescriptions": [ @@ -1851,6 +2113,10 @@ "Warning about failed cleanup of transient changes made by a failed operation.", "Warning that value of a field has been overridden. Deprecated unused field.", "Warning that a resource is in use.", + "Warning that network endpoint was not detached.", + "Current page contains less results than requested but a next page token exists.", + "Warning that SSL policy resource in the response does not contain information about the list of enabled features.", + "Warning that a resource is not found.", "A resource depends on a missing type", "Warning that is present in an external api call", "When a resource schema validation is ignored.", @@ -1861,7 +2127,14 @@ "When deploying a deployment with a exceedingly large number of resources", "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter." + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "Quota information is not available to client requests (e.g: regions.list).", + "Indicates that a VM is using global DNS. Can also be used to indicate that a resource has attributes that could result in the creation of a VM that uses global DNS.", + "Reserved entries for quickly adding new warnings without breaking dependent clients.", + "", + "", + "", + "" ], "type": "string" }, @@ -1919,10 +2192,41 @@ "description": "[Output Only] The array of errors encountered while processing this operation.", "items": { "properties": { + "arguments": { + "description": "[Output Only] Optional error details WARNING: DO NOT MAKE VISIBLE This is for internal use-only (like componentization) (thus the visibility \"none\") and in case of public exposure it is strongly recommended to follow pattern of: https://aip.dev/193 and expose as details field.", + "items": { + "type": "string" + }, + "type": "array" + }, "code": { "description": "[Output Only] The error type identifier for this error.", "type": "string" }, + "debugInfo": { + "$ref": "DebugInfo" + }, + "errorDetails": { + "description": "[Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED.", + "items": { + "properties": { + "errorInfo": { + "$ref": "ErrorInfo" + }, + "help": { + "$ref": "Help" + }, + "localizedMessage": { + "$ref": "LocalizedMessage" + }, + "quotaInfo": { + "$ref": "QuotaExceededInfo" + } + }, + "type": "object" + }, + "type": "array" + }, "location": { "description": "[Output Only] Indicates the field in the request that caused the error. This property is optional.", "type": "string" @@ -2013,6 +2317,10 @@ "CLEANUP_FAILED", "FIELD_VALUE_OVERRIDEN", "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "NETWORK_ENDPOINT_NOT_DETACHED", + "PAGE_MISSING_RESULTS", + "SSL_POLICY_ENABLED_FEATURES_NOT_FETCHED", + "RESOURCE_NOT_FOUND_WARNING", "MISSING_TYPE_DEPENDENCY", "EXTERNAL_API_WARNING", "SCHEMA_VALIDATION_IGNORED", @@ -2023,7 +2331,14 @@ "LARGE_DEPLOYMENT_WARNING", "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LIST_OVERHEAD_QUOTA_EXCEED" + "LIST_OVERHEAD_QUOTA_EXCEED", + "QUOTA_INFO_UNAVAILABLE", + "RESOURCE_USES_GLOBAL_DNS", + "RESERVED_ENTRY_134", + "RESERVED_ENTRY_135", + "RESERVED_ENTRY_136", + "RESERVED_ENTRY_139", + "RESERVED_ENTRY_141" ], "enumDeprecated": [ false, @@ -2053,6 +2368,17 @@ false, false, false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, false ], "enumDescriptions": [ @@ -2073,6 +2399,10 @@ "Warning about failed cleanup of transient changes made by a failed operation.", "Warning that value of a field has been overridden. Deprecated unused field.", "Warning that a resource is in use.", + "Warning that network endpoint was not detached.", + "Current page contains less results than requested but a next page token exists.", + "Warning that SSL policy resource in the response does not contain information about the list of enabled features.", + "Warning that a resource is not found.", "A resource depends on a missing type", "Warning that is present in an external api call", "When a resource schema validation is ignored.", @@ -2083,7 +2413,14 @@ "When deploying a deployment with a exceedingly large number of resources", "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter." + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "Quota information is not available to client requests (e.g: regions.list).", + "Indicates that a VM is using global DNS. Can also be used to indicate that a resource has attributes that could result in the creation of a VM that uses global DNS.", + "Reserved entries for quickly adding new warnings without breaking dependent clients.", + "", + "", + "", + "" ], "type": "string" }, diff --git a/deploymentmanager/v2/deploymentmanager-gen.go b/deploymentmanager/v2/deploymentmanager-gen.go index 6455479549c..7502ed6daea 100644 --- a/deploymentmanager/v2/deploymentmanager-gen.go +++ b/deploymentmanager/v2/deploymentmanager-gen.go @@ -464,6 +464,30 @@ func (s ConfigFile) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// DebugInfo: Describes additional debugging info. +type DebugInfo struct { + // Detail: Additional debugging information provided by the server. + Detail string `json:"detail,omitempty"` + // StackEntries: The stack trace entries indicating where the error occurred. + StackEntries []string `json:"stackEntries,omitempty"` + // ForceSendFields is a list of field names (e.g. "Detail") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Detail") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s DebugInfo) MarshalJSON() ([]byte, error) { + type NoMethod DebugInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type Deployment struct { // Description: An optional user-provided description of the deployment. Description string `json:"description,omitempty"` @@ -699,6 +723,54 @@ func (s DeploymentsStopRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ErrorInfo: Describes the cause of the error with structured details. Example +// of an error when contacting the "pubsub.googleapis.com" API when it is not +// enabled: { "reason": "API_DISABLED" "domain": "googleapis.com" "metadata": { +// "resource": "projects/123", "service": "pubsub.googleapis.com" } } This +// response indicates that the pubsub.googleapis.com API is not enabled. +// Example of an error that is returned when attempting to create a Spanner +// instance in a region that is out of stock: { "reason": "STOCKOUT" "domain": +// "spanner.googleapis.com", "metadata": { "availableRegions": +// "us-central1,us-east2" } } +type ErrorInfo struct { + // Domain: The logical grouping to which the "reason" belongs. The error domain + // is typically the registered service name of the tool or product that + // generates the error. Example: "pubsub.googleapis.com". If the error is + // generated by some common infrastructure, the error domain must be a globally + // unique value that identifies the infrastructure. For Google API + // infrastructure, the error domain is "googleapis.com". + Domain string `json:"domain,omitempty"` + // Metadata: Additional structured details about this error. Keys must match + // /a-z+/ but should ideally be lowerCamelCase. Also they must be limited to 64 + // characters in length. When identifying the current value of an exceeded + // limit, the units should be contained in the key, not the value. For example, + // rather than {"instanceLimit": "100/request"}, should be returned as, + // {"instanceLimitPerRequest": "100"}, if the client exceeds the number of + // instances that can be created in a single (batch) request. + Metadata map[string]string `json:"metadata,omitempty"` + // Reason: The reason of the error. This is a constant value that identifies + // the proximate cause of the error. Error reasons are unique within a + // particular domain of errors. This should be at most 63 characters and match + // a regular expression of `A-Z+[A-Z0-9]`, which represents UPPER_SNAKE_CASE. + Reason string `json:"reason,omitempty"` + // ForceSendFields is a list of field names (e.g. "Domain") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Domain") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ErrorInfo) MarshalJSON() ([]byte, error) { + type NoMethod ErrorInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Expr: Represents a textual expression in the Common Expression Language // (CEL) syntax. CEL is a C-like expression language. The syntax and semantics // of CEL are documented at https://github.com/google/cel-spec. Example @@ -758,7 +830,8 @@ type GlobalSetPolicyRequest struct { // size of the policy is limited to a few 10s of KB. An empty policy is in // general a valid policy but certain services (like Projects) might reject // them. - Policy *Policy `json:"policy,omitempty"` + Policy *Policy `json:"policy,omitempty"` + UpdateMask string `json:"updateMask,omitempty"` // ForceSendFields is a list of field names (e.g. "Bindings") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -777,6 +850,57 @@ func (s GlobalSetPolicyRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// Help: Provides links to documentation or for performing an out of band +// action. For example, if a quota check failed with an error indicating the +// calling project hasn't enabled the accessed service, this can contain a URL +// pointing directly to the right place in the developer console to flip the +// bit. +type Help struct { + // Links: URL(s) pointing to additional information on handling the current + // error. + Links []*HelpLink `json:"links,omitempty"` + // ForceSendFields is a list of field names (e.g. "Links") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Links") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s Help) MarshalJSON() ([]byte, error) { + type NoMethod Help + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// HelpLink: Describes a URL link. +type HelpLink struct { + // Description: Describes what the link offers. + Description string `json:"description,omitempty"` + // Url: The URL of the link. + Url string `json:"url,omitempty"` + // ForceSendFields is a list of field names (e.g. "Description") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Description") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s HelpLink) MarshalJSON() ([]byte, error) { + type NoMethod HelpLink + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type ImportFile struct { // Content: The contents of the file. Content string `json:"content,omitempty"` @@ -822,6 +946,33 @@ func (s InstancesBulkInsertOperationMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// LocalizedMessage: Provides a localized error message that is safe to return +// to the user which can be attached to an RPC error. +type LocalizedMessage struct { + // Locale: The locale used following the specification defined at + // https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: "en-US", + // "fr-CH", "es-MX" + Locale string `json:"locale,omitempty"` + // Message: The localized error message in the above locale. + Message string `json:"message,omitempty"` + // ForceSendFields is a list of field names (e.g. "Locale") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Locale") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s LocalizedMessage) MarshalJSON() ([]byte, error) { + type NoMethod LocalizedMessage + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type Manifest struct { // Config: Output only. The YAML configuration for this manifest. Config *ConfigFile `json:"config,omitempty"` @@ -959,6 +1110,9 @@ type Operation struct { Region string `json:"region,omitempty"` // SelfLink: [Output Only] Server-defined URL for the resource. SelfLink string `json:"selfLink,omitempty"` + // SelfLinkWithId: [Output Only] Server-defined URL for this resource with the + // resource id. + SelfLinkWithId string `json:"selfLinkWithId,omitempty"` // SetCommonInstanceMetadataOperationMetadata: [Output Only] If the operation // is for projects.setCommonInstanceMetadata, this field will contain // information on all underlying zonal actions and their state. @@ -982,7 +1136,7 @@ type Operation struct { TargetId uint64 `json:"targetId,omitempty,string"` // TargetLink: [Output Only] The URL of the resource that the operation // modifies. For operations related to creating a snapshot, this points to the - // persistent disk that the snapshot was created from. + // disk that the snapshot was created from. TargetLink string `json:"targetLink,omitempty"` // User: [Output Only] User who requested the operation, for example: // `user@example.com` or `alice_smith_identifier @@ -1040,22 +1194,33 @@ func (s OperationError) MarshalJSON() ([]byte, error) { } type OperationErrorErrors struct { + // Arguments: [Output Only] Optional error details WARNING: DO NOT MAKE VISIBLE + // This is for internal use-only (like componentization) (thus the visibility + // "none") and in case of public exposure it is strongly recommended to follow + // pattern of: https://aip.dev/193 and expose as details field. + Arguments []string `json:"arguments,omitempty"` // Code: [Output Only] The error type identifier for this error. - Code string `json:"code,omitempty"` + Code string `json:"code,omitempty"` + DebugInfo *DebugInfo `json:"debugInfo,omitempty"` + // ErrorDetails: [Output Only] An optional list of messages that contain the + // error details. There is a set of defined message types to use for providing + // details.The syntax depends on the error code. For example, QuotaExceededInfo + // will have details when the error code is QUOTA_EXCEEDED. + ErrorDetails []*OperationErrorErrorsErrorDetails `json:"errorDetails,omitempty"` // Location: [Output Only] Indicates the field in the request that caused the // error. This property is optional. Location string `json:"location,omitempty"` // Message: [Output Only] An optional, human-readable error message. Message string `json:"message,omitempty"` - // ForceSendFields is a list of field names (e.g. "Code") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See + // ForceSendFields is a list of field names (e.g. "Arguments") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Code") to include in API requests - // with the JSON null value. By default, fields with empty values are omitted - // from API requests. See + // NullFields is a list of field names (e.g. "Arguments") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -1065,6 +1230,29 @@ func (s OperationErrorErrors) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type OperationErrorErrorsErrorDetails struct { + ErrorInfo *ErrorInfo `json:"errorInfo,omitempty"` + Help *Help `json:"help,omitempty"` + LocalizedMessage *LocalizedMessage `json:"localizedMessage,omitempty"` + QuotaInfo *QuotaExceededInfo `json:"quotaInfo,omitempty"` + // ForceSendFields is a list of field names (e.g. "ErrorInfo") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ErrorInfo") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s OperationErrorErrorsErrorDetails) MarshalJSON() ([]byte, error) { + type NoMethod OperationErrorErrorsErrorDetails + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type OperationWarnings struct { // Code: [Output Only] A warning code, if applicable. For example, Compute // Engine returns NO_RESULTS_ON_PAGE if there are no results in the response. @@ -1102,6 +1290,14 @@ type OperationWarnings struct { // overridden. Deprecated unused field. // "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING" - Warning that a resource is // in use. + // "NETWORK_ENDPOINT_NOT_DETACHED" - Warning that network endpoint was not + // detached. + // "PAGE_MISSING_RESULTS" - Current page contains less results than requested + // but a next page token exists. + // "SSL_POLICY_ENABLED_FEATURES_NOT_FETCHED" - Warning that SSL policy + // resource in the response does not contain information about the list of + // enabled features. + // "RESOURCE_NOT_FOUND_WARNING" - Warning that a resource is not found. // "MISSING_TYPE_DEPENDENCY" - A resource depends on a missing type // "EXTERNAL_API_WARNING" - Warning that is present in an external api call // "SCHEMA_VALIDATION_IGNORED" - When a resource schema validation is @@ -1125,6 +1321,17 @@ type OperationWarnings struct { // "LIST_OVERHEAD_QUOTA_EXCEED" - Resource can't be retrieved due to list // overhead quota exceed which captures the amount of resources filtered out by // user-defined list filter. + // "QUOTA_INFO_UNAVAILABLE" - Quota information is not available to client + // requests (e.g: regions.list). + // "RESOURCE_USES_GLOBAL_DNS" - Indicates that a VM is using global DNS. Can + // also be used to indicate that a resource has attributes that could result in + // the creation of a VM that uses global DNS. + // "RESERVED_ENTRY_134" - Reserved entries for quickly adding new warnings + // without breaking dependent clients. + // "RESERVED_ENTRY_135" + // "RESERVED_ENTRY_136" + // "RESERVED_ENTRY_139" + // "RESERVED_ENTRY_141" Code string `json:"code,omitempty"` // Data: [Output Only] Metadata about this warning in key: value format. For // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } @@ -1300,6 +1507,63 @@ func (s Policy) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// QuotaExceededInfo: Additional details for quota exceeded error for resource +// quota. +type QuotaExceededInfo struct { + // Dimensions: The map holding related quota dimensions. + Dimensions map[string]string `json:"dimensions,omitempty"` + // FutureLimit: Future quota limit being rolled out. The limit's unit depends + // on the quota type or metric. + FutureLimit float64 `json:"futureLimit,omitempty"` + // Limit: Current effective quota limit. The limit's unit depends on the quota + // type or metric. + Limit float64 `json:"limit,omitempty"` + // LimitName: The name of the quota limit. + LimitName string `json:"limitName,omitempty"` + // MetricName: The Compute Engine quota metric name. + MetricName string `json:"metricName,omitempty"` + // RolloutStatus: Rollout status of the future quota limit. + // + // Possible values: + // "ROLLOUT_STATUS_UNSPECIFIED" - ROLLOUT_STATUS_UNSPECIFIED - Rollout status + // is not specified. The default value. + // "IN_PROGRESS" - IN_PROGRESS - A rollout is in process which will change + // the limit value to future limit. + RolloutStatus string `json:"rolloutStatus,omitempty"` + // ForceSendFields is a list of field names (e.g. "Dimensions") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Dimensions") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s QuotaExceededInfo) MarshalJSON() ([]byte, error) { + type NoMethod QuotaExceededInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *QuotaExceededInfo) UnmarshalJSON(data []byte) error { + type NoMethod QuotaExceededInfo + var s1 struct { + FutureLimit gensupport.JSONFloat64 `json:"futureLimit"` + Limit gensupport.JSONFloat64 `json:"limit"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.FutureLimit = float64(s1.FutureLimit) + s.Limit = float64(s1.Limit) + return nil +} + type Resource struct { // AccessControl: The Access Control Policy set on this resource. AccessControl *ResourceAccessControl `json:"accessControl,omitempty"` @@ -1390,6 +1654,14 @@ type ResourceWarnings struct { // overridden. Deprecated unused field. // "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING" - Warning that a resource is // in use. + // "NETWORK_ENDPOINT_NOT_DETACHED" - Warning that network endpoint was not + // detached. + // "PAGE_MISSING_RESULTS" - Current page contains less results than requested + // but a next page token exists. + // "SSL_POLICY_ENABLED_FEATURES_NOT_FETCHED" - Warning that SSL policy + // resource in the response does not contain information about the list of + // enabled features. + // "RESOURCE_NOT_FOUND_WARNING" - Warning that a resource is not found. // "MISSING_TYPE_DEPENDENCY" - A resource depends on a missing type // "EXTERNAL_API_WARNING" - Warning that is present in an external api call // "SCHEMA_VALIDATION_IGNORED" - When a resource schema validation is @@ -1413,6 +1685,17 @@ type ResourceWarnings struct { // "LIST_OVERHEAD_QUOTA_EXCEED" - Resource can't be retrieved due to list // overhead quota exceed which captures the amount of resources filtered out by // user-defined list filter. + // "QUOTA_INFO_UNAVAILABLE" - Quota information is not available to client + // requests (e.g: regions.list). + // "RESOURCE_USES_GLOBAL_DNS" - Indicates that a VM is using global DNS. Can + // also be used to indicate that a resource has attributes that could result in + // the creation of a VM that uses global DNS. + // "RESERVED_ENTRY_134" - Reserved entries for quickly adding new warnings + // without breaking dependent clients. + // "RESERVED_ENTRY_135" + // "RESERVED_ENTRY_136" + // "RESERVED_ENTRY_139" + // "RESERVED_ENTRY_141" Code string `json:"code,omitempty"` // Data: [Output Only] Metadata about this warning in key: value format. For // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } @@ -1571,22 +1854,33 @@ func (s ResourceUpdateError) MarshalJSON() ([]byte, error) { } type ResourceUpdateErrorErrors struct { + // Arguments: [Output Only] Optional error details WARNING: DO NOT MAKE VISIBLE + // This is for internal use-only (like componentization) (thus the visibility + // "none") and in case of public exposure it is strongly recommended to follow + // pattern of: https://aip.dev/193 and expose as details field. + Arguments []string `json:"arguments,omitempty"` // Code: [Output Only] The error type identifier for this error. - Code string `json:"code,omitempty"` + Code string `json:"code,omitempty"` + DebugInfo *DebugInfo `json:"debugInfo,omitempty"` + // ErrorDetails: [Output Only] An optional list of messages that contain the + // error details. There is a set of defined message types to use for providing + // details.The syntax depends on the error code. For example, QuotaExceededInfo + // will have details when the error code is QUOTA_EXCEEDED. + ErrorDetails []*ResourceUpdateErrorErrorsErrorDetails `json:"errorDetails,omitempty"` // Location: [Output Only] Indicates the field in the request that caused the // error. This property is optional. Location string `json:"location,omitempty"` // Message: [Output Only] An optional, human-readable error message. Message string `json:"message,omitempty"` - // ForceSendFields is a list of field names (e.g. "Code") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See + // ForceSendFields is a list of field names (e.g. "Arguments") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Code") to include in API requests - // with the JSON null value. By default, fields with empty values are omitted - // from API requests. See + // NullFields is a list of field names (e.g. "Arguments") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -1596,6 +1890,29 @@ func (s ResourceUpdateErrorErrors) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type ResourceUpdateErrorErrorsErrorDetails struct { + ErrorInfo *ErrorInfo `json:"errorInfo,omitempty"` + Help *Help `json:"help,omitempty"` + LocalizedMessage *LocalizedMessage `json:"localizedMessage,omitempty"` + QuotaInfo *QuotaExceededInfo `json:"quotaInfo,omitempty"` + // ForceSendFields is a list of field names (e.g. "ErrorInfo") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ErrorInfo") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ResourceUpdateErrorErrorsErrorDetails) MarshalJSON() ([]byte, error) { + type NoMethod ResourceUpdateErrorErrorsErrorDetails + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type ResourceUpdateWarnings struct { // Code: [Output Only] A warning code, if applicable. For example, Compute // Engine returns NO_RESULTS_ON_PAGE if there are no results in the response. @@ -1633,6 +1950,14 @@ type ResourceUpdateWarnings struct { // overridden. Deprecated unused field. // "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING" - Warning that a resource is // in use. + // "NETWORK_ENDPOINT_NOT_DETACHED" - Warning that network endpoint was not + // detached. + // "PAGE_MISSING_RESULTS" - Current page contains less results than requested + // but a next page token exists. + // "SSL_POLICY_ENABLED_FEATURES_NOT_FETCHED" - Warning that SSL policy + // resource in the response does not contain information about the list of + // enabled features. + // "RESOURCE_NOT_FOUND_WARNING" - Warning that a resource is not found. // "MISSING_TYPE_DEPENDENCY" - A resource depends on a missing type // "EXTERNAL_API_WARNING" - Warning that is present in an external api call // "SCHEMA_VALIDATION_IGNORED" - When a resource schema validation is @@ -1656,6 +1981,17 @@ type ResourceUpdateWarnings struct { // "LIST_OVERHEAD_QUOTA_EXCEED" - Resource can't be retrieved due to list // overhead quota exceed which captures the amount of resources filtered out by // user-defined list filter. + // "QUOTA_INFO_UNAVAILABLE" - Quota information is not available to client + // requests (e.g: regions.list). + // "RESOURCE_USES_GLOBAL_DNS" - Indicates that a VM is using global DNS. Can + // also be used to indicate that a resource has attributes that could result in + // the creation of a VM that uses global DNS. + // "RESERVED_ENTRY_134" - Reserved entries for quickly adding new warnings + // without breaking dependent clients. + // "RESERVED_ENTRY_135" + // "RESERVED_ENTRY_136" + // "RESERVED_ENTRY_139" + // "RESERVED_ENTRY_141" Code string `json:"code,omitempty"` // Data: [Output Only] Metadata about this warning in key: value format. For // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } @@ -2100,6 +2436,13 @@ func (c *DeploymentsDeleteCall) DeletePolicy(deletePolicy string) *DeploymentsDe return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *DeploymentsDeleteCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *DeploymentsDeleteCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -2200,6 +2543,13 @@ func (r *DeploymentsService) Get(project string, deployment string) *Deployments return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *DeploymentsGetCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *DeploymentsGetCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -2312,6 +2662,13 @@ func (r *DeploymentsService) GetIamPolicy(project string, resource string) *Depl return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *DeploymentsGetIamPolicyCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *DeploymentsGetIamPolicyCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // OptionsRequestedPolicyVersion sets the optional parameter // "optionsRequestedPolicyVersion": Requested IAM Policy version. func (c *DeploymentsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *DeploymentsGetIamPolicyCall { @@ -2441,6 +2798,13 @@ func (c *DeploymentsInsertCall) CreatePolicy(createPolicy string) *DeploymentsIn return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *DeploymentsInsertCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *DeploymentsInsertCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Preview sets the optional parameter "preview": If set to true, creates a // deployment and creates "shell" resources but does not actually instantiate // these resources. This allows you to preview what your deployment looks like. @@ -2780,6 +3144,13 @@ func (c *DeploymentsPatchCall) DeletePolicy(deletePolicy string) *DeploymentsPat return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *DeploymentsPatchCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *DeploymentsPatchCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Preview sets the optional parameter "preview": If set to true, updates the // deployment and creates and updates the "shell" resources but does not // actually alter or instantiate these resources. This allows you to preview @@ -3113,6 +3484,13 @@ func (r *DeploymentsService) TestIamPermissions(project string, resource string, return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *DeploymentsTestIamPermissionsCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *DeploymentsTestIamPermissionsCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -3244,6 +3622,13 @@ func (c *DeploymentsUpdateCall) DeletePolicy(deletePolicy string) *DeploymentsUp return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *DeploymentsUpdateCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *DeploymentsUpdateCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Preview sets the optional parameter "preview": If set to true, updates the // deployment and creates and updates the "shell" resources but does not // actually alter or instantiate these resources. This allows you to preview @@ -3366,6 +3751,13 @@ func (r *ManifestsService) Get(project string, deployment string, manifest strin return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *ManifestsGetCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *ManifestsGetCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -3679,6 +4071,13 @@ func (r *OperationsService) Get(project string, operation string) *OperationsGet return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *OperationsGetCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *OperationsGetCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -3990,6 +4389,13 @@ func (r *ResourcesService) Get(project string, deployment string, resource strin return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *ResourcesGetCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *ResourcesGetCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. diff --git a/deploymentmanager/v2beta/deploymentmanager-api.json b/deploymentmanager/v2beta/deploymentmanager-api.json index 55ddef43073..efc35b121ec 100644 --- a/deploymentmanager/v2beta/deploymentmanager-api.json +++ b/deploymentmanager/v2beta/deploymentmanager-api.json @@ -132,6 +132,10 @@ "required": true, "type": "string" }, + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "The project ID for this request.", "location": "path", @@ -166,6 +170,10 @@ "required": true, "type": "string" }, + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "The project ID for this request.", "location": "path", @@ -194,6 +202,10 @@ "project" ], "parameters": { + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "The project ID for this request.", "location": "path", @@ -282,6 +294,10 @@ "required": true, "type": "string" }, + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "The project ID for this request.", "location": "path", @@ -319,6 +335,10 @@ "required": true, "type": "string" }, + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "The project ID for this request.", "location": "path", @@ -410,6 +430,10 @@ "required": true, "type": "string" }, + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "The project ID for this request.", "location": "path", @@ -444,6 +468,10 @@ "required": true, "type": "string" }, + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "The project ID for this request.", "location": "path", @@ -473,6 +501,10 @@ "resource" ], "parameters": { + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "optionsRequestedPolicyVersion": { "description": "Requested IAM Policy version.", "format": "int32", @@ -528,6 +560,10 @@ "location": "query", "type": "string" }, + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "preview": { "description": "If set to true, creates a deployment and creates \"shell\" resources but does not actually instantiate these resources. This allows you to preview what your deployment looks like. After previewing a deployment, you can deploy your resources by making a request with the `update()` method or you can use the `cancelPreview()` method to cancel the preview altogether. Note that the deployment will still exist after you cancel the preview and you must separately delete this deployment if you want to remove it.", "location": "query", @@ -651,6 +687,10 @@ "required": true, "type": "string" }, + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "preview": { "default": "false", "description": "If set to true, updates the deployment and creates and updates the \"shell\" resources but does not actually alter or instantiate these resources. This allows you to preview what your deployment will look like. You can use this intent to preview how an update would affect your deployment. You must provide a `target.config` with a configuration if this is set to true. After previewing a deployment, you can deploy your resources by making a request with the `update()` or you can `cancelPreview()` to remove the preview altogether. Note that the deployment will still exist after you cancel the preview and you must separately delete this deployment if you want to remove it.", @@ -761,6 +801,10 @@ "resource" ], "parameters": { + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "Project ID for this request.", "location": "path", @@ -835,6 +879,10 @@ "required": true, "type": "string" }, + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "preview": { "default": "false", "description": "If set to true, updates the deployment and creates and updates the \"shell\" resources but does not actually alter or instantiate these resources. This allows you to preview what your deployment will look like. You can use this intent to preview how an update would affect your deployment. You must provide a `target.config` with a configuration if this is set to true. After previewing a deployment, you can deploy your resources by making a request with the `update()` or you can `cancelPreview()` to remove the preview altogether. Note that the deployment will still exist after you cancel the preview and you must separately delete this deployment if you want to remove it.", @@ -883,6 +931,10 @@ "required": true, "type": "string" }, + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "manifest": { "description": "The name of the manifest for this request.", "location": "path", @@ -982,6 +1034,10 @@ "operation" ], "parameters": { + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "operation": { "description": "The name of the operation for this request.", "location": "path", @@ -1080,6 +1136,10 @@ "required": true, "type": "string" }, + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "The project ID for this request.", "location": "path", @@ -1178,6 +1238,10 @@ "typeProvider" ], "parameters": { + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "The project ID for this request.", "location": "path", @@ -1212,6 +1276,10 @@ "typeProvider" ], "parameters": { + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "The project ID for this request.", "location": "path", @@ -1249,6 +1317,10 @@ "type" ], "parameters": { + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "The project ID for this request.", "location": "path", @@ -1290,6 +1362,10 @@ "project" ], "parameters": { + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "The project ID for this request.", "location": "path", @@ -1430,6 +1506,10 @@ "typeProvider" ], "parameters": { + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "The project ID for this request.", "location": "path", @@ -1467,6 +1547,10 @@ "typeProvider" ], "parameters": { + "header.bypassBillingFilter": { + "location": "query", + "type": "boolean" + }, "project": { "description": "The project ID for this request.", "location": "path", @@ -1552,7 +1636,7 @@ } } }, - "revision": "20240214", + "revision": "20241031", "rootUrl": "https://deploymentmanager.googleapis.com/", "schemas": { "AsyncOptions": { @@ -1855,6 +1939,24 @@ }, "type": "object" }, + "DebugInfo": { + "description": "Describes additional debugging info.", + "id": "DebugInfo", + "properties": { + "detail": { + "description": "Additional debugging information provided by the server.", + "type": "string" + }, + "stackEntries": { + "description": "The stack trace entries indicating where the error occurred.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "Deployment": { "id": "Deployment", "properties": { @@ -2030,6 +2132,28 @@ }, "type": "object" }, + "ErrorInfo": { + "description": "Describes the cause of the error with structured details. Example of an error when contacting the \"pubsub.googleapis.com\" API when it is not enabled: { \"reason\": \"API_DISABLED\" \"domain\": \"googleapis.com\" \"metadata\": { \"resource\": \"projects/123\", \"service\": \"pubsub.googleapis.com\" } } This response indicates that the pubsub.googleapis.com API is not enabled. Example of an error that is returned when attempting to create a Spanner instance in a region that is out of stock: { \"reason\": \"STOCKOUT\" \"domain\": \"spanner.googleapis.com\", \"metadata\": { \"availableRegions\": \"us-central1,us-east2\" } }", + "id": "ErrorInfo", + "properties": { + "domain": { + "description": "The logical grouping to which the \"reason\" belongs. The error domain is typically the registered service name of the tool or product that generates the error. Example: \"pubsub.googleapis.com\". If the error is generated by some common infrastructure, the error domain must be a globally unique value that identifies the infrastructure. For Google API infrastructure, the error domain is \"googleapis.com\".", + "type": "string" + }, + "metadata": { + "additionalProperties": { + "type": "string" + }, + "description": "Additional structured details about this error. Keys must match /a-z+/ but should ideally be lowerCamelCase. Also they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than {\"instanceLimit\": \"100/request\"}, should be returned as, {\"instanceLimitPerRequest\": \"100\"}, if the client exceeds the number of instances that can be created in a single (batch) request.", + "type": "object" + }, + "reason": { + "description": "The reason of the error. This is a constant value that identifies the proximate cause of the error. Error reasons are unique within a particular domain of errors. This should be at most 63 characters and match a regular expression of `A-Z+[A-Z0-9]`, which represents UPPER_SNAKE_CASE.", + "type": "string" + } + }, + "type": "object" + }, "Expr": { "description": "Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: \"Summary size limit\" description: \"Determines if a summary is less than 100 chars\" expression: \"document.summary.size() \u003c 100\" Example (Equality): title: \"Requestor is owner\" description: \"Determines if requestor is the document owner\" expression: \"document.owner == request.auth.claims.email\" Example (Logic): title: \"Public documents\" description: \"Determine whether the document should be publicly visible\" expression: \"document.type != 'private' \u0026\u0026 document.type != 'internal'\" Example (Data Manipulation): title: \"Notification string\" description: \"Create a notification string with a timestamp.\" expression: \"'New message received at ' + string(document.create_time)\" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information.", "id": "Expr", @@ -2071,6 +2195,39 @@ "policy": { "$ref": "Policy", "description": "REQUIRED: The complete policy to be applied to the 'resource'. The size of the policy is limited to a few 10s of KB. An empty policy is in general a valid policy but certain services (like Projects) might reject them." + }, + "updateMask": { + "format": "google-fieldmask", + "type": "string" + } + }, + "type": "object" + }, + "Help": { + "description": "Provides links to documentation or for performing an out of band action. For example, if a quota check failed with an error indicating the calling project hasn't enabled the accessed service, this can contain a URL pointing directly to the right place in the developer console to flip the bit.", + "id": "Help", + "properties": { + "links": { + "description": "URL(s) pointing to additional information on handling the current error.", + "items": { + "$ref": "HelpLink" + }, + "type": "array" + } + }, + "type": "object" + }, + "HelpLink": { + "description": "Describes a URL link.", + "id": "HelpLink", + "properties": { + "description": { + "description": "Describes what the link offers.", + "type": "string" + }, + "url": { + "description": "The URL of the link.", + "type": "string" } }, "type": "object" @@ -2139,6 +2296,21 @@ }, "type": "object" }, + "LocalizedMessage": { + "description": "Provides a localized error message that is safe to return to the user which can be attached to an RPC error.", + "id": "LocalizedMessage", + "properties": { + "locale": { + "description": "The locale used following the specification defined at https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: \"en-US\", \"fr-CH\", \"es-MX\"", + "type": "string" + }, + "message": { + "description": "The localized error message in the above locale.", + "type": "string" + } + }, + "type": "object" + }, "Manifest": { "id": "Manifest", "properties": { @@ -2235,10 +2407,41 @@ "description": "[Output Only] The array of errors encountered while processing this operation.", "items": { "properties": { + "arguments": { + "description": "[Output Only] Optional error details WARNING: DO NOT MAKE VISIBLE This is for internal use-only (like componentization) (thus the visibility \"none\") and in case of public exposure it is strongly recommended to follow pattern of: https://aip.dev/193 and expose as details field.", + "items": { + "type": "string" + }, + "type": "array" + }, "code": { "description": "[Output Only] The error type identifier for this error.", "type": "string" }, + "debugInfo": { + "$ref": "DebugInfo" + }, + "errorDetails": { + "description": "[Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED.", + "items": { + "properties": { + "errorInfo": { + "$ref": "ErrorInfo" + }, + "help": { + "$ref": "Help" + }, + "localizedMessage": { + "$ref": "LocalizedMessage" + }, + "quotaInfo": { + "$ref": "QuotaExceededInfo" + } + }, + "type": "object" + }, + "type": "array" + }, "location": { "description": "[Output Only] Indicates the field in the request that caused the error. This property is optional.", "type": "string" @@ -2306,6 +2509,10 @@ "description": "[Output Only] Server-defined URL for the resource.", "type": "string" }, + "selfLinkWithId": { + "description": "[Output Only] Server-defined URL for this resource with the resource id.", + "type": "string" + }, "setCommonInstanceMetadataOperationMetadata": { "$ref": "SetCommonInstanceMetadataOperationMetadata", "description": "[Output Only] If the operation is for projects.setCommonInstanceMetadata, this field will contain information on all underlying zonal actions and their state." @@ -2338,7 +2545,7 @@ "type": "string" }, "targetLink": { - "description": "[Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.", + "description": "[Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the disk that the snapshot was created from.", "type": "string" }, "user": { @@ -2369,6 +2576,10 @@ "CLEANUP_FAILED", "FIELD_VALUE_OVERRIDEN", "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "NETWORK_ENDPOINT_NOT_DETACHED", + "PAGE_MISSING_RESULTS", + "SSL_POLICY_ENABLED_FEATURES_NOT_FETCHED", + "RESOURCE_NOT_FOUND_WARNING", "MISSING_TYPE_DEPENDENCY", "EXTERNAL_API_WARNING", "SCHEMA_VALIDATION_IGNORED", @@ -2379,7 +2590,14 @@ "LARGE_DEPLOYMENT_WARNING", "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LIST_OVERHEAD_QUOTA_EXCEED" + "LIST_OVERHEAD_QUOTA_EXCEED", + "QUOTA_INFO_UNAVAILABLE", + "RESOURCE_USES_GLOBAL_DNS", + "RESERVED_ENTRY_134", + "RESERVED_ENTRY_135", + "RESERVED_ENTRY_136", + "RESERVED_ENTRY_139", + "RESERVED_ENTRY_141" ], "enumDeprecated": [ false, @@ -2409,6 +2627,17 @@ false, false, false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, false ], "enumDescriptions": [ @@ -2429,6 +2658,10 @@ "Warning about failed cleanup of transient changes made by a failed operation.", "Warning that value of a field has been overridden. Deprecated unused field.", "Warning that a resource is in use.", + "Warning that network endpoint was not detached.", + "Current page contains less results than requested but a next page token exists.", + "Warning that SSL policy resource in the response does not contain information about the list of enabled features.", + "Warning that a resource is not found.", "A resource depends on a missing type", "Warning that is present in an external api call", "When a resource schema validation is ignored.", @@ -2439,7 +2672,14 @@ "When deploying a deployment with a exceedingly large number of resources", "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter." + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "Quota information is not available to client requests (e.g: regions.list).", + "Indicates that a VM is using global DNS. Can also be used to indicate that a resource has attributes that could result in the creation of a VM that uses global DNS.", + "Reserved entries for quickly adding new warnings without breaking dependent clients.", + "", + "", + "", + "" ], "type": "string" }, @@ -2583,6 +2823,50 @@ }, "type": "object" }, + "QuotaExceededInfo": { + "description": "Additional details for quota exceeded error for resource quota.", + "id": "QuotaExceededInfo", + "properties": { + "dimensions": { + "additionalProperties": { + "type": "string" + }, + "description": "The map holding related quota dimensions.", + "type": "object" + }, + "futureLimit": { + "description": "Future quota limit being rolled out. The limit's unit depends on the quota type or metric.", + "format": "double", + "type": "number" + }, + "limit": { + "description": "Current effective quota limit. The limit's unit depends on the quota type or metric.", + "format": "double", + "type": "number" + }, + "limitName": { + "description": "The name of the quota limit.", + "type": "string" + }, + "metricName": { + "description": "The Compute Engine quota metric name.", + "type": "string" + }, + "rolloutStatus": { + "description": "Rollout status of the future quota limit.", + "enum": [ + "ROLLOUT_STATUS_UNSPECIFIED", + "IN_PROGRESS" + ], + "enumDescriptions": [ + "ROLLOUT_STATUS_UNSPECIFIED - Rollout status is not specified. The default value.", + "IN_PROGRESS - A rollout is in process which will change the limit value to future limit." + ], + "type": "string" + } + }, + "type": "object" + }, "Resource": { "id": "Resource", "properties": { @@ -2654,6 +2938,10 @@ "CLEANUP_FAILED", "FIELD_VALUE_OVERRIDEN", "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "NETWORK_ENDPOINT_NOT_DETACHED", + "PAGE_MISSING_RESULTS", + "SSL_POLICY_ENABLED_FEATURES_NOT_FETCHED", + "RESOURCE_NOT_FOUND_WARNING", "MISSING_TYPE_DEPENDENCY", "EXTERNAL_API_WARNING", "SCHEMA_VALIDATION_IGNORED", @@ -2664,7 +2952,14 @@ "LARGE_DEPLOYMENT_WARNING", "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LIST_OVERHEAD_QUOTA_EXCEED" + "LIST_OVERHEAD_QUOTA_EXCEED", + "QUOTA_INFO_UNAVAILABLE", + "RESOURCE_USES_GLOBAL_DNS", + "RESERVED_ENTRY_134", + "RESERVED_ENTRY_135", + "RESERVED_ENTRY_136", + "RESERVED_ENTRY_139", + "RESERVED_ENTRY_141" ], "enumDeprecated": [ false, @@ -2694,6 +2989,17 @@ false, false, false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, false ], "enumDescriptions": [ @@ -2714,6 +3020,10 @@ "Warning about failed cleanup of transient changes made by a failed operation.", "Warning that value of a field has been overridden. Deprecated unused field.", "Warning that a resource is in use.", + "Warning that network endpoint was not detached.", + "Current page contains less results than requested but a next page token exists.", + "Warning that SSL policy resource in the response does not contain information about the list of enabled features.", + "Warning that a resource is not found.", "A resource depends on a missing type", "Warning that is present in an external api call", "When a resource schema validation is ignored.", @@ -2724,7 +3034,14 @@ "When deploying a deployment with a exceedingly large number of resources", "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter." + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "Quota information is not available to client requests (e.g: regions.list).", + "Indicates that a VM is using global DNS. Can also be used to indicate that a resource has attributes that could result in the creation of a VM that uses global DNS.", + "Reserved entries for quickly adding new warnings without breaking dependent clients.", + "", + "", + "", + "" ], "type": "string" }, @@ -2782,10 +3099,41 @@ "description": "[Output Only] The array of errors encountered while processing this operation.", "items": { "properties": { + "arguments": { + "description": "[Output Only] Optional error details WARNING: DO NOT MAKE VISIBLE This is for internal use-only (like componentization) (thus the visibility \"none\") and in case of public exposure it is strongly recommended to follow pattern of: https://aip.dev/193 and expose as details field.", + "items": { + "type": "string" + }, + "type": "array" + }, "code": { "description": "[Output Only] The error type identifier for this error.", "type": "string" }, + "debugInfo": { + "$ref": "DebugInfo" + }, + "errorDetails": { + "description": "[Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED.", + "items": { + "properties": { + "errorInfo": { + "$ref": "ErrorInfo" + }, + "help": { + "$ref": "Help" + }, + "localizedMessage": { + "$ref": "LocalizedMessage" + }, + "quotaInfo": { + "$ref": "QuotaExceededInfo" + } + }, + "type": "object" + }, + "type": "array" + }, "location": { "description": "[Output Only] Indicates the field in the request that caused the error. This property is optional.", "type": "string" @@ -2876,6 +3224,10 @@ "CLEANUP_FAILED", "FIELD_VALUE_OVERRIDEN", "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "NETWORK_ENDPOINT_NOT_DETACHED", + "PAGE_MISSING_RESULTS", + "SSL_POLICY_ENABLED_FEATURES_NOT_FETCHED", + "RESOURCE_NOT_FOUND_WARNING", "MISSING_TYPE_DEPENDENCY", "EXTERNAL_API_WARNING", "SCHEMA_VALIDATION_IGNORED", @@ -2886,7 +3238,14 @@ "LARGE_DEPLOYMENT_WARNING", "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LIST_OVERHEAD_QUOTA_EXCEED" + "LIST_OVERHEAD_QUOTA_EXCEED", + "QUOTA_INFO_UNAVAILABLE", + "RESOURCE_USES_GLOBAL_DNS", + "RESERVED_ENTRY_134", + "RESERVED_ENTRY_135", + "RESERVED_ENTRY_136", + "RESERVED_ENTRY_139", + "RESERVED_ENTRY_141" ], "enumDeprecated": [ false, @@ -2916,6 +3275,17 @@ false, false, false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, false ], "enumDescriptions": [ @@ -2936,6 +3306,10 @@ "Warning about failed cleanup of transient changes made by a failed operation.", "Warning that value of a field has been overridden. Deprecated unused field.", "Warning that a resource is in use.", + "Warning that network endpoint was not detached.", + "Current page contains less results than requested but a next page token exists.", + "Warning that SSL policy resource in the response does not contain information about the list of enabled features.", + "Warning that a resource is not found.", "A resource depends on a missing type", "Warning that is present in an external api call", "When a resource schema validation is ignored.", @@ -2946,7 +3320,14 @@ "When deploying a deployment with a exceedingly large number of resources", "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter." + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "Quota information is not available to client requests (e.g: regions.list).", + "Indicates that a VM is using global DNS. Can also be used to indicate that a resource has attributes that could result in the creation of a VM that uses global DNS.", + "Reserved entries for quickly adding new warnings without breaking dependent clients.", + "", + "", + "", + "" ], "type": "string" }, diff --git a/deploymentmanager/v2beta/deploymentmanager-gen.go b/deploymentmanager/v2beta/deploymentmanager-gen.go index 5e30a9fe793..9e4452828f3 100644 --- a/deploymentmanager/v2beta/deploymentmanager-gen.go +++ b/deploymentmanager/v2beta/deploymentmanager-gen.go @@ -722,6 +722,30 @@ func (s Credential) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// DebugInfo: Describes additional debugging info. +type DebugInfo struct { + // Detail: Additional debugging information provided by the server. + Detail string `json:"detail,omitempty"` + // StackEntries: The stack trace entries indicating where the error occurred. + StackEntries []string `json:"stackEntries,omitempty"` + // ForceSendFields is a list of field names (e.g. "Detail") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Detail") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s DebugInfo) MarshalJSON() ([]byte, error) { + type NoMethod DebugInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type Deployment struct { // Description: An optional user-provided description of the deployment. Description string `json:"description,omitempty"` @@ -990,6 +1014,54 @@ func (s Diagnostic) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ErrorInfo: Describes the cause of the error with structured details. Example +// of an error when contacting the "pubsub.googleapis.com" API when it is not +// enabled: { "reason": "API_DISABLED" "domain": "googleapis.com" "metadata": { +// "resource": "projects/123", "service": "pubsub.googleapis.com" } } This +// response indicates that the pubsub.googleapis.com API is not enabled. +// Example of an error that is returned when attempting to create a Spanner +// instance in a region that is out of stock: { "reason": "STOCKOUT" "domain": +// "spanner.googleapis.com", "metadata": { "availableRegions": +// "us-central1,us-east2" } } +type ErrorInfo struct { + // Domain: The logical grouping to which the "reason" belongs. The error domain + // is typically the registered service name of the tool or product that + // generates the error. Example: "pubsub.googleapis.com". If the error is + // generated by some common infrastructure, the error domain must be a globally + // unique value that identifies the infrastructure. For Google API + // infrastructure, the error domain is "googleapis.com". + Domain string `json:"domain,omitempty"` + // Metadata: Additional structured details about this error. Keys must match + // /a-z+/ but should ideally be lowerCamelCase. Also they must be limited to 64 + // characters in length. When identifying the current value of an exceeded + // limit, the units should be contained in the key, not the value. For example, + // rather than {"instanceLimit": "100/request"}, should be returned as, + // {"instanceLimitPerRequest": "100"}, if the client exceeds the number of + // instances that can be created in a single (batch) request. + Metadata map[string]string `json:"metadata,omitempty"` + // Reason: The reason of the error. This is a constant value that identifies + // the proximate cause of the error. Error reasons are unique within a + // particular domain of errors. This should be at most 63 characters and match + // a regular expression of `A-Z+[A-Z0-9]`, which represents UPPER_SNAKE_CASE. + Reason string `json:"reason,omitempty"` + // ForceSendFields is a list of field names (e.g. "Domain") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Domain") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ErrorInfo) MarshalJSON() ([]byte, error) { + type NoMethod ErrorInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Expr: Represents a textual expression in the Common Expression Language // (CEL) syntax. CEL is a C-like expression language. The syntax and semantics // of CEL are documented at https://github.com/google/cel-spec. Example @@ -1049,7 +1121,8 @@ type GlobalSetPolicyRequest struct { // size of the policy is limited to a few 10s of KB. An empty policy is in // general a valid policy but certain services (like Projects) might reject // them. - Policy *Policy `json:"policy,omitempty"` + Policy *Policy `json:"policy,omitempty"` + UpdateMask string `json:"updateMask,omitempty"` // ForceSendFields is a list of field names (e.g. "Bindings") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -1068,6 +1141,57 @@ func (s GlobalSetPolicyRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// Help: Provides links to documentation or for performing an out of band +// action. For example, if a quota check failed with an error indicating the +// calling project hasn't enabled the accessed service, this can contain a URL +// pointing directly to the right place in the developer console to flip the +// bit. +type Help struct { + // Links: URL(s) pointing to additional information on handling the current + // error. + Links []*HelpLink `json:"links,omitempty"` + // ForceSendFields is a list of field names (e.g. "Links") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Links") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s Help) MarshalJSON() ([]byte, error) { + type NoMethod Help + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// HelpLink: Describes a URL link. +type HelpLink struct { + // Description: Describes what the link offers. + Description string `json:"description,omitempty"` + // Url: The URL of the link. + Url string `json:"url,omitempty"` + // ForceSendFields is a list of field names (e.g. "Description") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Description") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s HelpLink) MarshalJSON() ([]byte, error) { + type NoMethod HelpLink + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type ImportFile struct { // Content: The contents of the file. Content string `json:"content,omitempty"` @@ -1150,6 +1274,33 @@ func (s InstancesBulkInsertOperationMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// LocalizedMessage: Provides a localized error message that is safe to return +// to the user which can be attached to an RPC error. +type LocalizedMessage struct { + // Locale: The locale used following the specification defined at + // https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: "en-US", + // "fr-CH", "es-MX" + Locale string `json:"locale,omitempty"` + // Message: The localized error message in the above locale. + Message string `json:"message,omitempty"` + // ForceSendFields is a list of field names (e.g. "Locale") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Locale") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s LocalizedMessage) MarshalJSON() ([]byte, error) { + type NoMethod LocalizedMessage + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type Manifest struct { // Config: Output only. The YAML configuration for this manifest. Config *ConfigFile `json:"config,omitempty"` @@ -1287,6 +1438,9 @@ type Operation struct { Region string `json:"region,omitempty"` // SelfLink: [Output Only] Server-defined URL for the resource. SelfLink string `json:"selfLink,omitempty"` + // SelfLinkWithId: [Output Only] Server-defined URL for this resource with the + // resource id. + SelfLinkWithId string `json:"selfLinkWithId,omitempty"` // SetCommonInstanceMetadataOperationMetadata: [Output Only] If the operation // is for projects.setCommonInstanceMetadata, this field will contain // information on all underlying zonal actions and their state. @@ -1310,7 +1464,7 @@ type Operation struct { TargetId uint64 `json:"targetId,omitempty,string"` // TargetLink: [Output Only] The URL of the resource that the operation // modifies. For operations related to creating a snapshot, this points to the - // persistent disk that the snapshot was created from. + // disk that the snapshot was created from. TargetLink string `json:"targetLink,omitempty"` // User: [Output Only] User who requested the operation, for example: // `user@example.com` or `alice_smith_identifier @@ -1368,22 +1522,33 @@ func (s OperationError) MarshalJSON() ([]byte, error) { } type OperationErrorErrors struct { + // Arguments: [Output Only] Optional error details WARNING: DO NOT MAKE VISIBLE + // This is for internal use-only (like componentization) (thus the visibility + // "none") and in case of public exposure it is strongly recommended to follow + // pattern of: https://aip.dev/193 and expose as details field. + Arguments []string `json:"arguments,omitempty"` // Code: [Output Only] The error type identifier for this error. - Code string `json:"code,omitempty"` + Code string `json:"code,omitempty"` + DebugInfo *DebugInfo `json:"debugInfo,omitempty"` + // ErrorDetails: [Output Only] An optional list of messages that contain the + // error details. There is a set of defined message types to use for providing + // details.The syntax depends on the error code. For example, QuotaExceededInfo + // will have details when the error code is QUOTA_EXCEEDED. + ErrorDetails []*OperationErrorErrorsErrorDetails `json:"errorDetails,omitempty"` // Location: [Output Only] Indicates the field in the request that caused the // error. This property is optional. Location string `json:"location,omitempty"` // Message: [Output Only] An optional, human-readable error message. Message string `json:"message,omitempty"` - // ForceSendFields is a list of field names (e.g. "Code") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See + // ForceSendFields is a list of field names (e.g. "Arguments") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Code") to include in API requests - // with the JSON null value. By default, fields with empty values are omitted - // from API requests. See + // NullFields is a list of field names (e.g. "Arguments") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -1393,6 +1558,29 @@ func (s OperationErrorErrors) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type OperationErrorErrorsErrorDetails struct { + ErrorInfo *ErrorInfo `json:"errorInfo,omitempty"` + Help *Help `json:"help,omitempty"` + LocalizedMessage *LocalizedMessage `json:"localizedMessage,omitempty"` + QuotaInfo *QuotaExceededInfo `json:"quotaInfo,omitempty"` + // ForceSendFields is a list of field names (e.g. "ErrorInfo") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ErrorInfo") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s OperationErrorErrorsErrorDetails) MarshalJSON() ([]byte, error) { + type NoMethod OperationErrorErrorsErrorDetails + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type OperationWarnings struct { // Code: [Output Only] A warning code, if applicable. For example, Compute // Engine returns NO_RESULTS_ON_PAGE if there are no results in the response. @@ -1430,6 +1618,14 @@ type OperationWarnings struct { // overridden. Deprecated unused field. // "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING" - Warning that a resource is // in use. + // "NETWORK_ENDPOINT_NOT_DETACHED" - Warning that network endpoint was not + // detached. + // "PAGE_MISSING_RESULTS" - Current page contains less results than requested + // but a next page token exists. + // "SSL_POLICY_ENABLED_FEATURES_NOT_FETCHED" - Warning that SSL policy + // resource in the response does not contain information about the list of + // enabled features. + // "RESOURCE_NOT_FOUND_WARNING" - Warning that a resource is not found. // "MISSING_TYPE_DEPENDENCY" - A resource depends on a missing type // "EXTERNAL_API_WARNING" - Warning that is present in an external api call // "SCHEMA_VALIDATION_IGNORED" - When a resource schema validation is @@ -1453,6 +1649,17 @@ type OperationWarnings struct { // "LIST_OVERHEAD_QUOTA_EXCEED" - Resource can't be retrieved due to list // overhead quota exceed which captures the amount of resources filtered out by // user-defined list filter. + // "QUOTA_INFO_UNAVAILABLE" - Quota information is not available to client + // requests (e.g: regions.list). + // "RESOURCE_USES_GLOBAL_DNS" - Indicates that a VM is using global DNS. Can + // also be used to indicate that a resource has attributes that could result in + // the creation of a VM that uses global DNS. + // "RESERVED_ENTRY_134" - Reserved entries for quickly adding new warnings + // without breaking dependent clients. + // "RESERVED_ENTRY_135" + // "RESERVED_ENTRY_136" + // "RESERVED_ENTRY_139" + // "RESERVED_ENTRY_141" Code string `json:"code,omitempty"` // Data: [Output Only] Metadata about this warning in key: value format. For // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } @@ -1696,6 +1903,63 @@ func (s PollingOptions) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// QuotaExceededInfo: Additional details for quota exceeded error for resource +// quota. +type QuotaExceededInfo struct { + // Dimensions: The map holding related quota dimensions. + Dimensions map[string]string `json:"dimensions,omitempty"` + // FutureLimit: Future quota limit being rolled out. The limit's unit depends + // on the quota type or metric. + FutureLimit float64 `json:"futureLimit,omitempty"` + // Limit: Current effective quota limit. The limit's unit depends on the quota + // type or metric. + Limit float64 `json:"limit,omitempty"` + // LimitName: The name of the quota limit. + LimitName string `json:"limitName,omitempty"` + // MetricName: The Compute Engine quota metric name. + MetricName string `json:"metricName,omitempty"` + // RolloutStatus: Rollout status of the future quota limit. + // + // Possible values: + // "ROLLOUT_STATUS_UNSPECIFIED" - ROLLOUT_STATUS_UNSPECIFIED - Rollout status + // is not specified. The default value. + // "IN_PROGRESS" - IN_PROGRESS - A rollout is in process which will change + // the limit value to future limit. + RolloutStatus string `json:"rolloutStatus,omitempty"` + // ForceSendFields is a list of field names (e.g. "Dimensions") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Dimensions") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s QuotaExceededInfo) MarshalJSON() ([]byte, error) { + type NoMethod QuotaExceededInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *QuotaExceededInfo) UnmarshalJSON(data []byte) error { + type NoMethod QuotaExceededInfo + var s1 struct { + FutureLimit gensupport.JSONFloat64 `json:"futureLimit"` + Limit gensupport.JSONFloat64 `json:"limit"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.FutureLimit = float64(s1.FutureLimit) + s.Limit = float64(s1.Limit) + return nil +} + type Resource struct { // AccessControl: The Access Control Policy set on this resource. AccessControl *ResourceAccessControl `json:"accessControl,omitempty"` @@ -1786,6 +2050,14 @@ type ResourceWarnings struct { // overridden. Deprecated unused field. // "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING" - Warning that a resource is // in use. + // "NETWORK_ENDPOINT_NOT_DETACHED" - Warning that network endpoint was not + // detached. + // "PAGE_MISSING_RESULTS" - Current page contains less results than requested + // but a next page token exists. + // "SSL_POLICY_ENABLED_FEATURES_NOT_FETCHED" - Warning that SSL policy + // resource in the response does not contain information about the list of + // enabled features. + // "RESOURCE_NOT_FOUND_WARNING" - Warning that a resource is not found. // "MISSING_TYPE_DEPENDENCY" - A resource depends on a missing type // "EXTERNAL_API_WARNING" - Warning that is present in an external api call // "SCHEMA_VALIDATION_IGNORED" - When a resource schema validation is @@ -1809,6 +2081,17 @@ type ResourceWarnings struct { // "LIST_OVERHEAD_QUOTA_EXCEED" - Resource can't be retrieved due to list // overhead quota exceed which captures the amount of resources filtered out by // user-defined list filter. + // "QUOTA_INFO_UNAVAILABLE" - Quota information is not available to client + // requests (e.g: regions.list). + // "RESOURCE_USES_GLOBAL_DNS" - Indicates that a VM is using global DNS. Can + // also be used to indicate that a resource has attributes that could result in + // the creation of a VM that uses global DNS. + // "RESERVED_ENTRY_134" - Reserved entries for quickly adding new warnings + // without breaking dependent clients. + // "RESERVED_ENTRY_135" + // "RESERVED_ENTRY_136" + // "RESERVED_ENTRY_139" + // "RESERVED_ENTRY_141" Code string `json:"code,omitempty"` // Data: [Output Only] Metadata about this warning in key: value format. For // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } @@ -1967,22 +2250,33 @@ func (s ResourceUpdateError) MarshalJSON() ([]byte, error) { } type ResourceUpdateErrorErrors struct { + // Arguments: [Output Only] Optional error details WARNING: DO NOT MAKE VISIBLE + // This is for internal use-only (like componentization) (thus the visibility + // "none") and in case of public exposure it is strongly recommended to follow + // pattern of: https://aip.dev/193 and expose as details field. + Arguments []string `json:"arguments,omitempty"` // Code: [Output Only] The error type identifier for this error. - Code string `json:"code,omitempty"` + Code string `json:"code,omitempty"` + DebugInfo *DebugInfo `json:"debugInfo,omitempty"` + // ErrorDetails: [Output Only] An optional list of messages that contain the + // error details. There is a set of defined message types to use for providing + // details.The syntax depends on the error code. For example, QuotaExceededInfo + // will have details when the error code is QUOTA_EXCEEDED. + ErrorDetails []*ResourceUpdateErrorErrorsErrorDetails `json:"errorDetails,omitempty"` // Location: [Output Only] Indicates the field in the request that caused the // error. This property is optional. Location string `json:"location,omitempty"` // Message: [Output Only] An optional, human-readable error message. Message string `json:"message,omitempty"` - // ForceSendFields is a list of field names (e.g. "Code") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See + // ForceSendFields is a list of field names (e.g. "Arguments") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Code") to include in API requests - // with the JSON null value. By default, fields with empty values are omitted - // from API requests. See + // NullFields is a list of field names (e.g. "Arguments") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -1992,6 +2286,29 @@ func (s ResourceUpdateErrorErrors) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type ResourceUpdateErrorErrorsErrorDetails struct { + ErrorInfo *ErrorInfo `json:"errorInfo,omitempty"` + Help *Help `json:"help,omitempty"` + LocalizedMessage *LocalizedMessage `json:"localizedMessage,omitempty"` + QuotaInfo *QuotaExceededInfo `json:"quotaInfo,omitempty"` + // ForceSendFields is a list of field names (e.g. "ErrorInfo") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ErrorInfo") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ResourceUpdateErrorErrorsErrorDetails) MarshalJSON() ([]byte, error) { + type NoMethod ResourceUpdateErrorErrorsErrorDetails + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type ResourceUpdateWarnings struct { // Code: [Output Only] A warning code, if applicable. For example, Compute // Engine returns NO_RESULTS_ON_PAGE if there are no results in the response. @@ -2029,6 +2346,14 @@ type ResourceUpdateWarnings struct { // overridden. Deprecated unused field. // "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING" - Warning that a resource is // in use. + // "NETWORK_ENDPOINT_NOT_DETACHED" - Warning that network endpoint was not + // detached. + // "PAGE_MISSING_RESULTS" - Current page contains less results than requested + // but a next page token exists. + // "SSL_POLICY_ENABLED_FEATURES_NOT_FETCHED" - Warning that SSL policy + // resource in the response does not contain information about the list of + // enabled features. + // "RESOURCE_NOT_FOUND_WARNING" - Warning that a resource is not found. // "MISSING_TYPE_DEPENDENCY" - A resource depends on a missing type // "EXTERNAL_API_WARNING" - Warning that is present in an external api call // "SCHEMA_VALIDATION_IGNORED" - When a resource schema validation is @@ -2052,6 +2377,17 @@ type ResourceUpdateWarnings struct { // "LIST_OVERHEAD_QUOTA_EXCEED" - Resource can't be retrieved due to list // overhead quota exceed which captures the amount of resources filtered out by // user-defined list filter. + // "QUOTA_INFO_UNAVAILABLE" - Quota information is not available to client + // requests (e.g: regions.list). + // "RESOURCE_USES_GLOBAL_DNS" - Indicates that a VM is using global DNS. Can + // also be used to indicate that a resource has attributes that could result in + // the creation of a VM that uses global DNS. + // "RESERVED_ENTRY_134" - Reserved entries for quickly adding new warnings + // without breaking dependent clients. + // "RESERVED_ENTRY_135" + // "RESERVED_ENTRY_136" + // "RESERVED_ENTRY_139" + // "RESERVED_ENTRY_141" Code string `json:"code,omitempty"` // Data: [Output Only] Metadata about this warning in key: value format. For // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } @@ -2728,6 +3064,13 @@ func (r *CompositeTypesService) Delete(project string, compositeType string) *Co return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *CompositeTypesDeleteCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *CompositeTypesDeleteCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -2828,6 +3171,13 @@ func (r *CompositeTypesService) Get(project string, compositeType string) *Compo return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *CompositeTypesGetCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *CompositeTypesGetCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -2937,6 +3287,13 @@ func (r *CompositeTypesService) Insert(project string, compositetype *CompositeT return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *CompositeTypesInsertCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *CompositeTypesInsertCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -3238,6 +3595,13 @@ func (r *CompositeTypesService) Patch(project string, compositeType string, comp return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *CompositeTypesPatchCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *CompositeTypesPatchCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -3343,6 +3707,13 @@ func (r *CompositeTypesService) Update(project string, compositeType string, com return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *CompositeTypesUpdateCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *CompositeTypesUpdateCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -3564,6 +3935,13 @@ func (c *DeploymentsDeleteCall) DeletePolicy(deletePolicy string) *DeploymentsDe return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *DeploymentsDeleteCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *DeploymentsDeleteCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -3664,6 +4042,13 @@ func (r *DeploymentsService) Get(project string, deployment string) *Deployments return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *DeploymentsGetCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *DeploymentsGetCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -3776,6 +4161,13 @@ func (r *DeploymentsService) GetIamPolicy(project string, resource string) *Depl return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *DeploymentsGetIamPolicyCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *DeploymentsGetIamPolicyCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // OptionsRequestedPolicyVersion sets the optional parameter // "optionsRequestedPolicyVersion": Requested IAM Policy version. func (c *DeploymentsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *DeploymentsGetIamPolicyCall { @@ -3906,6 +4298,13 @@ func (c *DeploymentsInsertCall) CreatePolicy(createPolicy string) *DeploymentsIn return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *DeploymentsInsertCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *DeploymentsInsertCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Preview sets the optional parameter "preview": If set to true, creates a // deployment and creates "shell" resources but does not actually instantiate // these resources. This allows you to preview what your deployment looks like. @@ -4246,6 +4645,13 @@ func (c *DeploymentsPatchCall) DeletePolicy(deletePolicy string) *DeploymentsPat return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *DeploymentsPatchCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *DeploymentsPatchCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Preview sets the optional parameter "preview": If set to true, updates the // deployment and creates and updates the "shell" resources but does not // actually alter or instantiate these resources. This allows you to preview @@ -4579,6 +4985,13 @@ func (r *DeploymentsService) TestIamPermissions(project string, resource string, return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *DeploymentsTestIamPermissionsCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *DeploymentsTestIamPermissionsCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -4711,6 +5124,13 @@ func (c *DeploymentsUpdateCall) DeletePolicy(deletePolicy string) *DeploymentsUp return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *DeploymentsUpdateCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *DeploymentsUpdateCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Preview sets the optional parameter "preview": If set to true, updates the // deployment and creates and updates the "shell" resources but does not // actually alter or instantiate these resources. This allows you to preview @@ -4833,6 +5253,13 @@ func (r *ManifestsService) Get(project string, deployment string, manifest strin return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *ManifestsGetCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *ManifestsGetCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -5146,6 +5573,13 @@ func (r *OperationsService) Get(project string, operation string) *OperationsGet return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *OperationsGetCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *OperationsGetCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -5457,6 +5891,13 @@ func (r *ResourcesService) Get(project string, deployment string, resource strin return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *ResourcesGetCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *ResourcesGetCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -5769,6 +6210,13 @@ func (r *TypeProvidersService) Delete(project string, typeProvider string) *Type return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *TypeProvidersDeleteCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *TypeProvidersDeleteCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -5869,6 +6317,13 @@ func (r *TypeProvidersService) Get(project string, typeProvider string) *TypePro return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *TypeProvidersGetCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *TypeProvidersGetCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -5983,6 +6438,13 @@ func (r *TypeProvidersService) GetType(project string, typeProvider string, type return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *TypeProvidersGetTypeCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *TypeProvidersGetTypeCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -6093,6 +6555,13 @@ func (r *TypeProvidersService) Insert(project string, typeprovider *TypeProvider return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *TypeProvidersInsertCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *TypeProvidersInsertCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -6595,6 +7064,13 @@ func (r *TypeProvidersService) Patch(project string, typeProvider string, typepr return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *TypeProvidersPatchCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *TypeProvidersPatchCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -6700,6 +7176,13 @@ func (r *TypeProvidersService) Update(project string, typeProvider string, typep return c } +// HeaderBypassBillingFilter sets the optional parameter +// "header.bypassBillingFilter": +func (c *TypeProvidersUpdateCall) HeaderBypassBillingFilter(headerBypassBillingFilter bool) *TypeProvidersUpdateCall { + c.urlParams_.Set("header.bypassBillingFilter", fmt.Sprint(headerBypassBillingFilter)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. diff --git a/youtube/v3/youtube-api.json b/youtube/v3/youtube-api.json index bfd81ab3b38..7b5d1a69a65 100644 --- a/youtube/v3/youtube-api.json +++ b/youtube/v3/youtube-api.json @@ -4133,7 +4133,7 @@ } } }, - "revision": "20241031", + "revision": "20241105", "rootUrl": "https://youtube.googleapis.com/", "schemas": { "AbuseReport": { @@ -11705,7 +11705,7 @@ "type": "string" }, "scheduledEndTime": { - "description": "The time that the broadcast is scheduled to end. If the value is empty or the property is not present, then the broadcast is scheduled to contiue indefinitely.", + "description": "The time that the broadcast is scheduled to end. If the value is empty or the property is not present, then the broadcast is scheduled to continue indefinitely.", "format": "date-time", "type": "string" }, diff --git a/youtube/v3/youtube-gen.go b/youtube/v3/youtube-gen.go index 35581b147ab..c71fac3755f 100644 --- a/youtube/v3/youtube-gen.go +++ b/youtube/v3/youtube-gen.go @@ -7946,7 +7946,7 @@ type VideoLiveStreamingDetails struct { ConcurrentViewers uint64 `json:"concurrentViewers,omitempty,string"` // ScheduledEndTime: The time that the broadcast is scheduled to end. If the // value is empty or the property is not present, then the broadcast is - // scheduled to contiue indefinitely. + // scheduled to continue indefinitely. ScheduledEndTime string `json:"scheduledEndTime,omitempty"` // ScheduledStartTime: The time that the broadcast is scheduled to begin. ScheduledStartTime string `json:"scheduledStartTime,omitempty"`