diff --git a/accessapproval/v1/accessapproval-api.json b/accessapproval/v1/accessapproval-api.json index 2e751fce6c3..41b09ea779d 100644 --- a/accessapproval/v1/accessapproval-api.json +++ b/accessapproval/v1/accessapproval-api.json @@ -913,7 +913,7 @@ } } }, - "revision": "20230324", + "revision": "20230421", "rootUrl": "https://accessapproval.googleapis.com/", "schemas": { "AccessApprovalServiceAccount": { @@ -971,6 +971,15 @@ "type": "string" }, "type": "array" + }, + "preferNoBroadApprovalRequests": { + "description": "This preference is communicated to Google personnel when sending an approval request but can be overridden if necessary.", + "type": "boolean" + }, + "preferredRequestExpirationDays": { + "description": "This preference is shared with Google personnel, but can be overridden if said personnel deems necessary. The approver ultimately can set the expiration at approval time.", + "format": "int32", + "type": "integer" } }, "type": "object" diff --git a/accessapproval/v1/accessapproval-gen.go b/accessapproval/v1/accessapproval-gen.go index 23b07d1c184..efa8a68430b 100644 --- a/accessapproval/v1/accessapproval-gen.go +++ b/accessapproval/v1/accessapproval-gen.go @@ -306,6 +306,16 @@ type AccessApprovalSettings struct { // allowed. NotificationEmails []string `json:"notificationEmails,omitempty"` + // PreferNoBroadApprovalRequests: This preference is communicated to + // Google personnel when sending an approval request but can be + // overridden if necessary. + PreferNoBroadApprovalRequests bool `json:"preferNoBroadApprovalRequests,omitempty"` + + // PreferredRequestExpirationDays: This preference is shared with Google + // personnel, but can be overridden if said personnel deems necessary. + // The approver ultimately can set the expiration at approval time. + PreferredRequestExpirationDays int64 `json:"preferredRequestExpirationDays,omitempty"` + // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` diff --git a/analyticsadmin/v1alpha/analyticsadmin-api.json b/analyticsadmin/v1alpha/analyticsadmin-api.json index 7c2153bce6f..cb5ab92cbe5 100644 --- a/analyticsadmin/v1alpha/analyticsadmin-api.json +++ b/analyticsadmin/v1alpha/analyticsadmin-api.json @@ -4062,7 +4062,7 @@ } } }, - "revision": "20230416", + "revision": "20230424", "rootUrl": "https://analyticsadmin.googleapis.com/", "schemas": { "GoogleAnalyticsAdminV1alphaAccessBetweenFilter": { @@ -4705,11 +4705,11 @@ "description": "A filter for numeric or date values between certain values on a dimension or metric." }, "fieldName": { - "description": "Required. Immutable. The dimension name or metric name to filter.", + "description": "Required. Immutable. The dimension name or metric name to filter. If the field name refers to a custom dimension or metric, a scope prefix will be added to the front of the custom dimensions or metric name. For more on scope prefixes or custom dimensions/metrics, reference the [Google Analytics Data API documentation] (https://developers.google.com/analytics/devguides/reporting/data/v1/api-schema#custom_dimensions).", "type": "string" }, "inAnyNDayPeriod": { - "description": "Optional. If set, specifies the time window for which to evaluate data in number of days. If not set, then audience data is evaluated against lifetime data (i.e., infinite time window). For example, if set to 1 day, only the current day's data is evaluated. The reference point is the current day when at_any_point_in_time is unset or false. It can only be set when Audience scope is ACROSS_ALL_SESSIONS and cannot be greater than 60 days.", + "description": "Optional. If set, specifies the time window for which to evaluate data in number of days. If not set, then audience data is evaluated against lifetime data (For example, infinite time window). For example, if set to 1 day, only the current day's data is evaluated. The reference point is the current day when at_any_point_in_time is unset or false. It can only be set when Audience scope is ACROSS_ALL_SESSIONS and cannot be greater than 60 days.", "format": "int32", "type": "integer" }, @@ -4850,7 +4850,7 @@ }, "eventParameterFilterExpression": { "$ref": "GoogleAnalyticsAdminV1alphaAudienceFilterExpression", - "description": "Optional. If specified, this filter matches events that match both the single event name and the parameter filter expressions. AudienceEventFilter inside the parameter filter expression cannot be set (i.e., nested event filters are not supported). This should be a single and_group of dimension_or_metric_filter or not_expression; ANDs of ORs are not supported. Also, if it includes a filter for \"eventCount\", only that one will be considered; all the other filters will be ignored." + "description": "Optional. If specified, this filter matches events that match both the single event name and the parameter filter expressions. AudienceEventFilter inside the parameter filter expression cannot be set (For example, nested event filters are not supported). This should be a single and_group of dimension_or_metric_filter or not_expression; ANDs of ORs are not supported. Also, if it includes a filter for \"eventCount\", only that one will be considered; all the other filters will be ignored." } }, "type": "object" @@ -4881,7 +4881,7 @@ "type": "object" }, "GoogleAnalyticsAdminV1alphaAudienceFilterClause": { - "description": "A clause for defining either a simple or sequence filter. A filter can be inclusive (i.e., users satisfying the filter clause are included in the Audience) or exclusive (i.e., users satisfying the filter clause are excluded from the Audience).", + "description": "A clause for defining either a simple or sequence filter. A filter can be inclusive (For example, users satisfying the filter clause are included in the Audience) or exclusive (For example, users satisfying the filter clause are excluded from the Audience).", "id": "GoogleAnalyticsAdminV1alphaAudienceFilterClause", "properties": { "clauseType": { @@ -4927,7 +4927,7 @@ }, "notExpression": { "$ref": "GoogleAnalyticsAdminV1alphaAudienceFilterExpression", - "description": "A filter expression to be NOT'ed (i.e., inverted, complemented). It can only include a dimension_or_metric_filter. This cannot be set on the top level AudienceFilterExpression." + "description": "A filter expression to be NOT'ed (For example, inverted, complemented). It can only include a dimension_or_metric_filter. This cannot be set on the top level AudienceFilterExpression." }, "orGroup": { "$ref": "GoogleAnalyticsAdminV1alphaAudienceFilterExpressionList", @@ -4990,7 +4990,7 @@ "id": "GoogleAnalyticsAdminV1alphaAudienceSequenceFilterAudienceSequenceStep", "properties": { "constraintDuration": { - "description": "Optional. When set, this step must be satisfied within the constraint_duration of the previous step (i.e., t[i] - t[i-1] \u003c= constraint_duration). If not set, there is no duration requirement (the duration is effectively unlimited). It is ignored for the first step.", + "description": "Optional. When set, this step must be satisfied within the constraint_duration of the previous step (For example, t[i] - t[i-1] \u003c= constraint_duration). If not set, there is no duration requirement (the duration is effectively unlimited). It is ignored for the first step.", "format": "google-duration", "type": "string" }, diff --git a/analyticsadmin/v1alpha/analyticsadmin-gen.go b/analyticsadmin/v1alpha/analyticsadmin-gen.go index e3a8f4f0479..3de9d5891c2 100644 --- a/analyticsadmin/v1alpha/analyticsadmin-gen.go +++ b/analyticsadmin/v1alpha/analyticsadmin-gen.go @@ -1559,13 +1559,17 @@ type GoogleAnalyticsAdminV1alphaAudienceDimensionOrMetricFilter struct { BetweenFilter *GoogleAnalyticsAdminV1alphaAudienceDimensionOrMetricFilterBetweenFilter `json:"betweenFilter,omitempty"` // FieldName: Required. Immutable. The dimension name or metric name to - // filter. + // filter. If the field name refers to a custom dimension or metric, a + // scope prefix will be added to the front of the custom dimensions or + // metric name. For more on scope prefixes or custom dimensions/metrics, + // reference the [Google Analytics Data API documentation] + // (https://developers.google.com/analytics/devguides/reporting/data/v1/api-schema#custom_dimensions). FieldName string `json:"fieldName,omitempty"` // InAnyNDayPeriod: Optional. If set, specifies the time window for // which to evaluate data in number of days. If not set, then audience - // data is evaluated against lifetime data (i.e., infinite time window). - // For example, if set to 1 day, only the current day's data is + // data is evaluated against lifetime data (For example, infinite time + // window). For example, if set to 1 day, only the current day's data is // evaluated. The reference point is the current day when // at_any_point_in_time is unset or false. It can only be set when // Audience scope is ACROSS_ALL_SESSIONS and cannot be greater than 60 @@ -1818,8 +1822,8 @@ type GoogleAnalyticsAdminV1alphaAudienceEventFilter struct { // EventParameterFilterExpression: Optional. If specified, this filter // matches events that match both the single event name and the // parameter filter expressions. AudienceEventFilter inside the - // parameter filter expression cannot be set (i.e., nested event filters - // are not supported). This should be a single and_group of + // parameter filter expression cannot be set (For example, nested event + // filters are not supported). This should be a single and_group of // dimension_or_metric_filter or not_expression; ANDs of ORs are not // supported. Also, if it includes a filter for "eventCount", only that // one will be considered; all the other filters will be ignored. @@ -1890,9 +1894,9 @@ func (s *GoogleAnalyticsAdminV1alphaAudienceEventTrigger) MarshalJSON() ([]byte, // GoogleAnalyticsAdminV1alphaAudienceFilterClause: A clause for // defining either a simple or sequence filter. A filter can be -// inclusive (i.e., users satisfying the filter clause are included in -// the Audience) or exclusive (i.e., users satisfying the filter clause -// are excluded from the Audience). +// inclusive (For example, users satisfying the filter clause are +// included in the Audience) or exclusive (For example, users satisfying +// the filter clause are excluded from the Audience). type GoogleAnalyticsAdminV1alphaAudienceFilterClause struct { // ClauseType: Required. Specifies whether this is an include or exclude // filter clause. @@ -1952,9 +1956,10 @@ type GoogleAnalyticsAdminV1alphaAudienceFilterExpression struct { // cannot be set on the top level AudienceFilterExpression. EventFilter *GoogleAnalyticsAdminV1alphaAudienceEventFilter `json:"eventFilter,omitempty"` - // NotExpression: A filter expression to be NOT'ed (i.e., inverted, - // complemented). It can only include a dimension_or_metric_filter. This - // cannot be set on the top level AudienceFilterExpression. + // NotExpression: A filter expression to be NOT'ed (For example, + // inverted, complemented). It can only include a + // dimension_or_metric_filter. This cannot be set on the top level + // AudienceFilterExpression. NotExpression *GoogleAnalyticsAdminV1alphaAudienceFilterExpression `json:"notExpression,omitempty"` // OrGroup: A list of expressions to OR’ed together. It cannot contain @@ -2069,10 +2074,10 @@ func (s *GoogleAnalyticsAdminV1alphaAudienceSequenceFilter) MarshalJSON() ([]byt // user to match the sequence. type GoogleAnalyticsAdminV1alphaAudienceSequenceFilterAudienceSequenceStep struct { // ConstraintDuration: Optional. When set, this step must be satisfied - // within the constraint_duration of the previous step (i.e., t[i] - - // t[i-1] <= constraint_duration). If not set, there is no duration - // requirement (the duration is effectively unlimited). It is ignored - // for the first step. + // within the constraint_duration of the previous step (For example, + // t[i] - t[i-1] <= constraint_duration). If not set, there is no + // duration requirement (the duration is effectively unlimited). It is + // ignored for the first step. ConstraintDuration string `json:"constraintDuration,omitempty"` // FilterExpression: Required. Immutable. A logical expression of diff --git a/analyticshub/v1/analyticshub-api.json b/analyticshub/v1/analyticshub-api.json index 661dee2838c..120aab8db2b 100644 --- a/analyticshub/v1/analyticshub-api.json +++ b/analyticshub/v1/analyticshub-api.json @@ -695,7 +695,7 @@ } } }, - "revision": "20230324", + "revision": "20230414", "rootUrl": "https://analyticshub.googleapis.com/", "schemas": { "AuditConfig": { @@ -1081,10 +1081,6 @@ "description": "Optional. Email or URL of the request access of the listing. Subscribers can use this reference to request access. Max Length: 1000 bytes.", "type": "string" }, - "restrictedExportConfig": { - "$ref": "RestrictedExportConfig", - "description": "Optional. If set, restricted export configuration will be propagated and enforced on the linked dataset." - }, "state": { "description": "Output only. Current state of the listing.", "enum": [ @@ -1191,21 +1187,6 @@ }, "type": "object" }, - "RestrictedExportConfig": { - "description": "Restricted export config, used to configure restricted export on linked dataset.", - "id": "RestrictedExportConfig", - "properties": { - "enabled": { - "description": "If true, enable restricted export.", - "type": "boolean" - }, - "restrictQueryResult": { - "description": "If true, restrict export of query result derived from restricted linked dataset table.", - "type": "boolean" - } - }, - "type": "object" - }, "SetIamPolicyRequest": { "description": "Request message for `SetIamPolicy` method.", "id": "SetIamPolicyRequest", diff --git a/analyticshub/v1/analyticshub-gen.go b/analyticshub/v1/analyticshub-gen.go index c25ee1059ca..3565e8d8323 100644 --- a/analyticshub/v1/analyticshub-gen.go +++ b/analyticshub/v1/analyticshub-gen.go @@ -949,10 +949,6 @@ type Listing struct { // Length: 1000 bytes. RequestAccess string `json:"requestAccess,omitempty"` - // RestrictedExportConfig: Optional. If set, restricted export - // configuration will be propagated and enforced on the linked dataset. - RestrictedExportConfig *RestrictedExportConfig `json:"restrictedExportConfig,omitempty"` - // State: Output only. Current state of the listing. // // Possible values: @@ -1184,39 +1180,6 @@ func (s *Publisher) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// RestrictedExportConfig: Restricted export config, used to configure -// restricted export on linked dataset. -type RestrictedExportConfig struct { - // Enabled: If true, enable restricted export. - Enabled bool `json:"enabled,omitempty"` - - // RestrictQueryResult: If true, restrict export of query result derived - // from restricted linked dataset table. - RestrictQueryResult bool `json:"restrictQueryResult,omitempty"` - - // ForceSendFields is a list of field names (e.g. "Enabled") to - // unconditionally include in API requests. By default, fields with - // empty or default values are omitted from API requests. However, any - // non-pointer, non-interface field appearing in ForceSendFields will be - // sent to the server regardless of whether the field is empty or not. - // This may be used to include empty fields in Patch requests. - ForceSendFields []string `json:"-"` - - // NullFields is a list of field names (e.g. "Enabled") to include in - // API requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. However, any field with an - // empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. - NullFields []string `json:"-"` -} - -func (s *RestrictedExportConfig) MarshalJSON() ([]byte, error) { - type NoMethod RestrictedExportConfig - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // SetIamPolicyRequest: Request message for `SetIamPolicy` method. type SetIamPolicyRequest struct { // Policy: REQUIRED: The complete policy to be applied to the diff --git a/analyticshub/v1beta1/analyticshub-api.json b/analyticshub/v1beta1/analyticshub-api.json index 2f9f390c8b7..632caccf694 100644 --- a/analyticshub/v1beta1/analyticshub-api.json +++ b/analyticshub/v1beta1/analyticshub-api.json @@ -695,7 +695,7 @@ } } }, - "revision": "20230324", + "revision": "20230414", "rootUrl": "https://analyticshub.googleapis.com/", "schemas": { "AuditConfig": { @@ -1081,10 +1081,6 @@ "description": "Optional. Email or URL of the request access of the listing. Subscribers can use this reference to request access. Max Length: 1000 bytes.", "type": "string" }, - "restrictedExportConfig": { - "$ref": "RestrictedExportConfig", - "description": "Optional. If set, restricted export configuration will be propagated and enforced on the linked dataset." - }, "state": { "description": "Output only. Current state of the listing.", "enum": [ @@ -1191,21 +1187,6 @@ }, "type": "object" }, - "RestrictedExportConfig": { - "description": "Restricted export config, used to configure restricted export on linked dataset.", - "id": "RestrictedExportConfig", - "properties": { - "enabled": { - "description": "If true, enable restricted export.", - "type": "boolean" - }, - "restrictQueryResult": { - "description": "If true, restrict export of query result derived from restricted linked dataset table.", - "type": "boolean" - } - }, - "type": "object" - }, "SetIamPolicyRequest": { "description": "Request message for `SetIamPolicy` method.", "id": "SetIamPolicyRequest", diff --git a/analyticshub/v1beta1/analyticshub-gen.go b/analyticshub/v1beta1/analyticshub-gen.go index 554795a9039..17d9a8036e0 100644 --- a/analyticshub/v1beta1/analyticshub-gen.go +++ b/analyticshub/v1beta1/analyticshub-gen.go @@ -949,10 +949,6 @@ type Listing struct { // Length: 1000 bytes. RequestAccess string `json:"requestAccess,omitempty"` - // RestrictedExportConfig: Optional. If set, restricted export - // configuration will be propagated and enforced on the linked dataset. - RestrictedExportConfig *RestrictedExportConfig `json:"restrictedExportConfig,omitempty"` - // State: Output only. Current state of the listing. // // Possible values: @@ -1184,39 +1180,6 @@ func (s *Publisher) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// RestrictedExportConfig: Restricted export config, used to configure -// restricted export on linked dataset. -type RestrictedExportConfig struct { - // Enabled: If true, enable restricted export. - Enabled bool `json:"enabled,omitempty"` - - // RestrictQueryResult: If true, restrict export of query result derived - // from restricted linked dataset table. - RestrictQueryResult bool `json:"restrictQueryResult,omitempty"` - - // ForceSendFields is a list of field names (e.g. "Enabled") to - // unconditionally include in API requests. By default, fields with - // empty or default values are omitted from API requests. However, any - // non-pointer, non-interface field appearing in ForceSendFields will be - // sent to the server regardless of whether the field is empty or not. - // This may be used to include empty fields in Patch requests. - ForceSendFields []string `json:"-"` - - // NullFields is a list of field names (e.g. "Enabled") to include in - // API requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. However, any field with an - // empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. - NullFields []string `json:"-"` -} - -func (s *RestrictedExportConfig) MarshalJSON() ([]byte, error) { - type NoMethod RestrictedExportConfig - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // SetIamPolicyRequest: Request message for `SetIamPolicy` method. type SetIamPolicyRequest struct { // Policy: REQUIRED: The complete policy to be applied to the diff --git a/api-list.json b/api-list.json index 035727b417f..b92eeb680c1 100644 --- a/api-list.json +++ b/api-list.json @@ -3171,6 +3171,21 @@ "documentationLink": "https://cloud.google.com/anthos/multicluster-management/connect/registering-a-cluster", "preferred": true }, + { + "kind": "discovery#directoryItem", + "id": "gkeonprem:v1", + "name": "gkeonprem", + "version": "v1", + "title": "Anthos On-Prem API", + "description": "", + "discoveryRestUrl": "https://gkeonprem.googleapis.com/$discovery/rest?version=v1", + "icons": { + "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png", + "x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png" + }, + "documentationLink": "https://cloud.google.com/anthos/clusters/docs/on-prem/", + "preferred": true + }, { "kind": "discovery#directoryItem", "id": "gmail:v1", @@ -4580,6 +4595,21 @@ "x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png" }, "documentationLink": "https://cloud.google.com/public-certificate-authority/docs", + "preferred": false + }, + { + "kind": "discovery#directoryItem", + "id": "publicca:v1", + "name": "publicca", + "version": "v1", + "title": "Public Certificate Authority API", + "description": "The Public Certificate Authority API may be used to create and manage ACME external account binding keys associated with Google Trust Services' publicly trusted certificate authority.", + "discoveryRestUrl": "https://publicca.googleapis.com/$discovery/rest?version=v1", + "icons": { + "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png", + "x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png" + }, + "documentationLink": "https://cloud.google.com/public-certificate-authority/docs", "preferred": true }, { diff --git a/bigqueryreservation/v1/bigqueryreservation-api.json b/bigqueryreservation/v1/bigqueryreservation-api.json index 5bb18177787..44c96110818 100644 --- a/bigqueryreservation/v1/bigqueryreservation-api.json +++ b/bigqueryreservation/v1/bigqueryreservation-api.json @@ -181,6 +181,7 @@ ] }, "searchAssignments": { + "deprecated": true, "description": "Deprecated: Looks up assignments for a specified resource for a particular region. If the request is about a project: 1. Assignments created on the project will be returned if they exist. 2. Otherwise assignments created on the closest ancestor will be returned. 3. Assignments for different JobTypes will all be returned. The same logic applies if the request is about a folder. If the request is about an organization, then assignments created on the organization will be returned (organization doesn't have ancestors). Comparing to ListAssignments, there are some behavior differences: 1. permission on the assignee will be verified in this API. 2. Hierarchy lookup (project-\u003efolder-\u003eorganization) happens in this API. 3. Parent here is `projects/*/locations/*`, instead of `projects/*/locations/*reservations/*`. **Note** \"-\" cannot be used for projects nor locations.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}:searchAssignments", "httpMethod": "GET", @@ -823,7 +824,7 @@ } } }, - "revision": "20230326", + "revision": "20230419", "rootUrl": "https://bigqueryreservation.googleapis.com/", "schemas": { "Assignment": { @@ -1186,7 +1187,7 @@ "type": "string" }, "slotCapacity": { - "description": "Minimum slots available to this reservation. A slot is a unit of computational power in BigQuery, and serves as the unit of parallelism. Queries using this reservation might use more slots during runtime if ignore_idle_slots is set to false. If total slot_capacity of the reservation and its siblings exceeds the total slot_count of all capacity commitments, the request will fail with `google.rpc.Code.RESOURCE_EXHAUSTED`. NOTE: for reservations in US or EU multi-regions, slot capacity constraints are checked separately for default and auxiliary regions. See multi_region_auxiliary flag for more details.", + "description": "Minimum slots available to this reservation. A slot is a unit of computational power in BigQuery, and serves as the unit of parallelism. Queries using this reservation might use more slots during runtime if ignore_idle_slots is set to false. If edition is EDITION_UNSPECIFIED and total slot_capacity of the reservation and its siblings exceeds the total slot_count of all capacity commitments, the request will fail with `google.rpc.Code.RESOURCE_EXHAUSTED`. If edition is any value but EDITION_UNSPECIFIED, then the above requirement is not needed. The total slot_capacity of the reservation and its siblings may exceed the total slot_count of capacity commitments. In that case, the exceeding slots will be charged with the autoscale SKU. You can increase the number of baseline slots in a reservation every few minutes. If you want to decrease your baseline slots, you are limited to once an hour if you have recently changed your baseline slot capacity and your baseline slots exceed your committed slots. Otherwise, you can decrease your baseline slots every few minutes. NOTE: for reservations in US or EU multi-regions, slot capacity constraints are checked separately for default and auxiliary regions. See multi_region_auxiliary flag for more details.", "format": "int64", "type": "string" }, diff --git a/bigqueryreservation/v1/bigqueryreservation-gen.go b/bigqueryreservation/v1/bigqueryreservation-gen.go index 6746be6bf97..f3324028472 100644 --- a/bigqueryreservation/v1/bigqueryreservation-gen.go +++ b/bigqueryreservation/v1/bigqueryreservation-gen.go @@ -767,13 +767,23 @@ type Reservation struct { // SlotCapacity: Minimum slots available to this reservation. A slot is // a unit of computational power in BigQuery, and serves as the unit of // parallelism. Queries using this reservation might use more slots - // during runtime if ignore_idle_slots is set to false. If total - // slot_capacity of the reservation and its siblings exceeds the total - // slot_count of all capacity commitments, the request will fail with - // `google.rpc.Code.RESOURCE_EXHAUSTED`. NOTE: for reservations in US or - // EU multi-regions, slot capacity constraints are checked separately - // for default and auxiliary regions. See multi_region_auxiliary flag - // for more details. + // during runtime if ignore_idle_slots is set to false. If edition is + // EDITION_UNSPECIFIED and total slot_capacity of the reservation and + // its siblings exceeds the total slot_count of all capacity + // commitments, the request will fail with + // `google.rpc.Code.RESOURCE_EXHAUSTED`. If edition is any value but + // EDITION_UNSPECIFIED, then the above requirement is not needed. The + // total slot_capacity of the reservation and its siblings may exceed + // the total slot_count of capacity commitments. In that case, the + // exceeding slots will be charged with the autoscale SKU. You can + // increase the number of baseline slots in a reservation every few + // minutes. If you want to decrease your baseline slots, you are limited + // to once an hour if you have recently changed your baseline slot + // capacity and your baseline slots exceed your committed slots. + // Otherwise, you can decrease your baseline slots every few minutes. + // NOTE: for reservations in US or EU multi-regions, slot capacity + // constraints are checked separately for default and auxiliary regions. + // See multi_region_auxiliary flag for more details. SlotCapacity int64 `json:"slotCapacity,omitempty,string"` // UpdateTime: Output only. Last update time of the reservation. @@ -1549,6 +1559,7 @@ func (c *ProjectsLocationsSearchAssignmentsCall) Do(opts ...googleapi.CallOption } return ret, nil // { + // "deprecated": true, // "description": "Deprecated: Looks up assignments for a specified resource for a particular region. If the request is about a project: 1. Assignments created on the project will be returned if they exist. 2. Otherwise assignments created on the closest ancestor will be returned. 3. Assignments for different JobTypes will all be returned. The same logic applies if the request is about a folder. If the request is about an organization, then assignments created on the organization will be returned (organization doesn't have ancestors). Comparing to ListAssignments, there are some behavior differences: 1. permission on the assignee will be verified in this API. 2. Hierarchy lookup (project-\u003efolder-\u003eorganization) happens in this API. 3. Parent here is `projects/*/locations/*`, instead of `projects/*/locations/*reservations/*`. **Note** \"-\" cannot be used for projects nor locations.", // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}:searchAssignments", // "httpMethod": "GET", diff --git a/cloudfunctions/v1/cloudfunctions-api.json b/cloudfunctions/v1/cloudfunctions-api.json index 50beefb19bb..1bb1951168f 100644 --- a/cloudfunctions/v1/cloudfunctions-api.json +++ b/cloudfunctions/v1/cloudfunctions-api.json @@ -546,7 +546,7 @@ } } }, - "revision": "20230406", + "revision": "20230420", "rootUrl": "https://cloudfunctions.googleapis.com/", "schemas": { "AuditConfig": { @@ -1111,30 +1111,6 @@ }, "type": "object" }, - "GoogleCloudFunctionsV2alphaLocationMetadata": { - "description": "Extra GCF specific location information.", - "id": "GoogleCloudFunctionsV2alphaLocationMetadata", - "properties": { - "environments": { - "description": "The Cloud Function environments this location supports.", - "items": { - "enum": [ - "ENVIRONMENT_UNSPECIFIED", - "GEN_1", - "GEN_2" - ], - "enumDescriptions": [ - "Unspecified", - "Gen 1", - "Gen 2" - ], - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "GoogleCloudFunctionsV2alphaOperationMetadata": { "description": "Represents the metadata of the long-running operation.", "id": "GoogleCloudFunctionsV2alphaOperationMetadata", @@ -1168,7 +1144,7 @@ "stages": { "description": "Mechanism for reporting in-progress stages", "items": { - "$ref": "Stage" + "$ref": "GoogleCloudFunctionsV2alphaStage" }, "type": "array" }, @@ -1187,6 +1163,70 @@ }, "type": "object" }, + "GoogleCloudFunctionsV2alphaStage": { + "description": "Each Stage of the deployment process", + "id": "GoogleCloudFunctionsV2alphaStage", + "properties": { + "message": { + "description": "Message describing the Stage", + "type": "string" + }, + "name": { + "description": "Name of the Stage. This will be unique for each Stage.", + "enum": [ + "NAME_UNSPECIFIED", + "ARTIFACT_REGISTRY", + "BUILD", + "SERVICE", + "TRIGGER", + "SERVICE_ROLLBACK", + "TRIGGER_ROLLBACK" + ], + "enumDescriptions": [ + "Not specified. Invalid name.", + "Artifact Regsitry Stage", + "Build Stage", + "Service Stage", + "Trigger Stage", + "Service Rollback Stage", + "Trigger Rollback Stage" + ], + "type": "string" + }, + "resource": { + "description": "Resource of the Stage", + "type": "string" + }, + "resourceUri": { + "description": "Link to the current Stage resource", + "type": "string" + }, + "state": { + "description": "Current state of the Stage", + "enum": [ + "STATE_UNSPECIFIED", + "NOT_STARTED", + "IN_PROGRESS", + "COMPLETE" + ], + "enumDescriptions": [ + "Not specified. Invalid state.", + "Stage has not started.", + "Stage is in progress.", + "Stage has completed." + ], + "type": "string" + }, + "stateMessages": { + "description": "State messages from the current Stage.", + "items": { + "$ref": "GoogleCloudFunctionsV2alphaStateMessage" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudFunctionsV2alphaStateMessage": { "description": "Informational messages about the state of the Cloud Function or Operation.", "id": "GoogleCloudFunctionsV2alphaStateMessage", @@ -1218,30 +1258,6 @@ }, "type": "object" }, - "GoogleCloudFunctionsV2betaLocationMetadata": { - "description": "Extra GCF specific location information.", - "id": "GoogleCloudFunctionsV2betaLocationMetadata", - "properties": { - "environments": { - "description": "The Cloud Function environments this location supports.", - "items": { - "enum": [ - "ENVIRONMENT_UNSPECIFIED", - "GEN_1", - "GEN_2" - ], - "enumDescriptions": [ - "Unspecified", - "Gen 1", - "Gen 2" - ], - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "GoogleCloudFunctionsV2betaOperationMetadata": { "description": "Represents the metadata of the long-running operation.", "id": "GoogleCloudFunctionsV2betaOperationMetadata", @@ -1477,7 +1493,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { @@ -1510,30 +1526,6 @@ }, "type": "object" }, - "LocationMetadata": { - "description": "Extra GCF specific location information.", - "id": "LocationMetadata", - "properties": { - "environments": { - "description": "The Cloud Function environments this location supports.", - "items": { - "enum": [ - "ENVIRONMENT_UNSPECIFIED", - "GEN_1", - "GEN_2" - ], - "enumDescriptions": [ - "Unspecified", - "Gen 1", - "Gen 2" - ], - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "Operation": { "description": "This resource represents a long-running operation that is the result of a network API call.", "id": "Operation", @@ -1759,70 +1751,6 @@ }, "type": "object" }, - "Stage": { - "description": "Each Stage of the deployment process", - "id": "Stage", - "properties": { - "message": { - "description": "Message describing the Stage", - "type": "string" - }, - "name": { - "description": "Name of the Stage. This will be unique for each Stage.", - "enum": [ - "NAME_UNSPECIFIED", - "ARTIFACT_REGISTRY", - "BUILD", - "SERVICE", - "TRIGGER", - "SERVICE_ROLLBACK", - "TRIGGER_ROLLBACK" - ], - "enumDescriptions": [ - "Not specified. Invalid name.", - "Artifact Regsitry Stage", - "Build Stage", - "Service Stage", - "Trigger Stage", - "Service Rollback Stage", - "Trigger Rollback Stage" - ], - "type": "string" - }, - "resource": { - "description": "Resource of the Stage", - "type": "string" - }, - "resourceUri": { - "description": "Link to the current Stage resource", - "type": "string" - }, - "state": { - "description": "Current state of the Stage", - "enum": [ - "STATE_UNSPECIFIED", - "NOT_STARTED", - "IN_PROGRESS", - "COMPLETE" - ], - "enumDescriptions": [ - "Not specified. Invalid state.", - "Stage has not started.", - "Stage is in progress.", - "Stage has completed." - ], - "type": "string" - }, - "stateMessages": { - "description": "State messages from the current Stage.", - "items": { - "$ref": "GoogleCloudFunctionsV2alphaStateMessage" - }, - "type": "array" - } - }, - "type": "object" - }, "Status": { "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", "id": "Status", diff --git a/cloudfunctions/v1/cloudfunctions-gen.go b/cloudfunctions/v1/cloudfunctions-gen.go index 1ff1f57ff60..10f475c1188 100644 --- a/cloudfunctions/v1/cloudfunctions-gen.go +++ b/cloudfunctions/v1/cloudfunctions-gen.go @@ -1147,40 +1147,6 @@ func (s *GoogleCloudFunctionsV2StateMessage) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudFunctionsV2alphaLocationMetadata: Extra GCF specific -// location information. -type GoogleCloudFunctionsV2alphaLocationMetadata struct { - // Environments: The Cloud Function environments this location supports. - // - // Possible values: - // "ENVIRONMENT_UNSPECIFIED" - Unspecified - // "GEN_1" - Gen 1 - // "GEN_2" - Gen 2 - Environments []string `json:"environments,omitempty"` - - // ForceSendFields is a list of field names (e.g. "Environments") to - // unconditionally include in API requests. By default, fields with - // empty or default values are omitted from API requests. However, any - // non-pointer, non-interface field appearing in ForceSendFields will be - // sent to the server regardless of whether the field is empty or not. - // This may be used to include empty fields in Patch requests. - ForceSendFields []string `json:"-"` - - // NullFields is a list of field names (e.g. "Environments") to include - // in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. However, any field with - // an empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. - NullFields []string `json:"-"` -} - -func (s *GoogleCloudFunctionsV2alphaLocationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudFunctionsV2alphaLocationMetadata - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // GoogleCloudFunctionsV2alphaOperationMetadata: Represents the metadata // of the long-running operation. type GoogleCloudFunctionsV2alphaOperationMetadata struct { @@ -1203,7 +1169,7 @@ type GoogleCloudFunctionsV2alphaOperationMetadata struct { RequestResource googleapi.RawMessage `json:"requestResource,omitempty"` // Stages: Mechanism for reporting in-progress stages - Stages []*Stage `json:"stages,omitempty"` + Stages []*GoogleCloudFunctionsV2alphaStage `json:"stages,omitempty"` // StatusDetail: Human-readable status of the operation, if any. StatusDetail string `json:"statusDetail,omitempty"` @@ -1237,23 +1203,41 @@ func (s *GoogleCloudFunctionsV2alphaOperationMetadata) MarshalJSON() ([]byte, er return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudFunctionsV2alphaStateMessage: Informational messages about -// the state of the Cloud Function or Operation. -type GoogleCloudFunctionsV2alphaStateMessage struct { - // Message: The message. +// GoogleCloudFunctionsV2alphaStage: Each Stage of the deployment +// process +type GoogleCloudFunctionsV2alphaStage struct { + // Message: Message describing the Stage Message string `json:"message,omitempty"` - // Severity: Severity of the state message. + // Name: Name of the Stage. This will be unique for each Stage. // // Possible values: - // "SEVERITY_UNSPECIFIED" - Not specified. Invalid severity. - // "ERROR" - ERROR-level severity. - // "WARNING" - WARNING-level severity. - // "INFO" - INFO-level severity. - Severity string `json:"severity,omitempty"` + // "NAME_UNSPECIFIED" - Not specified. Invalid name. + // "ARTIFACT_REGISTRY" - Artifact Regsitry Stage + // "BUILD" - Build Stage + // "SERVICE" - Service Stage + // "TRIGGER" - Trigger Stage + // "SERVICE_ROLLBACK" - Service Rollback Stage + // "TRIGGER_ROLLBACK" - Trigger Rollback Stage + Name string `json:"name,omitempty"` - // Type: One-word CamelCase type of the state message. - Type string `json:"type,omitempty"` + // Resource: Resource of the Stage + Resource string `json:"resource,omitempty"` + + // ResourceUri: Link to the current Stage resource + ResourceUri string `json:"resourceUri,omitempty"` + + // State: Current state of the Stage + // + // Possible values: + // "STATE_UNSPECIFIED" - Not specified. Invalid state. + // "NOT_STARTED" - Stage has not started. + // "IN_PROGRESS" - Stage is in progress. + // "COMPLETE" - Stage has completed. + State string `json:"state,omitempty"` + + // StateMessages: State messages from the current Stage. + StateMessages []*GoogleCloudFunctionsV2alphaStateMessage `json:"stateMessages,omitempty"` // ForceSendFields is a list of field names (e.g. "Message") to // unconditionally include in API requests. By default, fields with @@ -1272,24 +1256,31 @@ type GoogleCloudFunctionsV2alphaStateMessage struct { NullFields []string `json:"-"` } -func (s *GoogleCloudFunctionsV2alphaStateMessage) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudFunctionsV2alphaStateMessage +func (s *GoogleCloudFunctionsV2alphaStage) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudFunctionsV2alphaStage raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudFunctionsV2betaLocationMetadata: Extra GCF specific -// location information. -type GoogleCloudFunctionsV2betaLocationMetadata struct { - // Environments: The Cloud Function environments this location supports. +// GoogleCloudFunctionsV2alphaStateMessage: Informational messages about +// the state of the Cloud Function or Operation. +type GoogleCloudFunctionsV2alphaStateMessage struct { + // Message: The message. + Message string `json:"message,omitempty"` + + // Severity: Severity of the state message. // // Possible values: - // "ENVIRONMENT_UNSPECIFIED" - Unspecified - // "GEN_1" - Gen 1 - // "GEN_2" - Gen 2 - Environments []string `json:"environments,omitempty"` + // "SEVERITY_UNSPECIFIED" - Not specified. Invalid severity. + // "ERROR" - ERROR-level severity. + // "WARNING" - WARNING-level severity. + // "INFO" - INFO-level severity. + Severity string `json:"severity,omitempty"` + + // Type: One-word CamelCase type of the state message. + Type string `json:"type,omitempty"` - // ForceSendFields is a list of field names (e.g. "Environments") to + // ForceSendFields is a list of field names (e.g. "Message") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -1297,17 +1288,17 @@ type GoogleCloudFunctionsV2betaLocationMetadata struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Environments") to include - // in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. However, any field with - // an empty value appearing in NullFields will be sent to the server as + // NullFields is a list of field names (e.g. "Message") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } -func (s *GoogleCloudFunctionsV2betaLocationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudFunctionsV2betaLocationMetadata +func (s *GoogleCloudFunctionsV2alphaStateMessage) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudFunctionsV2alphaStateMessage raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } @@ -1625,7 +1616,7 @@ func (s *ListOperationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". @@ -1671,39 +1662,6 @@ func (s *Location) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// LocationMetadata: Extra GCF specific location information. -type LocationMetadata struct { - // Environments: The Cloud Function environments this location supports. - // - // Possible values: - // "ENVIRONMENT_UNSPECIFIED" - Unspecified - // "GEN_1" - Gen 1 - // "GEN_2" - Gen 2 - Environments []string `json:"environments,omitempty"` - - // ForceSendFields is a list of field names (e.g. "Environments") to - // unconditionally include in API requests. By default, fields with - // empty or default values are omitted from API requests. However, any - // non-pointer, non-interface field appearing in ForceSendFields will be - // sent to the server regardless of whether the field is empty or not. - // This may be used to include empty fields in Patch requests. - ForceSendFields []string `json:"-"` - - // NullFields is a list of field names (e.g. "Environments") to include - // in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. However, any field with - // an empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. - NullFields []string `json:"-"` -} - -func (s *LocationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod LocationMetadata - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // Operation: This resource represents a long-running operation that is // the result of a network API call. type Operation struct { @@ -2163,64 +2121,6 @@ func (s *SourceRepository) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Stage: Each Stage of the deployment process -type Stage struct { - // Message: Message describing the Stage - Message string `json:"message,omitempty"` - - // Name: Name of the Stage. This will be unique for each Stage. - // - // Possible values: - // "NAME_UNSPECIFIED" - Not specified. Invalid name. - // "ARTIFACT_REGISTRY" - Artifact Regsitry Stage - // "BUILD" - Build Stage - // "SERVICE" - Service Stage - // "TRIGGER" - Trigger Stage - // "SERVICE_ROLLBACK" - Service Rollback Stage - // "TRIGGER_ROLLBACK" - Trigger Rollback Stage - Name string `json:"name,omitempty"` - - // Resource: Resource of the Stage - Resource string `json:"resource,omitempty"` - - // ResourceUri: Link to the current Stage resource - ResourceUri string `json:"resourceUri,omitempty"` - - // State: Current state of the Stage - // - // Possible values: - // "STATE_UNSPECIFIED" - Not specified. Invalid state. - // "NOT_STARTED" - Stage has not started. - // "IN_PROGRESS" - Stage is in progress. - // "COMPLETE" - Stage has completed. - State string `json:"state,omitempty"` - - // StateMessages: State messages from the current Stage. - StateMessages []*GoogleCloudFunctionsV2alphaStateMessage `json:"stateMessages,omitempty"` - - // ForceSendFields is a list of field names (e.g. "Message") to - // unconditionally include in API requests. By default, fields with - // empty or default values are omitted from API requests. However, any - // non-pointer, non-interface field appearing in ForceSendFields will be - // sent to the server regardless of whether the field is empty or not. - // This may be used to include empty fields in Patch requests. - ForceSendFields []string `json:"-"` - - // NullFields is a list of field names (e.g. "Message") to include in - // API requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. However, any field with an - // empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. - NullFields []string `json:"-"` -} - -func (s *Stage) MarshalJSON() ([]byte, error) { - type NoMethod Stage - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs // and RPC APIs. It is used by gRPC (https://github.com/grpc). Each diff --git a/cloudfunctions/v2/cloudfunctions-api.json b/cloudfunctions/v2/cloudfunctions-api.json index fe9ed6b5149..83006b7f9d5 100644 --- a/cloudfunctions/v2/cloudfunctions-api.json +++ b/cloudfunctions/v2/cloudfunctions-api.json @@ -571,7 +571,7 @@ } } }, - "revision": "20230406", + "revision": "20230420", "rootUrl": "https://cloudfunctions.googleapis.com/", "schemas": { "AuditConfig": { @@ -1074,30 +1074,6 @@ }, "type": "object" }, - "GoogleCloudFunctionsV2alphaLocationMetadata": { - "description": "Extra GCF specific location information.", - "id": "GoogleCloudFunctionsV2alphaLocationMetadata", - "properties": { - "environments": { - "description": "The Cloud Function environments this location supports.", - "items": { - "enum": [ - "ENVIRONMENT_UNSPECIFIED", - "GEN_1", - "GEN_2" - ], - "enumDescriptions": [ - "Unspecified", - "Gen 1", - "Gen 2" - ], - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "GoogleCloudFunctionsV2alphaOperationMetadata": { "description": "Represents the metadata of the long-running operation.", "id": "GoogleCloudFunctionsV2alphaOperationMetadata", @@ -1131,7 +1107,7 @@ "stages": { "description": "Mechanism for reporting in-progress stages", "items": { - "$ref": "Stage" + "$ref": "GoogleCloudFunctionsV2alphaStage" }, "type": "array" }, @@ -1150,6 +1126,70 @@ }, "type": "object" }, + "GoogleCloudFunctionsV2alphaStage": { + "description": "Each Stage of the deployment process", + "id": "GoogleCloudFunctionsV2alphaStage", + "properties": { + "message": { + "description": "Message describing the Stage", + "type": "string" + }, + "name": { + "description": "Name of the Stage. This will be unique for each Stage.", + "enum": [ + "NAME_UNSPECIFIED", + "ARTIFACT_REGISTRY", + "BUILD", + "SERVICE", + "TRIGGER", + "SERVICE_ROLLBACK", + "TRIGGER_ROLLBACK" + ], + "enumDescriptions": [ + "Not specified. Invalid name.", + "Artifact Regsitry Stage", + "Build Stage", + "Service Stage", + "Trigger Stage", + "Service Rollback Stage", + "Trigger Rollback Stage" + ], + "type": "string" + }, + "resource": { + "description": "Resource of the Stage", + "type": "string" + }, + "resourceUri": { + "description": "Link to the current Stage resource", + "type": "string" + }, + "state": { + "description": "Current state of the Stage", + "enum": [ + "STATE_UNSPECIFIED", + "NOT_STARTED", + "IN_PROGRESS", + "COMPLETE" + ], + "enumDescriptions": [ + "Not specified. Invalid state.", + "Stage has not started.", + "Stage is in progress.", + "Stage has completed." + ], + "type": "string" + }, + "stateMessages": { + "description": "State messages from the current Stage.", + "items": { + "$ref": "GoogleCloudFunctionsV2alphaStateMessage" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudFunctionsV2alphaStateMessage": { "description": "Informational messages about the state of the Cloud Function or Operation.", "id": "GoogleCloudFunctionsV2alphaStateMessage", @@ -1181,30 +1221,6 @@ }, "type": "object" }, - "GoogleCloudFunctionsV2betaLocationMetadata": { - "description": "Extra GCF specific location information.", - "id": "GoogleCloudFunctionsV2betaLocationMetadata", - "properties": { - "environments": { - "description": "The Cloud Function environments this location supports.", - "items": { - "enum": [ - "ENVIRONMENT_UNSPECIFIED", - "GEN_1", - "GEN_2" - ], - "enumDescriptions": [ - "Unspecified", - "Gen 1", - "Gen 2" - ], - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "GoogleCloudFunctionsV2betaOperationMetadata": { "description": "Represents the metadata of the long-running operation.", "id": "GoogleCloudFunctionsV2betaOperationMetadata", @@ -1428,7 +1444,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { @@ -1461,30 +1477,6 @@ }, "type": "object" }, - "LocationMetadata": { - "description": "Extra GCF specific location information.", - "id": "LocationMetadata", - "properties": { - "environments": { - "description": "The Cloud Function environments this location supports.", - "items": { - "enum": [ - "ENVIRONMENT_UNSPECIFIED", - "GEN_1", - "GEN_2" - ], - "enumDescriptions": [ - "Unspecified", - "Gen 1", - "Gen 2" - ], - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "Operation": { "description": "This resource represents a long-running operation that is the result of a network API call.", "id": "Operation", @@ -1938,70 +1930,6 @@ }, "type": "object" }, - "Stage": { - "description": "Each Stage of the deployment process", - "id": "Stage", - "properties": { - "message": { - "description": "Message describing the Stage", - "type": "string" - }, - "name": { - "description": "Name of the Stage. This will be unique for each Stage.", - "enum": [ - "NAME_UNSPECIFIED", - "ARTIFACT_REGISTRY", - "BUILD", - "SERVICE", - "TRIGGER", - "SERVICE_ROLLBACK", - "TRIGGER_ROLLBACK" - ], - "enumDescriptions": [ - "Not specified. Invalid name.", - "Artifact Regsitry Stage", - "Build Stage", - "Service Stage", - "Trigger Stage", - "Service Rollback Stage", - "Trigger Rollback Stage" - ], - "type": "string" - }, - "resource": { - "description": "Resource of the Stage", - "type": "string" - }, - "resourceUri": { - "description": "Link to the current Stage resource", - "type": "string" - }, - "state": { - "description": "Current state of the Stage", - "enum": [ - "STATE_UNSPECIFIED", - "NOT_STARTED", - "IN_PROGRESS", - "COMPLETE" - ], - "enumDescriptions": [ - "Not specified. Invalid state.", - "Stage has not started.", - "Stage is in progress.", - "Stage has completed." - ], - "type": "string" - }, - "stateMessages": { - "description": "State messages from the current Stage.", - "items": { - "$ref": "GoogleCloudFunctionsV2alphaStateMessage" - }, - "type": "array" - } - }, - "type": "object" - }, "Status": { "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", "id": "Status", diff --git a/cloudfunctions/v2/cloudfunctions-gen.go b/cloudfunctions/v2/cloudfunctions-gen.go index aaa07b8b2f4..bbc91c33835 100644 --- a/cloudfunctions/v2/cloudfunctions-gen.go +++ b/cloudfunctions/v2/cloudfunctions-gen.go @@ -1011,40 +1011,6 @@ func (s *GoogleCloudFunctionsV2StateMessage) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudFunctionsV2alphaLocationMetadata: Extra GCF specific -// location information. -type GoogleCloudFunctionsV2alphaLocationMetadata struct { - // Environments: The Cloud Function environments this location supports. - // - // Possible values: - // "ENVIRONMENT_UNSPECIFIED" - Unspecified - // "GEN_1" - Gen 1 - // "GEN_2" - Gen 2 - Environments []string `json:"environments,omitempty"` - - // ForceSendFields is a list of field names (e.g. "Environments") to - // unconditionally include in API requests. By default, fields with - // empty or default values are omitted from API requests. However, any - // non-pointer, non-interface field appearing in ForceSendFields will be - // sent to the server regardless of whether the field is empty or not. - // This may be used to include empty fields in Patch requests. - ForceSendFields []string `json:"-"` - - // NullFields is a list of field names (e.g. "Environments") to include - // in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. However, any field with - // an empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. - NullFields []string `json:"-"` -} - -func (s *GoogleCloudFunctionsV2alphaLocationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudFunctionsV2alphaLocationMetadata - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // GoogleCloudFunctionsV2alphaOperationMetadata: Represents the metadata // of the long-running operation. type GoogleCloudFunctionsV2alphaOperationMetadata struct { @@ -1067,7 +1033,7 @@ type GoogleCloudFunctionsV2alphaOperationMetadata struct { RequestResource googleapi.RawMessage `json:"requestResource,omitempty"` // Stages: Mechanism for reporting in-progress stages - Stages []*Stage `json:"stages,omitempty"` + Stages []*GoogleCloudFunctionsV2alphaStage `json:"stages,omitempty"` // StatusDetail: Human-readable status of the operation, if any. StatusDetail string `json:"statusDetail,omitempty"` @@ -1101,23 +1067,41 @@ func (s *GoogleCloudFunctionsV2alphaOperationMetadata) MarshalJSON() ([]byte, er return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudFunctionsV2alphaStateMessage: Informational messages about -// the state of the Cloud Function or Operation. -type GoogleCloudFunctionsV2alphaStateMessage struct { - // Message: The message. +// GoogleCloudFunctionsV2alphaStage: Each Stage of the deployment +// process +type GoogleCloudFunctionsV2alphaStage struct { + // Message: Message describing the Stage Message string `json:"message,omitempty"` - // Severity: Severity of the state message. + // Name: Name of the Stage. This will be unique for each Stage. // // Possible values: - // "SEVERITY_UNSPECIFIED" - Not specified. Invalid severity. - // "ERROR" - ERROR-level severity. - // "WARNING" - WARNING-level severity. - // "INFO" - INFO-level severity. - Severity string `json:"severity,omitempty"` + // "NAME_UNSPECIFIED" - Not specified. Invalid name. + // "ARTIFACT_REGISTRY" - Artifact Regsitry Stage + // "BUILD" - Build Stage + // "SERVICE" - Service Stage + // "TRIGGER" - Trigger Stage + // "SERVICE_ROLLBACK" - Service Rollback Stage + // "TRIGGER_ROLLBACK" - Trigger Rollback Stage + Name string `json:"name,omitempty"` - // Type: One-word CamelCase type of the state message. - Type string `json:"type,omitempty"` + // Resource: Resource of the Stage + Resource string `json:"resource,omitempty"` + + // ResourceUri: Link to the current Stage resource + ResourceUri string `json:"resourceUri,omitempty"` + + // State: Current state of the Stage + // + // Possible values: + // "STATE_UNSPECIFIED" - Not specified. Invalid state. + // "NOT_STARTED" - Stage has not started. + // "IN_PROGRESS" - Stage is in progress. + // "COMPLETE" - Stage has completed. + State string `json:"state,omitempty"` + + // StateMessages: State messages from the current Stage. + StateMessages []*GoogleCloudFunctionsV2alphaStateMessage `json:"stateMessages,omitempty"` // ForceSendFields is a list of field names (e.g. "Message") to // unconditionally include in API requests. By default, fields with @@ -1136,24 +1120,31 @@ type GoogleCloudFunctionsV2alphaStateMessage struct { NullFields []string `json:"-"` } -func (s *GoogleCloudFunctionsV2alphaStateMessage) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudFunctionsV2alphaStateMessage +func (s *GoogleCloudFunctionsV2alphaStage) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudFunctionsV2alphaStage raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudFunctionsV2betaLocationMetadata: Extra GCF specific -// location information. -type GoogleCloudFunctionsV2betaLocationMetadata struct { - // Environments: The Cloud Function environments this location supports. +// GoogleCloudFunctionsV2alphaStateMessage: Informational messages about +// the state of the Cloud Function or Operation. +type GoogleCloudFunctionsV2alphaStateMessage struct { + // Message: The message. + Message string `json:"message,omitempty"` + + // Severity: Severity of the state message. // // Possible values: - // "ENVIRONMENT_UNSPECIFIED" - Unspecified - // "GEN_1" - Gen 1 - // "GEN_2" - Gen 2 - Environments []string `json:"environments,omitempty"` + // "SEVERITY_UNSPECIFIED" - Not specified. Invalid severity. + // "ERROR" - ERROR-level severity. + // "WARNING" - WARNING-level severity. + // "INFO" - INFO-level severity. + Severity string `json:"severity,omitempty"` + + // Type: One-word CamelCase type of the state message. + Type string `json:"type,omitempty"` - // ForceSendFields is a list of field names (e.g. "Environments") to + // ForceSendFields is a list of field names (e.g. "Message") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -1161,17 +1152,17 @@ type GoogleCloudFunctionsV2betaLocationMetadata struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Environments") to include - // in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. However, any field with - // an empty value appearing in NullFields will be sent to the server as + // NullFields is a list of field names (e.g. "Message") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } -func (s *GoogleCloudFunctionsV2betaLocationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudFunctionsV2betaLocationMetadata +func (s *GoogleCloudFunctionsV2alphaStateMessage) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudFunctionsV2alphaStateMessage raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } @@ -1478,7 +1469,7 @@ func (s *ListRuntimesResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". @@ -1524,39 +1515,6 @@ func (s *Location) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// LocationMetadata: Extra GCF specific location information. -type LocationMetadata struct { - // Environments: The Cloud Function environments this location supports. - // - // Possible values: - // "ENVIRONMENT_UNSPECIFIED" - Unspecified - // "GEN_1" - Gen 1 - // "GEN_2" - Gen 2 - Environments []string `json:"environments,omitempty"` - - // ForceSendFields is a list of field names (e.g. "Environments") to - // unconditionally include in API requests. By default, fields with - // empty or default values are omitted from API requests. However, any - // non-pointer, non-interface field appearing in ForceSendFields will be - // sent to the server regardless of whether the field is empty or not. - // This may be used to include empty fields in Patch requests. - ForceSendFields []string `json:"-"` - - // NullFields is a list of field names (e.g. "Environments") to include - // in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. However, any field with - // an empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. - NullFields []string `json:"-"` -} - -func (s *LocationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod LocationMetadata - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // Operation: This resource represents a long-running operation that is // the result of a network API call. type Operation struct { @@ -2290,64 +2248,6 @@ func (s *SourceProvenance) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Stage: Each Stage of the deployment process -type Stage struct { - // Message: Message describing the Stage - Message string `json:"message,omitempty"` - - // Name: Name of the Stage. This will be unique for each Stage. - // - // Possible values: - // "NAME_UNSPECIFIED" - Not specified. Invalid name. - // "ARTIFACT_REGISTRY" - Artifact Regsitry Stage - // "BUILD" - Build Stage - // "SERVICE" - Service Stage - // "TRIGGER" - Trigger Stage - // "SERVICE_ROLLBACK" - Service Rollback Stage - // "TRIGGER_ROLLBACK" - Trigger Rollback Stage - Name string `json:"name,omitempty"` - - // Resource: Resource of the Stage - Resource string `json:"resource,omitempty"` - - // ResourceUri: Link to the current Stage resource - ResourceUri string `json:"resourceUri,omitempty"` - - // State: Current state of the Stage - // - // Possible values: - // "STATE_UNSPECIFIED" - Not specified. Invalid state. - // "NOT_STARTED" - Stage has not started. - // "IN_PROGRESS" - Stage is in progress. - // "COMPLETE" - Stage has completed. - State string `json:"state,omitempty"` - - // StateMessages: State messages from the current Stage. - StateMessages []*GoogleCloudFunctionsV2alphaStateMessage `json:"stateMessages,omitempty"` - - // ForceSendFields is a list of field names (e.g. "Message") to - // unconditionally include in API requests. By default, fields with - // empty or default values are omitted from API requests. However, any - // non-pointer, non-interface field appearing in ForceSendFields will be - // sent to the server regardless of whether the field is empty or not. - // This may be used to include empty fields in Patch requests. - ForceSendFields []string `json:"-"` - - // NullFields is a list of field names (e.g. "Message") to include in - // API requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. However, any field with an - // empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. - NullFields []string `json:"-"` -} - -func (s *Stage) MarshalJSON() ([]byte, error) { - type NoMethod Stage - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs // and RPC APIs. It is used by gRPC (https://github.com/grpc). Each diff --git a/cloudfunctions/v2alpha/cloudfunctions-api.json b/cloudfunctions/v2alpha/cloudfunctions-api.json index 5886a495d36..eb80ff0a6e3 100644 --- a/cloudfunctions/v2alpha/cloudfunctions-api.json +++ b/cloudfunctions/v2alpha/cloudfunctions-api.json @@ -571,7 +571,7 @@ } } }, - "revision": "20230406", + "revision": "20230420", "rootUrl": "https://cloudfunctions.googleapis.com/", "schemas": { "AuditConfig": { @@ -1074,30 +1074,6 @@ }, "type": "object" }, - "GoogleCloudFunctionsV2alphaLocationMetadata": { - "description": "Extra GCF specific location information.", - "id": "GoogleCloudFunctionsV2alphaLocationMetadata", - "properties": { - "environments": { - "description": "The Cloud Function environments this location supports.", - "items": { - "enum": [ - "ENVIRONMENT_UNSPECIFIED", - "GEN_1", - "GEN_2" - ], - "enumDescriptions": [ - "Unspecified", - "Gen 1", - "Gen 2" - ], - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "GoogleCloudFunctionsV2alphaOperationMetadata": { "description": "Represents the metadata of the long-running operation.", "id": "GoogleCloudFunctionsV2alphaOperationMetadata", @@ -1131,7 +1107,7 @@ "stages": { "description": "Mechanism for reporting in-progress stages", "items": { - "$ref": "Stage" + "$ref": "GoogleCloudFunctionsV2alphaStage" }, "type": "array" }, @@ -1150,6 +1126,70 @@ }, "type": "object" }, + "GoogleCloudFunctionsV2alphaStage": { + "description": "Each Stage of the deployment process", + "id": "GoogleCloudFunctionsV2alphaStage", + "properties": { + "message": { + "description": "Message describing the Stage", + "type": "string" + }, + "name": { + "description": "Name of the Stage. This will be unique for each Stage.", + "enum": [ + "NAME_UNSPECIFIED", + "ARTIFACT_REGISTRY", + "BUILD", + "SERVICE", + "TRIGGER", + "SERVICE_ROLLBACK", + "TRIGGER_ROLLBACK" + ], + "enumDescriptions": [ + "Not specified. Invalid name.", + "Artifact Regsitry Stage", + "Build Stage", + "Service Stage", + "Trigger Stage", + "Service Rollback Stage", + "Trigger Rollback Stage" + ], + "type": "string" + }, + "resource": { + "description": "Resource of the Stage", + "type": "string" + }, + "resourceUri": { + "description": "Link to the current Stage resource", + "type": "string" + }, + "state": { + "description": "Current state of the Stage", + "enum": [ + "STATE_UNSPECIFIED", + "NOT_STARTED", + "IN_PROGRESS", + "COMPLETE" + ], + "enumDescriptions": [ + "Not specified. Invalid state.", + "Stage has not started.", + "Stage is in progress.", + "Stage has completed." + ], + "type": "string" + }, + "stateMessages": { + "description": "State messages from the current Stage.", + "items": { + "$ref": "GoogleCloudFunctionsV2alphaStateMessage" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudFunctionsV2alphaStateMessage": { "description": "Informational messages about the state of the Cloud Function or Operation.", "id": "GoogleCloudFunctionsV2alphaStateMessage", @@ -1181,30 +1221,6 @@ }, "type": "object" }, - "GoogleCloudFunctionsV2betaLocationMetadata": { - "description": "Extra GCF specific location information.", - "id": "GoogleCloudFunctionsV2betaLocationMetadata", - "properties": { - "environments": { - "description": "The Cloud Function environments this location supports.", - "items": { - "enum": [ - "ENVIRONMENT_UNSPECIFIED", - "GEN_1", - "GEN_2" - ], - "enumDescriptions": [ - "Unspecified", - "Gen 1", - "Gen 2" - ], - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "GoogleCloudFunctionsV2betaOperationMetadata": { "description": "Represents the metadata of the long-running operation.", "id": "GoogleCloudFunctionsV2betaOperationMetadata", @@ -1428,7 +1444,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { @@ -1461,30 +1477,6 @@ }, "type": "object" }, - "LocationMetadata": { - "description": "Extra GCF specific location information.", - "id": "LocationMetadata", - "properties": { - "environments": { - "description": "The Cloud Function environments this location supports.", - "items": { - "enum": [ - "ENVIRONMENT_UNSPECIFIED", - "GEN_1", - "GEN_2" - ], - "enumDescriptions": [ - "Unspecified", - "Gen 1", - "Gen 2" - ], - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "Operation": { "description": "This resource represents a long-running operation that is the result of a network API call.", "id": "Operation", @@ -1938,70 +1930,6 @@ }, "type": "object" }, - "Stage": { - "description": "Each Stage of the deployment process", - "id": "Stage", - "properties": { - "message": { - "description": "Message describing the Stage", - "type": "string" - }, - "name": { - "description": "Name of the Stage. This will be unique for each Stage.", - "enum": [ - "NAME_UNSPECIFIED", - "ARTIFACT_REGISTRY", - "BUILD", - "SERVICE", - "TRIGGER", - "SERVICE_ROLLBACK", - "TRIGGER_ROLLBACK" - ], - "enumDescriptions": [ - "Not specified. Invalid name.", - "Artifact Regsitry Stage", - "Build Stage", - "Service Stage", - "Trigger Stage", - "Service Rollback Stage", - "Trigger Rollback Stage" - ], - "type": "string" - }, - "resource": { - "description": "Resource of the Stage", - "type": "string" - }, - "resourceUri": { - "description": "Link to the current Stage resource", - "type": "string" - }, - "state": { - "description": "Current state of the Stage", - "enum": [ - "STATE_UNSPECIFIED", - "NOT_STARTED", - "IN_PROGRESS", - "COMPLETE" - ], - "enumDescriptions": [ - "Not specified. Invalid state.", - "Stage has not started.", - "Stage is in progress.", - "Stage has completed." - ], - "type": "string" - }, - "stateMessages": { - "description": "State messages from the current Stage.", - "items": { - "$ref": "GoogleCloudFunctionsV2alphaStateMessage" - }, - "type": "array" - } - }, - "type": "object" - }, "Status": { "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", "id": "Status", diff --git a/cloudfunctions/v2alpha/cloudfunctions-gen.go b/cloudfunctions/v2alpha/cloudfunctions-gen.go index 4fd1c60bb2c..8b8289a4e8c 100644 --- a/cloudfunctions/v2alpha/cloudfunctions-gen.go +++ b/cloudfunctions/v2alpha/cloudfunctions-gen.go @@ -1011,40 +1011,6 @@ func (s *GoogleCloudFunctionsV2StateMessage) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudFunctionsV2alphaLocationMetadata: Extra GCF specific -// location information. -type GoogleCloudFunctionsV2alphaLocationMetadata struct { - // Environments: The Cloud Function environments this location supports. - // - // Possible values: - // "ENVIRONMENT_UNSPECIFIED" - Unspecified - // "GEN_1" - Gen 1 - // "GEN_2" - Gen 2 - Environments []string `json:"environments,omitempty"` - - // ForceSendFields is a list of field names (e.g. "Environments") to - // unconditionally include in API requests. By default, fields with - // empty or default values are omitted from API requests. However, any - // non-pointer, non-interface field appearing in ForceSendFields will be - // sent to the server regardless of whether the field is empty or not. - // This may be used to include empty fields in Patch requests. - ForceSendFields []string `json:"-"` - - // NullFields is a list of field names (e.g. "Environments") to include - // in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. However, any field with - // an empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. - NullFields []string `json:"-"` -} - -func (s *GoogleCloudFunctionsV2alphaLocationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudFunctionsV2alphaLocationMetadata - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // GoogleCloudFunctionsV2alphaOperationMetadata: Represents the metadata // of the long-running operation. type GoogleCloudFunctionsV2alphaOperationMetadata struct { @@ -1067,7 +1033,7 @@ type GoogleCloudFunctionsV2alphaOperationMetadata struct { RequestResource googleapi.RawMessage `json:"requestResource,omitempty"` // Stages: Mechanism for reporting in-progress stages - Stages []*Stage `json:"stages,omitempty"` + Stages []*GoogleCloudFunctionsV2alphaStage `json:"stages,omitempty"` // StatusDetail: Human-readable status of the operation, if any. StatusDetail string `json:"statusDetail,omitempty"` @@ -1101,23 +1067,41 @@ func (s *GoogleCloudFunctionsV2alphaOperationMetadata) MarshalJSON() ([]byte, er return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudFunctionsV2alphaStateMessage: Informational messages about -// the state of the Cloud Function or Operation. -type GoogleCloudFunctionsV2alphaStateMessage struct { - // Message: The message. +// GoogleCloudFunctionsV2alphaStage: Each Stage of the deployment +// process +type GoogleCloudFunctionsV2alphaStage struct { + // Message: Message describing the Stage Message string `json:"message,omitempty"` - // Severity: Severity of the state message. + // Name: Name of the Stage. This will be unique for each Stage. // // Possible values: - // "SEVERITY_UNSPECIFIED" - Not specified. Invalid severity. - // "ERROR" - ERROR-level severity. - // "WARNING" - WARNING-level severity. - // "INFO" - INFO-level severity. - Severity string `json:"severity,omitempty"` + // "NAME_UNSPECIFIED" - Not specified. Invalid name. + // "ARTIFACT_REGISTRY" - Artifact Regsitry Stage + // "BUILD" - Build Stage + // "SERVICE" - Service Stage + // "TRIGGER" - Trigger Stage + // "SERVICE_ROLLBACK" - Service Rollback Stage + // "TRIGGER_ROLLBACK" - Trigger Rollback Stage + Name string `json:"name,omitempty"` - // Type: One-word CamelCase type of the state message. - Type string `json:"type,omitempty"` + // Resource: Resource of the Stage + Resource string `json:"resource,omitempty"` + + // ResourceUri: Link to the current Stage resource + ResourceUri string `json:"resourceUri,omitempty"` + + // State: Current state of the Stage + // + // Possible values: + // "STATE_UNSPECIFIED" - Not specified. Invalid state. + // "NOT_STARTED" - Stage has not started. + // "IN_PROGRESS" - Stage is in progress. + // "COMPLETE" - Stage has completed. + State string `json:"state,omitempty"` + + // StateMessages: State messages from the current Stage. + StateMessages []*GoogleCloudFunctionsV2alphaStateMessage `json:"stateMessages,omitempty"` // ForceSendFields is a list of field names (e.g. "Message") to // unconditionally include in API requests. By default, fields with @@ -1136,24 +1120,31 @@ type GoogleCloudFunctionsV2alphaStateMessage struct { NullFields []string `json:"-"` } -func (s *GoogleCloudFunctionsV2alphaStateMessage) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudFunctionsV2alphaStateMessage +func (s *GoogleCloudFunctionsV2alphaStage) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudFunctionsV2alphaStage raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudFunctionsV2betaLocationMetadata: Extra GCF specific -// location information. -type GoogleCloudFunctionsV2betaLocationMetadata struct { - // Environments: The Cloud Function environments this location supports. +// GoogleCloudFunctionsV2alphaStateMessage: Informational messages about +// the state of the Cloud Function or Operation. +type GoogleCloudFunctionsV2alphaStateMessage struct { + // Message: The message. + Message string `json:"message,omitempty"` + + // Severity: Severity of the state message. // // Possible values: - // "ENVIRONMENT_UNSPECIFIED" - Unspecified - // "GEN_1" - Gen 1 - // "GEN_2" - Gen 2 - Environments []string `json:"environments,omitempty"` + // "SEVERITY_UNSPECIFIED" - Not specified. Invalid severity. + // "ERROR" - ERROR-level severity. + // "WARNING" - WARNING-level severity. + // "INFO" - INFO-level severity. + Severity string `json:"severity,omitempty"` + + // Type: One-word CamelCase type of the state message. + Type string `json:"type,omitempty"` - // ForceSendFields is a list of field names (e.g. "Environments") to + // ForceSendFields is a list of field names (e.g. "Message") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -1161,17 +1152,17 @@ type GoogleCloudFunctionsV2betaLocationMetadata struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Environments") to include - // in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. However, any field with - // an empty value appearing in NullFields will be sent to the server as + // NullFields is a list of field names (e.g. "Message") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } -func (s *GoogleCloudFunctionsV2betaLocationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudFunctionsV2betaLocationMetadata +func (s *GoogleCloudFunctionsV2alphaStateMessage) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudFunctionsV2alphaStateMessage raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } @@ -1478,7 +1469,7 @@ func (s *ListRuntimesResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". @@ -1524,39 +1515,6 @@ func (s *Location) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// LocationMetadata: Extra GCF specific location information. -type LocationMetadata struct { - // Environments: The Cloud Function environments this location supports. - // - // Possible values: - // "ENVIRONMENT_UNSPECIFIED" - Unspecified - // "GEN_1" - Gen 1 - // "GEN_2" - Gen 2 - Environments []string `json:"environments,omitempty"` - - // ForceSendFields is a list of field names (e.g. "Environments") to - // unconditionally include in API requests. By default, fields with - // empty or default values are omitted from API requests. However, any - // non-pointer, non-interface field appearing in ForceSendFields will be - // sent to the server regardless of whether the field is empty or not. - // This may be used to include empty fields in Patch requests. - ForceSendFields []string `json:"-"` - - // NullFields is a list of field names (e.g. "Environments") to include - // in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. However, any field with - // an empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. - NullFields []string `json:"-"` -} - -func (s *LocationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod LocationMetadata - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // Operation: This resource represents a long-running operation that is // the result of a network API call. type Operation struct { @@ -2290,64 +2248,6 @@ func (s *SourceProvenance) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Stage: Each Stage of the deployment process -type Stage struct { - // Message: Message describing the Stage - Message string `json:"message,omitempty"` - - // Name: Name of the Stage. This will be unique for each Stage. - // - // Possible values: - // "NAME_UNSPECIFIED" - Not specified. Invalid name. - // "ARTIFACT_REGISTRY" - Artifact Regsitry Stage - // "BUILD" - Build Stage - // "SERVICE" - Service Stage - // "TRIGGER" - Trigger Stage - // "SERVICE_ROLLBACK" - Service Rollback Stage - // "TRIGGER_ROLLBACK" - Trigger Rollback Stage - Name string `json:"name,omitempty"` - - // Resource: Resource of the Stage - Resource string `json:"resource,omitempty"` - - // ResourceUri: Link to the current Stage resource - ResourceUri string `json:"resourceUri,omitempty"` - - // State: Current state of the Stage - // - // Possible values: - // "STATE_UNSPECIFIED" - Not specified. Invalid state. - // "NOT_STARTED" - Stage has not started. - // "IN_PROGRESS" - Stage is in progress. - // "COMPLETE" - Stage has completed. - State string `json:"state,omitempty"` - - // StateMessages: State messages from the current Stage. - StateMessages []*GoogleCloudFunctionsV2alphaStateMessage `json:"stateMessages,omitempty"` - - // ForceSendFields is a list of field names (e.g. "Message") to - // unconditionally include in API requests. By default, fields with - // empty or default values are omitted from API requests. However, any - // non-pointer, non-interface field appearing in ForceSendFields will be - // sent to the server regardless of whether the field is empty or not. - // This may be used to include empty fields in Patch requests. - ForceSendFields []string `json:"-"` - - // NullFields is a list of field names (e.g. "Message") to include in - // API requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. However, any field with an - // empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. - NullFields []string `json:"-"` -} - -func (s *Stage) MarshalJSON() ([]byte, error) { - type NoMethod Stage - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs // and RPC APIs. It is used by gRPC (https://github.com/grpc). Each diff --git a/cloudfunctions/v2beta/cloudfunctions-api.json b/cloudfunctions/v2beta/cloudfunctions-api.json index 93110596428..d71520bc850 100644 --- a/cloudfunctions/v2beta/cloudfunctions-api.json +++ b/cloudfunctions/v2beta/cloudfunctions-api.json @@ -571,7 +571,7 @@ } } }, - "revision": "20230406", + "revision": "20230420", "rootUrl": "https://cloudfunctions.googleapis.com/", "schemas": { "AuditConfig": { @@ -1074,30 +1074,6 @@ }, "type": "object" }, - "GoogleCloudFunctionsV2alphaLocationMetadata": { - "description": "Extra GCF specific location information.", - "id": "GoogleCloudFunctionsV2alphaLocationMetadata", - "properties": { - "environments": { - "description": "The Cloud Function environments this location supports.", - "items": { - "enum": [ - "ENVIRONMENT_UNSPECIFIED", - "GEN_1", - "GEN_2" - ], - "enumDescriptions": [ - "Unspecified", - "Gen 1", - "Gen 2" - ], - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "GoogleCloudFunctionsV2alphaOperationMetadata": { "description": "Represents the metadata of the long-running operation.", "id": "GoogleCloudFunctionsV2alphaOperationMetadata", @@ -1131,7 +1107,7 @@ "stages": { "description": "Mechanism for reporting in-progress stages", "items": { - "$ref": "Stage" + "$ref": "GoogleCloudFunctionsV2alphaStage" }, "type": "array" }, @@ -1150,6 +1126,70 @@ }, "type": "object" }, + "GoogleCloudFunctionsV2alphaStage": { + "description": "Each Stage of the deployment process", + "id": "GoogleCloudFunctionsV2alphaStage", + "properties": { + "message": { + "description": "Message describing the Stage", + "type": "string" + }, + "name": { + "description": "Name of the Stage. This will be unique for each Stage.", + "enum": [ + "NAME_UNSPECIFIED", + "ARTIFACT_REGISTRY", + "BUILD", + "SERVICE", + "TRIGGER", + "SERVICE_ROLLBACK", + "TRIGGER_ROLLBACK" + ], + "enumDescriptions": [ + "Not specified. Invalid name.", + "Artifact Regsitry Stage", + "Build Stage", + "Service Stage", + "Trigger Stage", + "Service Rollback Stage", + "Trigger Rollback Stage" + ], + "type": "string" + }, + "resource": { + "description": "Resource of the Stage", + "type": "string" + }, + "resourceUri": { + "description": "Link to the current Stage resource", + "type": "string" + }, + "state": { + "description": "Current state of the Stage", + "enum": [ + "STATE_UNSPECIFIED", + "NOT_STARTED", + "IN_PROGRESS", + "COMPLETE" + ], + "enumDescriptions": [ + "Not specified. Invalid state.", + "Stage has not started.", + "Stage is in progress.", + "Stage has completed." + ], + "type": "string" + }, + "stateMessages": { + "description": "State messages from the current Stage.", + "items": { + "$ref": "GoogleCloudFunctionsV2alphaStateMessage" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudFunctionsV2alphaStateMessage": { "description": "Informational messages about the state of the Cloud Function or Operation.", "id": "GoogleCloudFunctionsV2alphaStateMessage", @@ -1181,30 +1221,6 @@ }, "type": "object" }, - "GoogleCloudFunctionsV2betaLocationMetadata": { - "description": "Extra GCF specific location information.", - "id": "GoogleCloudFunctionsV2betaLocationMetadata", - "properties": { - "environments": { - "description": "The Cloud Function environments this location supports.", - "items": { - "enum": [ - "ENVIRONMENT_UNSPECIFIED", - "GEN_1", - "GEN_2" - ], - "enumDescriptions": [ - "Unspecified", - "Gen 1", - "Gen 2" - ], - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "GoogleCloudFunctionsV2betaOperationMetadata": { "description": "Represents the metadata of the long-running operation.", "id": "GoogleCloudFunctionsV2betaOperationMetadata", @@ -1428,7 +1444,7 @@ "type": "object" }, "Location": { - "description": "A resource that represents Google Cloud Platform location.", + "description": "A resource that represents a Google Cloud location.", "id": "Location", "properties": { "displayName": { @@ -1461,30 +1477,6 @@ }, "type": "object" }, - "LocationMetadata": { - "description": "Extra GCF specific location information.", - "id": "LocationMetadata", - "properties": { - "environments": { - "description": "The Cloud Function environments this location supports.", - "items": { - "enum": [ - "ENVIRONMENT_UNSPECIFIED", - "GEN_1", - "GEN_2" - ], - "enumDescriptions": [ - "Unspecified", - "Gen 1", - "Gen 2" - ], - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "Operation": { "description": "This resource represents a long-running operation that is the result of a network API call.", "id": "Operation", @@ -1938,70 +1930,6 @@ }, "type": "object" }, - "Stage": { - "description": "Each Stage of the deployment process", - "id": "Stage", - "properties": { - "message": { - "description": "Message describing the Stage", - "type": "string" - }, - "name": { - "description": "Name of the Stage. This will be unique for each Stage.", - "enum": [ - "NAME_UNSPECIFIED", - "ARTIFACT_REGISTRY", - "BUILD", - "SERVICE", - "TRIGGER", - "SERVICE_ROLLBACK", - "TRIGGER_ROLLBACK" - ], - "enumDescriptions": [ - "Not specified. Invalid name.", - "Artifact Regsitry Stage", - "Build Stage", - "Service Stage", - "Trigger Stage", - "Service Rollback Stage", - "Trigger Rollback Stage" - ], - "type": "string" - }, - "resource": { - "description": "Resource of the Stage", - "type": "string" - }, - "resourceUri": { - "description": "Link to the current Stage resource", - "type": "string" - }, - "state": { - "description": "Current state of the Stage", - "enum": [ - "STATE_UNSPECIFIED", - "NOT_STARTED", - "IN_PROGRESS", - "COMPLETE" - ], - "enumDescriptions": [ - "Not specified. Invalid state.", - "Stage has not started.", - "Stage is in progress.", - "Stage has completed." - ], - "type": "string" - }, - "stateMessages": { - "description": "State messages from the current Stage.", - "items": { - "$ref": "GoogleCloudFunctionsV2alphaStateMessage" - }, - "type": "array" - } - }, - "type": "object" - }, "Status": { "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", "id": "Status", diff --git a/cloudfunctions/v2beta/cloudfunctions-gen.go b/cloudfunctions/v2beta/cloudfunctions-gen.go index dc8ff315e81..1e73941d077 100644 --- a/cloudfunctions/v2beta/cloudfunctions-gen.go +++ b/cloudfunctions/v2beta/cloudfunctions-gen.go @@ -1011,40 +1011,6 @@ func (s *GoogleCloudFunctionsV2StateMessage) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudFunctionsV2alphaLocationMetadata: Extra GCF specific -// location information. -type GoogleCloudFunctionsV2alphaLocationMetadata struct { - // Environments: The Cloud Function environments this location supports. - // - // Possible values: - // "ENVIRONMENT_UNSPECIFIED" - Unspecified - // "GEN_1" - Gen 1 - // "GEN_2" - Gen 2 - Environments []string `json:"environments,omitempty"` - - // ForceSendFields is a list of field names (e.g. "Environments") to - // unconditionally include in API requests. By default, fields with - // empty or default values are omitted from API requests. However, any - // non-pointer, non-interface field appearing in ForceSendFields will be - // sent to the server regardless of whether the field is empty or not. - // This may be used to include empty fields in Patch requests. - ForceSendFields []string `json:"-"` - - // NullFields is a list of field names (e.g. "Environments") to include - // in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. However, any field with - // an empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. - NullFields []string `json:"-"` -} - -func (s *GoogleCloudFunctionsV2alphaLocationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudFunctionsV2alphaLocationMetadata - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // GoogleCloudFunctionsV2alphaOperationMetadata: Represents the metadata // of the long-running operation. type GoogleCloudFunctionsV2alphaOperationMetadata struct { @@ -1067,7 +1033,7 @@ type GoogleCloudFunctionsV2alphaOperationMetadata struct { RequestResource googleapi.RawMessage `json:"requestResource,omitempty"` // Stages: Mechanism for reporting in-progress stages - Stages []*Stage `json:"stages,omitempty"` + Stages []*GoogleCloudFunctionsV2alphaStage `json:"stages,omitempty"` // StatusDetail: Human-readable status of the operation, if any. StatusDetail string `json:"statusDetail,omitempty"` @@ -1101,23 +1067,41 @@ func (s *GoogleCloudFunctionsV2alphaOperationMetadata) MarshalJSON() ([]byte, er return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudFunctionsV2alphaStateMessage: Informational messages about -// the state of the Cloud Function or Operation. -type GoogleCloudFunctionsV2alphaStateMessage struct { - // Message: The message. +// GoogleCloudFunctionsV2alphaStage: Each Stage of the deployment +// process +type GoogleCloudFunctionsV2alphaStage struct { + // Message: Message describing the Stage Message string `json:"message,omitempty"` - // Severity: Severity of the state message. + // Name: Name of the Stage. This will be unique for each Stage. // // Possible values: - // "SEVERITY_UNSPECIFIED" - Not specified. Invalid severity. - // "ERROR" - ERROR-level severity. - // "WARNING" - WARNING-level severity. - // "INFO" - INFO-level severity. - Severity string `json:"severity,omitempty"` + // "NAME_UNSPECIFIED" - Not specified. Invalid name. + // "ARTIFACT_REGISTRY" - Artifact Regsitry Stage + // "BUILD" - Build Stage + // "SERVICE" - Service Stage + // "TRIGGER" - Trigger Stage + // "SERVICE_ROLLBACK" - Service Rollback Stage + // "TRIGGER_ROLLBACK" - Trigger Rollback Stage + Name string `json:"name,omitempty"` - // Type: One-word CamelCase type of the state message. - Type string `json:"type,omitempty"` + // Resource: Resource of the Stage + Resource string `json:"resource,omitempty"` + + // ResourceUri: Link to the current Stage resource + ResourceUri string `json:"resourceUri,omitempty"` + + // State: Current state of the Stage + // + // Possible values: + // "STATE_UNSPECIFIED" - Not specified. Invalid state. + // "NOT_STARTED" - Stage has not started. + // "IN_PROGRESS" - Stage is in progress. + // "COMPLETE" - Stage has completed. + State string `json:"state,omitempty"` + + // StateMessages: State messages from the current Stage. + StateMessages []*GoogleCloudFunctionsV2alphaStateMessage `json:"stateMessages,omitempty"` // ForceSendFields is a list of field names (e.g. "Message") to // unconditionally include in API requests. By default, fields with @@ -1136,24 +1120,31 @@ type GoogleCloudFunctionsV2alphaStateMessage struct { NullFields []string `json:"-"` } -func (s *GoogleCloudFunctionsV2alphaStateMessage) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudFunctionsV2alphaStateMessage +func (s *GoogleCloudFunctionsV2alphaStage) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudFunctionsV2alphaStage raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudFunctionsV2betaLocationMetadata: Extra GCF specific -// location information. -type GoogleCloudFunctionsV2betaLocationMetadata struct { - // Environments: The Cloud Function environments this location supports. +// GoogleCloudFunctionsV2alphaStateMessage: Informational messages about +// the state of the Cloud Function or Operation. +type GoogleCloudFunctionsV2alphaStateMessage struct { + // Message: The message. + Message string `json:"message,omitempty"` + + // Severity: Severity of the state message. // // Possible values: - // "ENVIRONMENT_UNSPECIFIED" - Unspecified - // "GEN_1" - Gen 1 - // "GEN_2" - Gen 2 - Environments []string `json:"environments,omitempty"` + // "SEVERITY_UNSPECIFIED" - Not specified. Invalid severity. + // "ERROR" - ERROR-level severity. + // "WARNING" - WARNING-level severity. + // "INFO" - INFO-level severity. + Severity string `json:"severity,omitempty"` + + // Type: One-word CamelCase type of the state message. + Type string `json:"type,omitempty"` - // ForceSendFields is a list of field names (e.g. "Environments") to + // ForceSendFields is a list of field names (e.g. "Message") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be @@ -1161,17 +1152,17 @@ type GoogleCloudFunctionsV2betaLocationMetadata struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Environments") to include - // in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. However, any field with - // an empty value appearing in NullFields will be sent to the server as + // NullFields is a list of field names (e.g. "Message") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` } -func (s *GoogleCloudFunctionsV2betaLocationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudFunctionsV2betaLocationMetadata +func (s *GoogleCloudFunctionsV2alphaStateMessage) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudFunctionsV2alphaStateMessage raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } @@ -1478,7 +1469,7 @@ func (s *ListRuntimesResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Location: A resource that represents Google Cloud Platform location. +// Location: A resource that represents a Google Cloud location. type Location struct { // DisplayName: The friendly name for this location, typically a nearby // city name. For example, "Tokyo". @@ -1524,39 +1515,6 @@ func (s *Location) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// LocationMetadata: Extra GCF specific location information. -type LocationMetadata struct { - // Environments: The Cloud Function environments this location supports. - // - // Possible values: - // "ENVIRONMENT_UNSPECIFIED" - Unspecified - // "GEN_1" - Gen 1 - // "GEN_2" - Gen 2 - Environments []string `json:"environments,omitempty"` - - // ForceSendFields is a list of field names (e.g. "Environments") to - // unconditionally include in API requests. By default, fields with - // empty or default values are omitted from API requests. However, any - // non-pointer, non-interface field appearing in ForceSendFields will be - // sent to the server regardless of whether the field is empty or not. - // This may be used to include empty fields in Patch requests. - ForceSendFields []string `json:"-"` - - // NullFields is a list of field names (e.g. "Environments") to include - // in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. However, any field with - // an empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. - NullFields []string `json:"-"` -} - -func (s *LocationMetadata) MarshalJSON() ([]byte, error) { - type NoMethod LocationMetadata - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // Operation: This resource represents a long-running operation that is // the result of a network API call. type Operation struct { @@ -2290,64 +2248,6 @@ func (s *SourceProvenance) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Stage: Each Stage of the deployment process -type Stage struct { - // Message: Message describing the Stage - Message string `json:"message,omitempty"` - - // Name: Name of the Stage. This will be unique for each Stage. - // - // Possible values: - // "NAME_UNSPECIFIED" - Not specified. Invalid name. - // "ARTIFACT_REGISTRY" - Artifact Regsitry Stage - // "BUILD" - Build Stage - // "SERVICE" - Service Stage - // "TRIGGER" - Trigger Stage - // "SERVICE_ROLLBACK" - Service Rollback Stage - // "TRIGGER_ROLLBACK" - Trigger Rollback Stage - Name string `json:"name,omitempty"` - - // Resource: Resource of the Stage - Resource string `json:"resource,omitempty"` - - // ResourceUri: Link to the current Stage resource - ResourceUri string `json:"resourceUri,omitempty"` - - // State: Current state of the Stage - // - // Possible values: - // "STATE_UNSPECIFIED" - Not specified. Invalid state. - // "NOT_STARTED" - Stage has not started. - // "IN_PROGRESS" - Stage is in progress. - // "COMPLETE" - Stage has completed. - State string `json:"state,omitempty"` - - // StateMessages: State messages from the current Stage. - StateMessages []*GoogleCloudFunctionsV2alphaStateMessage `json:"stateMessages,omitempty"` - - // ForceSendFields is a list of field names (e.g. "Message") to - // unconditionally include in API requests. By default, fields with - // empty or default values are omitted from API requests. However, any - // non-pointer, non-interface field appearing in ForceSendFields will be - // sent to the server regardless of whether the field is empty or not. - // This may be used to include empty fields in Patch requests. - ForceSendFields []string `json:"-"` - - // NullFields is a list of field names (e.g. "Message") to include in - // API requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. However, any field with an - // empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. - NullFields []string `json:"-"` -} - -func (s *Stage) MarshalJSON() ([]byte, error) { - type NoMethod Stage - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // Status: The `Status` type defines a logical error model that is // suitable for different programming environments, including REST APIs // and RPC APIs. It is used by gRPC (https://github.com/grpc). Each diff --git a/dialogflow/v2/dialogflow-api.json b/dialogflow/v2/dialogflow-api.json index c89babf5a07..fea170bdbc7 100644 --- a/dialogflow/v2/dialogflow-api.json +++ b/dialogflow/v2/dialogflow-api.json @@ -8143,7 +8143,7 @@ } } }, - "revision": "20230402", + "revision": "20230418", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AudioInput": { @@ -8543,7 +8543,7 @@ "type": "string" }, "agentUri": { - "description": "The URI to a file containing the exported agent. This field is populated only if `agent_uri` is specified in ExportAgentRequest.", + "description": "The URI to a file containing the exported agent. This field is populated if `agent_uri` is specified in ExportAgentRequest.", "type": "string" } }, @@ -8916,7 +8916,7 @@ "type": "object" }, "GoogleCloudDialogflowCxV3Intent": { - "description": "An intent represents a user's intent to interact with a conversational agent. You can provide information for the Dialogflow API to use to match user input to an intent by adding training phrases (i.e., examples of user input) to your intent. Next ID: 15", + "description": "An intent represents a user's intent to interact with a conversational agent. You can provide information for the Dialogflow API to use to match user input to an intent by adding training phrases (i.e., examples of user input) to your intent.", "id": "GoogleCloudDialogflowCxV3Intent", "properties": { "description": { @@ -10408,7 +10408,7 @@ "type": "string" }, "agentUri": { - "description": "The URI to a file containing the exported agent. This field is populated only if `agent_uri` is specified in ExportAgentRequest.", + "description": "The URI to a file containing the exported agent. This field is populated if `agent_uri` is specified in ExportAgentRequest.", "type": "string" } }, @@ -10864,7 +10864,7 @@ "type": "object" }, "GoogleCloudDialogflowCxV3beta1IntentTrainingPhrase": { - "description": "Represents an example that the agent is trained on to identify the intent. Next ID: 15", + "description": "Represents an example that the agent is trained on to identify the intent.", "id": "GoogleCloudDialogflowCxV3beta1IntentTrainingPhrase", "properties": { "id": { @@ -14197,6 +14197,10 @@ "description": "Only used in Participants.AnalyzeContent and Participants.StreamingAnalyzeContent. If `false` and recognition doesn't return any result, trigger `NO_SPEECH_RECOGNIZED` event to Dialogflow agent.", "type": "boolean" }, + "enableAutomaticPunctuation": { + "description": "Enable automatic punctuation option at the speech backend.", + "type": "boolean" + }, "enableWordInfo": { "description": "If `true`, Dialogflow returns SpeechWordInfo in StreamingRecognitionResult with information about the recognized speech words, e.g. start and end time offsets. If false or unspecified, Speech doesn't return any word-level information.", "type": "boolean" diff --git a/dialogflow/v2/dialogflow-gen.go b/dialogflow/v2/dialogflow-gen.go index 77daf9ff261..9a1506f3333 100644 --- a/dialogflow/v2/dialogflow-gen.go +++ b/dialogflow/v2/dialogflow-gen.go @@ -1583,7 +1583,7 @@ type GoogleCloudDialogflowCxV3ExportAgentResponse struct { AgentContent string `json:"agentContent,omitempty"` // AgentUri: The URI to a file containing the exported agent. This field - // is populated only if `agent_uri` is specified in ExportAgentRequest. + // is populated if `agent_uri` is specified in ExportAgentRequest. AgentUri string `json:"agentUri,omitempty"` // ForceSendFields is a list of field names (e.g. "AgentContent") to @@ -2353,7 +2353,7 @@ func (s *GoogleCloudDialogflowCxV3InputAudioConfig) MarshalJSON() ([]byte, error // to interact with a conversational agent. You can provide information // for the Dialogflow API to use to match user input to an intent by // adding training phrases (i.e., examples of user input) to your -// intent. Next ID: 15 +// intent. type GoogleCloudDialogflowCxV3Intent struct { // Description: Human readable description for better understanding an // intent like its scope, content, result etc. Maximum character limit: @@ -5093,7 +5093,7 @@ type GoogleCloudDialogflowCxV3beta1ExportAgentResponse struct { AgentContent string `json:"agentContent,omitempty"` // AgentUri: The URI to a file containing the exported agent. This field - // is populated only if `agent_uri` is specified in ExportAgentRequest. + // is populated if `agent_uri` is specified in ExportAgentRequest. AgentUri string `json:"agentUri,omitempty"` // ForceSendFields is a list of field names (e.g. "AgentContent") to @@ -6017,8 +6017,7 @@ func (s *GoogleCloudDialogflowCxV3beta1IntentParameter) MarshalJSON() ([]byte, e } // GoogleCloudDialogflowCxV3beta1IntentTrainingPhrase: Represents an -// example that the agent is trained on to identify the intent. Next ID: -// 15 +// example that the agent is trained on to identify the intent. type GoogleCloudDialogflowCxV3beta1IntentTrainingPhrase struct { // Id: Output only. The unique identifier of the training phrase. Id string `json:"id,omitempty"` @@ -12058,6 +12057,10 @@ type GoogleCloudDialogflowV2InputAudioConfig struct { // `NO_SPEECH_RECOGNIZED` event to Dialogflow agent. DisableNoSpeechRecognizedEvent bool `json:"disableNoSpeechRecognizedEvent,omitempty"` + // EnableAutomaticPunctuation: Enable automatic punctuation option at + // the speech backend. + EnableAutomaticPunctuation bool `json:"enableAutomaticPunctuation,omitempty"` + // EnableWordInfo: If `true`, Dialogflow returns SpeechWordInfo in // StreamingRecognitionResult with information about the recognized // speech words, e.g. start and end time offsets. If false or diff --git a/dialogflow/v2beta1/dialogflow-api.json b/dialogflow/v2beta1/dialogflow-api.json index 9baddb691ba..676b8c72f65 100644 --- a/dialogflow/v2beta1/dialogflow-api.json +++ b/dialogflow/v2beta1/dialogflow-api.json @@ -7507,7 +7507,7 @@ } } }, - "revision": "20230402", + "revision": "20230418", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AudioInput": { @@ -7907,7 +7907,7 @@ "type": "string" }, "agentUri": { - "description": "The URI to a file containing the exported agent. This field is populated only if `agent_uri` is specified in ExportAgentRequest.", + "description": "The URI to a file containing the exported agent. This field is populated if `agent_uri` is specified in ExportAgentRequest.", "type": "string" } }, @@ -8280,7 +8280,7 @@ "type": "object" }, "GoogleCloudDialogflowCxV3Intent": { - "description": "An intent represents a user's intent to interact with a conversational agent. You can provide information for the Dialogflow API to use to match user input to an intent by adding training phrases (i.e., examples of user input) to your intent. Next ID: 15", + "description": "An intent represents a user's intent to interact with a conversational agent. You can provide information for the Dialogflow API to use to match user input to an intent by adding training phrases (i.e., examples of user input) to your intent.", "id": "GoogleCloudDialogflowCxV3Intent", "properties": { "description": { @@ -9772,7 +9772,7 @@ "type": "string" }, "agentUri": { - "description": "The URI to a file containing the exported agent. This field is populated only if `agent_uri` is specified in ExportAgentRequest.", + "description": "The URI to a file containing the exported agent. This field is populated if `agent_uri` is specified in ExportAgentRequest.", "type": "string" } }, @@ -10228,7 +10228,7 @@ "type": "object" }, "GoogleCloudDialogflowCxV3beta1IntentTrainingPhrase": { - "description": "Represents an example that the agent is trained on to identify the intent. Next ID: 15", + "description": "Represents an example that the agent is trained on to identify the intent.", "id": "GoogleCloudDialogflowCxV3beta1IntentTrainingPhrase", "properties": { "id": { @@ -15438,6 +15438,10 @@ "description": "Only used in Participants.AnalyzeContent and Participants.StreamingAnalyzeContent. If `false` and recognition doesn't return any result, trigger `NO_SPEECH_RECOGNIZED` event to Dialogflow agent.", "type": "boolean" }, + "enableAutomaticPunctuation": { + "description": "Enable automatic punctuation option at the speech backend.", + "type": "boolean" + }, "enableWordInfo": { "description": "If `true`, Dialogflow returns SpeechWordInfo in StreamingRecognitionResult with information about the recognized speech words, e.g. start and end time offsets. If false or unspecified, Speech doesn't return any word-level information.", "type": "boolean" diff --git a/dialogflow/v2beta1/dialogflow-gen.go b/dialogflow/v2beta1/dialogflow-gen.go index f6d1b5dd58e..407721f762e 100644 --- a/dialogflow/v2beta1/dialogflow-gen.go +++ b/dialogflow/v2beta1/dialogflow-gen.go @@ -1511,7 +1511,7 @@ type GoogleCloudDialogflowCxV3ExportAgentResponse struct { AgentContent string `json:"agentContent,omitempty"` // AgentUri: The URI to a file containing the exported agent. This field - // is populated only if `agent_uri` is specified in ExportAgentRequest. + // is populated if `agent_uri` is specified in ExportAgentRequest. AgentUri string `json:"agentUri,omitempty"` // ForceSendFields is a list of field names (e.g. "AgentContent") to @@ -2281,7 +2281,7 @@ func (s *GoogleCloudDialogflowCxV3InputAudioConfig) MarshalJSON() ([]byte, error // to interact with a conversational agent. You can provide information // for the Dialogflow API to use to match user input to an intent by // adding training phrases (i.e., examples of user input) to your -// intent. Next ID: 15 +// intent. type GoogleCloudDialogflowCxV3Intent struct { // Description: Human readable description for better understanding an // intent like its scope, content, result etc. Maximum character limit: @@ -5021,7 +5021,7 @@ type GoogleCloudDialogflowCxV3beta1ExportAgentResponse struct { AgentContent string `json:"agentContent,omitempty"` // AgentUri: The URI to a file containing the exported agent. This field - // is populated only if `agent_uri` is specified in ExportAgentRequest. + // is populated if `agent_uri` is specified in ExportAgentRequest. AgentUri string `json:"agentUri,omitempty"` // ForceSendFields is a list of field names (e.g. "AgentContent") to @@ -5945,8 +5945,7 @@ func (s *GoogleCloudDialogflowCxV3beta1IntentParameter) MarshalJSON() ([]byte, e } // GoogleCloudDialogflowCxV3beta1IntentTrainingPhrase: Represents an -// example that the agent is trained on to identify the intent. Next ID: -// 15 +// example that the agent is trained on to identify the intent. type GoogleCloudDialogflowCxV3beta1IntentTrainingPhrase struct { // Id: Output only. The unique identifier of the training phrase. Id string `json:"id,omitempty"` @@ -15179,6 +15178,10 @@ type GoogleCloudDialogflowV2beta1InputAudioConfig struct { // `NO_SPEECH_RECOGNIZED` event to Dialogflow agent. DisableNoSpeechRecognizedEvent bool `json:"disableNoSpeechRecognizedEvent,omitempty"` + // EnableAutomaticPunctuation: Enable automatic punctuation option at + // the speech backend. + EnableAutomaticPunctuation bool `json:"enableAutomaticPunctuation,omitempty"` + // EnableWordInfo: If `true`, Dialogflow returns SpeechWordInfo in // StreamingRecognitionResult with information about the recognized // speech words, e.g. start and end time offsets. If false or diff --git a/dialogflow/v3/dialogflow-api.json b/dialogflow/v3/dialogflow-api.json index eb635afcd7d..2f3b4a7176d 100644 --- a/dialogflow/v3/dialogflow-api.json +++ b/dialogflow/v3/dialogflow-api.json @@ -3820,7 +3820,7 @@ } } }, - "revision": "20230402", + "revision": "20230418", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AdvancedSettings": { @@ -4952,7 +4952,7 @@ "type": "string" }, "agentUri": { - "description": "The URI to a file containing the exported agent. This field is populated only if `agent_uri` is specified in ExportAgentRequest.", + "description": "The URI to a file containing the exported agent. This field is populated if `agent_uri` is specified in ExportAgentRequest.", "type": "string" } }, @@ -5536,7 +5536,7 @@ "type": "object" }, "GoogleCloudDialogflowCxV3Intent": { - "description": "An intent represents a user's intent to interact with a conversational agent. You can provide information for the Dialogflow API to use to match user input to an intent by adding training phrases (i.e., examples of user input) to your intent. Next ID: 15", + "description": "An intent represents a user's intent to interact with a conversational agent. You can provide information for the Dialogflow API to use to match user input to an intent by adding training phrases (i.e., examples of user input) to your intent.", "id": "GoogleCloudDialogflowCxV3Intent", "properties": { "description": { @@ -8481,7 +8481,7 @@ "type": "string" }, "agentUri": { - "description": "The URI to a file containing the exported agent. This field is populated only if `agent_uri` is specified in ExportAgentRequest.", + "description": "The URI to a file containing the exported agent. This field is populated if `agent_uri` is specified in ExportAgentRequest.", "type": "string" } }, @@ -8937,7 +8937,7 @@ "type": "object" }, "GoogleCloudDialogflowCxV3beta1IntentTrainingPhrase": { - "description": "Represents an example that the agent is trained on to identify the intent. Next ID: 15", + "description": "Represents an example that the agent is trained on to identify the intent.", "id": "GoogleCloudDialogflowCxV3beta1IntentTrainingPhrase", "properties": { "id": { diff --git a/dialogflow/v3/dialogflow-gen.go b/dialogflow/v3/dialogflow-gen.go index b1a7bf6f1fc..563bd17adc0 100644 --- a/dialogflow/v3/dialogflow-gen.go +++ b/dialogflow/v3/dialogflow-gen.go @@ -2454,7 +2454,7 @@ type GoogleCloudDialogflowCxV3ExportAgentResponse struct { AgentContent string `json:"agentContent,omitempty"` // AgentUri: The URI to a file containing the exported agent. This field - // is populated only if `agent_uri` is specified in ExportAgentRequest. + // is populated if `agent_uri` is specified in ExportAgentRequest. AgentUri string `json:"agentUri,omitempty"` // ForceSendFields is a list of field names (e.g. "AgentContent") to @@ -3653,7 +3653,7 @@ func (s *GoogleCloudDialogflowCxV3InputAudioConfig) MarshalJSON() ([]byte, error // to interact with a conversational agent. You can provide information // for the Dialogflow API to use to match user input to an intent by // adding training phrases (i.e., examples of user input) to your -// intent. Next ID: 15 +// intent. type GoogleCloudDialogflowCxV3Intent struct { // Description: Human readable description for better understanding an // intent like its scope, content, result etc. Maximum character limit: @@ -9148,7 +9148,7 @@ type GoogleCloudDialogflowCxV3beta1ExportAgentResponse struct { AgentContent string `json:"agentContent,omitempty"` // AgentUri: The URI to a file containing the exported agent. This field - // is populated only if `agent_uri` is specified in ExportAgentRequest. + // is populated if `agent_uri` is specified in ExportAgentRequest. AgentUri string `json:"agentUri,omitempty"` // ForceSendFields is a list of field names (e.g. "AgentContent") to @@ -10072,8 +10072,7 @@ func (s *GoogleCloudDialogflowCxV3beta1IntentParameter) MarshalJSON() ([]byte, e } // GoogleCloudDialogflowCxV3beta1IntentTrainingPhrase: Represents an -// example that the agent is trained on to identify the intent. Next ID: -// 15 +// example that the agent is trained on to identify the intent. type GoogleCloudDialogflowCxV3beta1IntentTrainingPhrase struct { // Id: Output only. The unique identifier of the training phrase. Id string `json:"id,omitempty"` diff --git a/dialogflow/v3beta1/dialogflow-api.json b/dialogflow/v3beta1/dialogflow-api.json index a37b112f4af..051e754cb74 100644 --- a/dialogflow/v3beta1/dialogflow-api.json +++ b/dialogflow/v3beta1/dialogflow-api.json @@ -3820,7 +3820,7 @@ } } }, - "revision": "20230402", + "revision": "20230418", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AudioInput": { @@ -4220,7 +4220,7 @@ "type": "string" }, "agentUri": { - "description": "The URI to a file containing the exported agent. This field is populated only if `agent_uri` is specified in ExportAgentRequest.", + "description": "The URI to a file containing the exported agent. This field is populated if `agent_uri` is specified in ExportAgentRequest.", "type": "string" } }, @@ -4593,7 +4593,7 @@ "type": "object" }, "GoogleCloudDialogflowCxV3Intent": { - "description": "An intent represents a user's intent to interact with a conversational agent. You can provide information for the Dialogflow API to use to match user input to an intent by adding training phrases (i.e., examples of user input) to your intent. Next ID: 15", + "description": "An intent represents a user's intent to interact with a conversational agent. You can provide information for the Dialogflow API to use to match user input to an intent by adding training phrases (i.e., examples of user input) to your intent.", "id": "GoogleCloudDialogflowCxV3Intent", "properties": { "description": { @@ -6817,7 +6817,7 @@ "type": "string" }, "agentUri": { - "description": "The URI to a file containing the exported agent. This field is populated only if `agent_uri` is specified in ExportAgentRequest.", + "description": "The URI to a file containing the exported agent. This field is populated if `agent_uri` is specified in ExportAgentRequest.", "type": "string" } }, @@ -7518,7 +7518,7 @@ "type": "object" }, "GoogleCloudDialogflowCxV3beta1IntentTrainingPhrase": { - "description": "Represents an example that the agent is trained on to identify the intent. Next ID: 15", + "description": "Represents an example that the agent is trained on to identify the intent.", "id": "GoogleCloudDialogflowCxV3beta1IntentTrainingPhrase", "properties": { "id": { diff --git a/dialogflow/v3beta1/dialogflow-gen.go b/dialogflow/v3beta1/dialogflow-gen.go index 8175cd1bf84..36be887f474 100644 --- a/dialogflow/v3beta1/dialogflow-gen.go +++ b/dialogflow/v3beta1/dialogflow-gen.go @@ -1175,7 +1175,7 @@ type GoogleCloudDialogflowCxV3ExportAgentResponse struct { AgentContent string `json:"agentContent,omitempty"` // AgentUri: The URI to a file containing the exported agent. This field - // is populated only if `agent_uri` is specified in ExportAgentRequest. + // is populated if `agent_uri` is specified in ExportAgentRequest. AgentUri string `json:"agentUri,omitempty"` // ForceSendFields is a list of field names (e.g. "AgentContent") to @@ -1945,7 +1945,7 @@ func (s *GoogleCloudDialogflowCxV3InputAudioConfig) MarshalJSON() ([]byte, error // to interact with a conversational agent. You can provide information // for the Dialogflow API to use to match user input to an intent by // adding training phrases (i.e., examples of user input) to your -// intent. Next ID: 15 +// intent. type GoogleCloudDialogflowCxV3Intent struct { // Description: Human readable description for better understanding an // intent like its scope, content, result etc. Maximum character limit: @@ -5966,7 +5966,7 @@ type GoogleCloudDialogflowCxV3beta1ExportAgentResponse struct { AgentContent string `json:"agentContent,omitempty"` // AgentUri: The URI to a file containing the exported agent. This field - // is populated only if `agent_uri` is specified in ExportAgentRequest. + // is populated if `agent_uri` is specified in ExportAgentRequest. AgentUri string `json:"agentUri,omitempty"` // ForceSendFields is a list of field names (e.g. "AgentContent") to @@ -7403,8 +7403,7 @@ func (s *GoogleCloudDialogflowCxV3beta1IntentParameter) MarshalJSON() ([]byte, e } // GoogleCloudDialogflowCxV3beta1IntentTrainingPhrase: Represents an -// example that the agent is trained on to identify the intent. Next ID: -// 15 +// example that the agent is trained on to identify the intent. type GoogleCloudDialogflowCxV3beta1IntentTrainingPhrase struct { // Id: Output only. The unique identifier of the training phrase. Id string `json:"id,omitempty"` diff --git a/publicca/v1/publicca-api.json b/publicca/v1/publicca-api.json new file mode 100644 index 00000000000..ba585304414 --- /dev/null +++ b/publicca/v1/publicca-api.json @@ -0,0 +1,180 @@ +{ + "auth": { + "oauth2": { + "scopes": { + "https://www.googleapis.com/auth/cloud-platform": { + "description": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account." + } + } + } + }, + "basePath": "", + "baseUrl": "https://publicca.googleapis.com/", + "batchPath": "batch", + "canonicalName": "Public Certificate Authority", + "description": "The Public Certificate Authority API may be used to create and manage ACME external account binding keys associated with Google Trust Services' publicly trusted certificate authority. ", + "discoveryVersion": "v1", + "documentationLink": "https://cloud.google.com/public-certificate-authority/docs", + "fullyEncodeReservedExpansion": true, + "icons": { + "x16": "http://www.google.com/images/icons/product/search-16.gif", + "x32": "http://www.google.com/images/icons/product/search-32.gif" + }, + "id": "publicca:v1", + "kind": "discovery#restDescription", + "mtlsRootUrl": "https://publicca.mtls.googleapis.com/", + "name": "publicca", + "ownerDomain": "google.com", + "ownerName": "Google", + "parameters": { + "$.xgafv": { + "description": "V1 error format.", + "enum": [ + "1", + "2" + ], + "enumDescriptions": [ + "v1 error format", + "v2 error format" + ], + "location": "query", + "type": "string" + }, + "access_token": { + "description": "OAuth access token.", + "location": "query", + "type": "string" + }, + "alt": { + "default": "json", + "description": "Data format for response.", + "enum": [ + "json", + "media", + "proto" + ], + "enumDescriptions": [ + "Responses with Content-Type of application/json", + "Media download with context-dependent Content-Type", + "Responses with Content-Type of application/x-protobuf" + ], + "location": "query", + "type": "string" + }, + "callback": { + "description": "JSONP", + "location": "query", + "type": "string" + }, + "fields": { + "description": "Selector specifying which fields to include in a partial response.", + "location": "query", + "type": "string" + }, + "key": { + "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.", + "location": "query", + "type": "string" + }, + "oauth_token": { + "description": "OAuth 2.0 token for the current user.", + "location": "query", + "type": "string" + }, + "prettyPrint": { + "default": "true", + "description": "Returns response with indentations and line breaks.", + "location": "query", + "type": "boolean" + }, + "quotaUser": { + "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", + "location": "query", + "type": "string" + }, + "uploadType": { + "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", + "location": "query", + "type": "string" + }, + "upload_protocol": { + "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", + "location": "query", + "type": "string" + } + }, + "protocol": "rest", + "resources": { + "projects": { + "resources": { + "locations": { + "resources": { + "externalAccountKeys": { + "methods": { + "create": { + "description": "Creates a new ExternalAccountKey bound to the project.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/externalAccountKeys", + "httpMethod": "POST", + "id": "publicca.projects.locations.externalAccountKeys.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent resource where this external_account_key will be created. Format: projects/[project_id]/locations/[location]. At present only the \"global\" location is supported.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/externalAccountKeys", + "request": { + "$ref": "ExternalAccountKey" + }, + "response": { + "$ref": "ExternalAccountKey" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + } + } + } + }, + "revision": "20230424", + "rootUrl": "https://publicca.googleapis.com/", + "schemas": { + "ExternalAccountKey": { + "description": "A representation of an ExternalAccountKey used for [external account binding](https://tools.ietf.org/html/rfc8555#section-7.3.4) within ACME.", + "id": "ExternalAccountKey", + "properties": { + "b64MacKey": { + "description": "Output only. Base64-URL-encoded HS256 key. It is generated by the PublicCertificateAuthorityService when the ExternalAccountKey is created", + "format": "byte", + "readOnly": true, + "type": "string" + }, + "keyId": { + "description": "Output only. Key ID. It is generated by the PublicCertificateAuthorityService when the ExternalAccountKey is created", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Output only. Resource name. projects/{project}/locations/{location}/externalAccountKeys/{key_id}", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + } + }, + "servicePath": "", + "title": "Public Certificate Authority API", + "version": "v1", + "version_module": true +} \ No newline at end of file diff --git a/publicca/v1/publicca-gen.go b/publicca/v1/publicca-gen.go new file mode 100644 index 00000000000..208c9c686fd --- /dev/null +++ b/publicca/v1/publicca-gen.go @@ -0,0 +1,361 @@ +// Copyright 2023 Google LLC. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +// Code generated file. DO NOT EDIT. + +// Package publicca provides access to the Public Certificate Authority API. +// +// For product documentation, see: https://cloud.google.com/public-certificate-authority/docs +// +// # Creating a client +// +// Usage example: +// +// import "google.golang.org/api/publicca/v1" +// ... +// ctx := context.Background() +// publiccaService, err := publicca.NewService(ctx) +// +// In this example, Google Application Default Credentials are used for authentication. +// +// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials. +// +// # Other authentication options +// +// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey: +// +// publiccaService, err := publicca.NewService(ctx, option.WithAPIKey("AIza...")) +// +// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource: +// +// config := &oauth2.Config{...} +// // ... +// token, err := config.Exchange(ctx, ...) +// publiccaService, err := publicca.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token))) +// +// See https://godoc.org/google.golang.org/api/option/ for details on options. +package publicca // import "google.golang.org/api/publicca/v1" + +import ( + "bytes" + "context" + "encoding/json" + "errors" + "fmt" + "io" + "net/http" + "net/url" + "strconv" + "strings" + + googleapi "google.golang.org/api/googleapi" + internal "google.golang.org/api/internal" + gensupport "google.golang.org/api/internal/gensupport" + option "google.golang.org/api/option" + internaloption "google.golang.org/api/option/internaloption" + htransport "google.golang.org/api/transport/http" +) + +// Always reference these packages, just in case the auto-generated code +// below doesn't. +var _ = bytes.NewBuffer +var _ = strconv.Itoa +var _ = fmt.Sprintf +var _ = json.NewDecoder +var _ = io.Copy +var _ = url.Parse +var _ = gensupport.MarshalJSON +var _ = googleapi.Version +var _ = errors.New +var _ = strings.Replace +var _ = context.Canceled +var _ = internaloption.WithDefaultEndpoint +var _ = internal.Version + +const apiId = "publicca:v1" +const apiName = "publicca" +const apiVersion = "v1" +const basePath = "https://publicca.googleapis.com/" +const mtlsBasePath = "https://publicca.mtls.googleapis.com/" + +// OAuth2 scopes used by this API. +const ( + // See, edit, configure, and delete your Google Cloud data and see the + // email address for your Google Account. + CloudPlatformScope = "https://www.googleapis.com/auth/cloud-platform" +) + +// NewService creates a new Service. +func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, error) { + scopesOption := internaloption.WithDefaultScopes( + "https://www.googleapis.com/auth/cloud-platform", + ) + // NOTE: prepend, so we don't override user-specified scopes. + opts = append([]option.ClientOption{scopesOption}, opts...) + opts = append(opts, internaloption.WithDefaultEndpoint(basePath)) + opts = append(opts, internaloption.WithDefaultMTLSEndpoint(mtlsBasePath)) + client, endpoint, err := htransport.NewClient(ctx, opts...) + if err != nil { + return nil, err + } + s, err := New(client) + if err != nil { + return nil, err + } + if endpoint != "" { + s.BasePath = endpoint + } + return s, nil +} + +// New creates a new Service. It uses the provided http.Client for requests. +// +// Deprecated: please use NewService instead. +// To provide a custom HTTP client, use option.WithHTTPClient. +// If you are using google.golang.org/api/googleapis/transport.APIKey, use option.WithAPIKey with NewService instead. +func New(client *http.Client) (*Service, error) { + if client == nil { + return nil, errors.New("client is nil") + } + s := &Service{client: client, BasePath: basePath} + s.Projects = NewProjectsService(s) + return s, nil +} + +type Service struct { + client *http.Client + BasePath string // API endpoint base URL + UserAgent string // optional additional User-Agent fragment + + Projects *ProjectsService +} + +func (s *Service) userAgent() string { + if s.UserAgent == "" { + return googleapi.UserAgent + } + return googleapi.UserAgent + " " + s.UserAgent +} + +func NewProjectsService(s *Service) *ProjectsService { + rs := &ProjectsService{s: s} + rs.Locations = NewProjectsLocationsService(s) + return rs +} + +type ProjectsService struct { + s *Service + + Locations *ProjectsLocationsService +} + +func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { + rs := &ProjectsLocationsService{s: s} + rs.ExternalAccountKeys = NewProjectsLocationsExternalAccountKeysService(s) + return rs +} + +type ProjectsLocationsService struct { + s *Service + + ExternalAccountKeys *ProjectsLocationsExternalAccountKeysService +} + +func NewProjectsLocationsExternalAccountKeysService(s *Service) *ProjectsLocationsExternalAccountKeysService { + rs := &ProjectsLocationsExternalAccountKeysService{s: s} + return rs +} + +type ProjectsLocationsExternalAccountKeysService struct { + s *Service +} + +// ExternalAccountKey: A representation of an ExternalAccountKey used +// for external account binding +// (https://tools.ietf.org/html/rfc8555#section-7.3.4) within ACME. +type ExternalAccountKey struct { + // B64MacKey: Output only. Base64-URL-encoded HS256 key. It is generated + // by the PublicCertificateAuthorityService when the ExternalAccountKey + // is created + B64MacKey string `json:"b64MacKey,omitempty"` + + // KeyId: Output only. Key ID. It is generated by the + // PublicCertificateAuthorityService when the ExternalAccountKey is + // created + KeyId string `json:"keyId,omitempty"` + + // Name: Output only. Resource name. + // projects/{project}/locations/{location}/externalAccountKeys/{key_id} + Name string `json:"name,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "B64MacKey") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "B64MacKey") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ExternalAccountKey) MarshalJSON() ([]byte, error) { + type NoMethod ExternalAccountKey + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// method id "publicca.projects.locations.externalAccountKeys.create": + +type ProjectsLocationsExternalAccountKeysCreateCall struct { + s *Service + parent string + externalaccountkey *ExternalAccountKey + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a new ExternalAccountKey bound to the project. +// +// - parent: The parent resource where this external_account_key will be +// created. Format: projects/[project_id]/locations/[location]. At +// present only the "global" location is supported. +func (r *ProjectsLocationsExternalAccountKeysService) Create(parent string, externalaccountkey *ExternalAccountKey) *ProjectsLocationsExternalAccountKeysCreateCall { + c := &ProjectsLocationsExternalAccountKeysCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.externalaccountkey = externalaccountkey + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsExternalAccountKeysCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsExternalAccountKeysCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsLocationsExternalAccountKeysCreateCall) Context(ctx context.Context) *ProjectsLocationsExternalAccountKeysCreateCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsLocationsExternalAccountKeysCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsExternalAccountKeysCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.externalaccountkey) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/externalAccountKeys") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "publicca.projects.locations.externalAccountKeys.create" call. +// Exactly one of *ExternalAccountKey or error will be non-nil. Any +// non-2xx status code is an error. Response headers are in either +// *ExternalAccountKey.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was +// because http.StatusNotModified was returned. +func (c *ProjectsLocationsExternalAccountKeysCreateCall) Do(opts ...googleapi.CallOption) (*ExternalAccountKey, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, gensupport.WrapError(&googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + }) + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, gensupport.WrapError(err) + } + ret := &ExternalAccountKey{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Creates a new ExternalAccountKey bound to the project.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/externalAccountKeys", + // "httpMethod": "POST", + // "id": "publicca.projects.locations.externalAccountKeys.create", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "parent": { + // "description": "Required. The parent resource where this external_account_key will be created. Format: projects/[project_id]/locations/[location]. At present only the \"global\" location is supported.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/externalAccountKeys", + // "request": { + // "$ref": "ExternalAccountKey" + // }, + // "response": { + // "$ref": "ExternalAccountKey" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} diff --git a/securitycenter/v1/securitycenter-api.json b/securitycenter/v1/securitycenter-api.json index 09d0a441b56..9aa44b95a05 100644 --- a/securitycenter/v1/securitycenter-api.json +++ b/securitycenter/v1/securitycenter-api.json @@ -4143,7 +4143,7 @@ } } }, - "revision": "20230414", + "revision": "20230420", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -4197,15 +4197,15 @@ "type": "object" }, "AccessReview": { - "description": "Conveys information about a Kubernetes access review (e.g. kubectl auth can-i ...) that was involved in a finding.", + "description": "Conveys information about a Kubernetes access review (such as one returned by a [`kubectl auth can-i`](https://kubernetes.io/docs/reference/access-authn-authz/authorization/#checking-api-access) command) that was involved in a finding.", "id": "AccessReview", "properties": { "group": { - "description": "Group is the API Group of the Resource. \"*\" means all.", + "description": "The API group of the resource. \"*\" means all.", "type": "string" }, "name": { - "description": "Name is the name of the resource being requested. Empty means all.", + "description": "The name of the resource being requested. Empty means all.", "type": "string" }, "ns": { @@ -4213,19 +4213,19 @@ "type": "string" }, "resource": { - "description": "Resource is the optional resource type requested. \"*\" means all.", + "description": "The optional resource type requested. \"*\" means all.", "type": "string" }, "subresource": { - "description": "Subresource is the optional subresource type.", + "description": "The optional subresource type.", "type": "string" }, "verb": { - "description": "Verb is a Kubernetes resource API verb, like: get, list, watch, create, update, delete, proxy. \"*\" means all.", + "description": "A Kubernetes resource API verb, like get, list, watch, create, update, delete, proxy. \"*\" means all.", "type": "string" }, "version": { - "description": "Version is the API Version of the Resource. \"*\" means all.", + "description": "The API version of the resource. \"*\" means all.", "type": "string" } }, @@ -4415,7 +4415,7 @@ "type": "boolean" }, "infoType": { - "description": "The [type of information](https://cloud.google.com/dlp/docs/infotypes-reference) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.", + "description": "The type of information (or *[infoType](https://cloud.google.com/dlp/docs/infotypes-reference)*) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.", "type": "string" }, "infoTypeCount": { @@ -4435,18 +4435,18 @@ "id": "Compliance", "properties": { "ids": { - "description": "Policies within the standard/benchmark e.g. A.12.4.1", + "description": "Policies within the standard or benchmark, for example, A.12.4.1", "items": { "type": "string" }, "type": "array" }, "standard": { - "description": "Refers to industry wide standards or benchmarks e.g. \"cis\", \"pci\", \"owasp\", etc.", + "description": "Industry-wide compliance standards or benchmarks, such as CIS, PCI, and OWASP.", "type": "string" }, "version": { - "description": "Version of the standard/benchmark e.g. 1.1", + "description": "Version of the standard or benchmark, for example, 1.1", "type": "string" } }, @@ -4509,7 +4509,7 @@ "type": "object" }, "ContactDetails": { - "description": "The details pertaining to specific contacts", + "description": "Details about specific contacts", "id": "ContactDetails", "properties": { "contacts": { @@ -4527,7 +4527,7 @@ "id": "Container", "properties": { "imageId": { - "description": "Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.", + "description": "Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.", "type": "string" }, "labels": { @@ -4538,11 +4538,11 @@ "type": "array" }, "name": { - "description": "Container name.", + "description": "Name of the container.", "type": "string" }, "uri": { - "description": "Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.", + "description": "Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.", "type": "string" } }, @@ -4711,30 +4711,30 @@ "type": "object" }, "Database": { - "description": "Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of CloudSQL instances or Cloud Spanner instances), or the database instance itself. Some database resources may not have the full resource name populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. CloudSQL databases). In these cases only the display name will be provided.", + "description": "Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of Cloud SQL instances or Cloud Spanner instances), or the database instance itself. Some database resources might not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types, such as Cloud SQL databases, are not yet supported by Cloud Asset Inventory. In these cases only the display name is provided. Some database resources may not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. Cloud SQL databases). In these cases only the display name will be provided.", "id": "Database", "properties": { "displayName": { - "description": "The human readable name of the database the user connected to.", + "description": "The human-readable name of the database that the user connected to.", "type": "string" }, "grantees": { - "description": "The target usernames/roles/groups of a SQL privilege grant (not an IAM policy change).", + "description": "The target usernames, roles, or groups of an SQL privilege grant, which is not an IAM policy change.", "items": { "type": "string" }, "type": "array" }, "name": { - "description": "The full resource name of the database the user connected to, if it is supported by CAI. (https://google.aip.dev/122#full-resource-names)", + "description": "The [full resource name](https://google.aip.dev/122#full-resource-names) of the database that the user connected to, if it is supported by Cloud Asset Inventory.", "type": "string" }, "query": { - "description": "The SQL statement associated with the relevant access.", + "description": "The SQL statement that is associated with the database access.", "type": "string" }, "userName": { - "description": "The username used to connect to the DB. This may not necessarily be an IAM principal, and has no required format.", + "description": "The username used to connect to the database. The username might not be an IAM principal and does not have a set format.", "type": "string" } }, @@ -4763,7 +4763,7 @@ "type": "object" }, "EnvironmentVariable": { - "description": "EnvironmentVariable is a name-value pair to store environment variables for Process.", + "description": "A name-value pair representing an environment variable used in an operating system process.", "id": "EnvironmentVariable", "properties": { "name": { @@ -4778,25 +4778,25 @@ "type": "object" }, "ExfilResource": { - "description": "Resource that has been exfiltrated or exfiltrated_to.", + "description": "Resource where data was exfiltrated from or exfiltrated to.", "id": "ExfilResource", "properties": { "components": { - "description": "Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.", + "description": "Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.", "items": { "type": "string" }, "type": "array" }, "name": { - "description": "Resource's URI (https://google.aip.dev/122#full-resource-names)", + "description": "The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).", "type": "string" } }, "type": "object" }, "Exfiltration": { - "description": "Exfiltration represents a data exfiltration attempt of one or more sources to one or more targets. Sources represent the source of data that is exfiltrated, and Targets represents the destination the data was copied to.", + "description": "Exfiltration represents a data exfiltration attempt from one or more sources to one or more targets. The `sources` attribute lists the sources of the exfiltrated data. The `targets` attribute lists the destinations the data was copied to.", "id": "Exfiltration", "properties": { "sources": { @@ -4844,7 +4844,7 @@ "id": "File", "properties": { "contents": { - "description": "Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)", + "description": "Prefix of the file contents as a JSON-encoded string.", "type": "string" }, "hashedSize": { @@ -5217,11 +5217,11 @@ "id": "GoogleCloudSecuritycenterV1Binding", "properties": { "name": { - "description": "Name for binding.", + "description": "Name for the binding.", "type": "string" }, "ns": { - "description": "Namespace for binding.", + "description": "Namespace for the binding.", "type": "string" }, "role": { @@ -5975,7 +5975,7 @@ "type": "string" }, "member": { - "description": "A single identity requesting access for a Cloud Platform resource, e.g. \"foo@google.com\".", + "description": "A single identity requesting access for a Cloud Platform resource, for example, \"foo@google.com\".", "type": "string" }, "role": { @@ -6036,39 +6036,39 @@ "id": "KernelRootkit", "properties": { "name": { - "description": "Rootkit name when available.", + "description": "Rootkit name, when available.", "type": "string" }, "unexpectedCodeModification": { - "description": "True when unexpected modifications of kernel code memory are present.", + "description": "True if unexpected modifications of kernel code memory are present.", "type": "boolean" }, "unexpectedFtraceHandler": { - "description": "True when `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.", + "description": "True if `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.", "type": "boolean" }, "unexpectedInterruptHandler": { - "description": "True when interrupt handlers that are are not in the expected kernel or module code regions are present.", + "description": "True if interrupt handlers that are are not in the expected kernel or module code regions are present.", "type": "boolean" }, "unexpectedKernelCodePages": { - "description": "True when kernel code pages that are not in the expected kernel or module code regions are present.", + "description": "True if kernel code pages that are not in the expected kernel or module code regions are present.", "type": "boolean" }, "unexpectedKprobeHandler": { - "description": "True when `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.", + "description": "True if `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.", "type": "boolean" }, "unexpectedProcessesInRunqueue": { - "description": "True when unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.", + "description": "True if unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.", "type": "boolean" }, "unexpectedReadOnlyDataModification": { - "description": "True when unexpected modifications of kernel read-only data memory are present.", + "description": "True if unexpected modifications of kernel read-only data memory are present.", "type": "boolean" }, "unexpectedSystemCallHandler": { - "description": "True when system call handlers that are are not in the expected kernel or module code regions are present.", + "description": "True if system call handlers that are are not in the expected kernel or module code regions are present.", "type": "boolean" } }, @@ -6079,42 +6079,42 @@ "id": "Kubernetes", "properties": { "accessReviews": { - "description": "Provides information on any Kubernetes access reviews (i.e. privilege checks) relevant to the finding.", + "description": "Provides information on any Kubernetes access reviews (privilege checks) relevant to the finding.", "items": { "$ref": "AccessReview" }, "type": "array" }, "bindings": { - "description": "Provides Kubernetes role binding information for findings that involve RoleBindings or ClusterRoleBindings.", + "description": "Provides Kubernetes role binding information for findings that involve [RoleBindings or ClusterRoleBindings](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).", "items": { "$ref": "GoogleCloudSecuritycenterV1Binding" }, "type": "array" }, "nodePools": { - "description": "GKE Node Pools associated with the finding. This field will contain NodePool information for each Node, when it is available.", + "description": "GKE [node pools](https://cloud.google.com/kubernetes-engine/docs/concepts/node-pools) associated with the finding. This field contains node pool information for each node, when it is available.", "items": { "$ref": "NodePool" }, "type": "array" }, "nodes": { - "description": "Provides Kubernetes Node information.", + "description": "Provides Kubernetes [node](https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-architecture#nodes) information.", "items": { "$ref": "Node" }, "type": "array" }, "pods": { - "description": "Kubernetes Pods associated with the finding. This field will contain Pod records for each container that is owned by a Pod.", + "description": "Kubernetes [Pods](https://cloud.google.com/kubernetes-engine/docs/concepts/pod) associated with the finding. This field contains Pod records for each container that is owned by a Pod.", "items": { "$ref": "Pod" }, "type": "array" }, "roles": { - "description": "Provides Kubernetes role information for findings that involve Roles or ClusterRoles.", + "description": "Provides Kubernetes role information for findings that involve [Roles or ClusterRoles](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).", "items": { "$ref": "Role" }, @@ -6124,15 +6124,15 @@ "type": "object" }, "Label": { - "description": "Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().", + "description": "Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).", "id": "Label", "properties": { "name": { - "description": "Label name.", + "description": "Name of the label.", "type": "string" }, "value": { - "description": "Label value.", + "description": "Value that corresponds to the label's name.", "type": "string" } }, @@ -6674,22 +6674,22 @@ "type": "object" }, "Node": { - "description": "Kubernetes Nodes associated with the finding.", + "description": "Kubernetes nodes associated with the finding.", "id": "Node", "properties": { "name": { - "description": "Full Resource name of the Compute Engine VM running the cluster node.", + "description": "[Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.", "type": "string" } }, "type": "object" }, "NodePool": { - "description": "Provides GKE Node Pool information.", + "description": "Provides GKE node pool information.", "id": "NodePool", "properties": { "name": { - "description": "Kubernetes Node pool name.", + "description": "Kubernetes node pool name.", "type": "string" }, "nodes": { @@ -6785,7 +6785,7 @@ "type": "object" }, "Pod": { - "description": "Kubernetes Pod.", + "description": "A Kubernetes Pod.", "id": "Pod", "properties": { "containers": { @@ -6882,22 +6882,22 @@ "type": "array" }, "name": { - "description": "The process name visible in utilities like `top` and `ps`; it can be accessed via `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.", + "description": "The process name, as displayed in utilities like `top` and `ps`. This name can be accessed through `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.", "type": "string" }, "parentPid": { - "description": "The parent process id.", + "description": "The parent process ID.", "format": "int64", "type": "string" }, "pid": { - "description": "The process id.", + "description": "The process ID.", "format": "int64", "type": "string" }, "script": { "$ref": "File", - "description": "When the process represents the invocation of a script, `binary` provides information about the interpreter while `script` provides information about the script file provided to the interpreter." + "description": "When the process represents the invocation of a script, `binary` provides information about the interpreter, while `script` provides information about the script file provided to the interpreter." } }, "type": "object" @@ -7222,11 +7222,11 @@ "type": "object" }, "Subject": { - "description": "Represents a Kubernetes Subject.", + "description": "Represents a Kubernetes subject.", "id": "Subject", "properties": { "kind": { - "description": "Authentication type for subject.", + "description": "Authentication type for the subject.", "enum": [ "AUTH_TYPE_UNSPECIFIED", "USER", @@ -7236,17 +7236,17 @@ "enumDescriptions": [ "Authentication is not specified.", "User with valid certificate.", - "Users managed by Kubernetes API with credentials stored as Secrets.", + "Users managed by Kubernetes API with credentials stored as secrets.", "Collection of users." ], "type": "string" }, "name": { - "description": "Name for subject.", + "description": "Name for the subject.", "type": "string" }, "ns": { - "description": "Namespace for subject.", + "description": "Namespace for the subject.", "type": "string" } }, diff --git a/securitycenter/v1/securitycenter-gen.go b/securitycenter/v1/securitycenter-gen.go index 3ae30acd58f..f696137b4ff 100644 --- a/securitycenter/v1/securitycenter-gen.go +++ b/securitycenter/v1/securitycenter-gen.go @@ -668,13 +668,14 @@ func (s *Access) MarshalJSON() ([]byte, error) { } // AccessReview: Conveys information about a Kubernetes access review -// (e.g. kubectl auth can-i ...) that was involved in a finding. +// (such as one returned by a `kubectl auth can-i` +// (https://kubernetes.io/docs/reference/access-authn-authz/authorization/#checking-api-access) +// command) that was involved in a finding. type AccessReview struct { - // Group: Group is the API Group of the Resource. "*" means all. + // Group: The API group of the resource. "*" means all. Group string `json:"group,omitempty"` - // Name: Name is the name of the resource being requested. Empty means - // all. + // Name: The name of the resource being requested. Empty means all. Name string `json:"name,omitempty"` // Ns: Namespace of the action being requested. Currently, there is no @@ -682,18 +683,17 @@ type AccessReview struct { // represented by "" (empty). Ns string `json:"ns,omitempty"` - // Resource: Resource is the optional resource type requested. "*" means - // all. + // Resource: The optional resource type requested. "*" means all. Resource string `json:"resource,omitempty"` - // Subresource: Subresource is the optional subresource type. + // Subresource: The optional subresource type. Subresource string `json:"subresource,omitempty"` - // Verb: Verb is a Kubernetes resource API verb, like: get, list, watch, - // create, update, delete, proxy. "*" means all. + // Verb: A Kubernetes resource API verb, like get, list, watch, create, + // update, delete, proxy. "*" means all. Verb string `json:"verb,omitempty"` - // Version: Version is the API Version of the Resource. "*" means all. + // Version: The API version of the resource. "*" means all. Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "Group") to @@ -1094,8 +1094,8 @@ type CloudDlpInspection struct { // sampled subset. FullScan bool `json:"fullScan,omitempty"` - // InfoType: The type of information - // (https://cloud.google.com/dlp/docs/infotypes-reference) found, for + // InfoType: The type of information (or *infoType + // (https://cloud.google.com/dlp/docs/infotypes-reference)*) found, for // example, `EMAIL_ADDRESS` or `STREET_ADDRESS`. InfoType string `json:"infoType,omitempty"` @@ -1133,14 +1133,14 @@ func (s *CloudDlpInspection) MarshalJSON() ([]byte, error) { // Compliance: Contains compliance information about a security standard // indicating unmet recommendations. type Compliance struct { - // Ids: Policies within the standard/benchmark e.g. A.12.4.1 + // Ids: Policies within the standard or benchmark, for example, A.12.4.1 Ids []string `json:"ids,omitempty"` - // Standard: Refers to industry wide standards or benchmarks e.g. "cis", - // "pci", "owasp", etc. + // Standard: Industry-wide compliance standards or benchmarks, such as + // CIS, PCI, and OWASP. Standard string `json:"standard,omitempty"` - // Version: Version of the standard/benchmark e.g. 1.1 + // Version: Version of the standard or benchmark, for example, 1.1 Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "Ids") to @@ -1245,7 +1245,7 @@ func (s *Contact) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// ContactDetails: The details pertaining to specific contacts +// ContactDetails: Details about specific contacts type ContactDetails struct { // Contacts: A list of contacts Contacts []*Contact `json:"contacts,omitempty"` @@ -1275,7 +1275,7 @@ func (s *ContactDetails) MarshalJSON() ([]byte, error) { // Container: Container associated with the finding. type Container struct { - // ImageId: Optional container image id, when provided by the container + // ImageId: Optional container image ID, if provided by the container // runtime. Uniquely identifies the container image launched using a // container image digest. ImageId string `json:"imageId,omitempty"` @@ -1283,11 +1283,12 @@ type Container struct { // Labels: Container labels, as provided by the container runtime. Labels []*Label `json:"labels,omitempty"` - // Name: Container name. + // Name: Name of the container. Name string `json:"name,omitempty"` - // Uri: Container image URI provided when configuring a pod/container. - // May identify a container image version using mutable tags. + // Uri: Container image URI provided when configuring a pod or + // container. This string can identify a container image version using + // mutable tags. Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "ImageId") to @@ -1513,30 +1514,36 @@ func (s *Cvssv3) UnmarshalJSON(data []byte) error { // Database: Represents database access information, such as queries. A // database may be a sub-resource of an instance (as in the case of -// CloudSQL instances or Cloud Spanner instances), or the database -// instance itself. Some database resources may not have the full -// resource name populated because these resource types are not yet -// supported by Cloud Asset Inventory (e.g. CloudSQL databases). In -// these cases only the display name will be provided. +// Cloud SQL instances or Cloud Spanner instances), or the database +// instance itself. Some database resources might not have the full +// resource name (https://google.aip.dev/122#full-resource-names) +// populated because these resource types, such as Cloud SQL databases, +// are not yet supported by Cloud Asset Inventory. In these cases only +// the display name is provided. Some database resources may not have +// the full resource name +// (https://google.aip.dev/122#full-resource-names) populated because +// these resource types are not yet supported by Cloud Asset Inventory +// (e.g. Cloud SQL databases). In these cases only the display name will +// be provided. type Database struct { - // DisplayName: The human readable name of the database the user + // DisplayName: The human-readable name of the database that the user // connected to. DisplayName string `json:"displayName,omitempty"` - // Grantees: The target usernames/roles/groups of a SQL privilege grant - // (not an IAM policy change). + // Grantees: The target usernames, roles, or groups of an SQL privilege + // grant, which is not an IAM policy change. Grantees []string `json:"grantees,omitempty"` - // Name: The full resource name of the database the user connected to, - // if it is supported by CAI. - // (https://google.aip.dev/122#full-resource-names) + // Name: The full resource name + // (https://google.aip.dev/122#full-resource-names) of the database that + // the user connected to, if it is supported by Cloud Asset Inventory. Name string `json:"name,omitempty"` - // Query: The SQL statement associated with the relevant access. + // Query: The SQL statement that is associated with the database access. Query string `json:"query,omitempty"` - // UserName: The username used to connect to the DB. This may not - // necessarily be an IAM principal, and has no required format. + // UserName: The username used to connect to the database. The username + // might not be an IAM principal and does not have a set format. UserName string `json:"userName,omitempty"` // ForceSendFields is a list of field names (e.g. "DisplayName") to @@ -1621,8 +1628,8 @@ type Empty struct { googleapi.ServerResponse `json:"-"` } -// EnvironmentVariable: EnvironmentVariable is a name-value pair to -// store environment variables for Process. +// EnvironmentVariable: A name-value pair representing an environment +// variable used in an operating system process. type EnvironmentVariable struct { // Name: Environment variable name as a JSON encoded string. Name string `json:"name,omitempty"` @@ -1653,16 +1660,18 @@ func (s *EnvironmentVariable) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// ExfilResource: Resource that has been exfiltrated or exfiltrated_to. +// ExfilResource: Resource where data was exfiltrated from or +// exfiltrated to. type ExfilResource struct { - // Components: Subcomponents of the asset that is exfiltrated - these - // could be URIs used during exfiltration, table names, databases, - // filenames, etc. For example, multiple tables may be exfiltrated from - // the same CloudSQL instance, or multiple files from the same Cloud - // Storage bucket. + // Components: Subcomponents of the asset that was exfiltrated, like + // URIs used during exfiltration, table names, databases, and filenames. + // For example, multiple tables might have been exfiltrated from the + // same Cloud SQL instance, or multiple files might have been + // exfiltrated from the same Cloud Storage bucket. Components []string `json:"components,omitempty"` - // Name: Resource's URI (https://google.aip.dev/122#full-resource-names) + // Name: The resource's full resource name + // (https://cloud.google.com/apis/design/resource_names#full_resource_name). Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "Components") to @@ -1688,10 +1697,10 @@ func (s *ExfilResource) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Exfiltration: Exfiltration represents a data exfiltration attempt of -// one or more sources to one or more targets. Sources represent the -// source of data that is exfiltrated, and Targets represents the -// destination the data was copied to. +// Exfiltration: Exfiltration represents a data exfiltration attempt +// from one or more sources to one or more targets. The `sources` +// attribute lists the sources of the exfiltrated data. The `targets` +// attribute lists the destinations the data was copied to. type Exfiltration struct { // Sources: If there are multiple sources, then the data is considered // "joined" between them. For instance, BigQuery can join multiple @@ -1788,8 +1797,7 @@ func (s *Expr) MarshalJSON() ([]byte, error) { // File: File information about the related binary/library used by an // executable, or the script used by a script interpreter type File struct { - // Contents: Prefix of the file contents as a JSON encoded string. - // (Currently only populated for Malicious Script Executed findings.) + // Contents: Prefix of the file contents as a JSON-encoded string. Contents string `json:"contents,omitempty"` // HashedSize: The length in bytes of the file prefix that was hashed. @@ -2338,10 +2346,10 @@ func (s *GoogleCloudSecuritycenterV1BigQueryExport) MarshalJSON() ([]byte, error // GoogleCloudSecuritycenterV1Binding: Represents a Kubernetes // RoleBinding or ClusterRoleBinding. type GoogleCloudSecuritycenterV1Binding struct { - // Name: Name for binding. + // Name: Name for the binding. Name string `json:"name,omitempty"` - // Ns: Namespace for binding. + // Ns: Namespace for the binding. Ns string `json:"ns,omitempty"` // Role: The Role or ClusterRole referenced by the binding. @@ -3673,7 +3681,7 @@ type IamBinding struct { Action string `json:"action,omitempty"` // Member: A single identity requesting access for a Cloud Platform - // resource, e.g. "foo@google.com". + // resource, for example, "foo@google.com". Member string `json:"member,omitempty"` // Role: Role that is assigned to "members". For example, @@ -3782,41 +3790,41 @@ func (s *Indicator) MarshalJSON() ([]byte, error) { // KernelRootkit: Kernel mode rootkit signatures. type KernelRootkit struct { - // Name: Rootkit name when available. + // Name: Rootkit name, when available. Name string `json:"name,omitempty"` - // UnexpectedCodeModification: True when unexpected modifications of + // UnexpectedCodeModification: True if unexpected modifications of // kernel code memory are present. UnexpectedCodeModification bool `json:"unexpectedCodeModification,omitempty"` - // UnexpectedFtraceHandler: True when `ftrace` points are present with + // UnexpectedFtraceHandler: True if `ftrace` points are present with // callbacks pointing to regions that are not in the expected kernel or // module code range. UnexpectedFtraceHandler bool `json:"unexpectedFtraceHandler,omitempty"` - // UnexpectedInterruptHandler: True when interrupt handlers that are are + // UnexpectedInterruptHandler: True if interrupt handlers that are are // not in the expected kernel or module code regions are present. UnexpectedInterruptHandler bool `json:"unexpectedInterruptHandler,omitempty"` - // UnexpectedKernelCodePages: True when kernel code pages that are not - // in the expected kernel or module code regions are present. + // UnexpectedKernelCodePages: True if kernel code pages that are not in + // the expected kernel or module code regions are present. UnexpectedKernelCodePages bool `json:"unexpectedKernelCodePages,omitempty"` - // UnexpectedKprobeHandler: True when `kprobe` points are present with + // UnexpectedKprobeHandler: True if `kprobe` points are present with // callbacks pointing to regions that are not in the expected kernel or // module code range. UnexpectedKprobeHandler bool `json:"unexpectedKprobeHandler,omitempty"` - // UnexpectedProcessesInRunqueue: True when unexpected processes in the + // UnexpectedProcessesInRunqueue: True if unexpected processes in the // scheduler run queue are present. Such processes are in the run queue, // but not in the process task list. UnexpectedProcessesInRunqueue bool `json:"unexpectedProcessesInRunqueue,omitempty"` - // UnexpectedReadOnlyDataModification: True when unexpected - // modifications of kernel read-only data memory are present. + // UnexpectedReadOnlyDataModification: True if unexpected modifications + // of kernel read-only data memory are present. UnexpectedReadOnlyDataModification bool `json:"unexpectedReadOnlyDataModification,omitempty"` - // UnexpectedSystemCallHandler: True when system call handlers that are + // UnexpectedSystemCallHandler: True if system call handlers that are // are not in the expected kernel or module code regions are present. UnexpectedSystemCallHandler bool `json:"unexpectedSystemCallHandler,omitempty"` @@ -3846,27 +3854,34 @@ func (s *KernelRootkit) MarshalJSON() ([]byte, error) { // Kubernetes: Kubernetes-related attributes. type Kubernetes struct { // AccessReviews: Provides information on any Kubernetes access reviews - // (i.e. privilege checks) relevant to the finding. + // (privilege checks) relevant to the finding. AccessReviews []*AccessReview `json:"accessReviews,omitempty"` // Bindings: Provides Kubernetes role binding information for findings - // that involve RoleBindings or ClusterRoleBindings. + // that involve RoleBindings or ClusterRoleBindings + // (https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control). Bindings []*GoogleCloudSecuritycenterV1Binding `json:"bindings,omitempty"` - // NodePools: GKE Node Pools associated with the finding. This field - // will contain NodePool information for each Node, when it is - // available. + // NodePools: GKE node pools + // (https://cloud.google.com/kubernetes-engine/docs/concepts/node-pools) + // associated with the finding. This field contains node pool + // information for each node, when it is available. NodePools []*NodePool `json:"nodePools,omitempty"` - // Nodes: Provides Kubernetes Node information. + // Nodes: Provides Kubernetes node + // (https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-architecture#nodes) + // information. Nodes []*Node `json:"nodes,omitempty"` - // Pods: Kubernetes Pods associated with the finding. This field will - // contain Pod records for each container that is owned by a Pod. + // Pods: Kubernetes Pods + // (https://cloud.google.com/kubernetes-engine/docs/concepts/pod) + // associated with the finding. This field contains Pod records for each + // container that is owned by a Pod. Pods []*Pod `json:"pods,omitempty"` // Roles: Provides Kubernetes role information for findings that involve - // Roles or ClusterRoles. + // Roles or ClusterRoles + // (https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control). Roles []*Role `json:"roles,omitempty"` // ForceSendFields is a list of field names (e.g. "AccessReviews") to @@ -3892,13 +3907,15 @@ func (s *Kubernetes) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Label: Label represents a generic name=value label. Label has -// separate name and value fields to support filtering with contains(). +// Label: Represents a generic name-value label. A label has separate +// name and value fields to support filtering with the `contains()` +// function. For more information, see Filtering on array-type fields +// (https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering). type Label struct { - // Name: Label name. + // Name: Name of the label. Name string `json:"name,omitempty"` - // Value: Label value. + // Value: Value that corresponds to the label's name. Value string `json:"value,omitempty"` // ForceSendFields is a list of field names (e.g. "Name") to @@ -4594,10 +4611,11 @@ func (s *MitreAttack) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Node: Kubernetes Nodes associated with the finding. +// Node: Kubernetes nodes associated with the finding. type Node struct { - // Name: Full Resource name of the Compute Engine VM running the cluster - // node. + // Name: Full resource name + // (https://google.aip.dev/122#full-resource-names) of the Compute + // Engine VM running the cluster node. Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "Name") to @@ -4623,9 +4641,9 @@ func (s *Node) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// NodePool: Provides GKE Node Pool information. +// NodePool: Provides GKE node pool information. type NodePool struct { - // Name: Kubernetes Node pool name. + // Name: Kubernetes node pool name. Name string `json:"name,omitempty"` // Nodes: Nodes associated with the finding. @@ -4819,7 +4837,7 @@ func (s *OrganizationSettings) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Pod: Kubernetes Pod. +// Pod: A Kubernetes Pod. type Pod struct { // Containers: Pod containers associated with this finding, if any. Containers []*Container `json:"containers,omitempty"` @@ -4987,19 +5005,19 @@ type Process struct { // Libraries: File information for libraries loaded by the process. Libraries []*File `json:"libraries,omitempty"` - // Name: The process name visible in utilities like `top` and `ps`; it - // can be accessed via `/proc/[pid]/comm` and changed with - // `prctl(PR_SET_NAME)`. + // Name: The process name, as displayed in utilities like `top` and + // `ps`. This name can be accessed through `/proc/[pid]/comm` and + // changed with `prctl(PR_SET_NAME)`. Name string `json:"name,omitempty"` - // ParentPid: The parent process id. + // ParentPid: The parent process ID. ParentPid int64 `json:"parentPid,omitempty,string"` - // Pid: The process id. + // Pid: The process ID. Pid int64 `json:"pid,omitempty,string"` // Script: When the process represents the invocation of a script, - // `binary` provides information about the interpreter while `script` + // `binary` provides information about the interpreter, while `script` // provides information about the script file provided to the // interpreter. Script *File `json:"script,omitempty"` @@ -5612,22 +5630,22 @@ func (s *StreamingConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Subject: Represents a Kubernetes Subject. +// Subject: Represents a Kubernetes subject. type Subject struct { - // Kind: Authentication type for subject. + // Kind: Authentication type for the subject. // // Possible values: // "AUTH_TYPE_UNSPECIFIED" - Authentication is not specified. // "USER" - User with valid certificate. // "SERVICEACCOUNT" - Users managed by Kubernetes API with credentials - // stored as Secrets. + // stored as secrets. // "GROUP" - Collection of users. Kind string `json:"kind,omitempty"` - // Name: Name for subject. + // Name: Name for the subject. Name string `json:"name,omitempty"` - // Ns: Namespace for subject. + // Ns: Namespace for the subject. Ns string `json:"ns,omitempty"` // ForceSendFields is a list of field names (e.g. "Kind") to diff --git a/securitycenter/v1beta1/securitycenter-api.json b/securitycenter/v1beta1/securitycenter-api.json index a9c73323af0..8f7f6e6dba8 100644 --- a/securitycenter/v1beta1/securitycenter-api.json +++ b/securitycenter/v1beta1/securitycenter-api.json @@ -896,7 +896,7 @@ } } }, - "revision": "20230414", + "revision": "20230420", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -950,15 +950,15 @@ "type": "object" }, "AccessReview": { - "description": "Conveys information about a Kubernetes access review (e.g. kubectl auth can-i ...) that was involved in a finding.", + "description": "Conveys information about a Kubernetes access review (such as one returned by a [`kubectl auth can-i`](https://kubernetes.io/docs/reference/access-authn-authz/authorization/#checking-api-access) command) that was involved in a finding.", "id": "AccessReview", "properties": { "group": { - "description": "Group is the API Group of the Resource. \"*\" means all.", + "description": "The API group of the resource. \"*\" means all.", "type": "string" }, "name": { - "description": "Name is the name of the resource being requested. Empty means all.", + "description": "The name of the resource being requested. Empty means all.", "type": "string" }, "ns": { @@ -966,19 +966,19 @@ "type": "string" }, "resource": { - "description": "Resource is the optional resource type requested. \"*\" means all.", + "description": "The optional resource type requested. \"*\" means all.", "type": "string" }, "subresource": { - "description": "Subresource is the optional subresource type.", + "description": "The optional subresource type.", "type": "string" }, "verb": { - "description": "Verb is a Kubernetes resource API verb, like: get, list, watch, create, update, delete, proxy. \"*\" means all.", + "description": "A Kubernetes resource API verb, like get, list, watch, create, update, delete, proxy. \"*\" means all.", "type": "string" }, "version": { - "description": "Version is the API Version of the Resource. \"*\" means all.", + "description": "The API version of the resource. \"*\" means all.", "type": "string" } }, @@ -1144,7 +1144,7 @@ "type": "boolean" }, "infoType": { - "description": "The [type of information](https://cloud.google.com/dlp/docs/infotypes-reference) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.", + "description": "The type of information (or *[infoType](https://cloud.google.com/dlp/docs/infotypes-reference)*) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.", "type": "string" }, "infoTypeCount": { @@ -1164,18 +1164,18 @@ "id": "Compliance", "properties": { "ids": { - "description": "Policies within the standard/benchmark e.g. A.12.4.1", + "description": "Policies within the standard or benchmark, for example, A.12.4.1", "items": { "type": "string" }, "type": "array" }, "standard": { - "description": "Refers to industry wide standards or benchmarks e.g. \"cis\", \"pci\", \"owasp\", etc.", + "description": "Industry-wide compliance standards or benchmarks, such as CIS, PCI, and OWASP.", "type": "string" }, "version": { - "description": "Version of the standard/benchmark e.g. 1.1", + "description": "Version of the standard or benchmark, for example, 1.1", "type": "string" } }, @@ -1238,7 +1238,7 @@ "type": "object" }, "ContactDetails": { - "description": "The details pertaining to specific contacts", + "description": "Details about specific contacts", "id": "ContactDetails", "properties": { "contacts": { @@ -1256,7 +1256,7 @@ "id": "Container", "properties": { "imageId": { - "description": "Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.", + "description": "Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.", "type": "string" }, "labels": { @@ -1267,11 +1267,11 @@ "type": "array" }, "name": { - "description": "Container name.", + "description": "Name of the container.", "type": "string" }, "uri": { - "description": "Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.", + "description": "Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.", "type": "string" } }, @@ -1440,30 +1440,30 @@ "type": "object" }, "Database": { - "description": "Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of CloudSQL instances or Cloud Spanner instances), or the database instance itself. Some database resources may not have the full resource name populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. CloudSQL databases). In these cases only the display name will be provided.", + "description": "Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of Cloud SQL instances or Cloud Spanner instances), or the database instance itself. Some database resources might not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types, such as Cloud SQL databases, are not yet supported by Cloud Asset Inventory. In these cases only the display name is provided. Some database resources may not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. Cloud SQL databases). In these cases only the display name will be provided.", "id": "Database", "properties": { "displayName": { - "description": "The human readable name of the database the user connected to.", + "description": "The human-readable name of the database that the user connected to.", "type": "string" }, "grantees": { - "description": "The target usernames/roles/groups of a SQL privilege grant (not an IAM policy change).", + "description": "The target usernames, roles, or groups of an SQL privilege grant, which is not an IAM policy change.", "items": { "type": "string" }, "type": "array" }, "name": { - "description": "The full resource name of the database the user connected to, if it is supported by CAI. (https://google.aip.dev/122#full-resource-names)", + "description": "The [full resource name](https://google.aip.dev/122#full-resource-names) of the database that the user connected to, if it is supported by Cloud Asset Inventory.", "type": "string" }, "query": { - "description": "The SQL statement associated with the relevant access.", + "description": "The SQL statement that is associated with the database access.", "type": "string" }, "userName": { - "description": "The username used to connect to the DB. This may not necessarily be an IAM principal, and has no required format.", + "description": "The username used to connect to the database. The username might not be an IAM principal and does not have a set format.", "type": "string" } }, @@ -1492,7 +1492,7 @@ "type": "object" }, "EnvironmentVariable": { - "description": "EnvironmentVariable is a name-value pair to store environment variables for Process.", + "description": "A name-value pair representing an environment variable used in an operating system process.", "id": "EnvironmentVariable", "properties": { "name": { @@ -1507,25 +1507,25 @@ "type": "object" }, "ExfilResource": { - "description": "Resource that has been exfiltrated or exfiltrated_to.", + "description": "Resource where data was exfiltrated from or exfiltrated to.", "id": "ExfilResource", "properties": { "components": { - "description": "Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.", + "description": "Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.", "items": { "type": "string" }, "type": "array" }, "name": { - "description": "Resource's URI (https://google.aip.dev/122#full-resource-names)", + "description": "The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).", "type": "string" } }, "type": "object" }, "Exfiltration": { - "description": "Exfiltration represents a data exfiltration attempt of one or more sources to one or more targets. Sources represent the source of data that is exfiltrated, and Targets represents the destination the data was copied to.", + "description": "Exfiltration represents a data exfiltration attempt from one or more sources to one or more targets. The `sources` attribute lists the sources of the exfiltrated data. The `targets` attribute lists the destinations the data was copied to.", "id": "Exfiltration", "properties": { "sources": { @@ -1573,7 +1573,7 @@ "id": "File", "properties": { "contents": { - "description": "Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)", + "description": "Prefix of the file contents as a JSON-encoded string.", "type": "string" }, "hashedSize": { @@ -1946,11 +1946,11 @@ "id": "GoogleCloudSecuritycenterV1Binding", "properties": { "name": { - "description": "Name for binding.", + "description": "Name for the binding.", "type": "string" }, "ns": { - "description": "Namespace for binding.", + "description": "Namespace for the binding.", "type": "string" }, "role": { @@ -2770,7 +2770,7 @@ "type": "string" }, "member": { - "description": "A single identity requesting access for a Cloud Platform resource, e.g. \"foo@google.com\".", + "description": "A single identity requesting access for a Cloud Platform resource, for example, \"foo@google.com\".", "type": "string" }, "role": { @@ -2820,39 +2820,39 @@ "id": "KernelRootkit", "properties": { "name": { - "description": "Rootkit name when available.", + "description": "Rootkit name, when available.", "type": "string" }, "unexpectedCodeModification": { - "description": "True when unexpected modifications of kernel code memory are present.", + "description": "True if unexpected modifications of kernel code memory are present.", "type": "boolean" }, "unexpectedFtraceHandler": { - "description": "True when `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.", + "description": "True if `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.", "type": "boolean" }, "unexpectedInterruptHandler": { - "description": "True when interrupt handlers that are are not in the expected kernel or module code regions are present.", + "description": "True if interrupt handlers that are are not in the expected kernel or module code regions are present.", "type": "boolean" }, "unexpectedKernelCodePages": { - "description": "True when kernel code pages that are not in the expected kernel or module code regions are present.", + "description": "True if kernel code pages that are not in the expected kernel or module code regions are present.", "type": "boolean" }, "unexpectedKprobeHandler": { - "description": "True when `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.", + "description": "True if `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.", "type": "boolean" }, "unexpectedProcessesInRunqueue": { - "description": "True when unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.", + "description": "True if unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.", "type": "boolean" }, "unexpectedReadOnlyDataModification": { - "description": "True when unexpected modifications of kernel read-only data memory are present.", + "description": "True if unexpected modifications of kernel read-only data memory are present.", "type": "boolean" }, "unexpectedSystemCallHandler": { - "description": "True when system call handlers that are are not in the expected kernel or module code regions are present.", + "description": "True if system call handlers that are are not in the expected kernel or module code regions are present.", "type": "boolean" } }, @@ -2863,42 +2863,42 @@ "id": "Kubernetes", "properties": { "accessReviews": { - "description": "Provides information on any Kubernetes access reviews (i.e. privilege checks) relevant to the finding.", + "description": "Provides information on any Kubernetes access reviews (privilege checks) relevant to the finding.", "items": { "$ref": "AccessReview" }, "type": "array" }, "bindings": { - "description": "Provides Kubernetes role binding information for findings that involve RoleBindings or ClusterRoleBindings.", + "description": "Provides Kubernetes role binding information for findings that involve [RoleBindings or ClusterRoleBindings](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).", "items": { "$ref": "GoogleCloudSecuritycenterV1Binding" }, "type": "array" }, "nodePools": { - "description": "GKE Node Pools associated with the finding. This field will contain NodePool information for each Node, when it is available.", + "description": "GKE [node pools](https://cloud.google.com/kubernetes-engine/docs/concepts/node-pools) associated with the finding. This field contains node pool information for each node, when it is available.", "items": { "$ref": "NodePool" }, "type": "array" }, "nodes": { - "description": "Provides Kubernetes Node information.", + "description": "Provides Kubernetes [node](https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-architecture#nodes) information.", "items": { "$ref": "Node" }, "type": "array" }, "pods": { - "description": "Kubernetes Pods associated with the finding. This field will contain Pod records for each container that is owned by a Pod.", + "description": "Kubernetes [Pods](https://cloud.google.com/kubernetes-engine/docs/concepts/pod) associated with the finding. This field contains Pod records for each container that is owned by a Pod.", "items": { "$ref": "Pod" }, "type": "array" }, "roles": { - "description": "Provides Kubernetes role information for findings that involve Roles or ClusterRoles.", + "description": "Provides Kubernetes role information for findings that involve [Roles or ClusterRoles](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).", "items": { "$ref": "Role" }, @@ -2908,15 +2908,15 @@ "type": "object" }, "Label": { - "description": "Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().", + "description": "Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).", "id": "Label", "properties": { "name": { - "description": "Label name.", + "description": "Name of the label.", "type": "string" }, "value": { - "description": "Label value.", + "description": "Value that corresponds to the label's name.", "type": "string" } }, @@ -3318,22 +3318,22 @@ "type": "object" }, "Node": { - "description": "Kubernetes Nodes associated with the finding.", + "description": "Kubernetes nodes associated with the finding.", "id": "Node", "properties": { "name": { - "description": "Full Resource name of the Compute Engine VM running the cluster node.", + "description": "[Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.", "type": "string" } }, "type": "object" }, "NodePool": { - "description": "Provides GKE Node Pool information.", + "description": "Provides GKE node pool information.", "id": "NodePool", "properties": { "name": { - "description": "Kubernetes Node pool name.", + "description": "Kubernetes node pool name.", "type": "string" }, "nodes": { @@ -3401,7 +3401,7 @@ "type": "object" }, "Pod": { - "description": "Kubernetes Pod.", + "description": "A Kubernetes Pod.", "id": "Pod", "properties": { "containers": { @@ -3498,22 +3498,22 @@ "type": "array" }, "name": { - "description": "The process name visible in utilities like `top` and `ps`; it can be accessed via `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.", + "description": "The process name, as displayed in utilities like `top` and `ps`. This name can be accessed through `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.", "type": "string" }, "parentPid": { - "description": "The parent process id.", + "description": "The parent process ID.", "format": "int64", "type": "string" }, "pid": { - "description": "The process id.", + "description": "The process ID.", "format": "int64", "type": "string" }, "script": { "$ref": "File", - "description": "When the process represents the invocation of a script, `binary` provides information about the interpreter while `script` provides information about the script file provided to the interpreter." + "description": "When the process represents the invocation of a script, `binary` provides information about the interpreter, while `script` provides information about the script file provided to the interpreter." } }, "type": "object" @@ -3739,11 +3739,11 @@ "type": "object" }, "Subject": { - "description": "Represents a Kubernetes Subject.", + "description": "Represents a Kubernetes subject.", "id": "Subject", "properties": { "kind": { - "description": "Authentication type for subject.", + "description": "Authentication type for the subject.", "enum": [ "AUTH_TYPE_UNSPECIFIED", "USER", @@ -3753,17 +3753,17 @@ "enumDescriptions": [ "Authentication is not specified.", "User with valid certificate.", - "Users managed by Kubernetes API with credentials stored as Secrets.", + "Users managed by Kubernetes API with credentials stored as secrets.", "Collection of users." ], "type": "string" }, "name": { - "description": "Name for subject.", + "description": "Name for the subject.", "type": "string" }, "ns": { - "description": "Namespace for subject.", + "description": "Namespace for the subject.", "type": "string" } }, diff --git a/securitycenter/v1beta1/securitycenter-gen.go b/securitycenter/v1beta1/securitycenter-gen.go index b25484b7817..e952fe74ac2 100644 --- a/securitycenter/v1beta1/securitycenter-gen.go +++ b/securitycenter/v1beta1/securitycenter-gen.go @@ -284,13 +284,14 @@ func (s *Access) MarshalJSON() ([]byte, error) { } // AccessReview: Conveys information about a Kubernetes access review -// (e.g. kubectl auth can-i ...) that was involved in a finding. +// (such as one returned by a `kubectl auth can-i` +// (https://kubernetes.io/docs/reference/access-authn-authz/authorization/#checking-api-access) +// command) that was involved in a finding. type AccessReview struct { - // Group: Group is the API Group of the Resource. "*" means all. + // Group: The API group of the resource. "*" means all. Group string `json:"group,omitempty"` - // Name: Name is the name of the resource being requested. Empty means - // all. + // Name: The name of the resource being requested. Empty means all. Name string `json:"name,omitempty"` // Ns: Namespace of the action being requested. Currently, there is no @@ -298,18 +299,17 @@ type AccessReview struct { // represented by "" (empty). Ns string `json:"ns,omitempty"` - // Resource: Resource is the optional resource type requested. "*" means - // all. + // Resource: The optional resource type requested. "*" means all. Resource string `json:"resource,omitempty"` - // Subresource: Subresource is the optional subresource type. + // Subresource: The optional subresource type. Subresource string `json:"subresource,omitempty"` - // Verb: Verb is a Kubernetes resource API verb, like: get, list, watch, - // create, update, delete, proxy. "*" means all. + // Verb: A Kubernetes resource API verb, like get, list, watch, create, + // update, delete, proxy. "*" means all. Verb string `json:"verb,omitempty"` - // Version: Version is the API Version of the Resource. "*" means all. + // Version: The API version of the resource. "*" means all. Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "Group") to @@ -653,8 +653,8 @@ type CloudDlpInspection struct { // sampled subset. FullScan bool `json:"fullScan,omitempty"` - // InfoType: The type of information - // (https://cloud.google.com/dlp/docs/infotypes-reference) found, for + // InfoType: The type of information (or *infoType + // (https://cloud.google.com/dlp/docs/infotypes-reference)*) found, for // example, `EMAIL_ADDRESS` or `STREET_ADDRESS`. InfoType string `json:"infoType,omitempty"` @@ -692,14 +692,14 @@ func (s *CloudDlpInspection) MarshalJSON() ([]byte, error) { // Compliance: Contains compliance information about a security standard // indicating unmet recommendations. type Compliance struct { - // Ids: Policies within the standard/benchmark e.g. A.12.4.1 + // Ids: Policies within the standard or benchmark, for example, A.12.4.1 Ids []string `json:"ids,omitempty"` - // Standard: Refers to industry wide standards or benchmarks e.g. "cis", - // "pci", "owasp", etc. + // Standard: Industry-wide compliance standards or benchmarks, such as + // CIS, PCI, and OWASP. Standard string `json:"standard,omitempty"` - // Version: Version of the standard/benchmark e.g. 1.1 + // Version: Version of the standard or benchmark, for example, 1.1 Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "Ids") to @@ -804,7 +804,7 @@ func (s *Contact) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// ContactDetails: The details pertaining to specific contacts +// ContactDetails: Details about specific contacts type ContactDetails struct { // Contacts: A list of contacts Contacts []*Contact `json:"contacts,omitempty"` @@ -834,7 +834,7 @@ func (s *ContactDetails) MarshalJSON() ([]byte, error) { // Container: Container associated with the finding. type Container struct { - // ImageId: Optional container image id, when provided by the container + // ImageId: Optional container image ID, if provided by the container // runtime. Uniquely identifies the container image launched using a // container image digest. ImageId string `json:"imageId,omitempty"` @@ -842,11 +842,12 @@ type Container struct { // Labels: Container labels, as provided by the container runtime. Labels []*Label `json:"labels,omitempty"` - // Name: Container name. + // Name: Name of the container. Name string `json:"name,omitempty"` - // Uri: Container image URI provided when configuring a pod/container. - // May identify a container image version using mutable tags. + // Uri: Container image URI provided when configuring a pod or + // container. This string can identify a container image version using + // mutable tags. Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "ImageId") to @@ -1072,30 +1073,36 @@ func (s *Cvssv3) UnmarshalJSON(data []byte) error { // Database: Represents database access information, such as queries. A // database may be a sub-resource of an instance (as in the case of -// CloudSQL instances or Cloud Spanner instances), or the database -// instance itself. Some database resources may not have the full -// resource name populated because these resource types are not yet -// supported by Cloud Asset Inventory (e.g. CloudSQL databases). In -// these cases only the display name will be provided. +// Cloud SQL instances or Cloud Spanner instances), or the database +// instance itself. Some database resources might not have the full +// resource name (https://google.aip.dev/122#full-resource-names) +// populated because these resource types, such as Cloud SQL databases, +// are not yet supported by Cloud Asset Inventory. In these cases only +// the display name is provided. Some database resources may not have +// the full resource name +// (https://google.aip.dev/122#full-resource-names) populated because +// these resource types are not yet supported by Cloud Asset Inventory +// (e.g. Cloud SQL databases). In these cases only the display name will +// be provided. type Database struct { - // DisplayName: The human readable name of the database the user + // DisplayName: The human-readable name of the database that the user // connected to. DisplayName string `json:"displayName,omitempty"` - // Grantees: The target usernames/roles/groups of a SQL privilege grant - // (not an IAM policy change). + // Grantees: The target usernames, roles, or groups of an SQL privilege + // grant, which is not an IAM policy change. Grantees []string `json:"grantees,omitempty"` - // Name: The full resource name of the database the user connected to, - // if it is supported by CAI. - // (https://google.aip.dev/122#full-resource-names) + // Name: The full resource name + // (https://google.aip.dev/122#full-resource-names) of the database that + // the user connected to, if it is supported by Cloud Asset Inventory. Name string `json:"name,omitempty"` - // Query: The SQL statement associated with the relevant access. + // Query: The SQL statement that is associated with the database access. Query string `json:"query,omitempty"` - // UserName: The username used to connect to the DB. This may not - // necessarily be an IAM principal, and has no required format. + // UserName: The username used to connect to the database. The username + // might not be an IAM principal and does not have a set format. UserName string `json:"userName,omitempty"` // ForceSendFields is a list of field names (e.g. "DisplayName") to @@ -1180,8 +1187,8 @@ type Empty struct { googleapi.ServerResponse `json:"-"` } -// EnvironmentVariable: EnvironmentVariable is a name-value pair to -// store environment variables for Process. +// EnvironmentVariable: A name-value pair representing an environment +// variable used in an operating system process. type EnvironmentVariable struct { // Name: Environment variable name as a JSON encoded string. Name string `json:"name,omitempty"` @@ -1212,16 +1219,18 @@ func (s *EnvironmentVariable) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// ExfilResource: Resource that has been exfiltrated or exfiltrated_to. +// ExfilResource: Resource where data was exfiltrated from or +// exfiltrated to. type ExfilResource struct { - // Components: Subcomponents of the asset that is exfiltrated - these - // could be URIs used during exfiltration, table names, databases, - // filenames, etc. For example, multiple tables may be exfiltrated from - // the same CloudSQL instance, or multiple files from the same Cloud - // Storage bucket. + // Components: Subcomponents of the asset that was exfiltrated, like + // URIs used during exfiltration, table names, databases, and filenames. + // For example, multiple tables might have been exfiltrated from the + // same Cloud SQL instance, or multiple files might have been + // exfiltrated from the same Cloud Storage bucket. Components []string `json:"components,omitempty"` - // Name: Resource's URI (https://google.aip.dev/122#full-resource-names) + // Name: The resource's full resource name + // (https://cloud.google.com/apis/design/resource_names#full_resource_name). Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "Components") to @@ -1247,10 +1256,10 @@ func (s *ExfilResource) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Exfiltration: Exfiltration represents a data exfiltration attempt of -// one or more sources to one or more targets. Sources represent the -// source of data that is exfiltrated, and Targets represents the -// destination the data was copied to. +// Exfiltration: Exfiltration represents a data exfiltration attempt +// from one or more sources to one or more targets. The `sources` +// attribute lists the sources of the exfiltrated data. The `targets` +// attribute lists the destinations the data was copied to. type Exfiltration struct { // Sources: If there are multiple sources, then the data is considered // "joined" between them. For instance, BigQuery can join multiple @@ -1347,8 +1356,7 @@ func (s *Expr) MarshalJSON() ([]byte, error) { // File: File information about the related binary/library used by an // executable, or the script used by a script interpreter type File struct { - // Contents: Prefix of the file contents as a JSON encoded string. - // (Currently only populated for Malicious Script Executed findings.) + // Contents: Prefix of the file contents as a JSON-encoded string. Contents string `json:"contents,omitempty"` // HashedSize: The length in bytes of the file prefix that was hashed. @@ -1889,10 +1897,10 @@ func (s *GoogleCloudSecuritycenterV1BigQueryExport) MarshalJSON() ([]byte, error // GoogleCloudSecuritycenterV1Binding: Represents a Kubernetes // RoleBinding or ClusterRoleBinding. type GoogleCloudSecuritycenterV1Binding struct { - // Name: Name for binding. + // Name: Name for the binding. Name string `json:"name,omitempty"` - // Ns: Namespace for binding. + // Ns: Namespace for the binding. Ns string `json:"ns,omitempty"` // Role: The Role or ClusterRole referenced by the binding. @@ -3281,7 +3289,7 @@ type IamBinding struct { Action string `json:"action,omitempty"` // Member: A single identity requesting access for a Cloud Platform - // resource, e.g. "foo@google.com". + // resource, for example, "foo@google.com". Member string `json:"member,omitempty"` // Role: Role that is assigned to "members". For example, @@ -3357,41 +3365,41 @@ func (s *Indicator) MarshalJSON() ([]byte, error) { // KernelRootkit: Kernel mode rootkit signatures. type KernelRootkit struct { - // Name: Rootkit name when available. + // Name: Rootkit name, when available. Name string `json:"name,omitempty"` - // UnexpectedCodeModification: True when unexpected modifications of + // UnexpectedCodeModification: True if unexpected modifications of // kernel code memory are present. UnexpectedCodeModification bool `json:"unexpectedCodeModification,omitempty"` - // UnexpectedFtraceHandler: True when `ftrace` points are present with + // UnexpectedFtraceHandler: True if `ftrace` points are present with // callbacks pointing to regions that are not in the expected kernel or // module code range. UnexpectedFtraceHandler bool `json:"unexpectedFtraceHandler,omitempty"` - // UnexpectedInterruptHandler: True when interrupt handlers that are are + // UnexpectedInterruptHandler: True if interrupt handlers that are are // not in the expected kernel or module code regions are present. UnexpectedInterruptHandler bool `json:"unexpectedInterruptHandler,omitempty"` - // UnexpectedKernelCodePages: True when kernel code pages that are not - // in the expected kernel or module code regions are present. + // UnexpectedKernelCodePages: True if kernel code pages that are not in + // the expected kernel or module code regions are present. UnexpectedKernelCodePages bool `json:"unexpectedKernelCodePages,omitempty"` - // UnexpectedKprobeHandler: True when `kprobe` points are present with + // UnexpectedKprobeHandler: True if `kprobe` points are present with // callbacks pointing to regions that are not in the expected kernel or // module code range. UnexpectedKprobeHandler bool `json:"unexpectedKprobeHandler,omitempty"` - // UnexpectedProcessesInRunqueue: True when unexpected processes in the + // UnexpectedProcessesInRunqueue: True if unexpected processes in the // scheduler run queue are present. Such processes are in the run queue, // but not in the process task list. UnexpectedProcessesInRunqueue bool `json:"unexpectedProcessesInRunqueue,omitempty"` - // UnexpectedReadOnlyDataModification: True when unexpected - // modifications of kernel read-only data memory are present. + // UnexpectedReadOnlyDataModification: True if unexpected modifications + // of kernel read-only data memory are present. UnexpectedReadOnlyDataModification bool `json:"unexpectedReadOnlyDataModification,omitempty"` - // UnexpectedSystemCallHandler: True when system call handlers that are + // UnexpectedSystemCallHandler: True if system call handlers that are // are not in the expected kernel or module code regions are present. UnexpectedSystemCallHandler bool `json:"unexpectedSystemCallHandler,omitempty"` @@ -3421,27 +3429,34 @@ func (s *KernelRootkit) MarshalJSON() ([]byte, error) { // Kubernetes: Kubernetes-related attributes. type Kubernetes struct { // AccessReviews: Provides information on any Kubernetes access reviews - // (i.e. privilege checks) relevant to the finding. + // (privilege checks) relevant to the finding. AccessReviews []*AccessReview `json:"accessReviews,omitempty"` // Bindings: Provides Kubernetes role binding information for findings - // that involve RoleBindings or ClusterRoleBindings. + // that involve RoleBindings or ClusterRoleBindings + // (https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control). Bindings []*GoogleCloudSecuritycenterV1Binding `json:"bindings,omitempty"` - // NodePools: GKE Node Pools associated with the finding. This field - // will contain NodePool information for each Node, when it is - // available. + // NodePools: GKE node pools + // (https://cloud.google.com/kubernetes-engine/docs/concepts/node-pools) + // associated with the finding. This field contains node pool + // information for each node, when it is available. NodePools []*NodePool `json:"nodePools,omitempty"` - // Nodes: Provides Kubernetes Node information. + // Nodes: Provides Kubernetes node + // (https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-architecture#nodes) + // information. Nodes []*Node `json:"nodes,omitempty"` - // Pods: Kubernetes Pods associated with the finding. This field will - // contain Pod records for each container that is owned by a Pod. + // Pods: Kubernetes Pods + // (https://cloud.google.com/kubernetes-engine/docs/concepts/pod) + // associated with the finding. This field contains Pod records for each + // container that is owned by a Pod. Pods []*Pod `json:"pods,omitempty"` // Roles: Provides Kubernetes role information for findings that involve - // Roles or ClusterRoles. + // Roles or ClusterRoles + // (https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control). Roles []*Role `json:"roles,omitempty"` // ForceSendFields is a list of field names (e.g. "AccessReviews") to @@ -3467,13 +3482,15 @@ func (s *Kubernetes) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Label: Label represents a generic name=value label. Label has -// separate name and value fields to support filtering with contains(). +// Label: Represents a generic name-value label. A label has separate +// name and value fields to support filtering with the `contains()` +// function. For more information, see Filtering on array-type fields +// (https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering). type Label struct { - // Name: Label name. + // Name: Name of the label. Name string `json:"name,omitempty"` - // Value: Label value. + // Value: Value that corresponds to the label's name. Value string `json:"value,omitempty"` // ForceSendFields is a list of field names (e.g. "Name") to @@ -3890,10 +3907,11 @@ func (s *MitreAttack) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Node: Kubernetes Nodes associated with the finding. +// Node: Kubernetes nodes associated with the finding. type Node struct { - // Name: Full Resource name of the Compute Engine VM running the cluster - // node. + // Name: Full resource name + // (https://google.aip.dev/122#full-resource-names) of the Compute + // Engine VM running the cluster node. Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "Name") to @@ -3919,9 +3937,9 @@ func (s *Node) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// NodePool: Provides GKE Node Pool information. +// NodePool: Provides GKE node pool information. type NodePool struct { - // Name: Kubernetes Node pool name. + // Name: Kubernetes node pool name. Name string `json:"name,omitempty"` // Nodes: Nodes associated with the finding. @@ -4059,7 +4077,7 @@ func (s *OrganizationSettings) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Pod: Kubernetes Pod. +// Pod: A Kubernetes Pod. type Pod struct { // Containers: Pod containers associated with this finding, if any. Containers []*Container `json:"containers,omitempty"` @@ -4227,19 +4245,19 @@ type Process struct { // Libraries: File information for libraries loaded by the process. Libraries []*File `json:"libraries,omitempty"` - // Name: The process name visible in utilities like `top` and `ps`; it - // can be accessed via `/proc/[pid]/comm` and changed with - // `prctl(PR_SET_NAME)`. + // Name: The process name, as displayed in utilities like `top` and + // `ps`. This name can be accessed through `/proc/[pid]/comm` and + // changed with `prctl(PR_SET_NAME)`. Name string `json:"name,omitempty"` - // ParentPid: The parent process id. + // ParentPid: The parent process ID. ParentPid int64 `json:"parentPid,omitempty,string"` - // Pid: The process id. + // Pid: The process ID. Pid int64 `json:"pid,omitempty,string"` // Script: When the process represents the invocation of a script, - // `binary` provides information about the interpreter while `script` + // `binary` provides information about the interpreter, while `script` // provides information about the script file provided to the // interpreter. Script *File `json:"script,omitempty"` @@ -4697,22 +4715,22 @@ func (s *Status) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Subject: Represents a Kubernetes Subject. +// Subject: Represents a Kubernetes subject. type Subject struct { - // Kind: Authentication type for subject. + // Kind: Authentication type for the subject. // // Possible values: // "AUTH_TYPE_UNSPECIFIED" - Authentication is not specified. // "USER" - User with valid certificate. // "SERVICEACCOUNT" - Users managed by Kubernetes API with credentials - // stored as Secrets. + // stored as secrets. // "GROUP" - Collection of users. Kind string `json:"kind,omitempty"` - // Name: Name for subject. + // Name: Name for the subject. Name string `json:"name,omitempty"` - // Ns: Namespace for subject. + // Ns: Namespace for the subject. Ns string `json:"ns,omitempty"` // ForceSendFields is a list of field names (e.g. "Kind") to diff --git a/securitycenter/v1beta2/securitycenter-api.json b/securitycenter/v1beta2/securitycenter-api.json index 61372b26d60..e78c8329dac 100644 --- a/securitycenter/v1beta2/securitycenter-api.json +++ b/securitycenter/v1beta2/securitycenter-api.json @@ -1981,7 +1981,7 @@ } } }, - "revision": "20230414", + "revision": "20230420", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -2035,15 +2035,15 @@ "type": "object" }, "AccessReview": { - "description": "Conveys information about a Kubernetes access review (e.g. kubectl auth can-i ...) that was involved in a finding.", + "description": "Conveys information about a Kubernetes access review (such as one returned by a [`kubectl auth can-i`](https://kubernetes.io/docs/reference/access-authn-authz/authorization/#checking-api-access) command) that was involved in a finding.", "id": "AccessReview", "properties": { "group": { - "description": "Group is the API Group of the Resource. \"*\" means all.", + "description": "The API group of the resource. \"*\" means all.", "type": "string" }, "name": { - "description": "Name is the name of the resource being requested. Empty means all.", + "description": "The name of the resource being requested. Empty means all.", "type": "string" }, "ns": { @@ -2051,19 +2051,19 @@ "type": "string" }, "resource": { - "description": "Resource is the optional resource type requested. \"*\" means all.", + "description": "The optional resource type requested. \"*\" means all.", "type": "string" }, "subresource": { - "description": "Subresource is the optional subresource type.", + "description": "The optional subresource type.", "type": "string" }, "verb": { - "description": "Verb is a Kubernetes resource API verb, like: get, list, watch, create, update, delete, proxy. \"*\" means all.", + "description": "A Kubernetes resource API verb, like get, list, watch, create, update, delete, proxy. \"*\" means all.", "type": "string" }, "version": { - "description": "Version is the API Version of the Resource. \"*\" means all.", + "description": "The API version of the resource. \"*\" means all.", "type": "string" } }, @@ -2089,7 +2089,7 @@ "type": "boolean" }, "infoType": { - "description": "The [type of information](https://cloud.google.com/dlp/docs/infotypes-reference) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.", + "description": "The type of information (or *[infoType](https://cloud.google.com/dlp/docs/infotypes-reference)*) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.", "type": "string" }, "infoTypeCount": { @@ -2109,18 +2109,18 @@ "id": "Compliance", "properties": { "ids": { - "description": "Policies within the standard/benchmark e.g. A.12.4.1", + "description": "Policies within the standard or benchmark, for example, A.12.4.1", "items": { "type": "string" }, "type": "array" }, "standard": { - "description": "Refers to industry wide standards or benchmarks e.g. \"cis\", \"pci\", \"owasp\", etc.", + "description": "Industry-wide compliance standards or benchmarks, such as CIS, PCI, and OWASP.", "type": "string" }, "version": { - "description": "Version of the standard/benchmark e.g. 1.1", + "description": "Version of the standard or benchmark, for example, 1.1", "type": "string" } }, @@ -2214,7 +2214,7 @@ "type": "object" }, "ContactDetails": { - "description": "The details pertaining to specific contacts", + "description": "Details about specific contacts", "id": "ContactDetails", "properties": { "contacts": { @@ -2232,7 +2232,7 @@ "id": "Container", "properties": { "imageId": { - "description": "Optional container image id, when provided by the container runtime. Uniquely identifies the container image launched using a container image digest.", + "description": "Optional container image ID, if provided by the container runtime. Uniquely identifies the container image launched using a container image digest.", "type": "string" }, "labels": { @@ -2243,11 +2243,11 @@ "type": "array" }, "name": { - "description": "Container name.", + "description": "Name of the container.", "type": "string" }, "uri": { - "description": "Container image URI provided when configuring a pod/container. May identify a container image version using mutable tags.", + "description": "Container image URI provided when configuring a pod or container. This string can identify a container image version using mutable tags.", "type": "string" } }, @@ -2461,30 +2461,30 @@ "type": "object" }, "Database": { - "description": "Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of CloudSQL instances or Cloud Spanner instances), or the database instance itself. Some database resources may not have the full resource name populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. CloudSQL databases). In these cases only the display name will be provided.", + "description": "Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of Cloud SQL instances or Cloud Spanner instances), or the database instance itself. Some database resources might not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types, such as Cloud SQL databases, are not yet supported by Cloud Asset Inventory. In these cases only the display name is provided. Some database resources may not have the [full resource name](https://google.aip.dev/122#full-resource-names) populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. Cloud SQL databases). In these cases only the display name will be provided.", "id": "Database", "properties": { "displayName": { - "description": "The human readable name of the database the user connected to.", + "description": "The human-readable name of the database that the user connected to.", "type": "string" }, "grantees": { - "description": "The target usernames/roles/groups of a SQL privilege grant (not an IAM policy change).", + "description": "The target usernames, roles, or groups of an SQL privilege grant, which is not an IAM policy change.", "items": { "type": "string" }, "type": "array" }, "name": { - "description": "The full resource name of the database the user connected to, if it is supported by CAI. (https://google.aip.dev/122#full-resource-names)", + "description": "The [full resource name](https://google.aip.dev/122#full-resource-names) of the database that the user connected to, if it is supported by Cloud Asset Inventory.", "type": "string" }, "query": { - "description": "The SQL statement associated with the relevant access.", + "description": "The SQL statement that is associated with the database access.", "type": "string" }, "userName": { - "description": "The username used to connect to the DB. This may not necessarily be an IAM principal, and has no required format.", + "description": "The username used to connect to the database. The username might not be an IAM principal and does not have a set format.", "type": "string" } }, @@ -2544,7 +2544,7 @@ "type": "object" }, "EnvironmentVariable": { - "description": "EnvironmentVariable is a name-value pair to store environment variables for Process.", + "description": "A name-value pair representing an environment variable used in an operating system process.", "id": "EnvironmentVariable", "properties": { "name": { @@ -2599,25 +2599,25 @@ "type": "object" }, "ExfilResource": { - "description": "Resource that has been exfiltrated or exfiltrated_to.", + "description": "Resource where data was exfiltrated from or exfiltrated to.", "id": "ExfilResource", "properties": { "components": { - "description": "Subcomponents of the asset that is exfiltrated - these could be URIs used during exfiltration, table names, databases, filenames, etc. For example, multiple tables may be exfiltrated from the same CloudSQL instance, or multiple files from the same Cloud Storage bucket.", + "description": "Subcomponents of the asset that was exfiltrated, like URIs used during exfiltration, table names, databases, and filenames. For example, multiple tables might have been exfiltrated from the same Cloud SQL instance, or multiple files might have been exfiltrated from the same Cloud Storage bucket.", "items": { "type": "string" }, "type": "array" }, "name": { - "description": "Resource's URI (https://google.aip.dev/122#full-resource-names)", + "description": "The resource's [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name).", "type": "string" } }, "type": "object" }, "Exfiltration": { - "description": "Exfiltration represents a data exfiltration attempt of one or more sources to one or more targets. Sources represent the source of data that is exfiltrated, and Targets represents the destination the data was copied to.", + "description": "Exfiltration represents a data exfiltration attempt from one or more sources to one or more targets. The `sources` attribute lists the sources of the exfiltrated data. The `targets` attribute lists the destinations the data was copied to.", "id": "Exfiltration", "properties": { "sources": { @@ -2665,7 +2665,7 @@ "id": "File", "properties": { "contents": { - "description": "Prefix of the file contents as a JSON encoded string. (Currently only populated for Malicious Script Executed findings.)", + "description": "Prefix of the file contents as a JSON-encoded string.", "type": "string" }, "hashedSize": { @@ -3015,11 +3015,11 @@ "id": "GoogleCloudSecuritycenterV1Binding", "properties": { "name": { - "description": "Name for binding.", + "description": "Name for the binding.", "type": "string" }, "ns": { - "description": "Namespace for binding.", + "description": "Namespace for the binding.", "type": "string" }, "role": { @@ -3630,7 +3630,7 @@ "type": "string" }, "member": { - "description": "A single identity requesting access for a Cloud Platform resource, e.g. \"foo@google.com\".", + "description": "A single identity requesting access for a Cloud Platform resource, for example, \"foo@google.com\".", "type": "string" }, "role": { @@ -3680,39 +3680,39 @@ "id": "KernelRootkit", "properties": { "name": { - "description": "Rootkit name when available.", + "description": "Rootkit name, when available.", "type": "string" }, "unexpectedCodeModification": { - "description": "True when unexpected modifications of kernel code memory are present.", + "description": "True if unexpected modifications of kernel code memory are present.", "type": "boolean" }, "unexpectedFtraceHandler": { - "description": "True when `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.", + "description": "True if `ftrace` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.", "type": "boolean" }, "unexpectedInterruptHandler": { - "description": "True when interrupt handlers that are are not in the expected kernel or module code regions are present.", + "description": "True if interrupt handlers that are are not in the expected kernel or module code regions are present.", "type": "boolean" }, "unexpectedKernelCodePages": { - "description": "True when kernel code pages that are not in the expected kernel or module code regions are present.", + "description": "True if kernel code pages that are not in the expected kernel or module code regions are present.", "type": "boolean" }, "unexpectedKprobeHandler": { - "description": "True when `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.", + "description": "True if `kprobe` points are present with callbacks pointing to regions that are not in the expected kernel or module code range.", "type": "boolean" }, "unexpectedProcessesInRunqueue": { - "description": "True when unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.", + "description": "True if unexpected processes in the scheduler run queue are present. Such processes are in the run queue, but not in the process task list.", "type": "boolean" }, "unexpectedReadOnlyDataModification": { - "description": "True when unexpected modifications of kernel read-only data memory are present.", + "description": "True if unexpected modifications of kernel read-only data memory are present.", "type": "boolean" }, "unexpectedSystemCallHandler": { - "description": "True when system call handlers that are are not in the expected kernel or module code regions are present.", + "description": "True if system call handlers that are are not in the expected kernel or module code regions are present.", "type": "boolean" } }, @@ -3723,42 +3723,42 @@ "id": "Kubernetes", "properties": { "accessReviews": { - "description": "Provides information on any Kubernetes access reviews (i.e. privilege checks) relevant to the finding.", + "description": "Provides information on any Kubernetes access reviews (privilege checks) relevant to the finding.", "items": { "$ref": "AccessReview" }, "type": "array" }, "bindings": { - "description": "Provides Kubernetes role binding information for findings that involve RoleBindings or ClusterRoleBindings.", + "description": "Provides Kubernetes role binding information for findings that involve [RoleBindings or ClusterRoleBindings](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).", "items": { "$ref": "GoogleCloudSecuritycenterV1Binding" }, "type": "array" }, "nodePools": { - "description": "GKE Node Pools associated with the finding. This field will contain NodePool information for each Node, when it is available.", + "description": "GKE [node pools](https://cloud.google.com/kubernetes-engine/docs/concepts/node-pools) associated with the finding. This field contains node pool information for each node, when it is available.", "items": { "$ref": "NodePool" }, "type": "array" }, "nodes": { - "description": "Provides Kubernetes Node information.", + "description": "Provides Kubernetes [node](https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-architecture#nodes) information.", "items": { "$ref": "Node" }, "type": "array" }, "pods": { - "description": "Kubernetes Pods associated with the finding. This field will contain Pod records for each container that is owned by a Pod.", + "description": "Kubernetes [Pods](https://cloud.google.com/kubernetes-engine/docs/concepts/pod) associated with the finding. This field contains Pod records for each container that is owned by a Pod.", "items": { "$ref": "Pod" }, "type": "array" }, "roles": { - "description": "Provides Kubernetes role information for findings that involve Roles or ClusterRoles.", + "description": "Provides Kubernetes role information for findings that involve [Roles or ClusterRoles](https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control).", "items": { "$ref": "Role" }, @@ -3768,15 +3768,15 @@ "type": "object" }, "Label": { - "description": "Label represents a generic name=value label. Label has separate name and value fields to support filtering with contains().", + "description": "Represents a generic name-value label. A label has separate name and value fields to support filtering with the `contains()` function. For more information, see [Filtering on array-type fields](https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering).", "id": "Label", "properties": { "name": { - "description": "Label name.", + "description": "Name of the label.", "type": "string" }, "value": { - "description": "Label value.", + "description": "Value that corresponds to the label's name.", "type": "string" } }, @@ -4057,22 +4057,22 @@ "type": "object" }, "Node": { - "description": "Kubernetes Nodes associated with the finding.", + "description": "Kubernetes nodes associated with the finding.", "id": "Node", "properties": { "name": { - "description": "Full Resource name of the Compute Engine VM running the cluster node.", + "description": "[Full resource name](https://google.aip.dev/122#full-resource-names) of the Compute Engine VM running the cluster node.", "type": "string" } }, "type": "object" }, "NodePool": { - "description": "Provides GKE Node Pool information.", + "description": "Provides GKE node pool information.", "id": "NodePool", "properties": { "name": { - "description": "Kubernetes Node pool name.", + "description": "Kubernetes node pool name.", "type": "string" }, "nodes": { @@ -4111,7 +4111,7 @@ "type": "object" }, "Pod": { - "description": "Kubernetes Pod.", + "description": "A Kubernetes Pod.", "id": "Pod", "properties": { "containers": { @@ -4177,22 +4177,22 @@ "type": "array" }, "name": { - "description": "The process name visible in utilities like `top` and `ps`; it can be accessed via `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.", + "description": "The process name, as displayed in utilities like `top` and `ps`. This name can be accessed through `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.", "type": "string" }, "parentPid": { - "description": "The parent process id.", + "description": "The parent process ID.", "format": "int64", "type": "string" }, "pid": { - "description": "The process id.", + "description": "The process ID.", "format": "int64", "type": "string" }, "script": { "$ref": "File", - "description": "When the process represents the invocation of a script, `binary` provides information about the interpreter while `script` provides information about the script file provided to the interpreter." + "description": "When the process represents the invocation of a script, `binary` provides information about the interpreter, while `script` provides information about the script file provided to the interpreter." } }, "type": "object" @@ -4405,11 +4405,11 @@ "type": "object" }, "Subject": { - "description": "Represents a Kubernetes Subject.", + "description": "Represents a Kubernetes subject.", "id": "Subject", "properties": { "kind": { - "description": "Authentication type for subject.", + "description": "Authentication type for the subject.", "enum": [ "AUTH_TYPE_UNSPECIFIED", "USER", @@ -4419,17 +4419,17 @@ "enumDescriptions": [ "Authentication is not specified.", "User with valid certificate.", - "Users managed by Kubernetes API with credentials stored as Secrets.", + "Users managed by Kubernetes API with credentials stored as secrets.", "Collection of users." ], "type": "string" }, "name": { - "description": "Name for subject.", + "description": "Name for the subject.", "type": "string" }, "ns": { - "description": "Namespace for subject.", + "description": "Namespace for the subject.", "type": "string" } }, diff --git a/securitycenter/v1beta2/securitycenter-gen.go b/securitycenter/v1beta2/securitycenter-gen.go index 70206b293da..5a51490bc3d 100644 --- a/securitycenter/v1beta2/securitycenter-gen.go +++ b/securitycenter/v1beta2/securitycenter-gen.go @@ -512,13 +512,14 @@ func (s *Access) MarshalJSON() ([]byte, error) { } // AccessReview: Conveys information about a Kubernetes access review -// (e.g. kubectl auth can-i ...) that was involved in a finding. +// (such as one returned by a `kubectl auth can-i` +// (https://kubernetes.io/docs/reference/access-authn-authz/authorization/#checking-api-access) +// command) that was involved in a finding. type AccessReview struct { - // Group: Group is the API Group of the Resource. "*" means all. + // Group: The API group of the resource. "*" means all. Group string `json:"group,omitempty"` - // Name: Name is the name of the resource being requested. Empty means - // all. + // Name: The name of the resource being requested. Empty means all. Name string `json:"name,omitempty"` // Ns: Namespace of the action being requested. Currently, there is no @@ -526,18 +527,17 @@ type AccessReview struct { // represented by "" (empty). Ns string `json:"ns,omitempty"` - // Resource: Resource is the optional resource type requested. "*" means - // all. + // Resource: The optional resource type requested. "*" means all. Resource string `json:"resource,omitempty"` - // Subresource: Subresource is the optional subresource type. + // Subresource: The optional subresource type. Subresource string `json:"subresource,omitempty"` - // Verb: Verb is a Kubernetes resource API verb, like: get, list, watch, - // create, update, delete, proxy. "*" means all. + // Verb: A Kubernetes resource API verb, like get, list, watch, create, + // update, delete, proxy. "*" means all. Verb string `json:"verb,omitempty"` - // Version: Version is the API Version of the Resource. "*" means all. + // Version: The API version of the resource. "*" means all. Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "Group") to @@ -603,8 +603,8 @@ type CloudDlpInspection struct { // sampled subset. FullScan bool `json:"fullScan,omitempty"` - // InfoType: The type of information - // (https://cloud.google.com/dlp/docs/infotypes-reference) found, for + // InfoType: The type of information (or *infoType + // (https://cloud.google.com/dlp/docs/infotypes-reference)*) found, for // example, `EMAIL_ADDRESS` or `STREET_ADDRESS`. InfoType string `json:"infoType,omitempty"` @@ -642,14 +642,14 @@ func (s *CloudDlpInspection) MarshalJSON() ([]byte, error) { // Compliance: Contains compliance information about a security standard // indicating unmet recommendations. type Compliance struct { - // Ids: Policies within the standard/benchmark e.g. A.12.4.1 + // Ids: Policies within the standard or benchmark, for example, A.12.4.1 Ids []string `json:"ids,omitempty"` - // Standard: Refers to industry wide standards or benchmarks e.g. "cis", - // "pci", "owasp", etc. + // Standard: Industry-wide compliance standards or benchmarks, such as + // CIS, PCI, and OWASP. Standard string `json:"standard,omitempty"` - // Version: Version of the standard/benchmark e.g. 1.1 + // Version: Version of the standard or benchmark, for example, 1.1 Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "Ids") to @@ -796,7 +796,7 @@ func (s *Contact) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// ContactDetails: The details pertaining to specific contacts +// ContactDetails: Details about specific contacts type ContactDetails struct { // Contacts: A list of contacts Contacts []*Contact `json:"contacts,omitempty"` @@ -826,7 +826,7 @@ func (s *ContactDetails) MarshalJSON() ([]byte, error) { // Container: Container associated with the finding. type Container struct { - // ImageId: Optional container image id, when provided by the container + // ImageId: Optional container image ID, if provided by the container // runtime. Uniquely identifies the container image launched using a // container image digest. ImageId string `json:"imageId,omitempty"` @@ -834,11 +834,12 @@ type Container struct { // Labels: Container labels, as provided by the container runtime. Labels []*Label `json:"labels,omitempty"` - // Name: Container name. + // Name: Name of the container. Name string `json:"name,omitempty"` - // Uri: Container image URI provided when configuring a pod/container. - // May identify a container image version using mutable tags. + // Uri: Container image URI provided when configuring a pod or + // container. This string can identify a container image version using + // mutable tags. Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "ImageId") to @@ -1129,30 +1130,36 @@ func (s *Cvssv3) UnmarshalJSON(data []byte) error { // Database: Represents database access information, such as queries. A // database may be a sub-resource of an instance (as in the case of -// CloudSQL instances or Cloud Spanner instances), or the database -// instance itself. Some database resources may not have the full -// resource name populated because these resource types are not yet -// supported by Cloud Asset Inventory (e.g. CloudSQL databases). In -// these cases only the display name will be provided. +// Cloud SQL instances or Cloud Spanner instances), or the database +// instance itself. Some database resources might not have the full +// resource name (https://google.aip.dev/122#full-resource-names) +// populated because these resource types, such as Cloud SQL databases, +// are not yet supported by Cloud Asset Inventory. In these cases only +// the display name is provided. Some database resources may not have +// the full resource name +// (https://google.aip.dev/122#full-resource-names) populated because +// these resource types are not yet supported by Cloud Asset Inventory +// (e.g. Cloud SQL databases). In these cases only the display name will +// be provided. type Database struct { - // DisplayName: The human readable name of the database the user + // DisplayName: The human-readable name of the database that the user // connected to. DisplayName string `json:"displayName,omitempty"` - // Grantees: The target usernames/roles/groups of a SQL privilege grant - // (not an IAM policy change). + // Grantees: The target usernames, roles, or groups of an SQL privilege + // grant, which is not an IAM policy change. Grantees []string `json:"grantees,omitempty"` - // Name: The full resource name of the database the user connected to, - // if it is supported by CAI. - // (https://google.aip.dev/122#full-resource-names) + // Name: The full resource name + // (https://google.aip.dev/122#full-resource-names) of the database that + // the user connected to, if it is supported by Cloud Asset Inventory. Name string `json:"name,omitempty"` - // Query: The SQL statement associated with the relevant access. + // Query: The SQL statement that is associated with the database access. Query string `json:"query,omitempty"` - // UserName: The username used to connect to the DB. This may not - // necessarily be an IAM principal, and has no required format. + // UserName: The username used to connect to the database. The username + // might not be an IAM principal and does not have a set format. UserName string `json:"userName,omitempty"` // ForceSendFields is a list of field names (e.g. "DisplayName") to @@ -1268,8 +1275,8 @@ func (s *Detection) UnmarshalJSON(data []byte) error { return nil } -// EnvironmentVariable: EnvironmentVariable is a name-value pair to -// store environment variables for Process. +// EnvironmentVariable: A name-value pair representing an environment +// variable used in an operating system process. type EnvironmentVariable struct { // Name: Environment variable name as a JSON encoded string. Name string `json:"name,omitempty"` @@ -1356,16 +1363,18 @@ func (s *EventThreatDetectionSettings) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// ExfilResource: Resource that has been exfiltrated or exfiltrated_to. +// ExfilResource: Resource where data was exfiltrated from or +// exfiltrated to. type ExfilResource struct { - // Components: Subcomponents of the asset that is exfiltrated - these - // could be URIs used during exfiltration, table names, databases, - // filenames, etc. For example, multiple tables may be exfiltrated from - // the same CloudSQL instance, or multiple files from the same Cloud - // Storage bucket. + // Components: Subcomponents of the asset that was exfiltrated, like + // URIs used during exfiltration, table names, databases, and filenames. + // For example, multiple tables might have been exfiltrated from the + // same Cloud SQL instance, or multiple files might have been + // exfiltrated from the same Cloud Storage bucket. Components []string `json:"components,omitempty"` - // Name: Resource's URI (https://google.aip.dev/122#full-resource-names) + // Name: The resource's full resource name + // (https://cloud.google.com/apis/design/resource_names#full_resource_name). Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "Components") to @@ -1391,10 +1400,10 @@ func (s *ExfilResource) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Exfiltration: Exfiltration represents a data exfiltration attempt of -// one or more sources to one or more targets. Sources represent the -// source of data that is exfiltrated, and Targets represents the -// destination the data was copied to. +// Exfiltration: Exfiltration represents a data exfiltration attempt +// from one or more sources to one or more targets. The `sources` +// attribute lists the sources of the exfiltrated data. The `targets` +// attribute lists the destinations the data was copied to. type Exfiltration struct { // Sources: If there are multiple sources, then the data is considered // "joined" between them. For instance, BigQuery can join multiple @@ -1491,8 +1500,7 @@ func (s *Expr) MarshalJSON() ([]byte, error) { // File: File information about the related binary/library used by an // executable, or the script used by a script interpreter type File struct { - // Contents: Prefix of the file contents as a JSON encoded string. - // (Currently only populated for Malicious Script Executed findings.) + // Contents: Prefix of the file contents as a JSON-encoded string. Contents string `json:"contents,omitempty"` // HashedSize: The length in bytes of the file prefix that was hashed. @@ -1963,10 +1971,10 @@ func (s *GoogleCloudSecuritycenterV1BigQueryExport) MarshalJSON() ([]byte, error // GoogleCloudSecuritycenterV1Binding: Represents a Kubernetes // RoleBinding or ClusterRoleBinding. type GoogleCloudSecuritycenterV1Binding struct { - // Name: Name for binding. + // Name: Name for the binding. Name string `json:"name,omitempty"` - // Ns: Namespace for binding. + // Ns: Namespace for the binding. Ns string `json:"ns,omitempty"` // Role: The Role or ClusterRole referenced by the binding. @@ -2939,7 +2947,7 @@ type IamBinding struct { Action string `json:"action,omitempty"` // Member: A single identity requesting access for a Cloud Platform - // resource, e.g. "foo@google.com". + // resource, for example, "foo@google.com". Member string `json:"member,omitempty"` // Role: Role that is assigned to "members". For example, @@ -3015,41 +3023,41 @@ func (s *Indicator) MarshalJSON() ([]byte, error) { // KernelRootkit: Kernel mode rootkit signatures. type KernelRootkit struct { - // Name: Rootkit name when available. + // Name: Rootkit name, when available. Name string `json:"name,omitempty"` - // UnexpectedCodeModification: True when unexpected modifications of + // UnexpectedCodeModification: True if unexpected modifications of // kernel code memory are present. UnexpectedCodeModification bool `json:"unexpectedCodeModification,omitempty"` - // UnexpectedFtraceHandler: True when `ftrace` points are present with + // UnexpectedFtraceHandler: True if `ftrace` points are present with // callbacks pointing to regions that are not in the expected kernel or // module code range. UnexpectedFtraceHandler bool `json:"unexpectedFtraceHandler,omitempty"` - // UnexpectedInterruptHandler: True when interrupt handlers that are are + // UnexpectedInterruptHandler: True if interrupt handlers that are are // not in the expected kernel or module code regions are present. UnexpectedInterruptHandler bool `json:"unexpectedInterruptHandler,omitempty"` - // UnexpectedKernelCodePages: True when kernel code pages that are not - // in the expected kernel or module code regions are present. + // UnexpectedKernelCodePages: True if kernel code pages that are not in + // the expected kernel or module code regions are present. UnexpectedKernelCodePages bool `json:"unexpectedKernelCodePages,omitempty"` - // UnexpectedKprobeHandler: True when `kprobe` points are present with + // UnexpectedKprobeHandler: True if `kprobe` points are present with // callbacks pointing to regions that are not in the expected kernel or // module code range. UnexpectedKprobeHandler bool `json:"unexpectedKprobeHandler,omitempty"` - // UnexpectedProcessesInRunqueue: True when unexpected processes in the + // UnexpectedProcessesInRunqueue: True if unexpected processes in the // scheduler run queue are present. Such processes are in the run queue, // but not in the process task list. UnexpectedProcessesInRunqueue bool `json:"unexpectedProcessesInRunqueue,omitempty"` - // UnexpectedReadOnlyDataModification: True when unexpected - // modifications of kernel read-only data memory are present. + // UnexpectedReadOnlyDataModification: True if unexpected modifications + // of kernel read-only data memory are present. UnexpectedReadOnlyDataModification bool `json:"unexpectedReadOnlyDataModification,omitempty"` - // UnexpectedSystemCallHandler: True when system call handlers that are + // UnexpectedSystemCallHandler: True if system call handlers that are // are not in the expected kernel or module code regions are present. UnexpectedSystemCallHandler bool `json:"unexpectedSystemCallHandler,omitempty"` @@ -3079,27 +3087,34 @@ func (s *KernelRootkit) MarshalJSON() ([]byte, error) { // Kubernetes: Kubernetes-related attributes. type Kubernetes struct { // AccessReviews: Provides information on any Kubernetes access reviews - // (i.e. privilege checks) relevant to the finding. + // (privilege checks) relevant to the finding. AccessReviews []*AccessReview `json:"accessReviews,omitempty"` // Bindings: Provides Kubernetes role binding information for findings - // that involve RoleBindings or ClusterRoleBindings. + // that involve RoleBindings or ClusterRoleBindings + // (https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control). Bindings []*GoogleCloudSecuritycenterV1Binding `json:"bindings,omitempty"` - // NodePools: GKE Node Pools associated with the finding. This field - // will contain NodePool information for each Node, when it is - // available. + // NodePools: GKE node pools + // (https://cloud.google.com/kubernetes-engine/docs/concepts/node-pools) + // associated with the finding. This field contains node pool + // information for each node, when it is available. NodePools []*NodePool `json:"nodePools,omitempty"` - // Nodes: Provides Kubernetes Node information. + // Nodes: Provides Kubernetes node + // (https://cloud.google.com/kubernetes-engine/docs/concepts/cluster-architecture#nodes) + // information. Nodes []*Node `json:"nodes,omitempty"` - // Pods: Kubernetes Pods associated with the finding. This field will - // contain Pod records for each container that is owned by a Pod. + // Pods: Kubernetes Pods + // (https://cloud.google.com/kubernetes-engine/docs/concepts/pod) + // associated with the finding. This field contains Pod records for each + // container that is owned by a Pod. Pods []*Pod `json:"pods,omitempty"` // Roles: Provides Kubernetes role information for findings that involve - // Roles or ClusterRoles. + // Roles or ClusterRoles + // (https://cloud.google.com/kubernetes-engine/docs/how-to/role-based-access-control). Roles []*Role `json:"roles,omitempty"` // ForceSendFields is a list of field names (e.g. "AccessReviews") to @@ -3125,13 +3140,15 @@ func (s *Kubernetes) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Label: Label represents a generic name=value label. Label has -// separate name and value fields to support filtering with contains(). +// Label: Represents a generic name-value label. A label has separate +// name and value fields to support filtering with the `contains()` +// function. For more information, see Filtering on array-type fields +// (https://cloud.google.com/security-command-center/docs/how-to-api-list-findings#array-contains-filtering). type Label struct { - // Name: Label name. + // Name: Name of the label. Name string `json:"name,omitempty"` - // Value: Label value. + // Value: Value that corresponds to the label's name. Value string `json:"value,omitempty"` // ForceSendFields is a list of field names (e.g. "Name") to @@ -3352,10 +3369,11 @@ func (s *MitreAttack) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Node: Kubernetes Nodes associated with the finding. +// Node: Kubernetes nodes associated with the finding. type Node struct { - // Name: Full Resource name of the Compute Engine VM running the cluster - // node. + // Name: Full resource name + // (https://google.aip.dev/122#full-resource-names) of the Compute + // Engine VM running the cluster node. Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "Name") to @@ -3381,9 +3399,9 @@ func (s *Node) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// NodePool: Provides GKE Node Pool information. +// NodePool: Provides GKE node pool information. type NodePool struct { - // Name: Kubernetes Node pool name. + // Name: Kubernetes node pool name. Name string `json:"name,omitempty"` // Nodes: Nodes associated with the finding. @@ -3461,7 +3479,7 @@ func (s *OnboardingState) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Pod: Kubernetes Pod. +// Pod: A Kubernetes Pod. type Pod struct { // Containers: Pod containers associated with this finding, if any. Containers []*Container `json:"containers,omitempty"` @@ -3519,19 +3537,19 @@ type Process struct { // Libraries: File information for libraries loaded by the process. Libraries []*File `json:"libraries,omitempty"` - // Name: The process name visible in utilities like `top` and `ps`; it - // can be accessed via `/proc/[pid]/comm` and changed with - // `prctl(PR_SET_NAME)`. + // Name: The process name, as displayed in utilities like `top` and + // `ps`. This name can be accessed through `/proc/[pid]/comm` and + // changed with `prctl(PR_SET_NAME)`. Name string `json:"name,omitempty"` - // ParentPid: The parent process id. + // ParentPid: The parent process ID. ParentPid int64 `json:"parentPid,omitempty,string"` - // Pid: The process id. + // Pid: The process ID. Pid int64 `json:"pid,omitempty,string"` // Script: When the process represents the invocation of a script, - // `binary` provides information about the interpreter while `script` + // `binary` provides information about the interpreter, while `script` // provides information about the script file provided to the // interpreter. Script *File `json:"script,omitempty"` @@ -3932,22 +3950,22 @@ func (s *ServiceAccountDelegationInfo) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Subject: Represents a Kubernetes Subject. +// Subject: Represents a Kubernetes subject. type Subject struct { - // Kind: Authentication type for subject. + // Kind: Authentication type for the subject. // // Possible values: // "AUTH_TYPE_UNSPECIFIED" - Authentication is not specified. // "USER" - User with valid certificate. // "SERVICEACCOUNT" - Users managed by Kubernetes API with credentials - // stored as Secrets. + // stored as secrets. // "GROUP" - Collection of users. Kind string `json:"kind,omitempty"` - // Name: Name for subject. + // Name: Name for the subject. Name string `json:"name,omitempty"` - // Ns: Namespace for subject. + // Ns: Namespace for the subject. Ns string `json:"ns,omitempty"` // ForceSendFields is a list of field names (e.g. "Kind") to diff --git a/workstations/v1beta/workstations-api.json b/workstations/v1beta/workstations-api.json index f559502c895..26a7f60f4ec 100644 --- a/workstations/v1beta/workstations-api.json +++ b/workstations/v1beta/workstations-api.json @@ -443,7 +443,7 @@ "type": "boolean" }, "workstationConfigId": { - "description": "Required. ID to use for the config.", + "description": "Required. ID to use for the workstation configuration.", "location": "query", "type": "string" } @@ -469,17 +469,17 @@ ], "parameters": { "etag": { - "description": "If set, the request will be rejected if the latest version of the config on the server does not have this etag.", + "description": "If set, the request is rejected if the latest version of the workstation configuration on the server does not have this etag.", "location": "query", "type": "string" }, "force": { - "description": "If set, any Workstations in the config will also be deleted. Otherwise, the request will work only if the config has no workstations.", + "description": "If set, any workstations in the workstation configuration are also deleted. Otherwise, the request works only if the workstation configuration has no workstations.", "location": "query", "type": "boolean" }, "name": { - "description": "Required. Name of the config to delete.", + "description": "Required. Name of the workstation configuration to delete.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/workstationClusters/[^/]+/workstationConfigs/[^/]+$", "required": true, @@ -637,7 +637,7 @@ ], "parameters": { "allowMissing": { - "description": "If set, and the config is not found, a new config will be created. In this situation, update_mask is ignored.", + "description": "If set and the workstation configuration is not found, a new workstation configuration will be created. In this situation, update_mask is ignored.", "location": "query", "type": "boolean" }, @@ -649,7 +649,7 @@ "type": "string" }, "updateMask": { - "description": "Required. Mask specifying which fields in the config should be updated.", + "description": "Required. Mask specifying which fields in the workstation configuration should be updated.", "format": "google-fieldmask", "location": "query", "type": "string" @@ -889,7 +889,7 @@ ] }, "list": { - "description": "Returns all Workstations using the specified config.", + "description": "Returns all Workstations using the specified workstation configuration.", "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/workstationClusters/{workstationClustersId}/workstationConfigs/{workstationConfigsId}/workstations", "httpMethod": "GET", "id": "workstations.projects.locations.workstationClusters.workstationConfigs.workstations.list", @@ -925,7 +925,7 @@ ] }, "listUsable": { - "description": "Returns all Workstations using the specified config on which the caller has the \"workstations.workstations.use\" permission.", + "description": "Returns all workstations using the specified workstation configuration on which the caller has the \"workstations.workstations.use\" permission.", "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/workstationClusters/{workstationClustersId}/workstationConfigs/{workstationConfigsId}/workstations:listUsable", "httpMethod": "GET", "id": "workstations.projects.locations.workstationClusters.workstationConfigs.workstations.listUsable", @@ -970,7 +970,7 @@ ], "parameters": { "allowMissing": { - "description": "If set, and the config is not found, a new config will be created. In this situation, update_mask is ignored.", + "description": "If set and the workstation configuration is not found, a new workstation configuration is created. In this situation, update_mask is ignored.", "location": "query", "type": "boolean" }, @@ -982,7 +982,7 @@ "type": "string" }, "updateMask": { - "description": "Required. Mask specifying which fields in the config should be updated.", + "description": "Required. Mask specifying which fields in the workstation configuration should be updated.", "format": "google-fieldmask", "location": "query", "type": "string" @@ -1127,7 +1127,7 @@ } } }, - "revision": "20230405", + "revision": "20230412", "rootUrl": "https://workstations.googleapis.com/", "schemas": { "AuditConfig": { @@ -1232,7 +1232,7 @@ "type": "object" }, "image": { - "description": "Docker image defining the container. This image must be accessible by the config's service account.", + "description": "Docker image defining the container. This image must be accessible by the service account specified in the workstation configuration.", "type": "string" }, "runAsUser": { @@ -1323,7 +1323,7 @@ "type": "integer" }, "serviceAccount": { - "description": "Email address of the service account that will be used on VM instances used to support this config. If not set, VMs will run with a Google-managed service account. This service account must have permission to pull the specified container image, otherwise the image must be publicly accessible.", + "description": "Email address of the service account used on VM instances used to support this configuration. If not set, VMs run with a Google-managed service account. This service account must have permission to pull the specified container image; otherwise, the image must be publicly accessible.", "type": "string" }, "shieldedInstanceConfig": { @@ -1879,7 +1879,7 @@ "type": "object" }, "etag": { - "description": "Checksum computed by the server. May be sent on update and delete requests to ensure that the client has an up-to-date value before proceeding.", + "description": "Checksum computed by the server. May be sent on update and delete requests to make sure that the client has an up-to-date value before proceeding.", "type": "string" }, "host": { @@ -1956,7 +1956,7 @@ "type": "array" }, "controlPlaneIp": { - "description": "Output only. The private IP address of the control plane for this cluster. Workstation VMs need access to this IP address to work with the service, so please ensure your firewall rules allow egress from the Workstation VMs to this address.", + "description": "Output only. The private IP address of the control plane for this cluster. Workstation VMs need access to this IP address to work with the service, so make sure that your firewall rules allow egress from the workstation VMs to this address.", "readOnly": true, "type": "string" }, @@ -1982,7 +1982,7 @@ "type": "string" }, "etag": { - "description": "Checksum computed by the server. May be sent on update and delete requests to ensure that the client has an up-to-date value before proceeding.", + "description": "Checksum computed by the server. May be sent on update and delete requests to make sure that the client has an up-to-date value before proceeding.", "type": "string" }, "labels": { @@ -2077,10 +2077,10 @@ }, "encryptionKey": { "$ref": "CustomerEncryptionKey", - "description": "Immutable. Encrypts resources of this workstation configuration using a customer-managed encryption key. If specified, the boot disk of the Compute Engine instance and the persistent disk are encrypted using this encryption key. If this field is not set, the disks are encrypted using a generated key. Customer-managed encryption keys do not protect disk metadata. If the customer-managed encryption key is rotated, when the workstation instance is stopped, the system attempts to recreate the persistent disk with the new version of the key. Be sure to keep older versions of the key until the persistent disk is recreated. Otherwise, data on the persistent disk will be lost. If the encryption key is revoked, the workstation session will automatically be stopped within 7 hours. Immutable after workstation config is created." + "description": "Immutable. Encrypts resources of this workstation configuration using a customer-managed encryption key. If specified, the boot disk of the Compute Engine instance and the persistent disk are encrypted using this encryption key. If this field is not set, the disks are encrypted using a generated key. Customer-managed encryption keys do not protect disk metadata. If the customer-managed encryption key is rotated, when the workstation instance is stopped, the system attempts to recreate the persistent disk with the new version of the key. Be sure to keep older versions of the key until the persistent disk is recreated. Otherwise, data on the persistent disk will be lost. If the encryption key is revoked, the workstation session will automatically be stopped within 7 hours. Immutable after the workstation configuration is created." }, "etag": { - "description": "Checksum computed by the server. May be sent on update and delete requests to ensure that the client has an up-to-date value before proceeding.", + "description": "Checksum computed by the server. May be sent on update and delete requests to make sure that the client has an up-to-date value before proceeding.", "type": "string" }, "host": { diff --git a/workstations/v1beta/workstations-gen.go b/workstations/v1beta/workstations-gen.go index 600058bc7eb..cb2241cb1fe 100644 --- a/workstations/v1beta/workstations-gen.go +++ b/workstations/v1beta/workstations-gen.go @@ -400,7 +400,8 @@ type Container struct { Env map[string]string `json:"env,omitempty"` // Image: Docker image defining the container. This image must be - // accessible by the config's service account. + // accessible by the service account specified in the workstation + // configuration. Image string `json:"image,omitempty"` // RunAsUser: If set, overrides the USER specified in the image with the @@ -585,11 +586,11 @@ type GceInstance struct { // PoolSize: Number of instances to pool for faster workstation starup. PoolSize int64 `json:"poolSize,omitempty"` - // ServiceAccount: Email address of the service account that will be - // used on VM instances used to support this config. If not set, VMs - // will run with a Google-managed service account. This service account - // must have permission to pull the specified container image, otherwise - // the image must be publicly accessible. + // ServiceAccount: Email address of the service account used on VM + // instances used to support this configuration. If not set, VMs run + // with a Google-managed service account. This service account must have + // permission to pull the specified container image; otherwise, the + // image must be publicly accessible. ServiceAccount string `json:"serviceAccount,omitempty"` // ShieldedInstanceConfig: A set of Compute Engine Shielded instance @@ -1601,7 +1602,7 @@ type Workstation struct { Env map[string]string `json:"env,omitempty"` // Etag: Checksum computed by the server. May be sent on update and - // delete requests to ensure that the client has an up-to-date value + // delete requests to make sure that the client has an up-to-date value // before proceeding. Etag string `json:"etag,omitempty"` @@ -1683,8 +1684,8 @@ type WorkstationCluster struct { // ControlPlaneIp: Output only. The private IP address of the control // plane for this cluster. Workstation VMs need access to this IP - // address to work with the service, so please ensure your firewall - // rules allow egress from the Workstation VMs to this address. + // address to work with the service, so make sure that your firewall + // rules allow egress from the workstation VMs to this address. ControlPlaneIp string `json:"controlPlaneIp,omitempty"` // CreateTime: Output only. Time when this resource was created. @@ -1702,7 +1703,7 @@ type WorkstationCluster struct { DisplayName string `json:"displayName,omitempty"` // Etag: Checksum computed by the server. May be sent on update and - // delete requests to ensure that the client has an up-to-date value + // delete requests to make sure that the client has an up-to-date value // before proceeding. Etag string `json:"etag,omitempty"` @@ -1812,11 +1813,11 @@ type WorkstationConfig struct { // the persistent disk is recreated. Otherwise, data on the persistent // disk will be lost. If the encryption key is revoked, the workstation // session will automatically be stopped within 7 hours. Immutable after - // workstation config is created. + // the workstation configuration is created. EncryptionKey *CustomerEncryptionKey `json:"encryptionKey,omitempty"` // Etag: Checksum computed by the server. May be sent on update and - // delete requests to ensure that the client has an up-to-date value + // delete requests to make sure that the client has an up-to-date value // before proceeding. Etag string `json:"etag,omitempty"` @@ -3415,7 +3416,8 @@ func (c *ProjectsLocationsWorkstationClustersWorkstationConfigsCreateCall) Valid } // WorkstationConfigId sets the optional parameter -// "workstationConfigId": Required. ID to use for the config. +// "workstationConfigId": Required. ID to use for the workstation +// configuration. func (c *ProjectsLocationsWorkstationClustersWorkstationConfigsCreateCall) WorkstationConfigId(workstationConfigId string) *ProjectsLocationsWorkstationClustersWorkstationConfigsCreateCall { c.urlParams_.Set("workstationConfigId", workstationConfigId) return c @@ -3533,7 +3535,7 @@ func (c *ProjectsLocationsWorkstationClustersWorkstationConfigsCreateCall) Do(op // "type": "boolean" // }, // "workstationConfigId": { - // "description": "Required. ID to use for the config.", + // "description": "Required. ID to use for the workstation configuration.", // "location": "query", // "type": "string" // } @@ -3564,24 +3566,25 @@ type ProjectsLocationsWorkstationClustersWorkstationConfigsDeleteCall struct { // Delete: Deletes the specified workstation configuration. // -// - name: Name of the config to delete. +// - name: Name of the workstation configuration to delete. func (r *ProjectsLocationsWorkstationClustersWorkstationConfigsService) Delete(name string) *ProjectsLocationsWorkstationClustersWorkstationConfigsDeleteCall { c := &ProjectsLocationsWorkstationClustersWorkstationConfigsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } -// Etag sets the optional parameter "etag": If set, the request will be -// rejected if the latest version of the config on the server does not -// have this etag. +// Etag sets the optional parameter "etag": If set, the request is +// rejected if the latest version of the workstation configuration on +// the server does not have this etag. func (c *ProjectsLocationsWorkstationClustersWorkstationConfigsDeleteCall) Etag(etag string) *ProjectsLocationsWorkstationClustersWorkstationConfigsDeleteCall { c.urlParams_.Set("etag", etag) return c } -// Force sets the optional parameter "force": If set, any Workstations -// in the config will also be deleted. Otherwise, the request will work -// only if the config has no workstations. +// Force sets the optional parameter "force": If set, any workstations +// in the workstation configuration are also deleted. Otherwise, the +// request works only if the workstation configuration has no +// workstations. func (c *ProjectsLocationsWorkstationClustersWorkstationConfigsDeleteCall) Force(force bool) *ProjectsLocationsWorkstationClustersWorkstationConfigsDeleteCall { c.urlParams_.Set("force", fmt.Sprint(force)) return c @@ -3690,17 +3693,17 @@ func (c *ProjectsLocationsWorkstationClustersWorkstationConfigsDeleteCall) Do(op // ], // "parameters": { // "etag": { - // "description": "If set, the request will be rejected if the latest version of the config on the server does not have this etag.", + // "description": "If set, the request is rejected if the latest version of the workstation configuration on the server does not have this etag.", // "location": "query", // "type": "string" // }, // "force": { - // "description": "If set, any Workstations in the config will also be deleted. Otherwise, the request will work only if the config has no workstations.", + // "description": "If set, any workstations in the workstation configuration are also deleted. Otherwise, the request works only if the workstation configuration has no workstations.", // "location": "query", // "type": "boolean" // }, // "name": { - // "description": "Required. Name of the config to delete.", + // "description": "Required. Name of the workstation configuration to delete.", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/workstationClusters/[^/]+/workstationConfigs/[^/]+$", // "required": true, @@ -4453,16 +4456,18 @@ func (r *ProjectsLocationsWorkstationClustersWorkstationConfigsService) Patch(na return c } -// AllowMissing sets the optional parameter "allowMissing": If set, and -// the config is not found, a new config will be created. In this -// situation, update_mask is ignored. +// AllowMissing sets the optional parameter "allowMissing": If set and +// the workstation configuration is not found, a new workstation +// configuration will be created. In this situation, update_mask is +// ignored. func (c *ProjectsLocationsWorkstationClustersWorkstationConfigsPatchCall) AllowMissing(allowMissing bool) *ProjectsLocationsWorkstationClustersWorkstationConfigsPatchCall { c.urlParams_.Set("allowMissing", fmt.Sprint(allowMissing)) return c } // UpdateMask sets the optional parameter "updateMask": Required. Mask -// specifying which fields in the config should be updated. +// specifying which fields in the workstation configuration should be +// updated. func (c *ProjectsLocationsWorkstationClustersWorkstationConfigsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsWorkstationClustersWorkstationConfigsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -4576,7 +4581,7 @@ func (c *ProjectsLocationsWorkstationClustersWorkstationConfigsPatchCall) Do(opt // ], // "parameters": { // "allowMissing": { - // "description": "If set, and the config is not found, a new config will be created. In this situation, update_mask is ignored.", + // "description": "If set and the workstation configuration is not found, a new workstation configuration will be created. In this situation, update_mask is ignored.", // "location": "query", // "type": "boolean" // }, @@ -4588,7 +4593,7 @@ func (c *ProjectsLocationsWorkstationClustersWorkstationConfigsPatchCall) Do(opt // "type": "string" // }, // "updateMask": { - // "description": "Required. Mask specifying which fields in the config should be updated.", + // "description": "Required. Mask specifying which fields in the workstation configuration should be updated.", // "format": "google-fieldmask", // "location": "query", // "type": "string" @@ -5711,7 +5716,8 @@ type ProjectsLocationsWorkstationClustersWorkstationConfigsWorkstationsListCall header_ http.Header } -// List: Returns all Workstations using the specified config. +// List: Returns all Workstations using the specified workstation +// configuration. // // - parent: Parent resource name. func (r *ProjectsLocationsWorkstationClustersWorkstationConfigsWorkstationsService) List(parent string) *ProjectsLocationsWorkstationClustersWorkstationConfigsWorkstationsListCall { @@ -5833,7 +5839,7 @@ func (c *ProjectsLocationsWorkstationClustersWorkstationConfigsWorkstationsListC } return ret, nil // { - // "description": "Returns all Workstations using the specified config.", + // "description": "Returns all Workstations using the specified workstation configuration.", // "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/workstationClusters/{workstationClustersId}/workstationConfigs/{workstationConfigsId}/workstations", // "httpMethod": "GET", // "id": "workstations.projects.locations.workstationClusters.workstationConfigs.workstations.list", @@ -5903,8 +5909,9 @@ type ProjectsLocationsWorkstationClustersWorkstationConfigsWorkstationsListUsabl header_ http.Header } -// ListUsable: Returns all Workstations using the specified config on -// which the caller has the "workstations.workstations.use" permission. +// ListUsable: Returns all workstations using the specified workstation +// configuration on which the caller has the +// "workstations.workstations.use" permission. // // - parent: Parent resource name. func (r *ProjectsLocationsWorkstationClustersWorkstationConfigsWorkstationsService) ListUsable(parent string) *ProjectsLocationsWorkstationClustersWorkstationConfigsWorkstationsListUsableCall { @@ -6026,7 +6033,7 @@ func (c *ProjectsLocationsWorkstationClustersWorkstationConfigsWorkstationsListU } return ret, nil // { - // "description": "Returns all Workstations using the specified config on which the caller has the \"workstations.workstations.use\" permission.", + // "description": "Returns all workstations using the specified workstation configuration on which the caller has the \"workstations.workstations.use\" permission.", // "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/workstationClusters/{workstationClustersId}/workstationConfigs/{workstationConfigsId}/workstations:listUsable", // "httpMethod": "GET", // "id": "workstations.projects.locations.workstationClusters.workstationConfigs.workstations.listUsable", @@ -6106,16 +6113,17 @@ func (r *ProjectsLocationsWorkstationClustersWorkstationConfigsWorkstationsServi return c } -// AllowMissing sets the optional parameter "allowMissing": If set, and -// the config is not found, a new config will be created. In this -// situation, update_mask is ignored. +// AllowMissing sets the optional parameter "allowMissing": If set and +// the workstation configuration is not found, a new workstation +// configuration is created. In this situation, update_mask is ignored. func (c *ProjectsLocationsWorkstationClustersWorkstationConfigsWorkstationsPatchCall) AllowMissing(allowMissing bool) *ProjectsLocationsWorkstationClustersWorkstationConfigsWorkstationsPatchCall { c.urlParams_.Set("allowMissing", fmt.Sprint(allowMissing)) return c } // UpdateMask sets the optional parameter "updateMask": Required. Mask -// specifying which fields in the config should be updated. +// specifying which fields in the workstation configuration should be +// updated. func (c *ProjectsLocationsWorkstationClustersWorkstationConfigsWorkstationsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsWorkstationClustersWorkstationConfigsWorkstationsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -6229,7 +6237,7 @@ func (c *ProjectsLocationsWorkstationClustersWorkstationConfigsWorkstationsPatch // ], // "parameters": { // "allowMissing": { - // "description": "If set, and the config is not found, a new config will be created. In this situation, update_mask is ignored.", + // "description": "If set and the workstation configuration is not found, a new workstation configuration is created. In this situation, update_mask is ignored.", // "location": "query", // "type": "boolean" // }, @@ -6241,7 +6249,7 @@ func (c *ProjectsLocationsWorkstationClustersWorkstationConfigsWorkstationsPatch // "type": "string" // }, // "updateMask": { - // "description": "Required. Mask specifying which fields in the config should be updated.", + // "description": "Required. Mask specifying which fields in the workstation configuration should be updated.", // "format": "google-fieldmask", // "location": "query", // "type": "string"