diff --git a/.github/renovate.json b/.github/renovate.json index 6302f8db98a..98f0c454d0a 100644 --- a/.github/renovate.json +++ b/.github/renovate.json @@ -12,8 +12,7 @@ "commitMessageAction": "update", "groupName": "all", "ignoreDeps": [ - "google.golang.org/appengine", - "google.golang.org/grpc" + "google.golang.org/appengine" ], "packageRules": [ { @@ -26,7 +25,7 @@ ], "force": { "constraints": { - "go": "1.21" + "go": "1.22" } } } diff --git a/CHANGES.md b/CHANGES.md index fb0eae4d4f7..eb960c189fb 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -1,5 +1,18 @@ # Changes +## [0.216.0](https://github.com/googleapis/google-api-go-client/compare/v0.215.0...v0.216.0) (2025-01-09) + + +### Features + +* **all:** Auto-regenerate discovery clients ([#2946](https://github.com/googleapis/google-api-go-client/issues/2946)) ([fe72ad1](https://github.com/googleapis/google-api-go-client/commit/fe72ad1a338f479e121db2ff040787c8bff52c06)) +* **all:** Auto-regenerate discovery clients ([#2947](https://github.com/googleapis/google-api-go-client/issues/2947)) ([0386e0f](https://github.com/googleapis/google-api-go-client/commit/0386e0fba6d3ca3073953a1a8a95f658bc223d09)) +* **all:** Auto-regenerate discovery clients ([#2948](https://github.com/googleapis/google-api-go-client/issues/2948)) ([a04a14b](https://github.com/googleapis/google-api-go-client/commit/a04a14b15482a1a19132482ee81ef6b795768321)) +* **all:** Auto-regenerate discovery clients ([#2950](https://github.com/googleapis/google-api-go-client/issues/2950)) ([7ad3a5f](https://github.com/googleapis/google-api-go-client/commit/7ad3a5f3ac65dc3531c421108e9ce5ffbd94a4c8)) +* **all:** Auto-regenerate discovery clients ([#2951](https://github.com/googleapis/google-api-go-client/issues/2951)) ([d6e4f8d](https://github.com/googleapis/google-api-go-client/commit/d6e4f8d04653d492c5e46fc9c65781c36215a5d9)) +* **all:** Auto-regenerate discovery clients ([#2953](https://github.com/googleapis/google-api-go-client/issues/2953)) ([01a17b3](https://github.com/googleapis/google-api-go-client/commit/01a17b31be736d40369d7bfcb57b61c059aa5b7f)) +* **all:** Auto-regenerate discovery clients ([#2954](https://github.com/googleapis/google-api-go-client/issues/2954)) ([d4f41c6](https://github.com/googleapis/google-api-go-client/commit/d4f41c6070fa7d976c2d70e2d2237d5d4f4ec39e)) + ## [0.215.0](https://github.com/googleapis/google-api-go-client/compare/v0.214.0...v0.215.0) (2025-01-01) diff --git a/adsenseplatform/v1alpha/adsenseplatform-api.json b/adsenseplatform/v1alpha/adsenseplatform-api.json index 62e2189c264..61b25cd766e 100644 --- a/adsenseplatform/v1alpha/adsenseplatform-api.json +++ b/adsenseplatform/v1alpha/adsenseplatform-api.json @@ -108,6 +108,77 @@ }, "protocol": "rest", "resources": { + "accounts": { + "resources": { + "platforms": { + "methods": { + "get": { + "description": "Gets a platform.", + "flatPath": "v1alpha/accounts/{accountsId}/platforms/{platformsId}", + "httpMethod": "GET", + "id": "adsenseplatform.accounts.platforms.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the platform to retrieve. Format: accounts/{account}/platforms/{platform}", + "location": "path", + "pattern": "^accounts/[^/]+/platforms/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "Platform" + }, + "scopes": [ + "https://www.googleapis.com/auth/adsense", + "https://www.googleapis.com/auth/adsense.readonly" + ] + }, + "list": { + "description": "Lists platforms for a specified account.", + "flatPath": "v1alpha/accounts/{accountsId}/platforms", + "httpMethod": "GET", + "id": "adsenseplatform.accounts.platforms.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Optional. The maximum number of platforms to include in the response, used for paging. If unspecified, at most 10000 platforms will be returned. The maximum value is 10000; values above 10000 will be coerced to 10000.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. A page token, received from a previous `ListPlatforms` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListPlatforms` must match the call that provided the page token.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The account which owns the platforms. Format: accounts/{account}", + "location": "path", + "pattern": "^accounts/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+parent}/platforms", + "response": { + "$ref": "ListPlatformsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/adsense", + "https://www.googleapis.com/auth/adsense.readonly" + ] + } + } + } + } + }, "platforms": { "resources": { "accounts": { @@ -446,7 +517,7 @@ } } }, - "revision": "20241203", + "revision": "20250108", "rootUrl": "https://adsenseplatform.googleapis.com/", "schemas": { "Account": { @@ -628,6 +699,24 @@ }, "type": "object" }, + "ListPlatformsResponse": { + "description": "Response definition for the platform list rpc.", + "id": "ListPlatformsResponse", + "properties": { + "nextPageToken": { + "description": "Continuation token used to page through platforms. To retrieve the next page of the results, set the next request's \"page_token\" value to this.", + "type": "string" + }, + "platforms": { + "description": "The platforms returned in this list response.", + "items": { + "$ref": "Platform" + }, + "type": "array" + } + }, + "type": "object" + }, "ListSitesResponse": { "description": "Response definition for the site list rpc.", "id": "ListSitesResponse", @@ -657,6 +746,26 @@ }, "type": "object" }, + "Platform": { + "description": "Representation of a Transparent Platform.", + "id": "Platform", + "properties": { + "defaultPlatformGroup": { + "description": "Default platform group for the platform.", + "type": "string" + }, + "description": { + "description": "Output only. Description of the platform.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Identifier. Resource name of a platform. Format: accounts/{account}/platforms/{platform}", + "type": "string" + } + }, + "type": "object" + }, "RequestSiteReviewResponse": { "description": "Response definition for the site request review rpc.", "id": "RequestSiteReviewResponse", diff --git a/adsenseplatform/v1alpha/adsenseplatform-gen.go b/adsenseplatform/v1alpha/adsenseplatform-gen.go index 708ff4e54bb..a15e0ca0ccd 100644 --- a/adsenseplatform/v1alpha/adsenseplatform-gen.go +++ b/adsenseplatform/v1alpha/adsenseplatform-gen.go @@ -127,6 +127,7 @@ func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, err return nil, err } s := &Service{client: client, BasePath: basePath, logger: internaloption.GetLogger(opts)} + s.Accounts = NewAccountsService(s) s.Platforms = NewPlatformsService(s) if err != nil { return nil, err @@ -155,6 +156,8 @@ type Service struct { BasePath string // API endpoint base URL UserAgent string // optional additional User-Agent fragment + Accounts *AccountsService + Platforms *PlatformsService } @@ -165,6 +168,27 @@ func (s *Service) userAgent() string { return googleapi.UserAgent + " " + s.UserAgent } +func NewAccountsService(s *Service) *AccountsService { + rs := &AccountsService{s: s} + rs.Platforms = NewAccountsPlatformsService(s) + return rs +} + +type AccountsService struct { + s *Service + + Platforms *AccountsPlatformsService +} + +func NewAccountsPlatformsService(s *Service) *AccountsPlatformsService { + rs := &AccountsPlatformsService{s: s} + return rs +} + +type AccountsPlatformsService struct { + s *Service +} + func NewPlatformsService(s *Service) *PlatformsService { rs := &PlatformsService{s: s} rs.Accounts = NewPlatformsAccountsService(s) @@ -421,6 +445,35 @@ func (s ListAccountsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ListPlatformsResponse: Response definition for the platform list rpc. +type ListPlatformsResponse struct { + // NextPageToken: Continuation token used to page through platforms. To + // retrieve the next page of the results, set the next request's "page_token" + // value to this. + NextPageToken string `json:"nextPageToken,omitempty"` + // Platforms: The platforms returned in this list response. + Platforms []*Platform `json:"platforms,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "NextPageToken") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "NextPageToken") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ListPlatformsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListPlatformsResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ListSitesResponse: Response definition for the site list rpc. type ListSitesResponse struct { // NextPageToken: Continuation token used to page through sites. To retrieve @@ -476,6 +529,36 @@ func (s LookupAccountResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// Platform: Representation of a Transparent Platform. +type Platform struct { + // DefaultPlatformGroup: Default platform group for the platform. + DefaultPlatformGroup string `json:"defaultPlatformGroup,omitempty"` + // Description: Output only. Description of the platform. + Description string `json:"description,omitempty"` + // Name: Identifier. Resource name of a platform. Format: + // accounts/{account}/platforms/{platform} + 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. "DefaultPlatformGroup") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "DefaultPlatformGroup") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s Platform) MarshalJSON() ([]byte, error) { + type NoMethod Platform + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // RequestSiteReviewResponse: Response definition for the site request review // rpc. type RequestSiteReviewResponse struct { @@ -556,6 +639,265 @@ func (s TimeZone) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type AccountsPlatformsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets a platform. +// +// - name: The name of the platform to retrieve. Format: +// accounts/{account}/platforms/{platform}. +func (r *AccountsPlatformsService) Get(name string) *AccountsPlatformsGetCall { + c := &AccountsPlatformsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *AccountsPlatformsGetCall) Fields(s ...googleapi.Field) *AccountsPlatformsGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *AccountsPlatformsGetCall) IfNoneMatch(entityTag string) *AccountsPlatformsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *AccountsPlatformsGetCall) Context(ctx context.Context) *AccountsPlatformsGetCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *AccountsPlatformsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountsPlatformsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "adsenseplatform.accounts.platforms.get", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "adsenseplatform.accounts.platforms.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *Platform.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 *AccountsPlatformsGetCall) Do(opts ...googleapi.CallOption) (*Platform, 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 := &Platform{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "adsenseplatform.accounts.platforms.get", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type AccountsPlatformsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists platforms for a specified account. +// +// - parent: The account which owns the platforms. Format: accounts/{account}. +func (r *AccountsPlatformsService) List(parent string) *AccountsPlatformsListCall { + c := &AccountsPlatformsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number of +// platforms to include in the response, used for paging. If unspecified, at +// most 10000 platforms will be returned. The maximum value is 10000; values +// above 10000 will be coerced to 10000. +func (c *AccountsPlatformsListCall) PageSize(pageSize int64) *AccountsPlatformsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A page token, received +// from a previous `ListPlatforms` call. Provide this to retrieve the +// subsequent page. When paginating, all other parameters provided to +// `ListPlatforms` must match the call that provided the page token. +func (c *AccountsPlatformsListCall) PageToken(pageToken string) *AccountsPlatformsListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *AccountsPlatformsListCall) Fields(s ...googleapi.Field) *AccountsPlatformsListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *AccountsPlatformsListCall) IfNoneMatch(entityTag string) *AccountsPlatformsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *AccountsPlatformsListCall) Context(ctx context.Context) *AccountsPlatformsListCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *AccountsPlatformsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountsPlatformsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+parent}/platforms") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "adsenseplatform.accounts.platforms.list", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "adsenseplatform.accounts.platforms.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *ListPlatformsResponse.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 *AccountsPlatformsListCall) Do(opts ...googleapi.CallOption) (*ListPlatformsResponse, 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 := &ListPlatformsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "adsenseplatform.accounts.platforms.list", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *AccountsPlatformsListCall) Pages(ctx context.Context, f func(*ListPlatformsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + type PlatformsAccountsCloseCall struct { s *Service name string diff --git a/analyticsadmin/v1alpha/analyticsadmin-api.json b/analyticsadmin/v1alpha/analyticsadmin-api.json index d09a559b1c5..24682e1c372 100644 --- a/analyticsadmin/v1alpha/analyticsadmin-api.json +++ b/analyticsadmin/v1alpha/analyticsadmin-api.json @@ -340,7 +340,7 @@ ] }, "searchChangeHistoryEvents": { - "description": "Searches through all changes to an account or its children given the specified set of filters.", + "description": "Searches through all changes to an account or its children given the specified set of filters. Only returns the subset of changes supported by the API. The UI may return additional changes.", "flatPath": "v1alpha/accounts/{accountsId}:searchChangeHistoryEvents", "httpMethod": "POST", "id": "analyticsadmin.accounts.searchChangeHistoryEvents", @@ -4886,7 +4886,7 @@ } } }, - "revision": "20240929", + "revision": "20250103", "rootUrl": "https://analyticsadmin.googleapis.com/", "schemas": { "GoogleAnalyticsAdminV1alphaAccessBetweenFilter": { @@ -6818,7 +6818,7 @@ "id": "GoogleAnalyticsAdminV1alphaDataRetentionSettings", "properties": { "eventDataRetention": { - "description": "The length of time that event-level data is retained.", + "description": "Required. The length of time that event-level data is retained.", "enum": [ "RETENTION_DURATION_UNSPECIFIED", "TWO_MONTHS", @@ -6831,9 +6831,9 @@ "Data retention time duration is not specified.", "The data retention time duration is 2 months.", "The data retention time duration is 14 months.", - "The data retention time duration is 26 months. Available to 360 properties only.", - "The data retention time duration is 38 months. Available to 360 properties only.", - "The data retention time duration is 50 months. Available to 360 properties only." + "The data retention time duration is 26 months. Available to 360 properties only. Available for event data only.", + "The data retention time duration is 38 months. Available to 360 properties only. Available for event data only.", + "The data retention time duration is 50 months. Available to 360 properties only. Available for event data only." ], "type": "string" }, @@ -8774,7 +8774,7 @@ "type": "string" }, "pageSize": { - "description": "Optional. The maximum number of ChangeHistoryEvent items to return. The service may return fewer than this value, even if there are additional pages. If unspecified, at most 50 items will be returned. The maximum value is 200 (higher values will be coerced to the maximum).", + "description": "Optional. The maximum number of ChangeHistoryEvent items to return. If unspecified, at most 50 items will be returned. The maximum value is 200 (higher values will be coerced to the maximum). Note that the service may return a page with fewer items than this value specifies (potentially even zero), and that there still may be additional pages. If you want a particular number of items, you'll need to continue requesting additional pages using `page_token` until you get the needed number.", "format": "int32", "type": "integer" }, diff --git a/analyticsadmin/v1alpha/analyticsadmin-gen.go b/analyticsadmin/v1alpha/analyticsadmin-gen.go index d4836faf45e..7917492b817 100644 --- a/analyticsadmin/v1alpha/analyticsadmin-gen.go +++ b/analyticsadmin/v1alpha/analyticsadmin-gen.go @@ -3047,7 +3047,8 @@ func (s GoogleAnalyticsAdminV1alphaDataRedactionSettings) MarshalJSON() ([]byte, // GoogleAnalyticsAdminV1alphaDataRetentionSettings: Settings values for data // retention. This is a singleton resource. type GoogleAnalyticsAdminV1alphaDataRetentionSettings struct { - // EventDataRetention: The length of time that event-level data is retained. + // EventDataRetention: Required. The length of time that event-level data is + // retained. // // Possible values: // "RETENTION_DURATION_UNSPECIFIED" - Data retention time duration is not @@ -3055,11 +3056,11 @@ type GoogleAnalyticsAdminV1alphaDataRetentionSettings struct { // "TWO_MONTHS" - The data retention time duration is 2 months. // "FOURTEEN_MONTHS" - The data retention time duration is 14 months. // "TWENTY_SIX_MONTHS" - The data retention time duration is 26 months. - // Available to 360 properties only. + // Available to 360 properties only. Available for event data only. // "THIRTY_EIGHT_MONTHS" - The data retention time duration is 38 months. - // Available to 360 properties only. + // Available to 360 properties only. Available for event data only. // "FIFTY_MONTHS" - The data retention time duration is 50 months. Available - // to 360 properties only. + // to 360 properties only. Available for event data only. EventDataRetention string `json:"eventDataRetention,omitempty"` // Name: Output only. Resource name for this DataRetentionSetting resource. // Format: properties/{property}/dataRetentionSettings @@ -5850,9 +5851,12 @@ type GoogleAnalyticsAdminV1alphaSearchChangeHistoryEventsRequest struct { // time (inclusive). LatestChangeTime string `json:"latestChangeTime,omitempty"` // PageSize: Optional. The maximum number of ChangeHistoryEvent items to - // return. The service may return fewer than this value, even if there are - // additional pages. If unspecified, at most 50 items will be returned. The - // maximum value is 200 (higher values will be coerced to the maximum). + // return. If unspecified, at most 50 items will be returned. The maximum value + // is 200 (higher values will be coerced to the maximum). Note that the service + // may return a page with fewer items than this value specifies (potentially + // even zero), and that there still may be additional pages. If you want a + // particular number of items, you'll need to continue requesting additional + // pages using `page_token` until you get the needed number. PageSize int64 `json:"pageSize,omitempty"` // PageToken: Optional. A page token, received from a previous // `SearchChangeHistoryEvents` call. Provide this to retrieve the subsequent @@ -7179,7 +7183,8 @@ type AccountsSearchChangeHistoryEventsCall struct { } // SearchChangeHistoryEvents: Searches through all changes to an account or its -// children given the specified set of filters. +// children given the specified set of filters. Only returns the subset of +// changes supported by the API. The UI may return additional changes. // // - account: The account resource for which to return change history // resources. Format: accounts/{account} Example: `accounts/100`. diff --git a/analyticsadmin/v1beta/analyticsadmin-api.json b/analyticsadmin/v1beta/analyticsadmin-api.json index aa8d75e5bed..705ee6eca44 100644 --- a/analyticsadmin/v1beta/analyticsadmin-api.json +++ b/analyticsadmin/v1beta/analyticsadmin-api.json @@ -334,7 +334,7 @@ ] }, "searchChangeHistoryEvents": { - "description": "Searches through all changes to an account or its children given the specified set of filters.", + "description": "Searches through all changes to an account or its children given the specified set of filters. Only returns the subset of changes supported by the API. The UI may return additional changes.", "flatPath": "v1beta/accounts/{accountsId}:searchChangeHistoryEvents", "httpMethod": "POST", "id": "analyticsadmin.accounts.searchChangeHistoryEvents", @@ -1788,7 +1788,7 @@ } } }, - "revision": "20241113", + "revision": "20250103", "rootUrl": "https://analyticsadmin.googleapis.com/", "schemas": { "GoogleAnalyticsAdminV1betaAccessBetweenFilter": { @@ -2575,7 +2575,7 @@ "id": "GoogleAnalyticsAdminV1betaDataRetentionSettings", "properties": { "eventDataRetention": { - "description": "The length of time that event-level data is retained.", + "description": "Required. The length of time that event-level data is retained.", "enum": [ "RETENTION_DURATION_UNSPECIFIED", "TWO_MONTHS", @@ -2588,9 +2588,9 @@ "Data retention time duration is not specified.", "The data retention time duration is 2 months.", "The data retention time duration is 14 months.", - "The data retention time duration is 26 months. Available to 360 properties only.", - "The data retention time duration is 38 months. Available to 360 properties only.", - "The data retention time duration is 50 months. Available to 360 properties only." + "The data retention time duration is 26 months. Available to 360 properties only. Available for event data only.", + "The data retention time duration is 38 months. Available to 360 properties only. Available for event data only.", + "The data retention time duration is 50 months. Available to 360 properties only. Available for event data only." ], "type": "string" }, @@ -3470,7 +3470,7 @@ "type": "string" }, "pageSize": { - "description": "Optional. The maximum number of ChangeHistoryEvent items to return. The service may return fewer than this value, even if there are additional pages. If unspecified, at most 50 items will be returned. The maximum value is 200 (higher values will be coerced to the maximum).", + "description": "Optional. The maximum number of ChangeHistoryEvent items to return. If unspecified, at most 50 items will be returned. The maximum value is 200 (higher values will be coerced to the maximum). Note that the service may return a page with fewer items than this value specifies (potentially even zero), and that there still may be additional pages. If you want a particular number of items, you'll need to continue requesting additional pages using `page_token` until you get the needed number.", "format": "int32", "type": "integer" }, diff --git a/analyticsadmin/v1beta/analyticsadmin-gen.go b/analyticsadmin/v1beta/analyticsadmin-gen.go index 97ac8dd1f63..46aae2a119a 100644 --- a/analyticsadmin/v1beta/analyticsadmin-gen.go +++ b/analyticsadmin/v1beta/analyticsadmin-gen.go @@ -1339,7 +1339,8 @@ func (s GoogleAnalyticsAdminV1betaCustomMetric) MarshalJSON() ([]byte, error) { // GoogleAnalyticsAdminV1betaDataRetentionSettings: Settings values for data // retention. This is a singleton resource. type GoogleAnalyticsAdminV1betaDataRetentionSettings struct { - // EventDataRetention: The length of time that event-level data is retained. + // EventDataRetention: Required. The length of time that event-level data is + // retained. // // Possible values: // "RETENTION_DURATION_UNSPECIFIED" - Data retention time duration is not @@ -1347,11 +1348,11 @@ type GoogleAnalyticsAdminV1betaDataRetentionSettings struct { // "TWO_MONTHS" - The data retention time duration is 2 months. // "FOURTEEN_MONTHS" - The data retention time duration is 14 months. // "TWENTY_SIX_MONTHS" - The data retention time duration is 26 months. - // Available to 360 properties only. + // Available to 360 properties only. Available for event data only. // "THIRTY_EIGHT_MONTHS" - The data retention time duration is 38 months. - // Available to 360 properties only. + // Available to 360 properties only. Available for event data only. // "FIFTY_MONTHS" - The data retention time duration is 50 months. Available - // to 360 properties only. + // to 360 properties only. Available for event data only. EventDataRetention string `json:"eventDataRetention,omitempty"` // Name: Output only. Resource name for this DataRetentionSetting resource. // Format: properties/{property}/dataRetentionSettings @@ -2488,9 +2489,12 @@ type GoogleAnalyticsAdminV1betaSearchChangeHistoryEventsRequest struct { // time (inclusive). LatestChangeTime string `json:"latestChangeTime,omitempty"` // PageSize: Optional. The maximum number of ChangeHistoryEvent items to - // return. The service may return fewer than this value, even if there are - // additional pages. If unspecified, at most 50 items will be returned. The - // maximum value is 200 (higher values will be coerced to the maximum). + // return. If unspecified, at most 50 items will be returned. The maximum value + // is 200 (higher values will be coerced to the maximum). Note that the service + // may return a page with fewer items than this value specifies (potentially + // even zero), and that there still may be additional pages. If you want a + // particular number of items, you'll need to continue requesting additional + // pages using `page_token` until you get the needed number. PageSize int64 `json:"pageSize,omitempty"` // PageToken: Optional. A page token, received from a previous // `SearchChangeHistoryEvents` call. Provide this to retrieve the subsequent @@ -3556,7 +3560,8 @@ type AccountsSearchChangeHistoryEventsCall struct { } // SearchChangeHistoryEvents: Searches through all changes to an account or its -// children given the specified set of filters. +// children given the specified set of filters. Only returns the subset of +// changes supported by the API. The UI may return additional changes. // // - account: The account resource for which to return change history // resources. Format: accounts/{account} Example: `accounts/100`. diff --git a/analyticshub/v1/analyticshub-api.json b/analyticshub/v1/analyticshub-api.json index 190f6a852bf..6e3483b5f83 100644 --- a/analyticshub/v1/analyticshub-api.json +++ b/analyticshub/v1/analyticshub-api.json @@ -1022,11 +1022,11 @@ } } }, - "revision": "20241028", + "revision": "20241213", "rootUrl": "https://analyticshub.googleapis.com/", "schemas": { "AnalyticsHubSubscriptionInfo": { - "description": "Information about an associated Analytics Hub subscription (https://cloud.google.com/bigquery/docs/analytics-hub-manage-subscriptions).", + "description": "Information about an associated [Analytics Hub subscription](https://cloud.google.com/bigquery/docs/analytics-hub-manage-subscriptions).", "id": "AnalyticsHubSubscriptionInfo", "properties": { "listing": { @@ -1501,6 +1501,68 @@ }, "type": "object" }, + "GoogleCloudBigqueryAnalyticshubV1ListingCommercialInfo": { + "description": "Commercial info contains the information about the commercial data products associated with the listing.", + "id": "GoogleCloudBigqueryAnalyticshubV1ListingCommercialInfo", + "properties": { + "cloudMarketplace": { + "$ref": "GoogleCloudBigqueryAnalyticshubV1ListingCommercialInfoGoogleCloudMarketplaceInfo", + "description": "Output only. Details of the Marketplace Data Product associated with the Listing.", + "readOnly": true + } + }, + "type": "object" + }, + "GoogleCloudBigqueryAnalyticshubV1ListingCommercialInfoGoogleCloudMarketplaceInfo": { + "description": "Specifies the details of the Marketplace Data Product associated with the Listing.", + "id": "GoogleCloudBigqueryAnalyticshubV1ListingCommercialInfoGoogleCloudMarketplaceInfo", + "properties": { + "commercialState": { + "description": "Output only. Commercial state of the Marketplace Data Product.", + "enum": [ + "COMMERCIAL_STATE_UNSPECIFIED", + "ONBOARDING", + "ACTIVE" + ], + "enumDescriptions": [ + "Commercialization is incomplete and cannot be used.", + "Commercialization has been initialized.", + "Commercialization is complete and available for use." + ], + "readOnly": true, + "type": "string" + }, + "service": { + "description": "Output only. Resource name of the commercial service associated with the Marketplace Data Product. e.g. example.com", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudBigqueryAnalyticshubV1SubscriptionCommercialInfo": { + "description": "Commercial info metadata for this subscription.", + "id": "GoogleCloudBigqueryAnalyticshubV1SubscriptionCommercialInfo", + "properties": { + "cloudMarketplace": { + "$ref": "GoogleCloudBigqueryAnalyticshubV1SubscriptionCommercialInfoGoogleCloudMarketplaceInfo", + "description": "Output only. This is set when the subscription is commercialised via Cloud Marketplace.", + "readOnly": true + } + }, + "type": "object" + }, + "GoogleCloudBigqueryAnalyticshubV1SubscriptionCommercialInfoGoogleCloudMarketplaceInfo": { + "description": "Cloud Marketplace commercial metadata for this subscription.", + "id": "GoogleCloudBigqueryAnalyticshubV1SubscriptionCommercialInfoGoogleCloudMarketplaceInfo", + "properties": { + "order": { + "description": "Resource name of the Marketplace Order.", + "type": "string" + } + }, + "type": "object" + }, "GooglePubsubV1Subscription": { "description": "A subscription resource. If none of `push_config`, `bigquery_config`, or `cloud_storage_config` is set, then the subscriber will pull and ack messages using API methods. At most one of these fields may be set.", "id": "GooglePubsubV1Subscription", @@ -1770,6 +1832,11 @@ }, "type": "array" }, + "commercialInfo": { + "$ref": "GoogleCloudBigqueryAnalyticshubV1ListingCommercialInfo", + "description": "Output only. Commercial info contains the information about the commercial data products associated with the listing.", + "readOnly": true + }, "dataProvider": { "$ref": "DataProvider", "description": "Optional. Details of the data provider who owns the source data." @@ -2284,6 +2351,11 @@ "description": "A subscription represents a subscribers' access to a particular set of published data. It contains references to associated listings, data exchanges, and linked datasets.", "id": "Subscription", "properties": { + "commercialInfo": { + "$ref": "GoogleCloudBigqueryAnalyticshubV1SubscriptionCommercialInfo", + "description": "Output only. This is set if this is a commercial subscription i.e. if this subscription was created from subscribing to a commercial listing.", + "readOnly": true + }, "creationTime": { "description": "Output only. Timestamp when the subscription was created.", "format": "google-datetime", diff --git a/analyticshub/v1/analyticshub-gen.go b/analyticshub/v1/analyticshub-gen.go index def7a6d206f..62414f334b0 100644 --- a/analyticshub/v1/analyticshub-gen.go +++ b/analyticshub/v1/analyticshub-gen.go @@ -1080,6 +1080,112 @@ func (s GetPolicyOptions) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudBigqueryAnalyticshubV1ListingCommercialInfo: Commercial info +// contains the information about the commercial data products associated with +// the listing. +type GoogleCloudBigqueryAnalyticshubV1ListingCommercialInfo struct { + // CloudMarketplace: Output only. Details of the Marketplace Data Product + // associated with the Listing. + CloudMarketplace *GoogleCloudBigqueryAnalyticshubV1ListingCommercialInfoGoogleCloudMarketplaceInfo `json:"cloudMarketplace,omitempty"` + // ForceSendFields is a list of field names (e.g. "CloudMarketplace") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CloudMarketplace") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudBigqueryAnalyticshubV1ListingCommercialInfo) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudBigqueryAnalyticshubV1ListingCommercialInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudBigqueryAnalyticshubV1ListingCommercialInfoGoogleCloudMarketplaceI +// nfo: Specifies the details of the Marketplace Data Product associated with +// the Listing. +type GoogleCloudBigqueryAnalyticshubV1ListingCommercialInfoGoogleCloudMarketplaceInfo struct { + // CommercialState: Output only. Commercial state of the Marketplace Data + // Product. + // + // Possible values: + // "COMMERCIAL_STATE_UNSPECIFIED" - Commercialization is incomplete and + // cannot be used. + // "ONBOARDING" - Commercialization has been initialized. + // "ACTIVE" - Commercialization is complete and available for use. + CommercialState string `json:"commercialState,omitempty"` + // Service: Output only. Resource name of the commercial service associated + // with the Marketplace Data Product. e.g. example.com + Service string `json:"service,omitempty"` + // ForceSendFields is a list of field names (e.g. "CommercialState") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CommercialState") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudBigqueryAnalyticshubV1ListingCommercialInfoGoogleCloudMarketplaceInfo) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudBigqueryAnalyticshubV1ListingCommercialInfoGoogleCloudMarketplaceInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudBigqueryAnalyticshubV1SubscriptionCommercialInfo: Commercial info +// metadata for this subscription. +type GoogleCloudBigqueryAnalyticshubV1SubscriptionCommercialInfo struct { + // CloudMarketplace: Output only. This is set when the subscription is + // commercialised via Cloud Marketplace. + CloudMarketplace *GoogleCloudBigqueryAnalyticshubV1SubscriptionCommercialInfoGoogleCloudMarketplaceInfo `json:"cloudMarketplace,omitempty"` + // ForceSendFields is a list of field names (e.g. "CloudMarketplace") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CloudMarketplace") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudBigqueryAnalyticshubV1SubscriptionCommercialInfo) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudBigqueryAnalyticshubV1SubscriptionCommercialInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudBigqueryAnalyticshubV1SubscriptionCommercialInfoGoogleCloudMarketp +// laceInfo: Cloud Marketplace commercial metadata for this subscription. +type GoogleCloudBigqueryAnalyticshubV1SubscriptionCommercialInfoGoogleCloudMarketplaceInfo struct { + // Order: Resource name of the Marketplace Order. + Order string `json:"order,omitempty"` + // ForceSendFields is a list of field names (e.g. "Order") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Order") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudBigqueryAnalyticshubV1SubscriptionCommercialInfoGoogleCloudMarketplaceInfo) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudBigqueryAnalyticshubV1SubscriptionCommercialInfoGoogleCloudMarketplaceInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GooglePubsubV1Subscription: A subscription resource. If none of // `push_config`, `bigquery_config`, or `cloud_storage_config` is set, then the // subscriber will pull and ack messages using API methods. At most one of @@ -1418,6 +1524,9 @@ type Listing struct { // "CATEGORY_TRANSPORTATION_AND_LOGISTICS" // "CATEGORY_TRAVEL_AND_TOURISM" Categories []string `json:"categories,omitempty"` + // CommercialInfo: Output only. Commercial info contains the information about + // the commercial data products associated with the listing. + CommercialInfo *GoogleCloudBigqueryAnalyticshubV1ListingCommercialInfo `json:"commercialInfo,omitempty"` // DataProvider: Optional. Details of the data provider who owns the source // data. DataProvider *DataProvider `json:"dataProvider,omitempty"` @@ -2201,6 +2310,10 @@ func (s SubscribeListingResponse) MarshalJSON() ([]byte, error) { // particular set of published data. It contains references to associated // listings, data exchanges, and linked datasets. type Subscription struct { + // CommercialInfo: Output only. This is set if this is a commercial + // subscription i.e. if this subscription was created from subscribing to a + // commercial listing. + CommercialInfo *GoogleCloudBigqueryAnalyticshubV1SubscriptionCommercialInfo `json:"commercialInfo,omitempty"` // CreationTime: Output only. Timestamp when the subscription was created. CreationTime string `json:"creationTime,omitempty"` // DataExchange: Output only. Resource name of the source Data Exchange. e.g. @@ -2253,15 +2366,15 @@ type Subscription struct { // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "CreationTime") to + // ForceSendFields is a list of field names (e.g. "CommercialInfo") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "CreationTime") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See + // NullFields is a list of field names (e.g. "CommercialInfo") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } diff --git a/analyticshub/v1beta1/analyticshub-api.json b/analyticshub/v1beta1/analyticshub-api.json index 2a6dd602443..c9eb6cd5d63 100644 --- a/analyticshub/v1beta1/analyticshub-api.json +++ b/analyticshub/v1beta1/analyticshub-api.json @@ -695,7 +695,7 @@ } } }, - "revision": "20241028", + "revision": "20241213", "rootUrl": "https://analyticshub.googleapis.com/", "schemas": { "AuditConfig": { @@ -779,6 +779,18 @@ }, "type": "object" }, + "CommercialInfo": { + "description": "Commercial info metadata for this subscription.", + "id": "CommercialInfo", + "properties": { + "cloudMarketplace": { + "$ref": "GoogleCloudMarketplaceInfo", + "description": "Output only. This is set when the subscription is commercialised via Cloud Marketplace.", + "readOnly": true + } + }, + "type": "object" + }, "DataExchange": { "description": "A data exchange is a container that lets you share data. Along with the descriptive information about the data exchange, it contains listings that reference shared datasets.", "id": "DataExchange", @@ -930,6 +942,17 @@ }, "type": "object" }, + "GoogleCloudMarketplaceInfo": { + "description": "Cloud Marketplace commercial metadata for this subscription.", + "id": "GoogleCloudMarketplaceInfo", + "properties": { + "order": { + "description": "Resource name of the Marketplace Order.", + "type": "string" + } + }, + "type": "object" + }, "LinkedResource": { "description": "Reference to a linked resource tracked by this Subscription.", "id": "LinkedResource", @@ -1292,6 +1315,11 @@ "description": "A subscription represents a subscribers' access to a particular set of published data. It contains references to associated listings, data exchanges, and linked datasets.", "id": "Subscription", "properties": { + "commercialInfo": { + "$ref": "CommercialInfo", + "description": "Output only. This is set if this is a commercial subscription i.e. if this subscription was created from subscribing to a commercial listing.", + "readOnly": true + }, "creationTime": { "description": "Output only. Timestamp when the subscription was created.", "format": "google-datetime", diff --git a/analyticshub/v1beta1/analyticshub-gen.go b/analyticshub/v1beta1/analyticshub-gen.go index 0db811f8c6b..ad997f3133b 100644 --- a/analyticshub/v1beta1/analyticshub-gen.go +++ b/analyticshub/v1beta1/analyticshub-gen.go @@ -451,6 +451,29 @@ func (s Binding) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// CommercialInfo: Commercial info metadata for this subscription. +type CommercialInfo struct { + // CloudMarketplace: Output only. This is set when the subscription is + // commercialised via Cloud Marketplace. + CloudMarketplace *GoogleCloudMarketplaceInfo `json:"cloudMarketplace,omitempty"` + // ForceSendFields is a list of field names (e.g. "CloudMarketplace") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CloudMarketplace") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s CommercialInfo) MarshalJSON() ([]byte, error) { + type NoMethod CommercialInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // DataExchange: A data exchange is a container that lets you share data. Along // with the descriptive information about the data exchange, it contains // listings that reference shared datasets. @@ -705,6 +728,29 @@ func (s GoogleCloudBigqueryDataexchangeV1beta1DestinationDatasetReference) Marsh return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudMarketplaceInfo: Cloud Marketplace commercial metadata for this +// subscription. +type GoogleCloudMarketplaceInfo struct { + // Order: Resource name of the Marketplace Order. + Order string `json:"order,omitempty"` + // ForceSendFields is a list of field names (e.g. "Order") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Order") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudMarketplaceInfo) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudMarketplaceInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // LinkedResource: Reference to a linked resource tracked by this Subscription. type LinkedResource struct { // LinkedDataset: Output only. Name of the linked dataset, e.g. @@ -1208,6 +1254,10 @@ type SubscribeListingResponse struct { // particular set of published data. It contains references to associated // listings, data exchanges, and linked datasets. type Subscription struct { + // CommercialInfo: Output only. This is set if this is a commercial + // subscription i.e. if this subscription was created from subscribing to a + // commercial listing. + CommercialInfo *CommercialInfo `json:"commercialInfo,omitempty"` // CreationTime: Output only. Timestamp when the subscription was created. CreationTime string `json:"creationTime,omitempty"` // DataExchange: Output only. Resource name of the source Data Exchange. e.g. @@ -1257,15 +1307,15 @@ type Subscription struct { State string `json:"state,omitempty"` // SubscriberContact: Output only. Email of the subscriber. SubscriberContact string `json:"subscriberContact,omitempty"` - // ForceSendFields is a list of field names (e.g. "CreationTime") to + // ForceSendFields is a list of field names (e.g. "CommercialInfo") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "CreationTime") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See + // NullFields is a list of field names (e.g. "CommercialInfo") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } diff --git a/androidenterprise/v1/androidenterprise-api.json b/androidenterprise/v1/androidenterprise-api.json index 8537d8c2692..fcc4320ee3b 100644 --- a/androidenterprise/v1/androidenterprise-api.json +++ b/androidenterprise/v1/androidenterprise-api.json @@ -392,48 +392,6 @@ "enterpriseId" ], "parameters": { - "deviceType": { - "deprecated": true, - "description": "Deprecated: Use enrollment_token instead. this field will be removed in the future.", - "enum": [ - "unknown", - "dedicatedDevice", - "knowledgeWorker" - ], - "enumDescriptions": [ - "This value is unused", - "This device is a dedicated device.", - "This device is required to have an authenticated user." - ], - "location": "query", - "type": "string" - }, - "enrollmentToken.duration": { - "description": "[Optional] The length of time the enrollment token is valid, ranging from 1 minute to [`Durations.MAX_VALUE`](https://developers.google.com/protocol-buffers/docs/reference/java/com/google/protobuf/util/Durations.html#MAX_VALUE), approximately 10,000 years. If not specified, the default duration is 1 hour.", - "format": "google-duration", - "location": "query", - "type": "string" - }, - "enrollmentToken.enrollmentTokenType": { - "description": "[Required] The type of the enrollment token.", - "enum": [ - "enrollmentTokenTypeUnspecified", - "userlessDevice", - "userDevice" - ], - "enumDescriptions": [ - "The value is unused.", - "The enrollment token is for a userless device.", - "The enrollment token is for a user device." - ], - "location": "query", - "type": "string" - }, - "enrollmentToken.token": { - "description": "The token value that's passed to the device and authorizes the device to enroll. This is a read-only field generated by the server.", - "location": "query", - "type": "string" - }, "enterpriseId": { "description": "Required. The ID of the enterprise.", "location": "path", @@ -442,8 +400,11 @@ } }, "path": "androidenterprise/v1/enterprises/{enterpriseId}/createEnrollmentToken", + "request": { + "$ref": "EnrollmentToken" + }, "response": { - "$ref": "CreateEnrollmentTokenResponse" + "$ref": "EnrollmentToken" }, "scopes": [ "https://www.googleapis.com/auth/androidenterprise" @@ -2681,7 +2642,7 @@ } } }, - "revision": "20241113", + "revision": "20250102", "rootUrl": "https://androidenterprise.googleapis.com/", "schemas": { "Administrator": { @@ -3175,22 +3136,6 @@ }, "type": "object" }, - "CreateEnrollmentTokenResponse": { - "description": "Response message for create enrollment token.", - "id": "CreateEnrollmentTokenResponse", - "properties": { - "enrollmentToken": { - "deprecated": true, - "description": "Deprecated: Use token instead. This field will be removed in the future.", - "type": "string" - }, - "token": { - "$ref": "EnrollmentToken", - "description": "[Required] The created enrollment token." - } - }, - "type": "object" - }, "Device": { "description": "A Devices resource represents a mobile device managed by the EMM and belonging to a specific enterprise user.", "id": "Device", diff --git a/androidenterprise/v1/androidenterprise-gen.go b/androidenterprise/v1/androidenterprise-gen.go index e0babc488ee..8fcac4c034d 100644 --- a/androidenterprise/v1/androidenterprise-gen.go +++ b/androidenterprise/v1/androidenterprise-gen.go @@ -990,34 +990,6 @@ func (s ConfigurationVariables) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// CreateEnrollmentTokenResponse: Response message for create enrollment token. -type CreateEnrollmentTokenResponse struct { - // EnrollmentToken: Deprecated: Use token instead. This field will be removed - // in the future. - EnrollmentToken string `json:"enrollmentToken,omitempty"` - // Token: [Required] The created enrollment token. - Token *EnrollmentToken `json:"token,omitempty"` - - // ServerResponse contains the HTTP response code and headers from the server. - googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "EnrollmentToken") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "EnrollmentToken") to include in - // API requests with the JSON null value. By default, fields with empty values - // are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s CreateEnrollmentTokenResponse) MarshalJSON() ([]byte, error) { - type NoMethod CreateEnrollmentTokenResponse - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // Device: A Devices resource represents a mobile device managed by the EMM and // belonging to a specific enterprise user. type Device struct { @@ -1214,6 +1186,9 @@ type EnrollmentToken struct { // Token: The token value that's passed to the device and authorizes the device // to enroll. This is a read-only field generated by the server. Token string `json:"token,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. "Duration") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -4301,11 +4276,12 @@ func (c *EnterprisesCompleteSignupCall) Do(opts ...googleapi.CallOption) (*Enter } type EnterprisesCreateEnrollmentTokenCall struct { - s *Service - enterpriseId string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header + s *Service + enterpriseId string + enrollmenttoken *EnrollmentToken + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } // CreateEnrollmentToken: Returns a token for device enrollment. The DPC can @@ -4314,55 +4290,10 @@ type EnterprisesCreateEnrollmentTokenCall struct { // be generated for each device or reused across multiple devices. // // - enterpriseId: The ID of the enterprise. -func (r *EnterprisesService) CreateEnrollmentToken(enterpriseId string) *EnterprisesCreateEnrollmentTokenCall { +func (r *EnterprisesService) CreateEnrollmentToken(enterpriseId string, enrollmenttoken *EnrollmentToken) *EnterprisesCreateEnrollmentTokenCall { c := &EnterprisesCreateEnrollmentTokenCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.enterpriseId = enterpriseId - return c -} - -// DeviceType sets the optional parameter "deviceType": Deprecated: Use -// enrollment_token instead. this field will be removed in the future. -// -// Possible values: -// -// "unknown" - This value is unused -// "dedicatedDevice" - This device is a dedicated device. -// "knowledgeWorker" - This device is required to have an authenticated user. -func (c *EnterprisesCreateEnrollmentTokenCall) DeviceType(deviceType string) *EnterprisesCreateEnrollmentTokenCall { - c.urlParams_.Set("deviceType", deviceType) - return c -} - -// EnrollmentTokenDuration sets the optional parameter -// "enrollmentToken.duration": [Optional] The length of time the enrollment -// token is valid, ranging from 1 minute to `Durations.MAX_VALUE` -// (https://developers.google.com/protocol-buffers/docs/reference/java/com/google/protobuf/util/Durations.html#MAX_VALUE), -// approximately 10,000 years. If not specified, the default duration is 1 -// hour. -func (c *EnterprisesCreateEnrollmentTokenCall) EnrollmentTokenDuration(enrollmentTokenDuration string) *EnterprisesCreateEnrollmentTokenCall { - c.urlParams_.Set("enrollmentToken.duration", enrollmentTokenDuration) - return c -} - -// EnrollmentTokenEnrollmentTokenType sets the optional parameter -// "enrollmentToken.enrollmentTokenType": [Required] The type of the enrollment -// token. -// -// Possible values: -// -// "enrollmentTokenTypeUnspecified" - The value is unused. -// "userlessDevice" - The enrollment token is for a userless device. -// "userDevice" - The enrollment token is for a user device. -func (c *EnterprisesCreateEnrollmentTokenCall) EnrollmentTokenEnrollmentTokenType(enrollmentTokenEnrollmentTokenType string) *EnterprisesCreateEnrollmentTokenCall { - c.urlParams_.Set("enrollmentToken.enrollmentTokenType", enrollmentTokenEnrollmentTokenType) - return c -} - -// EnrollmentTokenToken sets the optional parameter "enrollmentToken.token": -// The token value that's passed to the device and authorizes the device to -// enroll. This is a read-only field generated by the server. -func (c *EnterprisesCreateEnrollmentTokenCall) EnrollmentTokenToken(enrollmentTokenToken string) *EnterprisesCreateEnrollmentTokenCall { - c.urlParams_.Set("enrollmentToken.token", enrollmentTokenToken) + c.enrollmenttoken = enrollmenttoken return c } @@ -4390,12 +4321,16 @@ func (c *EnterprisesCreateEnrollmentTokenCall) Header() http.Header { } func (c *EnterprisesCreateEnrollmentTokenCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.enrollmenttoken) + if err != nil { + return nil, err + } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "androidenterprise/v1/enterprises/{enterpriseId}/createEnrollmentToken") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, nil) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } @@ -4403,17 +4338,17 @@ func (c *EnterprisesCreateEnrollmentTokenCall) doRequest(alt string) (*http.Resp googleapi.Expand(req.URL, map[string]string{ "enterpriseId": c.enterpriseId, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "androidenterprise.enterprises.createEnrollmentToken", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "androidenterprise.enterprises.createEnrollmentToken", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } // Do executes the "androidenterprise.enterprises.createEnrollmentToken" call. // Any non-2xx status code is an error. Response headers are in either -// *CreateEnrollmentTokenResponse.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 *EnterprisesCreateEnrollmentTokenCall) Do(opts ...googleapi.CallOption) (*CreateEnrollmentTokenResponse, error) { +// *EnrollmentToken.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 *EnterprisesCreateEnrollmentTokenCall) Do(opts ...googleapi.CallOption) (*EnrollmentToken, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -4432,7 +4367,7 @@ func (c *EnterprisesCreateEnrollmentTokenCall) Do(opts ...googleapi.CallOption) if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &CreateEnrollmentTokenResponse{ + ret := &EnrollmentToken{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, diff --git a/androidmanagement/v1/androidmanagement-api.json b/androidmanagement/v1/androidmanagement-api.json index 4d654b8ff88..306dd796e6c 100644 --- a/androidmanagement/v1/androidmanagement-api.json +++ b/androidmanagement/v1/androidmanagement-api.json @@ -1146,6 +1146,12 @@ "location": "query", "type": "string" }, + "allowedDomains": { + "description": "Optional. A list of domains that are permitted for the admin email. The IT admin cannot enter an email address with a domain name that is not in this list. Subdomains of domains in this list are not allowed but can be allowed by adding a second entry which has *. prefixed to the domain name (e.g. *.example.com). If the field is not present or is an empty list then the IT admin is free to use any valid domain name. Personal email domains are always allowed, but will result in the creation of a managed Google Play Accounts enterprise.", + "location": "query", + "repeated": true, + "type": "string" + }, "callbackUrl": { "description": "The callback URL that the admin will be redirected to after successfully creating an enterprise. Before redirecting there the system will add a query parameter to this URL named enterpriseToken which will contain an opaque token to be used for the create enterprise request. The URL will be parsed then reformatted in order to add the enterpriseToken parameter, so there may be some minor formatting changes.", "location": "query", @@ -1168,7 +1174,7 @@ } } }, - "revision": "20241204", + "revision": "20250106", "rootUrl": "https://androidmanagement.googleapis.com/", "schemas": { "AdbShellCommandEvent": { diff --git a/androidmanagement/v1/androidmanagement-gen.go b/androidmanagement/v1/androidmanagement-gen.go index 21ee930731f..a0e66d6e93b 100644 --- a/androidmanagement/v1/androidmanagement-gen.go +++ b/androidmanagement/v1/androidmanagement-gen.go @@ -10676,6 +10676,19 @@ func (c *SignupUrlsCreateCall) AdminEmail(adminEmail string) *SignupUrlsCreateCa return c } +// AllowedDomains sets the optional parameter "allowedDomains": A list of +// domains that are permitted for the admin email. The IT admin cannot enter an +// email address with a domain name that is not in this list. Subdomains of +// domains in this list are not allowed but can be allowed by adding a second +// entry which has *. prefixed to the domain name (e.g. *.example.com). If the +// field is not present or is an empty list then the IT admin is free to use +// any valid domain name. Personal email domains are always allowed, but will +// result in the creation of a managed Google Play Accounts enterprise. +func (c *SignupUrlsCreateCall) AllowedDomains(allowedDomains ...string) *SignupUrlsCreateCall { + c.urlParams_.SetMulti("allowedDomains", append([]string{}, allowedDomains...)) + return c +} + // CallbackUrl sets the optional parameter "callbackUrl": The callback URL that // the admin will be redirected to after successfully creating an enterprise. // Before redirecting there the system will add a query parameter to this URL diff --git a/androidpublisher/v3/androidpublisher-api.json b/androidpublisher/v3/androidpublisher-api.json index bcc8e3f8ade..5d0c11981d4 100644 --- a/androidpublisher/v3/androidpublisher-api.json +++ b/androidpublisher/v3/androidpublisher-api.json @@ -4732,7 +4732,7 @@ } } }, - "revision": "20241217", + "revision": "20250102", "rootUrl": "https://androidpublisher.googleapis.com/", "schemas": { "Abi": { @@ -7582,7 +7582,7 @@ "type": "object" }, "OfferTag": { - "description": "Represents a custom tag specified for base plans and subscription offers.", + "description": "Represents a custom tag specified for a product offer.", "id": "OfferTag", "properties": { "tag": { diff --git a/androidpublisher/v3/androidpublisher-gen.go b/androidpublisher/v3/androidpublisher-gen.go index 42e52c54ffc..340d5bc4f6b 100644 --- a/androidpublisher/v3/androidpublisher-gen.go +++ b/androidpublisher/v3/androidpublisher-gen.go @@ -4292,8 +4292,7 @@ func (s OfferDetails) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// OfferTag: Represents a custom tag specified for base plans and subscription -// offers. +// OfferTag: Represents a custom tag specified for a product offer. type OfferTag struct { // Tag: Must conform with RFC-1034. That is, this string can only contain // lower-case letters (a-z), numbers (0-9), and hyphens (-), and be at most 20 diff --git a/authorizedbuyersmarketplace/v1/authorizedbuyersmarketplace-api.json b/authorizedbuyersmarketplace/v1/authorizedbuyersmarketplace-api.json index c8be7c99915..49f2aa6c700 100644 --- a/authorizedbuyersmarketplace/v1/authorizedbuyersmarketplace-api.json +++ b/authorizedbuyersmarketplace/v1/authorizedbuyersmarketplace-api.json @@ -1367,7 +1367,7 @@ } } }, - "revision": "20241120", + "revision": "20250107", "rootUrl": "https://authorizedbuyersmarketplace.googleapis.com/", "schemas": { "AcceptProposalRequest": { @@ -1466,6 +1466,11 @@ "readOnly": true, "type": "string" }, + "dealOwnerSeatId": { + "description": "Output only. If set, this field contains the DSP specific seat id set by the media planner account that is considered the owner of this deal. The seat ID is in the calling DSP's namespace.", + "readOnly": true, + "type": "string" + }, "description": { "description": "Output only. A description of the auction package.", "readOnly": true, @@ -1476,7 +1481,7 @@ "type": "string" }, "eligibleSeatIds": { - "description": "Output only. If set, this field contains the list of DSP specific seat ids set by media planners that are eligible to transact on this deal. The seat ID is in the calling DSP's namespace.", + "description": "Output only. If set, this field identifies a seat that the media planner selected as the owner of this auction package. This is a seat ID in the DSP's namespace that was provided to the media planner.", "items": { "type": "string" }, diff --git a/authorizedbuyersmarketplace/v1/authorizedbuyersmarketplace-gen.go b/authorizedbuyersmarketplace/v1/authorizedbuyersmarketplace-gen.go index e8690b7bee2..7af42bf37e9 100644 --- a/authorizedbuyersmarketplace/v1/authorizedbuyersmarketplace-gen.go +++ b/authorizedbuyersmarketplace/v1/authorizedbuyersmarketplace-gen.go @@ -406,13 +406,17 @@ type AuctionPackage struct { // Creator: Output only. The buyer that created this auction package. Format: // `buyers/{buyerAccountId}` Creator string `json:"creator,omitempty"` + // DealOwnerSeatId: Output only. If set, this field contains the DSP specific + // seat id set by the media planner account that is considered the owner of + // this deal. The seat ID is in the calling DSP's namespace. + DealOwnerSeatId string `json:"dealOwnerSeatId,omitempty"` // Description: Output only. A description of the auction package. Description string `json:"description,omitempty"` // DisplayName: The display_name assigned to the auction package. DisplayName string `json:"displayName,omitempty"` - // EligibleSeatIds: Output only. If set, this field contains the list of DSP - // specific seat ids set by media planners that are eligible to transact on - // this deal. The seat ID is in the calling DSP's namespace. + // EligibleSeatIds: Output only. If set, this field identifies a seat that the + // media planner selected as the owner of this auction package. This is a seat + // ID in the DSP's namespace that was provided to the media planner. EligibleSeatIds []string `json:"eligibleSeatIds,omitempty"` // Name: Immutable. The unique identifier for the auction package. Format: // `buyers/{accountId}/auctionPackages/{auctionPackageId}` The diff --git a/authorizedbuyersmarketplace/v1alpha/authorizedbuyersmarketplace-api.json b/authorizedbuyersmarketplace/v1alpha/authorizedbuyersmarketplace-api.json index ded89f65725..3ea191d8d85 100644 --- a/authorizedbuyersmarketplace/v1alpha/authorizedbuyersmarketplace-api.json +++ b/authorizedbuyersmarketplace/v1alpha/authorizedbuyersmarketplace-api.json @@ -1550,7 +1550,7 @@ } } }, - "revision": "20241120", + "revision": "20250107", "rootUrl": "https://authorizedbuyersmarketplace.googleapis.com/", "schemas": { "AcceptProposalRequest": { @@ -1655,6 +1655,11 @@ "readOnly": true, "type": "string" }, + "dealOwnerSeatId": { + "description": "Output only. If set, this field contains the DSP specific seat id set by the media planner account that is considered the owner of this deal. The seat ID is in the calling DSP's namespace.", + "readOnly": true, + "type": "string" + }, "description": { "description": "Output only. A description of the auction package.", "readOnly": true, @@ -1665,7 +1670,7 @@ "type": "string" }, "eligibleSeatIds": { - "description": "Output only. If set, this field contains the list of DSP specific seat ids set by media planners that are eligible to transact on this deal. The seat ID is in the calling DSP's namespace.", + "description": "Output only. If set, this field identifies a seat that the media planner selected as the owner of this auction package. This is a seat ID in the DSP's namespace that was provided to the media planner.", "items": { "type": "string" }, diff --git a/authorizedbuyersmarketplace/v1alpha/authorizedbuyersmarketplace-gen.go b/authorizedbuyersmarketplace/v1alpha/authorizedbuyersmarketplace-gen.go index 644ce5a7718..2b52ce79ec4 100644 --- a/authorizedbuyersmarketplace/v1alpha/authorizedbuyersmarketplace-gen.go +++ b/authorizedbuyersmarketplace/v1alpha/authorizedbuyersmarketplace-gen.go @@ -422,13 +422,17 @@ type AuctionPackage struct { // Creator: Output only. The buyer that created this auction package. Format: // `buyers/{buyerAccountId}` Creator string `json:"creator,omitempty"` + // DealOwnerSeatId: Output only. If set, this field contains the DSP specific + // seat id set by the media planner account that is considered the owner of + // this deal. The seat ID is in the calling DSP's namespace. + DealOwnerSeatId string `json:"dealOwnerSeatId,omitempty"` // Description: Output only. A description of the auction package. Description string `json:"description,omitempty"` // DisplayName: The display_name assigned to the auction package. DisplayName string `json:"displayName,omitempty"` - // EligibleSeatIds: Output only. If set, this field contains the list of DSP - // specific seat ids set by media planners that are eligible to transact on - // this deal. The seat ID is in the calling DSP's namespace. + // EligibleSeatIds: Output only. If set, this field identifies a seat that the + // media planner selected as the owner of this auction package. This is a seat + // ID in the DSP's namespace that was provided to the media planner. EligibleSeatIds []string `json:"eligibleSeatIds,omitempty"` // Name: Immutable. The unique identifier for the auction package. Format: // `buyers/{accountId}/auctionPackages/{auctionPackageId}` The diff --git a/bigquery/v2/bigquery-api.json b/bigquery/v2/bigquery-api.json index 286f3cbe44b..88d45fcbc3d 100644 --- a/bigquery/v2/bigquery-api.json +++ b/bigquery/v2/bigquery-api.json @@ -529,7 +529,7 @@ "type": "string" }, "location": { - "description": "The geographic location of the job. You must specify the location to run the job for the following scenarios: * If the location to run a job is not in the `us` or the `eu` multi-regional location * If the job's location is in a single region (for example, `us-central1`) For more information, see https://cloud.google.com/bigquery/docs/locations#specifying_your_location.", + "description": "The geographic location of the job. You must [specify the location](https://cloud.google.com/bigquery/docs/locations#specify_locations) to run the job for the following scenarios: * If the location to run a job is not in the `us` or the `eu` multi-regional location * If the job's location is in a single region (for example, `us-central1`)", "location": "query", "type": "string" }, @@ -568,7 +568,7 @@ "type": "string" }, "location": { - "description": "The geographic location of the job. Required. See details at: https://cloud.google.com/bigquery/docs/locations#specifying_your_location.", + "description": "The geographic location of the job. Required. For more information, see how to [specify locations](https://cloud.google.com/bigquery/docs/locations#specify_locations).", "location": "query", "type": "string" }, @@ -604,7 +604,7 @@ "type": "string" }, "location": { - "description": "The geographic location of the job. You must specify the location to run the job for the following scenarios: * If the location to run a job is not in the `us` or the `eu` multi-regional location * If the job's location is in a single region (for example, `us-central1`) For more information, see https://cloud.google.com/bigquery/docs/locations#specifying_your_location.", + "description": "The geographic location of the job. You must specify the location to run the job for the following scenarios: * If the location to run a job is not in the `us` or the `eu` multi-regional location * If the job's location is in a single region (for example, `us-central1`) For more information, see how to [specify locations](https://cloud.google.com/bigquery/docs/locations#specify_locations).", "location": "query", "type": "string" }, @@ -649,7 +649,7 @@ "type": "string" }, "location": { - "description": "The geographic location of the job. You must specify the location to run the job for the following scenarios: * If the location to run a job is not in the `us` or the `eu` multi-regional location * If the job's location is in a single region (for example, `us-central1`) For more information, see https://cloud.google.com/bigquery/docs/locations#specifying_your_location.", + "description": "The geographic location of the job. You must specify the location to run the job for the following scenarios: * If the location to run a job is not in the `us` or the `eu` multi-regional location * If the job's location is in a single region (for example, `us-central1`) For more information, see how to [specify locations](https://cloud.google.com/bigquery/docs/locations#specify_locations).", "location": "query", "type": "string" }, @@ -2009,7 +2009,7 @@ } } }, - "revision": "20241115", + "revision": "20241222", "rootUrl": "https://bigquery.googleapis.com/", "schemas": { "AggregateClassificationMetrics": { @@ -3019,7 +3019,7 @@ "id": "Clustering", "properties": { "fields": { - "description": "One or more fields on which data should be clustered. Only top-level, non-repeated, simple-type fields are supported. The ordering of the clustering fields should be prioritized from most to least important for filtering purposes. Additional information on limitations can be found here: https://cloud.google.com/bigquery/docs/creating-clustered-tables#limitations", + "description": "One or more fields on which data should be clustered. Only top-level, non-repeated, simple-type fields are supported. The ordering of the clustering fields should be prioritized from most to least important for filtering purposes. For additional information, see [Introduction to clustered tables](https://cloud.google.com/bigquery/docs/clustered-tables#limitations).", "items": { "type": "string" }, @@ -4015,7 +4015,7 @@ "type": "object" }, "ExternalCatalogDatasetOptions": { - "description": "Options defining open source compatible datasets living in the BigQuery catalog. Contains metadata of open source database, schema or namespace represented by the current dataset.", + "description": "Options defining open source compatible datasets living in the BigQuery catalog. Contains metadata of open source database, schema, or namespace represented by the current dataset.", "id": "ExternalCatalogDatasetOptions", "properties": { "defaultStorageLocationUri": { @@ -4026,25 +4026,25 @@ "additionalProperties": { "type": "string" }, - "description": "Optional. A map of key value pairs defining the parameters and properties of the open source schema. Maximum size of 2Mib.", + "description": "Optional. A map of key value pairs defining the parameters and properties of the open source schema. Maximum size of 2MiB.", "type": "object" } }, "type": "object" }, "ExternalCatalogTableOptions": { - "description": "Metadata about open source compatible table. The fields contained in these options correspond to hive metastore's table level properties.", + "description": "Metadata about open source compatible table. The fields contained in these options correspond to Hive metastore's table-level properties.", "id": "ExternalCatalogTableOptions", "properties": { "connectionId": { - "description": "Optional. The connection specifying the credentials to be used to read external storage, such as Azure Blob, Cloud Storage, or S3. The connection is needed to read the open source table from BigQuery Engine. The connection_id can have the form `..` or `projects//locations//connections/`.", + "description": "Optional. A connection ID that specifies the credentials to be used to read external storage, such as Azure Blob, Cloud Storage, or Amazon S3. This connection is needed to read the open source table from BigQuery. The connection_id format must be either `..` or `projects//locations//connections/`.", "type": "string" }, "parameters": { "additionalProperties": { "type": "string" }, - "description": "Optional. A map of key value pairs defining the parameters and properties of the open source table. Corresponds with hive meta store table parameters. Maximum size of 4Mib.", + "description": "Optional. A map of the key-value pairs defining the parameters and properties of the open source table. Corresponds with Hive metastore table parameters. Maximum size of 4MiB.", "type": "object" }, "storageDescriptor": { @@ -5934,7 +5934,7 @@ "readOnly": true }, "statementType": { - "description": "Output only. The type of query statement, if valid. Possible values: * `SELECT`: [`SELECT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#select_list) statement. * `ASSERT`: [`ASSERT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/debugging-statements#assert) statement. * `INSERT`: [`INSERT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/dml-syntax#insert_statement) statement. * `UPDATE`: [`UPDATE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#update_statement) statement. * `DELETE`: [`DELETE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language) statement. * `MERGE`: [`MERGE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language) statement. * `CREATE_TABLE`: [`CREATE TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_table_statement) statement, without `AS SELECT`. * `CREATE_TABLE_AS_SELECT`: [`CREATE TABLE AS SELECT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#query_statement) statement. * `CREATE_VIEW`: [`CREATE VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_view_statement) statement. * `CREATE_MODEL`: [`CREATE MODEL`](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-create#create_model_statement) statement. * `CREATE_MATERIALIZED_VIEW`: [`CREATE MATERIALIZED VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_materialized_view_statement) statement. * `CREATE_FUNCTION`: [`CREATE FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_function_statement) statement. * `CREATE_TABLE_FUNCTION`: [`CREATE TABLE FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_table_function_statement) statement. * `CREATE_PROCEDURE`: [`CREATE PROCEDURE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_procedure) statement. * `CREATE_ROW_ACCESS_POLICY`: [`CREATE ROW ACCESS POLICY`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_row_access_policy_statement) statement. * `CREATE_SCHEMA`: [`CREATE SCHEMA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_schema_statement) statement. * `CREATE_SNAPSHOT_TABLE`: [`CREATE SNAPSHOT TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_snapshot_table_statement) statement. * `CREATE_SEARCH_INDEX`: [`CREATE SEARCH INDEX`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_search_index_statement) statement. * `DROP_TABLE`: [`DROP TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_statement) statement. * `DROP_EXTERNAL_TABLE`: [`DROP EXTERNAL TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_external_table_statement) statement. * `DROP_VIEW`: [`DROP VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_view_statement) statement. * `DROP_MODEL`: [`DROP MODEL`](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-drop-model) statement. * `DROP_MATERIALIZED_VIEW`: [`DROP MATERIALIZED VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_materialized_view_statement) statement. * `DROP_FUNCTION` : [`DROP FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_function_statement) statement. * `DROP_TABLE_FUNCTION` : [`DROP TABLE FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_function) statement. * `DROP_PROCEDURE`: [`DROP PROCEDURE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_procedure_statement) statement. * `DROP_SEARCH_INDEX`: [`DROP SEARCH INDEX`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_search_index) statement. * `DROP_SCHEMA`: [`DROP SCHEMA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_schema_statement) statement. * `DROP_SNAPSHOT_TABLE`: [`DROP SNAPSHOT TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_snapshot_table_statement) statement. * `DROP_ROW_ACCESS_POLICY`: [`DROP [ALL] ROW ACCESS POLICY|POLICIES`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_row_access_policy_statement) statement. * `ALTER_TABLE`: [`ALTER TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_table_set_options_statement) statement. * `ALTER_VIEW`: [`ALTER VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_view_set_options_statement) statement. * `ALTER_MATERIALIZED_VIEW`: [`ALTER MATERIALIZED VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_materialized_view_set_options_statement) statement. * `ALTER_SCHEMA`: [`ALTER SCHEMA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#aalter_schema_set_options_statement) statement. * `SCRIPT`: [`SCRIPT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/procedural-language). * `TRUNCATE_TABLE`: [`TRUNCATE TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/dml-syntax#truncate_table_statement) statement. * `CREATE_EXTERNAL_TABLE`: [`CREATE EXTERNAL TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_external_table_statement) statement. * `EXPORT_DATA`: [`EXPORT DATA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/other-statements#export_data_statement) statement. * `EXPORT_MODEL`: [`EXPORT MODEL`](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-export-model) statement. * `LOAD_DATA`: [`LOAD DATA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/other-statements#load_data_statement) statement. * `CALL`: [`CALL`](https://cloud.google.com/bigquery/docs/reference/standard-sql/procedural-language#call) statement.", + "description": "Output only. The type of query statement, if valid. Possible values: * `SELECT`: [`SELECT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#select_list) statement. * `ASSERT`: [`ASSERT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/debugging-statements#assert) statement. * `INSERT`: [`INSERT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/dml-syntax#insert_statement) statement. * `UPDATE`: [`UPDATE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/dml-syntax#update_statement) statement. * `DELETE`: [`DELETE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language) statement. * `MERGE`: [`MERGE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language) statement. * `CREATE_TABLE`: [`CREATE TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_table_statement) statement, without `AS SELECT`. * `CREATE_TABLE_AS_SELECT`: [`CREATE TABLE AS SELECT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_table_statement) statement. * `CREATE_VIEW`: [`CREATE VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_view_statement) statement. * `CREATE_MODEL`: [`CREATE MODEL`](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-create#create_model_statement) statement. * `CREATE_MATERIALIZED_VIEW`: [`CREATE MATERIALIZED VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_materialized_view_statement) statement. * `CREATE_FUNCTION`: [`CREATE FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_function_statement) statement. * `CREATE_TABLE_FUNCTION`: [`CREATE TABLE FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_table_function_statement) statement. * `CREATE_PROCEDURE`: [`CREATE PROCEDURE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_procedure) statement. * `CREATE_ROW_ACCESS_POLICY`: [`CREATE ROW ACCESS POLICY`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_row_access_policy_statement) statement. * `CREATE_SCHEMA`: [`CREATE SCHEMA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_schema_statement) statement. * `CREATE_SNAPSHOT_TABLE`: [`CREATE SNAPSHOT TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_snapshot_table_statement) statement. * `CREATE_SEARCH_INDEX`: [`CREATE SEARCH INDEX`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_search_index_statement) statement. * `DROP_TABLE`: [`DROP TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_statement) statement. * `DROP_EXTERNAL_TABLE`: [`DROP EXTERNAL TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_external_table_statement) statement. * `DROP_VIEW`: [`DROP VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_view_statement) statement. * `DROP_MODEL`: [`DROP MODEL`](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-drop-model) statement. * `DROP_MATERIALIZED_VIEW`: [`DROP MATERIALIZED VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_materialized_view_statement) statement. * `DROP_FUNCTION` : [`DROP FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_function_statement) statement. * `DROP_TABLE_FUNCTION` : [`DROP TABLE FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_function) statement. * `DROP_PROCEDURE`: [`DROP PROCEDURE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_procedure_statement) statement. * `DROP_SEARCH_INDEX`: [`DROP SEARCH INDEX`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_search_index) statement. * `DROP_SCHEMA`: [`DROP SCHEMA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_schema_statement) statement. * `DROP_SNAPSHOT_TABLE`: [`DROP SNAPSHOT TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_snapshot_table_statement) statement. * `DROP_ROW_ACCESS_POLICY`: [`DROP [ALL] ROW ACCESS POLICY|POLICIES`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_row_access_policy_statement) statement. * `ALTER_TABLE`: [`ALTER TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_table_set_options_statement) statement. * `ALTER_VIEW`: [`ALTER VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_view_set_options_statement) statement. * `ALTER_MATERIALIZED_VIEW`: [`ALTER MATERIALIZED VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_materialized_view_set_options_statement) statement. * `ALTER_SCHEMA`: [`ALTER SCHEMA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_schema_set_options_statement) statement. * `SCRIPT`: [`SCRIPT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/procedural-language). * `TRUNCATE_TABLE`: [`TRUNCATE TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/dml-syntax#truncate_table_statement) statement. * `CREATE_EXTERNAL_TABLE`: [`CREATE EXTERNAL TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_external_table_statement) statement. * `EXPORT_DATA`: [`EXPORT DATA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/other-statements#export_data_statement) statement. * `EXPORT_MODEL`: [`EXPORT MODEL`](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-export-model) statement. * `LOAD_DATA`: [`LOAD DATA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/other-statements#load_data_statement) statement. * `CALL`: [`CALL`](https://cloud.google.com/bigquery/docs/reference/standard-sql/procedural-language#call) statement.", "readOnly": true, "type": "string" }, @@ -6346,7 +6346,7 @@ "View has no cached data because it has not refreshed yet.", "The estimated cost of the view is more expensive than another view or the base table. Note: The estimate cost might not match the billed cost.", "View has no cached data because a base table is truncated.", - "View is invalidated because of a data change in one or more base tables. It could be any recent change if the [`max_staleness`](https://cloud.google.com/bigquery/docs/materialized-views-create#max_staleness) option is not set for the view, or otherwise any change outside of the staleness window.", + "View is invalidated because of a data change in one or more base tables. It could be any recent change if the [`maxStaleness`](https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#Table.FIELDS.max_staleness) option is not set for the view, or otherwise any change outside of the staleness window.", "View is invalidated because a base table's partition expiration has changed.", "View is invalidated because a base table's partition has expired.", "View is invalidated because a base table has an incompatible metadata change.", @@ -7219,7 +7219,7 @@ "type": "object" }, "location": { - "description": "The geographic location where the job should run. See details at https://cloud.google.com/bigquery/docs/locations#specifying_your_location.", + "description": "The geographic location where the job should run. For more information, see how to [specify locations](https://cloud.google.com/bigquery/docs/locations#specify_locations).", "type": "string" }, "maxResults": { @@ -9465,7 +9465,7 @@ "type": "string" }, "dataSplitColumn": { - "description": "The column to split data with. This column won't be used as a feature. 1. When data_split_method is CUSTOM, the corresponding column should be boolean. The rows with true value tag are eval data, and the false are training data. 2. When data_split_method is SEQ, the first DATA_SPLIT_EVAL_FRACTION rows (from smallest to largest) in the corresponding column are used as training data, and the rest are eval data. It respects the order in Orderable data types: https://cloud.google.com/bigquery/docs/reference/standard-sql/data-types#data-type-properties", + "description": "The column to split data with. This column won't be used as a feature. 1. When data_split_method is CUSTOM, the corresponding column should be boolean. The rows with true value tag are eval data, and the false are training data. 2. When data_split_method is SEQ, the first DATA_SPLIT_EVAL_FRACTION rows (from smallest to largest) in the corresponding column are used as training data, and the rest are eval data. It respects the order in Orderable data types: https://cloud.google.com/bigquery/docs/reference/standard-sql/data-types#data_type_properties", "type": "string" }, "dataSplitEvalFraction": { diff --git a/bigquery/v2/bigquery-gen.go b/bigquery/v2/bigquery-gen.go index cfdfe035588..25a53a0ebf5 100644 --- a/bigquery/v2/bigquery-gen.go +++ b/bigquery/v2/bigquery-gen.go @@ -1627,8 +1627,9 @@ type Clustering struct { // Fields: One or more fields on which data should be clustered. Only // top-level, non-repeated, simple-type fields are supported. The ordering of // the clustering fields should be prioritized from most to least important for - // filtering purposes. Additional information on limitations can be found here: - // https://cloud.google.com/bigquery/docs/creating-clustered-tables#limitations + // filtering purposes. For additional information, see Introduction to + // clustered tables + // (https://cloud.google.com/bigquery/docs/clustered-tables#limitations). Fields []string `json:"fields,omitempty"` // ForceSendFields is a list of field names (e.g. "Fields") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -3070,14 +3071,14 @@ func (s Expr) MarshalJSON() ([]byte, error) { // ExternalCatalogDatasetOptions: Options defining open source compatible // datasets living in the BigQuery catalog. Contains metadata of open source -// database, schema or namespace represented by the current dataset. +// database, schema, or namespace represented by the current dataset. type ExternalCatalogDatasetOptions struct { // DefaultStorageLocationUri: Optional. The storage location URI for all tables // in the dataset. Equivalent to hive metastore's database locationUri. Maximum // length of 1024 characters. DefaultStorageLocationUri string `json:"defaultStorageLocationUri,omitempty"` // Parameters: Optional. A map of key value pairs defining the parameters and - // properties of the open source schema. Maximum size of 2Mib. + // properties of the open source schema. Maximum size of 2MiB. Parameters map[string]string `json:"parameters,omitempty"` // ForceSendFields is a list of field names (e.g. "DefaultStorageLocationUri") // to unconditionally include in API requests. By default, fields with empty or @@ -3098,17 +3099,18 @@ func (s ExternalCatalogDatasetOptions) MarshalJSON() ([]byte, error) { } // ExternalCatalogTableOptions: Metadata about open source compatible table. -// The fields contained in these options correspond to hive metastore's table -// level properties. +// The fields contained in these options correspond to Hive metastore's +// table-level properties. type ExternalCatalogTableOptions struct { - // ConnectionId: Optional. The connection specifying the credentials to be used - // to read external storage, such as Azure Blob, Cloud Storage, or S3. The - // connection is needed to read the open source table from BigQuery Engine. The - // connection_id can have the form `..` or `projects//locations//connections/`. + // ConnectionId: Optional. A connection ID that specifies the credentials to be + // used to read external storage, such as Azure Blob, Cloud Storage, or Amazon + // S3. This connection is needed to read the open source table from BigQuery. + // The connection_id format must be either `..` or + // `projects//locations//connections/`. ConnectionId string `json:"connectionId,omitempty"` - // Parameters: Optional. A map of key value pairs defining the parameters and - // properties of the open source table. Corresponds with hive meta store table - // parameters. Maximum size of 4Mib. + // Parameters: Optional. A map of the key-value pairs defining the parameters + // and properties of the open source table. Corresponds with Hive metastore + // table parameters. Maximum size of 4MiB. Parameters map[string]string `json:"parameters,omitempty"` // StorageDescriptor: Optional. A storage descriptor containing information // about the physical storage of this table. @@ -5284,7 +5286,7 @@ type JobStatistics2 struct { // statement. * `INSERT`: `INSERT` // (https://cloud.google.com/bigquery/docs/reference/standard-sql/dml-syntax#insert_statement) // statement. * `UPDATE`: `UPDATE` - // (https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#update_statement) + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/dml-syntax#update_statement) // statement. * `DELETE`: `DELETE` // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language) // statement. * `MERGE`: `MERGE` @@ -5293,7 +5295,7 @@ type JobStatistics2 struct { // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_table_statement) // statement, without `AS SELECT`. * `CREATE_TABLE_AS_SELECT`: `CREATE TABLE AS // SELECT` - // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#query_statement) + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_table_statement) // statement. * `CREATE_VIEW`: `CREATE VIEW` // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_view_statement) // statement. * `CREATE_MODEL`: `CREATE MODEL` @@ -5346,7 +5348,7 @@ type JobStatistics2 struct { // statement. * `ALTER_MATERIALIZED_VIEW`: `ALTER MATERIALIZED VIEW` // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_materialized_view_set_options_statement) // statement. * `ALTER_SCHEMA`: `ALTER SCHEMA` - // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#aalter_schema_set_options_statement) + // (https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_schema_set_options_statement) // statement. * `SCRIPT`: `SCRIPT` // (https://cloud.google.com/bigquery/docs/reference/standard-sql/procedural-language). // * `TRUNCATE_TABLE`: `TRUNCATE TABLE` @@ -5859,9 +5861,9 @@ type MaterializedView struct { // truncated. // "BASE_TABLE_DATA_CHANGE" - View is invalidated because of a data change in // one or more base tables. It could be any recent change if the - // [`max_staleness`](https://cloud.google.com/bigquery/docs/materialized-views-c - // reate#max_staleness) option is not set for the view, or otherwise any change - // outside of the staleness window. + // [`maxStaleness`](https://cloud.google.com/bigquery/docs/reference/rest/v2/tab + // les#Table.FIELDS.max_staleness) option is not set for the view, or otherwise + // any change outside of the staleness window. // "BASE_TABLE_PARTITION_EXPIRATION_CHANGE" - View is invalidated because a // base table's partition expiration has changed. // "BASE_TABLE_EXPIRED_PARTITION" - View is invalidated because a base @@ -6929,8 +6931,9 @@ type QueryRequest struct { // must start with a letter and each label in the list must have a different // key. Labels map[string]string `json:"labels,omitempty"` - // Location: The geographic location where the job should run. See details at - // https://cloud.google.com/bigquery/docs/locations#specifying_your_location. + // Location: The geographic location where the job should run. For more + // information, see how to specify locations + // (https://cloud.google.com/bigquery/docs/locations#specify_locations). Location string `json:"location,omitempty"` // MaxResults: Optional. The maximum number of rows of data to return per page // of results. Setting this flag to a small value such as 1000 and then paging @@ -9625,7 +9628,7 @@ type TrainingOptions struct { // DATA_SPLIT_EVAL_FRACTION rows (from smallest to largest) in the // corresponding column are used as training data, and the rest are eval data. // It respects the order in Orderable data types: - // https://cloud.google.com/bigquery/docs/reference/standard-sql/data-types#data-type-properties + // https://cloud.google.com/bigquery/docs/reference/standard-sql/data-types#data_type_properties DataSplitColumn string `json:"dataSplitColumn,omitempty"` // DataSplitEvalFraction: The fraction of evaluation data over the whole input // data. The rest of data will be used as training data. The format should be @@ -11291,11 +11294,11 @@ func (r *JobsService) Cancel(projectId string, jobId string) *JobsCancelCall { } // Location sets the optional parameter "location": The geographic location of -// the job. You must specify the location to run the job for the following -// scenarios: * If the location to run a job is not in the `us` or the `eu` -// multi-regional location * If the job's location is in a single region (for -// example, `us-central1`) For more information, see -// https://cloud.google.com/bigquery/docs/locations#specifying_your_location. +// the job. You must specify the location +// (https://cloud.google.com/bigquery/docs/locations#specify_locations) to run +// the job for the following scenarios: * If the location to run a job is not +// in the `us` or the `eu` multi-regional location * If the job's location is +// in a single region (for example, `us-central1`) func (c *JobsCancelCall) Location(location string) *JobsCancelCall { c.urlParams_.Set("location", location) return c @@ -11408,8 +11411,8 @@ func (r *JobsService) Delete(projectId string, jobId string) *JobsDeleteCall { } // Location sets the optional parameter "location": The geographic location of -// the job. Required. See details at: -// https://cloud.google.com/bigquery/docs/locations#specifying_your_location. +// the job. Required. For more information, see how to specify locations +// (https://cloud.google.com/bigquery/docs/locations#specify_locations). func (c *JobsDeleteCall) Location(location string) *JobsDeleteCall { c.urlParams_.Set("location", location) return c @@ -11499,8 +11502,8 @@ func (r *JobsService) Get(projectId string, jobId string) *JobsGetCall { // the job. You must specify the location to run the job for the following // scenarios: * If the location to run a job is not in the `us` or the `eu` // multi-regional location * If the job's location is in a single region (for -// example, `us-central1`) For more information, see -// https://cloud.google.com/bigquery/docs/locations#specifying_your_location. +// example, `us-central1`) For more information, see how to specify locations +// (https://cloud.google.com/bigquery/docs/locations#specify_locations). func (c *JobsGetCall) Location(location string) *JobsGetCall { c.urlParams_.Set("location", location) return c @@ -11631,8 +11634,8 @@ func (c *JobsGetQueryResultsCall) FormatOptionsUseInt64Timestamp(formatOptionsUs // the job. You must specify the location to run the job for the following // scenarios: * If the location to run a job is not in the `us` or the `eu` // multi-regional location * If the job's location is in a single region (for -// example, `us-central1`) For more information, see -// https://cloud.google.com/bigquery/docs/locations#specifying_your_location. +// example, `us-central1`) For more information, see how to specify locations +// (https://cloud.google.com/bigquery/docs/locations#specify_locations). func (c *JobsGetQueryResultsCall) Location(location string) *JobsGetQueryResultsCall { c.urlParams_.Set("location", location) return c diff --git a/chat/v1/chat-api.json b/chat/v1/chat-api.json index 561b0c5536e..d564c4bb134 100644 --- a/chat/v1/chat-api.json +++ b/chat/v1/chat-api.json @@ -1344,7 +1344,7 @@ } } }, - "revision": "20241217", + "revision": "20241229", "rootUrl": "https://chat.googleapis.com/", "schemas": { "AccessSettings": { @@ -2169,6 +2169,10 @@ "description": "An action that describes the behavior when the form is submitted. For example, you can invoke an Apps Script script to handle the form. If the action is triggered, the form values are sent to the server. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", "id": "GoogleAppsCardV1Action", "properties": { + "allWidgetsAreRequired": { + "description": "Optional. If this is true, then all widgets are considered required by this action. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", + "type": "boolean" + }, "function": { "description": "A custom function to invoke when the containing element is clicked or otherwise activated. For example usage, see [Read form data](https://developers.google.com/workspace/chat/read-form-data).", "type": "string" @@ -2207,6 +2211,13 @@ "persistValues": { "description": "Indicates whether form values persist after the action. The default value is `false`. If `true`, form values remain after the action is triggered. To let the user make changes while the action is being processed, set [`LoadIndicator`](https://developers.google.com/workspace/add-ons/reference/rpc/google.apps.card.v1#loadindicator) to `NONE`. For [card messages](https://developers.google.com/workspace/chat/api/guides/v1/messages/create#create) in Chat apps, you must also set the action's [`ResponseType`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages#responsetype) to `UPDATE_MESSAGE` and use the same [`card_id`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages#CardWithId) from the card that contained the action. If `false`, the form values are cleared when the action is triggered. To prevent the user from making changes while the action is being processed, set [`LoadIndicator`](https://developers.google.com/workspace/add-ons/reference/rpc/google.apps.card.v1#loadindicator) to `SPINNER`.", "type": "boolean" + }, + "requiredWidgets": { + "description": "Optional. Fill this list with the names of widgets that this Action needs for a valid submission. If the widgets listed here don't have a value when this Action is invoked, the form submission is aborted. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" @@ -2650,7 +2661,7 @@ "type": "object" }, "GoogleAppsCardV1DateTimePicker": { - "description": "Lets users input a date, a time, or both a date and a time. For an example in Google Chat apps, see [Let a user pick a date and time](https://developers.google.com/workspace/chat/design-interactive-card-dialog#let_a_user_pick_a_date_and_time). Users can input text or use the picker to select dates and times. If users input an invalid date or time, the picker shows an error that prompts users to input the information correctly. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", + "description": "Lets users input a date, a time, or both a date and a time. Supports form submission validation. When `Action.all_widgets_are_required` is set to `true` or this widget is specified in `Action.required_widgets`, the submission action is blocked unless a value is selected. For an example in Google Chat apps, see [Let a user pick a date and time](https://developers.google.com/workspace/chat/design-interactive-card-dialog#let_a_user_pick_a_date_and_time). Users can input text or use the picker to select dates and times. If users input an invalid date or time, the picker shows an error that prompts users to input the information correctly. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", "id": "GoogleAppsCardV1DateTimePicker", "properties": { "label": { @@ -3119,7 +3130,7 @@ "type": "object" }, "GoogleAppsCardV1SelectionInput": { - "description": "A widget that creates one or more UI items that users can select. For example, a dropdown menu or checkboxes. You can use this widget to collect data that can be predicted or enumerated. For an example in Google Chat apps, see [Add selectable UI elements](/workspace/chat/design-interactive-card-dialog#add_selectable_ui_elements). Chat apps can process the value of items that users select or input. For details about working with form inputs, see [Receive form data](https://developers.google.com/workspace/chat/read-form-data). To collect undefined or abstract data from users, use the TextInput widget. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", + "description": "A widget that creates one or more UI items that users can select. Supports form submission validation for `dropdown` and `multiselect` menus only. When `Action.all_widgets_are_required` is set to `true` or this widget is specified in `Action.required_widgets`, the submission action is blocked unless a value is selected. For example, a dropdown menu or checkboxes. You can use this widget to collect data that can be predicted or enumerated. For an example in Google Chat apps, see [Add selectable UI elements](/workspace/chat/design-interactive-card-dialog#add_selectable_ui_elements). Chat apps can process the value of items that users select or input. For details about working with form inputs, see [Receive form data](https://developers.google.com/workspace/chat/read-form-data). To collect undefined or abstract data from users, use the TextInput widget. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", "id": "GoogleAppsCardV1SelectionInput", "properties": { "externalDataSource": { @@ -3270,7 +3281,7 @@ "type": "object" }, "GoogleAppsCardV1TextInput": { - "description": "A field in which users can enter text. Supports suggestions and on-change actions. For an example in Google Chat apps, see [Add a field in which a user can enter text](https://developers.google.com/workspace/chat/design-interactive-card-dialog#add_a_field_in_which_a_user_can_enter_text). Chat apps receive and can process the value of entered text during form input events. For details about working with form inputs, see [Receive form data](https://developers.google.com/workspace/chat/read-form-data). When you need to collect undefined or abstract data from users, use a text input. To collect defined or enumerated data from users, use the SelectionInput widget. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", + "description": "A field in which users can enter text. Supports suggestions and on-change actions. Supports form submission validation. When `Action.all_widgets_are_required` is set to `true` or this widget is specified in `Action.required_widgets`, the submission action is blocked unless a value is entered. For an example in Google Chat apps, see [Add a field in which a user can enter text](https://developers.google.com/workspace/chat/design-interactive-card-dialog#add_a_field_in_which_a_user_can_enter_text). Chat apps receive and can process the value of entered text during form input events. For details about working with form inputs, see [Receive form data](https://developers.google.com/workspace/chat/read-form-data). When you need to collect undefined or abstract data from users, use a text input. To collect defined or enumerated data from users, use the SelectionInput widget. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", "id": "GoogleAppsCardV1TextInput", "properties": { "autoCompleteAction": { @@ -3313,6 +3324,10 @@ ], "type": "string" }, + "validation": { + "$ref": "GoogleAppsCardV1Validation", + "description": "Specify the input format validation necessary for this text field. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):" + }, "value": { "description": "The value entered by a user, returned as part of a form input event. For details about working with form inputs, see [Receive form data](https://developers.google.com/workspace/chat/read-form-data).", "type": "string" @@ -3336,6 +3351,38 @@ }, "type": "object" }, + "GoogleAppsCardV1Validation": { + "description": "Represents the necessary data for validating the widget it's attached to. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", + "id": "GoogleAppsCardV1Validation", + "properties": { + "characterLimit": { + "description": "Specify the character limit for text input widgets. Note that this is only used for text input and is ignored for other widgets. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", + "format": "int32", + "type": "integer" + }, + "inputType": { + "description": "Specify the type of the input widgets. [Google Workspace Add-ons and Chat apps](https://developers.google.com/workspace/extend):", + "enum": [ + "INPUT_TYPE_UNSPECIFIED", + "TEXT", + "INTEGER", + "FLOAT", + "EMAIL", + "EMOJI_PICKER" + ], + "enumDescriptions": [ + "Unspecified type. Do not use.", + "Regular text that accepts all characters.", + "An integer value.", + "A float value.", + "An email address.", + "A emoji selected from system-provided emoji picker." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleAppsCardV1Widget": { "description": "Each card is made up of widgets. A widget is a composite object that can represent one of text, images, buttons, and other object types.", "id": "GoogleAppsCardV1Widget", @@ -4579,10 +4626,10 @@ }, "permissionSettings": { "$ref": "PermissionSettings", - "description": "Optional. Space permission settings for existing spaces. Input for updating exact space permission settings, where existing permission settings are replaced. Output lists current permission settings." + "description": "Optional. Space permission settings for existing spaces. Input for updating exact space permission settings, where existing permission settings are replaced. Output lists current permission settings. Reading and updating permission settings supports: - In [Developer Preview](https://developers.google.com/workspace/preview), [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with [administrator approval](https://support.google.com/a?p=chat-app-auth) with the `chat.app.spaces` scope. Only populated and settable when the Chat app created the space. - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)" }, "predefinedPermissionSettings": { - "description": "Optional. Input only. Predefined space permission settings, input only when creating a space. If the field is not set, a collaboration space is created. After you create the space, settings are populated in the `PermissionSettings` field.", + "description": "Optional. Input only. Predefined space permission settings, input only when creating a space. If the field is not set, a collaboration space is created. After you create the space, settings are populated in the `PermissionSettings` field. Setting predefined permission settings supports: - In [Developer Preview](https://developers.google.com/workspace/preview), [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with [administrator approval](https://support.google.com/a?p=chat-app-auth) with the `chat.app.spaces` or `chat.app.spaces.create` scopes. - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)", "enum": [ "PREDEFINED_PERMISSION_SETTINGS_UNSPECIFIED", "COLLABORATION_SPACE", diff --git a/chat/v1/chat-gen.go b/chat/v1/chat-gen.go index 4b1e4b46b71..7b242a17c0f 100644 --- a/chat/v1/chat-gen.go +++ b/chat/v1/chat-gen.go @@ -1665,6 +1665,10 @@ func (s FormAction) MarshalJSON() ([]byte, error) { // server. Google Workspace Add-ons and Chat apps // (https://developers.google.com/workspace/extend): type GoogleAppsCardV1Action struct { + // AllWidgetsAreRequired: Optional. If this is true, then all widgets are + // considered required by this action. Google Workspace Add-ons and Chat apps + // (https://developers.google.com/workspace/extend): + AllWidgetsAreRequired bool `json:"allWidgetsAreRequired,omitempty"` // Function: A custom function to invoke when the containing element is clicked // or otherwise activated. For example usage, see Read form data // (https://developers.google.com/workspace/chat/read-form-data). @@ -1718,15 +1722,21 @@ type GoogleAppsCardV1Action struct { // (https://developers.google.com/workspace/add-ons/reference/rpc/google.apps.card.v1#loadindicator) // to `SPINNER`. PersistValues bool `json:"persistValues,omitempty"` - // ForceSendFields is a list of field names (e.g. "Function") to + // RequiredWidgets: Optional. Fill this list with the names of widgets that + // this Action needs for a valid submission. If the widgets listed here don't + // have a value when this Action is invoked, the form submission is aborted. + // Google Workspace Add-ons and Chat apps + // (https://developers.google.com/workspace/extend): + RequiredWidgets []string `json:"requiredWidgets,omitempty"` + // ForceSendFields is a list of field names (e.g. "AllWidgetsAreRequired") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Function") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See + // NullFields is a list of field names (e.g. "AllWidgetsAreRequired") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -2403,8 +2413,11 @@ func (s GoogleAppsCardV1Columns) MarshalJSON() ([]byte, error) { } // GoogleAppsCardV1DateTimePicker: Lets users input a date, a time, or both a -// date and a time. For an example in Google Chat apps, see Let a user pick a -// date and time +// date and a time. Supports form submission validation. When +// `Action.all_widgets_are_required` is set to `true` or this widget is +// specified in `Action.required_widgets`, the submission action is blocked +// unless a value is selected. For an example in Google Chat apps, see Let a +// user pick a date and time // (https://developers.google.com/workspace/chat/design-interactive-card-dialog#let_a_user_pick_a_date_and_time). // Users can input text or use the picker to select dates and times. If users // input an invalid date or time, the picker shows an error that prompts users @@ -3099,9 +3112,13 @@ func (s GoogleAppsCardV1Section) MarshalJSON() ([]byte, error) { } // GoogleAppsCardV1SelectionInput: A widget that creates one or more UI items -// that users can select. For example, a dropdown menu or checkboxes. You can -// use this widget to collect data that can be predicted or enumerated. For an -// example in Google Chat apps, see Add selectable UI elements +// that users can select. Supports form submission validation for `dropdown` +// and `multiselect` menus only. When `Action.all_widgets_are_required` is set +// to `true` or this widget is specified in `Action.required_widgets`, the +// submission action is blocked unless a value is selected. For example, a +// dropdown menu or checkboxes. You can use this widget to collect data that +// can be predicted or enumerated. For an example in Google Chat apps, see Add +// selectable UI elements // (/workspace/chat/design-interactive-card-dialog#add_selectable_ui_elements). // Chat apps can process the value of items that users select or input. For // details about working with form inputs, see Receive form data @@ -3335,8 +3352,11 @@ func (s GoogleAppsCardV1SwitchControl) MarshalJSON() ([]byte, error) { } // GoogleAppsCardV1TextInput: A field in which users can enter text. Supports -// suggestions and on-change actions. For an example in Google Chat apps, see -// Add a field in which a user can enter text +// suggestions and on-change actions. Supports form submission validation. When +// `Action.all_widgets_are_required` is set to `true` or this widget is +// specified in `Action.required_widgets`, the submission action is blocked +// unless a value is entered. For an example in Google Chat apps, see Add a +// field in which a user can enter text // (https://developers.google.com/workspace/chat/design-interactive-card-dialog#add_a_field_in_which_a_user_can_enter_text). // Chat apps receive and can process the value of entered text during form // input events. For details about working with form inputs, see Receive form @@ -3398,6 +3418,10 @@ type GoogleAppsCardV1TextInput struct { // "MULTIPLE_LINE" - The text input field has a fixed height of multiple // lines. Type string `json:"type,omitempty"` + // Validation: Specify the input format validation necessary for this text + // field. Google Workspace Add-ons and Chat apps + // (https://developers.google.com/workspace/extend): + Validation *GoogleAppsCardV1Validation `json:"validation,omitempty"` // Value: The value entered by a user, returned as part of a form input event. // For details about working with form inputs, see Receive form data // (https://developers.google.com/workspace/chat/read-form-data). @@ -3458,6 +3482,44 @@ func (s GoogleAppsCardV1TextParagraph) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleAppsCardV1Validation: Represents the necessary data for validating the +// widget it's attached to. Google Workspace Add-ons and Chat apps +// (https://developers.google.com/workspace/extend): +type GoogleAppsCardV1Validation struct { + // CharacterLimit: Specify the character limit for text input widgets. Note + // that this is only used for text input and is ignored for other widgets. + // Google Workspace Add-ons and Chat apps + // (https://developers.google.com/workspace/extend): + CharacterLimit int64 `json:"characterLimit,omitempty"` + // InputType: Specify the type of the input widgets. Google Workspace Add-ons + // and Chat apps (https://developers.google.com/workspace/extend): + // + // Possible values: + // "INPUT_TYPE_UNSPECIFIED" - Unspecified type. Do not use. + // "TEXT" - Regular text that accepts all characters. + // "INTEGER" - An integer value. + // "FLOAT" - A float value. + // "EMAIL" - An email address. + // "EMOJI_PICKER" - A emoji selected from system-provided emoji picker. + InputType string `json:"inputType,omitempty"` + // ForceSendFields is a list of field names (e.g. "CharacterLimit") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CharacterLimit") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleAppsCardV1Validation) MarshalJSON() ([]byte, error) { + type NoMethod GoogleAppsCardV1Validation + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleAppsCardV1Widget: Each card is made up of widgets. A widget is a // composite object that can represent one of text, images, buttons, and other // object types. @@ -5214,11 +5276,25 @@ type Space struct { // PermissionSettings: Optional. Space permission settings for existing spaces. // Input for updating exact space permission settings, where existing // permission settings are replaced. Output lists current permission settings. + // Reading and updating permission settings supports: - In Developer Preview + // (https://developers.google.com/workspace/preview), App authentication + // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) + // with administrator approval (https://support.google.com/a?p=chat-app-auth) + // with the `chat.app.spaces` scope. Only populated and settable when the Chat + // app created the space. - User authentication + // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) PermissionSettings *PermissionSettings `json:"permissionSettings,omitempty"` // PredefinedPermissionSettings: Optional. Input only. Predefined space // permission settings, input only when creating a space. If the field is not // set, a collaboration space is created. After you create the space, settings - // are populated in the `PermissionSettings` field. + // are populated in the `PermissionSettings` field. Setting predefined + // permission settings supports: - In Developer Preview + // (https://developers.google.com/workspace/preview), App authentication + // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) + // with administrator approval (https://support.google.com/a?p=chat-app-auth) + // with the `chat.app.spaces` or `chat.app.spaces.create` scopes. - User + // authentication + // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) // // Possible values: // "PREDEFINED_PERMISSION_SETTINGS_UNSPECIFIED" - Unspecified. Don't use. diff --git a/cloudasset/v1/cloudasset-api.json b/cloudasset/v1/cloudasset-api.json index b5bc71a905e..a1e91b93466 100644 --- a/cloudasset/v1/cloudasset-api.json +++ b/cloudasset/v1/cloudasset-api.json @@ -1095,7 +1095,7 @@ } } }, - "revision": "20241211", + "revision": "20250104", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AccessSelector": { @@ -2886,6 +2886,10 @@ "accessLevel": { "description": "An AccessLevel resource name that allows protected resources inside the ServicePerimeters to access outside the ServicePerimeter boundaries. AccessLevels listed must be in the same policy as this ServicePerimeter. Referencing a nonexistent AccessLevel will cause an error. If an AccessLevel name is not specified, only resources within the perimeter can be accessed through Google Cloud calls with request origins within the perimeter. Example: `accessPolicies/MY_POLICY/accessLevels/MY_LEVEL`. If a single `*` is specified for `access_level`, then all EgressSources will be allowed.", "type": "string" + }, + "resource": { + "description": "A Google Cloud resource that you want to allow to egress the perimeter. These resources can access data outside the perimeter. This field only supports projects. The project format is `projects/{project_number}`. The resource can be in any Google Cloud organization, not just the organization where the perimeter is defined. You can't use `*` in this field to allow all Google Cloud resources.", + "type": "string" } }, "type": "object" diff --git a/cloudasset/v1/cloudasset-gen.go b/cloudasset/v1/cloudasset-gen.go index 71888d0e25e..2ac9d77de47 100644 --- a/cloudasset/v1/cloudasset-gen.go +++ b/cloudasset/v1/cloudasset-gen.go @@ -3081,6 +3081,13 @@ type GoogleIdentityAccesscontextmanagerV1EgressSource struct { // single `*` is specified for `access_level`, then all EgressSources will be // allowed. AccessLevel string `json:"accessLevel,omitempty"` + // Resource: A Google Cloud resource that you want to allow to egress the + // perimeter. These resources can access data outside the perimeter. This field + // only supports projects. The project format is `projects/{project_number}`. + // The resource can be in any Google Cloud organization, not just the + // organization where the perimeter is defined. You can't use `*` in this field + // to allow all Google Cloud resources. + Resource string `json:"resource,omitempty"` // ForceSendFields is a list of field names (e.g. "AccessLevel") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See diff --git a/cloudasset/v1beta1/cloudasset-api.json b/cloudasset/v1beta1/cloudasset-api.json index c69ef22165c..00ef8bc129a 100644 --- a/cloudasset/v1beta1/cloudasset-api.json +++ b/cloudasset/v1beta1/cloudasset-api.json @@ -411,7 +411,7 @@ } } }, - "revision": "20241211", + "revision": "20250104", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AnalyzeIamPolicyLongrunningMetadata": { @@ -1196,6 +1196,10 @@ "accessLevel": { "description": "An AccessLevel resource name that allows protected resources inside the ServicePerimeters to access outside the ServicePerimeter boundaries. AccessLevels listed must be in the same policy as this ServicePerimeter. Referencing a nonexistent AccessLevel will cause an error. If an AccessLevel name is not specified, only resources within the perimeter can be accessed through Google Cloud calls with request origins within the perimeter. Example: `accessPolicies/MY_POLICY/accessLevels/MY_LEVEL`. If a single `*` is specified for `access_level`, then all EgressSources will be allowed.", "type": "string" + }, + "resource": { + "description": "A Google Cloud resource that you want to allow to egress the perimeter. These resources can access data outside the perimeter. This field only supports projects. The project format is `projects/{project_number}`. The resource can be in any Google Cloud organization, not just the organization where the perimeter is defined. You can't use `*` in this field to allow all Google Cloud resources.", + "type": "string" } }, "type": "object" diff --git a/cloudasset/v1beta1/cloudasset-gen.go b/cloudasset/v1beta1/cloudasset-gen.go index 19855ac0388..8b12fe8204f 100644 --- a/cloudasset/v1beta1/cloudasset-gen.go +++ b/cloudasset/v1beta1/cloudasset-gen.go @@ -1526,6 +1526,13 @@ type GoogleIdentityAccesscontextmanagerV1EgressSource struct { // single `*` is specified for `access_level`, then all EgressSources will be // allowed. AccessLevel string `json:"accessLevel,omitempty"` + // Resource: A Google Cloud resource that you want to allow to egress the + // perimeter. These resources can access data outside the perimeter. This field + // only supports projects. The project format is `projects/{project_number}`. + // The resource can be in any Google Cloud organization, not just the + // organization where the perimeter is defined. You can't use `*` in this field + // to allow all Google Cloud resources. + Resource string `json:"resource,omitempty"` // ForceSendFields is a list of field names (e.g. "AccessLevel") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See diff --git a/cloudasset/v1p1beta1/cloudasset-api.json b/cloudasset/v1p1beta1/cloudasset-api.json index f8a9dc2fb3e..f85f39dfc76 100644 --- a/cloudasset/v1p1beta1/cloudasset-api.json +++ b/cloudasset/v1p1beta1/cloudasset-api.json @@ -207,7 +207,7 @@ } } }, - "revision": "20241211", + "revision": "20250104", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AnalyzeIamPolicyLongrunningMetadata": { @@ -898,6 +898,10 @@ "accessLevel": { "description": "An AccessLevel resource name that allows protected resources inside the ServicePerimeters to access outside the ServicePerimeter boundaries. AccessLevels listed must be in the same policy as this ServicePerimeter. Referencing a nonexistent AccessLevel will cause an error. If an AccessLevel name is not specified, only resources within the perimeter can be accessed through Google Cloud calls with request origins within the perimeter. Example: `accessPolicies/MY_POLICY/accessLevels/MY_LEVEL`. If a single `*` is specified for `access_level`, then all EgressSources will be allowed.", "type": "string" + }, + "resource": { + "description": "A Google Cloud resource that you want to allow to egress the perimeter. These resources can access data outside the perimeter. This field only supports projects. The project format is `projects/{project_number}`. The resource can be in any Google Cloud organization, not just the organization where the perimeter is defined. You can't use `*` in this field to allow all Google Cloud resources.", + "type": "string" } }, "type": "object" diff --git a/cloudasset/v1p1beta1/cloudasset-gen.go b/cloudasset/v1p1beta1/cloudasset-gen.go index b910f33a59e..ca847f98529 100644 --- a/cloudasset/v1p1beta1/cloudasset-gen.go +++ b/cloudasset/v1p1beta1/cloudasset-gen.go @@ -1337,6 +1337,13 @@ type GoogleIdentityAccesscontextmanagerV1EgressSource struct { // single `*` is specified for `access_level`, then all EgressSources will be // allowed. AccessLevel string `json:"accessLevel,omitempty"` + // Resource: A Google Cloud resource that you want to allow to egress the + // perimeter. These resources can access data outside the perimeter. This field + // only supports projects. The project format is `projects/{project_number}`. + // The resource can be in any Google Cloud organization, not just the + // organization where the perimeter is defined. You can't use `*` in this field + // to allow all Google Cloud resources. + Resource string `json:"resource,omitempty"` // ForceSendFields is a list of field names (e.g. "AccessLevel") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See diff --git a/cloudasset/v1p5beta1/cloudasset-api.json b/cloudasset/v1p5beta1/cloudasset-api.json index 3b2c84b1b1d..94d5f20a53f 100644 --- a/cloudasset/v1p5beta1/cloudasset-api.json +++ b/cloudasset/v1p5beta1/cloudasset-api.json @@ -177,7 +177,7 @@ } } }, - "revision": "20241211", + "revision": "20250104", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AnalyzeIamPolicyLongrunningMetadata": { @@ -903,6 +903,10 @@ "accessLevel": { "description": "An AccessLevel resource name that allows protected resources inside the ServicePerimeters to access outside the ServicePerimeter boundaries. AccessLevels listed must be in the same policy as this ServicePerimeter. Referencing a nonexistent AccessLevel will cause an error. If an AccessLevel name is not specified, only resources within the perimeter can be accessed through Google Cloud calls with request origins within the perimeter. Example: `accessPolicies/MY_POLICY/accessLevels/MY_LEVEL`. If a single `*` is specified for `access_level`, then all EgressSources will be allowed.", "type": "string" + }, + "resource": { + "description": "A Google Cloud resource that you want to allow to egress the perimeter. These resources can access data outside the perimeter. This field only supports projects. The project format is `projects/{project_number}`. The resource can be in any Google Cloud organization, not just the organization where the perimeter is defined. You can't use `*` in this field to allow all Google Cloud resources.", + "type": "string" } }, "type": "object" diff --git a/cloudasset/v1p5beta1/cloudasset-gen.go b/cloudasset/v1p5beta1/cloudasset-gen.go index 43549dea139..9a421ecac44 100644 --- a/cloudasset/v1p5beta1/cloudasset-gen.go +++ b/cloudasset/v1p5beta1/cloudasset-gen.go @@ -1371,6 +1371,13 @@ type GoogleIdentityAccesscontextmanagerV1EgressSource struct { // single `*` is specified for `access_level`, then all EgressSources will be // allowed. AccessLevel string `json:"accessLevel,omitempty"` + // Resource: A Google Cloud resource that you want to allow to egress the + // perimeter. These resources can access data outside the perimeter. This field + // only supports projects. The project format is `projects/{project_number}`. + // The resource can be in any Google Cloud organization, not just the + // organization where the perimeter is defined. You can't use `*` in this field + // to allow all Google Cloud resources. + Resource string `json:"resource,omitempty"` // ForceSendFields is a list of field names (e.g. "AccessLevel") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See diff --git a/cloudasset/v1p7beta1/cloudasset-api.json b/cloudasset/v1p7beta1/cloudasset-api.json index 99c291714c4..8fe0867a272 100644 --- a/cloudasset/v1p7beta1/cloudasset-api.json +++ b/cloudasset/v1p7beta1/cloudasset-api.json @@ -167,7 +167,7 @@ } } }, - "revision": "20241211", + "revision": "20250104", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AnalyzeIamPolicyLongrunningMetadata": { @@ -972,6 +972,10 @@ "accessLevel": { "description": "An AccessLevel resource name that allows protected resources inside the ServicePerimeters to access outside the ServicePerimeter boundaries. AccessLevels listed must be in the same policy as this ServicePerimeter. Referencing a nonexistent AccessLevel will cause an error. If an AccessLevel name is not specified, only resources within the perimeter can be accessed through Google Cloud calls with request origins within the perimeter. Example: `accessPolicies/MY_POLICY/accessLevels/MY_LEVEL`. If a single `*` is specified for `access_level`, then all EgressSources will be allowed.", "type": "string" + }, + "resource": { + "description": "A Google Cloud resource that you want to allow to egress the perimeter. These resources can access data outside the perimeter. This field only supports projects. The project format is `projects/{project_number}`. The resource can be in any Google Cloud organization, not just the organization where the perimeter is defined. You can't use `*` in this field to allow all Google Cloud resources.", + "type": "string" } }, "type": "object" diff --git a/cloudasset/v1p7beta1/cloudasset-gen.go b/cloudasset/v1p7beta1/cloudasset-gen.go index cad97c6032a..18f8ae21970 100644 --- a/cloudasset/v1p7beta1/cloudasset-gen.go +++ b/cloudasset/v1p7beta1/cloudasset-gen.go @@ -1547,6 +1547,13 @@ type GoogleIdentityAccesscontextmanagerV1EgressSource struct { // single `*` is specified for `access_level`, then all EgressSources will be // allowed. AccessLevel string `json:"accessLevel,omitempty"` + // Resource: A Google Cloud resource that you want to allow to egress the + // perimeter. These resources can access data outside the perimeter. This field + // only supports projects. The project format is `projects/{project_number}`. + // The resource can be in any Google Cloud organization, not just the + // organization where the perimeter is defined. You can't use `*` in this field + // to allow all Google Cloud resources. + Resource string `json:"resource,omitempty"` // ForceSendFields is a list of field names (e.g. "AccessLevel") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See diff --git a/cloudbuild/v1/cloudbuild-api.json b/cloudbuild/v1/cloudbuild-api.json index 2745acbb0e2..e0e2dff0184 100644 --- a/cloudbuild/v1/cloudbuild-api.json +++ b/cloudbuild/v1/cloudbuild-api.json @@ -191,11 +191,6 @@ "endpointUrl": "https://cloudbuild.us-east1.rep.googleapis.com/", "location": "us-east1" }, - { - "description": "Regional Endpoint", - "endpointUrl": "https://cloudbuild.us-east10.rep.googleapis.com/", - "location": "us-east10" - }, { "description": "Regional Endpoint", "endpointUrl": "https://cloudbuild.us-east4.rep.googleapis.com/", @@ -2573,7 +2568,7 @@ } } }, - "revision": "20241210", + "revision": "20250102", "rootUrl": "https://cloudbuild.googleapis.com/", "schemas": { "ApprovalConfig": { diff --git a/cloudbuild/v2/cloudbuild-api.json b/cloudbuild/v2/cloudbuild-api.json index 9e8a57a79b5..a5884ae4653 100644 --- a/cloudbuild/v2/cloudbuild-api.json +++ b/cloudbuild/v2/cloudbuild-api.json @@ -191,11 +191,6 @@ "endpointUrl": "https://cloudbuild.us-east1.rep.googleapis.com/", "location": "us-east1" }, - { - "description": "Regional Endpoint", - "endpointUrl": "https://cloudbuild.us-east10.rep.googleapis.com/", - "location": "us-east10" - }, { "description": "Regional Endpoint", "endpointUrl": "https://cloudbuild.us-east4.rep.googleapis.com/", @@ -1071,7 +1066,7 @@ } } }, - "revision": "20241210", + "revision": "20250102", "rootUrl": "https://cloudbuild.googleapis.com/", "schemas": { "AuditConfig": { diff --git a/cloudcontrolspartner/v1/cloudcontrolspartner-api.json b/cloudcontrolspartner/v1/cloudcontrolspartner-api.json index 4cf024c5602..c9e291ad5c9 100644 --- a/cloudcontrolspartner/v1/cloudcontrolspartner-api.json +++ b/cloudcontrolspartner/v1/cloudcontrolspartner-api.json @@ -576,7 +576,7 @@ } } }, - "revision": "20241024", + "revision": "20241231", "rootUrl": "https://cloudcontrolspartner.googleapis.com/", "schemas": { "AccessApprovalRequest": { @@ -843,12 +843,19 @@ "THALES", "VIRTRU" ], + "enumDeprecated": [ + false, + false, + false, + false, + true + ], "enumDescriptions": [ "Unspecified EKM solution", "EKM Partner Fortanix", "EKM Partner FutureX", "EKM Partner Thales", - "EKM Partner Virtu" + "This enum value is never used." ], "type": "string" } diff --git a/cloudcontrolspartner/v1/cloudcontrolspartner-gen.go b/cloudcontrolspartner/v1/cloudcontrolspartner-gen.go index 1b74ff794fc..74bae759586 100644 --- a/cloudcontrolspartner/v1/cloudcontrolspartner-gen.go +++ b/cloudcontrolspartner/v1/cloudcontrolspartner-gen.go @@ -532,7 +532,7 @@ type EkmMetadata struct { // "FORTANIX" - EKM Partner Fortanix // "FUTUREX" - EKM Partner FutureX // "THALES" - EKM Partner Thales - // "VIRTRU" - EKM Partner Virtu + // "VIRTRU" - This enum value is never used. EkmSolution string `json:"ekmSolution,omitempty"` // ForceSendFields is a list of field names (e.g. "EkmEndpointUri") to // unconditionally include in API requests. By default, fields with empty or diff --git a/cloudcontrolspartner/v1beta/cloudcontrolspartner-api.json b/cloudcontrolspartner/v1beta/cloudcontrolspartner-api.json index 459581fd713..9abd17d53d9 100644 --- a/cloudcontrolspartner/v1beta/cloudcontrolspartner-api.json +++ b/cloudcontrolspartner/v1beta/cloudcontrolspartner-api.json @@ -576,7 +576,7 @@ } } }, - "revision": "20241024", + "revision": "20241231", "rootUrl": "https://cloudcontrolspartner.googleapis.com/", "schemas": { "AccessApprovalRequest": { @@ -843,12 +843,19 @@ "THALES", "VIRTRU" ], + "enumDeprecated": [ + false, + false, + false, + false, + true + ], "enumDescriptions": [ "Unspecified EKM solution", "EKM Partner Fortanix", "EKM Partner FutureX", "EKM Partner Thales", - "EKM Partner Virtu" + "This enum value is never used." ], "type": "string" } diff --git a/cloudcontrolspartner/v1beta/cloudcontrolspartner-gen.go b/cloudcontrolspartner/v1beta/cloudcontrolspartner-gen.go index bd0849d35c1..9806c73c6a9 100644 --- a/cloudcontrolspartner/v1beta/cloudcontrolspartner-gen.go +++ b/cloudcontrolspartner/v1beta/cloudcontrolspartner-gen.go @@ -532,7 +532,7 @@ type EkmMetadata struct { // "FORTANIX" - EKM Partner Fortanix // "FUTUREX" - EKM Partner FutureX // "THALES" - EKM Partner Thales - // "VIRTRU" - EKM Partner Virtu + // "VIRTRU" - This enum value is never used. EkmSolution string `json:"ekmSolution,omitempty"` // ForceSendFields is a list of field names (e.g. "EkmEndpointUri") to // unconditionally include in API requests. By default, fields with empty or diff --git a/cloudfunctions/v1/cloudfunctions-api.json b/cloudfunctions/v1/cloudfunctions-api.json index 29d91e9f814..8f9bac8f882 100644 --- a/cloudfunctions/v1/cloudfunctions-api.json +++ b/cloudfunctions/v1/cloudfunctions-api.json @@ -552,7 +552,7 @@ } } }, - "revision": "20240905", + "revision": "20250102", "rootUrl": "https://cloudfunctions.googleapis.com/", "schemas": { "AuditConfig": { @@ -703,7 +703,8 @@ "type": "string" }, "dockerRegistry": { - "description": "Docker Registry to use for this deployment. If unspecified, it defaults to `ARTIFACT_REGISTRY`. If `docker_repository` field is specified, this field should either be left unspecified or set to `ARTIFACT_REGISTRY`.", + "deprecated": true, + "description": "Docker Registry to use for this deployment. Deprecated: Container Registry option will no longer be available after March 2025: https://cloud.google.com/artifact-registry/docs/transition/transition-from-gcr Please use Artifact Registry instead, which is the default choice. If unspecified, it defaults to `ARTIFACT_REGISTRY`. If `docker_repository` field is specified, this field should either be left unspecified or set to `ARTIFACT_REGISTRY`.", "enum": [ "DOCKER_REGISTRY_UNSPECIFIED", "CONTAINER_REGISTRY", diff --git a/cloudfunctions/v1/cloudfunctions-gen.go b/cloudfunctions/v1/cloudfunctions-gen.go index d93326f3796..155dbe31b34 100644 --- a/cloudfunctions/v1/cloudfunctions-gen.go +++ b/cloudfunctions/v1/cloudfunctions-gen.go @@ -469,9 +469,12 @@ type CloudFunction struct { BuildWorkerPool string `json:"buildWorkerPool,omitempty"` // Description: User-provided description of a function. Description string `json:"description,omitempty"` - // DockerRegistry: Docker Registry to use for this deployment. If unspecified, - // it defaults to `ARTIFACT_REGISTRY`. If `docker_repository` field is - // specified, this field should either be left unspecified or set to + // DockerRegistry: Docker Registry to use for this deployment. Deprecated: + // Container Registry option will no longer be available after March 2025: + // https://cloud.google.com/artifact-registry/docs/transition/transition-from-gcr + // Please use Artifact Registry instead, which is the default choice. If + // unspecified, it defaults to `ARTIFACT_REGISTRY`. If `docker_repository` + // field is specified, this field should either be left unspecified or set to // `ARTIFACT_REGISTRY`. // // Possible values: diff --git a/cloudsupport/v2/cloudsupport-api.json b/cloudsupport/v2/cloudsupport-api.json index f4adfe85186..81be3c8e9b1 100644 --- a/cloudsupport/v2/cloudsupport-api.json +++ b/cloudsupport/v2/cloudsupport-api.json @@ -382,7 +382,7 @@ ], "parameters": { "pageSize": { - "description": "The maximum number of attachments fetched with each request. If not provided, the default is 10. The maximum page size that will be returned is 100.", + "description": "The maximum number of attachments fetched with each request. If not provided, the default is 10. The maximum page size that will be returned is 100. The size of each page can be smaller than the requested page size and can include zero. For example, you could request 100 attachments on one page, receive 0, and then on the next page, receive 90.", "format": "int32", "location": "query", "type": "integer" @@ -552,7 +552,7 @@ } } }, - "revision": "20241218", + "revision": "20241231", "rootUrl": "https://cloudsupport.googleapis.com/", "schemas": { "Actor": { diff --git a/cloudsupport/v2/cloudsupport-gen.go b/cloudsupport/v2/cloudsupport-gen.go index b0050640c73..1af0bcf82c4 100644 --- a/cloudsupport/v2/cloudsupport-gen.go +++ b/cloudsupport/v2/cloudsupport-gen.go @@ -2284,7 +2284,10 @@ func (r *CasesAttachmentsService) List(parent string) *CasesAttachmentsListCall // PageSize sets the optional parameter "pageSize": The maximum number of // attachments fetched with each request. If not provided, the default is 10. -// The maximum page size that will be returned is 100. +// The maximum page size that will be returned is 100. The size of each page +// can be smaller than the requested page size and can include zero. For +// example, you could request 100 attachments on one page, receive 0, and then +// on the next page, receive 90. func (c *CasesAttachmentsListCall) PageSize(pageSize int64) *CasesAttachmentsListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c diff --git a/cloudsupport/v2beta/cloudsupport-api.json b/cloudsupport/v2beta/cloudsupport-api.json index ed5bfc9c8d6..afa0304a169 100644 --- a/cloudsupport/v2beta/cloudsupport-api.json +++ b/cloudsupport/v2beta/cloudsupport-api.json @@ -449,7 +449,7 @@ ], "parameters": { "pageSize": { - "description": "The maximum number of attachments fetched with each request. If not provided, the default is 10. The maximum page size that will be returned is 100.", + "description": "The maximum number of attachments fetched with each request. If not provided, the default is 10. The maximum page size that will be returned is 100. The size of each page can be smaller than the requested page size and can include zero. For example, you could request 100 attachments on one page, receive 0, and then on the next page, receive 90.", "format": "int32", "location": "query", "type": "integer" @@ -619,7 +619,7 @@ } } }, - "revision": "20241218", + "revision": "20241231", "rootUrl": "https://cloudsupport.googleapis.com/", "schemas": { "Actor": { diff --git a/cloudsupport/v2beta/cloudsupport-gen.go b/cloudsupport/v2beta/cloudsupport-gen.go index 25fb36b7568..01edd36906e 100644 --- a/cloudsupport/v2beta/cloudsupport-gen.go +++ b/cloudsupport/v2beta/cloudsupport-gen.go @@ -2628,7 +2628,10 @@ func (r *CasesAttachmentsService) List(parent string) *CasesAttachmentsListCall // PageSize sets the optional parameter "pageSize": The maximum number of // attachments fetched with each request. If not provided, the default is 10. -// The maximum page size that will be returned is 100. +// The maximum page size that will be returned is 100. The size of each page +// can be smaller than the requested page size and can include zero. For +// example, you could request 100 attachments on one page, receive 0, and then +// on the next page, receive 90. func (c *CasesAttachmentsListCall) PageSize(pageSize int64) *CasesAttachmentsListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c diff --git a/compute/v0.alpha/compute-api.json b/compute/v0.alpha/compute-api.json index cca9ae6d9a6..70f4438416a 100644 --- a/compute/v0.alpha/compute-api.json +++ b/compute/v0.alpha/compute-api.json @@ -710,6 +710,47 @@ } } }, + "advice": { + "methods": { + "calendarMode": { + "description": "Advise how, where and when to create the requested amount of instances with specified accelerators, within the specified time and location limits. The method recommends creating future reservations for the requested resources.", + "flatPath": "projects/{project}/regions/{region}/advice/calendarMode", + "httpMethod": "POST", + "id": "compute.advice.calendarMode", + "parameterOrder": [ + "project", + "region" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/regions/{region}/advice/calendarMode", + "request": { + "$ref": "CalendarModeAdviceRequest" + }, + "response": { + "$ref": "CalendarModeAdviceResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + } + } + }, "autoscalers": { "methods": { "aggregatedList": { @@ -15456,6 +15497,41 @@ "https://www.googleapis.com/auth/compute.readonly" ] }, + "getOperationalStatus": { + "description": "Returns the InterconnectAttachmentStatuses for the specified InterconnectAttachmentGroup resource.", + "flatPath": "projects/{project}/global/interconnectAttachmentGroups/{interconnectAttachmentGroup}/getOperationalStatus", + "httpMethod": "GET", + "id": "compute.interconnectAttachmentGroups.getOperationalStatus", + "parameterOrder": [ + "project", + "interconnectAttachmentGroup" + ], + "parameters": { + "interconnectAttachmentGroup": { + "description": "Name of the interconnectAttachmentGroup resource to query.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/interconnectAttachmentGroups/{interconnectAttachmentGroup}/getOperationalStatus", + "response": { + "$ref": "InterconnectAttachmentGroupsGetOperationalStatusResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, "insert": { "description": "Creates a InterconnectAttachmentGroup in the specified project in the given scope using the parameters that are included in the request.", "flatPath": "projects/{project}/global/interconnectAttachmentGroups", @@ -16297,88 +16373,34 @@ "https://www.googleapis.com/auth/compute.readonly" ] }, - "insert": { - "description": "Creates a InterconnectGroup in the specified project in the given scope using the parameters that are included in the request.", - "flatPath": "projects/{project}/global/interconnectGroups", - "httpMethod": "POST", - "id": "compute.interconnectGroups.insert", + "getOperationalStatus": { + "description": "Returns the interconnectStatuses for the specified InterconnectGroup.", + "flatPath": "projects/{project}/global/interconnectGroups/{interconnectGroup}/getOperationalStatus", + "httpMethod": "GET", + "id": "compute.interconnectGroups.getOperationalStatus", "parameterOrder": [ - "project" + "project", + "interconnectGroup" ], "parameters": { - "project": { - "description": "Project ID for this request.", + "interconnectGroup": { + "description": "Name of the interconnectGroup resource to query.", "location": "path", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "required": true, "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder", - "location": "query", - "type": "string" - } - }, - "path": "projects/{project}/global/interconnectGroups", - "request": { - "$ref": "InterconnectGroup" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ] - }, - "list": { - "description": "Lists the InterconnectGroups for a project in the given scope.", - "flatPath": "projects/{project}/global/interconnectGroups", - "httpMethod": "GET", - "id": "compute.interconnectGroups.list", - "parameterOrder": [ - "project" - ], - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "default": "500", - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "format": "uint32", - "location": "query", - "minimum": "0", - "type": "integer" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, "project": { "description": "Project ID for this request.", "location": "path", "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", "required": true, "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" } }, - "path": "projects/{project}/global/interconnectGroups", + "path": "projects/{project}/global/interconnectGroups/{interconnectGroup}/getOperationalStatus", "response": { - "$ref": "InterconnectGroupsListResponse" + "$ref": "InterconnectGroupsGetOperationalStatusResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", @@ -16386,23 +16408,15 @@ "https://www.googleapis.com/auth/compute.readonly" ] }, - "patch": { - "description": "Patches the specified InterconnectGroup resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules.", - "flatPath": "projects/{project}/global/interconnectGroups/{interconnectGroup}", - "httpMethod": "PATCH", - "id": "compute.interconnectGroups.patch", + "insert": { + "description": "Creates a InterconnectGroup in the specified project in the given scope using the parameters that are included in the request.", + "flatPath": "projects/{project}/global/interconnectGroups", + "httpMethod": "POST", + "id": "compute.interconnectGroups.insert", "parameterOrder": [ - "project", - "interconnectGroup" + "project" ], "parameters": { - "interconnectGroup": { - "description": "Name of the InterconnectGroup resource to patch.", - "location": "path", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "required": true, - "type": "string" - }, "project": { "description": "Project ID for this request.", "location": "path", @@ -16414,15 +16428,9 @@ "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder", "location": "query", "type": "string" - }, - "updateMask": { - "description": "The list of fields to update.", - "format": "google-fieldmask", - "location": "query", - "type": "string" } }, - "path": "projects/{project}/global/interconnectGroups/{interconnectGroup}", + "path": "projects/{project}/global/interconnectGroups", "request": { "$ref": "InterconnectGroup" }, @@ -16434,125 +16442,228 @@ "https://www.googleapis.com/auth/compute" ] }, - "setIamPolicy": { - "description": "Sets the access control policy on the specified resource. Replaces any existing policy.", - "flatPath": "projects/{project}/global/interconnectGroups/{resource}/setIamPolicy", - "httpMethod": "POST", - "id": "compute.interconnectGroups.setIamPolicy", - "parameterOrder": [ - "project", - "resource" - ], - "parameters": { - "project": { - "description": "Project ID for this request.", - "location": "path", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "location": "path", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "required": true, - "type": "string" - } - }, - "path": "projects/{project}/global/interconnectGroups/{resource}/setIamPolicy", - "request": { - "$ref": "GlobalSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ] - }, - "testIamPermissions": { - "description": "Returns permissions that a caller has on the specified resource.", - "flatPath": "projects/{project}/global/interconnectGroups/{resource}/testIamPermissions", - "httpMethod": "POST", - "id": "compute.interconnectGroups.testIamPermissions", - "parameterOrder": [ - "project", - "resource" - ], - "parameters": { - "project": { - "description": "Project ID for this request.", - "location": "path", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "location": "path", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "required": true, - "type": "string" - } - }, - "path": "projects/{project}/global/interconnectGroups/{resource}/testIamPermissions", - "request": { - "$ref": "TestPermissionsRequest" - }, - "response": { - "$ref": "TestPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ] - } - } - }, - "interconnectLocations": { - "methods": { - "get": { - "description": "Returns the details for the specified interconnect location. Gets a list of available interconnect locations by making a list() request.", - "flatPath": "projects/{project}/global/interconnectLocations/{interconnectLocation}", - "httpMethod": "GET", - "id": "compute.interconnectLocations.get", - "parameterOrder": [ - "project", - "interconnectLocation" - ], - "parameters": { - "interconnectLocation": { - "description": "Name of the interconnect location to return.", - "location": "path", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "location": "path", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "required": true, - "type": "string" - } - }, - "path": "projects/{project}/global/interconnectLocations/{interconnectLocation}", - "response": { - "$ref": "InterconnectLocation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ] - }, "list": { - "description": "Retrieves the list of interconnect locations available to the specified project.", - "flatPath": "projects/{project}/global/interconnectLocations", + "description": "Lists the InterconnectGroups for a project in the given scope.", + "flatPath": "projects/{project}/global/interconnectGroups", "httpMethod": "GET", - "id": "compute.interconnectLocations.list", + "id": "compute.interconnectGroups.list", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "path": "projects/{project}/global/interconnectGroups", + "response": { + "$ref": "InterconnectGroupsListResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "patch": { + "description": "Patches the specified InterconnectGroup resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules.", + "flatPath": "projects/{project}/global/interconnectGroups/{interconnectGroup}", + "httpMethod": "PATCH", + "id": "compute.interconnectGroups.patch", + "parameterOrder": [ + "project", + "interconnectGroup" + ], + "parameters": { + "interconnectGroup": { + "description": "Name of the InterconnectGroup resource to patch.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder", + "location": "query", + "type": "string" + }, + "updateMask": { + "description": "The list of fields to update.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/interconnectGroups/{interconnectGroup}", + "request": { + "$ref": "InterconnectGroup" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource. Replaces any existing policy.", + "flatPath": "projects/{project}/global/interconnectGroups/{resource}/setIamPolicy", + "httpMethod": "POST", + "id": "compute.interconnectGroups.setIamPolicy", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/interconnectGroups/{resource}/setIamPolicy", + "request": { + "$ref": "GlobalSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource.", + "flatPath": "projects/{project}/global/interconnectGroups/{resource}/testIamPermissions", + "httpMethod": "POST", + "id": "compute.interconnectGroups.testIamPermissions", + "parameterOrder": [ + "project", + "resource" + ], + "parameters": { + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/interconnectGroups/{resource}/testIamPermissions", + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + } + } + }, + "interconnectLocations": { + "methods": { + "get": { + "description": "Returns the details for the specified interconnect location. Gets a list of available interconnect locations by making a list() request.", + "flatPath": "projects/{project}/global/interconnectLocations/{interconnectLocation}", + "httpMethod": "GET", + "id": "compute.interconnectLocations.get", + "parameterOrder": [ + "project", + "interconnectLocation" + ], + "parameters": { + "interconnectLocation": { + "description": "Name of the interconnect location to return.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/global/interconnectLocations/{interconnectLocation}", + "response": { + "$ref": "InterconnectLocation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "list": { + "description": "Retrieves the list of interconnect locations available to the specified project.", + "flatPath": "projects/{project}/global/interconnectLocations", + "httpMethod": "GET", + "id": "compute.interconnectLocations.list", "parameterOrder": [ "project" ], @@ -19519,6 +19630,72 @@ "https://www.googleapis.com/auth/compute" ] }, + "aggregatedList": { + "description": "Retrieves an aggregated list of network firewall policies, listing network firewall policies from all applicable scopes (global and regional) and grouping the results per scope. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/firewallPolicies", + "httpMethod": "GET", + "id": "compute.networkFirewallPolicies.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/firewallPolicies", + "response": { + "$ref": "NetworkFirewallPolicyAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, "cloneRules": { "description": "Copies rules to the specified firewall policy.", "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/cloneRules", @@ -47422,7 +47599,7 @@ } } }, - "revision": "20241201", + "revision": "20241231", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -48022,7 +48199,7 @@ "type": "string" }, "securityPolicy": { - "description": "[Output Only] The resource URL for the security policy associated with this access config.", + "description": "The resource URL for the security policy associated with this access config.", "type": "string" }, "setPublicDns": { @@ -49298,7 +49475,7 @@ "type": "string" }, "sourceSnapshot": { - "description": "The source snapshot to create this disk. When creating a new instance boot disk, one of initializeParams.sourceSnapshot or initializeParams.sourceImage or disks.source is required. To create a disk with a snapshot that you created, specify the snapshot name in the following format: global/snapshots/my-backup If the source snapshot is deleted later, this field will not be set.", + "description": "The source snapshot to create this disk. When creating a new instance boot disk, one of initializeParams.sourceSnapshot or initializeParams.sourceImage or disks.source is required. To create a disk with a snapshot that you created, specify the snapshot name in the following format: global/snapshots/my-backup If the source snapshot is deleted later, this field will not be set. Note: You cannot create VMs in bulk using a snapshot as the source. Use an image instead when you create VMs using the bulk insert method.", "type": "string" }, "sourceSnapshotEncryptionKey": { @@ -52967,6 +53144,48 @@ }, "type": "object" }, + "CalendarModeAdviceRequest": { + "description": "A request to recommend the best way to consume the specified resources in the future.", + "id": "CalendarModeAdviceRequest", + "properties": { + "futureResourcesSpecs": { + "additionalProperties": { + "$ref": "FutureResourcesSpec" + }, + "description": "Specification of resources to create in the future. The key of the map is an arbitrary string specified by the caller. Value of the map is a specification of required resources and their constraints. Currently only one value is allowed in this map.", + "type": "object" + } + }, + "type": "object" + }, + "CalendarModeAdviceResponse": { + "description": "A response containing the recommended way of creating the specified resources in the future. It contains (will contain) multiple recommendations that can be analyzed by the customer and the best one can be picked.", + "id": "CalendarModeAdviceResponse", + "properties": { + "recommendations": { + "description": "Recommendations where, how and when to create the requested resources in order to maximize their obtainability and minimize cost.", + "items": { + "$ref": "CalendarModeRecommendation" + }, + "type": "array" + } + }, + "type": "object" + }, + "CalendarModeRecommendation": { + "description": "A single recommendation to create requested resources. Contains detailed recommendations for every future resources specification specified in CalendarModeAdviceRequest.", + "id": "CalendarModeRecommendation", + "properties": { + "recommendationsPerSpec": { + "additionalProperties": { + "$ref": "FutureResourcesRecommendation" + }, + "description": "Recommendations for every future resource specification passed in CalendarModeAdviceRequest. Keys of the map correspond to keys specified in the request.", + "type": "object" + } + }, + "type": "object" + }, "CallCredentials": { "description": "[Deprecated] gRPC call credentials to access the SDS server. gRPC call credentials to access the SDS server.", "id": "CallCredentials", @@ -55941,7 +56160,7 @@ "additionalProperties": { "type": "string" }, - "description": "Additional structured details about this error. Keys must match /a-z+/ but should ideally be lowerCamelCase. Also they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than {\"instanceLimit\": \"100/request\"}, should be returned as, {\"instanceLimitPerRequest\": \"100\"}, if the client exceeds the number of instances that can be created in a single (batch) request.", + "description": "Additional structured details about this error. Keys must match a regular expression of `a-z+` but should ideally be lowerCamelCase. Also, they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than `{\"instanceLimit\": \"100/request\"}`, should be returned as, `{\"instanceLimitPerRequest\": \"100\"}`, if the client exceeds the number of instances that can be created in a single (batch) request.", "type": "object" }, "reason": { @@ -56796,6 +57015,143 @@ }, "type": "object" }, + "FirewallPoliciesScopedList": { + "id": "FirewallPoliciesScopedList", + "properties": { + "firewallPolicies": { + "description": "A list of firewall policies contained in this scope.", + "items": { + "$ref": "FirewallPolicy" + }, + "type": "array" + }, + "warning": { + "description": "Informational warning which replaces the list of firewall policies when the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g: regions.list).", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "type": "string" + }, + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", + "type": "string" + } + }, + "type": "object" + } + }, + "type": "object" + }, "FirewallPolicy": { "description": "Represents a Firewall Policy resource.", "id": "FirewallPolicy", @@ -57360,6 +57716,37 @@ }, "type": "object" }, + "FlexibleTimeRange": { + "description": "A flexible specification of a time range that has 3 points of flexibility: (1) a flexible start time, (2) a flexible end time, (3) a flexible duration. It is possible to specify a contradictory time range that cannot be matched by any Interval. This causes a validation error.", + "id": "FlexibleTimeRange", + "properties": { + "endTimeNotEarlierThan": { + "format": "google-datetime", + "type": "string" + }, + "endTimeNotLaterThan": { + "format": "google-datetime", + "type": "string" + }, + "maxDuration": { + "format": "google-duration", + "type": "string" + }, + "minDuration": { + "format": "google-duration", + "type": "string" + }, + "startTimeNotEarlierThan": { + "format": "google-datetime", + "type": "string" + }, + "startTimeNotLaterThan": { + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, "ForwardingRule": { "description": "Represents a Forwarding Rule resource. Forwarding rule resources in Google Cloud can be either regional or global in scope: * [Global](https://cloud.google.com/compute/docs/reference/rest/alpha/globalForwardingRules) * [Regional](https://cloud.google.com/compute/docs/reference/rest/alpha/forwardingRules) A forwarding rule and its corresponding IP address represent the frontend configuration of a Google Cloud load balancer. Forwarding rules can also reference target instances and Cloud VPN Classic gateways (targetVpnGateway). For more information, read Forwarding rule concepts and Using protocol forwarding.", "id": "ForwardingRule", @@ -58267,7 +58654,7 @@ "id": "FutureReservationCommitmentInfo", "properties": { "commitmentName": { - "description": "name of the commitment where capacity is being delivered to. In the form of \"projects/{project-id}/locations/{region-name}/commitment/{name}\"", + "description": "name of the commitment where capacity is being delivered to.", "type": "string" }, "commitmentPlan": { @@ -58991,6 +59378,248 @@ }, "type": "object" }, + "FutureResourcesRecommendation": { + "description": "Recommendation for single resources specification, to be created in the future.", + "id": "FutureResourcesRecommendation", + "properties": { + "endTime": { + "format": "google-datetime", + "type": "string" + }, + "location": { + "description": "The advised location for resource usage. When a zone, in format 'zones/'. If not set, it means that no location is recommended - see other_locations for details.", + "type": "string" + }, + "otherLocations": { + "additionalProperties": { + "$ref": "FutureResourcesRecommendationOtherLocation" + }, + "description": "List of locations in the request scope that were not recommended. Keys of the map are zones, in format 'zones/'. The values are status information indicating the recommendation status.", + "type": "object" + }, + "recommendationId": { + "description": "Unique id of the recommendation, a UUID string generated by the API.", + "type": "string" + }, + "recommendationType": { + "description": "Type of recommendation. Currently only FUTURE_RESERVATION is supported.", + "enum": [ + "FUTURE_RESERVATION", + "RECOMMENDATION_TYPE_UNSPECIFIED" + ], + "enumDescriptions": [ + "A Future Reservation is recommended.", + "Default value, unused." + ], + "type": "string" + }, + "startTime": { + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "FutureResourcesRecommendationOtherLocation": { + "description": "Information about recommendation status for locations that were allowed but not used by the response.", + "id": "FutureResourcesRecommendationOtherLocation", + "properties": { + "details": { + "description": "Details (human readable) describing the situation. For example, if status is CONDITION_NOT_MET, then details contain information about the parameters of the time window that did not meet the required conditions.", + "type": "string" + }, + "status": { + "description": "Status of recommendation in this location.", + "enum": [ + "CONDITIONS_NOT_MET", + "NOT_SUPPORTED", + "NO_CAPACITY", + "OTHER_LOCATION_STATUS_UNDEFINED", + "RECOMMENDED" + ], + "enumDescriptions": [ + "The requested resources are offered in this location but the requested time window is does not meet the required conditions.", + "The requested resources are not offered in this location. Retrying the request will not change this status.", + "The requested resources are offered in this location and the requested time window is accepted but there is no capacity within the requested time window.", + "Default value, unused.", + "The requested resources are offered in this location and it is possible to request them. However, another location was better and was recommended." + ], + "type": "string" + } + }, + "type": "object" + }, + "FutureResourcesSpec": { + "description": "Specification of resources to be created at some time in the future within an optionally specified set of locations, and within the specified time range.", + "id": "FutureResourcesSpec", + "properties": { + "deploymentType": { + "description": "Indicates if the reservation allocation strategy is static (DENSE) or dynamic (STANDARD). Defaults to DENSE.", + "enum": [ + "DENSE", + "DEPLOYMENT_TYPE_UNSPECIFIED", + "FLEXIBLE" + ], + "enumDescriptions": [ + "The reserved capacity is made up of densely deployed reservation blocks.", + "", + "The reserved capacity is made up of highly flexible, logical reservation blocks." + ], + "type": "string" + }, + "locationPolicy": { + "$ref": "FutureResourcesSpecLocationPolicy", + "description": "Optional location policy allowing to exclude some zone(s) in which the resources must not be created." + }, + "targetResources": { + "$ref": "FutureResourcesSpecTargetResources", + "description": "Specification of the reserved resources." + }, + "timeRangeSpec": { + "$ref": "FlexibleTimeRange", + "description": "Specification of a time range in which the resources may be created. The time range specifies start of resource use and planned end of resource use." + } + }, + "type": "object" + }, + "FutureResourcesSpecAggregateResources": { + "id": "FutureResourcesSpecAggregateResources", + "properties": { + "acceleratorCount": { + "description": "Size of the request, in accelerator (chip) count.", + "format": "int64", + "type": "string" + }, + "vmFamily": { + "description": "The VM family that all instances scheduled against this reservation must belong to. Use for TPU reservations.", + "enum": [ + "VM_FAMILY_CLOUD_TPU_DEVICE_CT3", + "VM_FAMILY_CLOUD_TPU_LITE_DEVICE_CT5L", + "VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT5LP", + "VM_FAMILY_CLOUD_TPU_POD_SLICE_CT3P", + "VM_FAMILY_CLOUD_TPU_POD_SLICE_CT4P" + ], + "enumDescriptions": [ + "", + "", + "", + "", + "" + ], + "type": "string" + }, + "workloadType": { + "description": "Workload type. Use for TPU reservations.", + "enum": [ + "BATCH", + "SERVING", + "UNSPECIFIED" + ], + "enumDescriptions": [ + "Reserved resources will be optimized for BATCH workloads, such as ML training.", + "Reserved resources will be optimized for SERVING workloads, such as ML inference.", + "" + ], + "type": "string" + } + }, + "type": "object" + }, + "FutureResourcesSpecLocalSsdPartition": { + "id": "FutureResourcesSpecLocalSsdPartition", + "properties": { + "diskInterface": { + "description": "Disk interface. Defaults to SCSI.", + "enum": [ + "NVDIMM", + "NVME", + "SCSI" + ], + "enumDescriptions": [ + "", + "", + "" + ], + "type": "string" + }, + "diskSizeGb": { + "description": "The size of the disk in GB.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, + "FutureResourcesSpecLocationPolicy": { + "description": "Specification of locations to create resources in.", + "id": "FutureResourcesSpecLocationPolicy", + "properties": { + "locations": { + "additionalProperties": { + "$ref": "FutureResourcesSpecLocationPolicyLocation" + }, + "description": "Preferences for specified locations. Keys of the map are locations - zones, in format of 'zones/'. Values are preferences for the zones. If a zone is not specified in this map, it is ALLOWed.", + "type": "object" + } + }, + "type": "object" + }, + "FutureResourcesSpecLocationPolicyLocation": { + "description": "Preference for a single specified location.", + "id": "FutureResourcesSpecLocationPolicyLocation", + "properties": { + "preference": { + "description": "Preference for this location.", + "enum": [ + "ALLOW", + "DENY", + "PREFERENCE_UNSPECIFIED" + ], + "enumDescriptions": [ + "Location is allowed for use.", + "Location is prohibited.", + "Default value, unused." + ], + "type": "string" + } + }, + "type": "object" + }, + "FutureResourcesSpecSpecificSKUResources": { + "id": "FutureResourcesSpecSpecificSKUResources", + "properties": { + "instanceCount": { + "description": "Size of the request, in instance count.", + "format": "int64", + "type": "string" + }, + "localSsdPartitions": { + "description": "Local SSD partitions. You do not have to include SSD partitions that are built in the machine type.", + "items": { + "$ref": "FutureResourcesSpecLocalSsdPartition" + }, + "type": "array" + }, + "machineType": { + "description": "The machine type to use for instances that will use the reservation. This field only accepts machine type names. e.g. n2-standard-4 and does not accept machine type full or partial url. e.g. projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4. Use for GPU reservations.", + "type": "string" + } + }, + "type": "object" + }, + "FutureResourcesSpecTargetResources": { + "description": "Specification of reserved resources.", + "id": "FutureResourcesSpecTargetResources", + "properties": { + "aggregateResources": { + "$ref": "FutureResourcesSpecAggregateResources" + }, + "specificSkuResources": { + "$ref": "FutureResourcesSpecSpecificSKUResources" + } + }, + "type": "object" + }, "GRPCHealthCheck": { "id": "GRPCHealthCheck", "properties": { @@ -68266,7 +68895,7 @@ "type": "string" }, "bandwidth": { - "description": "Provisioned bandwidth capacity for the interconnect attachment. For attachments of type DEDICATED, the user can set the bandwidth. For attachments of type PARTNER, the Google Partner that is operating the interconnect must set the bandwidth. Output only for PARTNER type, mutable for PARTNER_PROVIDER and DEDICATED, and can take one of the following values: - BPS_50M: 50 Mbit/s - BPS_100M: 100 Mbit/s - BPS_200M: 200 Mbit/s - BPS_300M: 300 Mbit/s - BPS_400M: 400 Mbit/s - BPS_500M: 500 Mbit/s - BPS_1G: 1 Gbit/s - BPS_2G: 2 Gbit/s - BPS_5G: 5 Gbit/s - BPS_10G: 10 Gbit/s - BPS_20G: 20 Gbit/s - BPS_50G: 50 Gbit/s ", + "description": "Provisioned bandwidth capacity for the interconnect attachment. For attachments of type DEDICATED, the user can set the bandwidth. For attachments of type PARTNER, the Google Partner that is operating the interconnect must set the bandwidth. Output only for PARTNER type, mutable for PARTNER_PROVIDER and DEDICATED, and can take one of the following values: - BPS_50M: 50 Mbit/s - BPS_100M: 100 Mbit/s - BPS_200M: 200 Mbit/s - BPS_300M: 300 Mbit/s - BPS_400M: 400 Mbit/s - BPS_500M: 500 Mbit/s - BPS_1G: 1 Gbit/s - BPS_2G: 2 Gbit/s - BPS_5G: 5 Gbit/s - BPS_10G: 10 Gbit/s - BPS_20G: 20 Gbit/s - BPS_50G: 50 Gbit/s - BPS_100G: 100 Gbit/s ", "enum": [ "BPS_100G", "BPS_100M", @@ -68299,6 +68928,22 @@ ], "type": "string" }, + "candidateCloudRouterIpAddress": { + "description": "Single IPv4 address + prefix length to be configured on the cloud router interface for this interconnect attachment. - Both candidate_cloud_router_ip_address and candidate_customer_router_ip_address fields must be set or both must be unset. - Prefix length of both candidate_cloud_router_ip_address and candidate_customer_router_ip_address must be the same. - Max prefix length is 31. ", + "type": "string" + }, + "candidateCloudRouterIpv6Address": { + "description": "Single IPv6 address + prefix length to be configured on the cloud router interface for this interconnect attachment. - Both candidate_cloud_router_ipv6_address and candidate_customer_router_ipv6_address fields must be set or both must be unset. - Prefix length of both candidate_cloud_router_ipv6_address and candidate_customer_router_ipv6_address must be the same. - Max prefix length is 126. ", + "type": "string" + }, + "candidateCustomerRouterIpAddress": { + "description": "Single IPv4 address + prefix length to be configured on the customer router interface for this interconnect attachment.", + "type": "string" + }, + "candidateCustomerRouterIpv6Address": { + "description": "Single IPv6 address + prefix length to be configured on the customer router interface for this interconnect attachment.", + "type": "string" + }, "candidateIpv6Subnets": { "description": "This field is not available.", "items": { @@ -68307,7 +68952,7 @@ "type": "array" }, "candidateSubnets": { - "description": "Up to 16 candidate prefixes that can be used to restrict the allocation of cloudRouterIpAddress and customerRouterIpAddress for this attachment. All prefixes must be within link-local address space (169.254.0.0/16) and must be /29 or shorter (/28, /27, etc). Google will attempt to select an unused /29 from the supplied candidate prefix(es). The request will fail if all possible /29s are in use on Google's edge. If not supplied, Google will randomly select an unused /29 from all of link-local space.", + "description": "Input only. Up to 16 candidate prefixes that can be used to restrict the allocation of cloudRouterIpAddress and customerRouterIpAddress for this attachment. All prefixes must be within link-local address space (169.254.0.0/16) and must be /29 or shorter (/28, /27, etc). Google will attempt to select an unused /29 from the supplied candidate prefix(es). The request will fail if all possible /29s are in use on Google's edge. If not supplied, Google will randomly select an unused /29 from all of link-local space.", "items": { "type": "string" }, @@ -68355,7 +69000,7 @@ "type": "string" }, "edgeAvailabilityDomain": { - "description": "Desired availability domain for the attachment. Only available for type PARTNER, at creation time, and can take one of the following values: - AVAILABILITY_DOMAIN_ANY - AVAILABILITY_DOMAIN_1 - AVAILABILITY_DOMAIN_2 For improved reliability, customers should configure a pair of attachments, one per availability domain. The selected availability domain will be provided to the Partner via the pairing key, so that the provisioned circuit will lie in the specified domain. If not specified, the value will default to AVAILABILITY_DOMAIN_ANY.", + "description": "Input only. Desired availability domain for the attachment. Only available for type PARTNER, at creation time, and can take one of the following values: - AVAILABILITY_DOMAIN_ANY - AVAILABILITY_DOMAIN_1 - AVAILABILITY_DOMAIN_2 For improved reliability, customers should configure a pair of attachments, one per availability domain. The selected availability domain will be provided to the Partner via the pairing key, so that the provisioned circuit will lie in the specified domain. If not specified, the value will default to AVAILABILITY_DOMAIN_ANY.", "enum": [ "AVAILABILITY_DOMAIN_1", "AVAILABILITY_DOMAIN_2", @@ -68520,7 +69165,7 @@ "type": "string" }, "subnetLength": { - "description": "Length of the IPv4 subnet mask. Allowed values: - 29 (default) - 30 The default value is 29, except for Cross-Cloud Interconnect connections that use an InterconnectRemoteLocation with a constraints.subnetLengthRange.min equal to 30. For example, connections that use an Azure remote location fall into this category. In these cases, the default value is 30, and requesting 29 returns an error. Where both 29 and 30 are allowed, 29 is preferred, because it gives Google Cloud Support more debugging visibility. ", + "description": "Input only. Length of the IPv4 subnet mask. Allowed values: - 29 (default) - 30 The default value is 29, except for Cross-Cloud Interconnect connections that use an InterconnectRemoteLocation with a constraints.subnetLengthRange.min equal to 30. For example, connections that use an Azure remote location fall into this category. In these cases, the default value is 30, and requesting 29 returns an error. Where both 29 and 30 are allowed, 29 is preferred, because it gives Google Cloud Support more debugging visibility. ", "format": "int32", "type": "integer" }, @@ -68902,6 +69547,13 @@ }, "type": "array" }, + "regions": { + "description": "[Output Only] Regions used to explain this blocker in more detail. These are region names formatted like \"us-central1\". This will be set for some blockers (like INCOMPATIBLE_REGIONS) but does not apply to others.", + "items": { + "type": "string" + }, + "type": "array" + }, "zones": { "description": "[Output Only] Zones used to explain this blocker in more detail. Format is \"zone1\" and/or \"zone2\". This will be set for some blockers (like MISSING_ZONE) but does not apply to others.", "items": { @@ -69016,6 +69668,19 @@ }, "type": "object" }, + "InterconnectAttachmentGroupsGetOperationalStatusResponse": { + "description": "Response for the InterconnectAttachmentGroupsGetOperationalStatusResponse.", + "id": "InterconnectAttachmentGroupsGetOperationalStatusResponse", + "properties": { + "etag": { + "type": "string" + }, + "result": { + "$ref": "InterconnectAttachmentGroupsOperationalStatus" + } + }, + "type": "object" + }, "InterconnectAttachmentGroupsListResponse": { "id": "InterconnectAttachmentGroupsListResponse", "properties": { @@ -69179,6 +69844,28 @@ }, "type": "object" }, + "InterconnectAttachmentGroupsOperationalStatus": { + "id": "InterconnectAttachmentGroupsOperationalStatus", + "properties": { + "groupStatus": { + "description": "Summarizes the status of the group.", + "enum": [ + "DEGRADED", + "FULLY_DOWN", + "FULLY_UP", + "UNSPECIFIED" + ], + "enumDescriptions": [ + "", + "", + "", + "" + ], + "type": "string" + } + }, + "type": "object" + }, "InterconnectAttachmentList": { "description": "Response to the list request, and contains a list of interconnect attachments.", "id": "InterconnectAttachmentList", @@ -69960,6 +70647,19 @@ }, "type": "object" }, + "InterconnectGroupsGetOperationalStatusResponse": { + "description": "Response for the InterconnectGroupsGetOperationalStatusResponse.", + "id": "InterconnectGroupsGetOperationalStatusResponse", + "properties": { + "etag": { + "type": "string" + }, + "result": { + "$ref": "InterconnectGroupsOperationalStatus" + } + }, + "type": "object" + }, "InterconnectGroupsListResponse": { "id": "InterconnectGroupsListResponse", "properties": { @@ -70123,6 +70823,80 @@ }, "type": "object" }, + "InterconnectGroupsOperationalStatus": { + "description": "Request to get the status of the interconnect group with extra detail.", + "id": "InterconnectGroupsOperationalStatus", + "properties": { + "configured": { + "$ref": "InterconnectGroupConfigured", + "description": "The configuration analysis, as returned by Get." + }, + "groupStatus": { + "description": "Summarizes the status of the group.", + "enum": [ + "DEGRADED", + "FULLY_DOWN", + "FULLY_UP", + "GROUPS_STATUS_UNSPECIFIED" + ], + "enumDescriptions": [ + "", + "", + "", + "" + ], + "type": "string" + }, + "intent": { + "$ref": "InterconnectGroupIntent", + "description": "The intent of the resource, as returned by Get." + }, + "interconnectStatuses": { + "items": { + "$ref": "InterconnectGroupsOperationalStatusInterconnectStatus" + }, + "type": "array" + }, + "operational": { + "$ref": "InterconnectGroupConfigured", + "description": "The operational state of the group, including only active Interconnects." + } + }, + "type": "object" + }, + "InterconnectGroupsOperationalStatusInterconnectStatus": { + "description": "The status of one Interconnect in the group. The order is arbitrary.", + "id": "InterconnectGroupsOperationalStatusInterconnectStatus", + "properties": { + "adminEnabled": { + "description": "Whether the Interconnect is enabled.", + "type": "boolean" + }, + "diagnostics": { + "$ref": "InterconnectDiagnostics", + "description": "The diagnostics of the Interconnect, as returned by the existing get-diagnostics method." + }, + "interconnect": { + "description": "The URL of the Interconnect being described.", + "type": "string" + }, + "isActive": { + "description": "Whether this interconnect is participating in the redundant configuration.", + "enum": [ + "ACTIVE", + "INACTIVE", + "IS_ACTIVE_UNSPECIFIED" + ], + "enumDescriptions": [ + "", + "", + "" + ], + "type": "string" + } + }, + "type": "object" + }, "InterconnectList": { "description": "Response to the list request, and contains a list of interconnects.", "id": "InterconnectList", @@ -75596,292 +76370,471 @@ }, "type": "object" }, - "NetworkEndpointGroupPscData": { - "description": "All data that is specifically relevant to only network endpoint groups of type PRIVATE_SERVICE_CONNECT.", - "id": "NetworkEndpointGroupPscData", - "properties": { - "consumerPscAddress": { - "description": "[Output Only] Address allocated from given subnetwork for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in L7 PSC-XLB.", - "type": "string" - }, - "producerPort": { - "description": "The psc producer port is used to connect PSC NEG with specific port on the PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG type", - "format": "int32", - "type": "integer" - }, - "pscConnectionId": { - "description": "[Output Only] The PSC connection id of the PSC Network Endpoint Group Consumer.", - "format": "uint64", - "type": "string" - }, - "pscConnectionStatus": { - "description": "[Output Only] The connection status of the PSC Forwarding Rule.", - "enum": [ - "ACCEPTED", - "CLOSED", - "NEEDS_ATTENTION", - "PENDING", - "REJECTED", - "STATUS_UNSPECIFIED" - ], - "enumDescriptions": [ - "The connection has been accepted by the producer.", - "The connection has been closed by the producer and will not serve traffic going forward.", - "The connection has been accepted by the producer, but the producer needs to take further action before the forwarding rule can serve traffic.", - "The connection is pending acceptance by the producer.", - "The connection has been rejected by the producer.", - "" - ], - "type": "string" - } - }, - "type": "object" - }, - "NetworkEndpointGroupServerlessDeployment": { - "description": "Configuration for a serverless network endpoint group (NEG). The platform must be provided. Note: The target backend service must be in the same project and located in the same region as the Serverless NEG.", - "id": "NetworkEndpointGroupServerlessDeployment", - "properties": { - "platform": { - "description": "The platform of the backend target(s) of this NEG. The only supported value is API Gateway: apigateway.googleapis.com.", - "type": "string" - }, - "resource": { - "description": "The user-defined name of the workload/instance. This value must be provided explicitly or in the urlMask. The resource identified by this value is platform-specific and is as follows: 1. API Gateway: The gateway ID 2. App Engine: The service name 3. Cloud Functions: The function name 4. Cloud Run: The service name ", - "type": "string" - }, - "urlMask": { - "description": "An URL mask is one of the main components of the Cloud Function. A template to parse platform-specific fields from a request URL. URL mask allows for routing to multiple resources on the same serverless platform without having to create multiple Network Endpoint Groups and backend resources. The fields parsed by this template are platform-specific and are as follows: 1. API Gateway: The gateway ID 2. App Engine: The service and version 3. Cloud Functions: The function name 4. Cloud Run: The service and tag ", - "type": "string" - }, - "version": { - "description": "The optional resource version. The version identified by this value is platform-specific and is follows: 1. API Gateway: Unused 2. App Engine: The service version 3. Cloud Functions: Unused 4. Cloud Run: The service tag ", - "type": "string" - } - }, - "type": "object" - }, - "NetworkEndpointGroupsAttachEndpointsRequest": { - "id": "NetworkEndpointGroupsAttachEndpointsRequest", - "properties": { - "networkEndpoints": { - "description": "The list of network endpoints to be attached.", - "items": { - "$ref": "NetworkEndpoint" - }, - "type": "array" - } - }, - "type": "object" - }, - "NetworkEndpointGroupsDetachEndpointsRequest": { - "id": "NetworkEndpointGroupsDetachEndpointsRequest", - "properties": { - "networkEndpoints": { - "description": "The list of network endpoints to be detached.", - "items": { - "$ref": "NetworkEndpoint" - }, - "type": "array" - } - }, - "type": "object" - }, - "NetworkEndpointGroupsListEndpointsRequest": { - "id": "NetworkEndpointGroupsListEndpointsRequest", + "NetworkEndpointGroupPscData": { + "description": "All data that is specifically relevant to only network endpoint groups of type PRIVATE_SERVICE_CONNECT.", + "id": "NetworkEndpointGroupPscData", + "properties": { + "consumerPscAddress": { + "description": "[Output Only] Address allocated from given subnetwork for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in L7 PSC-XLB.", + "type": "string" + }, + "producerPort": { + "description": "The psc producer port is used to connect PSC NEG with specific port on the PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG type", + "format": "int32", + "type": "integer" + }, + "pscConnectionId": { + "description": "[Output Only] The PSC connection id of the PSC Network Endpoint Group Consumer.", + "format": "uint64", + "type": "string" + }, + "pscConnectionStatus": { + "description": "[Output Only] The connection status of the PSC Forwarding Rule.", + "enum": [ + "ACCEPTED", + "CLOSED", + "NEEDS_ATTENTION", + "PENDING", + "REJECTED", + "STATUS_UNSPECIFIED" + ], + "enumDescriptions": [ + "The connection has been accepted by the producer.", + "The connection has been closed by the producer and will not serve traffic going forward.", + "The connection has been accepted by the producer, but the producer needs to take further action before the forwarding rule can serve traffic.", + "The connection is pending acceptance by the producer.", + "The connection has been rejected by the producer.", + "" + ], + "type": "string" + } + }, + "type": "object" + }, + "NetworkEndpointGroupServerlessDeployment": { + "description": "Configuration for a serverless network endpoint group (NEG). The platform must be provided. Note: The target backend service must be in the same project and located in the same region as the Serverless NEG.", + "id": "NetworkEndpointGroupServerlessDeployment", + "properties": { + "platform": { + "description": "The platform of the backend target(s) of this NEG. The only supported value is API Gateway: apigateway.googleapis.com.", + "type": "string" + }, + "resource": { + "description": "The user-defined name of the workload/instance. This value must be provided explicitly or in the urlMask. The resource identified by this value is platform-specific and is as follows: 1. API Gateway: The gateway ID 2. App Engine: The service name 3. Cloud Functions: The function name 4. Cloud Run: The service name ", + "type": "string" + }, + "urlMask": { + "description": "An URL mask is one of the main components of the Cloud Function. A template to parse platform-specific fields from a request URL. URL mask allows for routing to multiple resources on the same serverless platform without having to create multiple Network Endpoint Groups and backend resources. The fields parsed by this template are platform-specific and are as follows: 1. API Gateway: The gateway ID 2. App Engine: The service and version 3. Cloud Functions: The function name 4. Cloud Run: The service and tag ", + "type": "string" + }, + "version": { + "description": "The optional resource version. The version identified by this value is platform-specific and is follows: 1. API Gateway: Unused 2. App Engine: The service version 3. Cloud Functions: Unused 4. Cloud Run: The service tag ", + "type": "string" + } + }, + "type": "object" + }, + "NetworkEndpointGroupsAttachEndpointsRequest": { + "id": "NetworkEndpointGroupsAttachEndpointsRequest", + "properties": { + "networkEndpoints": { + "description": "The list of network endpoints to be attached.", + "items": { + "$ref": "NetworkEndpoint" + }, + "type": "array" + } + }, + "type": "object" + }, + "NetworkEndpointGroupsDetachEndpointsRequest": { + "id": "NetworkEndpointGroupsDetachEndpointsRequest", + "properties": { + "networkEndpoints": { + "description": "The list of network endpoints to be detached.", + "items": { + "$ref": "NetworkEndpoint" + }, + "type": "array" + } + }, + "type": "object" + }, + "NetworkEndpointGroupsListEndpointsRequest": { + "id": "NetworkEndpointGroupsListEndpointsRequest", + "properties": { + "endpointFilters": { + "description": "Optional list of endpoints to query. This is a more efficient but also limited version of filter parameter. Endpoints in the filter must have ip_address and port fields populated, other fields are not supported.", + "items": { + "$ref": "NetworkEndpointGroupsListEndpointsRequestNetworkEndpointFilter" + }, + "type": "array" + }, + "healthStatus": { + "description": "Optional query parameter for showing the health status of each network endpoint. Valid options are SKIP or SHOW. If you don't specify this parameter, the health status of network endpoints will not be provided.", + "enum": [ + "SHOW", + "SKIP" + ], + "enumDescriptions": [ + "Show the health status for each network endpoint. Impacts latency of the call.", + "Health status for network endpoints will not be provided." + ], + "type": "string" + } + }, + "type": "object" + }, + "NetworkEndpointGroupsListEndpointsRequestNetworkEndpointFilter": { + "id": "NetworkEndpointGroupsListEndpointsRequestNetworkEndpointFilter", + "properties": { + "networkEndpoint": { + "$ref": "NetworkEndpoint" + } + }, + "type": "object" + }, + "NetworkEndpointGroupsListNetworkEndpoints": { + "id": "NetworkEndpointGroupsListNetworkEndpoints", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of NetworkEndpointWithHealthStatus resources.", + "items": { + "$ref": "NetworkEndpointWithHealthStatus" + }, + "type": "array" + }, + "kind": { + "default": "compute#networkEndpointGroupsListNetworkEndpoints", + "description": "[Output Only] The resource type, which is always compute#networkEndpointGroupsListNetworkEndpoints for the list of network endpoints in the specified network endpoint group.", + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g: regions.list).", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "type": "string" + }, + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", + "type": "string" + } + }, + "type": "object" + } + }, + "type": "object" + }, + "NetworkEndpointGroupsScopedList": { + "id": "NetworkEndpointGroupsScopedList", + "properties": { + "networkEndpointGroups": { + "description": "[Output Only] The list of network endpoint groups that are contained in this scope.", + "items": { + "$ref": "NetworkEndpointGroup" + }, + "type": "array" + }, + "warning": { + "description": "[Output Only] An informational warning that replaces the list of network endpoint groups when the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g: regions.list).", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "type": "string" + }, + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", + "type": "string" + } + }, + "type": "object" + } + }, + "type": "object" + }, + "NetworkEndpointWithHealthStatus": { + "id": "NetworkEndpointWithHealthStatus", "properties": { - "endpointFilters": { - "description": "Optional list of endpoints to query. This is a more efficient but also limited version of filter parameter. Endpoints in the filter must have ip_address and port fields populated, other fields are not supported.", + "healths": { + "description": "[Output only] The health status of network endpoint;", "items": { - "$ref": "NetworkEndpointGroupsListEndpointsRequestNetworkEndpointFilter" + "$ref": "HealthStatusForNetworkEndpoint" }, "type": "array" }, - "healthStatus": { - "description": "Optional query parameter for showing the health status of each network endpoint. Valid options are SKIP or SHOW. If you don't specify this parameter, the health status of network endpoints will not be provided.", - "enum": [ - "SHOW", - "SKIP" - ], - "enumDescriptions": [ - "Show the health status for each network endpoint. Impacts latency of the call.", - "Health status for network endpoints will not be provided." - ], - "type": "string" - } - }, - "type": "object" - }, - "NetworkEndpointGroupsListEndpointsRequestNetworkEndpointFilter": { - "id": "NetworkEndpointGroupsListEndpointsRequestNetworkEndpointFilter", - "properties": { "networkEndpoint": { - "$ref": "NetworkEndpoint" + "$ref": "NetworkEndpoint", + "description": "[Output only] The network endpoint;" } }, "type": "object" }, - "NetworkEndpointGroupsListNetworkEndpoints": { - "id": "NetworkEndpointGroupsListNetworkEndpoints", + "NetworkFirewallPolicyAggregatedList": { + "id": "NetworkFirewallPolicyAggregatedList", "properties": { "id": { "description": "[Output Only] Unique identifier for the resource; defined by the server.", "type": "string" }, "items": { - "description": "A list of NetworkEndpointWithHealthStatus resources.", - "items": { - "$ref": "NetworkEndpointWithHealthStatus" + "additionalProperties": { + "$ref": "FirewallPoliciesScopedList", + "description": "Name of the scope containing this set of addresses." }, - "type": "array" + "description": "A list of FirewallPoliciesScopedList resources.", + "type": "object" }, "kind": { - "default": "compute#networkEndpointGroupsListNetworkEndpoints", - "description": "[Output Only] The resource type, which is always compute#networkEndpointGroupsListNetworkEndpoints for the list of network endpoints in the specified network endpoint group.", + "default": "compute#networkFirewallPolicyAggregatedList", + "description": "[Output Only] Type of resource. Always compute#networkFirewallPoliciesAggregatedList for lists of network firewall policies.", "type": "string" }, "nextPageToken": { "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", "type": "string" }, - "warning": { - "description": "[Output Only] Informational warning message.", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "QUOTA_INFO_UNAVAILABLE", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "Quota information is not available to client requests (e.g: regions.list).", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "items": { - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - }, - "type": "object" - }, - "type": "array" - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - } - }, - "type": "object" - } - }, - "type": "object" - }, - "NetworkEndpointGroupsScopedList": { - "id": "NetworkEndpointGroupsScopedList", - "properties": { - "networkEndpointGroups": { - "description": "[Output Only] The list of network endpoint groups that are contained in this scope.", + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "unreachables": { + "description": "[Output Only] Unreachable resources.", "items": { - "$ref": "NetworkEndpointGroup" + "type": "string" }, "type": "array" }, "warning": { - "description": "[Output Only] An informational warning that replaces the list of network endpoint groups when the list is empty.", + "description": "[Output Only] Informational warning message.", "properties": { "code": { "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", @@ -76007,23 +76960,6 @@ }, "type": "object" }, - "NetworkEndpointWithHealthStatus": { - "id": "NetworkEndpointWithHealthStatus", - "properties": { - "healths": { - "description": "[Output only] The health status of network endpoint;", - "items": { - "$ref": "HealthStatusForNetworkEndpoint" - }, - "type": "array" - }, - "networkEndpoint": { - "$ref": "NetworkEndpoint", - "description": "[Output only] The network endpoint;" - } - }, - "type": "object" - }, "NetworkInterface": { "description": "A network interface resource attached to an instance.", "id": "NetworkInterface", @@ -87565,6 +88501,10 @@ ], "type": "string" }, + "gpuTopology": { + "description": "Specifies the shape of the GPU slice, in slice based GPU families eg. A4X.", + "type": "string" + }, "maxDistance": { "description": "Specifies the number of max logical switches.", "format": "int32", @@ -100011,7 +100951,7 @@ "type": "string" }, "sslCertificates": { - "description": "URLs to SslCertificate resources that are used to authenticate connections between users and the load balancer. At least one SSL certificate must be specified. SslCertificates do not apply when the load balancing scheme is set to INTERNAL_SELF_MANAGED. The URLs should refer to a SSL Certificate resource or Certificate Manager Certificate resource. Mixing Classic Certificates and Certificate Manager Certificates is not allowed. Certificate Manager Certificates must include the certificatemanager API. Certificate Manager Certificates are not supported by Global external Application Load Balancer or Classic Application Load Balancer, use certificate_map instead. Currently, you may specify up to 15 Classic SSL Certificates. Certificate Manager Certificates accepted formats are: - //certificatemanager.googleapis.com/projects/{project}/locations/{ location}/certificates/{resourceName}. - https://certificatemanager.googleapis.com/v1alpha1/projects/{project }/locations/{location}/certificates/{resourceName}. ", + "description": "URLs to SslCertificate resources that are used to authenticate connections between users and the load balancer. At least one SSL certificate must be specified. SslCertificates do not apply when the load balancing scheme is set to INTERNAL_SELF_MANAGED. The URLs should refer to a SSL Certificate resource or Certificate Manager Certificate resource. Mixing Classic Certificates and Certificate Manager Certificates is not allowed. Certificate Manager Certificates must include the certificatemanager API namespace. Using Certificate Manager Certificates in this field is not supported by Global external Application Load Balancer or Classic Application Load Balancer, use certificate_map instead. Currently, you may specify up to 15 Classic SSL Certificates or up to 100 Certificate Manager Certificates. Certificate Manager Certificates accepted formats are: - //certificatemanager.googleapis.com/projects/{project}/locations/{ location}/certificates/{resourceName}. - https://certificatemanager.googleapis.com/v1alpha1/projects/{project }/locations/{location}/certificates/{resourceName}. ", "items": { "type": "string" }, @@ -103970,7 +104910,7 @@ "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. In special cases listUsable may return 0 subnetworks and nextPageToken which still should be used to get the next page of results.", "type": "string" }, - "scoped_warnings": { + "scopedWarnings": { "description": "[Output Only] Informational warning messages for failures encountered from scopes.", "items": { "$ref": "SubnetworksScopedWarning" diff --git a/compute/v0.alpha/compute-gen.go b/compute/v0.alpha/compute-gen.go index abbc8220544..e662cb0a36e 100644 --- a/compute/v0.alpha/compute-gen.go +++ b/compute/v0.alpha/compute-gen.go @@ -148,6 +148,7 @@ func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, err s := &Service{client: client, BasePath: basePath, logger: internaloption.GetLogger(opts)} s.AcceleratorTypes = NewAcceleratorTypesService(s) s.Addresses = NewAddressesService(s) + s.Advice = NewAdviceService(s) s.Autoscalers = NewAutoscalersService(s) s.BackendBuckets = NewBackendBucketsService(s) s.BackendServices = NewBackendServicesService(s) @@ -294,6 +295,8 @@ type Service struct { Addresses *AddressesService + Advice *AdviceService + Autoscalers *AutoscalersService BackendBuckets *BackendBucketsService @@ -550,6 +553,15 @@ type AddressesService struct { s *Service } +func NewAdviceService(s *Service) *AdviceService { + rs := &AdviceService{s: s} + return rs +} + +type AdviceService struct { + s *Service +} + func NewAutoscalersService(s *Service) *AutoscalersService { rs := &AutoscalersService{s: s} return rs @@ -2216,8 +2228,8 @@ type AccessConfig struct { // If this field is unspecified in ipv6AccessConfig, a default PTR record will // be created for first IP in associated external IPv6 range. PublicPtrDomainName string `json:"publicPtrDomainName,omitempty"` - // SecurityPolicy: [Output Only] The resource URL for the security policy - // associated with this access config. + // SecurityPolicy: The resource URL for the security policy associated with + // this access config. SecurityPolicy string `json:"securityPolicy,omitempty"` // SetPublicDns: Specifies whether a public DNS 'A' record should be created // for the external IP address of this access configuration. @@ -3573,7 +3585,9 @@ type AttachedDiskInitializeParams struct { // initializeParams.sourceImage or disks.source is required. To create a disk // with a snapshot that you created, specify the snapshot name in the following // format: global/snapshots/my-backup If the source snapshot is deleted later, - // this field will not be set. + // this field will not be set. Note: You cannot create VMs in bulk using a + // snapshot as the source. Use an image instead when you create VMs using the + // bulk insert method. SourceSnapshot string `json:"sourceSnapshot,omitempty"` // SourceSnapshotEncryptionKey: The customer-supplied encryption key of the // source snapshot. @@ -8301,6 +8315,87 @@ func (s CacheKeyPolicy) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// CalendarModeAdviceRequest: A request to recommend the best way to consume +// the specified resources in the future. +type CalendarModeAdviceRequest struct { + // FutureResourcesSpecs: Specification of resources to create in the future. + // The key of the map is an arbitrary string specified by the caller. Value of + // the map is a specification of required resources and their constraints. + // Currently only one value is allowed in this map. + FutureResourcesSpecs map[string]FutureResourcesSpec `json:"futureResourcesSpecs,omitempty"` + // ForceSendFields is a list of field names (e.g. "FutureResourcesSpecs") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "FutureResourcesSpecs") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s CalendarModeAdviceRequest) MarshalJSON() ([]byte, error) { + type NoMethod CalendarModeAdviceRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// CalendarModeAdviceResponse: A response containing the recommended way of +// creating the specified resources in the future. It contains (will contain) +// multiple recommendations that can be analyzed by the customer and the best +// one can be picked. +type CalendarModeAdviceResponse struct { + // Recommendations: Recommendations where, how and when to create the requested + // resources in order to maximize their obtainability and minimize cost. + Recommendations []*CalendarModeRecommendation `json:"recommendations,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Recommendations") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Recommendations") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s CalendarModeAdviceResponse) MarshalJSON() ([]byte, error) { + type NoMethod CalendarModeAdviceResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// CalendarModeRecommendation: A single recommendation to create requested +// resources. Contains detailed recommendations for every future resources +// specification specified in CalendarModeAdviceRequest. +type CalendarModeRecommendation struct { + // RecommendationsPerSpec: Recommendations for every future resource + // specification passed in CalendarModeAdviceRequest. Keys of the map + // correspond to keys specified in the request. + RecommendationsPerSpec map[string]FutureResourcesRecommendation `json:"recommendationsPerSpec,omitempty"` + // ForceSendFields is a list of field names (e.g. "RecommendationsPerSpec") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "RecommendationsPerSpec") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s CalendarModeRecommendation) MarshalJSON() ([]byte, error) { + type NoMethod CalendarModeRecommendation + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // CallCredentials: [Deprecated] gRPC call credentials to access the SDS // server. gRPC call credentials to access the SDS server. type CallCredentials struct { @@ -11716,13 +11811,14 @@ type ErrorInfo struct { // unique value that identifies the infrastructure. For Google API // infrastructure, the error domain is "googleapis.com". Domain string `json:"domain,omitempty"` - // Metadatas: Additional structured details about this error. Keys must match - // /a-z+/ but should ideally be lowerCamelCase. Also they must be limited to 64 - // characters in length. When identifying the current value of an exceeded - // limit, the units should be contained in the key, not the value. For example, - // rather than {"instanceLimit": "100/request"}, should be returned as, - // {"instanceLimitPerRequest": "100"}, if the client exceeds the number of - // instances that can be created in a single (batch) request. + // Metadatas: Additional structured details about this error. Keys must match a + // regular expression of `a-z+` but should ideally be lowerCamelCase. Also, + // they must be limited to 64 characters in length. When identifying the + // current value of an exceeded limit, the units should be contained in the + // key, not the value. For example, rather than `{"instanceLimit": + // "100/request"}`, should be returned as, `{"instanceLimitPerRequest": + // "100"}`, if the client exceeds the number of instances that can be created + // in a single (batch) request. Metadatas map[string]string `json:"metadatas,omitempty"` // Reason: The reason of the error. This is a constant value that identifies // the proximate cause of the error. Error reasons are unique within a @@ -12726,6 +12822,147 @@ func (s FirewallPoliciesListAssociationsResponse) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type FirewallPoliciesScopedList struct { + // FirewallPolicies: A list of firewall policies contained in this scope. + FirewallPolicies []*FirewallPolicy `json:"firewallPolicies,omitempty"` + // Warning: Informational warning which replaces the list of firewall policies + // when the list is empty. + Warning *FirewallPoliciesScopedListWarning `json:"warning,omitempty"` + // ForceSendFields is a list of field names (e.g. "FirewallPolicies") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "FirewallPolicies") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s FirewallPoliciesScopedList) MarshalJSON() ([]byte, error) { + type NoMethod FirewallPoliciesScopedList + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// FirewallPoliciesScopedListWarning: Informational warning which replaces the +// list of firewall policies when the list is empty. +type FirewallPoliciesScopedListWarning struct { + // Code: [Output Only] A warning code, if applicable. For example, Compute + // Engine returns NO_RESULTS_ON_PAGE if there are no results in the response. + // + // Possible values: + // "CLEANUP_FAILED" - Warning about failed cleanup of transient changes made + // by a failed operation. + // "DEPRECATED_RESOURCE_USED" - A link to a deprecated resource was created. + // "DEPRECATED_TYPE_USED" - When deploying and at least one of the resources + // has a type marked as deprecated + // "DISK_SIZE_LARGER_THAN_IMAGE_SIZE" - The user created a boot disk that is + // larger than image size. + // "EXPERIMENTAL_TYPE_USED" - When deploying and at least one of the + // resources has a type marked as experimental + // "EXTERNAL_API_WARNING" - Warning that is present in an external api call + // "FIELD_VALUE_OVERRIDEN" - Warning that value of a field has been + // overridden. Deprecated unused field. + // "INJECTED_KERNELS_DEPRECATED" - The operation involved use of an injected + // kernel, which is deprecated. + // "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB" - A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // "LARGE_DEPLOYMENT_WARNING" - When deploying a deployment with a + // exceedingly large number of resources + // "LIST_OVERHEAD_QUOTA_EXCEED" - Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out by + // user-defined list filter. + // "MISSING_TYPE_DEPENDENCY" - A resource depends on a missing type + // "NEXT_HOP_ADDRESS_NOT_ASSIGNED" - The route's nextHopIp address is not + // assigned to an instance on the network. + // "NEXT_HOP_CANNOT_IP_FORWARD" - The route's next hop instance cannot ip + // forward. + // "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE" - The route's nextHopInstance + // URL refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // "NEXT_HOP_INSTANCE_NOT_FOUND" - The route's nextHopInstance URL refers to + // an instance that does not exist. + // "NEXT_HOP_INSTANCE_NOT_ON_NETWORK" - The route's nextHopInstance URL + // refers to an instance that is not on the same network as the route. + // "NEXT_HOP_NOT_RUNNING" - The route's next hop instance does not have a + // status of RUNNING. + // "NOT_CRITICAL_ERROR" - Error which is not critical. We decided to continue + // the process despite the mentioned error. + // "NO_RESULTS_ON_PAGE" - No results are present on a particular list page. + // "PARTIAL_SUCCESS" - Success is reported, but some results may be missing + // due to errors + // "QUOTA_INFO_UNAVAILABLE" - Quota information is not available to client + // requests (e.g: regions.list). + // "REQUIRED_TOS_AGREEMENT" - The user attempted to use a resource that + // requires a TOS they have not accepted. + // "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING" - Warning that a resource is + // in use. + // "RESOURCE_NOT_DELETED" - One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // "SCHEMA_VALIDATION_IGNORED" - When a resource schema validation is + // ignored. + // "SINGLE_INSTANCE_PROPERTY_TEMPLATE" - Instance template used in instance + // group manager is valid as such, but its application does not make a lot of + // sense, because it allows only single instance in instance group. + // "UNDECLARED_PROPERTIES" - When undeclared properties in the schema are + // present + // "UNREACHABLE" - A given scope cannot be reached. + Code string `json:"code,omitempty"` + // Data: [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + Data []*FirewallPoliciesScopedListWarningData `json:"data,omitempty"` + // Message: [Output Only] A human-readable description of the warning code. + Message string `json:"message,omitempty"` + // ForceSendFields is a list of field names (e.g. "Code") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Code") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s FirewallPoliciesScopedListWarning) MarshalJSON() ([]byte, error) { + type NoMethod FirewallPoliciesScopedListWarning + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type FirewallPoliciesScopedListWarningData struct { + // Key: [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a list + // request for a particular zone, this key might be scope and the key value + // might be the zone name. Other examples might be a key indicating a + // deprecated resource and a suggested replacement, or a warning about invalid + // network settings (for example, if an instance attempts to perform IP + // forwarding but is not enabled for IP forwarding). + Key string `json:"key,omitempty"` + // Value: [Output Only] A warning data value corresponding to the key. + Value string `json:"value,omitempty"` + // ForceSendFields is a list of field names (e.g. "Key") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Key") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s FirewallPoliciesScopedListWarningData) MarshalJSON() ([]byte, error) { + type NoMethod FirewallPoliciesScopedListWarningData + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // FirewallPolicy: Represents a Firewall Policy resource. type FirewallPolicy struct { // Associations: A list of associations that belong to this firewall policy. @@ -13297,6 +13534,36 @@ func (s FixedOrPercent) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// FlexibleTimeRange: A flexible specification of a time range that has 3 +// points of flexibility: (1) a flexible start time, (2) a flexible end time, +// (3) a flexible duration. It is possible to specify a contradictory time +// range that cannot be matched by any Interval. This causes a validation +// error. +type FlexibleTimeRange struct { + EndTimeNotEarlierThan string `json:"endTimeNotEarlierThan,omitempty"` + EndTimeNotLaterThan string `json:"endTimeNotLaterThan,omitempty"` + MaxDuration string `json:"maxDuration,omitempty"` + MinDuration string `json:"minDuration,omitempty"` + StartTimeNotEarlierThan string `json:"startTimeNotEarlierThan,omitempty"` + StartTimeNotLaterThan string `json:"startTimeNotLaterThan,omitempty"` + // ForceSendFields is a list of field names (e.g. "EndTimeNotEarlierThan") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "EndTimeNotEarlierThan") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s FlexibleTimeRange) MarshalJSON() ([]byte, error) { + type NoMethod FlexibleTimeRange + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ForwardingRule: Represents a Forwarding Rule resource. Forwarding rule // resources in Google Cloud can be either regional or global in scope: * // Global @@ -14312,8 +14579,6 @@ func (s FutureReservation) MarshalJSON() ([]byte, error) { type FutureReservationCommitmentInfo struct { // CommitmentName: name of the commitment where capacity is being delivered to. - // In the form of - // "projects/{project-id}/locations/{region-name}/commitment/{name}" CommitmentName string `json:"commitmentName,omitempty"` // CommitmentPlan: Indicates if a Commitment needs to be created as part of FR // delivery. If this field is not present, then no commitment needs to be @@ -15094,6 +15359,302 @@ func (s FutureReservationsScopedListWarningData) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// FutureResourcesRecommendation: Recommendation for single resources +// specification, to be created in the future. +type FutureResourcesRecommendation struct { + EndTime string `json:"endTime,omitempty"` + // Location: The advised location for resource usage. When a zone, in format + // 'zones/'. If not set, it means that no location is recommended - see + // other_locations for details. + Location string `json:"location,omitempty"` + // OtherLocations: List of locations in the request scope that were not + // recommended. Keys of the map are zones, in format 'zones/'. The values are + // status information indicating the recommendation status. + OtherLocations map[string]FutureResourcesRecommendationOtherLocation `json:"otherLocations,omitempty"` + // RecommendationId: Unique id of the recommendation, a UUID string generated + // by the API. + RecommendationId string `json:"recommendationId,omitempty"` + // RecommendationType: Type of recommendation. Currently only + // FUTURE_RESERVATION is supported. + // + // Possible values: + // "FUTURE_RESERVATION" - A Future Reservation is recommended. + // "RECOMMENDATION_TYPE_UNSPECIFIED" - Default value, unused. + RecommendationType string `json:"recommendationType,omitempty"` + StartTime string `json:"startTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "EndTime") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "EndTime") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s FutureResourcesRecommendation) MarshalJSON() ([]byte, error) { + type NoMethod FutureResourcesRecommendation + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// FutureResourcesRecommendationOtherLocation: Information about recommendation +// status for locations that were allowed but not used by the response. +type FutureResourcesRecommendationOtherLocation struct { + // Details: Details (human readable) describing the situation. For example, if + // status is CONDITION_NOT_MET, then details contain information about the + // parameters of the time window that did not meet the required conditions. + Details string `json:"details,omitempty"` + // Status: Status of recommendation in this location. + // + // Possible values: + // "CONDITIONS_NOT_MET" - The requested resources are offered in this + // location but the requested time window is does not meet the required + // conditions. + // "NOT_SUPPORTED" - The requested resources are not offered in this + // location. Retrying the request will not change this status. + // "NO_CAPACITY" - The requested resources are offered in this location and + // the requested time window is accepted but there is no capacity within the + // requested time window. + // "OTHER_LOCATION_STATUS_UNDEFINED" - Default value, unused. + // "RECOMMENDED" - The requested resources are offered in this location and + // it is possible to request them. However, another location was better and was + // recommended. + Status string `json:"status,omitempty"` + // ForceSendFields is a list of field names (e.g. "Details") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Details") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s FutureResourcesRecommendationOtherLocation) MarshalJSON() ([]byte, error) { + type NoMethod FutureResourcesRecommendationOtherLocation + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// FutureResourcesSpec: Specification of resources to be created at some time +// in the future within an optionally specified set of locations, and within +// the specified time range. +type FutureResourcesSpec struct { + // DeploymentType: Indicates if the reservation allocation strategy is static + // (DENSE) or dynamic (STANDARD). Defaults to DENSE. + // + // Possible values: + // "DENSE" - The reserved capacity is made up of densely deployed reservation + // blocks. + // "DEPLOYMENT_TYPE_UNSPECIFIED" + // "FLEXIBLE" - The reserved capacity is made up of highly flexible, logical + // reservation blocks. + DeploymentType string `json:"deploymentType,omitempty"` + // LocationPolicy: Optional location policy allowing to exclude some zone(s) in + // which the resources must not be created. + LocationPolicy *FutureResourcesSpecLocationPolicy `json:"locationPolicy,omitempty"` + // TargetResources: Specification of the reserved resources. + TargetResources *FutureResourcesSpecTargetResources `json:"targetResources,omitempty"` + // TimeRangeSpec: Specification of a time range in which the resources may be + // created. The time range specifies start of resource use and planned end of + // resource use. + TimeRangeSpec *FlexibleTimeRange `json:"timeRangeSpec,omitempty"` + // ForceSendFields is a list of field names (e.g. "DeploymentType") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "DeploymentType") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s FutureResourcesSpec) MarshalJSON() ([]byte, error) { + type NoMethod FutureResourcesSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type FutureResourcesSpecAggregateResources struct { + // AcceleratorCount: Size of the request, in accelerator (chip) count. + AcceleratorCount int64 `json:"acceleratorCount,omitempty,string"` + // VmFamily: The VM family that all instances scheduled against this + // reservation must belong to. Use for TPU reservations. + // + // Possible values: + // "VM_FAMILY_CLOUD_TPU_DEVICE_CT3" + // "VM_FAMILY_CLOUD_TPU_LITE_DEVICE_CT5L" + // "VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT5LP" + // "VM_FAMILY_CLOUD_TPU_POD_SLICE_CT3P" + // "VM_FAMILY_CLOUD_TPU_POD_SLICE_CT4P" + VmFamily string `json:"vmFamily,omitempty"` + // WorkloadType: Workload type. Use for TPU reservations. + // + // Possible values: + // "BATCH" - Reserved resources will be optimized for BATCH workloads, such + // as ML training. + // "SERVING" - Reserved resources will be optimized for SERVING workloads, + // such as ML inference. + // "UNSPECIFIED" + WorkloadType string `json:"workloadType,omitempty"` + // ForceSendFields is a list of field names (e.g. "AcceleratorCount") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AcceleratorCount") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s FutureResourcesSpecAggregateResources) MarshalJSON() ([]byte, error) { + type NoMethod FutureResourcesSpecAggregateResources + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type FutureResourcesSpecLocalSsdPartition struct { + // DiskInterface: Disk interface. Defaults to SCSI. + // + // Possible values: + // "NVDIMM" + // "NVME" + // "SCSI" + DiskInterface string `json:"diskInterface,omitempty"` + // DiskSizeGb: The size of the disk in GB. + DiskSizeGb int64 `json:"diskSizeGb,omitempty,string"` + // ForceSendFields is a list of field names (e.g. "DiskInterface") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "DiskInterface") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s FutureResourcesSpecLocalSsdPartition) MarshalJSON() ([]byte, error) { + type NoMethod FutureResourcesSpecLocalSsdPartition + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// FutureResourcesSpecLocationPolicy: Specification of locations to create +// resources in. +type FutureResourcesSpecLocationPolicy struct { + // Locations: Preferences for specified locations. Keys of the map are + // locations - zones, in format of 'zones/'. Values are preferences for the + // zones. If a zone is not specified in this map, it is ALLOWed. + Locations map[string]FutureResourcesSpecLocationPolicyLocation `json:"locations,omitempty"` + // ForceSendFields is a list of field names (e.g. "Locations") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Locations") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s FutureResourcesSpecLocationPolicy) MarshalJSON() ([]byte, error) { + type NoMethod FutureResourcesSpecLocationPolicy + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// FutureResourcesSpecLocationPolicyLocation: Preference for a single specified +// location. +type FutureResourcesSpecLocationPolicyLocation struct { + // Preference: Preference for this location. + // + // Possible values: + // "ALLOW" - Location is allowed for use. + // "DENY" - Location is prohibited. + // "PREFERENCE_UNSPECIFIED" - Default value, unused. + Preference string `json:"preference,omitempty"` + // ForceSendFields is a list of field names (e.g. "Preference") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Preference") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s FutureResourcesSpecLocationPolicyLocation) MarshalJSON() ([]byte, error) { + type NoMethod FutureResourcesSpecLocationPolicyLocation + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type FutureResourcesSpecSpecificSKUResources struct { + // InstanceCount: Size of the request, in instance count. + InstanceCount int64 `json:"instanceCount,omitempty,string"` + // LocalSsdPartitions: Local SSD partitions. You do not have to include SSD + // partitions that are built in the machine type. + LocalSsdPartitions []*FutureResourcesSpecLocalSsdPartition `json:"localSsdPartitions,omitempty"` + // MachineType: The machine type to use for instances that will use the + // reservation. This field only accepts machine type names. e.g. n2-standard-4 + // and does not accept machine type full or partial url. e.g. + // projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4. + // Use for GPU reservations. + MachineType string `json:"machineType,omitempty"` + // ForceSendFields is a list of field names (e.g. "InstanceCount") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "InstanceCount") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s FutureResourcesSpecSpecificSKUResources) MarshalJSON() ([]byte, error) { + type NoMethod FutureResourcesSpecSpecificSKUResources + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// FutureResourcesSpecTargetResources: Specification of reserved resources. +type FutureResourcesSpecTargetResources struct { + AggregateResources *FutureResourcesSpecAggregateResources `json:"aggregateResources,omitempty"` + SpecificSkuResources *FutureResourcesSpecSpecificSKUResources `json:"specificSkuResources,omitempty"` + // ForceSendFields is a list of field names (e.g. "AggregateResources") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AggregateResources") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s FutureResourcesSpecTargetResources) MarshalJSON() ([]byte, error) { + type NoMethod FutureResourcesSpecTargetResources + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type GRPCHealthCheck struct { // GrpcServiceName: The gRPC service name for the health check. This field is // optional. The value of grpc_service_name has the following meanings by @@ -25835,7 +26396,7 @@ type InterconnectAttachment struct { // values: - BPS_50M: 50 Mbit/s - BPS_100M: 100 Mbit/s - BPS_200M: 200 Mbit/s - // BPS_300M: 300 Mbit/s - BPS_400M: 400 Mbit/s - BPS_500M: 500 Mbit/s - BPS_1G: // 1 Gbit/s - BPS_2G: 2 Gbit/s - BPS_5G: 5 Gbit/s - BPS_10G: 10 Gbit/s - - // BPS_20G: 20 Gbit/s - BPS_50G: 50 Gbit/s + // BPS_20G: 20 Gbit/s - BPS_50G: 50 Gbit/s - BPS_100G: 100 Gbit/s // // Possible values: // "BPS_100G" - 100 Gbit/s @@ -25852,16 +26413,40 @@ type InterconnectAttachment struct { // "BPS_50M" - 50 Mbit/s // "BPS_5G" - 5 Gbit/s Bandwidth string `json:"bandwidth,omitempty"` + // CandidateCloudRouterIpAddress: Single IPv4 address + prefix length to be + // configured on the cloud router interface for this interconnect attachment. - + // Both candidate_cloud_router_ip_address and + // candidate_customer_router_ip_address fields must be set or both must be + // unset. - Prefix length of both candidate_cloud_router_ip_address and + // candidate_customer_router_ip_address must be the same. - Max prefix length + // is 31. + CandidateCloudRouterIpAddress string `json:"candidateCloudRouterIpAddress,omitempty"` + // CandidateCloudRouterIpv6Address: Single IPv6 address + prefix length to be + // configured on the cloud router interface for this interconnect attachment. - + // Both candidate_cloud_router_ipv6_address and + // candidate_customer_router_ipv6_address fields must be set or both must be + // unset. - Prefix length of both candidate_cloud_router_ipv6_address and + // candidate_customer_router_ipv6_address must be the same. - Max prefix length + // is 126. + CandidateCloudRouterIpv6Address string `json:"candidateCloudRouterIpv6Address,omitempty"` + // CandidateCustomerRouterIpAddress: Single IPv4 address + prefix length to be + // configured on the customer router interface for this interconnect + // attachment. + CandidateCustomerRouterIpAddress string `json:"candidateCustomerRouterIpAddress,omitempty"` + // CandidateCustomerRouterIpv6Address: Single IPv6 address + prefix length to + // be configured on the customer router interface for this interconnect + // attachment. + CandidateCustomerRouterIpv6Address string `json:"candidateCustomerRouterIpv6Address,omitempty"` // CandidateIpv6Subnets: This field is not available. CandidateIpv6Subnets []string `json:"candidateIpv6Subnets,omitempty"` - // CandidateSubnets: Up to 16 candidate prefixes that can be used to restrict - // the allocation of cloudRouterIpAddress and customerRouterIpAddress for this - // attachment. All prefixes must be within link-local address space - // (169.254.0.0/16) and must be /29 or shorter (/28, /27, etc). Google will - // attempt to select an unused /29 from the supplied candidate prefix(es). The - // request will fail if all possible /29s are in use on Google's edge. If not - // supplied, Google will randomly select an unused /29 from all of link-local - // space. + // CandidateSubnets: Input only. Up to 16 candidate prefixes that can be used + // to restrict the allocation of cloudRouterIpAddress and + // customerRouterIpAddress for this attachment. All prefixes must be within + // link-local address space (169.254.0.0/16) and must be /29 or shorter (/28, + // /27, etc). Google will attempt to select an unused /29 from the supplied + // candidate prefix(es). The request will fail if all possible /29s are in use + // on Google's edge. If not supplied, Google will randomly select an unused /29 + // from all of link-local space. CandidateSubnets []string `json:"candidateSubnets,omitempty"` // CloudRouterIpAddress: [Output Only] IPv4 address + prefix length to be // configured on Cloud Router Interface for this interconnect attachment. @@ -25893,14 +26478,14 @@ type InterconnectAttachment struct { DataplaneVersion int64 `json:"dataplaneVersion,omitempty"` // Description: An optional description of this resource. Description string `json:"description,omitempty"` - // EdgeAvailabilityDomain: Desired availability domain for the attachment. Only - // available for type PARTNER, at creation time, and can take one of the - // following values: - AVAILABILITY_DOMAIN_ANY - AVAILABILITY_DOMAIN_1 - - // AVAILABILITY_DOMAIN_2 For improved reliability, customers should configure a - // pair of attachments, one per availability domain. The selected availability - // domain will be provided to the Partner via the pairing key, so that the - // provisioned circuit will lie in the specified domain. If not specified, the - // value will default to AVAILABILITY_DOMAIN_ANY. + // EdgeAvailabilityDomain: Input only. Desired availability domain for the + // attachment. Only available for type PARTNER, at creation time, and can take + // one of the following values: - AVAILABILITY_DOMAIN_ANY - + // AVAILABILITY_DOMAIN_1 - AVAILABILITY_DOMAIN_2 For improved reliability, + // customers should configure a pair of attachments, one per availability + // domain. The selected availability domain will be provided to the Partner via + // the pairing key, so that the provisioned circuit will lie in the specified + // domain. If not specified, the value will default to AVAILABILITY_DOMAIN_ANY. // // Possible values: // "AVAILABILITY_DOMAIN_1" @@ -26080,9 +26665,9 @@ type InterconnectAttachment struct { // "UNPROVISIONED" - Indicates that attachment is not ready to use yet, // because turnup is not complete. State string `json:"state,omitempty"` - // SubnetLength: Length of the IPv4 subnet mask. Allowed values: - 29 (default) - // - 30 The default value is 29, except for Cross-Cloud Interconnect - // connections that use an InterconnectRemoteLocation with a + // SubnetLength: Input only. Length of the IPv4 subnet mask. Allowed values: - + // 29 (default) - 30 The default value is 29, except for Cross-Cloud + // Interconnect connections that use an InterconnectRemoteLocation with a // constraints.subnetLengthRange.min equal to 30. For example, connections that // use an Azure remote location fall into this category. In these cases, the // default value is 30, and requesting 29 returns an error. Where both 29 and @@ -26516,6 +27101,10 @@ type InterconnectAttachmentGroupConfiguredAvailabilitySLAIntendedSlaBlockers str // some blockers (like NO_ATTACHMENTS_IN_METRO_AND_ZONE) but does not apply to // others. Metros []string `json:"metros,omitempty"` + // Regions: [Output Only] Regions used to explain this blocker in more detail. + // These are region names formatted like "us-central1". This will be set for + // some blockers (like INCOMPATIBLE_REGIONS) but does not apply to others. + Regions []string `json:"regions,omitempty"` // Zones: [Output Only] Zones used to explain this blocker in more detail. // Format is "zone1" and/or "zone2". This will be set for some blockers (like // MISSING_ZONE) but does not apply to others. @@ -26691,6 +27280,32 @@ func (s InterconnectAttachmentGroupLogicalStructureRegionMetroFacilityZone) Mars return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// InterconnectAttachmentGroupsGetOperationalStatusResponse: Response for the +// InterconnectAttachmentGroupsGetOperationalStatusResponse. +type InterconnectAttachmentGroupsGetOperationalStatusResponse struct { + Etag string `json:"etag,omitempty"` + Result *InterconnectAttachmentGroupsOperationalStatus `json:"result,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Etag") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Etag") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s InterconnectAttachmentGroupsGetOperationalStatusResponse) MarshalJSON() ([]byte, error) { + type NoMethod InterconnectAttachmentGroupsGetOperationalStatusResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type InterconnectAttachmentGroupsListResponse struct { Etag string `json:"etag,omitempty"` // Id: [Output Only] Unique identifier for the resource; defined by the server. @@ -26849,6 +27464,33 @@ func (s InterconnectAttachmentGroupsListResponseWarningData) MarshalJSON() ([]by return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type InterconnectAttachmentGroupsOperationalStatus struct { + // GroupStatus: Summarizes the status of the group. + // + // Possible values: + // "DEGRADED" + // "FULLY_DOWN" + // "FULLY_UP" + // "UNSPECIFIED" + GroupStatus string `json:"groupStatus,omitempty"` + // ForceSendFields is a list of field names (e.g. "GroupStatus") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "GroupStatus") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s InterconnectAttachmentGroupsOperationalStatus) MarshalJSON() ([]byte, error) { + type NoMethod InterconnectAttachmentGroupsOperationalStatus + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // InterconnectAttachmentList: Response to the list request, and contains a // list of interconnect attachments. type InterconnectAttachmentList struct { @@ -27790,6 +28432,32 @@ func (s InterconnectGroupPhysicalStructureMetrosFacilitiesZones) MarshalJSON() ( return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// InterconnectGroupsGetOperationalStatusResponse: Response for the +// InterconnectGroupsGetOperationalStatusResponse. +type InterconnectGroupsGetOperationalStatusResponse struct { + Etag string `json:"etag,omitempty"` + Result *InterconnectGroupsOperationalStatus `json:"result,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Etag") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Etag") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s InterconnectGroupsGetOperationalStatusResponse) MarshalJSON() ([]byte, error) { + type NoMethod InterconnectGroupsGetOperationalStatusResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type InterconnectGroupsListResponse struct { Etag string `json:"etag,omitempty"` // Id: [Output Only] Unique identifier for the resource; defined by the server. @@ -27948,6 +28616,79 @@ func (s InterconnectGroupsListResponseWarningData) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// InterconnectGroupsOperationalStatus: Request to get the status of the +// interconnect group with extra detail. +type InterconnectGroupsOperationalStatus struct { + // Configured: The configuration analysis, as returned by Get. + Configured *InterconnectGroupConfigured `json:"configured,omitempty"` + // GroupStatus: Summarizes the status of the group. + // + // Possible values: + // "DEGRADED" + // "FULLY_DOWN" + // "FULLY_UP" + // "GROUPS_STATUS_UNSPECIFIED" + GroupStatus string `json:"groupStatus,omitempty"` + // Intent: The intent of the resource, as returned by Get. + Intent *InterconnectGroupIntent `json:"intent,omitempty"` + InterconnectStatuses []*InterconnectGroupsOperationalStatusInterconnectStatus `json:"interconnectStatuses,omitempty"` + // Operational: The operational state of the group, including only active + // Interconnects. + Operational *InterconnectGroupConfigured `json:"operational,omitempty"` + // ForceSendFields is a list of field names (e.g. "Configured") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Configured") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s InterconnectGroupsOperationalStatus) MarshalJSON() ([]byte, error) { + type NoMethod InterconnectGroupsOperationalStatus + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// InterconnectGroupsOperationalStatusInterconnectStatus: The status of one +// Interconnect in the group. The order is arbitrary. +type InterconnectGroupsOperationalStatusInterconnectStatus struct { + // AdminEnabled: Whether the Interconnect is enabled. + AdminEnabled bool `json:"adminEnabled,omitempty"` + // Diagnostics: The diagnostics of the Interconnect, as returned by the + // existing get-diagnostics method. + Diagnostics *InterconnectDiagnostics `json:"diagnostics,omitempty"` + // Interconnect: The URL of the Interconnect being described. + Interconnect string `json:"interconnect,omitempty"` + // IsActive: Whether this interconnect is participating in the redundant + // configuration. + // + // Possible values: + // "ACTIVE" + // "INACTIVE" + // "IS_ACTIVE_UNSPECIFIED" + IsActive string `json:"isActive,omitempty"` + // ForceSendFields is a list of field names (e.g. "AdminEnabled") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AdminEnabled") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s InterconnectGroupsOperationalStatusInterconnectStatus) MarshalJSON() ([]byte, error) { + type NoMethod InterconnectGroupsOperationalStatusInterconnectStatus + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // InterconnectList: Response to the list request, and contains a list of // interconnects. type InterconnectList struct { @@ -34399,6 +35140,165 @@ func (s NetworkEndpointWithHealthStatus) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type NetworkFirewallPolicyAggregatedList struct { + // Id: [Output Only] Unique identifier for the resource; defined by the server. + Id string `json:"id,omitempty"` + // Items: A list of FirewallPoliciesScopedList resources. + Items map[string]FirewallPoliciesScopedList `json:"items,omitempty"` + // Kind: [Output Only] Type of resource. Always + // compute#networkFirewallPoliciesAggregatedList for lists of network firewall + // policies. + Kind string `json:"kind,omitempty"` + // NextPageToken: [Output Only] This token allows you to get the next page of + // results for list requests. If the number of results is larger than + // maxResults, use the nextPageToken as a value for the query parameter + // pageToken in the next list request. Subsequent list requests will have their + // own nextPageToken to continue paging through the results. + NextPageToken string `json:"nextPageToken,omitempty"` + // SelfLink: [Output Only] Server-defined URL for this resource. + SelfLink string `json:"selfLink,omitempty"` + // Unreachables: [Output Only] Unreachable resources. + Unreachables []string `json:"unreachables,omitempty"` + // Warning: [Output Only] Informational warning message. + Warning *NetworkFirewallPolicyAggregatedListWarning `json:"warning,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Id") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Id") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s NetworkFirewallPolicyAggregatedList) MarshalJSON() ([]byte, error) { + type NoMethod NetworkFirewallPolicyAggregatedList + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// NetworkFirewallPolicyAggregatedListWarning: [Output Only] Informational +// warning message. +type NetworkFirewallPolicyAggregatedListWarning struct { + // Code: [Output Only] A warning code, if applicable. For example, Compute + // Engine returns NO_RESULTS_ON_PAGE if there are no results in the response. + // + // Possible values: + // "CLEANUP_FAILED" - Warning about failed cleanup of transient changes made + // by a failed operation. + // "DEPRECATED_RESOURCE_USED" - A link to a deprecated resource was created. + // "DEPRECATED_TYPE_USED" - When deploying and at least one of the resources + // has a type marked as deprecated + // "DISK_SIZE_LARGER_THAN_IMAGE_SIZE" - The user created a boot disk that is + // larger than image size. + // "EXPERIMENTAL_TYPE_USED" - When deploying and at least one of the + // resources has a type marked as experimental + // "EXTERNAL_API_WARNING" - Warning that is present in an external api call + // "FIELD_VALUE_OVERRIDEN" - Warning that value of a field has been + // overridden. Deprecated unused field. + // "INJECTED_KERNELS_DEPRECATED" - The operation involved use of an injected + // kernel, which is deprecated. + // "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB" - A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // "LARGE_DEPLOYMENT_WARNING" - When deploying a deployment with a + // exceedingly large number of resources + // "LIST_OVERHEAD_QUOTA_EXCEED" - Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out by + // user-defined list filter. + // "MISSING_TYPE_DEPENDENCY" - A resource depends on a missing type + // "NEXT_HOP_ADDRESS_NOT_ASSIGNED" - The route's nextHopIp address is not + // assigned to an instance on the network. + // "NEXT_HOP_CANNOT_IP_FORWARD" - The route's next hop instance cannot ip + // forward. + // "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE" - The route's nextHopInstance + // URL refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // "NEXT_HOP_INSTANCE_NOT_FOUND" - The route's nextHopInstance URL refers to + // an instance that does not exist. + // "NEXT_HOP_INSTANCE_NOT_ON_NETWORK" - The route's nextHopInstance URL + // refers to an instance that is not on the same network as the route. + // "NEXT_HOP_NOT_RUNNING" - The route's next hop instance does not have a + // status of RUNNING. + // "NOT_CRITICAL_ERROR" - Error which is not critical. We decided to continue + // the process despite the mentioned error. + // "NO_RESULTS_ON_PAGE" - No results are present on a particular list page. + // "PARTIAL_SUCCESS" - Success is reported, but some results may be missing + // due to errors + // "QUOTA_INFO_UNAVAILABLE" - Quota information is not available to client + // requests (e.g: regions.list). + // "REQUIRED_TOS_AGREEMENT" - The user attempted to use a resource that + // requires a TOS they have not accepted. + // "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING" - Warning that a resource is + // in use. + // "RESOURCE_NOT_DELETED" - One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // "SCHEMA_VALIDATION_IGNORED" - When a resource schema validation is + // ignored. + // "SINGLE_INSTANCE_PROPERTY_TEMPLATE" - Instance template used in instance + // group manager is valid as such, but its application does not make a lot of + // sense, because it allows only single instance in instance group. + // "UNDECLARED_PROPERTIES" - When undeclared properties in the schema are + // present + // "UNREACHABLE" - A given scope cannot be reached. + Code string `json:"code,omitempty"` + // Data: [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + Data []*NetworkFirewallPolicyAggregatedListWarningData `json:"data,omitempty"` + // Message: [Output Only] A human-readable description of the warning code. + Message string `json:"message,omitempty"` + // ForceSendFields is a list of field names (e.g. "Code") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Code") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s NetworkFirewallPolicyAggregatedListWarning) MarshalJSON() ([]byte, error) { + type NoMethod NetworkFirewallPolicyAggregatedListWarning + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type NetworkFirewallPolicyAggregatedListWarningData struct { + // Key: [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a list + // request for a particular zone, this key might be scope and the key value + // might be the zone name. Other examples might be a key indicating a + // deprecated resource and a suggested replacement, or a warning about invalid + // network settings (for example, if an instance attempts to perform IP + // forwarding but is not enabled for IP forwarding). + Key string `json:"key,omitempty"` + // Value: [Output Only] A warning data value corresponding to the key. + Value string `json:"value,omitempty"` + // ForceSendFields is a list of field names (e.g. "Key") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Key") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s NetworkFirewallPolicyAggregatedListWarningData) MarshalJSON() ([]byte, error) { + type NoMethod NetworkFirewallPolicyAggregatedListWarningData + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // NetworkInterface: A network interface resource attached to an instance. type NetworkInterface struct { // AccessConfigs: An array of configurations for this interface. Currently, @@ -46561,6 +47461,9 @@ type ResourcePolicyGroupPlacementPolicy struct { // clusters. // "UNSPECIFIED_COLLOCATION" Collocation string `json:"collocation,omitempty"` + // GpuTopology: Specifies the shape of the GPU slice, in slice based GPU + // families eg. A4X. + GpuTopology string `json:"gpuTopology,omitempty"` // MaxDistance: Specifies the number of max logical switches. MaxDistance int64 `json:"maxDistance,omitempty"` // Scope: Scope specifies the availability domain to which the VMs should be @@ -60033,11 +60936,12 @@ type TargetHttpsProxy struct { // to a SSL Certificate resource or Certificate Manager Certificate resource. // Mixing Classic Certificates and Certificate Manager Certificates is not // allowed. Certificate Manager Certificates must include the - // certificatemanager API. Certificate Manager Certificates are not supported - // by Global external Application Load Balancer or Classic Application Load - // Balancer, use certificate_map instead. Currently, you may specify up to 15 - // Classic SSL Certificates. Certificate Manager Certificates accepted formats - // are: - //certificatemanager.googleapis.com/projects/{project}/locations/{ + // certificatemanager API namespace. Using Certificate Manager Certificates in + // this field is not supported by Global external Application Load Balancer or + // Classic Application Load Balancer, use certificate_map instead. Currently, + // you may specify up to 15 Classic SSL Certificates or up to 100 Certificate + // Manager Certificates. Certificate Manager Certificates accepted formats are: + // - //certificatemanager.googleapis.com/projects/{project}/locations/{ // location}/certificates/{resourceName}. - // https://certificatemanager.googleapis.com/v1alpha1/projects/{project // }/locations/{location}/certificates/{resourceName}. @@ -64447,7 +65351,7 @@ type UsableSubnetworksAggregatedList struct { NextPageToken string `json:"nextPageToken,omitempty"` // ScopedWarnings: [Output Only] Informational warning messages for failures // encountered from scopes. - ScopedWarnings []*SubnetworksScopedWarning `json:"scoped_warnings,omitempty"` + ScopedWarnings []*SubnetworksScopedWarning `json:"scopedWarnings,omitempty"` // SelfLink: [Output Only] Server-defined URL for this resource. SelfLink string `json:"selfLink,omitempty"` // Unreachables: [Output Only] Unreachable resources. diff --git a/compute/v0.alpha/compute2-gen.go b/compute/v0.alpha/compute2-gen.go index 38377b3aa35..682a452a3b6 100644 --- a/compute/v0.alpha/compute2-gen.go +++ b/compute/v0.alpha/compute2-gen.go @@ -1750,6 +1750,117 @@ func (c *AddressesTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*Tes return ret, nil } +type AdviceCalendarModeCall struct { + s *Service + project string + region string + calendarmodeadvicerequest *CalendarModeAdviceRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// CalendarMode: Advise how, where and when to create the requested amount of +// instances with specified accelerators, within the specified time and +// location limits. The method recommends creating future reservations for the +// requested resources. +// +// - project: Project ID for this request. +// - region: Name of the region for this request. +func (r *AdviceService) CalendarMode(project string, region string, calendarmodeadvicerequest *CalendarModeAdviceRequest) *AdviceCalendarModeCall { + c := &AdviceCalendarModeCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.region = region + c.calendarmodeadvicerequest = calendarmodeadvicerequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *AdviceCalendarModeCall) Fields(s ...googleapi.Field) *AdviceCalendarModeCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *AdviceCalendarModeCall) Context(ctx context.Context) *AdviceCalendarModeCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *AdviceCalendarModeCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AdviceCalendarModeCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.calendarmodeadvicerequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/regions/{region}/advice/calendarMode") + 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{ + "project": c.project, + "region": c.region, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.advice.calendarMode", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.advice.calendarMode" call. +// Any non-2xx status code is an error. Response headers are in either +// *CalendarModeAdviceResponse.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 *AdviceCalendarModeCall) Do(opts ...googleapi.CallOption) (*CalendarModeAdviceResponse, 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 := &CalendarModeAdviceResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.advice.calendarMode", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type AutoscalersAggregatedListCall struct { s *Service project string @@ -45028,6 +45139,122 @@ func (c *InterconnectAttachmentGroupsGetIamPolicyCall) Do(opts ...googleapi.Call return ret, nil } +type InterconnectAttachmentGroupsGetOperationalStatusCall struct { + s *Service + project string + interconnectAttachmentGroup string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetOperationalStatus: Returns the InterconnectAttachmentStatuses for the +// specified InterconnectAttachmentGroup resource. +// +// - interconnectAttachmentGroup: Name of the interconnectAttachmentGroup +// resource to query. +// - project: Project ID for this request. +func (r *InterconnectAttachmentGroupsService) GetOperationalStatus(project string, interconnectAttachmentGroup string) *InterconnectAttachmentGroupsGetOperationalStatusCall { + c := &InterconnectAttachmentGroupsGetOperationalStatusCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.interconnectAttachmentGroup = interconnectAttachmentGroup + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *InterconnectAttachmentGroupsGetOperationalStatusCall) Fields(s ...googleapi.Field) *InterconnectAttachmentGroupsGetOperationalStatusCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *InterconnectAttachmentGroupsGetOperationalStatusCall) IfNoneMatch(entityTag string) *InterconnectAttachmentGroupsGetOperationalStatusCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *InterconnectAttachmentGroupsGetOperationalStatusCall) Context(ctx context.Context) *InterconnectAttachmentGroupsGetOperationalStatusCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *InterconnectAttachmentGroupsGetOperationalStatusCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *InterconnectAttachmentGroupsGetOperationalStatusCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/global/interconnectAttachmentGroups/{interconnectAttachmentGroup}/getOperationalStatus") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "interconnectAttachmentGroup": c.interconnectAttachmentGroup, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.interconnectAttachmentGroups.getOperationalStatus", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.interconnectAttachmentGroups.getOperationalStatus" call. +// Any non-2xx status code is an error. Response headers are in either +// *InterconnectAttachmentGroupsGetOperationalStatusResponse.ServerResponse.Head +// er 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 *InterconnectAttachmentGroupsGetOperationalStatusCall) Do(opts ...googleapi.CallOption) (*InterconnectAttachmentGroupsGetOperationalStatusResponse, 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 := &InterconnectAttachmentGroupsGetOperationalStatusResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.interconnectAttachmentGroups.getOperationalStatus", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type InterconnectAttachmentGroupsInsertCall struct { s *Service project string @@ -47479,6 +47706,121 @@ func (c *InterconnectGroupsGetIamPolicyCall) Do(opts ...googleapi.CallOption) (* return ret, nil } +type InterconnectGroupsGetOperationalStatusCall struct { + s *Service + project string + interconnectGroup string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetOperationalStatus: Returns the interconnectStatuses for the specified +// InterconnectGroup. +// +// - interconnectGroup: Name of the interconnectGroup resource to query. +// - project: Project ID for this request. +func (r *InterconnectGroupsService) GetOperationalStatus(project string, interconnectGroup string) *InterconnectGroupsGetOperationalStatusCall { + c := &InterconnectGroupsGetOperationalStatusCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.interconnectGroup = interconnectGroup + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *InterconnectGroupsGetOperationalStatusCall) Fields(s ...googleapi.Field) *InterconnectGroupsGetOperationalStatusCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *InterconnectGroupsGetOperationalStatusCall) IfNoneMatch(entityTag string) *InterconnectGroupsGetOperationalStatusCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *InterconnectGroupsGetOperationalStatusCall) Context(ctx context.Context) *InterconnectGroupsGetOperationalStatusCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *InterconnectGroupsGetOperationalStatusCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *InterconnectGroupsGetOperationalStatusCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/global/interconnectGroups/{interconnectGroup}/getOperationalStatus") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "interconnectGroup": c.interconnectGroup, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.interconnectGroups.getOperationalStatus", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.interconnectGroups.getOperationalStatus" call. +// Any non-2xx status code is an error. Response headers are in either +// *InterconnectGroupsGetOperationalStatusResponse.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 *InterconnectGroupsGetOperationalStatusCall) Do(opts ...googleapi.CallOption) (*InterconnectGroupsGetOperationalStatusResponse, 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 := &InterconnectGroupsGetOperationalStatusResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.interconnectGroups.getOperationalStatus", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type InterconnectGroupsInsertCall struct { s *Service project string @@ -57203,6 +57545,239 @@ func (c *NetworkFirewallPoliciesAddRuleCall) Do(opts ...googleapi.CallOption) (* return ret, nil } +type NetworkFirewallPoliciesAggregatedListCall struct { + s *Service + project string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// AggregatedList: Retrieves an aggregated list of network firewall policies, +// listing network firewall policies from all applicable scopes (global and +// regional) and grouping the results per scope. To prevent failure, Google +// recommends that you set the `returnPartialSuccess` parameter to `true`. +// +// - project: Project ID for this request. +func (r *NetworkFirewallPoliciesService) AggregatedList(project string) *NetworkFirewallPoliciesAggregatedListCall { + c := &NetworkFirewallPoliciesAggregatedListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + return c +} + +// Filter sets the optional parameter "filter": A filter expression that +// filters resources listed in the response. Most Compute resources support two +// types of filter expressions: expressions that support regular expressions +// and expressions that follow API improvement proposal AIP-160. These two +// types of filter expressions cannot be mixed in one request. If you want to +// use AIP-160, your expression must specify the field name, an operator, and +// the value that you want to use for filtering. The value must be a string, a +// number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, +// `>=` or `:`. For example, if you are filtering Compute Engine instances, you +// can exclude instances named `example-instance` by specifying `name != +// example-instance`. The `:*` comparison can be used to test whether a key has +// been defined. For example, to find all objects with `owner` label use: ``` +// labels.owner:* ``` You can also filter nested fields. For example, you could +// specify `scheduling.automaticRestart = false` to include instances only if +// they are not scheduled for automatic restarts. You can use filtering on +// nested fields to filter based on resource labels. To filter on multiple +// expressions, provide each separate expression within parentheses. For +// example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel +// Skylake") ``` By default, each expression is an `AND` expression. However, +// you can include `AND` and `OR` expressions explicitly. For example: ``` +// (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND +// (scheduling.automaticRestart = true) ``` If you want to use a regular +// expression, use the `eq` (equal) or `ne` (not equal) operator against a +// single un-parenthesized expression with or without quotes or against +// multiple parenthesized expressions. Examples: `fieldname eq unquoted +// literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted +// literal" `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal +// value is interpreted as a regular expression using Google RE2 library +// syntax. The literal value must match the entire field. For example, to +// filter for instances that do not end with name "instance", you would use +// `name ne .*instance`. You cannot combine constraints on multiple fields +// using regular expressions. +func (c *NetworkFirewallPoliciesAggregatedListCall) Filter(filter string) *NetworkFirewallPoliciesAggregatedListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// IncludeAllScopes sets the optional parameter "includeAllScopes": Indicates +// whether every visible scope for each scope type (zone, region, global) +// should be included in the response. For new resource types added after this +// field, the flag has no effect as new resource types will always include +// every visible scope for each scope type in response. For resource types +// which predate this field, if this flag is omitted or false, only scopes of +// the scope types where the resource type is expected to be found will be +// included. +func (c *NetworkFirewallPoliciesAggregatedListCall) IncludeAllScopes(includeAllScopes bool) *NetworkFirewallPoliciesAggregatedListCall { + c.urlParams_.Set("includeAllScopes", fmt.Sprint(includeAllScopes)) + return c +} + +// MaxResults sets the optional parameter "maxResults": The maximum number of +// results per page that should be returned. If the number of available results +// is larger than `maxResults`, Compute Engine returns a `nextPageToken` that +// can be used to get the next page of results in subsequent list requests. +// Acceptable values are `0` to `500`, inclusive. (Default: `500`) +func (c *NetworkFirewallPoliciesAggregatedListCall) MaxResults(maxResults int64) *NetworkFirewallPoliciesAggregatedListCall { + c.urlParams_.Set("maxResults", fmt.Sprint(maxResults)) + return c +} + +// OrderBy sets the optional parameter "orderBy": Sorts list results by a +// certain order. By default, results are returned in alphanumerical order +// based on the resource name. You can also sort results in descending order +// based on the creation timestamp using `orderBy="creationTimestamp desc". +// This sorts results based on the `creationTimestamp` field in reverse +// chronological order (newest result first). Use this to sort resources like +// operations so that the newest operation is returned first. Currently, only +// sorting by `name` or `creationTimestamp desc` is supported. +func (c *NetworkFirewallPoliciesAggregatedListCall) OrderBy(orderBy string) *NetworkFirewallPoliciesAggregatedListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + +// PageToken sets the optional parameter "pageToken": Specifies a page token to +// use. Set `pageToken` to the `nextPageToken` returned by a previous list +// request to get the next page of results. +func (c *NetworkFirewallPoliciesAggregatedListCall) PageToken(pageToken string) *NetworkFirewallPoliciesAggregatedListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// ReturnPartialSuccess sets the optional parameter "returnPartialSuccess": +// Opt-in for partial success behavior which provides partial results in case +// of failure. The default value is false. For example, when partial success +// behavior is enabled, aggregatedList for a single zone scope either returns +// all resources in the zone or no resources, with an error code. +func (c *NetworkFirewallPoliciesAggregatedListCall) ReturnPartialSuccess(returnPartialSuccess bool) *NetworkFirewallPoliciesAggregatedListCall { + c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) + return c +} + +// ServiceProjectNumber sets the optional parameter "serviceProjectNumber": The +// Shared VPC service project id or service project number for which aggregated +// list request is invoked for subnetworks list-usable api. +func (c *NetworkFirewallPoliciesAggregatedListCall) ServiceProjectNumber(serviceProjectNumber int64) *NetworkFirewallPoliciesAggregatedListCall { + c.urlParams_.Set("serviceProjectNumber", fmt.Sprint(serviceProjectNumber)) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *NetworkFirewallPoliciesAggregatedListCall) Fields(s ...googleapi.Field) *NetworkFirewallPoliciesAggregatedListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *NetworkFirewallPoliciesAggregatedListCall) IfNoneMatch(entityTag string) *NetworkFirewallPoliciesAggregatedListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *NetworkFirewallPoliciesAggregatedListCall) Context(ctx context.Context) *NetworkFirewallPoliciesAggregatedListCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *NetworkFirewallPoliciesAggregatedListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *NetworkFirewallPoliciesAggregatedListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/aggregated/firewallPolicies") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.networkFirewallPolicies.aggregatedList", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.networkFirewallPolicies.aggregatedList" call. +// Any non-2xx status code is an error. Response headers are in either +// *NetworkFirewallPolicyAggregatedList.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 *NetworkFirewallPoliciesAggregatedListCall) Do(opts ...googleapi.CallOption) (*NetworkFirewallPolicyAggregatedList, 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 := &NetworkFirewallPolicyAggregatedList{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.networkFirewallPolicies.aggregatedList", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *NetworkFirewallPoliciesAggregatedListCall) Pages(ctx context.Context, f func(*NetworkFirewallPolicyAggregatedList) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + type NetworkFirewallPoliciesCloneRulesCall struct { s *Service project string diff --git a/compute/v0.beta/compute-api.json b/compute/v0.beta/compute-api.json index 4100e34f719..9730dd5b787 100644 --- a/compute/v0.beta/compute-api.json +++ b/compute/v0.beta/compute-api.json @@ -17481,6 +17481,72 @@ "https://www.googleapis.com/auth/compute" ] }, + "aggregatedList": { + "description": "Retrieves an aggregated list of network firewall policies, listing network firewall policies from all applicable scopes (global and regional) and grouping the results per scope. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/firewallPolicies", + "httpMethod": "GET", + "id": "compute.networkFirewallPolicies.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/firewallPolicies", + "response": { + "$ref": "NetworkFirewallPolicyAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, "cloneRules": { "description": "Copies rules to the specified firewall policy.", "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/cloneRules", @@ -42790,7 +42856,7 @@ } } }, - "revision": "20241201", + "revision": "20241231", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -43380,7 +43446,7 @@ "type": "string" }, "securityPolicy": { - "description": "[Output Only] The resource URL for the security policy associated with this access config.", + "description": "The resource URL for the security policy associated with this access config.", "type": "string" }, "setPublicPtr": { @@ -44594,7 +44660,7 @@ "type": "string" }, "sourceSnapshot": { - "description": "The source snapshot to create this disk. When creating a new instance boot disk, one of initializeParams.sourceSnapshot or initializeParams.sourceImage or disks.source is required. To create a disk with a snapshot that you created, specify the snapshot name in the following format: global/snapshots/my-backup If the source snapshot is deleted later, this field will not be set.", + "description": "The source snapshot to create this disk. When creating a new instance boot disk, one of initializeParams.sourceSnapshot or initializeParams.sourceImage or disks.source is required. To create a disk with a snapshot that you created, specify the snapshot name in the following format: global/snapshots/my-backup If the source snapshot is deleted later, this field will not be set. Note: You cannot create VMs in bulk using a snapshot as the source. Use an image instead when you create VMs using the bulk insert method.", "type": "string" }, "sourceSnapshotEncryptionKey": { @@ -46293,6 +46359,10 @@ "format": "int32", "type": "integer" }, + "tlsSettings": { + "$ref": "BackendServiceTlsSettings", + "description": "Configuration for Backend Authenticated TLS and mTLS. May only be specified when the backend protocol is SSL, HTTPS or HTTP2." + }, "usedBy": { "description": "[Output Only] List of resources referencing given backend service.", "items": { @@ -47138,6 +47208,42 @@ }, "type": "object" }, + "BackendServiceTlsSettings": { + "id": "BackendServiceTlsSettings", + "properties": { + "authenticationConfig": { + "description": "Reference to the BackendAuthenticationConfig resource from the networksecurity.googleapis.com namespace. Can be used in authenticating TLS connections to the backend, as specified by the authenticationMode field. Can only be specified if authenticationMode is not NONE.", + "type": "string" + }, + "sni": { + "description": "Server Name Indication - see RFC3546 section 3.1. If set, the load balancer sends this string as the SNI hostname in the TLS connection to the backend, and requires that this string match a Subject Alternative Name (SAN) in the backend's server certificate. With a Regional Internet NEG backend, if the SNI is specified here, the load balancer uses it regardless of whether the Regional Internet NEG is specified with FQDN or IP address and port. When both sni and subjectAltNames[] are specified, the load balancer matches the backend certificate's SAN only to subjectAltNames[].", + "type": "string" + }, + "subjectAltNames": { + "description": "A list of Subject Alternative Names (SANs) that the Load Balancer verifies during a TLS handshake with the backend. When the server presents its X.509 certificate to the Load Balancer, the Load Balancer inspects the certificate's SAN field, and requires that at least one SAN match one of the subjectAltNames in the list. This field is limited to 5 entries. When both sni and subjectAltNames[] are specified, the load balancer matches the backend certificate's SAN only to subjectAltNames[].", + "items": { + "$ref": "BackendServiceTlsSettingsSubjectAltName" + }, + "type": "array" + } + }, + "type": "object" + }, + "BackendServiceTlsSettingsSubjectAltName": { + "description": "A Subject Alternative Name that the load balancer matches against the SAN field in the TLS certificate provided by the backend, specified as either a DNS name or a URI, in accordance with RFC 5280 4.2.1.6", + "id": "BackendServiceTlsSettingsSubjectAltName", + "properties": { + "dnsName": { + "description": "The SAN specified as a DNS Name.", + "type": "string" + }, + "uniformResourceIdentifier": { + "description": "The SAN specified as a URI.", + "type": "string" + } + }, + "type": "object" + }, "BackendServiceUsedBy": { "id": "BackendServiceUsedBy", "properties": { @@ -50364,7 +50470,7 @@ "additionalProperties": { "type": "string" }, - "description": "Additional structured details about this error. Keys must match /a-z+/ but should ideally be lowerCamelCase. Also they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than {\"instanceLimit\": \"100/request\"}, should be returned as, {\"instanceLimitPerRequest\": \"100\"}, if the client exceeds the number of instances that can be created in a single (batch) request.", + "description": "Additional structured details about this error. Keys must match a regular expression of `a-z+` but should ideally be lowerCamelCase. Also, they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than `{\"instanceLimit\": \"100/request\"}`, should be returned as, `{\"instanceLimitPerRequest\": \"100\"}`, if the client exceeds the number of instances that can be created in a single (batch) request.", "type": "object" }, "reason": { @@ -51215,6 +51321,143 @@ }, "type": "object" }, + "FirewallPoliciesScopedList": { + "id": "FirewallPoliciesScopedList", + "properties": { + "firewallPolicies": { + "description": "A list of firewall policies contained in this scope.", + "items": { + "$ref": "FirewallPolicy" + }, + "type": "array" + }, + "warning": { + "description": "Informational warning which replaces the list of firewall policies when the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g: regions.list).", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "type": "string" + }, + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", + "type": "string" + } + }, + "type": "object" + } + }, + "type": "object" + }, "FirewallPolicy": { "description": "Represents a Firewall Policy resource.", "id": "FirewallPolicy", @@ -52522,6 +52765,10 @@ "description": "Setting for enabling or disabling automatic deletion for auto-created reservation. If set to true, auto-created reservations will be deleted at Future Reservation's end time (default) or at user's defined timestamp if any of the [auto_created_reservations_delete_time, auto_created_reservations_duration] values is specified. For keeping auto-created reservation indefinitely, this value should be set to false.", "type": "boolean" }, + "commitmentInfo": { + "$ref": "FutureReservationCommitmentInfo", + "description": "If not present, then FR will not deliver a new commitment or update an existing commitment." + }, "creationTimestamp": { "description": "[Output Only] The creation timestamp for this future reservation in RFC3339 text format.", "type": "string" @@ -52635,6 +52882,42 @@ }, "type": "object" }, + "FutureReservationCommitmentInfo": { + "id": "FutureReservationCommitmentInfo", + "properties": { + "commitmentName": { + "description": "name of the commitment where capacity is being delivered to.", + "type": "string" + }, + "commitmentPlan": { + "description": "Indicates if a Commitment needs to be created as part of FR delivery. If this field is not present, then no commitment needs to be created.", + "enum": [ + "INVALID", + "THIRTY_SIX_MONTH", + "TWELVE_MONTH" + ], + "enumDescriptions": [ + "", + "", + "" + ], + "type": "string" + }, + "previousCommitmentTerms": { + "description": "Only applicable if FR is delivering to the same reservation. If set, all parent commitments will be extended to match the end date of the plan for this commitment.", + "enum": [ + "EXTEND", + "PREVIOUSCOMMITMENTTERM_UNSPECIFIED" + ], + "enumDescriptions": [ + "All associated parent Committed Used Discount(s) end-date/term will be extended to the end-time of this future reservation. Default is to extend previous commitment(s) time to the end_time of the reservation.", + "No changes to associated parents Committed Used Discount(s) terms." + ], + "type": "string" + } + }, + "type": "object" + }, "FutureReservationSpecificSKUProperties": { "id": "FutureReservationSpecificSKUProperties", "properties": { @@ -61671,8 +61954,9 @@ "type": "boolean" }, "bandwidth": { - "description": "Provisioned bandwidth capacity for the interconnect attachment. For attachments of type DEDICATED, the user can set the bandwidth. For attachments of type PARTNER, the Google Partner that is operating the interconnect must set the bandwidth. Output only for PARTNER type, mutable for PARTNER_PROVIDER and DEDICATED, and can take one of the following values: - BPS_50M: 50 Mbit/s - BPS_100M: 100 Mbit/s - BPS_200M: 200 Mbit/s - BPS_300M: 300 Mbit/s - BPS_400M: 400 Mbit/s - BPS_500M: 500 Mbit/s - BPS_1G: 1 Gbit/s - BPS_2G: 2 Gbit/s - BPS_5G: 5 Gbit/s - BPS_10G: 10 Gbit/s - BPS_20G: 20 Gbit/s - BPS_50G: 50 Gbit/s ", + "description": "Provisioned bandwidth capacity for the interconnect attachment. For attachments of type DEDICATED, the user can set the bandwidth. For attachments of type PARTNER, the Google Partner that is operating the interconnect must set the bandwidth. Output only for PARTNER type, mutable for PARTNER_PROVIDER and DEDICATED, and can take one of the following values: - BPS_50M: 50 Mbit/s - BPS_100M: 100 Mbit/s - BPS_200M: 200 Mbit/s - BPS_300M: 300 Mbit/s - BPS_400M: 400 Mbit/s - BPS_500M: 500 Mbit/s - BPS_1G: 1 Gbit/s - BPS_2G: 2 Gbit/s - BPS_5G: 5 Gbit/s - BPS_10G: 10 Gbit/s - BPS_20G: 20 Gbit/s - BPS_50G: 50 Gbit/s - BPS_100G: 100 Gbit/s ", "enum": [ + "BPS_100G", "BPS_100M", "BPS_10G", "BPS_1G", @@ -61687,6 +61971,7 @@ "BPS_5G" ], "enumDescriptions": [ + "100 Gbit/s", "100 Mbit/s", "10 Gbit/s", "1 Gbit/s", @@ -61710,7 +61995,7 @@ "type": "array" }, "candidateSubnets": { - "description": "Up to 16 candidate prefixes that can be used to restrict the allocation of cloudRouterIpAddress and customerRouterIpAddress for this attachment. All prefixes must be within link-local address space (169.254.0.0/16) and must be /29 or shorter (/28, /27, etc). Google will attempt to select an unused /29 from the supplied candidate prefix(es). The request will fail if all possible /29s are in use on Google's edge. If not supplied, Google will randomly select an unused /29 from all of link-local space.", + "description": "Input only. Up to 16 candidate prefixes that can be used to restrict the allocation of cloudRouterIpAddress and customerRouterIpAddress for this attachment. All prefixes must be within link-local address space (169.254.0.0/16) and must be /29 or shorter (/28, /27, etc). Google will attempt to select an unused /29 from the supplied candidate prefix(es). The request will fail if all possible /29s are in use on Google's edge. If not supplied, Google will randomly select an unused /29 from all of link-local space.", "items": { "type": "string" }, @@ -61758,7 +62043,7 @@ "type": "string" }, "edgeAvailabilityDomain": { - "description": "Desired availability domain for the attachment. Only available for type PARTNER, at creation time, and can take one of the following values: - AVAILABILITY_DOMAIN_ANY - AVAILABILITY_DOMAIN_1 - AVAILABILITY_DOMAIN_2 For improved reliability, customers should configure a pair of attachments, one per availability domain. The selected availability domain will be provided to the Partner via the pairing key, so that the provisioned circuit will lie in the specified domain. If not specified, the value will default to AVAILABILITY_DOMAIN_ANY.", + "description": "Input only. Desired availability domain for the attachment. Only available for type PARTNER, at creation time, and can take one of the following values: - AVAILABILITY_DOMAIN_ANY - AVAILABILITY_DOMAIN_1 - AVAILABILITY_DOMAIN_2 For improved reliability, customers should configure a pair of attachments, one per availability domain. The selected availability domain will be provided to the Partner via the pairing key, so that the provisioned circuit will lie in the specified domain. If not specified, the value will default to AVAILABILITY_DOMAIN_ANY.", "enum": [ "AVAILABILITY_DOMAIN_1", "AVAILABILITY_DOMAIN_2", @@ -61915,7 +62200,7 @@ "type": "string" }, "subnetLength": { - "description": "Length of the IPv4 subnet mask. Allowed values: - 29 (default) - 30 The default value is 29, except for Cross-Cloud Interconnect connections that use an InterconnectRemoteLocation with a constraints.subnetLengthRange.min equal to 30. For example, connections that use an Azure remote location fall into this category. In these cases, the default value is 30, and requesting 29 returns an error. Where both 29 and 30 are allowed, 29 is preferred, because it gives Google Cloud Support more debugging visibility. ", + "description": "Input only. Length of the IPv4 subnet mask. Allowed values: - 29 (default) - 30 The default value is 29, except for Cross-Cloud Interconnect connections that use an InterconnectRemoteLocation with a constraints.subnetLengthRange.min equal to 30. For example, connections that use an Azure remote location fall into this category. In these cases, the default value is 30, and requesting 29 returns an error. Where both 29 and 30 are allowed, 29 is preferred, because it gives Google Cloud Support more debugging visibility. ", "format": "int32", "type": "integer" }, @@ -67594,6 +67879,168 @@ }, "type": "object" }, + "NetworkFirewallPolicyAggregatedList": { + "id": "NetworkFirewallPolicyAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "FirewallPoliciesScopedList", + "description": "Name of the scope containing this set of addresses." + }, + "description": "A list of FirewallPoliciesScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#networkFirewallPolicyAggregatedList", + "description": "[Output Only] Type of resource. Always compute#networkFirewallPoliciesAggregatedList for lists of network firewall policies.", + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "items": { + "type": "string" + }, + "type": "array" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g: regions.list).", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "type": "string" + }, + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", + "type": "string" + } + }, + "type": "object" + } + }, + "type": "object" + }, "NetworkInterface": { "description": "A network interface resource attached to an instance.", "id": "NetworkInterface", @@ -88832,7 +89279,7 @@ "type": "string" }, "sslCertificates": { - "description": "URLs to SslCertificate resources that are used to authenticate connections between users and the load balancer. At least one SSL certificate must be specified. SslCertificates do not apply when the load balancing scheme is set to INTERNAL_SELF_MANAGED. The URLs should refer to a SSL Certificate resource or Certificate Manager Certificate resource. Mixing Classic Certificates and Certificate Manager Certificates is not allowed. Certificate Manager Certificates must include the certificatemanager API. Certificate Manager Certificates are not supported by Global external Application Load Balancer or Classic Application Load Balancer, use certificate_map instead. Currently, you may specify up to 15 Classic SSL Certificates. Certificate Manager Certificates accepted formats are: - //certificatemanager.googleapis.com/projects/{project}/locations/{ location}/certificates/{resourceName}. - https://certificatemanager.googleapis.com/v1alpha1/projects/{project }/locations/{location}/certificates/{resourceName}. ", + "description": "URLs to SslCertificate resources that are used to authenticate connections between users and the load balancer. At least one SSL certificate must be specified. SslCertificates do not apply when the load balancing scheme is set to INTERNAL_SELF_MANAGED. The URLs should refer to a SSL Certificate resource or Certificate Manager Certificate resource. Mixing Classic Certificates and Certificate Manager Certificates is not allowed. Certificate Manager Certificates must include the certificatemanager API namespace. Using Certificate Manager Certificates in this field is not supported by Global external Application Load Balancer or Classic Application Load Balancer, use certificate_map instead. Currently, you may specify up to 15 Classic SSL Certificates or up to 100 Certificate Manager Certificates. Certificate Manager Certificates accepted formats are: - //certificatemanager.googleapis.com/projects/{project}/locations/{ location}/certificates/{resourceName}. - https://certificatemanager.googleapis.com/v1alpha1/projects/{project }/locations/{location}/certificates/{resourceName}. ", "items": { "type": "string" }, diff --git a/compute/v0.beta/compute-gen.go b/compute/v0.beta/compute-gen.go index 326f71e60cd..dd474a6389a 100644 --- a/compute/v0.beta/compute-gen.go +++ b/compute/v0.beta/compute-gen.go @@ -2077,8 +2077,8 @@ type AccessConfig struct { // If this field is unspecified in ipv6AccessConfig, a default PTR record will // be created for first IP in associated external IPv6 range. PublicPtrDomainName string `json:"publicPtrDomainName,omitempty"` - // SecurityPolicy: [Output Only] The resource URL for the security policy - // associated with this access config. + // SecurityPolicy: The resource URL for the security policy associated with + // this access config. SecurityPolicy string `json:"securityPolicy,omitempty"` // SetPublicPtr: Specifies whether a public DNS 'PTR' record should be created // to map the external IP address of the instance to a DNS domain name. This @@ -3384,7 +3384,9 @@ type AttachedDiskInitializeParams struct { // initializeParams.sourceImage or disks.source is required. To create a disk // with a snapshot that you created, specify the snapshot name in the following // format: global/snapshots/my-backup If the source snapshot is deleted later, - // this field will not be set. + // this field will not be set. Note: You cannot create VMs in bulk using a + // snapshot as the source. Use an image instead when you create VMs using the + // bulk insert method. SourceSnapshot string `json:"sourceSnapshot,omitempty"` // SourceSnapshotEncryptionKey: The customer-supplied encryption key of the // source snapshot. @@ -5586,6 +5588,9 @@ type BackendService struct { // by a URL map that is bound to target gRPC proxy that has // validateForProxyless field set to true. Instead, use maxStreamDuration. TimeoutSec int64 `json:"timeoutSec,omitempty"` + // TlsSettings: Configuration for Backend Authenticated TLS and mTLS. May only + // be specified when the backend protocol is SSL, HTTPS or HTTP2. + TlsSettings *BackendServiceTlsSettings `json:"tlsSettings,omitempty"` // UsedBy: [Output Only] List of resources referencing given backend service. UsedBy []*BackendServiceUsedBy `json:"usedBy,omitempty"` @@ -6748,6 +6753,75 @@ func (s BackendServiceReference) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type BackendServiceTlsSettings struct { + // AuthenticationConfig: Reference to the BackendAuthenticationConfig resource + // from the networksecurity.googleapis.com namespace. Can be used in + // authenticating TLS connections to the backend, as specified by the + // authenticationMode field. Can only be specified if authenticationMode is not + // NONE. + AuthenticationConfig string `json:"authenticationConfig,omitempty"` + // Sni: Server Name Indication - see RFC3546 section 3.1. If set, the load + // balancer sends this string as the SNI hostname in the TLS connection to the + // backend, and requires that this string match a Subject Alternative Name + // (SAN) in the backend's server certificate. With a Regional Internet NEG + // backend, if the SNI is specified here, the load balancer uses it regardless + // of whether the Regional Internet NEG is specified with FQDN or IP address + // and port. When both sni and subjectAltNames[] are specified, the load + // balancer matches the backend certificate's SAN only to subjectAltNames[]. + Sni string `json:"sni,omitempty"` + // SubjectAltNames: A list of Subject Alternative Names (SANs) that the Load + // Balancer verifies during a TLS handshake with the backend. When the server + // presents its X.509 certificate to the Load Balancer, the Load Balancer + // inspects the certificate's SAN field, and requires that at least one SAN + // match one of the subjectAltNames in the list. This field is limited to 5 + // entries. When both sni and subjectAltNames[] are specified, the load + // balancer matches the backend certificate's SAN only to subjectAltNames[]. + SubjectAltNames []*BackendServiceTlsSettingsSubjectAltName `json:"subjectAltNames,omitempty"` + // ForceSendFields is a list of field names (e.g. "AuthenticationConfig") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AuthenticationConfig") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s BackendServiceTlsSettings) MarshalJSON() ([]byte, error) { + type NoMethod BackendServiceTlsSettings + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// BackendServiceTlsSettingsSubjectAltName: A Subject Alternative Name that the +// load balancer matches against the SAN field in the TLS certificate provided +// by the backend, specified as either a DNS name or a URI, in accordance with +// RFC 5280 4.2.1.6 +type BackendServiceTlsSettingsSubjectAltName struct { + // DnsName: The SAN specified as a DNS Name. + DnsName string `json:"dnsName,omitempty"` + // UniformResourceIdentifier: The SAN specified as a URI. + UniformResourceIdentifier string `json:"uniformResourceIdentifier,omitempty"` + // ForceSendFields is a list of field names (e.g. "DnsName") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "DnsName") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s BackendServiceTlsSettingsSubjectAltName) MarshalJSON() ([]byte, error) { + type NoMethod BackendServiceTlsSettingsSubjectAltName + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type BackendServiceUsedBy struct { // Reference: [Output Only] Server-defined URL for resources referencing given // BackendService like UrlMaps, TargetTcpProxies, TargetSslProxies and @@ -10432,13 +10506,14 @@ type ErrorInfo struct { // unique value that identifies the infrastructure. For Google API // infrastructure, the error domain is "googleapis.com". Domain string `json:"domain,omitempty"` - // Metadatas: Additional structured details about this error. Keys must match - // /a-z+/ but should ideally be lowerCamelCase. Also they must be limited to 64 - // characters in length. When identifying the current value of an exceeded - // limit, the units should be contained in the key, not the value. For example, - // rather than {"instanceLimit": "100/request"}, should be returned as, - // {"instanceLimitPerRequest": "100"}, if the client exceeds the number of - // instances that can be created in a single (batch) request. + // Metadatas: Additional structured details about this error. Keys must match a + // regular expression of `a-z+` but should ideally be lowerCamelCase. Also, + // they must be limited to 64 characters in length. When identifying the + // current value of an exceeded limit, the units should be contained in the + // key, not the value. For example, rather than `{"instanceLimit": + // "100/request"}`, should be returned as, `{"instanceLimitPerRequest": + // "100"}`, if the client exceeds the number of instances that can be created + // in a single (batch) request. Metadatas map[string]string `json:"metadatas,omitempty"` // Reason: The reason of the error. This is a constant value that identifies // the proximate cause of the error. Error reasons are unique within a @@ -11439,6 +11514,147 @@ func (s FirewallPoliciesListAssociationsResponse) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type FirewallPoliciesScopedList struct { + // FirewallPolicies: A list of firewall policies contained in this scope. + FirewallPolicies []*FirewallPolicy `json:"firewallPolicies,omitempty"` + // Warning: Informational warning which replaces the list of firewall policies + // when the list is empty. + Warning *FirewallPoliciesScopedListWarning `json:"warning,omitempty"` + // ForceSendFields is a list of field names (e.g. "FirewallPolicies") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "FirewallPolicies") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s FirewallPoliciesScopedList) MarshalJSON() ([]byte, error) { + type NoMethod FirewallPoliciesScopedList + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// FirewallPoliciesScopedListWarning: Informational warning which replaces the +// list of firewall policies when the list is empty. +type FirewallPoliciesScopedListWarning struct { + // Code: [Output Only] A warning code, if applicable. For example, Compute + // Engine returns NO_RESULTS_ON_PAGE if there are no results in the response. + // + // Possible values: + // "CLEANUP_FAILED" - Warning about failed cleanup of transient changes made + // by a failed operation. + // "DEPRECATED_RESOURCE_USED" - A link to a deprecated resource was created. + // "DEPRECATED_TYPE_USED" - When deploying and at least one of the resources + // has a type marked as deprecated + // "DISK_SIZE_LARGER_THAN_IMAGE_SIZE" - The user created a boot disk that is + // larger than image size. + // "EXPERIMENTAL_TYPE_USED" - When deploying and at least one of the + // resources has a type marked as experimental + // "EXTERNAL_API_WARNING" - Warning that is present in an external api call + // "FIELD_VALUE_OVERRIDEN" - Warning that value of a field has been + // overridden. Deprecated unused field. + // "INJECTED_KERNELS_DEPRECATED" - The operation involved use of an injected + // kernel, which is deprecated. + // "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB" - A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // "LARGE_DEPLOYMENT_WARNING" - When deploying a deployment with a + // exceedingly large number of resources + // "LIST_OVERHEAD_QUOTA_EXCEED" - Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out by + // user-defined list filter. + // "MISSING_TYPE_DEPENDENCY" - A resource depends on a missing type + // "NEXT_HOP_ADDRESS_NOT_ASSIGNED" - The route's nextHopIp address is not + // assigned to an instance on the network. + // "NEXT_HOP_CANNOT_IP_FORWARD" - The route's next hop instance cannot ip + // forward. + // "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE" - The route's nextHopInstance + // URL refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // "NEXT_HOP_INSTANCE_NOT_FOUND" - The route's nextHopInstance URL refers to + // an instance that does not exist. + // "NEXT_HOP_INSTANCE_NOT_ON_NETWORK" - The route's nextHopInstance URL + // refers to an instance that is not on the same network as the route. + // "NEXT_HOP_NOT_RUNNING" - The route's next hop instance does not have a + // status of RUNNING. + // "NOT_CRITICAL_ERROR" - Error which is not critical. We decided to continue + // the process despite the mentioned error. + // "NO_RESULTS_ON_PAGE" - No results are present on a particular list page. + // "PARTIAL_SUCCESS" - Success is reported, but some results may be missing + // due to errors + // "QUOTA_INFO_UNAVAILABLE" - Quota information is not available to client + // requests (e.g: regions.list). + // "REQUIRED_TOS_AGREEMENT" - The user attempted to use a resource that + // requires a TOS they have not accepted. + // "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING" - Warning that a resource is + // in use. + // "RESOURCE_NOT_DELETED" - One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // "SCHEMA_VALIDATION_IGNORED" - When a resource schema validation is + // ignored. + // "SINGLE_INSTANCE_PROPERTY_TEMPLATE" - Instance template used in instance + // group manager is valid as such, but its application does not make a lot of + // sense, because it allows only single instance in instance group. + // "UNDECLARED_PROPERTIES" - When undeclared properties in the schema are + // present + // "UNREACHABLE" - A given scope cannot be reached. + Code string `json:"code,omitempty"` + // Data: [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + Data []*FirewallPoliciesScopedListWarningData `json:"data,omitempty"` + // Message: [Output Only] A human-readable description of the warning code. + Message string `json:"message,omitempty"` + // ForceSendFields is a list of field names (e.g. "Code") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Code") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s FirewallPoliciesScopedListWarning) MarshalJSON() ([]byte, error) { + type NoMethod FirewallPoliciesScopedListWarning + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type FirewallPoliciesScopedListWarningData struct { + // Key: [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a list + // request for a particular zone, this key might be scope and the key value + // might be the zone name. Other examples might be a key indicating a + // deprecated resource and a suggested replacement, or a warning about invalid + // network settings (for example, if an instance attempts to perform IP + // forwarding but is not enabled for IP forwarding). + Key string `json:"key,omitempty"` + // Value: [Output Only] A warning data value corresponding to the key. + Value string `json:"value,omitempty"` + // ForceSendFields is a list of field names (e.g. "Key") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Key") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s FirewallPoliciesScopedListWarningData) MarshalJSON() ([]byte, error) { + type NoMethod FirewallPoliciesScopedListWarningData + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // FirewallPolicy: Represents a Firewall Policy resource. type FirewallPolicy struct { // Associations: A list of associations that belong to this firewall policy. @@ -12878,6 +13094,9 @@ type FutureReservation struct { // values is specified. For keeping auto-created reservation indefinitely, this // value should be set to false. AutoDeleteAutoCreatedReservations bool `json:"autoDeleteAutoCreatedReservations,omitempty"` + // CommitmentInfo: If not present, then FR will not deliver a new commitment or + // update an existing commitment. + CommitmentInfo *FutureReservationCommitmentInfo `json:"commitmentInfo,omitempty"` // CreationTimestamp: [Output Only] The creation timestamp for this future // reservation in RFC3339 text format. CreationTimestamp string `json:"creationTimestamp,omitempty"` @@ -12980,6 +13199,47 @@ func (s FutureReservation) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type FutureReservationCommitmentInfo struct { + // CommitmentName: name of the commitment where capacity is being delivered to. + CommitmentName string `json:"commitmentName,omitempty"` + // CommitmentPlan: Indicates if a Commitment needs to be created as part of FR + // delivery. If this field is not present, then no commitment needs to be + // created. + // + // Possible values: + // "INVALID" + // "THIRTY_SIX_MONTH" + // "TWELVE_MONTH" + CommitmentPlan string `json:"commitmentPlan,omitempty"` + // PreviousCommitmentTerms: Only applicable if FR is delivering to the same + // reservation. If set, all parent commitments will be extended to match the + // end date of the plan for this commitment. + // + // Possible values: + // "EXTEND" - All associated parent Committed Used Discount(s) end-date/term + // will be extended to the end-time of this future reservation. Default is to + // extend previous commitment(s) time to the end_time of the reservation. + // "PREVIOUSCOMMITMENTTERM_UNSPECIFIED" - No changes to associated parents + // Committed Used Discount(s) terms. + PreviousCommitmentTerms string `json:"previousCommitmentTerms,omitempty"` + // ForceSendFields is a list of field names (e.g. "CommitmentName") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CommitmentName") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s FutureReservationCommitmentInfo) MarshalJSON() ([]byte, error) { + type NoMethod FutureReservationCommitmentInfo + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type FutureReservationSpecificSKUProperties struct { // InstanceProperties: Properties of the SKU instances being reserved. InstanceProperties *AllocationSpecificSKUAllocationReservedInstanceProperties `json:"instanceProperties,omitempty"` @@ -23418,9 +23678,10 @@ type InterconnectAttachment struct { // values: - BPS_50M: 50 Mbit/s - BPS_100M: 100 Mbit/s - BPS_200M: 200 Mbit/s - // BPS_300M: 300 Mbit/s - BPS_400M: 400 Mbit/s - BPS_500M: 500 Mbit/s - BPS_1G: // 1 Gbit/s - BPS_2G: 2 Gbit/s - BPS_5G: 5 Gbit/s - BPS_10G: 10 Gbit/s - - // BPS_20G: 20 Gbit/s - BPS_50G: 50 Gbit/s + // BPS_20G: 20 Gbit/s - BPS_50G: 50 Gbit/s - BPS_100G: 100 Gbit/s // // Possible values: + // "BPS_100G" - 100 Gbit/s // "BPS_100M" - 100 Mbit/s // "BPS_10G" - 10 Gbit/s // "BPS_1G" - 1 Gbit/s @@ -23436,14 +23697,14 @@ type InterconnectAttachment struct { Bandwidth string `json:"bandwidth,omitempty"` // CandidateIpv6Subnets: This field is not available. CandidateIpv6Subnets []string `json:"candidateIpv6Subnets,omitempty"` - // CandidateSubnets: Up to 16 candidate prefixes that can be used to restrict - // the allocation of cloudRouterIpAddress and customerRouterIpAddress for this - // attachment. All prefixes must be within link-local address space - // (169.254.0.0/16) and must be /29 or shorter (/28, /27, etc). Google will - // attempt to select an unused /29 from the supplied candidate prefix(es). The - // request will fail if all possible /29s are in use on Google's edge. If not - // supplied, Google will randomly select an unused /29 from all of link-local - // space. + // CandidateSubnets: Input only. Up to 16 candidate prefixes that can be used + // to restrict the allocation of cloudRouterIpAddress and + // customerRouterIpAddress for this attachment. All prefixes must be within + // link-local address space (169.254.0.0/16) and must be /29 or shorter (/28, + // /27, etc). Google will attempt to select an unused /29 from the supplied + // candidate prefix(es). The request will fail if all possible /29s are in use + // on Google's edge. If not supplied, Google will randomly select an unused /29 + // from all of link-local space. CandidateSubnets []string `json:"candidateSubnets,omitempty"` // CloudRouterIpAddress: [Output Only] IPv4 address + prefix length to be // configured on Cloud Router Interface for this interconnect attachment. @@ -23475,14 +23736,14 @@ type InterconnectAttachment struct { DataplaneVersion int64 `json:"dataplaneVersion,omitempty"` // Description: An optional description of this resource. Description string `json:"description,omitempty"` - // EdgeAvailabilityDomain: Desired availability domain for the attachment. Only - // available for type PARTNER, at creation time, and can take one of the - // following values: - AVAILABILITY_DOMAIN_ANY - AVAILABILITY_DOMAIN_1 - - // AVAILABILITY_DOMAIN_2 For improved reliability, customers should configure a - // pair of attachments, one per availability domain. The selected availability - // domain will be provided to the Partner via the pairing key, so that the - // provisioned circuit will lie in the specified domain. If not specified, the - // value will default to AVAILABILITY_DOMAIN_ANY. + // EdgeAvailabilityDomain: Input only. Desired availability domain for the + // attachment. Only available for type PARTNER, at creation time, and can take + // one of the following values: - AVAILABILITY_DOMAIN_ANY - + // AVAILABILITY_DOMAIN_1 - AVAILABILITY_DOMAIN_2 For improved reliability, + // customers should configure a pair of attachments, one per availability + // domain. The selected availability domain will be provided to the Partner via + // the pairing key, so that the provisioned circuit will lie in the specified + // domain. If not specified, the value will default to AVAILABILITY_DOMAIN_ANY. // // Possible values: // "AVAILABILITY_DOMAIN_1" @@ -23656,9 +23917,9 @@ type InterconnectAttachment struct { // "UNPROVISIONED" - Indicates that attachment is not ready to use yet, // because turnup is not complete. State string `json:"state,omitempty"` - // SubnetLength: Length of the IPv4 subnet mask. Allowed values: - 29 (default) - // - 30 The default value is 29, except for Cross-Cloud Interconnect - // connections that use an InterconnectRemoteLocation with a + // SubnetLength: Input only. Length of the IPv4 subnet mask. Allowed values: - + // 29 (default) - 30 The default value is 29, except for Cross-Cloud + // Interconnect connections that use an InterconnectRemoteLocation with a // constraints.subnetLengthRange.min equal to 30. For example, connections that // use an Azure remote location fall into this category. In these cases, the // default value is 30, and requesting 29 returns an error. Where both 29 and @@ -29968,6 +30229,165 @@ func (s NetworkEndpointWithHealthStatus) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type NetworkFirewallPolicyAggregatedList struct { + // Id: [Output Only] Unique identifier for the resource; defined by the server. + Id string `json:"id,omitempty"` + // Items: A list of FirewallPoliciesScopedList resources. + Items map[string]FirewallPoliciesScopedList `json:"items,omitempty"` + // Kind: [Output Only] Type of resource. Always + // compute#networkFirewallPoliciesAggregatedList for lists of network firewall + // policies. + Kind string `json:"kind,omitempty"` + // NextPageToken: [Output Only] This token allows you to get the next page of + // results for list requests. If the number of results is larger than + // maxResults, use the nextPageToken as a value for the query parameter + // pageToken in the next list request. Subsequent list requests will have their + // own nextPageToken to continue paging through the results. + NextPageToken string `json:"nextPageToken,omitempty"` + // SelfLink: [Output Only] Server-defined URL for this resource. + SelfLink string `json:"selfLink,omitempty"` + // Unreachables: [Output Only] Unreachable resources. + Unreachables []string `json:"unreachables,omitempty"` + // Warning: [Output Only] Informational warning message. + Warning *NetworkFirewallPolicyAggregatedListWarning `json:"warning,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Id") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Id") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s NetworkFirewallPolicyAggregatedList) MarshalJSON() ([]byte, error) { + type NoMethod NetworkFirewallPolicyAggregatedList + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// NetworkFirewallPolicyAggregatedListWarning: [Output Only] Informational +// warning message. +type NetworkFirewallPolicyAggregatedListWarning struct { + // Code: [Output Only] A warning code, if applicable. For example, Compute + // Engine returns NO_RESULTS_ON_PAGE if there are no results in the response. + // + // Possible values: + // "CLEANUP_FAILED" - Warning about failed cleanup of transient changes made + // by a failed operation. + // "DEPRECATED_RESOURCE_USED" - A link to a deprecated resource was created. + // "DEPRECATED_TYPE_USED" - When deploying and at least one of the resources + // has a type marked as deprecated + // "DISK_SIZE_LARGER_THAN_IMAGE_SIZE" - The user created a boot disk that is + // larger than image size. + // "EXPERIMENTAL_TYPE_USED" - When deploying and at least one of the + // resources has a type marked as experimental + // "EXTERNAL_API_WARNING" - Warning that is present in an external api call + // "FIELD_VALUE_OVERRIDEN" - Warning that value of a field has been + // overridden. Deprecated unused field. + // "INJECTED_KERNELS_DEPRECATED" - The operation involved use of an injected + // kernel, which is deprecated. + // "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB" - A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // "LARGE_DEPLOYMENT_WARNING" - When deploying a deployment with a + // exceedingly large number of resources + // "LIST_OVERHEAD_QUOTA_EXCEED" - Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out by + // user-defined list filter. + // "MISSING_TYPE_DEPENDENCY" - A resource depends on a missing type + // "NEXT_HOP_ADDRESS_NOT_ASSIGNED" - The route's nextHopIp address is not + // assigned to an instance on the network. + // "NEXT_HOP_CANNOT_IP_FORWARD" - The route's next hop instance cannot ip + // forward. + // "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE" - The route's nextHopInstance + // URL refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // "NEXT_HOP_INSTANCE_NOT_FOUND" - The route's nextHopInstance URL refers to + // an instance that does not exist. + // "NEXT_HOP_INSTANCE_NOT_ON_NETWORK" - The route's nextHopInstance URL + // refers to an instance that is not on the same network as the route. + // "NEXT_HOP_NOT_RUNNING" - The route's next hop instance does not have a + // status of RUNNING. + // "NOT_CRITICAL_ERROR" - Error which is not critical. We decided to continue + // the process despite the mentioned error. + // "NO_RESULTS_ON_PAGE" - No results are present on a particular list page. + // "PARTIAL_SUCCESS" - Success is reported, but some results may be missing + // due to errors + // "QUOTA_INFO_UNAVAILABLE" - Quota information is not available to client + // requests (e.g: regions.list). + // "REQUIRED_TOS_AGREEMENT" - The user attempted to use a resource that + // requires a TOS they have not accepted. + // "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING" - Warning that a resource is + // in use. + // "RESOURCE_NOT_DELETED" - One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // "SCHEMA_VALIDATION_IGNORED" - When a resource schema validation is + // ignored. + // "SINGLE_INSTANCE_PROPERTY_TEMPLATE" - Instance template used in instance + // group manager is valid as such, but its application does not make a lot of + // sense, because it allows only single instance in instance group. + // "UNDECLARED_PROPERTIES" - When undeclared properties in the schema are + // present + // "UNREACHABLE" - A given scope cannot be reached. + Code string `json:"code,omitempty"` + // Data: [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + Data []*NetworkFirewallPolicyAggregatedListWarningData `json:"data,omitempty"` + // Message: [Output Only] A human-readable description of the warning code. + Message string `json:"message,omitempty"` + // ForceSendFields is a list of field names (e.g. "Code") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Code") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s NetworkFirewallPolicyAggregatedListWarning) MarshalJSON() ([]byte, error) { + type NoMethod NetworkFirewallPolicyAggregatedListWarning + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type NetworkFirewallPolicyAggregatedListWarningData struct { + // Key: [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a list + // request for a particular zone, this key might be scope and the key value + // might be the zone name. Other examples might be a key indicating a + // deprecated resource and a suggested replacement, or a warning about invalid + // network settings (for example, if an instance attempts to perform IP + // forwarding but is not enabled for IP forwarding). + Key string `json:"key,omitempty"` + // Value: [Output Only] A warning data value corresponding to the key. + Value string `json:"value,omitempty"` + // ForceSendFields is a list of field names (e.g. "Key") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Key") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s NetworkFirewallPolicyAggregatedListWarningData) MarshalJSON() ([]byte, error) { + type NoMethod NetworkFirewallPolicyAggregatedListWarningData + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // NetworkInterface: A network interface resource attached to an instance. type NetworkInterface struct { // AccessConfigs: An array of configurations for this interface. Currently, @@ -52701,11 +53121,12 @@ type TargetHttpsProxy struct { // to a SSL Certificate resource or Certificate Manager Certificate resource. // Mixing Classic Certificates and Certificate Manager Certificates is not // allowed. Certificate Manager Certificates must include the - // certificatemanager API. Certificate Manager Certificates are not supported - // by Global external Application Load Balancer or Classic Application Load - // Balancer, use certificate_map instead. Currently, you may specify up to 15 - // Classic SSL Certificates. Certificate Manager Certificates accepted formats - // are: - //certificatemanager.googleapis.com/projects/{project}/locations/{ + // certificatemanager API namespace. Using Certificate Manager Certificates in + // this field is not supported by Global external Application Load Balancer or + // Classic Application Load Balancer, use certificate_map instead. Currently, + // you may specify up to 15 Classic SSL Certificates or up to 100 Certificate + // Manager Certificates. Certificate Manager Certificates accepted formats are: + // - //certificatemanager.googleapis.com/projects/{project}/locations/{ // location}/certificates/{resourceName}. - // https://certificatemanager.googleapis.com/v1alpha1/projects/{project // }/locations/{location}/certificates/{resourceName}. diff --git a/compute/v0.beta/compute2-gen.go b/compute/v0.beta/compute2-gen.go index e440c9880db..a869806b646 100644 --- a/compute/v0.beta/compute2-gen.go +++ b/compute/v0.beta/compute2-gen.go @@ -51233,6 +51233,239 @@ func (c *NetworkFirewallPoliciesAddRuleCall) Do(opts ...googleapi.CallOption) (* return ret, nil } +type NetworkFirewallPoliciesAggregatedListCall struct { + s *Service + project string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// AggregatedList: Retrieves an aggregated list of network firewall policies, +// listing network firewall policies from all applicable scopes (global and +// regional) and grouping the results per scope. To prevent failure, Google +// recommends that you set the `returnPartialSuccess` parameter to `true`. +// +// - project: Project ID for this request. +func (r *NetworkFirewallPoliciesService) AggregatedList(project string) *NetworkFirewallPoliciesAggregatedListCall { + c := &NetworkFirewallPoliciesAggregatedListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + return c +} + +// Filter sets the optional parameter "filter": A filter expression that +// filters resources listed in the response. Most Compute resources support two +// types of filter expressions: expressions that support regular expressions +// and expressions that follow API improvement proposal AIP-160. These two +// types of filter expressions cannot be mixed in one request. If you want to +// use AIP-160, your expression must specify the field name, an operator, and +// the value that you want to use for filtering. The value must be a string, a +// number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, +// `>=` or `:`. For example, if you are filtering Compute Engine instances, you +// can exclude instances named `example-instance` by specifying `name != +// example-instance`. The `:*` comparison can be used to test whether a key has +// been defined. For example, to find all objects with `owner` label use: ``` +// labels.owner:* ``` You can also filter nested fields. For example, you could +// specify `scheduling.automaticRestart = false` to include instances only if +// they are not scheduled for automatic restarts. You can use filtering on +// nested fields to filter based on resource labels. To filter on multiple +// expressions, provide each separate expression within parentheses. For +// example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel +// Skylake") ``` By default, each expression is an `AND` expression. However, +// you can include `AND` and `OR` expressions explicitly. For example: ``` +// (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND +// (scheduling.automaticRestart = true) ``` If you want to use a regular +// expression, use the `eq` (equal) or `ne` (not equal) operator against a +// single un-parenthesized expression with or without quotes or against +// multiple parenthesized expressions. Examples: `fieldname eq unquoted +// literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted +// literal" `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal +// value is interpreted as a regular expression using Google RE2 library +// syntax. The literal value must match the entire field. For example, to +// filter for instances that do not end with name "instance", you would use +// `name ne .*instance`. You cannot combine constraints on multiple fields +// using regular expressions. +func (c *NetworkFirewallPoliciesAggregatedListCall) Filter(filter string) *NetworkFirewallPoliciesAggregatedListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// IncludeAllScopes sets the optional parameter "includeAllScopes": Indicates +// whether every visible scope for each scope type (zone, region, global) +// should be included in the response. For new resource types added after this +// field, the flag has no effect as new resource types will always include +// every visible scope for each scope type in response. For resource types +// which predate this field, if this flag is omitted or false, only scopes of +// the scope types where the resource type is expected to be found will be +// included. +func (c *NetworkFirewallPoliciesAggregatedListCall) IncludeAllScopes(includeAllScopes bool) *NetworkFirewallPoliciesAggregatedListCall { + c.urlParams_.Set("includeAllScopes", fmt.Sprint(includeAllScopes)) + return c +} + +// MaxResults sets the optional parameter "maxResults": The maximum number of +// results per page that should be returned. If the number of available results +// is larger than `maxResults`, Compute Engine returns a `nextPageToken` that +// can be used to get the next page of results in subsequent list requests. +// Acceptable values are `0` to `500`, inclusive. (Default: `500`) +func (c *NetworkFirewallPoliciesAggregatedListCall) MaxResults(maxResults int64) *NetworkFirewallPoliciesAggregatedListCall { + c.urlParams_.Set("maxResults", fmt.Sprint(maxResults)) + return c +} + +// OrderBy sets the optional parameter "orderBy": Sorts list results by a +// certain order. By default, results are returned in alphanumerical order +// based on the resource name. You can also sort results in descending order +// based on the creation timestamp using `orderBy="creationTimestamp desc". +// This sorts results based on the `creationTimestamp` field in reverse +// chronological order (newest result first). Use this to sort resources like +// operations so that the newest operation is returned first. Currently, only +// sorting by `name` or `creationTimestamp desc` is supported. +func (c *NetworkFirewallPoliciesAggregatedListCall) OrderBy(orderBy string) *NetworkFirewallPoliciesAggregatedListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + +// PageToken sets the optional parameter "pageToken": Specifies a page token to +// use. Set `pageToken` to the `nextPageToken` returned by a previous list +// request to get the next page of results. +func (c *NetworkFirewallPoliciesAggregatedListCall) PageToken(pageToken string) *NetworkFirewallPoliciesAggregatedListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// ReturnPartialSuccess sets the optional parameter "returnPartialSuccess": +// Opt-in for partial success behavior which provides partial results in case +// of failure. The default value is false. For example, when partial success +// behavior is enabled, aggregatedList for a single zone scope either returns +// all resources in the zone or no resources, with an error code. +func (c *NetworkFirewallPoliciesAggregatedListCall) ReturnPartialSuccess(returnPartialSuccess bool) *NetworkFirewallPoliciesAggregatedListCall { + c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) + return c +} + +// ServiceProjectNumber sets the optional parameter "serviceProjectNumber": The +// Shared VPC service project id or service project number for which aggregated +// list request is invoked for subnetworks list-usable api. +func (c *NetworkFirewallPoliciesAggregatedListCall) ServiceProjectNumber(serviceProjectNumber int64) *NetworkFirewallPoliciesAggregatedListCall { + c.urlParams_.Set("serviceProjectNumber", fmt.Sprint(serviceProjectNumber)) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *NetworkFirewallPoliciesAggregatedListCall) Fields(s ...googleapi.Field) *NetworkFirewallPoliciesAggregatedListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *NetworkFirewallPoliciesAggregatedListCall) IfNoneMatch(entityTag string) *NetworkFirewallPoliciesAggregatedListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *NetworkFirewallPoliciesAggregatedListCall) Context(ctx context.Context) *NetworkFirewallPoliciesAggregatedListCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *NetworkFirewallPoliciesAggregatedListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *NetworkFirewallPoliciesAggregatedListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/aggregated/firewallPolicies") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.networkFirewallPolicies.aggregatedList", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.networkFirewallPolicies.aggregatedList" call. +// Any non-2xx status code is an error. Response headers are in either +// *NetworkFirewallPolicyAggregatedList.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 *NetworkFirewallPoliciesAggregatedListCall) Do(opts ...googleapi.CallOption) (*NetworkFirewallPolicyAggregatedList, 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 := &NetworkFirewallPolicyAggregatedList{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.networkFirewallPolicies.aggregatedList", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *NetworkFirewallPoliciesAggregatedListCall) Pages(ctx context.Context, f func(*NetworkFirewallPolicyAggregatedList) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + type NetworkFirewallPoliciesCloneRulesCall struct { s *Service project string diff --git a/compute/v1/compute-api.json b/compute/v1/compute-api.json index 68e261dfc8a..46642d05b14 100644 --- a/compute/v1/compute-api.json +++ b/compute/v1/compute-api.json @@ -15883,6 +15883,72 @@ "https://www.googleapis.com/auth/compute" ] }, + "aggregatedList": { + "description": "Retrieves an aggregated list of network firewall policies, listing network firewall policies from all applicable scopes (global and regional) and grouping the results per scope. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`.", + "flatPath": "projects/{project}/aggregated/firewallPolicies", + "httpMethod": "GET", + "id": "compute.networkFirewallPolicies.aggregatedList", + "parameterOrder": [ + "project" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "format": "int64", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/aggregated/firewallPolicies", + "response": { + "$ref": "NetworkFirewallPolicyAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, "cloneRules": { "description": "Copies rules to the specified firewall policy.", "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/cloneRules", @@ -37949,7 +38015,7 @@ } } }, - "revision": "20241201", + "revision": "20241231", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -38539,7 +38605,7 @@ "type": "string" }, "securityPolicy": { - "description": "[Output Only] The resource URL for the security policy associated with this access config.", + "description": "The resource URL for the security policy associated with this access config.", "type": "string" }, "setPublicPtr": { @@ -39671,7 +39737,7 @@ "description": "The customer-supplied encryption key of the source image. Required if the source image is protected by a customer-supplied encryption key. InstanceTemplate and InstancePropertiesPatch do not store customer-supplied encryption keys, so you cannot create disks for instances in a managed instance group if the source images are encrypted with your own keys." }, "sourceSnapshot": { - "description": "The source snapshot to create this disk. When creating a new instance boot disk, one of initializeParams.sourceSnapshot or initializeParams.sourceImage or disks.source is required. To create a disk with a snapshot that you created, specify the snapshot name in the following format: global/snapshots/my-backup If the source snapshot is deleted later, this field will not be set.", + "description": "The source snapshot to create this disk. When creating a new instance boot disk, one of initializeParams.sourceSnapshot or initializeParams.sourceImage or disks.source is required. To create a disk with a snapshot that you created, specify the snapshot name in the following format: global/snapshots/my-backup If the source snapshot is deleted later, this field will not be set. Note: You cannot create VMs in bulk using a snapshot as the source. Use an image instead when you create VMs using the bulk insert method.", "type": "string" }, "sourceSnapshotEncryptionKey": { @@ -45166,7 +45232,7 @@ "additionalProperties": { "type": "string" }, - "description": "Additional structured details about this error. Keys must match /a-z+/ but should ideally be lowerCamelCase. Also they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than {\"instanceLimit\": \"100/request\"}, should be returned as, {\"instanceLimitPerRequest\": \"100\"}, if the client exceeds the number of instances that can be created in a single (batch) request.", + "description": "Additional structured details about this error. Keys must match a regular expression of `a-z+` but should ideally be lowerCamelCase. Also, they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than `{\"instanceLimit\": \"100/request\"}`, should be returned as, `{\"instanceLimitPerRequest\": \"100\"}`, if the client exceeds the number of instances that can be created in a single (batch) request.", "type": "object" }, "reason": { @@ -46012,6 +46078,143 @@ }, "type": "object" }, + "FirewallPoliciesScopedList": { + "id": "FirewallPoliciesScopedList", + "properties": { + "firewallPolicies": { + "description": "A list of firewall policies contained in this scope.", + "items": { + "$ref": "FirewallPolicy" + }, + "type": "array" + }, + "warning": { + "description": "Informational warning which replaces the list of firewall policies when the list is empty.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g: regions.list).", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "type": "string" + }, + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", + "type": "string" + } + }, + "type": "object" + } + }, + "type": "object" + }, "FirewallPolicy": { "description": "Represents a Firewall Policy resource.", "id": "FirewallPolicy", @@ -55148,8 +55351,9 @@ "type": "boolean" }, "bandwidth": { - "description": "Provisioned bandwidth capacity for the interconnect attachment. For attachments of type DEDICATED, the user can set the bandwidth. For attachments of type PARTNER, the Google Partner that is operating the interconnect must set the bandwidth. Output only for PARTNER type, mutable for PARTNER_PROVIDER and DEDICATED, and can take one of the following values: - BPS_50M: 50 Mbit/s - BPS_100M: 100 Mbit/s - BPS_200M: 200 Mbit/s - BPS_300M: 300 Mbit/s - BPS_400M: 400 Mbit/s - BPS_500M: 500 Mbit/s - BPS_1G: 1 Gbit/s - BPS_2G: 2 Gbit/s - BPS_5G: 5 Gbit/s - BPS_10G: 10 Gbit/s - BPS_20G: 20 Gbit/s - BPS_50G: 50 Gbit/s ", + "description": "Provisioned bandwidth capacity for the interconnect attachment. For attachments of type DEDICATED, the user can set the bandwidth. For attachments of type PARTNER, the Google Partner that is operating the interconnect must set the bandwidth. Output only for PARTNER type, mutable for PARTNER_PROVIDER and DEDICATED, and can take one of the following values: - BPS_50M: 50 Mbit/s - BPS_100M: 100 Mbit/s - BPS_200M: 200 Mbit/s - BPS_300M: 300 Mbit/s - BPS_400M: 400 Mbit/s - BPS_500M: 500 Mbit/s - BPS_1G: 1 Gbit/s - BPS_2G: 2 Gbit/s - BPS_5G: 5 Gbit/s - BPS_10G: 10 Gbit/s - BPS_20G: 20 Gbit/s - BPS_50G: 50 Gbit/s - BPS_100G: 100 Gbit/s ", "enum": [ + "BPS_100G", "BPS_100M", "BPS_10G", "BPS_1G", @@ -55164,6 +55368,7 @@ "BPS_5G" ], "enumDescriptions": [ + "100 Gbit/s", "100 Mbit/s", "10 Gbit/s", "1 Gbit/s", @@ -55187,7 +55392,7 @@ "type": "array" }, "candidateSubnets": { - "description": "Up to 16 candidate prefixes that can be used to restrict the allocation of cloudRouterIpAddress and customerRouterIpAddress for this attachment. All prefixes must be within link-local address space (169.254.0.0/16) and must be /29 or shorter (/28, /27, etc). Google will attempt to select an unused /29 from the supplied candidate prefix(es). The request will fail if all possible /29s are in use on Google's edge. If not supplied, Google will randomly select an unused /29 from all of link-local space.", + "description": "Input only. Up to 16 candidate prefixes that can be used to restrict the allocation of cloudRouterIpAddress and customerRouterIpAddress for this attachment. All prefixes must be within link-local address space (169.254.0.0/16) and must be /29 or shorter (/28, /27, etc). Google will attempt to select an unused /29 from the supplied candidate prefix(es). The request will fail if all possible /29s are in use on Google's edge. If not supplied, Google will randomly select an unused /29 from all of link-local space.", "items": { "type": "string" }, @@ -55235,7 +55440,7 @@ "type": "string" }, "edgeAvailabilityDomain": { - "description": "Desired availability domain for the attachment. Only available for type PARTNER, at creation time, and can take one of the following values: - AVAILABILITY_DOMAIN_ANY - AVAILABILITY_DOMAIN_1 - AVAILABILITY_DOMAIN_2 For improved reliability, customers should configure a pair of attachments, one per availability domain. The selected availability domain will be provided to the Partner via the pairing key, so that the provisioned circuit will lie in the specified domain. If not specified, the value will default to AVAILABILITY_DOMAIN_ANY.", + "description": "Input only. Desired availability domain for the attachment. Only available for type PARTNER, at creation time, and can take one of the following values: - AVAILABILITY_DOMAIN_ANY - AVAILABILITY_DOMAIN_1 - AVAILABILITY_DOMAIN_2 For improved reliability, customers should configure a pair of attachments, one per availability domain. The selected availability domain will be provided to the Partner via the pairing key, so that the provisioned circuit will lie in the specified domain. If not specified, the value will default to AVAILABILITY_DOMAIN_ANY.", "enum": [ "AVAILABILITY_DOMAIN_1", "AVAILABILITY_DOMAIN_2", @@ -55392,7 +55597,7 @@ "type": "string" }, "subnetLength": { - "description": "Length of the IPv4 subnet mask. Allowed values: - 29 (default) - 30 The default value is 29, except for Cross-Cloud Interconnect connections that use an InterconnectRemoteLocation with a constraints.subnetLengthRange.min equal to 30. For example, connections that use an Azure remote location fall into this category. In these cases, the default value is 30, and requesting 29 returns an error. Where both 29 and 30 are allowed, 29 is preferred, because it gives Google Cloud Support more debugging visibility. ", + "description": "Input only. Length of the IPv4 subnet mask. Allowed values: - 29 (default) - 30 The default value is 29, except for Cross-Cloud Interconnect connections that use an InterconnectRemoteLocation with a constraints.subnetLengthRange.min equal to 30. For example, connections that use an Azure remote location fall into this category. In these cases, the default value is 30, and requesting 29 returns an error. Where both 29 and 30 are allowed, 29 is preferred, because it gives Google Cloud Support more debugging visibility. ", "format": "int32", "type": "integer" }, @@ -60745,6 +60950,168 @@ }, "type": "object" }, + "NetworkFirewallPolicyAggregatedList": { + "id": "NetworkFirewallPolicyAggregatedList", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "additionalProperties": { + "$ref": "FirewallPoliciesScopedList", + "description": "Name of the scope containing this set of addresses." + }, + "description": "A list of FirewallPoliciesScopedList resources.", + "type": "object" + }, + "kind": { + "default": "compute#networkFirewallPolicyAggregatedList", + "description": "[Output Only] Type of resource. Always compute#networkFirewallPoliciesAggregatedList for lists of network firewall policies.", + "type": "string" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "items": { + "type": "string" + }, + "type": "array" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g: regions.list).", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "type": "string" + }, + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", + "type": "string" + } + }, + "type": "object" + } + }, + "type": "object" + }, "NetworkInterface": { "description": "A network interface resource attached to an instance.", "id": "NetworkInterface", @@ -61678,6 +62045,22 @@ ], "type": "string" }, + "effectiveBgpAlwaysCompareMed": { + "description": "[Output Only] Effective value of the bgp_always_compare_med field.", + "type": "boolean" + }, + "effectiveBgpInterRegionCost": { + "description": "[Output Only] Effective value of the bgp_inter_region_cost field.", + "enum": [ + "ADD_COST_TO_MED", + "DEFAULT" + ], + "enumDescriptions": [ + "", + "" + ], + "type": "string" + }, "routingMode": { "description": "The network-wide routing mode to use. If set to REGIONAL, this network's Cloud Routers will only advertise routes with subnets of this network in the same region as the router. If set to GLOBAL, this network's Cloud Routers will advertise routes with all subnets of this network, across regions.", "enum": [ @@ -80209,7 +80592,7 @@ "type": "string" }, "sslCertificates": { - "description": "URLs to SslCertificate resources that are used to authenticate connections between users and the load balancer. At least one SSL certificate must be specified. SslCertificates do not apply when the load balancing scheme is set to INTERNAL_SELF_MANAGED. The URLs should refer to a SSL Certificate resource or Certificate Manager Certificate resource. Mixing Classic Certificates and Certificate Manager Certificates is not allowed. Certificate Manager Certificates must include the certificatemanager API. Certificate Manager Certificates are not supported by Global external Application Load Balancer or Classic Application Load Balancer, use certificate_map instead. Currently, you may specify up to 15 Classic SSL Certificates. Certificate Manager Certificates accepted formats are: - //certificatemanager.googleapis.com/projects/{project}/locations/{ location}/certificates/{resourceName}. - https://certificatemanager.googleapis.com/v1alpha1/projects/{project }/locations/{location}/certificates/{resourceName}. ", + "description": "URLs to SslCertificate resources that are used to authenticate connections between users and the load balancer. At least one SSL certificate must be specified. SslCertificates do not apply when the load balancing scheme is set to INTERNAL_SELF_MANAGED. The URLs should refer to a SSL Certificate resource or Certificate Manager Certificate resource. Mixing Classic Certificates and Certificate Manager Certificates is not allowed. Certificate Manager Certificates must include the certificatemanager API namespace. Using Certificate Manager Certificates in this field is not supported by Global external Application Load Balancer or Classic Application Load Balancer, use certificate_map instead. Currently, you may specify up to 15 Classic SSL Certificates or up to 100 Certificate Manager Certificates. Certificate Manager Certificates accepted formats are: - //certificatemanager.googleapis.com/projects/{project}/locations/{ location}/certificates/{resourceName}. - https://certificatemanager.googleapis.com/v1alpha1/projects/{project }/locations/{location}/certificates/{resourceName}. ", "items": { "type": "string" }, diff --git a/compute/v1/compute-gen.go b/compute/v1/compute-gen.go index d097ac480c8..6ad1ef763db 100644 --- a/compute/v1/compute-gen.go +++ b/compute/v1/compute-gen.go @@ -2017,8 +2017,8 @@ type AccessConfig struct { // If this field is unspecified in ipv6AccessConfig, a default PTR record will // be created for first IP in associated external IPv6 range. PublicPtrDomainName string `json:"publicPtrDomainName,omitempty"` - // SecurityPolicy: [Output Only] The resource URL for the security policy - // associated with this access config. + // SecurityPolicy: The resource URL for the security policy associated with + // this access config. SecurityPolicy string `json:"securityPolicy,omitempty"` // SetPublicPtr: Specifies whether a public DNS 'PTR' record should be created // to map the external IP address of the instance to a DNS domain name. This @@ -3237,7 +3237,9 @@ type AttachedDiskInitializeParams struct { // initializeParams.sourceImage or disks.source is required. To create a disk // with a snapshot that you created, specify the snapshot name in the following // format: global/snapshots/my-backup If the source snapshot is deleted later, - // this field will not be set. + // this field will not be set. Note: You cannot create VMs in bulk using a + // snapshot as the source. Use an image instead when you create VMs using the + // bulk insert method. SourceSnapshot string `json:"sourceSnapshot,omitempty"` // SourceSnapshotEncryptionKey: The customer-supplied encryption key of the // source snapshot. @@ -9914,13 +9916,14 @@ type ErrorInfo struct { // unique value that identifies the infrastructure. For Google API // infrastructure, the error domain is "googleapis.com". Domain string `json:"domain,omitempty"` - // Metadatas: Additional structured details about this error. Keys must match - // /a-z+/ but should ideally be lowerCamelCase. Also they must be limited to 64 - // characters in length. When identifying the current value of an exceeded - // limit, the units should be contained in the key, not the value. For example, - // rather than {"instanceLimit": "100/request"}, should be returned as, - // {"instanceLimitPerRequest": "100"}, if the client exceeds the number of - // instances that can be created in a single (batch) request. + // Metadatas: Additional structured details about this error. Keys must match a + // regular expression of `a-z+` but should ideally be lowerCamelCase. Also, + // they must be limited to 64 characters in length. When identifying the + // current value of an exceeded limit, the units should be contained in the + // key, not the value. For example, rather than `{"instanceLimit": + // "100/request"}`, should be returned as, `{"instanceLimitPerRequest": + // "100"}`, if the client exceeds the number of instances that can be created + // in a single (batch) request. Metadatas map[string]string `json:"metadatas,omitempty"` // Reason: The reason of the error. This is a constant value that identifies // the proximate cause of the error. Error reasons are unique within a @@ -10917,6 +10920,147 @@ func (s FirewallPoliciesListAssociationsResponse) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type FirewallPoliciesScopedList struct { + // FirewallPolicies: A list of firewall policies contained in this scope. + FirewallPolicies []*FirewallPolicy `json:"firewallPolicies,omitempty"` + // Warning: Informational warning which replaces the list of firewall policies + // when the list is empty. + Warning *FirewallPoliciesScopedListWarning `json:"warning,omitempty"` + // ForceSendFields is a list of field names (e.g. "FirewallPolicies") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "FirewallPolicies") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s FirewallPoliciesScopedList) MarshalJSON() ([]byte, error) { + type NoMethod FirewallPoliciesScopedList + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// FirewallPoliciesScopedListWarning: Informational warning which replaces the +// list of firewall policies when the list is empty. +type FirewallPoliciesScopedListWarning struct { + // Code: [Output Only] A warning code, if applicable. For example, Compute + // Engine returns NO_RESULTS_ON_PAGE if there are no results in the response. + // + // Possible values: + // "CLEANUP_FAILED" - Warning about failed cleanup of transient changes made + // by a failed operation. + // "DEPRECATED_RESOURCE_USED" - A link to a deprecated resource was created. + // "DEPRECATED_TYPE_USED" - When deploying and at least one of the resources + // has a type marked as deprecated + // "DISK_SIZE_LARGER_THAN_IMAGE_SIZE" - The user created a boot disk that is + // larger than image size. + // "EXPERIMENTAL_TYPE_USED" - When deploying and at least one of the + // resources has a type marked as experimental + // "EXTERNAL_API_WARNING" - Warning that is present in an external api call + // "FIELD_VALUE_OVERRIDEN" - Warning that value of a field has been + // overridden. Deprecated unused field. + // "INJECTED_KERNELS_DEPRECATED" - The operation involved use of an injected + // kernel, which is deprecated. + // "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB" - A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // "LARGE_DEPLOYMENT_WARNING" - When deploying a deployment with a + // exceedingly large number of resources + // "LIST_OVERHEAD_QUOTA_EXCEED" - Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out by + // user-defined list filter. + // "MISSING_TYPE_DEPENDENCY" - A resource depends on a missing type + // "NEXT_HOP_ADDRESS_NOT_ASSIGNED" - The route's nextHopIp address is not + // assigned to an instance on the network. + // "NEXT_HOP_CANNOT_IP_FORWARD" - The route's next hop instance cannot ip + // forward. + // "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE" - The route's nextHopInstance + // URL refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // "NEXT_HOP_INSTANCE_NOT_FOUND" - The route's nextHopInstance URL refers to + // an instance that does not exist. + // "NEXT_HOP_INSTANCE_NOT_ON_NETWORK" - The route's nextHopInstance URL + // refers to an instance that is not on the same network as the route. + // "NEXT_HOP_NOT_RUNNING" - The route's next hop instance does not have a + // status of RUNNING. + // "NOT_CRITICAL_ERROR" - Error which is not critical. We decided to continue + // the process despite the mentioned error. + // "NO_RESULTS_ON_PAGE" - No results are present on a particular list page. + // "PARTIAL_SUCCESS" - Success is reported, but some results may be missing + // due to errors + // "QUOTA_INFO_UNAVAILABLE" - Quota information is not available to client + // requests (e.g: regions.list). + // "REQUIRED_TOS_AGREEMENT" - The user attempted to use a resource that + // requires a TOS they have not accepted. + // "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING" - Warning that a resource is + // in use. + // "RESOURCE_NOT_DELETED" - One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // "SCHEMA_VALIDATION_IGNORED" - When a resource schema validation is + // ignored. + // "SINGLE_INSTANCE_PROPERTY_TEMPLATE" - Instance template used in instance + // group manager is valid as such, but its application does not make a lot of + // sense, because it allows only single instance in instance group. + // "UNDECLARED_PROPERTIES" - When undeclared properties in the schema are + // present + // "UNREACHABLE" - A given scope cannot be reached. + Code string `json:"code,omitempty"` + // Data: [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + Data []*FirewallPoliciesScopedListWarningData `json:"data,omitempty"` + // Message: [Output Only] A human-readable description of the warning code. + Message string `json:"message,omitempty"` + // ForceSendFields is a list of field names (e.g. "Code") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Code") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s FirewallPoliciesScopedListWarning) MarshalJSON() ([]byte, error) { + type NoMethod FirewallPoliciesScopedListWarning + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type FirewallPoliciesScopedListWarningData struct { + // Key: [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a list + // request for a particular zone, this key might be scope and the key value + // might be the zone name. Other examples might be a key indicating a + // deprecated resource and a suggested replacement, or a warning about invalid + // network settings (for example, if an instance attempts to perform IP + // forwarding but is not enabled for IP forwarding). + Key string `json:"key,omitempty"` + // Value: [Output Only] A warning data value corresponding to the key. + Value string `json:"value,omitempty"` + // ForceSendFields is a list of field names (e.g. "Key") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Key") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s FirewallPoliciesScopedListWarningData) MarshalJSON() ([]byte, error) { + type NoMethod FirewallPoliciesScopedListWarningData + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // FirewallPolicy: Represents a Firewall Policy resource. type FirewallPolicy struct { // Associations: A list of associations that belong to this firewall policy. @@ -21439,9 +21583,10 @@ type InterconnectAttachment struct { // values: - BPS_50M: 50 Mbit/s - BPS_100M: 100 Mbit/s - BPS_200M: 200 Mbit/s - // BPS_300M: 300 Mbit/s - BPS_400M: 400 Mbit/s - BPS_500M: 500 Mbit/s - BPS_1G: // 1 Gbit/s - BPS_2G: 2 Gbit/s - BPS_5G: 5 Gbit/s - BPS_10G: 10 Gbit/s - - // BPS_20G: 20 Gbit/s - BPS_50G: 50 Gbit/s + // BPS_20G: 20 Gbit/s - BPS_50G: 50 Gbit/s - BPS_100G: 100 Gbit/s // // Possible values: + // "BPS_100G" - 100 Gbit/s // "BPS_100M" - 100 Mbit/s // "BPS_10G" - 10 Gbit/s // "BPS_1G" - 1 Gbit/s @@ -21457,14 +21602,14 @@ type InterconnectAttachment struct { Bandwidth string `json:"bandwidth,omitempty"` // CandidateIpv6Subnets: This field is not available. CandidateIpv6Subnets []string `json:"candidateIpv6Subnets,omitempty"` - // CandidateSubnets: Up to 16 candidate prefixes that can be used to restrict - // the allocation of cloudRouterIpAddress and customerRouterIpAddress for this - // attachment. All prefixes must be within link-local address space - // (169.254.0.0/16) and must be /29 or shorter (/28, /27, etc). Google will - // attempt to select an unused /29 from the supplied candidate prefix(es). The - // request will fail if all possible /29s are in use on Google's edge. If not - // supplied, Google will randomly select an unused /29 from all of link-local - // space. + // CandidateSubnets: Input only. Up to 16 candidate prefixes that can be used + // to restrict the allocation of cloudRouterIpAddress and + // customerRouterIpAddress for this attachment. All prefixes must be within + // link-local address space (169.254.0.0/16) and must be /29 or shorter (/28, + // /27, etc). Google will attempt to select an unused /29 from the supplied + // candidate prefix(es). The request will fail if all possible /29s are in use + // on Google's edge. If not supplied, Google will randomly select an unused /29 + // from all of link-local space. CandidateSubnets []string `json:"candidateSubnets,omitempty"` // CloudRouterIpAddress: [Output Only] IPv4 address + prefix length to be // configured on Cloud Router Interface for this interconnect attachment. @@ -21496,14 +21641,14 @@ type InterconnectAttachment struct { DataplaneVersion int64 `json:"dataplaneVersion,omitempty"` // Description: An optional description of this resource. Description string `json:"description,omitempty"` - // EdgeAvailabilityDomain: Desired availability domain for the attachment. Only - // available for type PARTNER, at creation time, and can take one of the - // following values: - AVAILABILITY_DOMAIN_ANY - AVAILABILITY_DOMAIN_1 - - // AVAILABILITY_DOMAIN_2 For improved reliability, customers should configure a - // pair of attachments, one per availability domain. The selected availability - // domain will be provided to the Partner via the pairing key, so that the - // provisioned circuit will lie in the specified domain. If not specified, the - // value will default to AVAILABILITY_DOMAIN_ANY. + // EdgeAvailabilityDomain: Input only. Desired availability domain for the + // attachment. Only available for type PARTNER, at creation time, and can take + // one of the following values: - AVAILABILITY_DOMAIN_ANY - + // AVAILABILITY_DOMAIN_1 - AVAILABILITY_DOMAIN_2 For improved reliability, + // customers should configure a pair of attachments, one per availability + // domain. The selected availability domain will be provided to the Partner via + // the pairing key, so that the provisioned circuit will lie in the specified + // domain. If not specified, the value will default to AVAILABILITY_DOMAIN_ANY. // // Possible values: // "AVAILABILITY_DOMAIN_1" @@ -21677,9 +21822,9 @@ type InterconnectAttachment struct { // "UNPROVISIONED" - Indicates that attachment is not ready to use yet, // because turnup is not complete. State string `json:"state,omitempty"` - // SubnetLength: Length of the IPv4 subnet mask. Allowed values: - 29 (default) - // - 30 The default value is 29, except for Cross-Cloud Interconnect - // connections that use an InterconnectRemoteLocation with a + // SubnetLength: Input only. Length of the IPv4 subnet mask. Allowed values: - + // 29 (default) - 30 The default value is 29, except for Cross-Cloud + // Interconnect connections that use an InterconnectRemoteLocation with a // constraints.subnetLengthRange.min equal to 30. For example, connections that // use an Azure remote location fall into this category. In these cases, the // default value is 30, and requesting 29 returns an error. Where both 29 and @@ -27619,6 +27764,165 @@ func (s NetworkEndpointWithHealthStatus) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type NetworkFirewallPolicyAggregatedList struct { + // Id: [Output Only] Unique identifier for the resource; defined by the server. + Id string `json:"id,omitempty"` + // Items: A list of FirewallPoliciesScopedList resources. + Items map[string]FirewallPoliciesScopedList `json:"items,omitempty"` + // Kind: [Output Only] Type of resource. Always + // compute#networkFirewallPoliciesAggregatedList for lists of network firewall + // policies. + Kind string `json:"kind,omitempty"` + // NextPageToken: [Output Only] This token allows you to get the next page of + // results for list requests. If the number of results is larger than + // maxResults, use the nextPageToken as a value for the query parameter + // pageToken in the next list request. Subsequent list requests will have their + // own nextPageToken to continue paging through the results. + NextPageToken string `json:"nextPageToken,omitempty"` + // SelfLink: [Output Only] Server-defined URL for this resource. + SelfLink string `json:"selfLink,omitempty"` + // Unreachables: [Output Only] Unreachable resources. + Unreachables []string `json:"unreachables,omitempty"` + // Warning: [Output Only] Informational warning message. + Warning *NetworkFirewallPolicyAggregatedListWarning `json:"warning,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Id") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Id") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s NetworkFirewallPolicyAggregatedList) MarshalJSON() ([]byte, error) { + type NoMethod NetworkFirewallPolicyAggregatedList + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// NetworkFirewallPolicyAggregatedListWarning: [Output Only] Informational +// warning message. +type NetworkFirewallPolicyAggregatedListWarning struct { + // Code: [Output Only] A warning code, if applicable. For example, Compute + // Engine returns NO_RESULTS_ON_PAGE if there are no results in the response. + // + // Possible values: + // "CLEANUP_FAILED" - Warning about failed cleanup of transient changes made + // by a failed operation. + // "DEPRECATED_RESOURCE_USED" - A link to a deprecated resource was created. + // "DEPRECATED_TYPE_USED" - When deploying and at least one of the resources + // has a type marked as deprecated + // "DISK_SIZE_LARGER_THAN_IMAGE_SIZE" - The user created a boot disk that is + // larger than image size. + // "EXPERIMENTAL_TYPE_USED" - When deploying and at least one of the + // resources has a type marked as experimental + // "EXTERNAL_API_WARNING" - Warning that is present in an external api call + // "FIELD_VALUE_OVERRIDEN" - Warning that value of a field has been + // overridden. Deprecated unused field. + // "INJECTED_KERNELS_DEPRECATED" - The operation involved use of an injected + // kernel, which is deprecated. + // "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB" - A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // "LARGE_DEPLOYMENT_WARNING" - When deploying a deployment with a + // exceedingly large number of resources + // "LIST_OVERHEAD_QUOTA_EXCEED" - Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out by + // user-defined list filter. + // "MISSING_TYPE_DEPENDENCY" - A resource depends on a missing type + // "NEXT_HOP_ADDRESS_NOT_ASSIGNED" - The route's nextHopIp address is not + // assigned to an instance on the network. + // "NEXT_HOP_CANNOT_IP_FORWARD" - The route's next hop instance cannot ip + // forward. + // "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE" - The route's nextHopInstance + // URL refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // "NEXT_HOP_INSTANCE_NOT_FOUND" - The route's nextHopInstance URL refers to + // an instance that does not exist. + // "NEXT_HOP_INSTANCE_NOT_ON_NETWORK" - The route's nextHopInstance URL + // refers to an instance that is not on the same network as the route. + // "NEXT_HOP_NOT_RUNNING" - The route's next hop instance does not have a + // status of RUNNING. + // "NOT_CRITICAL_ERROR" - Error which is not critical. We decided to continue + // the process despite the mentioned error. + // "NO_RESULTS_ON_PAGE" - No results are present on a particular list page. + // "PARTIAL_SUCCESS" - Success is reported, but some results may be missing + // due to errors + // "QUOTA_INFO_UNAVAILABLE" - Quota information is not available to client + // requests (e.g: regions.list). + // "REQUIRED_TOS_AGREEMENT" - The user attempted to use a resource that + // requires a TOS they have not accepted. + // "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING" - Warning that a resource is + // in use. + // "RESOURCE_NOT_DELETED" - One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // "SCHEMA_VALIDATION_IGNORED" - When a resource schema validation is + // ignored. + // "SINGLE_INSTANCE_PROPERTY_TEMPLATE" - Instance template used in instance + // group manager is valid as such, but its application does not make a lot of + // sense, because it allows only single instance in instance group. + // "UNDECLARED_PROPERTIES" - When undeclared properties in the schema are + // present + // "UNREACHABLE" - A given scope cannot be reached. + Code string `json:"code,omitempty"` + // Data: [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + Data []*NetworkFirewallPolicyAggregatedListWarningData `json:"data,omitempty"` + // Message: [Output Only] A human-readable description of the warning code. + Message string `json:"message,omitempty"` + // ForceSendFields is a list of field names (e.g. "Code") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Code") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s NetworkFirewallPolicyAggregatedListWarning) MarshalJSON() ([]byte, error) { + type NoMethod NetworkFirewallPolicyAggregatedListWarning + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type NetworkFirewallPolicyAggregatedListWarningData struct { + // Key: [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a list + // request for a particular zone, this key might be scope and the key value + // might be the zone name. Other examples might be a key indicating a + // deprecated resource and a suggested replacement, or a warning about invalid + // network settings (for example, if an instance attempts to perform IP + // forwarding but is not enabled for IP forwarding). + Key string `json:"key,omitempty"` + // Value: [Output Only] A warning data value corresponding to the key. + Value string `json:"value,omitempty"` + // ForceSendFields is a list of field names (e.g. "Key") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Key") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s NetworkFirewallPolicyAggregatedListWarningData) MarshalJSON() ([]byte, error) { + type NoMethod NetworkFirewallPolicyAggregatedListWarningData + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // NetworkInterface: A network interface resource attached to an instance. type NetworkInterface struct { // AccessConfigs: An array of configurations for this interface. Currently, @@ -28437,6 +28741,16 @@ type NetworkRoutingConfig struct { // "ADD_COST_TO_MED" // "DEFAULT" BgpInterRegionCost string `json:"bgpInterRegionCost,omitempty"` + // EffectiveBgpAlwaysCompareMed: [Output Only] Effective value of the + // bgp_always_compare_med field. + EffectiveBgpAlwaysCompareMed bool `json:"effectiveBgpAlwaysCompareMed,omitempty"` + // EffectiveBgpInterRegionCost: [Output Only] Effective value of the + // bgp_inter_region_cost field. + // + // Possible values: + // "ADD_COST_TO_MED" + // "DEFAULT" + EffectiveBgpInterRegionCost string `json:"effectiveBgpInterRegionCost,omitempty"` // RoutingMode: The network-wide routing mode to use. If set to REGIONAL, this // network's Cloud Routers will only advertise routes with subnets of this // network in the same region as the router. If set to GLOBAL, this network's @@ -48417,11 +48731,12 @@ type TargetHttpsProxy struct { // to a SSL Certificate resource or Certificate Manager Certificate resource. // Mixing Classic Certificates and Certificate Manager Certificates is not // allowed. Certificate Manager Certificates must include the - // certificatemanager API. Certificate Manager Certificates are not supported - // by Global external Application Load Balancer or Classic Application Load - // Balancer, use certificate_map instead. Currently, you may specify up to 15 - // Classic SSL Certificates. Certificate Manager Certificates accepted formats - // are: - //certificatemanager.googleapis.com/projects/{project}/locations/{ + // certificatemanager API namespace. Using Certificate Manager Certificates in + // this field is not supported by Global external Application Load Balancer or + // Classic Application Load Balancer, use certificate_map instead. Currently, + // you may specify up to 15 Classic SSL Certificates or up to 100 Certificate + // Manager Certificates. Certificate Manager Certificates accepted formats are: + // - //certificatemanager.googleapis.com/projects/{project}/locations/{ // location}/certificates/{resourceName}. - // https://certificatemanager.googleapis.com/v1alpha1/projects/{project // }/locations/{location}/certificates/{resourceName}. diff --git a/compute/v1/compute2-gen.go b/compute/v1/compute2-gen.go index 370ae7ee2e4..035b5167039 100644 --- a/compute/v1/compute2-gen.go +++ b/compute/v1/compute2-gen.go @@ -46882,6 +46882,239 @@ func (c *NetworkFirewallPoliciesAddRuleCall) Do(opts ...googleapi.CallOption) (* return ret, nil } +type NetworkFirewallPoliciesAggregatedListCall struct { + s *Service + project string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// AggregatedList: Retrieves an aggregated list of network firewall policies, +// listing network firewall policies from all applicable scopes (global and +// regional) and grouping the results per scope. To prevent failure, Google +// recommends that you set the `returnPartialSuccess` parameter to `true`. +// +// - project: Project ID for this request. +func (r *NetworkFirewallPoliciesService) AggregatedList(project string) *NetworkFirewallPoliciesAggregatedListCall { + c := &NetworkFirewallPoliciesAggregatedListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + return c +} + +// Filter sets the optional parameter "filter": A filter expression that +// filters resources listed in the response. Most Compute resources support two +// types of filter expressions: expressions that support regular expressions +// and expressions that follow API improvement proposal AIP-160. These two +// types of filter expressions cannot be mixed in one request. If you want to +// use AIP-160, your expression must specify the field name, an operator, and +// the value that you want to use for filtering. The value must be a string, a +// number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, +// `>=` or `:`. For example, if you are filtering Compute Engine instances, you +// can exclude instances named `example-instance` by specifying `name != +// example-instance`. The `:*` comparison can be used to test whether a key has +// been defined. For example, to find all objects with `owner` label use: ``` +// labels.owner:* ``` You can also filter nested fields. For example, you could +// specify `scheduling.automaticRestart = false` to include instances only if +// they are not scheduled for automatic restarts. You can use filtering on +// nested fields to filter based on resource labels. To filter on multiple +// expressions, provide each separate expression within parentheses. For +// example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel +// Skylake") ``` By default, each expression is an `AND` expression. However, +// you can include `AND` and `OR` expressions explicitly. For example: ``` +// (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND +// (scheduling.automaticRestart = true) ``` If you want to use a regular +// expression, use the `eq` (equal) or `ne` (not equal) operator against a +// single un-parenthesized expression with or without quotes or against +// multiple parenthesized expressions. Examples: `fieldname eq unquoted +// literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted +// literal" `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal +// value is interpreted as a regular expression using Google RE2 library +// syntax. The literal value must match the entire field. For example, to +// filter for instances that do not end with name "instance", you would use +// `name ne .*instance`. You cannot combine constraints on multiple fields +// using regular expressions. +func (c *NetworkFirewallPoliciesAggregatedListCall) Filter(filter string) *NetworkFirewallPoliciesAggregatedListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// IncludeAllScopes sets the optional parameter "includeAllScopes": Indicates +// whether every visible scope for each scope type (zone, region, global) +// should be included in the response. For new resource types added after this +// field, the flag has no effect as new resource types will always include +// every visible scope for each scope type in response. For resource types +// which predate this field, if this flag is omitted or false, only scopes of +// the scope types where the resource type is expected to be found will be +// included. +func (c *NetworkFirewallPoliciesAggregatedListCall) IncludeAllScopes(includeAllScopes bool) *NetworkFirewallPoliciesAggregatedListCall { + c.urlParams_.Set("includeAllScopes", fmt.Sprint(includeAllScopes)) + return c +} + +// MaxResults sets the optional parameter "maxResults": The maximum number of +// results per page that should be returned. If the number of available results +// is larger than `maxResults`, Compute Engine returns a `nextPageToken` that +// can be used to get the next page of results in subsequent list requests. +// Acceptable values are `0` to `500`, inclusive. (Default: `500`) +func (c *NetworkFirewallPoliciesAggregatedListCall) MaxResults(maxResults int64) *NetworkFirewallPoliciesAggregatedListCall { + c.urlParams_.Set("maxResults", fmt.Sprint(maxResults)) + return c +} + +// OrderBy sets the optional parameter "orderBy": Sorts list results by a +// certain order. By default, results are returned in alphanumerical order +// based on the resource name. You can also sort results in descending order +// based on the creation timestamp using `orderBy="creationTimestamp desc". +// This sorts results based on the `creationTimestamp` field in reverse +// chronological order (newest result first). Use this to sort resources like +// operations so that the newest operation is returned first. Currently, only +// sorting by `name` or `creationTimestamp desc` is supported. +func (c *NetworkFirewallPoliciesAggregatedListCall) OrderBy(orderBy string) *NetworkFirewallPoliciesAggregatedListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + +// PageToken sets the optional parameter "pageToken": Specifies a page token to +// use. Set `pageToken` to the `nextPageToken` returned by a previous list +// request to get the next page of results. +func (c *NetworkFirewallPoliciesAggregatedListCall) PageToken(pageToken string) *NetworkFirewallPoliciesAggregatedListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// ReturnPartialSuccess sets the optional parameter "returnPartialSuccess": +// Opt-in for partial success behavior which provides partial results in case +// of failure. The default value is false. For example, when partial success +// behavior is enabled, aggregatedList for a single zone scope either returns +// all resources in the zone or no resources, with an error code. +func (c *NetworkFirewallPoliciesAggregatedListCall) ReturnPartialSuccess(returnPartialSuccess bool) *NetworkFirewallPoliciesAggregatedListCall { + c.urlParams_.Set("returnPartialSuccess", fmt.Sprint(returnPartialSuccess)) + return c +} + +// ServiceProjectNumber sets the optional parameter "serviceProjectNumber": The +// Shared VPC service project id or service project number for which aggregated +// list request is invoked for subnetworks list-usable api. +func (c *NetworkFirewallPoliciesAggregatedListCall) ServiceProjectNumber(serviceProjectNumber int64) *NetworkFirewallPoliciesAggregatedListCall { + c.urlParams_.Set("serviceProjectNumber", fmt.Sprint(serviceProjectNumber)) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *NetworkFirewallPoliciesAggregatedListCall) Fields(s ...googleapi.Field) *NetworkFirewallPoliciesAggregatedListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *NetworkFirewallPoliciesAggregatedListCall) IfNoneMatch(entityTag string) *NetworkFirewallPoliciesAggregatedListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *NetworkFirewallPoliciesAggregatedListCall) Context(ctx context.Context) *NetworkFirewallPoliciesAggregatedListCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *NetworkFirewallPoliciesAggregatedListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *NetworkFirewallPoliciesAggregatedListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/aggregated/firewallPolicies") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.networkFirewallPolicies.aggregatedList", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.networkFirewallPolicies.aggregatedList" call. +// Any non-2xx status code is an error. Response headers are in either +// *NetworkFirewallPolicyAggregatedList.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 *NetworkFirewallPoliciesAggregatedListCall) Do(opts ...googleapi.CallOption) (*NetworkFirewallPolicyAggregatedList, 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 := &NetworkFirewallPolicyAggregatedList{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "compute.networkFirewallPolicies.aggregatedList", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *NetworkFirewallPoliciesAggregatedListCall) Pages(ctx context.Context, f func(*NetworkFirewallPolicyAggregatedList) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + type NetworkFirewallPoliciesCloneRulesCall struct { s *Service project string diff --git a/connectors/v1/connectors-api.json b/connectors/v1/connectors-api.json index 928b6ab03a5..d99ad34e8cf 100644 --- a/connectors/v1/connectors-api.json +++ b/connectors/v1/connectors-api.json @@ -2558,7 +2558,7 @@ } } }, - "revision": "20241203", + "revision": "20250101", "rootUrl": "https://connectors.googleapis.com/", "schemas": { "AuditConfig": { @@ -4511,10 +4511,6 @@ "$ref": "EndPoint", "description": "OPTION 1: Hit an endpoint when we receive an event." }, - "gsutil": { - "$ref": "GSUtil", - "description": "OPTION 2: Write the event to Cloud Storage bucket." - }, "serviceAccount": { "description": "Service account needed for runtime plane to trigger IP workflow.", "type": "string" @@ -5176,17 +5172,6 @@ }, "type": "object" }, - "GSUtil": { - "description": "GSUtil message includes details of the Destination Cloud Storage bucket.", - "id": "GSUtil", - "properties": { - "gsutilUri": { - "description": "Required. The URI of the Cloud Storage bucket.", - "type": "string" - } - }, - "type": "object" - }, "HPAConfig": { "description": "Autoscaling config for connector deployment system metrics.", "id": "HPAConfig", diff --git a/connectors/v1/connectors-gen.go b/connectors/v1/connectors-gen.go index e7147855d6a..4e00414be6c 100644 --- a/connectors/v1/connectors-gen.go +++ b/connectors/v1/connectors-gen.go @@ -2163,8 +2163,6 @@ func (s EventSubscription) MarshalJSON() ([]byte, error) { type EventSubscriptionDestination struct { // Endpoint: OPTION 1: Hit an endpoint when we receive an event. Endpoint *EndPoint `json:"endpoint,omitempty"` - // Gsutil: OPTION 2: Write the event to Cloud Storage bucket. - Gsutil *GSUtil `json:"gsutil,omitempty"` // ServiceAccount: Service account needed for runtime plane to trigger IP // workflow. ServiceAccount string `json:"serviceAccount,omitempty"` @@ -2730,29 +2728,6 @@ func (s FieldComparison) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GSUtil: GSUtil message includes details of the Destination Cloud Storage -// bucket. -type GSUtil struct { - // GsutilUri: Required. The URI of the Cloud Storage bucket. - GsutilUri string `json:"gsutilUri,omitempty"` - // ForceSendFields is a list of field names (e.g. "GsutilUri") to - // unconditionally include in API requests. By default, fields with empty or - // default values are omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more - // details. - ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "GsutilUri") to include in API - // requests with the JSON null value. By default, fields with empty values are - // omitted from API requests. See - // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. - NullFields []string `json:"-"` -} - -func (s GSUtil) MarshalJSON() ([]byte, error) { - type NoMethod GSUtil - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // HPAConfig: Autoscaling config for connector deployment system metrics. type HPAConfig struct { // CpuUtilizationThreshold: Output only. Percent CPU utilization where HPA diff --git a/css/v1/css-api.json b/css/v1/css-api.json index 226d97f3d4e..543e439b36f 100644 --- a/css/v1/css-api.json +++ b/css/v1/css-api.json @@ -258,7 +258,7 @@ "parameters": { "feedId": { "deprecated": true, - "description": "Optional. The primary or supplemental feed id. If CSS Product already exists and feed id provided is different, then the CSS Product will be moved to a new feed. Note: For now, CSSs do not need to provide feed ids as we create feeds on the fly. We do not have supplemental feed support for CSS Products yet.", + "description": "Optional. DEPRECATED. Feed id is not required for CSS Products. The primary or supplemental feed id. If CSS Product already exists and feed id provided is different, then the CSS Product will be moved to a new feed. Note: For now, CSSs do not need to provide feed ids as we create feeds on the fly. We do not have supplemental feed support for CSS Products yet.", "format": "int64", "location": "query", "type": "string" @@ -507,7 +507,7 @@ } } }, - "revision": "20241217", + "revision": "20250106", "rootUrl": "https://css.googleapis.com/", "schemas": { "Account": { @@ -955,7 +955,7 @@ }, "freshnessTime": { "deprecated": true, - "description": "Represents the existing version (freshness) of the CSS Product, which can be used to preserve the right order when multiple updates are done at the same time. This field must not be set to the future time. If set, the update is prevented if a newer version of the item already exists in our system (that is the last update time of the existing CSS products is later than the freshness time set in the update). If the update happens, the last update time is then set to this freshness time. If not set, the update will not be prevented and the last update time will default to when this request was received by the CSS API. If the operation is prevented, the aborted exception will be thrown.", + "description": "DEPRECATED. Use expiration_date instead. Represents the existing version (freshness) of the CSS Product, which can be used to preserve the right order when multiple updates are done at the same time. This field must not be set to the future time. If set, the update is prevented if a newer version of the item already exists in our system (that is the last update time of the existing CSS products is later than the freshness time set in the update). If the update happens, the last update time is then set to this freshness time. If not set, the update will not be prevented and the last update time will default to when this request was received by the CSS API. If the operation is prevented, the aborted exception will be thrown.", "format": "google-datetime", "type": "string" }, diff --git a/css/v1/css-gen.go b/css/v1/css-gen.go index 5e3ceca5fbc..15b76f35101 100644 --- a/css/v1/css-gen.go +++ b/css/v1/css-gen.go @@ -560,16 +560,17 @@ type CssProductInput struct { // FinalName: Output only. The name of the processed CSS Product. Format: // `accounts/{account}/cssProducts/{css_product}` " FinalName string `json:"finalName,omitempty"` - // FreshnessTime: Represents the existing version (freshness) of the CSS - // Product, which can be used to preserve the right order when multiple updates - // are done at the same time. This field must not be set to the future time. If - // set, the update is prevented if a newer version of the item already exists - // in our system (that is the last update time of the existing CSS products is - // later than the freshness time set in the update). If the update happens, the - // last update time is then set to this freshness time. If not set, the update - // will not be prevented and the last update time will default to when this - // request was received by the CSS API. If the operation is prevented, the - // aborted exception will be thrown. + // FreshnessTime: DEPRECATED. Use expiration_date instead. Represents the + // existing version (freshness) of the CSS Product, which can be used to + // preserve the right order when multiple updates are done at the same time. + // This field must not be set to the future time. If set, the update is + // prevented if a newer version of the item already exists in our system (that + // is the last update time of the existing CSS products is later than the + // freshness time set in the update). If the update happens, the last update + // time is then set to this freshness time. If not set, the update will not be + // prevented and the last update time will default to when this request was + // received by the CSS API. If the operation is prevented, the aborted + // exception will be thrown. FreshnessTime string `json:"freshnessTime,omitempty"` // Name: The name of the CSS Product input. Format: // `accounts/{account}/cssProductInputs/{css_product_input}` @@ -1568,11 +1569,12 @@ func (r *AccountsCssProductInputsService) Insert(parent string, cssproductinput return c } -// FeedId sets the optional parameter "feedId": The primary or supplemental -// feed id. If CSS Product already exists and feed id provided is different, -// then the CSS Product will be moved to a new feed. Note: For now, CSSs do not -// need to provide feed ids as we create feeds on the fly. We do not have -// supplemental feed support for CSS Products yet. +// FeedId sets the optional parameter "feedId": DEPRECATED. Feed id is not +// required for CSS Products. The primary or supplemental feed id. If CSS +// Product already exists and feed id provided is different, then the CSS +// Product will be moved to a new feed. Note: For now, CSSs do not need to +// provide feed ids as we create feeds on the fly. We do not have supplemental +// feed support for CSS Products yet. func (c *AccountsCssProductInputsInsertCall) FeedId(feedId int64) *AccountsCssProductInputsInsertCall { c.urlParams_.Set("feedId", fmt.Sprint(feedId)) return c diff --git a/datamigration/v1/datamigration-api.json b/datamigration/v1/datamigration-api.json index b74174be3e8..7c8111c6c32 100644 --- a/datamigration/v1/datamigration-api.json +++ b/datamigration/v1/datamigration-api.json @@ -2332,7 +2332,7 @@ } } }, - "revision": "20241211", + "revision": "20241231", "rootUrl": "https://datamigration.googleapis.com/", "schemas": { "AlloyDbConnectionProfile": { @@ -3055,14 +3055,16 @@ "CLOUDSQL", "RDS", "AURORA", - "ALLOYDB" + "ALLOYDB", + "AZURE_DATABASE" ], "enumDescriptions": [ "Use this value for on-premise source database instances and ORACLE.", "Cloud SQL is the source instance provider.", "Amazon RDS is the source instance provider.", "Amazon Aurora is the source instance provider.", - "AlloyDB for PostgreSQL is the source instance provider." + "AlloyDB for PostgreSQL is the source instance provider.", + "Microsoft Azure Database for MySQL/PostgreSQL." ], "type": "string" }, @@ -3080,6 +3082,16 @@ ], "type": "string" }, + "satisfiesPzi": { + "description": "Output only. Zone Isolation compliance state of the resource.", + "readOnly": true, + "type": "boolean" + }, + "satisfiesPzs": { + "description": "Output only. Zone Separation compliance state of the resource.", + "readOnly": true, + "type": "boolean" + }, "sqlserver": { "$ref": "SqlServerConnectionProfile", "description": "Connection profile for a SQL Server data source." @@ -3497,14 +3509,16 @@ "CLOUDSQL", "RDS", "AURORA", - "ALLOYDB" + "ALLOYDB", + "AZURE_DATABASE" ], "enumDescriptions": [ "Use this value for on-premise source database instances and ORACLE.", "Cloud SQL is the source instance provider.", "Amazon RDS is the source instance provider.", "Amazon Aurora is the source instance provider.", - "AlloyDB for PostgreSQL is the source instance provider." + "AlloyDB for PostgreSQL is the source instance provider.", + "Microsoft Azure Database for MySQL/PostgreSQL." ], "type": "string" } @@ -4841,6 +4855,16 @@ "$ref": "ReverseSshConnectivity", "description": "The details needed to communicate to the source over Reverse SSH tunnel connectivity." }, + "satisfiesPzi": { + "description": "Output only. Zone Isolation compliance state of the resource.", + "readOnly": true, + "type": "boolean" + }, + "satisfiesPzs": { + "description": "Output only. Zone Separation compliance state of the resource.", + "readOnly": true, + "type": "boolean" + }, "source": { "description": "Required. The resource name (URI) of the source connection profile.", "type": "string" @@ -5666,6 +5690,16 @@ "description": "The name of the resource.", "type": "string" }, + "satisfiesPzi": { + "description": "Output only. Zone Isolation compliance state of the resource.", + "readOnly": true, + "type": "boolean" + }, + "satisfiesPzs": { + "description": "Output only. Zone Separation compliance state of the resource.", + "readOnly": true, + "type": "boolean" + }, "state": { "description": "Output only. The state of the private connection.", "enum": [ @@ -6114,7 +6148,7 @@ "properties": { "objectIdentifier": { "$ref": "SourceObjectIdentifier", - "description": "The object identifier." + "description": "Optional. The object identifier." } }, "type": "object" @@ -6124,7 +6158,7 @@ "id": "SourceObjectIdentifier", "properties": { "database": { - "description": "The database name. This will be required only if the object uses a database name as part of its unique identifier.", + "description": "Optional. The database name. This will be required only if the object uses a database name as part of its unique identifier.", "type": "string" }, "type": { @@ -6147,7 +6181,7 @@ "id": "SourceObjectsConfig", "properties": { "objectConfigs": { - "description": "The list of the objects to be migrated.", + "description": "Optional. The list of the objects to be migrated.", "items": { "$ref": "SourceObjectConfig" }, diff --git a/datamigration/v1/datamigration-gen.go b/datamigration/v1/datamigration-gen.go index 7b4b4cddca6..15aab881bc4 100644 --- a/datamigration/v1/datamigration-gen.go +++ b/datamigration/v1/datamigration-gen.go @@ -1080,6 +1080,7 @@ type ConnectionProfile struct { // "RDS" - Amazon RDS is the source instance provider. // "AURORA" - Amazon Aurora is the source instance provider. // "ALLOYDB" - AlloyDB for PostgreSQL is the source instance provider. + // "AZURE_DATABASE" - Microsoft Azure Database for MySQL/PostgreSQL. Provider string `json:"provider,omitempty"` // Role: Optional. The connection profile role. // @@ -1088,6 +1089,10 @@ type ConnectionProfile struct { // "SOURCE" - The role is source. // "DESTINATION" - The role is destination. Role string `json:"role,omitempty"` + // SatisfiesPzi: Output only. Zone Isolation compliance state of the resource. + SatisfiesPzi bool `json:"satisfiesPzi,omitempty"` + // SatisfiesPzs: Output only. Zone Separation compliance state of the resource. + SatisfiesPzs bool `json:"satisfiesPzs,omitempty"` // Sqlserver: Connection profile for a SQL Server data source. Sqlserver *SqlServerConnectionProfile `json:"sqlserver,omitempty"` // State: The current connection profile state (e.g. DRAFT, READY, or FAILED). @@ -1522,6 +1527,7 @@ type DatabaseType struct { // "RDS" - Amazon RDS is the source instance provider. // "AURORA" - Amazon Aurora is the source instance provider. // "ALLOYDB" - AlloyDB for PostgreSQL is the source instance provider. + // "AZURE_DATABASE" - Microsoft Azure Database for MySQL/PostgreSQL. Provider string `json:"provider,omitempty"` // ForceSendFields is a list of field names (e.g. "Engine") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -3011,6 +3017,10 @@ type MigrationJob struct { // ReverseSshConnectivity: The details needed to communicate to the source over // Reverse SSH tunnel connectivity. ReverseSshConnectivity *ReverseSshConnectivity `json:"reverseSshConnectivity,omitempty"` + // SatisfiesPzi: Output only. Zone Isolation compliance state of the resource. + SatisfiesPzi bool `json:"satisfiesPzi,omitempty"` + // SatisfiesPzs: Output only. Zone Separation compliance state of the resource. + SatisfiesPzs bool `json:"satisfiesPzs,omitempty"` // Source: Required. The resource name (URI) of the source connection profile. Source string `json:"source,omitempty"` // SourceDatabase: The database engine type and provider of the source. @@ -3909,6 +3919,10 @@ type PrivateConnection struct { Labels map[string]string `json:"labels,omitempty"` // Name: The name of the resource. Name string `json:"name,omitempty"` + // SatisfiesPzi: Output only. Zone Isolation compliance state of the resource. + SatisfiesPzi bool `json:"satisfiesPzi,omitempty"` + // SatisfiesPzs: Output only. Zone Separation compliance state of the resource. + SatisfiesPzs bool `json:"satisfiesPzs,omitempty"` // State: Output only. The state of the private connection. // // Possible values: @@ -4521,7 +4535,7 @@ func (s SourceNumericFilter) MarshalJSON() ([]byte, error) { // SourceObjectConfig: Config for a single migration job object. type SourceObjectConfig struct { - // ObjectIdentifier: The object identifier. + // ObjectIdentifier: Optional. The object identifier. ObjectIdentifier *SourceObjectIdentifier `json:"objectIdentifier,omitempty"` // ForceSendFields is a list of field names (e.g. "ObjectIdentifier") to // unconditionally include in API requests. By default, fields with empty or @@ -4543,8 +4557,8 @@ func (s SourceObjectConfig) MarshalJSON() ([]byte, error) { // SourceObjectIdentifier: An identifier for the Migration Job Object. type SourceObjectIdentifier struct { - // Database: The database name. This will be required only if the object uses a - // database name as part of its unique identifier. + // Database: Optional. The database name. This will be required only if the + // object uses a database name as part of its unique identifier. Database string `json:"database,omitempty"` // Type: Required. The type of the migration job object. // @@ -4574,7 +4588,7 @@ func (s SourceObjectIdentifier) MarshalJSON() ([]byte, error) { // SourceObjectsConfig: List of configurations for the source objects to be // migrated. type SourceObjectsConfig struct { - // ObjectConfigs: The list of the objects to be migrated. + // ObjectConfigs: Optional. The list of the objects to be migrated. ObjectConfigs []*SourceObjectConfig `json:"objectConfigs,omitempty"` // ObjectsSelectionType: Optional. The objects selection type of the migration // job. diff --git a/deploymentmanager/v2/deploymentmanager-api.json b/deploymentmanager/v2/deploymentmanager-api.json index 0a903c2c7cc..d9a296db3a8 100644 --- a/deploymentmanager/v2/deploymentmanager-api.json +++ b/deploymentmanager/v2/deploymentmanager-api.json @@ -1028,7 +1028,7 @@ } } }, - "revision": "20241122", + "revision": "20250102", "rootUrl": "https://deploymentmanager.googleapis.com/", "schemas": { "AuditConfig": { @@ -1328,11 +1328,11 @@ "description": "The logical grouping to which the \"reason\" belongs. The error domain is typically the registered service name of the tool or product that generates the error. Example: \"pubsub.googleapis.com\". If the error is generated by some common infrastructure, the error domain must be a globally unique value that identifies the infrastructure. For Google API infrastructure, the error domain is \"googleapis.com\".", "type": "string" }, - "metadata": { + "metadatas": { "additionalProperties": { "type": "string" }, - "description": "Additional structured details about this error. Keys must match /a-z+/ but should ideally be lowerCamelCase. Also they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than {\"instanceLimit\": \"100/request\"}, should be returned as, {\"instanceLimitPerRequest\": \"100\"}, if the client exceeds the number of instances that can be created in a single (batch) request.", + "description": "Additional structured details about this error. Keys must match a regular expression of `a-z+` but should ideally be lowerCamelCase. Also, they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than `{\"instanceLimit\": \"100/request\"}`, should be returned as, `{\"instanceLimitPerRequest\": \"100\"}`, if the client exceeds the number of instances that can be created in a single (batch) request.", "type": "object" }, "reason": { diff --git a/deploymentmanager/v2/deploymentmanager-gen.go b/deploymentmanager/v2/deploymentmanager-gen.go index 75f1a08eb4e..7608aea032c 100644 --- a/deploymentmanager/v2/deploymentmanager-gen.go +++ b/deploymentmanager/v2/deploymentmanager-gen.go @@ -743,14 +743,15 @@ type ErrorInfo struct { // unique value that identifies the infrastructure. For Google API // infrastructure, the error domain is "googleapis.com". Domain string `json:"domain,omitempty"` - // Metadata: Additional structured details about this error. Keys must match - // /a-z+/ but should ideally be lowerCamelCase. Also they must be limited to 64 - // characters in length. When identifying the current value of an exceeded - // limit, the units should be contained in the key, not the value. For example, - // rather than {"instanceLimit": "100/request"}, should be returned as, - // {"instanceLimitPerRequest": "100"}, if the client exceeds the number of - // instances that can be created in a single (batch) request. - Metadata map[string]string `json:"metadata,omitempty"` + // Metadatas: Additional structured details about this error. Keys must match a + // regular expression of `a-z+` but should ideally be lowerCamelCase. Also, + // they must be limited to 64 characters in length. When identifying the + // current value of an exceeded limit, the units should be contained in the + // key, not the value. For example, rather than `{"instanceLimit": + // "100/request"}`, should be returned as, `{"instanceLimitPerRequest": + // "100"}`, if the client exceeds the number of instances that can be created + // in a single (batch) request. + Metadatas map[string]string `json:"metadatas,omitempty"` // Reason: The reason of the error. This is a constant value that identifies // the proximate cause of the error. Error reasons are unique within a // particular domain of errors. This should be at most 63 characters and match diff --git a/deploymentmanager/v2beta/deploymentmanager-api.json b/deploymentmanager/v2beta/deploymentmanager-api.json index f7bbabdfd1c..2471227195d 100644 --- a/deploymentmanager/v2beta/deploymentmanager-api.json +++ b/deploymentmanager/v2beta/deploymentmanager-api.json @@ -1636,7 +1636,7 @@ } } }, - "revision": "20241122", + "revision": "20250102", "rootUrl": "https://deploymentmanager.googleapis.com/", "schemas": { "AsyncOptions": { @@ -2140,11 +2140,11 @@ "description": "The logical grouping to which the \"reason\" belongs. The error domain is typically the registered service name of the tool or product that generates the error. Example: \"pubsub.googleapis.com\". If the error is generated by some common infrastructure, the error domain must be a globally unique value that identifies the infrastructure. For Google API infrastructure, the error domain is \"googleapis.com\".", "type": "string" }, - "metadata": { + "metadatas": { "additionalProperties": { "type": "string" }, - "description": "Additional structured details about this error. Keys must match /a-z+/ but should ideally be lowerCamelCase. Also they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than {\"instanceLimit\": \"100/request\"}, should be returned as, {\"instanceLimitPerRequest\": \"100\"}, if the client exceeds the number of instances that can be created in a single (batch) request.", + "description": "Additional structured details about this error. Keys must match a regular expression of `a-z+` but should ideally be lowerCamelCase. Also, they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than `{\"instanceLimit\": \"100/request\"}`, should be returned as, `{\"instanceLimitPerRequest\": \"100\"}`, if the client exceeds the number of instances that can be created in a single (batch) request.", "type": "object" }, "reason": { diff --git a/deploymentmanager/v2beta/deploymentmanager-gen.go b/deploymentmanager/v2beta/deploymentmanager-gen.go index 5daeaf741b7..66d60c7d099 100644 --- a/deploymentmanager/v2beta/deploymentmanager-gen.go +++ b/deploymentmanager/v2beta/deploymentmanager-gen.go @@ -1034,14 +1034,15 @@ type ErrorInfo struct { // unique value that identifies the infrastructure. For Google API // infrastructure, the error domain is "googleapis.com". Domain string `json:"domain,omitempty"` - // Metadata: Additional structured details about this error. Keys must match - // /a-z+/ but should ideally be lowerCamelCase. Also they must be limited to 64 - // characters in length. When identifying the current value of an exceeded - // limit, the units should be contained in the key, not the value. For example, - // rather than {"instanceLimit": "100/request"}, should be returned as, - // {"instanceLimitPerRequest": "100"}, if the client exceeds the number of - // instances that can be created in a single (batch) request. - Metadata map[string]string `json:"metadata,omitempty"` + // Metadatas: Additional structured details about this error. Keys must match a + // regular expression of `a-z+` but should ideally be lowerCamelCase. Also, + // they must be limited to 64 characters in length. When identifying the + // current value of an exceeded limit, the units should be contained in the + // key, not the value. For example, rather than `{"instanceLimit": + // "100/request"}`, should be returned as, `{"instanceLimitPerRequest": + // "100"}`, if the client exceeds the number of instances that can be created + // in a single (batch) request. + Metadatas map[string]string `json:"metadatas,omitempty"` // Reason: The reason of the error. This is a constant value that identifies // the proximate cause of the error. Error reasons are unique within a // particular domain of errors. This should be at most 63 characters and match diff --git a/discoveryengine/v1/discoveryengine-api.json b/discoveryengine/v1/discoveryengine-api.json index 7a38e9f1ca6..fc3a9bacec2 100644 --- a/discoveryengine/v1/discoveryengine-api.json +++ b/discoveryengine/v1/discoveryengine-api.json @@ -600,7 +600,7 @@ ], "parameters": { "documentId": { - "description": "Required. The ID to use for the Document, which becomes the final component of the Document.name. If the caller does not have permission to create the Document, regardless of whether or not it exists, a `PERMISSION_DENIED` error is returned. This field must be unique among all Documents with the same parent. Otherwise, an `ALREADY_EXISTS` error is returned. This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters. Otherwise, an `INVALID_ARGUMENT` error is returned.", + "description": "Required. The ID to use for the Document, which becomes the final component of the Document.name. If the caller does not have permission to create the Document, regardless of whether or not it exists, a `PERMISSION_DENIED` error is returned. This field must be unique among all Documents with the same parent. Otherwise, an `ALREADY_EXISTS` error is returned. This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 128 characters. Otherwise, an `INVALID_ARGUMENT` error is returned.", "location": "query", "type": "string" }, @@ -4100,7 +4100,7 @@ ], "parameters": { "documentId": { - "description": "Required. The ID to use for the Document, which becomes the final component of the Document.name. If the caller does not have permission to create the Document, regardless of whether or not it exists, a `PERMISSION_DENIED` error is returned. This field must be unique among all Documents with the same parent. Otherwise, an `ALREADY_EXISTS` error is returned. This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters. Otherwise, an `INVALID_ARGUMENT` error is returned.", + "description": "Required. The ID to use for the Document, which becomes the final component of the Document.name. If the caller does not have permission to create the Document, regardless of whether or not it exists, a `PERMISSION_DENIED` error is returned. This field must be unique among all Documents with the same parent. Otherwise, an `ALREADY_EXISTS` error is returned. This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 128 characters. Otherwise, an `INVALID_ARGUMENT` error is returned.", "location": "query", "type": "string" }, @@ -6371,7 +6371,7 @@ } } }, - "revision": "20241216", + "revision": "20250107", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiDistribution": { @@ -6749,7 +6749,16 @@ "GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig": { "description": "Configuration data for advance site search.", "id": "GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig", - "properties": {}, + "properties": { + "disableAutomaticRefresh": { + "description": "If set true, automatic refresh is disabled for the DataStore.", + "type": "boolean" + }, + "disableInitialIndex": { + "description": "If set true, initial indexing is disabled for the DataStore.", + "type": "boolean" + } + }, "type": "object" }, "GoogleCloudDiscoveryengineV1AlloyDbSource": { @@ -6875,6 +6884,13 @@ }, "type": "array" }, + "safetyRatings": { + "description": "Optional. Safety ratings.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1SafetyRating" + }, + "type": "array" + }, "state": { "description": "The state of the answer generation.", "enum": [ @@ -7214,6 +7230,60 @@ "enable": { "description": "Enable the safety filtering on the answer response. It is false by default.", "type": "boolean" + }, + "safetySettings": { + "description": "Optional. Safety settings. This settings are effective only when the safety_spec.enable is true.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1AnswerQueryRequestSafetySpecSafetySetting" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1AnswerQueryRequestSafetySpecSafetySetting": { + "description": "Safety settings.", + "id": "GoogleCloudDiscoveryengineV1AnswerQueryRequestSafetySpecSafetySetting", + "properties": { + "category": { + "description": "Required. Harm category.", + "enum": [ + "HARM_CATEGORY_UNSPECIFIED", + "HARM_CATEGORY_HATE_SPEECH", + "HARM_CATEGORY_DANGEROUS_CONTENT", + "HARM_CATEGORY_HARASSMENT", + "HARM_CATEGORY_SEXUALLY_EXPLICIT", + "HARM_CATEGORY_CIVIC_INTEGRITY" + ], + "enumDescriptions": [ + "The harm category is unspecified.", + "The harm category is hate speech.", + "The harm category is dangerous content.", + "The harm category is harassment.", + "The harm category is sexually explicit content.", + "The harm category is civic integrity." + ], + "type": "string" + }, + "threshold": { + "description": "Required. The harm block threshold.", + "enum": [ + "HARM_BLOCK_THRESHOLD_UNSPECIFIED", + "BLOCK_LOW_AND_ABOVE", + "BLOCK_MEDIUM_AND_ABOVE", + "BLOCK_ONLY_HIGH", + "BLOCK_NONE", + "OFF" + ], + "enumDescriptions": [ + "Unspecified harm block threshold.", + "Block low threshold and above (i.e. block more).", + "Block medium threshold and above.", + "Block only high threshold (i.e. block less).", + "Block none.", + "Turn off the safety filter." + ], + "type": "string" } }, "type": "object" @@ -8644,7 +8714,8 @@ "id": "GoogleCloudDiscoveryengineV1ControlBoostAction", "properties": { "boost": { - "description": "Required. Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op).", + "deprecated": true, + "description": "Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op).", "format": "float", "type": "number" }, @@ -8655,6 +8726,11 @@ "filter": { "description": "Required. Specifies which products to apply the boost to. If no filter is provided all products will be boosted (No-op). Syntax documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown.", "type": "string" + }, + "fixedBoost": { + "description": "Optional. Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op).", + "format": "float", + "type": "number" } }, "type": "object" @@ -9238,6 +9314,23 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1DeleteIdentityMappingStoreMetadata": { + "description": "Metadata related to the progress of the IdentityMappingStoreService.DeleteIdentityMappingStore operation. This will be returned by the google.longrunning.Operation.metadata field.", + "id": "GoogleCloudDiscoveryengineV1DeleteIdentityMappingStoreMetadata", + "properties": { + "createTime": { + "description": "Operation create time.", + "format": "google-datetime", + "type": "string" + }, + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1DeleteSchemaMetadata": { "description": "Metadata for DeleteSchema LRO.", "id": "GoogleCloudDiscoveryengineV1DeleteSchemaMetadata", @@ -9319,7 +9412,7 @@ "type": "object" }, "id": { - "description": "Immutable. The identifier of the document. Id should conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters.", + "description": "Immutable. The identifier of the document. Id should conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 128 characters.", "type": "string" }, "indexStatus": { @@ -11449,7 +11542,7 @@ "id": "GoogleCloudDiscoveryengineV1RecrawlUrisRequest", "properties": { "siteCredential": { - "description": "Optional. Full resource name of the SiteCredential, such as `projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine/siteCredentials/*`. Only set to crawl private URIs.", + "description": "Optional. Full resource name of the `SiteCredential`, such as `projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine/siteCredentials/*`. Only set to crawl private URIs.", "type": "string" }, "uris": { @@ -11473,6 +11566,89 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1SafetyRating": { + "description": "Safety rating corresponding to the generated content.", + "id": "GoogleCloudDiscoveryengineV1SafetyRating", + "properties": { + "blocked": { + "description": "Output only. Indicates whether the content was filtered out because of this rating.", + "readOnly": true, + "type": "boolean" + }, + "category": { + "description": "Output only. Harm category.", + "enum": [ + "HARM_CATEGORY_UNSPECIFIED", + "HARM_CATEGORY_HATE_SPEECH", + "HARM_CATEGORY_DANGEROUS_CONTENT", + "HARM_CATEGORY_HARASSMENT", + "HARM_CATEGORY_SEXUALLY_EXPLICIT", + "HARM_CATEGORY_CIVIC_INTEGRITY" + ], + "enumDescriptions": [ + "The harm category is unspecified.", + "The harm category is hate speech.", + "The harm category is dangerous content.", + "The harm category is harassment.", + "The harm category is sexually explicit content.", + "The harm category is civic integrity." + ], + "readOnly": true, + "type": "string" + }, + "probability": { + "description": "Output only. Harm probability levels in the content.", + "enum": [ + "HARM_PROBABILITY_UNSPECIFIED", + "NEGLIGIBLE", + "LOW", + "MEDIUM", + "HIGH" + ], + "enumDescriptions": [ + "Harm probability unspecified.", + "Negligible level of harm.", + "Low level of harm.", + "Medium level of harm.", + "High level of harm." + ], + "readOnly": true, + "type": "string" + }, + "probabilityScore": { + "description": "Output only. Harm probability score.", + "format": "float", + "readOnly": true, + "type": "number" + }, + "severity": { + "description": "Output only. Harm severity levels in the content.", + "enum": [ + "HARM_SEVERITY_UNSPECIFIED", + "HARM_SEVERITY_NEGLIGIBLE", + "HARM_SEVERITY_LOW", + "HARM_SEVERITY_MEDIUM", + "HARM_SEVERITY_HIGH" + ], + "enumDescriptions": [ + "Harm severity unspecified.", + "Negligible level of harm severity.", + "Low level of harm severity.", + "Medium level of harm severity.", + "High level of harm severity." + ], + "readOnly": true, + "type": "string" + }, + "severityScore": { + "description": "Output only. Harm severity score.", + "format": "float", + "readOnly": true, + "type": "number" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1Schema": { "description": "Defines the structure and layout of a type of document data.", "id": "GoogleCloudDiscoveryengineV1Schema", @@ -12538,7 +12714,7 @@ "type": "array" }, "rankingExpression": { - "description": "The ranking expression controls the customized ranking on retrieval documents. To leverage this, document embedding is required. The ranking expression setting in ServingConfig applies to all search requests served by the serving config. However, if SearchRequest.ranking_expression is specified, it overrides the ServingConfig ranking expression. The ranking expression is a single function or multiple functions that are joined by \"+\". * ranking_expression = function, { \" + \", function }; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between embedding_field_path and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`.", + "description": "The ranking expression controls the customized ranking on retrieval documents. To leverage this, document embedding is required. The ranking expression setting in ServingConfig applies to all search requests served by the serving config. However, if `SearchRequest.ranking_expression` is specified, it overrides the ServingConfig ranking expression. The ranking expression is a single function or multiple functions that are joined by \"+\". * ranking_expression = function, { \" + \", function }; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between embedding_field_path and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`.", "type": "string" }, "redirectControlIds": { @@ -12812,7 +12988,7 @@ "id": "GoogleCloudDiscoveryengineV1TargetSite", "properties": { "exactMatch": { - "description": "Input only. If set to false, a uri_pattern is generated to include all pages whose address contains the provided_uri_pattern. If set to true, an uri_pattern is generated to try to be an exact match of the provided_uri_pattern or just the specific page if the provided_uri_pattern is a specific one. provided_uri_pattern is always normalized to generate the URI pattern to be used by the search engine.", + "description": "Immutable. If set to false, a uri_pattern is generated to include all pages whose address contains the provided_uri_pattern. If set to true, an uri_pattern is generated to try to be an exact match of the provided_uri_pattern or just the specific page if the provided_uri_pattern is a specific one. provided_uri_pattern is always normalized to generate the URI pattern to be used by the search engine.", "type": "boolean" }, "failureReason": { @@ -13418,6 +13594,13 @@ }, "type": "array" }, + "safetyRatings": { + "description": "Optional. Safety ratings.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1alphaSafetyRating" + }, + "type": "array" + }, "state": { "description": "The state of the answer generation.", "enum": [ @@ -13960,7 +14143,7 @@ }, "dataConnector": { "$ref": "GoogleCloudDiscoveryengineV1alphaDataConnector", - "description": "Output only. The data connector, if present, manages the connection for data stores in the Collection. To set up the connector, use DataConnectorService.SetUpDataConnector method, which creates a new Collection while setting up the DataConnector singleton resource. Setting up connector on an existing Collection is not supported. This output only field contains a subset of the DataConnector fields, including `name`, `data_source`, `entities.entity_name` and `entities.data_store`. To get more details about a data connector, use the DataConnector.GetDataConnector method.", + "description": "Output only. The data connector, if present, manages the connection for data stores in the Collection. To set up the connector, use DataConnectorService.SetUpDataConnector method, which creates a new Collection while setting up the DataConnector singleton resource. Setting up connector on an existing Collection is not supported. This output only field contains a subset of the DataConnector fields, including `name`, `data_source`, `entities.entity_name` and `entities.data_store`. To get more details about a data connector, use the DataConnectorService.GetDataConnector method.", "readOnly": true }, "displayName": { @@ -14301,7 +14484,8 @@ "id": "GoogleCloudDiscoveryengineV1alphaControlBoostAction", "properties": { "boost": { - "description": "Required. Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op).", + "deprecated": true, + "description": "Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op).", "format": "float", "type": "number" }, @@ -14312,6 +14496,11 @@ "filter": { "description": "Required. Specifies which products to apply the boost to. If no filter is provided all products will be boosted (No-op). Syntax documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown.", "type": "string" + }, + "fixedBoost": { + "description": "Optional. Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op).", + "format": "float", + "type": "number" } }, "type": "object" @@ -14485,7 +14674,7 @@ "type": "object" }, "GoogleCloudDiscoveryengineV1alphaDataConnector": { - "description": "Manages the connection to external data sources for all data stores grouped under a Collection. It's a singleton resource of Collection. The initialization is only supported through SetUpDataConnector method, which will create a new Collection and initialize its DataConnector. //", + "description": "Manages the connection to external data sources for all data stores grouped under a Collection. It's a singleton resource of Collection. The initialization is only supported through DataConnectorService.SetUpDataConnector method, which will create a new Collection and initialize its DataConnector.", "id": "GoogleCloudDiscoveryengineV1alphaDataConnector", "properties": { "actionConfig": { @@ -14932,6 +15121,23 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaDeleteIdentityMappingStoreMetadata": { + "description": "Metadata related to the progress of the IdentityMappingStoreService.DeleteIdentityMappingStore operation. This will be returned by the google.longrunning.Operation.metadata field.", + "id": "GoogleCloudDiscoveryengineV1alphaDeleteIdentityMappingStoreMetadata", + "properties": { + "createTime": { + "description": "Operation create time.", + "format": "google-datetime", + "type": "string" + }, + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaDeleteSchemaMetadata": { "description": "Metadata for DeleteSchema LRO.", "id": "GoogleCloudDiscoveryengineV1alphaDeleteSchemaMetadata", @@ -15826,6 +16032,10 @@ "description": "The configuration for the identity data synchronization runs.", "id": "GoogleCloudDiscoveryengineV1alphaIdentityScheduleConfig", "properties": { + "nextSyncTime": { + "$ref": "GoogleTypeDateTime", + "description": "Optional. The UTC time when the next data sync is expected to start for the Data Connector. Customers are only able to specify the hour and minute to schedule the data sync. This is utilized when the data connector has a refresh interval greater than 1 day." + }, "refreshInterval": { "description": "Optional. The refresh interval to sync the Access Control List information for the documents ingested by this connector. If not set, the access control list will be refreshed at the default interval of 30 minutes. The identity refresh interval can be at least 30 minutes and at most 7 days.", "format": "google-duration", @@ -16725,6 +16935,132 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateMetadata": { + "description": "Metadata related to the progress of the CrawlRateManagementService.RemoveDedicatedCrawlRate operation. This will be returned by the google.longrunning.Operation.metadata field.", + "id": "GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateMetadata", + "properties": { + "createTime": { + "description": "Operation create time.", + "format": "google-datetime", + "type": "string" + }, + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateResponse": { + "description": "Response message for CrawlRateManagementService.RemoveDedicatedCrawlRate method. It simply returns the state of the response, and an error message if the state is FAILED.", + "id": "GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateResponse", + "properties": { + "error": { + "$ref": "GoogleRpcStatus", + "description": "Errors from service when handling the request." + }, + "state": { + "description": "Output only. The state of the response.", + "enum": [ + "STATE_UNSPECIFIED", + "SUCCEEDED", + "FAILED" + ], + "enumDescriptions": [ + "The state is unspecified.", + "The state is successful.", + "The state is failed." + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaSafetyRating": { + "description": "Safety rating corresponding to the generated content.", + "id": "GoogleCloudDiscoveryengineV1alphaSafetyRating", + "properties": { + "blocked": { + "description": "Output only. Indicates whether the content was filtered out because of this rating.", + "readOnly": true, + "type": "boolean" + }, + "category": { + "description": "Output only. Harm category.", + "enum": [ + "HARM_CATEGORY_UNSPECIFIED", + "HARM_CATEGORY_HATE_SPEECH", + "HARM_CATEGORY_DANGEROUS_CONTENT", + "HARM_CATEGORY_HARASSMENT", + "HARM_CATEGORY_SEXUALLY_EXPLICIT", + "HARM_CATEGORY_CIVIC_INTEGRITY" + ], + "enumDescriptions": [ + "The harm category is unspecified.", + "The harm category is hate speech.", + "The harm category is dangerous content.", + "The harm category is harassment.", + "The harm category is sexually explicit content.", + "The harm category is civic integrity." + ], + "readOnly": true, + "type": "string" + }, + "probability": { + "description": "Output only. Harm probability levels in the content.", + "enum": [ + "HARM_PROBABILITY_UNSPECIFIED", + "NEGLIGIBLE", + "LOW", + "MEDIUM", + "HIGH" + ], + "enumDescriptions": [ + "Harm probability unspecified.", + "Negligible level of harm.", + "Low level of harm.", + "Medium level of harm.", + "High level of harm." + ], + "readOnly": true, + "type": "string" + }, + "probabilityScore": { + "description": "Output only. Harm probability score.", + "format": "float", + "readOnly": true, + "type": "number" + }, + "severity": { + "description": "Output only. Harm severity levels in the content.", + "enum": [ + "HARM_SEVERITY_UNSPECIFIED", + "HARM_SEVERITY_NEGLIGIBLE", + "HARM_SEVERITY_LOW", + "HARM_SEVERITY_MEDIUM", + "HARM_SEVERITY_HIGH" + ], + "enumDescriptions": [ + "Harm severity unspecified.", + "Negligible level of harm severity.", + "Low level of harm severity.", + "Medium level of harm severity.", + "High level of harm severity." + ], + "readOnly": true, + "type": "string" + }, + "severityScore": { + "description": "Output only. Harm severity score.", + "format": "float", + "readOnly": true, + "type": "number" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaSchema": { "description": "Defines the structure and layout of a type of document data.", "id": "GoogleCloudDiscoveryengineV1alphaSchema", @@ -17364,14 +17700,14 @@ "id": "GoogleCloudDiscoveryengineV1alphaSearchRequestNaturalLanguageQueryUnderstandingSpec", "properties": { "filterExtractionCondition": { - "description": "The condition under which filter extraction should occur. Default to Condition.DISABLED.", + "description": "The condition under which filter extraction should occur. Server behavior defaults to `DISABLED`.", "enum": [ "CONDITION_UNSPECIFIED", "DISABLED", "ENABLED" ], "enumDescriptions": [ - "Server behavior defaults to Condition.DISABLED.", + "Server behavior defaults to `DISABLED`.", "Disables NL filter extraction.", "Enables NL filter extraction." ], @@ -17565,6 +17901,49 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateMetadata": { + "description": "Metadata related to the progress of the CrawlRateManagementService.SetDedicatedCrawlRate operation. This will be returned by the google.longrunning.Operation.metadata field.", + "id": "GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateMetadata", + "properties": { + "createTime": { + "description": "Operation create time.", + "format": "google-datetime", + "type": "string" + }, + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateResponse": { + "description": "Response message for CrawlRateManagementService.SetDedicatedCrawlRate method. It simply returns the state of the response, and an error message if the state is FAILED.", + "id": "GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateResponse", + "properties": { + "error": { + "$ref": "GoogleRpcStatus", + "description": "Errors from service when handling the request." + }, + "state": { + "description": "Output only. The state of the response.", + "enum": [ + "STATE_UNSPECIFIED", + "SUCCEEDED", + "FAILED" + ], + "enumDescriptions": [ + "The state is unspecified.", + "The state is successful.", + "The state is failed." + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaSetUpDataConnectorMetadata": { "description": "Metadata for DataConnectorService.SetUpDataConnector method.", "id": "GoogleCloudDiscoveryengineV1alphaSetUpDataConnectorMetadata", @@ -17660,7 +18039,7 @@ "id": "GoogleCloudDiscoveryengineV1alphaTargetSite", "properties": { "exactMatch": { - "description": "Input only. If set to false, a uri_pattern is generated to include all pages whose address contains the provided_uri_pattern. If set to true, an uri_pattern is generated to try to be an exact match of the provided_uri_pattern or just the specific page if the provided_uri_pattern is a specific one. provided_uri_pattern is always normalized to generate the URI pattern to be used by the search engine.", + "description": "Immutable. If set to false, a uri_pattern is generated to include all pages whose address contains the provided_uri_pattern. If set to true, an uri_pattern is generated to try to be an exact match of the provided_uri_pattern or just the specific page if the provided_uri_pattern is a specific one. provided_uri_pattern is always normalized to generate the URI pattern to be used by the search engine.", "type": "boolean" }, "failureReason": { @@ -17970,7 +18349,16 @@ "GoogleCloudDiscoveryengineV1betaAdvancedSiteSearchConfig": { "description": "Configuration data for advance site search.", "id": "GoogleCloudDiscoveryengineV1betaAdvancedSiteSearchConfig", - "properties": {}, + "properties": { + "disableAutomaticRefresh": { + "description": "If set true, automatic refresh is disabled for the DataStore.", + "type": "boolean" + }, + "disableInitialIndex": { + "description": "If set true, initial indexing is disabled for the DataStore.", + "type": "boolean" + } + }, "type": "object" }, "GoogleCloudDiscoveryengineV1betaBatchCreateTargetSiteMetadata": { @@ -18211,7 +18599,8 @@ "id": "GoogleCloudDiscoveryengineV1betaControlBoostAction", "properties": { "boost": { - "description": "Required. Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op).", + "deprecated": true, + "description": "Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op).", "format": "float", "type": "number" }, @@ -18222,6 +18611,11 @@ "filter": { "description": "Required. Specifies which products to apply the boost to. If no filter is provided all products will be boosted (No-op). Syntax documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown.", "type": "string" + }, + "fixedBoost": { + "description": "Optional. Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op).", + "format": "float", + "type": "number" } }, "type": "object" @@ -18581,6 +18975,23 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaDeleteIdentityMappingStoreMetadata": { + "description": "Metadata related to the progress of the IdentityMappingStoreService.DeleteIdentityMappingStore operation. This will be returned by the google.longrunning.Operation.metadata field.", + "id": "GoogleCloudDiscoveryengineV1betaDeleteIdentityMappingStoreMetadata", + "properties": { + "createTime": { + "description": "Operation create time.", + "format": "google-datetime", + "type": "string" + }, + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaDeleteSchemaMetadata": { "description": "Metadata for DeleteSchema LRO.", "id": "GoogleCloudDiscoveryengineV1betaDeleteSchemaMetadata", @@ -20254,14 +20665,14 @@ "id": "GoogleCloudDiscoveryengineV1betaSearchRequestNaturalLanguageQueryUnderstandingSpec", "properties": { "filterExtractionCondition": { - "description": "The condition under which filter extraction should occur. Default to Condition.DISABLED.", + "description": "The condition under which filter extraction should occur. Server behavior defaults to `DISABLED`.", "enum": [ "CONDITION_UNSPECIFIED", "DISABLED", "ENABLED" ], "enumDescriptions": [ - "Server behavior defaults to Condition.DISABLED.", + "Server behavior defaults to `DISABLED`.", "Disables NL filter extraction.", "Enables NL filter extraction." ], @@ -20447,7 +20858,7 @@ "id": "GoogleCloudDiscoveryengineV1betaTargetSite", "properties": { "exactMatch": { - "description": "Input only. If set to false, a uri_pattern is generated to include all pages whose address contains the provided_uri_pattern. If set to true, an uri_pattern is generated to try to be an exact match of the provided_uri_pattern or just the specific page if the provided_uri_pattern is a specific one. provided_uri_pattern is always normalized to generate the URI pattern to be used by the search engine.", + "description": "Immutable. If set to false, a uri_pattern is generated to include all pages whose address contains the provided_uri_pattern. If set to true, an uri_pattern is generated to try to be an exact match of the provided_uri_pattern or just the specific page if the provided_uri_pattern is a specific one. provided_uri_pattern is always normalized to generate the URI pattern to be used by the search engine.", "type": "boolean" }, "failureReason": { diff --git a/discoveryengine/v1/discoveryengine-gen.go b/discoveryengine/v1/discoveryengine-gen.go index cfcb8ea898f..7d6a51df748 100644 --- a/discoveryengine/v1/discoveryengine-gen.go +++ b/discoveryengine/v1/discoveryengine-gen.go @@ -1555,6 +1555,28 @@ func (s GoogleCloudDiscoveryengineLoggingSourceLocation) MarshalJSON() ([]byte, // GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig: Configuration data for // advance site search. type GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig struct { + // DisableAutomaticRefresh: If set true, automatic refresh is disabled for the + // DataStore. + DisableAutomaticRefresh bool `json:"disableAutomaticRefresh,omitempty"` + // DisableInitialIndex: If set true, initial indexing is disabled for the + // DataStore. + DisableInitialIndex bool `json:"disableInitialIndex,omitempty"` + // ForceSendFields is a list of field names (e.g. "DisableAutomaticRefresh") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "DisableAutomaticRefresh") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } // GoogleCloudDiscoveryengineV1AlloyDbSource: AlloyDB source import data from. @@ -1652,6 +1674,8 @@ type GoogleCloudDiscoveryengineV1Answer struct { References []*GoogleCloudDiscoveryengineV1AnswerReference `json:"references,omitempty"` // RelatedQuestions: Suggested related questions. RelatedQuestions []string `json:"relatedQuestions,omitempty"` + // SafetyRatings: Optional. Safety ratings. + SafetyRatings []*GoogleCloudDiscoveryengineV1SafetyRating `json:"safetyRatings,omitempty"` // State: The state of the answer generation. // // Possible values: @@ -2157,6 +2181,9 @@ type GoogleCloudDiscoveryengineV1AnswerQueryRequestSafetySpec struct { // Enable: Enable the safety filtering on the answer response. It is false by // default. Enable bool `json:"enable,omitempty"` + // SafetySettings: Optional. Safety settings. This settings are effective only + // when the safety_spec.enable is true. + SafetySettings []*GoogleCloudDiscoveryengineV1AnswerQueryRequestSafetySpecSafetySetting `json:"safetySettings,omitempty"` // ForceSendFields is a list of field names (e.g. "Enable") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See @@ -2175,6 +2202,49 @@ func (s GoogleCloudDiscoveryengineV1AnswerQueryRequestSafetySpec) MarshalJSON() return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1AnswerQueryRequestSafetySpecSafetySetting: +// Safety settings. +type GoogleCloudDiscoveryengineV1AnswerQueryRequestSafetySpecSafetySetting struct { + // Category: Required. Harm category. + // + // Possible values: + // "HARM_CATEGORY_UNSPECIFIED" - The harm category is unspecified. + // "HARM_CATEGORY_HATE_SPEECH" - The harm category is hate speech. + // "HARM_CATEGORY_DANGEROUS_CONTENT" - The harm category is dangerous + // content. + // "HARM_CATEGORY_HARASSMENT" - The harm category is harassment. + // "HARM_CATEGORY_SEXUALLY_EXPLICIT" - The harm category is sexually explicit + // content. + // "HARM_CATEGORY_CIVIC_INTEGRITY" - The harm category is civic integrity. + Category string `json:"category,omitempty"` + // Threshold: Required. The harm block threshold. + // + // Possible values: + // "HARM_BLOCK_THRESHOLD_UNSPECIFIED" - Unspecified harm block threshold. + // "BLOCK_LOW_AND_ABOVE" - Block low threshold and above (i.e. block more). + // "BLOCK_MEDIUM_AND_ABOVE" - Block medium threshold and above. + // "BLOCK_ONLY_HIGH" - Block only high threshold (i.e. block less). + // "BLOCK_NONE" - Block none. + // "OFF" - Turn off the safety filter. + Threshold string `json:"threshold,omitempty"` + // ForceSendFields is a list of field names (e.g. "Category") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Category") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1AnswerQueryRequestSafetySpecSafetySetting) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1AnswerQueryRequestSafetySpecSafetySetting + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpec: Search // specification. type GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpec struct { @@ -4114,8 +4184,8 @@ func (s GoogleCloudDiscoveryengineV1Control) MarshalJSON() ([]byte, error) { // GoogleCloudDiscoveryengineV1ControlBoostAction: Adjusts order of products in // returned list. type GoogleCloudDiscoveryengineV1ControlBoostAction struct { - // Boost: Required. Strength of the boost, which should be in [-1, 1]. Negative - // boost means demotion. Default is 0.0 (No-op). + // Boost: Strength of the boost, which should be in [-1, 1]. Negative boost + // means demotion. Default is 0.0 (No-op). Boost float64 `json:"boost,omitempty"` // DataStore: Required. Specifies which data store's documents can be boosted // by this control. Full data store name e.g. @@ -4127,6 +4197,9 @@ type GoogleCloudDiscoveryengineV1ControlBoostAction struct { // documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum // length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown. Filter string `json:"filter,omitempty"` + // FixedBoost: Optional. Strength of the boost, which should be in [-1, 1]. + // Negative boost means demotion. Default is 0.0 (No-op). + FixedBoost float64 `json:"fixedBoost,omitempty"` // ForceSendFields is a list of field names (e.g. "Boost") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See @@ -4148,7 +4221,8 @@ func (s GoogleCloudDiscoveryengineV1ControlBoostAction) MarshalJSON() ([]byte, e func (s *GoogleCloudDiscoveryengineV1ControlBoostAction) UnmarshalJSON(data []byte) error { type NoMethod GoogleCloudDiscoveryengineV1ControlBoostAction var s1 struct { - Boost gensupport.JSONFloat64 `json:"boost"` + Boost gensupport.JSONFloat64 `json:"boost"` + FixedBoost gensupport.JSONFloat64 `json:"fixedBoost"` *NoMethod } s1.NoMethod = (*NoMethod)(s) @@ -4156,6 +4230,7 @@ func (s *GoogleCloudDiscoveryengineV1ControlBoostAction) UnmarshalJSON(data []by return err } s.Boost = float64(s1.Boost) + s.FixedBoost = float64(s1.FixedBoost) return nil } @@ -4919,6 +4994,34 @@ func (s GoogleCloudDiscoveryengineV1DeleteEngineMetadata) MarshalJSON() ([]byte, return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1DeleteIdentityMappingStoreMetadata: Metadata +// related to the progress of the +// IdentityMappingStoreService.DeleteIdentityMappingStore operation. This will +// be returned by the google.longrunning.Operation.metadata field. +type GoogleCloudDiscoveryengineV1DeleteIdentityMappingStoreMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + // UpdateTime: Operation last update time. If the operation is done, this is + // also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "CreateTime") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CreateTime") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1DeleteIdentityMappingStoreMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DeleteIdentityMappingStoreMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1DeleteSchemaMetadata: Metadata for DeleteSchema // LRO. type GoogleCloudDiscoveryengineV1DeleteSchemaMetadata struct { @@ -5020,7 +5123,7 @@ type GoogleCloudDiscoveryengineV1Document struct { // derived data that are not in the original input document. DerivedStructData googleapi.RawMessage `json:"derivedStructData,omitempty"` // Id: Immutable. The identifier of the document. Id should conform to RFC-1034 - // (https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 + // (https://tools.ietf.org/html/rfc1034) standard with a length limit of 128 // characters. Id string `json:"id,omitempty"` // IndexStatus: Output only. The index status of the document. * If document is @@ -8198,7 +8301,8 @@ func (s GoogleCloudDiscoveryengineV1RecommendResponseRecommendationResult) Marsh // GoogleCloudDiscoveryengineV1RecrawlUrisRequest: Request message for // SiteSearchEngineService.RecrawlUris method. type GoogleCloudDiscoveryengineV1RecrawlUrisRequest struct { - // SiteCredential: Optional. Full resource name of the SiteCredential, such as + // SiteCredential: Optional. Full resource name of the `SiteCredential`, such + // as // `projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine/siteCrede // ntials/*`. Only set to crawl private URIs. SiteCredential string `json:"siteCredential,omitempty"` @@ -8246,6 +8350,80 @@ func (s GoogleCloudDiscoveryengineV1Reply) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1SafetyRating: Safety rating corresponding to the +// generated content. +type GoogleCloudDiscoveryengineV1SafetyRating struct { + // Blocked: Output only. Indicates whether the content was filtered out because + // of this rating. + Blocked bool `json:"blocked,omitempty"` + // Category: Output only. Harm category. + // + // Possible values: + // "HARM_CATEGORY_UNSPECIFIED" - The harm category is unspecified. + // "HARM_CATEGORY_HATE_SPEECH" - The harm category is hate speech. + // "HARM_CATEGORY_DANGEROUS_CONTENT" - The harm category is dangerous + // content. + // "HARM_CATEGORY_HARASSMENT" - The harm category is harassment. + // "HARM_CATEGORY_SEXUALLY_EXPLICIT" - The harm category is sexually explicit + // content. + // "HARM_CATEGORY_CIVIC_INTEGRITY" - The harm category is civic integrity. + Category string `json:"category,omitempty"` + // Probability: Output only. Harm probability levels in the content. + // + // Possible values: + // "HARM_PROBABILITY_UNSPECIFIED" - Harm probability unspecified. + // "NEGLIGIBLE" - Negligible level of harm. + // "LOW" - Low level of harm. + // "MEDIUM" - Medium level of harm. + // "HIGH" - High level of harm. + Probability string `json:"probability,omitempty"` + // ProbabilityScore: Output only. Harm probability score. + ProbabilityScore float64 `json:"probabilityScore,omitempty"` + // Severity: Output only. Harm severity levels in the content. + // + // Possible values: + // "HARM_SEVERITY_UNSPECIFIED" - Harm severity unspecified. + // "HARM_SEVERITY_NEGLIGIBLE" - Negligible level of harm severity. + // "HARM_SEVERITY_LOW" - Low level of harm severity. + // "HARM_SEVERITY_MEDIUM" - Medium level of harm severity. + // "HARM_SEVERITY_HIGH" - High level of harm severity. + Severity string `json:"severity,omitempty"` + // SeverityScore: Output only. Harm severity score. + SeverityScore float64 `json:"severityScore,omitempty"` + // ForceSendFields is a list of field names (e.g. "Blocked") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Blocked") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1SafetyRating) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1SafetyRating + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleCloudDiscoveryengineV1SafetyRating) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudDiscoveryengineV1SafetyRating + var s1 struct { + ProbabilityScore gensupport.JSONFloat64 `json:"probabilityScore"` + SeverityScore gensupport.JSONFloat64 `json:"severityScore"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.ProbabilityScore = float64(s1.ProbabilityScore) + s.SeverityScore = float64(s1.SeverityScore) + return nil +} + // GoogleCloudDiscoveryengineV1Schema: Defines the structure and layout of a // type of document data. type GoogleCloudDiscoveryengineV1Schema struct { @@ -9863,7 +10041,7 @@ type GoogleCloudDiscoveryengineV1ServingConfig struct { // RankingExpression: The ranking expression controls the customized ranking on // retrieval documents. To leverage this, document embedding is required. The // ranking expression setting in ServingConfig applies to all search requests - // served by the serving config. However, if SearchRequest.ranking_expression + // served by the serving config. However, if `SearchRequest.ranking_expression` // is specified, it overrides the ServingConfig ranking expression. The ranking // expression is a single function or multiple functions that are joined by // "+". * ranking_expression = function, { " + ", function }; Supported @@ -10258,7 +10436,7 @@ func (s GoogleCloudDiscoveryengineV1SuggestionDenyListEntry) MarshalJSON() ([]by // GoogleCloudDiscoveryengineV1TargetSite: A target site for the // SiteSearchEngine. type GoogleCloudDiscoveryengineV1TargetSite struct { - // ExactMatch: Input only. If set to false, a uri_pattern is generated to + // ExactMatch: Immutable. If set to false, a uri_pattern is generated to // include all pages whose address contains the provided_uri_pattern. If set to // true, an uri_pattern is generated to try to be an exact match of the // provided_uri_pattern or just the specific page if the provided_uri_pattern @@ -11067,6 +11245,8 @@ type GoogleCloudDiscoveryengineV1alphaAnswer struct { References []*GoogleCloudDiscoveryengineV1alphaAnswerReference `json:"references,omitempty"` // RelatedQuestions: Suggested related questions. RelatedQuestions []string `json:"relatedQuestions,omitempty"` + // SafetyRatings: Optional. Safety ratings. + SafetyRatings []*GoogleCloudDiscoveryengineV1alphaSafetyRating `json:"safetyRatings,omitempty"` // State: The state of the answer generation. // // Possible values: @@ -11797,8 +11977,8 @@ type GoogleCloudDiscoveryengineV1alphaCollection struct { // connector on an existing Collection is not supported. This output only field // contains a subset of the DataConnector fields, including `name`, // `data_source`, `entities.entity_name` and `entities.data_store`. To get more - // details about a data connector, use the DataConnector.GetDataConnector - // method. + // details about a data connector, use the + // DataConnectorService.GetDataConnector method. DataConnector *GoogleCloudDiscoveryengineV1alphaDataConnector `json:"dataConnector,omitempty"` // DisplayName: Required. The Collection display name. This field must be a // UTF-8 encoded string with a length limit of 128 characters. Otherwise, an @@ -12116,8 +12296,8 @@ func (s GoogleCloudDiscoveryengineV1alphaControl) MarshalJSON() ([]byte, error) // GoogleCloudDiscoveryengineV1alphaControlBoostAction: Adjusts order of // products in returned list. type GoogleCloudDiscoveryengineV1alphaControlBoostAction struct { - // Boost: Required. Strength of the boost, which should be in [-1, 1]. Negative - // boost means demotion. Default is 0.0 (No-op). + // Boost: Strength of the boost, which should be in [-1, 1]. Negative boost + // means demotion. Default is 0.0 (No-op). Boost float64 `json:"boost,omitempty"` // DataStore: Required. Specifies which data store's documents can be boosted // by this control. Full data store name e.g. @@ -12129,6 +12309,9 @@ type GoogleCloudDiscoveryengineV1alphaControlBoostAction struct { // documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum // length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown. Filter string `json:"filter,omitempty"` + // FixedBoost: Optional. Strength of the boost, which should be in [-1, 1]. + // Negative boost means demotion. Default is 0.0 (No-op). + FixedBoost float64 `json:"fixedBoost,omitempty"` // ForceSendFields is a list of field names (e.g. "Boost") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See @@ -12150,7 +12333,8 @@ func (s GoogleCloudDiscoveryengineV1alphaControlBoostAction) MarshalJSON() ([]by func (s *GoogleCloudDiscoveryengineV1alphaControlBoostAction) UnmarshalJSON(data []byte) error { type NoMethod GoogleCloudDiscoveryengineV1alphaControlBoostAction var s1 struct { - Boost gensupport.JSONFloat64 `json:"boost"` + Boost gensupport.JSONFloat64 `json:"boost"` + FixedBoost gensupport.JSONFloat64 `json:"fixedBoost"` *NoMethod } s1.NoMethod = (*NoMethod)(s) @@ -12158,6 +12342,7 @@ func (s *GoogleCloudDiscoveryengineV1alphaControlBoostAction) UnmarshalJSON(data return err } s.Boost = float64(s1.Boost) + s.FixedBoost = float64(s1.FixedBoost) return nil } @@ -12458,8 +12643,8 @@ func (s GoogleCloudDiscoveryengineV1alphaCustomFineTuningSpec) MarshalJSON() ([] // GoogleCloudDiscoveryengineV1alphaDataConnector: Manages the connection to // external data sources for all data stores grouped under a Collection. It's a // singleton resource of Collection. The initialization is only supported -// through SetUpDataConnector method, which will create a new Collection and -// initialize its DataConnector. // +// through DataConnectorService.SetUpDataConnector method, which will create a +// new Collection and initialize its DataConnector. type GoogleCloudDiscoveryengineV1alphaDataConnector struct { // ActionConfig: Optional. Action configurations to make the connector support // actions. @@ -12935,6 +13120,34 @@ func (s GoogleCloudDiscoveryengineV1alphaDeleteEngineMetadata) MarshalJSON() ([] return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaDeleteIdentityMappingStoreMetadata: +// Metadata related to the progress of the +// IdentityMappingStoreService.DeleteIdentityMappingStore operation. This will +// be returned by the google.longrunning.Operation.metadata field. +type GoogleCloudDiscoveryengineV1alphaDeleteIdentityMappingStoreMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + // UpdateTime: Operation last update time. If the operation is done, this is + // also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "CreateTime") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CreateTime") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaDeleteIdentityMappingStoreMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaDeleteIdentityMappingStoreMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaDeleteSchemaMetadata: Metadata for // DeleteSchema LRO. type GoogleCloudDiscoveryengineV1alphaDeleteSchemaMetadata struct { @@ -14162,21 +14375,26 @@ func (s GoogleCloudDiscoveryengineV1alphaGetUriPatternDocumentDataResponse) Mars // GoogleCloudDiscoveryengineV1alphaIdentityScheduleConfig: The configuration // for the identity data synchronization runs. type GoogleCloudDiscoveryengineV1alphaIdentityScheduleConfig struct { + // NextSyncTime: Optional. The UTC time when the next data sync is expected to + // start for the Data Connector. Customers are only able to specify the hour + // and minute to schedule the data sync. This is utilized when the data + // connector has a refresh interval greater than 1 day. + NextSyncTime *GoogleTypeDateTime `json:"nextSyncTime,omitempty"` // RefreshInterval: Optional. The refresh interval to sync the Access Control // List information for the documents ingested by this connector. If not set, // the access control list will be refreshed at the default interval of 30 // minutes. The identity refresh interval can be at least 30 minutes and at // most 7 days. RefreshInterval string `json:"refreshInterval,omitempty"` - // ForceSendFields is a list of field names (e.g. "RefreshInterval") to + // ForceSendFields is a list of field names (e.g. "NextSyncTime") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "RefreshInterval") to include in - // API requests with the JSON null value. By default, fields with empty values - // are omitted from API requests. See + // NullFields is a list of field names (e.g. "NextSyncTime") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -15388,6 +15606,140 @@ func (s GoogleCloudDiscoveryengineV1alphaRecrawlUrisResponseFailureInfoFailureRe return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateMetadata: Metadata +// related to the progress of the +// CrawlRateManagementService.RemoveDedicatedCrawlRate operation. This will be +// returned by the google.longrunning.Operation.metadata field. +type GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + // UpdateTime: Operation last update time. If the operation is done, this is + // also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "CreateTime") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CreateTime") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateResponse: Response +// message for CrawlRateManagementService.RemoveDedicatedCrawlRate method. It +// simply returns the state of the response, and an error message if the state +// is FAILED. +type GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateResponse struct { + // Error: Errors from service when handling the request. + Error *GoogleRpcStatus `json:"error,omitempty"` + // State: Output only. The state of the response. + // + // Possible values: + // "STATE_UNSPECIFIED" - The state is unspecified. + // "SUCCEEDED" - The state is successful. + // "FAILED" - The state is failed. + State string `json:"state,omitempty"` + // ForceSendFields is a list of field names (e.g. "Error") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Error") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaSafetyRating: Safety rating corresponding +// to the generated content. +type GoogleCloudDiscoveryengineV1alphaSafetyRating struct { + // Blocked: Output only. Indicates whether the content was filtered out because + // of this rating. + Blocked bool `json:"blocked,omitempty"` + // Category: Output only. Harm category. + // + // Possible values: + // "HARM_CATEGORY_UNSPECIFIED" - The harm category is unspecified. + // "HARM_CATEGORY_HATE_SPEECH" - The harm category is hate speech. + // "HARM_CATEGORY_DANGEROUS_CONTENT" - The harm category is dangerous + // content. + // "HARM_CATEGORY_HARASSMENT" - The harm category is harassment. + // "HARM_CATEGORY_SEXUALLY_EXPLICIT" - The harm category is sexually explicit + // content. + // "HARM_CATEGORY_CIVIC_INTEGRITY" - The harm category is civic integrity. + Category string `json:"category,omitempty"` + // Probability: Output only. Harm probability levels in the content. + // + // Possible values: + // "HARM_PROBABILITY_UNSPECIFIED" - Harm probability unspecified. + // "NEGLIGIBLE" - Negligible level of harm. + // "LOW" - Low level of harm. + // "MEDIUM" - Medium level of harm. + // "HIGH" - High level of harm. + Probability string `json:"probability,omitempty"` + // ProbabilityScore: Output only. Harm probability score. + ProbabilityScore float64 `json:"probabilityScore,omitempty"` + // Severity: Output only. Harm severity levels in the content. + // + // Possible values: + // "HARM_SEVERITY_UNSPECIFIED" - Harm severity unspecified. + // "HARM_SEVERITY_NEGLIGIBLE" - Negligible level of harm severity. + // "HARM_SEVERITY_LOW" - Low level of harm severity. + // "HARM_SEVERITY_MEDIUM" - Medium level of harm severity. + // "HARM_SEVERITY_HIGH" - High level of harm severity. + Severity string `json:"severity,omitempty"` + // SeverityScore: Output only. Harm severity score. + SeverityScore float64 `json:"severityScore,omitempty"` + // ForceSendFields is a list of field names (e.g. "Blocked") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Blocked") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaSafetyRating) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaSafetyRating + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleCloudDiscoveryengineV1alphaSafetyRating) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudDiscoveryengineV1alphaSafetyRating + var s1 struct { + ProbabilityScore gensupport.JSONFloat64 `json:"probabilityScore"` + SeverityScore gensupport.JSONFloat64 `json:"severityScore"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.ProbabilityScore = float64(s1.ProbabilityScore) + s.SeverityScore = float64(s1.SeverityScore) + return nil +} + // GoogleCloudDiscoveryengineV1alphaSchema: Defines the structure and layout of // a type of document data. type GoogleCloudDiscoveryengineV1alphaSchema struct { @@ -16431,10 +16783,10 @@ func (s GoogleCloudDiscoveryengineV1alphaSearchRequestImageQuery) MarshalJSON() // for search requests. type GoogleCloudDiscoveryengineV1alphaSearchRequestNaturalLanguageQueryUnderstandingSpec struct { // FilterExtractionCondition: The condition under which filter extraction - // should occur. Default to Condition.DISABLED. + // should occur. Server behavior defaults to `DISABLED`. // // Possible values: - // "CONDITION_UNSPECIFIED" - Server behavior defaults to Condition.DISABLED. + // "CONDITION_UNSPECIFIED" - Server behavior defaults to `DISABLED`. // "DISABLED" - Disables NL filter extraction. // "ENABLED" - Enables NL filter extraction. FilterExtractionCondition string `json:"filterExtractionCondition,omitempty"` @@ -16705,6 +17057,66 @@ func (s GoogleCloudDiscoveryengineV1alphaSessionTurn) MarshalJSON() ([]byte, err return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateMetadata: Metadata +// related to the progress of the +// CrawlRateManagementService.SetDedicatedCrawlRate operation. This will be +// returned by the google.longrunning.Operation.metadata field. +type GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + // UpdateTime: Operation last update time. If the operation is done, this is + // also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "CreateTime") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CreateTime") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateResponse: Response +// message for CrawlRateManagementService.SetDedicatedCrawlRate method. It +// simply returns the state of the response, and an error message if the state +// is FAILED. +type GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateResponse struct { + // Error: Errors from service when handling the request. + Error *GoogleRpcStatus `json:"error,omitempty"` + // State: Output only. The state of the response. + // + // Possible values: + // "STATE_UNSPECIFIED" - The state is unspecified. + // "SUCCEEDED" - The state is successful. + // "FAILED" - The state is failed. + State string `json:"state,omitempty"` + // ForceSendFields is a list of field names (e.g. "Error") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Error") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaSetUpDataConnectorMetadata: Metadata for // DataConnectorService.SetUpDataConnector method. type GoogleCloudDiscoveryengineV1alphaSetUpDataConnectorMetadata struct { @@ -16834,7 +17246,7 @@ func (s GoogleCloudDiscoveryengineV1alphaSitemap) MarshalJSON() ([]byte, error) // GoogleCloudDiscoveryengineV1alphaTargetSite: A target site for the // SiteSearchEngine. type GoogleCloudDiscoveryengineV1alphaTargetSite struct { - // ExactMatch: Input only. If set to false, a uri_pattern is generated to + // ExactMatch: Immutable. If set to false, a uri_pattern is generated to // include all pages whose address contains the provided_uri_pattern. If set to // true, an uri_pattern is generated to try to be an exact match of the // provided_uri_pattern or just the specific page if the provided_uri_pattern @@ -17260,6 +17672,28 @@ func (s GoogleCloudDiscoveryengineV1alphaWorkspaceConfig) MarshalJSON() ([]byte, // GoogleCloudDiscoveryengineV1betaAdvancedSiteSearchConfig: Configuration data // for advance site search. type GoogleCloudDiscoveryengineV1betaAdvancedSiteSearchConfig struct { + // DisableAutomaticRefresh: If set true, automatic refresh is disabled for the + // DataStore. + DisableAutomaticRefresh bool `json:"disableAutomaticRefresh,omitempty"` + // DisableInitialIndex: If set true, initial indexing is disabled for the + // DataStore. + DisableInitialIndex bool `json:"disableInitialIndex,omitempty"` + // ForceSendFields is a list of field names (e.g. "DisableAutomaticRefresh") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "DisableAutomaticRefresh") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1betaAdvancedSiteSearchConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaAdvancedSiteSearchConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } // GoogleCloudDiscoveryengineV1betaBatchCreateTargetSiteMetadata: Metadata @@ -17527,8 +17961,8 @@ func (s GoogleCloudDiscoveryengineV1betaControl) MarshalJSON() ([]byte, error) { // GoogleCloudDiscoveryengineV1betaControlBoostAction: Adjusts order of // products in returned list. type GoogleCloudDiscoveryengineV1betaControlBoostAction struct { - // Boost: Required. Strength of the boost, which should be in [-1, 1]. Negative - // boost means demotion. Default is 0.0 (No-op). + // Boost: Strength of the boost, which should be in [-1, 1]. Negative boost + // means demotion. Default is 0.0 (No-op). Boost float64 `json:"boost,omitempty"` // DataStore: Required. Specifies which data store's documents can be boosted // by this control. Full data store name e.g. @@ -17540,6 +17974,9 @@ type GoogleCloudDiscoveryengineV1betaControlBoostAction struct { // documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum // length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown. Filter string `json:"filter,omitempty"` + // FixedBoost: Optional. Strength of the boost, which should be in [-1, 1]. + // Negative boost means demotion. Default is 0.0 (No-op). + FixedBoost float64 `json:"fixedBoost,omitempty"` // ForceSendFields is a list of field names (e.g. "Boost") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See @@ -17561,7 +17998,8 @@ func (s GoogleCloudDiscoveryengineV1betaControlBoostAction) MarshalJSON() ([]byt func (s *GoogleCloudDiscoveryengineV1betaControlBoostAction) UnmarshalJSON(data []byte) error { type NoMethod GoogleCloudDiscoveryengineV1betaControlBoostAction var s1 struct { - Boost gensupport.JSONFloat64 `json:"boost"` + Boost gensupport.JSONFloat64 `json:"boost"` + FixedBoost gensupport.JSONFloat64 `json:"fixedBoost"` *NoMethod } s1.NoMethod = (*NoMethod)(s) @@ -17569,6 +18007,7 @@ func (s *GoogleCloudDiscoveryengineV1betaControlBoostAction) UnmarshalJSON(data return err } s.Boost = float64(s1.Boost) + s.FixedBoost = float64(s1.FixedBoost) return nil } @@ -18040,6 +18479,34 @@ func (s GoogleCloudDiscoveryengineV1betaDeleteEngineMetadata) MarshalJSON() ([]b return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1betaDeleteIdentityMappingStoreMetadata: Metadata +// related to the progress of the +// IdentityMappingStoreService.DeleteIdentityMappingStore operation. This will +// be returned by the google.longrunning.Operation.metadata field. +type GoogleCloudDiscoveryengineV1betaDeleteIdentityMappingStoreMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + // UpdateTime: Operation last update time. If the operation is done, this is + // also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "CreateTime") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CreateTime") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1betaDeleteIdentityMappingStoreMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaDeleteIdentityMappingStoreMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1betaDeleteSchemaMetadata: Metadata for // DeleteSchema LRO. type GoogleCloudDiscoveryengineV1betaDeleteSchemaMetadata struct { @@ -20525,10 +20992,10 @@ func (s GoogleCloudDiscoveryengineV1betaSearchRequestImageQuery) MarshalJSON() ( // for search requests. type GoogleCloudDiscoveryengineV1betaSearchRequestNaturalLanguageQueryUnderstandingSpec struct { // FilterExtractionCondition: The condition under which filter extraction - // should occur. Default to Condition.DISABLED. + // should occur. Server behavior defaults to `DISABLED`. // // Possible values: - // "CONDITION_UNSPECIFIED" - Server behavior defaults to Condition.DISABLED. + // "CONDITION_UNSPECIFIED" - Server behavior defaults to `DISABLED`. // "DISABLED" - Disables NL filter extraction. // "ENABLED" - Enables NL filter extraction. FilterExtractionCondition string `json:"filterExtractionCondition,omitempty"` @@ -20814,7 +21281,7 @@ func (s GoogleCloudDiscoveryengineV1betaSitemap) MarshalJSON() ([]byte, error) { // GoogleCloudDiscoveryengineV1betaTargetSite: A target site for the // SiteSearchEngine. type GoogleCloudDiscoveryengineV1betaTargetSite struct { - // ExactMatch: Input only. If set to false, a uri_pattern is generated to + // ExactMatch: Immutable. If set to false, a uri_pattern is generated to // include all pages whose address contains the provided_uri_pattern. If set to // true, an uri_pattern is generated to try to be an exact match of the // provided_uri_pattern or just the specific page if the provided_uri_pattern @@ -23265,7 +23732,7 @@ func (r *ProjectsLocationsCollectionsDataStoresBranchesDocumentsService) Create( // whether or not it exists, a `PERMISSION_DENIED` error is returned. This // field must be unique among all Documents with the same parent. Otherwise, an // `ALREADY_EXISTS` error is returned. This field must conform to RFC-1034 -// (https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 +// (https://tools.ietf.org/html/rfc1034) standard with a length limit of 128 // characters. Otherwise, an `INVALID_ARGUMENT` error is returned. func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall) DocumentId(documentId string) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall { c.urlParams_.Set("documentId", documentId) @@ -36366,7 +36833,7 @@ func (r *ProjectsLocationsDataStoresBranchesDocumentsService) Create(parent stri // whether or not it exists, a `PERMISSION_DENIED` error is returned. This // field must be unique among all Documents with the same parent. Otherwise, an // `ALREADY_EXISTS` error is returned. This field must conform to RFC-1034 -// (https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 +// (https://tools.ietf.org/html/rfc1034) standard with a length limit of 128 // characters. Otherwise, an `INVALID_ARGUMENT` error is returned. func (c *ProjectsLocationsDataStoresBranchesDocumentsCreateCall) DocumentId(documentId string) *ProjectsLocationsDataStoresBranchesDocumentsCreateCall { c.urlParams_.Set("documentId", documentId) diff --git a/discoveryengine/v1alpha/discoveryengine-api.json b/discoveryengine/v1alpha/discoveryengine-api.json index 3b24549bf8b..f34a0eddf71 100644 --- a/discoveryengine/v1alpha/discoveryengine-api.json +++ b/discoveryengine/v1alpha/discoveryengine-api.json @@ -320,6 +320,90 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "obtainCrawlRate": { + "description": "Obtains the time series data of organic or dedicated crawl rate for monitoring. When dedicated crawl rate is not set, it will return vertex AI's organic crawl rate time series. Organic crawl means Google automatically crawl the internet at its own convenience. When dedicated crawl rate is set, it will return vertex AI's dedicated crawl rate time series.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}:obtainCrawlRate", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.obtainCrawlRate", + "parameterOrder": [ + "location" + ], + "parameters": { + "location": { + "description": "Required. The location resource where crawl rate management will be performed. Format: `projects/{project}/locations/{location}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+location}:obtainCrawlRate", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1alphaObtainCrawlRateRequest" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "removeDedicatedCrawlRate": { + "description": "Removes the dedicated crawl rate for a craw_rate_scope. If the dedicated crawl rate was set, this will disable vertex AI's crawl bot from using the dedicated crawl rate for crawling. If the dedicated crawl rate was not set, this is a no-op.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}:removeDedicatedCrawlRate", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.removeDedicatedCrawlRate", + "parameterOrder": [ + "location" + ], + "parameters": { + "location": { + "description": "Required. The location resource where crawl rate management will be performed. Format: `projects/{project}/locations/{location}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+location}:removeDedicatedCrawlRate", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateRequest" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "setDedicatedCrawlRate": { + "description": "Sets the dedicated crawl rate for a crawl_rate_scope. If the dedicated crawl rate was not set, this will enable vertex AI's crawl bot to use the new dedicated crawl rate for crawling. If the dedicated crawl rate was set, vertex AI's crawl bot will try to update the rate to the new value. If the new value is too high, the crawl bot may crawl at a lower rate to avoid overloading the user's website.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}:setDedicatedCrawlRate", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.setDedicatedCrawlRate", + "parameterOrder": [ + "location" + ], + "parameters": { + "location": { + "description": "Required. The location resource where crawl rate management will be performed. Format: `projects/{project}/locations/{location}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+location}:setDedicatedCrawlRate", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateRequest" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "setUpDataConnector": { "description": "Creates a Collection and sets up the DataConnector for it. To stop a DataConnector after setup, use the CollectionService.DeleteCollection method.", "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}:setUpDataConnector", @@ -1222,7 +1306,7 @@ ], "parameters": { "documentId": { - "description": "Required. The ID to use for the Document, which becomes the final component of the Document.name. If the caller does not have permission to create the Document, regardless of whether or not it exists, a `PERMISSION_DENIED` error is returned. This field must be unique among all Documents with the same parent. Otherwise, an `ALREADY_EXISTS` error is returned. This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters. Otherwise, an `INVALID_ARGUMENT` error is returned.", + "description": "Required. The ID to use for the Document, which becomes the final component of the Document.name. If the caller does not have permission to create the Document, regardless of whether or not it exists, a `PERMISSION_DENIED` error is returned. This field must be unique among all Documents with the same parent. Otherwise, an `ALREADY_EXISTS` error is returned. This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 128 characters. Otherwise, an `INVALID_ARGUMENT` error is returned.", "location": "query", "type": "string" }, @@ -5283,7 +5367,7 @@ ], "parameters": { "documentId": { - "description": "Required. The ID to use for the Document, which becomes the final component of the Document.name. If the caller does not have permission to create the Document, regardless of whether or not it exists, a `PERMISSION_DENIED` error is returned. This field must be unique among all Documents with the same parent. Otherwise, an `ALREADY_EXISTS` error is returned. This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters. Otherwise, an `INVALID_ARGUMENT` error is returned.", + "description": "Required. The ID to use for the Document, which becomes the final component of the Document.name. If the caller does not have permission to create the Document, regardless of whether or not it exists, a `PERMISSION_DENIED` error is returned. This field must be unique among all Documents with the same parent. Otherwise, an `ALREADY_EXISTS` error is returned. This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 128 characters. Otherwise, an `INVALID_ARGUMENT` error is returned.", "location": "query", "type": "string" }, @@ -7541,14 +7625,14 @@ ], "parameters": { "evaluation": { - "description": "Required. The evaluation resource name, such as `projects/{project}/locations/{location}/evaluations/{evaluation}`. If the caller does not have permission to list EvaluationResult under this evaluation, regardless of whether or not this evaluation set exists, a `PERMISSION_DENIED` error is returned.", + "description": "Required. The evaluation resource name, such as `projects/{project}/locations/{location}/evaluations/{evaluation}`. If the caller does not have permission to list ListEvaluationResultsResponse.EvaluationResult under this evaluation, regardless of whether or not this evaluation set exists, a `PERMISSION_DENIED` error is returned.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/evaluations/[^/]+$", "required": true, "type": "string" }, "pageSize": { - "description": "Maximum number of EvaluationResult to return. If unspecified, defaults to 100. The maximum allowed value is 1000. Values above 1000 will be coerced to 1000. If this field is negative, an `INVALID_ARGUMENT` error is returned.", + "description": "Maximum number of ListEvaluationResultsResponse.EvaluationResult to return. If unspecified, defaults to 100. The maximum allowed value is 1000. Values above 1000 will be coerced to 1000. If this field is negative, an `INVALID_ARGUMENT` error is returned.", "format": "int32", "location": "query", "type": "integer" @@ -8468,7 +8552,7 @@ } } }, - "revision": "20241216", + "revision": "20250107", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiDistribution": { @@ -8846,7 +8930,16 @@ "GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig": { "description": "Configuration data for advance site search.", "id": "GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig", - "properties": {}, + "properties": { + "disableAutomaticRefresh": { + "description": "If set true, automatic refresh is disabled for the DataStore.", + "type": "boolean" + }, + "disableInitialIndex": { + "description": "If set true, initial indexing is disabled for the DataStore.", + "type": "boolean" + } + }, "type": "object" }, "GoogleCloudDiscoveryengineV1BatchCreateTargetSiteMetadata": { @@ -9087,7 +9180,8 @@ "id": "GoogleCloudDiscoveryengineV1ControlBoostAction", "properties": { "boost": { - "description": "Required. Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op).", + "deprecated": true, + "description": "Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op).", "format": "float", "type": "number" }, @@ -9098,6 +9192,11 @@ "filter": { "description": "Required. Specifies which products to apply the boost to. If no filter is provided all products will be boosted (No-op). Syntax documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown.", "type": "string" + }, + "fixedBoost": { + "description": "Optional. Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op).", + "format": "float", + "type": "number" } }, "type": "object" @@ -9426,6 +9525,23 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1DeleteIdentityMappingStoreMetadata": { + "description": "Metadata related to the progress of the IdentityMappingStoreService.DeleteIdentityMappingStore operation. This will be returned by the google.longrunning.Operation.metadata field.", + "id": "GoogleCloudDiscoveryengineV1DeleteIdentityMappingStoreMetadata", + "properties": { + "createTime": { + "description": "Operation create time.", + "format": "google-datetime", + "type": "string" + }, + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1DeleteSchemaMetadata": { "description": "Metadata for DeleteSchema LRO.", "id": "GoogleCloudDiscoveryengineV1DeleteSchemaMetadata", @@ -10501,7 +10617,7 @@ "type": "array" }, "rankingExpression": { - "description": "The ranking expression controls the customized ranking on retrieval documents. To leverage this, document embedding is required. The ranking expression setting in ServingConfig applies to all search requests served by the serving config. However, if SearchRequest.ranking_expression is specified, it overrides the ServingConfig ranking expression. The ranking expression is a single function or multiple functions that are joined by \"+\". * ranking_expression = function, { \" + \", function }; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between embedding_field_path and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`.", + "description": "The ranking expression controls the customized ranking on retrieval documents. To leverage this, document embedding is required. The ranking expression setting in ServingConfig applies to all search requests served by the serving config. However, if `SearchRequest.ranking_expression` is specified, it overrides the ServingConfig ranking expression. The ranking expression is a single function or multiple functions that are joined by \"+\". * ranking_expression = function, { \" + \", function }; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between embedding_field_path and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`.", "type": "string" }, "redirectControlIds": { @@ -10638,7 +10754,7 @@ "id": "GoogleCloudDiscoveryengineV1TargetSite", "properties": { "exactMatch": { - "description": "Input only. If set to false, a uri_pattern is generated to include all pages whose address contains the provided_uri_pattern. If set to true, an uri_pattern is generated to try to be an exact match of the provided_uri_pattern or just the specific page if the provided_uri_pattern is a specific one. provided_uri_pattern is always normalized to generate the URI pattern to be used by the search engine.", + "description": "Immutable. If set to false, a uri_pattern is generated to include all pages whose address contains the provided_uri_pattern. If set to true, an uri_pattern is generated to try to be an exact match of the provided_uri_pattern or just the specific page if the provided_uri_pattern is a specific one. provided_uri_pattern is always normalized to generate the URI pattern to be used by the search engine.", "type": "boolean" }, "failureReason": { @@ -11283,6 +11399,13 @@ }, "type": "array" }, + "safetyRatings": { + "description": "Optional. Safety ratings.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1alphaSafetyRating" + }, + "type": "array" + }, "state": { "description": "The state of the answer generation.", "enum": [ @@ -11622,6 +11745,60 @@ "enable": { "description": "Enable the safety filtering on the answer response. It is false by default.", "type": "boolean" + }, + "safetySettings": { + "description": "Optional. Safety settings. This settings are effective only when the safety_spec.enable is true.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSafetySpecSafetySetting" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSafetySpecSafetySetting": { + "description": "Safety settings.", + "id": "GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSafetySpecSafetySetting", + "properties": { + "category": { + "description": "Required. Harm category.", + "enum": [ + "HARM_CATEGORY_UNSPECIFIED", + "HARM_CATEGORY_HATE_SPEECH", + "HARM_CATEGORY_DANGEROUS_CONTENT", + "HARM_CATEGORY_HARASSMENT", + "HARM_CATEGORY_SEXUALLY_EXPLICIT", + "HARM_CATEGORY_CIVIC_INTEGRITY" + ], + "enumDescriptions": [ + "The harm category is unspecified.", + "The harm category is hate speech.", + "The harm category is dangerous content.", + "The harm category is harassment.", + "The harm category is sexually explicit content.", + "The harm category is civic integrity." + ], + "type": "string" + }, + "threshold": { + "description": "Required. The harm block threshold.", + "enum": [ + "HARM_BLOCK_THRESHOLD_UNSPECIFIED", + "BLOCK_LOW_AND_ABOVE", + "BLOCK_MEDIUM_AND_ABOVE", + "BLOCK_ONLY_HIGH", + "BLOCK_NONE", + "OFF" + ], + "enumDescriptions": [ + "Unspecified harm block threshold.", + "Block low threshold and above (i.e. block more).", + "Block medium threshold and above.", + "Block only high threshold (i.e. block less).", + "Block none.", + "Turn off the safety filter." + ], + "type": "string" } }, "type": "object" @@ -12909,7 +13086,7 @@ }, "dataConnector": { "$ref": "GoogleCloudDiscoveryengineV1alphaDataConnector", - "description": "Output only. The data connector, if present, manages the connection for data stores in the Collection. To set up the connector, use DataConnectorService.SetUpDataConnector method, which creates a new Collection while setting up the DataConnector singleton resource. Setting up connector on an existing Collection is not supported. This output only field contains a subset of the DataConnector fields, including `name`, `data_source`, `entities.entity_name` and `entities.data_store`. To get more details about a data connector, use the DataConnector.GetDataConnector method.", + "description": "Output only. The data connector, if present, manages the connection for data stores in the Collection. To set up the connector, use DataConnectorService.SetUpDataConnector method, which creates a new Collection while setting up the DataConnector singleton resource. Setting up connector on an existing Collection is not supported. This output only field contains a subset of the DataConnector fields, including `name`, `data_source`, `entities.entity_name` and `entities.data_store`. To get more details about a data connector, use the DataConnectorService.GetDataConnector method.", "readOnly": true }, "displayName": { @@ -13343,7 +13520,8 @@ "id": "GoogleCloudDiscoveryengineV1alphaControlBoostAction", "properties": { "boost": { - "description": "Required. Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op).", + "deprecated": true, + "description": "Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op).", "format": "float", "type": "number" }, @@ -13354,6 +13532,11 @@ "filter": { "description": "Required. Specifies which products to apply the boost to. If no filter is provided all products will be boosted (No-op). Syntax documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown.", "type": "string" + }, + "fixedBoost": { + "description": "Optional. Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op).", + "format": "float", + "type": "number" } }, "type": "object" @@ -13789,7 +13972,7 @@ "type": "object" }, "GoogleCloudDiscoveryengineV1alphaDataConnector": { - "description": "Manages the connection to external data sources for all data stores grouped under a Collection. It's a singleton resource of Collection. The initialization is only supported through SetUpDataConnector method, which will create a new Collection and initialize its DataConnector. //", + "description": "Manages the connection to external data sources for all data stores grouped under a Collection. It's a singleton resource of Collection. The initialization is only supported through DataConnectorService.SetUpDataConnector method, which will create a new Collection and initialize its DataConnector.", "id": "GoogleCloudDiscoveryengineV1alphaDataConnector", "properties": { "actionConfig": { @@ -14236,6 +14419,23 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaDeleteIdentityMappingStoreMetadata": { + "description": "Metadata related to the progress of the IdentityMappingStoreService.DeleteIdentityMappingStore operation. This will be returned by the google.longrunning.Operation.metadata field.", + "id": "GoogleCloudDiscoveryengineV1alphaDeleteIdentityMappingStoreMetadata", + "properties": { + "createTime": { + "description": "Operation create time.", + "format": "google-datetime", + "type": "string" + }, + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaDeleteSchemaMetadata": { "description": "Metadata for DeleteSchema LRO.", "id": "GoogleCloudDiscoveryengineV1alphaDeleteSchemaMetadata", @@ -14391,7 +14591,7 @@ "type": "object" }, "id": { - "description": "Immutable. The identifier of the document. Id should conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters.", + "description": "Immutable. The identifier of the document. Id should conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 128 characters.", "type": "string" }, "indexStatus": { @@ -15983,6 +16183,10 @@ "description": "The configuration for the identity data synchronization runs.", "id": "GoogleCloudDiscoveryengineV1alphaIdentityScheduleConfig", "properties": { + "nextSyncTime": { + "$ref": "GoogleTypeDateTime", + "description": "Optional. The UTC time when the next data sync is expected to start for the Data Connector. Customers are only able to specify the hour and minute to schedule the data sync. This is utilized when the data connector has a refresh interval greater than 1 day." + }, "refreshInterval": { "description": "Optional. The refresh interval to sync the Access Control List information for the documents ingested by this connector. If not set, the access control list will be refreshed at the default interval of 30 minutes. The identity refresh interval can be at least 30 minutes and at most 7 days.", "format": "google-duration", @@ -16737,7 +16941,7 @@ "id": "GoogleCloudDiscoveryengineV1alphaListEvaluationResultsResponse", "properties": { "evaluationResults": { - "description": "The EvaluationResults.", + "description": "The evaluation results for the SampleQuerys.", "items": { "$ref": "GoogleCloudDiscoveryengineV1alphaListEvaluationResultsResponseEvaluationResult" }, @@ -16964,6 +17168,17 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaObtainCrawlRateRequest": { + "description": "Request message for CrawlRateManagementService.ObtainCrawlRate method.", + "id": "GoogleCloudDiscoveryengineV1alphaObtainCrawlRateRequest", + "properties": { + "crawlRateScope": { + "description": "Required. The scope of the crawl rate that the user wants to monitor. Currently, only domain and host name are supported. A domain name example: `abc.com`. A host name example: `www.abc.com`. Please do not include `/` in the domain or host name.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse": { "description": "Response message for CrawlRateManagementService.ObtainCrawlRate method. The response contains organcic or dedicated crawl rate time series data for monitoring, depending on whether dedicated crawl rate is set.", "id": "GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse", @@ -17738,7 +17953,7 @@ "id": "GoogleCloudDiscoveryengineV1alphaRecrawlUrisRequest", "properties": { "siteCredential": { - "description": "Optional. Full resource name of the SiteCredential, such as `projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine/siteCredentials/*`. Only set to crawl private URIs.", + "description": "Optional. Full resource name of the `SiteCredential`, such as `projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine/siteCredentials/*`. Only set to crawl private URIs.", "type": "string" }, "uris": { @@ -17815,6 +18030,60 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateMetadata": { + "description": "Metadata related to the progress of the CrawlRateManagementService.RemoveDedicatedCrawlRate operation. This will be returned by the google.longrunning.Operation.metadata field.", + "id": "GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateMetadata", + "properties": { + "createTime": { + "description": "Operation create time.", + "format": "google-datetime", + "type": "string" + }, + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateRequest": { + "description": "Request message for CrawlRateManagementService.RemoveDedicatedCrawlRate method. The user can remove the dedicated crawl rate for a crawl_rate_scope they own, and Google will fall back to organic crawl, and the crawl rate will be determined by Google.", + "id": "GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateRequest", + "properties": { + "crawlRateScope": { + "description": "Required. The scope of the crawl rate change. Currently, only domain and host name are supported. A domain name example: `abc.com`. A host name example: `www.abc.com`. Please do not include `/` in the domain or host name.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateResponse": { + "description": "Response message for CrawlRateManagementService.RemoveDedicatedCrawlRate method. It simply returns the state of the response, and an error message if the state is FAILED.", + "id": "GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateResponse", + "properties": { + "error": { + "$ref": "GoogleRpcStatus", + "description": "Errors from service when handling the request." + }, + "state": { + "description": "Output only. The state of the response.", + "enum": [ + "STATE_UNSPECIFIED", + "SUCCEEDED", + "FAILED" + ], + "enumDescriptions": [ + "The state is unspecified.", + "The state is successful.", + "The state is failed." + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaReply": { "description": "Defines a reply message to user.", "id": "GoogleCloudDiscoveryengineV1alphaReply", @@ -18033,6 +18302,89 @@ "properties": {}, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaSafetyRating": { + "description": "Safety rating corresponding to the generated content.", + "id": "GoogleCloudDiscoveryengineV1alphaSafetyRating", + "properties": { + "blocked": { + "description": "Output only. Indicates whether the content was filtered out because of this rating.", + "readOnly": true, + "type": "boolean" + }, + "category": { + "description": "Output only. Harm category.", + "enum": [ + "HARM_CATEGORY_UNSPECIFIED", + "HARM_CATEGORY_HATE_SPEECH", + "HARM_CATEGORY_DANGEROUS_CONTENT", + "HARM_CATEGORY_HARASSMENT", + "HARM_CATEGORY_SEXUALLY_EXPLICIT", + "HARM_CATEGORY_CIVIC_INTEGRITY" + ], + "enumDescriptions": [ + "The harm category is unspecified.", + "The harm category is hate speech.", + "The harm category is dangerous content.", + "The harm category is harassment.", + "The harm category is sexually explicit content.", + "The harm category is civic integrity." + ], + "readOnly": true, + "type": "string" + }, + "probability": { + "description": "Output only. Harm probability levels in the content.", + "enum": [ + "HARM_PROBABILITY_UNSPECIFIED", + "NEGLIGIBLE", + "LOW", + "MEDIUM", + "HIGH" + ], + "enumDescriptions": [ + "Harm probability unspecified.", + "Negligible level of harm.", + "Low level of harm.", + "Medium level of harm.", + "High level of harm." + ], + "readOnly": true, + "type": "string" + }, + "probabilityScore": { + "description": "Output only. Harm probability score.", + "format": "float", + "readOnly": true, + "type": "number" + }, + "severity": { + "description": "Output only. Harm severity levels in the content.", + "enum": [ + "HARM_SEVERITY_UNSPECIFIED", + "HARM_SEVERITY_NEGLIGIBLE", + "HARM_SEVERITY_LOW", + "HARM_SEVERITY_MEDIUM", + "HARM_SEVERITY_HIGH" + ], + "enumDescriptions": [ + "Harm severity unspecified.", + "Negligible level of harm severity.", + "Low level of harm severity.", + "Medium level of harm severity.", + "High level of harm severity." + ], + "readOnly": true, + "type": "string" + }, + "severityScore": { + "description": "Output only. Harm severity score.", + "format": "float", + "readOnly": true, + "type": "number" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaSampleQuery": { "description": "Sample Query captures metadata to be used for evaluation.", "id": "GoogleCloudDiscoveryengineV1alphaSampleQuery", @@ -18780,14 +19132,14 @@ "id": "GoogleCloudDiscoveryengineV1alphaSearchRequestNaturalLanguageQueryUnderstandingSpec", "properties": { "filterExtractionCondition": { - "description": "The condition under which filter extraction should occur. Default to Condition.DISABLED.", + "description": "The condition under which filter extraction should occur. Server behavior defaults to `DISABLED`.", "enum": [ "CONDITION_UNSPECIFIED", "DISABLED", "ENABLED" ], "enumDescriptions": [ - "Server behavior defaults to Condition.DISABLED.", + "Server behavior defaults to `DISABLED`.", "Disables NL filter extraction.", "Enables NL filter extraction." ], @@ -19633,7 +19985,7 @@ "type": "array" }, "rankingExpression": { - "description": "The ranking expression controls the customized ranking on retrieval documents. To leverage this, document embedding is required. The ranking expression setting in ServingConfig applies to all search requests served by the serving config. However, if SearchRequest.ranking_expression is specified, it overrides the ServingConfig ranking expression. The ranking expression is a single function or multiple functions that are joined by \"+\". * ranking_expression = function, { \" + \", function }; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between embedding_field_path and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`.", + "description": "The ranking expression controls the customized ranking on retrieval documents. To leverage this, document embedding is required. The ranking expression setting in ServingConfig applies to all search requests served by the serving config. However, if `SearchRequest.ranking_expression` is specified, it overrides the ServingConfig ranking expression. The ranking expression is a single function or multiple functions that are joined by \"+\". * ranking_expression = function, { \" + \", function }; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between embedding_field_path and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`.", "type": "string" }, "redirectControlIds": { @@ -19800,6 +20152,93 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateMetadata": { + "description": "Metadata related to the progress of the CrawlRateManagementService.SetDedicatedCrawlRate operation. This will be returned by the google.longrunning.Operation.metadata field.", + "id": "GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateMetadata", + "properties": { + "createTime": { + "description": "Operation create time.", + "format": "google-datetime", + "type": "string" + }, + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateRequest": { + "description": "Request message for CrawlRateManagementService.SetDedicatedCrawlRate method. The user can set the crawl rate for a crawl_rate_scope they own. They can set up an overall crawl rate, or set up a user-triggered crawl rate and a auto-refresh crawl rate separately. If an overall crawl rate is set, Vertex AI will automatically splits crawl_rate into user-triggered and auto-refresh.", + "id": "GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateRequest", + "properties": { + "crawlRate": { + "description": "Optional. The crawl QPS set by the user. It is not guaranteed that Vertex crawl bot will crawl at this QPS. If the crawl rate is too high, the real QPS may be lower than the value set by the user to avoid overloading the user's website.", + "format": "int32", + "type": "integer" + }, + "crawlRateScope": { + "description": "Required. The scope of the crawl rate that the user wants to config. Currently, only domain and host name are supported. A domain name example: `abc.com`. A host name example: `www.abc.com`. Please do not include `/` in the domain or host name.", + "type": "string" + }, + "crawlType": { + "description": "Optional. Whether it’s the crawl rate of user-triggered or auto-refresh.", + "enum": [ + "CRAWL_TYPE_UNSPECIFIED", + "USER_TRIGGERED", + "AUTO_REFRESH" + ], + "enumDescriptions": [ + "The crawl type is unspecified.", + "The crawl type is user-triggered.", + "The crawl type is auto-refresh." + ], + "type": "string" + }, + "mode": { + "description": "Optional. Whether the rate is explicitly set by users, or set by vertex AI.", + "enum": [ + "MODE_UNSPECIFIED", + "AUTOMATIC", + "EXPLICIT" + ], + "enumDescriptions": [ + "The mode is unspecified. If the user does not specify the mode, default to AUTOMATIC.", + "Vertex AI automatically splits crawl_rate into user-triggered and auto-refresh. Users don't need to specify SetDedicatedCrawlRateRequest.CrawlType if the mode is AUTOMATIC.", + "Users explicitly set user-triggered or auto-refresh crawl rate." + ], + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateResponse": { + "description": "Response message for CrawlRateManagementService.SetDedicatedCrawlRate method. It simply returns the state of the response, and an error message if the state is FAILED.", + "id": "GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateResponse", + "properties": { + "error": { + "$ref": "GoogleRpcStatus", + "description": "Errors from service when handling the request." + }, + "state": { + "description": "Output only. The state of the response.", + "enum": [ + "STATE_UNSPECIFIED", + "SUCCEEDED", + "FAILED" + ], + "enumDescriptions": [ + "The state is unspecified.", + "The state is successful.", + "The state is failed." + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaSetUpDataConnectorMetadata": { "description": "Metadata for DataConnectorService.SetUpDataConnector method.", "id": "GoogleCloudDiscoveryengineV1alphaSetUpDataConnectorMetadata", @@ -19989,7 +20428,7 @@ "type": "array" }, "healthcareFhirResourceTypes": { - "description": "The FHIR resource types to import. The resource types should be a subset of all supported FHIR resource types http://shortn/_J8ymdyOokT. Default to all supported FHIR resource types if empty.", + "description": "The FHIR resource types to import. The resource types should be a subset of all [supported FHIR resource types](https://cloud.google.com/generative-ai-app-builder/docs/fhir-schema-reference#resource-level-specification). Default to all supported FHIR resource types if empty.", "items": { "type": "string" }, @@ -20037,7 +20476,7 @@ "id": "GoogleCloudDiscoveryengineV1alphaTargetSite", "properties": { "exactMatch": { - "description": "Input only. If set to false, a uri_pattern is generated to include all pages whose address contains the provided_uri_pattern. If set to true, an uri_pattern is generated to try to be an exact match of the provided_uri_pattern or just the specific page if the provided_uri_pattern is a specific one. provided_uri_pattern is always normalized to generate the URI pattern to be used by the search engine.", + "description": "Immutable. If set to false, a uri_pattern is generated to include all pages whose address contains the provided_uri_pattern. If set to true, an uri_pattern is generated to try to be an exact match of the provided_uri_pattern or just the specific page if the provided_uri_pattern is a specific one. provided_uri_pattern is always normalized to generate the URI pattern to be used by the search engine.", "type": "boolean" }, "failureReason": { @@ -20560,7 +20999,16 @@ "GoogleCloudDiscoveryengineV1betaAdvancedSiteSearchConfig": { "description": "Configuration data for advance site search.", "id": "GoogleCloudDiscoveryengineV1betaAdvancedSiteSearchConfig", - "properties": {}, + "properties": { + "disableAutomaticRefresh": { + "description": "If set true, automatic refresh is disabled for the DataStore.", + "type": "boolean" + }, + "disableInitialIndex": { + "description": "If set true, initial indexing is disabled for the DataStore.", + "type": "boolean" + } + }, "type": "object" }, "GoogleCloudDiscoveryengineV1betaBatchCreateTargetSiteMetadata": { @@ -20801,7 +21249,8 @@ "id": "GoogleCloudDiscoveryengineV1betaControlBoostAction", "properties": { "boost": { - "description": "Required. Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op).", + "deprecated": true, + "description": "Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op).", "format": "float", "type": "number" }, @@ -20812,6 +21261,11 @@ "filter": { "description": "Required. Specifies which products to apply the boost to. If no filter is provided all products will be boosted (No-op). Syntax documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown.", "type": "string" + }, + "fixedBoost": { + "description": "Optional. Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op).", + "format": "float", + "type": "number" } }, "type": "object" @@ -21171,6 +21625,23 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaDeleteIdentityMappingStoreMetadata": { + "description": "Metadata related to the progress of the IdentityMappingStoreService.DeleteIdentityMappingStore operation. This will be returned by the google.longrunning.Operation.metadata field.", + "id": "GoogleCloudDiscoveryengineV1betaDeleteIdentityMappingStoreMetadata", + "properties": { + "createTime": { + "description": "Operation create time.", + "format": "google-datetime", + "type": "string" + }, + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaDeleteSchemaMetadata": { "description": "Metadata for DeleteSchema LRO.", "id": "GoogleCloudDiscoveryengineV1betaDeleteSchemaMetadata", @@ -22844,14 +23315,14 @@ "id": "GoogleCloudDiscoveryengineV1betaSearchRequestNaturalLanguageQueryUnderstandingSpec", "properties": { "filterExtractionCondition": { - "description": "The condition under which filter extraction should occur. Default to Condition.DISABLED.", + "description": "The condition under which filter extraction should occur. Server behavior defaults to `DISABLED`.", "enum": [ "CONDITION_UNSPECIFIED", "DISABLED", "ENABLED" ], "enumDescriptions": [ - "Server behavior defaults to Condition.DISABLED.", + "Server behavior defaults to `DISABLED`.", "Disables NL filter extraction.", "Enables NL filter extraction." ], @@ -23037,7 +23508,7 @@ "id": "GoogleCloudDiscoveryengineV1betaTargetSite", "properties": { "exactMatch": { - "description": "Input only. If set to false, a uri_pattern is generated to include all pages whose address contains the provided_uri_pattern. If set to true, an uri_pattern is generated to try to be an exact match of the provided_uri_pattern or just the specific page if the provided_uri_pattern is a specific one. provided_uri_pattern is always normalized to generate the URI pattern to be used by the search engine.", + "description": "Immutable. If set to false, a uri_pattern is generated to include all pages whose address contains the provided_uri_pattern. If set to true, an uri_pattern is generated to try to be an exact match of the provided_uri_pattern or just the specific page if the provided_uri_pattern is a specific one. provided_uri_pattern is always normalized to generate the URI pattern to be used by the search engine.", "type": "boolean" }, "failureReason": { diff --git a/discoveryengine/v1alpha/discoveryengine-gen.go b/discoveryengine/v1alpha/discoveryengine-gen.go index bff20397746..b400aa3d5e9 100644 --- a/discoveryengine/v1alpha/discoveryengine-gen.go +++ b/discoveryengine/v1alpha/discoveryengine-gen.go @@ -1759,6 +1759,28 @@ func (s GoogleCloudDiscoveryengineLoggingSourceLocation) MarshalJSON() ([]byte, // GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig: Configuration data for // advance site search. type GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig struct { + // DisableAutomaticRefresh: If set true, automatic refresh is disabled for the + // DataStore. + DisableAutomaticRefresh bool `json:"disableAutomaticRefresh,omitempty"` + // DisableInitialIndex: If set true, initial indexing is disabled for the + // DataStore. + DisableInitialIndex bool `json:"disableInitialIndex,omitempty"` + // ForceSendFields is a list of field names (e.g. "DisableAutomaticRefresh") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "DisableAutomaticRefresh") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } // GoogleCloudDiscoveryengineV1BatchCreateTargetSiteMetadata: Metadata related @@ -2026,8 +2048,8 @@ func (s GoogleCloudDiscoveryengineV1Control) MarshalJSON() ([]byte, error) { // GoogleCloudDiscoveryengineV1ControlBoostAction: Adjusts order of products in // returned list. type GoogleCloudDiscoveryengineV1ControlBoostAction struct { - // Boost: Required. Strength of the boost, which should be in [-1, 1]. Negative - // boost means demotion. Default is 0.0 (No-op). + // Boost: Strength of the boost, which should be in [-1, 1]. Negative boost + // means demotion. Default is 0.0 (No-op). Boost float64 `json:"boost,omitempty"` // DataStore: Required. Specifies which data store's documents can be boosted // by this control. Full data store name e.g. @@ -2039,6 +2061,9 @@ type GoogleCloudDiscoveryengineV1ControlBoostAction struct { // documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum // length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown. Filter string `json:"filter,omitempty"` + // FixedBoost: Optional. Strength of the boost, which should be in [-1, 1]. + // Negative boost means demotion. Default is 0.0 (No-op). + FixedBoost float64 `json:"fixedBoost,omitempty"` // ForceSendFields is a list of field names (e.g. "Boost") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See @@ -2060,7 +2085,8 @@ func (s GoogleCloudDiscoveryengineV1ControlBoostAction) MarshalJSON() ([]byte, e func (s *GoogleCloudDiscoveryengineV1ControlBoostAction) UnmarshalJSON(data []byte) error { type NoMethod GoogleCloudDiscoveryengineV1ControlBoostAction var s1 struct { - Boost gensupport.JSONFloat64 `json:"boost"` + Boost gensupport.JSONFloat64 `json:"boost"` + FixedBoost gensupport.JSONFloat64 `json:"fixedBoost"` *NoMethod } s1.NoMethod = (*NoMethod)(s) @@ -2068,6 +2094,7 @@ func (s *GoogleCloudDiscoveryengineV1ControlBoostAction) UnmarshalJSON(data []by return err } s.Boost = float64(s1.Boost) + s.FixedBoost = float64(s1.FixedBoost) return nil } @@ -2502,6 +2529,34 @@ func (s GoogleCloudDiscoveryengineV1DeleteEngineMetadata) MarshalJSON() ([]byte, return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1DeleteIdentityMappingStoreMetadata: Metadata +// related to the progress of the +// IdentityMappingStoreService.DeleteIdentityMappingStore operation. This will +// be returned by the google.longrunning.Operation.metadata field. +type GoogleCloudDiscoveryengineV1DeleteIdentityMappingStoreMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + // UpdateTime: Operation last update time. If the operation is done, this is + // also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "CreateTime") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CreateTime") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1DeleteIdentityMappingStoreMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DeleteIdentityMappingStoreMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1DeleteSchemaMetadata: Metadata for DeleteSchema // LRO. type GoogleCloudDiscoveryengineV1DeleteSchemaMetadata struct { @@ -3972,7 +4027,7 @@ type GoogleCloudDiscoveryengineV1ServingConfig struct { // RankingExpression: The ranking expression controls the customized ranking on // retrieval documents. To leverage this, document embedding is required. The // ranking expression setting in ServingConfig applies to all search requests - // served by the serving config. However, if SearchRequest.ranking_expression + // served by the serving config. However, if `SearchRequest.ranking_expression` // is specified, it overrides the ServingConfig ranking expression. The ranking // expression is a single function or multiple functions that are joined by // "+". * ranking_expression = function, { " + ", function }; Supported @@ -4187,7 +4242,7 @@ func (s GoogleCloudDiscoveryengineV1SiteVerificationInfo) MarshalJSON() ([]byte, // GoogleCloudDiscoveryengineV1TargetSite: A target site for the // SiteSearchEngine. type GoogleCloudDiscoveryengineV1TargetSite struct { - // ExactMatch: Input only. If set to false, a uri_pattern is generated to + // ExactMatch: Immutable. If set to false, a uri_pattern is generated to // include all pages whose address contains the provided_uri_pattern. If set to // true, an uri_pattern is generated to try to be an exact match of the // provided_uri_pattern or just the specific page if the provided_uri_pattern @@ -4988,6 +5043,8 @@ type GoogleCloudDiscoveryengineV1alphaAnswer struct { References []*GoogleCloudDiscoveryengineV1alphaAnswerReference `json:"references,omitempty"` // RelatedQuestions: Suggested related questions. RelatedQuestions []string `json:"relatedQuestions,omitempty"` + // SafetyRatings: Optional. Safety ratings. + SafetyRatings []*GoogleCloudDiscoveryengineV1alphaSafetyRating `json:"safetyRatings,omitempty"` // State: The state of the answer generation. // // Possible values: @@ -5493,6 +5550,9 @@ type GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSafetySpec struct { // Enable: Enable the safety filtering on the answer response. It is false by // default. Enable bool `json:"enable,omitempty"` + // SafetySettings: Optional. Safety settings. This settings are effective only + // when the safety_spec.enable is true. + SafetySettings []*GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSafetySpecSafetySetting `json:"safetySettings,omitempty"` // ForceSendFields is a list of field names (e.g. "Enable") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See @@ -5511,6 +5571,49 @@ func (s GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSafetySpec) MarshalJS return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSafetySpecSafetySetting: +// Safety settings. +type GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSafetySpecSafetySetting struct { + // Category: Required. Harm category. + // + // Possible values: + // "HARM_CATEGORY_UNSPECIFIED" - The harm category is unspecified. + // "HARM_CATEGORY_HATE_SPEECH" - The harm category is hate speech. + // "HARM_CATEGORY_DANGEROUS_CONTENT" - The harm category is dangerous + // content. + // "HARM_CATEGORY_HARASSMENT" - The harm category is harassment. + // "HARM_CATEGORY_SEXUALLY_EXPLICIT" - The harm category is sexually explicit + // content. + // "HARM_CATEGORY_CIVIC_INTEGRITY" - The harm category is civic integrity. + Category string `json:"category,omitempty"` + // Threshold: Required. The harm block threshold. + // + // Possible values: + // "HARM_BLOCK_THRESHOLD_UNSPECIFIED" - Unspecified harm block threshold. + // "BLOCK_LOW_AND_ABOVE" - Block low threshold and above (i.e. block more). + // "BLOCK_MEDIUM_AND_ABOVE" - Block medium threshold and above. + // "BLOCK_ONLY_HIGH" - Block only high threshold (i.e. block less). + // "BLOCK_NONE" - Block none. + // "OFF" - Turn off the safety filter. + Threshold string `json:"threshold,omitempty"` + // ForceSendFields is a list of field names (e.g. "Category") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Category") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSafetySpecSafetySetting) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSafetySpecSafetySetting + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSearchSpec: Search // specification. type GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSearchSpec struct { @@ -7283,8 +7386,8 @@ type GoogleCloudDiscoveryengineV1alphaCollection struct { // connector on an existing Collection is not supported. This output only field // contains a subset of the DataConnector fields, including `name`, // `data_source`, `entities.entity_name` and `entities.data_store`. To get more - // details about a data connector, use the DataConnector.GetDataConnector - // method. + // details about a data connector, use the + // DataConnectorService.GetDataConnector method. DataConnector *GoogleCloudDiscoveryengineV1alphaDataConnector `json:"dataConnector,omitempty"` // DisplayName: Required. The Collection display name. This field must be a // UTF-8 encoded string with a length limit of 128 characters. Otherwise, an @@ -7753,8 +7856,8 @@ func (s GoogleCloudDiscoveryengineV1alphaControl) MarshalJSON() ([]byte, error) // GoogleCloudDiscoveryengineV1alphaControlBoostAction: Adjusts order of // products in returned list. type GoogleCloudDiscoveryengineV1alphaControlBoostAction struct { - // Boost: Required. Strength of the boost, which should be in [-1, 1]. Negative - // boost means demotion. Default is 0.0 (No-op). + // Boost: Strength of the boost, which should be in [-1, 1]. Negative boost + // means demotion. Default is 0.0 (No-op). Boost float64 `json:"boost,omitempty"` // DataStore: Required. Specifies which data store's documents can be boosted // by this control. Full data store name e.g. @@ -7766,6 +7869,9 @@ type GoogleCloudDiscoveryengineV1alphaControlBoostAction struct { // documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum // length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown. Filter string `json:"filter,omitempty"` + // FixedBoost: Optional. Strength of the boost, which should be in [-1, 1]. + // Negative boost means demotion. Default is 0.0 (No-op). + FixedBoost float64 `json:"fixedBoost,omitempty"` // ForceSendFields is a list of field names (e.g. "Boost") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See @@ -7787,7 +7893,8 @@ func (s GoogleCloudDiscoveryengineV1alphaControlBoostAction) MarshalJSON() ([]by func (s *GoogleCloudDiscoveryengineV1alphaControlBoostAction) UnmarshalJSON(data []byte) error { type NoMethod GoogleCloudDiscoveryengineV1alphaControlBoostAction var s1 struct { - Boost gensupport.JSONFloat64 `json:"boost"` + Boost gensupport.JSONFloat64 `json:"boost"` + FixedBoost gensupport.JSONFloat64 `json:"fixedBoost"` *NoMethod } s1.NoMethod = (*NoMethod)(s) @@ -7795,6 +7902,7 @@ func (s *GoogleCloudDiscoveryengineV1alphaControlBoostAction) UnmarshalJSON(data return err } s.Boost = float64(s1.Boost) + s.FixedBoost = float64(s1.FixedBoost) return nil } @@ -8423,8 +8531,8 @@ func (s GoogleCloudDiscoveryengineV1alphaCustomTuningModel) MarshalJSON() ([]byt // GoogleCloudDiscoveryengineV1alphaDataConnector: Manages the connection to // external data sources for all data stores grouped under a Collection. It's a // singleton resource of Collection. The initialization is only supported -// through SetUpDataConnector method, which will create a new Collection and -// initialize its DataConnector. // +// through DataConnectorService.SetUpDataConnector method, which will create a +// new Collection and initialize its DataConnector. type GoogleCloudDiscoveryengineV1alphaDataConnector struct { // ActionConfig: Optional. Action configurations to make the connector support // actions. @@ -8906,6 +9014,34 @@ func (s GoogleCloudDiscoveryengineV1alphaDeleteEngineMetadata) MarshalJSON() ([] return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaDeleteIdentityMappingStoreMetadata: +// Metadata related to the progress of the +// IdentityMappingStoreService.DeleteIdentityMappingStore operation. This will +// be returned by the google.longrunning.Operation.metadata field. +type GoogleCloudDiscoveryengineV1alphaDeleteIdentityMappingStoreMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + // UpdateTime: Operation last update time. If the operation is done, this is + // also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "CreateTime") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CreateTime") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaDeleteIdentityMappingStoreMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaDeleteIdentityMappingStoreMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaDeleteSchemaMetadata: Metadata for // DeleteSchema LRO. type GoogleCloudDiscoveryengineV1alphaDeleteSchemaMetadata struct { @@ -9114,7 +9250,7 @@ type GoogleCloudDiscoveryengineV1alphaDocument struct { // derived data that are not in the original input document. DerivedStructData googleapi.RawMessage `json:"derivedStructData,omitempty"` // Id: Immutable. The identifier of the document. Id should conform to RFC-1034 - // (https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 + // (https://tools.ietf.org/html/rfc1034) standard with a length limit of 128 // characters. Id string `json:"id,omitempty"` // IndexStatus: Output only. The index status of the document. * If document is @@ -11468,21 +11604,26 @@ func (s GoogleCloudDiscoveryengineV1alphaGuidedSearchSpec) MarshalJSON() ([]byte // GoogleCloudDiscoveryengineV1alphaIdentityScheduleConfig: The configuration // for the identity data synchronization runs. type GoogleCloudDiscoveryengineV1alphaIdentityScheduleConfig struct { + // NextSyncTime: Optional. The UTC time when the next data sync is expected to + // start for the Data Connector. Customers are only able to specify the hour + // and minute to schedule the data sync. This is utilized when the data + // connector has a refresh interval greater than 1 day. + NextSyncTime *GoogleTypeDateTime `json:"nextSyncTime,omitempty"` // RefreshInterval: Optional. The refresh interval to sync the Access Control // List information for the documents ingested by this connector. If not set, // the access control list will be refreshed at the default interval of 30 // minutes. The identity refresh interval can be at least 30 minutes and at // most 7 days. RefreshInterval string `json:"refreshInterval,omitempty"` - // ForceSendFields is a list of field names (e.g. "RefreshInterval") to + // ForceSendFields is a list of field names (e.g. "NextSyncTime") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "RefreshInterval") to include in - // API requests with the JSON null value. By default, fields with empty values - // are omitted from API requests. See + // NullFields is a list of field names (e.g. "NextSyncTime") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -12563,7 +12704,7 @@ func (s GoogleCloudDiscoveryengineV1alphaListEnginesResponse) MarshalJSON() ([]b // GoogleCloudDiscoveryengineV1alphaListEvaluationResultsResponse: Response // message for EvaluationService.ListEvaluationResults method. type GoogleCloudDiscoveryengineV1alphaListEvaluationResultsResponse struct { - // EvaluationResults: The EvaluationResults. + // EvaluationResults: The evaluation results for the SampleQuerys. EvaluationResults []*GoogleCloudDiscoveryengineV1alphaListEvaluationResultsResponseEvaluationResult `json:"evaluationResults,omitempty"` // NextPageToken: A token that can be sent as // ListEvaluationResultsRequest.page_token to retrieve the next page. If this @@ -12938,6 +13079,32 @@ func (s GoogleCloudDiscoveryengineV1alphaNaturalLanguageQueryUnderstandingConfig return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaObtainCrawlRateRequest: Request message for +// CrawlRateManagementService.ObtainCrawlRate method. +type GoogleCloudDiscoveryengineV1alphaObtainCrawlRateRequest struct { + // CrawlRateScope: Required. The scope of the crawl rate that the user wants to + // monitor. Currently, only domain and host name are supported. A domain name + // example: `abc.com`. A host name example: `www.abc.com`. Please do not + // include `/` in the domain or host name. + CrawlRateScope string `json:"crawlRateScope,omitempty"` + // ForceSendFields is a list of field names (e.g. "CrawlRateScope") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CrawlRateScope") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaObtainCrawlRateRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaObtainCrawlRateRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse: Response message // for CrawlRateManagementService.ObtainCrawlRate method. The response contains // organcic or dedicated crawl rate time series data for monitoring, depending @@ -12958,6 +13125,9 @@ type GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse struct { // "SUCCEEDED" - The state is successful. // "FAILED" - The state is failed. State string `json:"state,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. // "DedicatedCrawlRateTimeSeries") to unconditionally include in API requests. // By default, fields with empty or default values are omitted from API @@ -14098,7 +14268,8 @@ func (s GoogleCloudDiscoveryengineV1alphaRecrawlUrisMetadata) MarshalJSON() ([]b // GoogleCloudDiscoveryengineV1alphaRecrawlUrisRequest: Request message for // SiteSearchEngineService.RecrawlUris method. type GoogleCloudDiscoveryengineV1alphaRecrawlUrisRequest struct { - // SiteCredential: Optional. Full resource name of the SiteCredential, such as + // SiteCredential: Optional. Full resource name of the `SiteCredential`, such + // as // `projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine/siteCrede // ntials/*`. Only set to crawl private URIs. SiteCredential string `json:"siteCredential,omitempty"` @@ -14209,6 +14380,95 @@ func (s GoogleCloudDiscoveryengineV1alphaRecrawlUrisResponseFailureInfoFailureRe return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateMetadata: Metadata +// related to the progress of the +// CrawlRateManagementService.RemoveDedicatedCrawlRate operation. This will be +// returned by the google.longrunning.Operation.metadata field. +type GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + // UpdateTime: Operation last update time. If the operation is done, this is + // also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "CreateTime") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CreateTime") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateRequest: Request +// message for CrawlRateManagementService.RemoveDedicatedCrawlRate method. The +// user can remove the dedicated crawl rate for a crawl_rate_scope they own, +// and Google will fall back to organic crawl, and the crawl rate will be +// determined by Google. +type GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateRequest struct { + // CrawlRateScope: Required. The scope of the crawl rate change. Currently, + // only domain and host name are supported. A domain name example: `abc.com`. A + // host name example: `www.abc.com`. Please do not include `/` in the domain or + // host name. + CrawlRateScope string `json:"crawlRateScope,omitempty"` + // ForceSendFields is a list of field names (e.g. "CrawlRateScope") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CrawlRateScope") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateResponse: Response +// message for CrawlRateManagementService.RemoveDedicatedCrawlRate method. It +// simply returns the state of the response, and an error message if the state +// is FAILED. +type GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateResponse struct { + // Error: Errors from service when handling the request. + Error *GoogleRpcStatus `json:"error,omitempty"` + // State: Output only. The state of the response. + // + // Possible values: + // "STATE_UNSPECIFIED" - The state is unspecified. + // "SUCCEEDED" - The state is successful. + // "FAILED" - The state is failed. + State string `json:"state,omitempty"` + // ForceSendFields is a list of field names (e.g. "Error") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Error") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaReply: Defines a reply message to user. type GoogleCloudDiscoveryengineV1alphaReply struct { // References: References in the reply. @@ -14491,6 +14751,80 @@ func (s GoogleCloudDiscoveryengineV1alphaRequirementViolationSamplesBinding) Mar type GoogleCloudDiscoveryengineV1alphaResumeEngineRequest struct { } +// GoogleCloudDiscoveryengineV1alphaSafetyRating: Safety rating corresponding +// to the generated content. +type GoogleCloudDiscoveryengineV1alphaSafetyRating struct { + // Blocked: Output only. Indicates whether the content was filtered out because + // of this rating. + Blocked bool `json:"blocked,omitempty"` + // Category: Output only. Harm category. + // + // Possible values: + // "HARM_CATEGORY_UNSPECIFIED" - The harm category is unspecified. + // "HARM_CATEGORY_HATE_SPEECH" - The harm category is hate speech. + // "HARM_CATEGORY_DANGEROUS_CONTENT" - The harm category is dangerous + // content. + // "HARM_CATEGORY_HARASSMENT" - The harm category is harassment. + // "HARM_CATEGORY_SEXUALLY_EXPLICIT" - The harm category is sexually explicit + // content. + // "HARM_CATEGORY_CIVIC_INTEGRITY" - The harm category is civic integrity. + Category string `json:"category,omitempty"` + // Probability: Output only. Harm probability levels in the content. + // + // Possible values: + // "HARM_PROBABILITY_UNSPECIFIED" - Harm probability unspecified. + // "NEGLIGIBLE" - Negligible level of harm. + // "LOW" - Low level of harm. + // "MEDIUM" - Medium level of harm. + // "HIGH" - High level of harm. + Probability string `json:"probability,omitempty"` + // ProbabilityScore: Output only. Harm probability score. + ProbabilityScore float64 `json:"probabilityScore,omitempty"` + // Severity: Output only. Harm severity levels in the content. + // + // Possible values: + // "HARM_SEVERITY_UNSPECIFIED" - Harm severity unspecified. + // "HARM_SEVERITY_NEGLIGIBLE" - Negligible level of harm severity. + // "HARM_SEVERITY_LOW" - Low level of harm severity. + // "HARM_SEVERITY_MEDIUM" - Medium level of harm severity. + // "HARM_SEVERITY_HIGH" - High level of harm severity. + Severity string `json:"severity,omitempty"` + // SeverityScore: Output only. Harm severity score. + SeverityScore float64 `json:"severityScore,omitempty"` + // ForceSendFields is a list of field names (e.g. "Blocked") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Blocked") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaSafetyRating) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaSafetyRating + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleCloudDiscoveryengineV1alphaSafetyRating) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudDiscoveryengineV1alphaSafetyRating + var s1 struct { + ProbabilityScore gensupport.JSONFloat64 `json:"probabilityScore"` + SeverityScore gensupport.JSONFloat64 `json:"severityScore"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.ProbabilityScore = float64(s1.ProbabilityScore) + s.SeverityScore = float64(s1.SeverityScore) + return nil +} + // GoogleCloudDiscoveryengineV1alphaSampleQuery: Sample Query captures metadata // to be used for evaluation. type GoogleCloudDiscoveryengineV1alphaSampleQuery struct { @@ -15719,10 +16053,10 @@ func (s GoogleCloudDiscoveryengineV1alphaSearchRequestImageQuery) MarshalJSON() // for search requests. type GoogleCloudDiscoveryengineV1alphaSearchRequestNaturalLanguageQueryUnderstandingSpec struct { // FilterExtractionCondition: The condition under which filter extraction - // should occur. Default to Condition.DISABLED. + // should occur. Server behavior defaults to `DISABLED`. // // Possible values: - // "CONDITION_UNSPECIFIED" - Server behavior defaults to Condition.DISABLED. + // "CONDITION_UNSPECIFIED" - Server behavior defaults to `DISABLED`. // "DISABLED" - Disables NL filter extraction. // "ENABLED" - Enables NL filter extraction. FilterExtractionCondition string `json:"filterExtractionCondition,omitempty"` @@ -16863,7 +17197,7 @@ type GoogleCloudDiscoveryengineV1alphaServingConfig struct { // RankingExpression: The ranking expression controls the customized ranking on // retrieval documents. To leverage this, document embedding is required. The // ranking expression setting in ServingConfig applies to all search requests - // served by the serving config. However, if SearchRequest.ranking_expression + // served by the serving config. However, if `SearchRequest.ranking_expression` // is specified, it overrides the ServingConfig ranking expression. The ranking // expression is a single function or multiple functions that are joined by // "+". * ranking_expression = function, { " + ", function }; Supported @@ -17097,6 +17431,122 @@ func (s GoogleCloudDiscoveryengineV1alphaSessionTurn) MarshalJSON() ([]byte, err return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateMetadata: Metadata +// related to the progress of the +// CrawlRateManagementService.SetDedicatedCrawlRate operation. This will be +// returned by the google.longrunning.Operation.metadata field. +type GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + // UpdateTime: Operation last update time. If the operation is done, this is + // also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "CreateTime") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CreateTime") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateRequest: Request +// message for CrawlRateManagementService.SetDedicatedCrawlRate method. The +// user can set the crawl rate for a crawl_rate_scope they own. They can set up +// an overall crawl rate, or set up a user-triggered crawl rate and a +// auto-refresh crawl rate separately. If an overall crawl rate is set, Vertex +// AI will automatically splits crawl_rate into user-triggered and +// auto-refresh. +type GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateRequest struct { + // CrawlRate: Optional. The crawl QPS set by the user. It is not guaranteed + // that Vertex crawl bot will crawl at this QPS. If the crawl rate is too high, + // the real QPS may be lower than the value set by the user to avoid + // overloading the user's website. + CrawlRate int64 `json:"crawlRate,omitempty"` + // CrawlRateScope: Required. The scope of the crawl rate that the user wants to + // config. Currently, only domain and host name are supported. A domain name + // example: `abc.com`. A host name example: `www.abc.com`. Please do not + // include `/` in the domain or host name. + CrawlRateScope string `json:"crawlRateScope,omitempty"` + // CrawlType: Optional. Whether it’s the crawl rate of user-triggered or + // auto-refresh. + // + // Possible values: + // "CRAWL_TYPE_UNSPECIFIED" - The crawl type is unspecified. + // "USER_TRIGGERED" - The crawl type is user-triggered. + // "AUTO_REFRESH" - The crawl type is auto-refresh. + CrawlType string `json:"crawlType,omitempty"` + // Mode: Optional. Whether the rate is explicitly set by users, or set by + // vertex AI. + // + // Possible values: + // "MODE_UNSPECIFIED" - The mode is unspecified. If the user does not specify + // the mode, default to AUTOMATIC. + // "AUTOMATIC" - Vertex AI automatically splits crawl_rate into + // user-triggered and auto-refresh. Users don't need to specify + // SetDedicatedCrawlRateRequest.CrawlType if the mode is AUTOMATIC. + // "EXPLICIT" - Users explicitly set user-triggered or auto-refresh crawl + // rate. + Mode string `json:"mode,omitempty"` + // ForceSendFields is a list of field names (e.g. "CrawlRate") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CrawlRate") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateResponse: Response +// message for CrawlRateManagementService.SetDedicatedCrawlRate method. It +// simply returns the state of the response, and an error message if the state +// is FAILED. +type GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateResponse struct { + // Error: Errors from service when handling the request. + Error *GoogleRpcStatus `json:"error,omitempty"` + // State: Output only. The state of the response. + // + // Possible values: + // "STATE_UNSPECIFIED" - The state is unspecified. + // "SUCCEEDED" - The state is successful. + // "FAILED" - The state is failed. + State string `json:"state,omitempty"` + // ForceSendFields is a list of field names (e.g. "Error") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Error") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaSetUpDataConnectorMetadata: Metadata for // DataConnectorService.SetUpDataConnector method. type GoogleCloudDiscoveryengineV1alphaSetUpDataConnectorMetadata struct { @@ -17365,8 +17815,8 @@ type GoogleCloudDiscoveryengineV1alphaStartConnectorRunRequest struct { Entities []string `json:"entities,omitempty"` // HealthcareFhirResourceTypes: The FHIR resource types to import. The resource // types should be a subset of all supported FHIR resource types - // http://shortn/_J8ymdyOokT. Default to all supported FHIR resource types if - // empty. + // (https://cloud.google.com/generative-ai-app-builder/docs/fhir-schema-reference#resource-level-specification). + // Default to all supported FHIR resource types if empty. HealthcareFhirResourceTypes []string `json:"healthcareFhirResourceTypes,omitempty"` // SyncIdentity: If true, trigger Identity sync. SyncIdentity bool `json:"syncIdentity,omitempty"` @@ -17430,7 +17880,7 @@ func (s GoogleCloudDiscoveryengineV1alphaSuggestionDenyListEntry) MarshalJSON() // GoogleCloudDiscoveryengineV1alphaTargetSite: A target site for the // SiteSearchEngine. type GoogleCloudDiscoveryengineV1alphaTargetSite struct { - // ExactMatch: Input only. If set to false, a uri_pattern is generated to + // ExactMatch: Immutable. If set to false, a uri_pattern is generated to // include all pages whose address contains the provided_uri_pattern. If set to // true, an uri_pattern is generated to try to be an exact match of the // provided_uri_pattern or just the specific page if the provided_uri_pattern @@ -18195,6 +18645,28 @@ func (s GoogleCloudDiscoveryengineV1alphaWorkspaceConfig) MarshalJSON() ([]byte, // GoogleCloudDiscoveryengineV1betaAdvancedSiteSearchConfig: Configuration data // for advance site search. type GoogleCloudDiscoveryengineV1betaAdvancedSiteSearchConfig struct { + // DisableAutomaticRefresh: If set true, automatic refresh is disabled for the + // DataStore. + DisableAutomaticRefresh bool `json:"disableAutomaticRefresh,omitempty"` + // DisableInitialIndex: If set true, initial indexing is disabled for the + // DataStore. + DisableInitialIndex bool `json:"disableInitialIndex,omitempty"` + // ForceSendFields is a list of field names (e.g. "DisableAutomaticRefresh") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "DisableAutomaticRefresh") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1betaAdvancedSiteSearchConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaAdvancedSiteSearchConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } // GoogleCloudDiscoveryengineV1betaBatchCreateTargetSiteMetadata: Metadata @@ -18462,8 +18934,8 @@ func (s GoogleCloudDiscoveryengineV1betaControl) MarshalJSON() ([]byte, error) { // GoogleCloudDiscoveryengineV1betaControlBoostAction: Adjusts order of // products in returned list. type GoogleCloudDiscoveryengineV1betaControlBoostAction struct { - // Boost: Required. Strength of the boost, which should be in [-1, 1]. Negative - // boost means demotion. Default is 0.0 (No-op). + // Boost: Strength of the boost, which should be in [-1, 1]. Negative boost + // means demotion. Default is 0.0 (No-op). Boost float64 `json:"boost,omitempty"` // DataStore: Required. Specifies which data store's documents can be boosted // by this control. Full data store name e.g. @@ -18475,6 +18947,9 @@ type GoogleCloudDiscoveryengineV1betaControlBoostAction struct { // documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum // length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown. Filter string `json:"filter,omitempty"` + // FixedBoost: Optional. Strength of the boost, which should be in [-1, 1]. + // Negative boost means demotion. Default is 0.0 (No-op). + FixedBoost float64 `json:"fixedBoost,omitempty"` // ForceSendFields is a list of field names (e.g. "Boost") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See @@ -18496,7 +18971,8 @@ func (s GoogleCloudDiscoveryengineV1betaControlBoostAction) MarshalJSON() ([]byt func (s *GoogleCloudDiscoveryengineV1betaControlBoostAction) UnmarshalJSON(data []byte) error { type NoMethod GoogleCloudDiscoveryengineV1betaControlBoostAction var s1 struct { - Boost gensupport.JSONFloat64 `json:"boost"` + Boost gensupport.JSONFloat64 `json:"boost"` + FixedBoost gensupport.JSONFloat64 `json:"fixedBoost"` *NoMethod } s1.NoMethod = (*NoMethod)(s) @@ -18504,6 +18980,7 @@ func (s *GoogleCloudDiscoveryengineV1betaControlBoostAction) UnmarshalJSON(data return err } s.Boost = float64(s1.Boost) + s.FixedBoost = float64(s1.FixedBoost) return nil } @@ -18975,6 +19452,34 @@ func (s GoogleCloudDiscoveryengineV1betaDeleteEngineMetadata) MarshalJSON() ([]b return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1betaDeleteIdentityMappingStoreMetadata: Metadata +// related to the progress of the +// IdentityMappingStoreService.DeleteIdentityMappingStore operation. This will +// be returned by the google.longrunning.Operation.metadata field. +type GoogleCloudDiscoveryengineV1betaDeleteIdentityMappingStoreMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + // UpdateTime: Operation last update time. If the operation is done, this is + // also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "CreateTime") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CreateTime") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1betaDeleteIdentityMappingStoreMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaDeleteIdentityMappingStoreMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1betaDeleteSchemaMetadata: Metadata for // DeleteSchema LRO. type GoogleCloudDiscoveryengineV1betaDeleteSchemaMetadata struct { @@ -21460,10 +21965,10 @@ func (s GoogleCloudDiscoveryengineV1betaSearchRequestImageQuery) MarshalJSON() ( // for search requests. type GoogleCloudDiscoveryengineV1betaSearchRequestNaturalLanguageQueryUnderstandingSpec struct { // FilterExtractionCondition: The condition under which filter extraction - // should occur. Default to Condition.DISABLED. + // should occur. Server behavior defaults to `DISABLED`. // // Possible values: - // "CONDITION_UNSPECIFIED" - Server behavior defaults to Condition.DISABLED. + // "CONDITION_UNSPECIFIED" - Server behavior defaults to `DISABLED`. // "DISABLED" - Disables NL filter extraction. // "ENABLED" - Enables NL filter extraction. FilterExtractionCondition string `json:"filterExtractionCondition,omitempty"` @@ -21749,7 +22254,7 @@ func (s GoogleCloudDiscoveryengineV1betaSitemap) MarshalJSON() ([]byte, error) { // GoogleCloudDiscoveryengineV1betaTargetSite: A target site for the // SiteSearchEngine. type GoogleCloudDiscoveryengineV1betaTargetSite struct { - // ExactMatch: Input only. If set to false, a uri_pattern is generated to + // ExactMatch: Immutable. If set to false, a uri_pattern is generated to // include all pages whose address contains the provided_uri_pattern. If set to // true, an uri_pattern is generated to try to be an exact match of the // provided_uri_pattern or just the specific page if the provided_uri_pattern @@ -23347,6 +23852,334 @@ func (c *ProjectsLocationsGetCmekConfigCall) Do(opts ...googleapi.CallOption) (* return ret, nil } +type ProjectsLocationsObtainCrawlRateCall struct { + s *Service + location string + googleclouddiscoveryenginev1alphaobtaincrawlraterequest *GoogleCloudDiscoveryengineV1alphaObtainCrawlRateRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// ObtainCrawlRate: Obtains the time series data of organic or dedicated crawl +// rate for monitoring. When dedicated crawl rate is not set, it will return +// vertex AI's organic crawl rate time series. Organic crawl means Google +// automatically crawl the internet at its own convenience. When dedicated +// crawl rate is set, it will return vertex AI's dedicated crawl rate time +// series. +// +// - location: The location resource where crawl rate management will be +// performed. Format: `projects/{project}/locations/{location}`. +func (r *ProjectsLocationsService) ObtainCrawlRate(location string, googleclouddiscoveryenginev1alphaobtaincrawlraterequest *GoogleCloudDiscoveryengineV1alphaObtainCrawlRateRequest) *ProjectsLocationsObtainCrawlRateCall { + c := &ProjectsLocationsObtainCrawlRateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.location = location + c.googleclouddiscoveryenginev1alphaobtaincrawlraterequest = googleclouddiscoveryenginev1alphaobtaincrawlraterequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsObtainCrawlRateCall) Fields(s ...googleapi.Field) *ProjectsLocationsObtainCrawlRateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsObtainCrawlRateCall) Context(ctx context.Context) *ProjectsLocationsObtainCrawlRateCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsObtainCrawlRateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsObtainCrawlRateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1alphaobtaincrawlraterequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+location}:obtainCrawlRate") + 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{ + "location": c.location, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.obtainCrawlRate", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.obtainCrawlRate" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse.ServerResponse.Head +// er 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 *ProjectsLocationsObtainCrawlRateCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse, 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 := &GoogleCloudDiscoveryengineV1alphaObtainCrawlRateResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.obtainCrawlRate", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsRemoveDedicatedCrawlRateCall struct { + s *Service + location string + googleclouddiscoveryenginev1alpharemovededicatedcrawlraterequest *GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// RemoveDedicatedCrawlRate: Removes the dedicated crawl rate for a +// craw_rate_scope. If the dedicated crawl rate was set, this will disable +// vertex AI's crawl bot from using the dedicated crawl rate for crawling. If +// the dedicated crawl rate was not set, this is a no-op. +// +// - location: The location resource where crawl rate management will be +// performed. Format: `projects/{project}/locations/{location}`. +func (r *ProjectsLocationsService) RemoveDedicatedCrawlRate(location string, googleclouddiscoveryenginev1alpharemovededicatedcrawlraterequest *GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateRequest) *ProjectsLocationsRemoveDedicatedCrawlRateCall { + c := &ProjectsLocationsRemoveDedicatedCrawlRateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.location = location + c.googleclouddiscoveryenginev1alpharemovededicatedcrawlraterequest = googleclouddiscoveryenginev1alpharemovededicatedcrawlraterequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsRemoveDedicatedCrawlRateCall) Fields(s ...googleapi.Field) *ProjectsLocationsRemoveDedicatedCrawlRateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsRemoveDedicatedCrawlRateCall) Context(ctx context.Context) *ProjectsLocationsRemoveDedicatedCrawlRateCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsRemoveDedicatedCrawlRateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsRemoveDedicatedCrawlRateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1alpharemovededicatedcrawlraterequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+location}:removeDedicatedCrawlRate") + 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{ + "location": c.location, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.removeDedicatedCrawlRate", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.removeDedicatedCrawlRate" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleLongrunningOperation.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 *ProjectsLocationsRemoveDedicatedCrawlRateCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, 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 := &GoogleLongrunningOperation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.removeDedicatedCrawlRate", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsSetDedicatedCrawlRateCall struct { + s *Service + location string + googleclouddiscoveryenginev1alphasetdedicatedcrawlraterequest *GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetDedicatedCrawlRate: Sets the dedicated crawl rate for a crawl_rate_scope. +// If the dedicated crawl rate was not set, this will enable vertex AI's crawl +// bot to use the new dedicated crawl rate for crawling. If the dedicated crawl +// rate was set, vertex AI's crawl bot will try to update the rate to the new +// value. If the new value is too high, the crawl bot may crawl at a lower rate +// to avoid overloading the user's website. +// +// - location: The location resource where crawl rate management will be +// performed. Format: `projects/{project}/locations/{location}`. +func (r *ProjectsLocationsService) SetDedicatedCrawlRate(location string, googleclouddiscoveryenginev1alphasetdedicatedcrawlraterequest *GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateRequest) *ProjectsLocationsSetDedicatedCrawlRateCall { + c := &ProjectsLocationsSetDedicatedCrawlRateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.location = location + c.googleclouddiscoveryenginev1alphasetdedicatedcrawlraterequest = googleclouddiscoveryenginev1alphasetdedicatedcrawlraterequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsSetDedicatedCrawlRateCall) Fields(s ...googleapi.Field) *ProjectsLocationsSetDedicatedCrawlRateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsSetDedicatedCrawlRateCall) Context(ctx context.Context) *ProjectsLocationsSetDedicatedCrawlRateCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsSetDedicatedCrawlRateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsSetDedicatedCrawlRateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1alphasetdedicatedcrawlraterequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+location}:setDedicatedCrawlRate") + 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{ + "location": c.location, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.setDedicatedCrawlRate", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.setDedicatedCrawlRate" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleLongrunningOperation.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 *ProjectsLocationsSetDedicatedCrawlRateCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, 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 := &GoogleLongrunningOperation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.setDedicatedCrawlRate", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type ProjectsLocationsSetUpDataConnectorCall struct { s *Service parent string @@ -26685,7 +27518,7 @@ func (r *ProjectsLocationsCollectionsDataStoresBranchesDocumentsService) Create( // whether or not it exists, a `PERMISSION_DENIED` error is returned. This // field must be unique among all Documents with the same parent. Otherwise, an // `ALREADY_EXISTS` error is returned. This field must conform to RFC-1034 -// (https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 +// (https://tools.ietf.org/html/rfc1034) standard with a length limit of 128 // characters. Otherwise, an `INVALID_ARGUMENT` error is returned. func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall) DocumentId(documentId string) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall { c.urlParams_.Set("documentId", documentId) @@ -41929,7 +42762,7 @@ func (r *ProjectsLocationsDataStoresBranchesDocumentsService) Create(parent stri // whether or not it exists, a `PERMISSION_DENIED` error is returned. This // field must be unique among all Documents with the same parent. Otherwise, an // `ALREADY_EXISTS` error is returned. This field must conform to RFC-1034 -// (https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 +// (https://tools.ietf.org/html/rfc1034) standard with a length limit of 128 // characters. Otherwise, an `INVALID_ARGUMENT` error is returned. func (c *ProjectsLocationsDataStoresBranchesDocumentsCreateCall) DocumentId(documentId string) *ProjectsLocationsDataStoresBranchesDocumentsCreateCall { c.urlParams_.Set("documentId", documentId) @@ -50409,8 +51242,9 @@ type ProjectsLocationsEvaluationsListResultsCall struct { // // - evaluation: The evaluation resource name, such as // `projects/{project}/locations/{location}/evaluations/{evaluation}`. If the -// caller does not have permission to list EvaluationResult under this -// evaluation, regardless of whether or not this evaluation set exists, a +// caller does not have permission to list +// ListEvaluationResultsResponse.EvaluationResult under this evaluation, +// regardless of whether or not this evaluation set exists, a // `PERMISSION_DENIED` error is returned. func (r *ProjectsLocationsEvaluationsService) ListResults(evaluation string) *ProjectsLocationsEvaluationsListResultsCall { c := &ProjectsLocationsEvaluationsListResultsCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -50419,9 +51253,10 @@ func (r *ProjectsLocationsEvaluationsService) ListResults(evaluation string) *Pr } // PageSize sets the optional parameter "pageSize": Maximum number of -// EvaluationResult to return. If unspecified, defaults to 100. The maximum -// allowed value is 1000. Values above 1000 will be coerced to 1000. If this -// field is negative, an `INVALID_ARGUMENT` error is returned. +// ListEvaluationResultsResponse.EvaluationResult to return. If unspecified, +// defaults to 100. The maximum allowed value is 1000. Values above 1000 will +// be coerced to 1000. If this field is negative, an `INVALID_ARGUMENT` error +// is returned. func (c *ProjectsLocationsEvaluationsListResultsCall) PageSize(pageSize int64) *ProjectsLocationsEvaluationsListResultsCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c diff --git a/discoveryengine/v1beta/discoveryengine-api.json b/discoveryengine/v1beta/discoveryengine-api.json index c6545fdd4fd..a562ab57c40 100644 --- a/discoveryengine/v1beta/discoveryengine-api.json +++ b/discoveryengine/v1beta/discoveryengine-api.json @@ -600,7 +600,7 @@ ], "parameters": { "documentId": { - "description": "Required. The ID to use for the Document, which becomes the final component of the Document.name. If the caller does not have permission to create the Document, regardless of whether or not it exists, a `PERMISSION_DENIED` error is returned. This field must be unique among all Documents with the same parent. Otherwise, an `ALREADY_EXISTS` error is returned. This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters. Otherwise, an `INVALID_ARGUMENT` error is returned.", + "description": "Required. The ID to use for the Document, which becomes the final component of the Document.name. If the caller does not have permission to create the Document, regardless of whether or not it exists, a `PERMISSION_DENIED` error is returned. This field must be unique among all Documents with the same parent. Otherwise, an `ALREADY_EXISTS` error is returned. This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 128 characters. Otherwise, an `INVALID_ARGUMENT` error is returned.", "location": "query", "type": "string" }, @@ -4427,7 +4427,7 @@ ], "parameters": { "documentId": { - "description": "Required. The ID to use for the Document, which becomes the final component of the Document.name. If the caller does not have permission to create the Document, regardless of whether or not it exists, a `PERMISSION_DENIED` error is returned. This field must be unique among all Documents with the same parent. Otherwise, an `ALREADY_EXISTS` error is returned. This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters. Otherwise, an `INVALID_ARGUMENT` error is returned.", + "description": "Required. The ID to use for the Document, which becomes the final component of the Document.name. If the caller does not have permission to create the Document, regardless of whether or not it exists, a `PERMISSION_DENIED` error is returned. This field must be unique among all Documents with the same parent. Otherwise, an `ALREADY_EXISTS` error is returned. This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 128 characters. Otherwise, an `INVALID_ARGUMENT` error is returned.", "location": "query", "type": "string" }, @@ -6563,14 +6563,14 @@ ], "parameters": { "evaluation": { - "description": "Required. The evaluation resource name, such as `projects/{project}/locations/{location}/evaluations/{evaluation}`. If the caller does not have permission to list EvaluationResult under this evaluation, regardless of whether or not this evaluation set exists, a `PERMISSION_DENIED` error is returned.", + "description": "Required. The evaluation resource name, such as `projects/{project}/locations/{location}/evaluations/{evaluation}`. If the caller does not have permission to list ListEvaluationResultsResponse.EvaluationResult under this evaluation, regardless of whether or not this evaluation set exists, a `PERMISSION_DENIED` error is returned.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/evaluations/[^/]+$", "required": true, "type": "string" }, "pageSize": { - "description": "Maximum number of EvaluationResult to return. If unspecified, defaults to 100. The maximum allowed value is 1000. Values above 1000 will be coerced to 1000. If this field is negative, an `INVALID_ARGUMENT` error is returned.", + "description": "Maximum number of ListEvaluationResultsResponse.EvaluationResult to return. If unspecified, defaults to 100. The maximum allowed value is 1000. Values above 1000 will be coerced to 1000. If this field is negative, an `INVALID_ARGUMENT` error is returned.", "format": "int32", "location": "query", "type": "integer" @@ -7384,7 +7384,7 @@ } } }, - "revision": "20241216", + "revision": "20250107", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiDistribution": { @@ -7762,7 +7762,16 @@ "GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig": { "description": "Configuration data for advance site search.", "id": "GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig", - "properties": {}, + "properties": { + "disableAutomaticRefresh": { + "description": "If set true, automatic refresh is disabled for the DataStore.", + "type": "boolean" + }, + "disableInitialIndex": { + "description": "If set true, initial indexing is disabled for the DataStore.", + "type": "boolean" + } + }, "type": "object" }, "GoogleCloudDiscoveryengineV1BatchCreateTargetSiteMetadata": { @@ -8003,7 +8012,8 @@ "id": "GoogleCloudDiscoveryengineV1ControlBoostAction", "properties": { "boost": { - "description": "Required. Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op).", + "deprecated": true, + "description": "Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op).", "format": "float", "type": "number" }, @@ -8014,6 +8024,11 @@ "filter": { "description": "Required. Specifies which products to apply the boost to. If no filter is provided all products will be boosted (No-op). Syntax documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown.", "type": "string" + }, + "fixedBoost": { + "description": "Optional. Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op).", + "format": "float", + "type": "number" } }, "type": "object" @@ -8342,6 +8357,23 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1DeleteIdentityMappingStoreMetadata": { + "description": "Metadata related to the progress of the IdentityMappingStoreService.DeleteIdentityMappingStore operation. This will be returned by the google.longrunning.Operation.metadata field.", + "id": "GoogleCloudDiscoveryengineV1DeleteIdentityMappingStoreMetadata", + "properties": { + "createTime": { + "description": "Operation create time.", + "format": "google-datetime", + "type": "string" + }, + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1DeleteSchemaMetadata": { "description": "Metadata for DeleteSchema LRO.", "id": "GoogleCloudDiscoveryengineV1DeleteSchemaMetadata", @@ -9417,7 +9449,7 @@ "type": "array" }, "rankingExpression": { - "description": "The ranking expression controls the customized ranking on retrieval documents. To leverage this, document embedding is required. The ranking expression setting in ServingConfig applies to all search requests served by the serving config. However, if SearchRequest.ranking_expression is specified, it overrides the ServingConfig ranking expression. The ranking expression is a single function or multiple functions that are joined by \"+\". * ranking_expression = function, { \" + \", function }; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between embedding_field_path and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`.", + "description": "The ranking expression controls the customized ranking on retrieval documents. To leverage this, document embedding is required. The ranking expression setting in ServingConfig applies to all search requests served by the serving config. However, if `SearchRequest.ranking_expression` is specified, it overrides the ServingConfig ranking expression. The ranking expression is a single function or multiple functions that are joined by \"+\". * ranking_expression = function, { \" + \", function }; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between embedding_field_path and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`.", "type": "string" }, "redirectControlIds": { @@ -9554,7 +9586,7 @@ "id": "GoogleCloudDiscoveryengineV1TargetSite", "properties": { "exactMatch": { - "description": "Input only. If set to false, a uri_pattern is generated to include all pages whose address contains the provided_uri_pattern. If set to true, an uri_pattern is generated to try to be an exact match of the provided_uri_pattern or just the specific page if the provided_uri_pattern is a specific one. provided_uri_pattern is always normalized to generate the URI pattern to be used by the search engine.", + "description": "Immutable. If set to false, a uri_pattern is generated to include all pages whose address contains the provided_uri_pattern. If set to true, an uri_pattern is generated to try to be an exact match of the provided_uri_pattern or just the specific page if the provided_uri_pattern is a specific one. provided_uri_pattern is always normalized to generate the URI pattern to be used by the search engine.", "type": "boolean" }, "failureReason": { @@ -9938,6 +9970,13 @@ }, "type": "array" }, + "safetyRatings": { + "description": "Optional. Safety ratings.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1alphaSafetyRating" + }, + "type": "array" + }, "state": { "description": "The state of the answer generation.", "enum": [ @@ -10480,7 +10519,7 @@ }, "dataConnector": { "$ref": "GoogleCloudDiscoveryengineV1alphaDataConnector", - "description": "Output only. The data connector, if present, manages the connection for data stores in the Collection. To set up the connector, use DataConnectorService.SetUpDataConnector method, which creates a new Collection while setting up the DataConnector singleton resource. Setting up connector on an existing Collection is not supported. This output only field contains a subset of the DataConnector fields, including `name`, `data_source`, `entities.entity_name` and `entities.data_store`. To get more details about a data connector, use the DataConnector.GetDataConnector method.", + "description": "Output only. The data connector, if present, manages the connection for data stores in the Collection. To set up the connector, use DataConnectorService.SetUpDataConnector method, which creates a new Collection while setting up the DataConnector singleton resource. Setting up connector on an existing Collection is not supported. This output only field contains a subset of the DataConnector fields, including `name`, `data_source`, `entities.entity_name` and `entities.data_store`. To get more details about a data connector, use the DataConnectorService.GetDataConnector method.", "readOnly": true }, "displayName": { @@ -10821,7 +10860,8 @@ "id": "GoogleCloudDiscoveryengineV1alphaControlBoostAction", "properties": { "boost": { - "description": "Required. Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op).", + "deprecated": true, + "description": "Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op).", "format": "float", "type": "number" }, @@ -10832,6 +10872,11 @@ "filter": { "description": "Required. Specifies which products to apply the boost to. If no filter is provided all products will be boosted (No-op). Syntax documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown.", "type": "string" + }, + "fixedBoost": { + "description": "Optional. Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op).", + "format": "float", + "type": "number" } }, "type": "object" @@ -11005,7 +11050,7 @@ "type": "object" }, "GoogleCloudDiscoveryengineV1alphaDataConnector": { - "description": "Manages the connection to external data sources for all data stores grouped under a Collection. It's a singleton resource of Collection. The initialization is only supported through SetUpDataConnector method, which will create a new Collection and initialize its DataConnector. //", + "description": "Manages the connection to external data sources for all data stores grouped under a Collection. It's a singleton resource of Collection. The initialization is only supported through DataConnectorService.SetUpDataConnector method, which will create a new Collection and initialize its DataConnector.", "id": "GoogleCloudDiscoveryengineV1alphaDataConnector", "properties": { "actionConfig": { @@ -11452,6 +11497,23 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaDeleteIdentityMappingStoreMetadata": { + "description": "Metadata related to the progress of the IdentityMappingStoreService.DeleteIdentityMappingStore operation. This will be returned by the google.longrunning.Operation.metadata field.", + "id": "GoogleCloudDiscoveryengineV1alphaDeleteIdentityMappingStoreMetadata", + "properties": { + "createTime": { + "description": "Operation create time.", + "format": "google-datetime", + "type": "string" + }, + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaDeleteSchemaMetadata": { "description": "Metadata for DeleteSchema LRO.", "id": "GoogleCloudDiscoveryengineV1alphaDeleteSchemaMetadata", @@ -12346,6 +12408,10 @@ "description": "The configuration for the identity data synchronization runs.", "id": "GoogleCloudDiscoveryengineV1alphaIdentityScheduleConfig", "properties": { + "nextSyncTime": { + "$ref": "GoogleTypeDateTime", + "description": "Optional. The UTC time when the next data sync is expected to start for the Data Connector. Customers are only able to specify the hour and minute to schedule the data sync. This is utilized when the data connector has a refresh interval greater than 1 day." + }, "refreshInterval": { "description": "Optional. The refresh interval to sync the Access Control List information for the documents ingested by this connector. If not set, the access control list will be refreshed at the default interval of 30 minutes. The identity refresh interval can be at least 30 minutes and at most 7 days.", "format": "google-duration", @@ -13245,6 +13311,132 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateMetadata": { + "description": "Metadata related to the progress of the CrawlRateManagementService.RemoveDedicatedCrawlRate operation. This will be returned by the google.longrunning.Operation.metadata field.", + "id": "GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateMetadata", + "properties": { + "createTime": { + "description": "Operation create time.", + "format": "google-datetime", + "type": "string" + }, + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateResponse": { + "description": "Response message for CrawlRateManagementService.RemoveDedicatedCrawlRate method. It simply returns the state of the response, and an error message if the state is FAILED.", + "id": "GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateResponse", + "properties": { + "error": { + "$ref": "GoogleRpcStatus", + "description": "Errors from service when handling the request." + }, + "state": { + "description": "Output only. The state of the response.", + "enum": [ + "STATE_UNSPECIFIED", + "SUCCEEDED", + "FAILED" + ], + "enumDescriptions": [ + "The state is unspecified.", + "The state is successful.", + "The state is failed." + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaSafetyRating": { + "description": "Safety rating corresponding to the generated content.", + "id": "GoogleCloudDiscoveryengineV1alphaSafetyRating", + "properties": { + "blocked": { + "description": "Output only. Indicates whether the content was filtered out because of this rating.", + "readOnly": true, + "type": "boolean" + }, + "category": { + "description": "Output only. Harm category.", + "enum": [ + "HARM_CATEGORY_UNSPECIFIED", + "HARM_CATEGORY_HATE_SPEECH", + "HARM_CATEGORY_DANGEROUS_CONTENT", + "HARM_CATEGORY_HARASSMENT", + "HARM_CATEGORY_SEXUALLY_EXPLICIT", + "HARM_CATEGORY_CIVIC_INTEGRITY" + ], + "enumDescriptions": [ + "The harm category is unspecified.", + "The harm category is hate speech.", + "The harm category is dangerous content.", + "The harm category is harassment.", + "The harm category is sexually explicit content.", + "The harm category is civic integrity." + ], + "readOnly": true, + "type": "string" + }, + "probability": { + "description": "Output only. Harm probability levels in the content.", + "enum": [ + "HARM_PROBABILITY_UNSPECIFIED", + "NEGLIGIBLE", + "LOW", + "MEDIUM", + "HIGH" + ], + "enumDescriptions": [ + "Harm probability unspecified.", + "Negligible level of harm.", + "Low level of harm.", + "Medium level of harm.", + "High level of harm." + ], + "readOnly": true, + "type": "string" + }, + "probabilityScore": { + "description": "Output only. Harm probability score.", + "format": "float", + "readOnly": true, + "type": "number" + }, + "severity": { + "description": "Output only. Harm severity levels in the content.", + "enum": [ + "HARM_SEVERITY_UNSPECIFIED", + "HARM_SEVERITY_NEGLIGIBLE", + "HARM_SEVERITY_LOW", + "HARM_SEVERITY_MEDIUM", + "HARM_SEVERITY_HIGH" + ], + "enumDescriptions": [ + "Harm severity unspecified.", + "Negligible level of harm severity.", + "Low level of harm severity.", + "Medium level of harm severity.", + "High level of harm severity." + ], + "readOnly": true, + "type": "string" + }, + "severityScore": { + "description": "Output only. Harm severity score.", + "format": "float", + "readOnly": true, + "type": "number" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaSchema": { "description": "Defines the structure and layout of a type of document data.", "id": "GoogleCloudDiscoveryengineV1alphaSchema", @@ -13884,14 +14076,14 @@ "id": "GoogleCloudDiscoveryengineV1alphaSearchRequestNaturalLanguageQueryUnderstandingSpec", "properties": { "filterExtractionCondition": { - "description": "The condition under which filter extraction should occur. Default to Condition.DISABLED.", + "description": "The condition under which filter extraction should occur. Server behavior defaults to `DISABLED`.", "enum": [ "CONDITION_UNSPECIFIED", "DISABLED", "ENABLED" ], "enumDescriptions": [ - "Server behavior defaults to Condition.DISABLED.", + "Server behavior defaults to `DISABLED`.", "Disables NL filter extraction.", "Enables NL filter extraction." ], @@ -14085,6 +14277,49 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateMetadata": { + "description": "Metadata related to the progress of the CrawlRateManagementService.SetDedicatedCrawlRate operation. This will be returned by the google.longrunning.Operation.metadata field.", + "id": "GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateMetadata", + "properties": { + "createTime": { + "description": "Operation create time.", + "format": "google-datetime", + "type": "string" + }, + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateResponse": { + "description": "Response message for CrawlRateManagementService.SetDedicatedCrawlRate method. It simply returns the state of the response, and an error message if the state is FAILED.", + "id": "GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateResponse", + "properties": { + "error": { + "$ref": "GoogleRpcStatus", + "description": "Errors from service when handling the request." + }, + "state": { + "description": "Output only. The state of the response.", + "enum": [ + "STATE_UNSPECIFIED", + "SUCCEEDED", + "FAILED" + ], + "enumDescriptions": [ + "The state is unspecified.", + "The state is successful.", + "The state is failed." + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaSetUpDataConnectorMetadata": { "description": "Metadata for DataConnectorService.SetUpDataConnector method.", "id": "GoogleCloudDiscoveryengineV1alphaSetUpDataConnectorMetadata", @@ -14180,7 +14415,7 @@ "id": "GoogleCloudDiscoveryengineV1alphaTargetSite", "properties": { "exactMatch": { - "description": "Input only. If set to false, a uri_pattern is generated to include all pages whose address contains the provided_uri_pattern. If set to true, an uri_pattern is generated to try to be an exact match of the provided_uri_pattern or just the specific page if the provided_uri_pattern is a specific one. provided_uri_pattern is always normalized to generate the URI pattern to be used by the search engine.", + "description": "Immutable. If set to false, a uri_pattern is generated to include all pages whose address contains the provided_uri_pattern. If set to true, an uri_pattern is generated to try to be an exact match of the provided_uri_pattern or just the specific page if the provided_uri_pattern is a specific one. provided_uri_pattern is always normalized to generate the URI pattern to be used by the search engine.", "type": "boolean" }, "failureReason": { @@ -14720,7 +14955,16 @@ "GoogleCloudDiscoveryengineV1betaAdvancedSiteSearchConfig": { "description": "Configuration data for advance site search.", "id": "GoogleCloudDiscoveryengineV1betaAdvancedSiteSearchConfig", - "properties": {}, + "properties": { + "disableAutomaticRefresh": { + "description": "If set true, automatic refresh is disabled for the DataStore.", + "type": "boolean" + }, + "disableInitialIndex": { + "description": "If set true, initial indexing is disabled for the DataStore.", + "type": "boolean" + } + }, "type": "object" }, "GoogleCloudDiscoveryengineV1betaAlloyDbSource": { @@ -14846,6 +15090,13 @@ }, "type": "array" }, + "safetyRatings": { + "description": "Optional. Safety ratings.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1betaSafetyRating" + }, + "type": "array" + }, "state": { "description": "The state of the answer generation.", "enum": [ @@ -15185,6 +15436,60 @@ "enable": { "description": "Enable the safety filtering on the answer response. It is false by default.", "type": "boolean" + }, + "safetySettings": { + "description": "Optional. Safety settings. This settings are effective only when the safety_spec.enable is true.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1betaAnswerQueryRequestSafetySpecSafetySetting" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1betaAnswerQueryRequestSafetySpecSafetySetting": { + "description": "Safety settings.", + "id": "GoogleCloudDiscoveryengineV1betaAnswerQueryRequestSafetySpecSafetySetting", + "properties": { + "category": { + "description": "Required. Harm category.", + "enum": [ + "HARM_CATEGORY_UNSPECIFIED", + "HARM_CATEGORY_HATE_SPEECH", + "HARM_CATEGORY_DANGEROUS_CONTENT", + "HARM_CATEGORY_HARASSMENT", + "HARM_CATEGORY_SEXUALLY_EXPLICIT", + "HARM_CATEGORY_CIVIC_INTEGRITY" + ], + "enumDescriptions": [ + "The harm category is unspecified.", + "The harm category is hate speech.", + "The harm category is dangerous content.", + "The harm category is harassment.", + "The harm category is sexually explicit content.", + "The harm category is civic integrity." + ], + "type": "string" + }, + "threshold": { + "description": "Required. The harm block threshold.", + "enum": [ + "HARM_BLOCK_THRESHOLD_UNSPECIFIED", + "BLOCK_LOW_AND_ABOVE", + "BLOCK_MEDIUM_AND_ABOVE", + "BLOCK_ONLY_HIGH", + "BLOCK_NONE", + "OFF" + ], + "enumDescriptions": [ + "Unspecified harm block threshold.", + "Block low threshold and above (i.e. block more).", + "Block medium threshold and above.", + "Block only high threshold (i.e. block less).", + "Block none.", + "Turn off the safety filter." + ], + "type": "string" } }, "type": "object" @@ -16619,7 +16924,8 @@ "id": "GoogleCloudDiscoveryengineV1betaControlBoostAction", "properties": { "boost": { - "description": "Required. Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op).", + "deprecated": true, + "description": "Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op).", "format": "float", "type": "number" }, @@ -16630,6 +16936,11 @@ "filter": { "description": "Required. Specifies which products to apply the boost to. If no filter is provided all products will be boosted (No-op). Syntax documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown.", "type": "string" + }, + "fixedBoost": { + "description": "Optional. Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0 (No-op).", + "format": "float", + "type": "number" } }, "type": "object" @@ -17251,6 +17562,23 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaDeleteIdentityMappingStoreMetadata": { + "description": "Metadata related to the progress of the IdentityMappingStoreService.DeleteIdentityMappingStore operation. This will be returned by the google.longrunning.Operation.metadata field.", + "id": "GoogleCloudDiscoveryengineV1betaDeleteIdentityMappingStoreMetadata", + "properties": { + "createTime": { + "description": "Operation create time.", + "format": "google-datetime", + "type": "string" + }, + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaDeleteSchemaMetadata": { "description": "Metadata for DeleteSchema LRO.", "id": "GoogleCloudDiscoveryengineV1betaDeleteSchemaMetadata", @@ -17349,7 +17677,7 @@ "type": "object" }, "id": { - "description": "Immutable. The identifier of the document. Id should conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters.", + "description": "Immutable. The identifier of the document. Id should conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 128 characters.", "type": "string" }, "indexStatus": { @@ -19127,7 +19455,7 @@ "id": "GoogleCloudDiscoveryengineV1betaListEvaluationResultsResponse", "properties": { "evaluationResults": { - "description": "The EvaluationResults.", + "description": "The evaluation results for the SampleQuerys.", "items": { "$ref": "GoogleCloudDiscoveryengineV1betaListEvaluationResultsResponseEvaluationResult" }, @@ -19886,7 +20214,7 @@ "id": "GoogleCloudDiscoveryengineV1betaRecrawlUrisRequest", "properties": { "siteCredential": { - "description": "Optional. Full resource name of the SiteCredential, such as `projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine/siteCredentials/*`. Only set to crawl private URIs.", + "description": "Optional. Full resource name of the `SiteCredential`, such as `projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine/siteCredentials/*`. Only set to crawl private URIs.", "type": "string" }, "uris": { @@ -19955,6 +20283,89 @@ "properties": {}, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaSafetyRating": { + "description": "Safety rating corresponding to the generated content.", + "id": "GoogleCloudDiscoveryengineV1betaSafetyRating", + "properties": { + "blocked": { + "description": "Output only. Indicates whether the content was filtered out because of this rating.", + "readOnly": true, + "type": "boolean" + }, + "category": { + "description": "Output only. Harm category.", + "enum": [ + "HARM_CATEGORY_UNSPECIFIED", + "HARM_CATEGORY_HATE_SPEECH", + "HARM_CATEGORY_DANGEROUS_CONTENT", + "HARM_CATEGORY_HARASSMENT", + "HARM_CATEGORY_SEXUALLY_EXPLICIT", + "HARM_CATEGORY_CIVIC_INTEGRITY" + ], + "enumDescriptions": [ + "The harm category is unspecified.", + "The harm category is hate speech.", + "The harm category is dangerous content.", + "The harm category is harassment.", + "The harm category is sexually explicit content.", + "The harm category is civic integrity." + ], + "readOnly": true, + "type": "string" + }, + "probability": { + "description": "Output only. Harm probability levels in the content.", + "enum": [ + "HARM_PROBABILITY_UNSPECIFIED", + "NEGLIGIBLE", + "LOW", + "MEDIUM", + "HIGH" + ], + "enumDescriptions": [ + "Harm probability unspecified.", + "Negligible level of harm.", + "Low level of harm.", + "Medium level of harm.", + "High level of harm." + ], + "readOnly": true, + "type": "string" + }, + "probabilityScore": { + "description": "Output only. Harm probability score.", + "format": "float", + "readOnly": true, + "type": "number" + }, + "severity": { + "description": "Output only. Harm severity levels in the content.", + "enum": [ + "HARM_SEVERITY_UNSPECIFIED", + "HARM_SEVERITY_NEGLIGIBLE", + "HARM_SEVERITY_LOW", + "HARM_SEVERITY_MEDIUM", + "HARM_SEVERITY_HIGH" + ], + "enumDescriptions": [ + "Harm severity unspecified.", + "Negligible level of harm severity.", + "Low level of harm severity.", + "Medium level of harm severity.", + "High level of harm severity." + ], + "readOnly": true, + "type": "string" + }, + "severityScore": { + "description": "Output only. Harm severity score.", + "format": "float", + "readOnly": true, + "type": "number" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaSampleQuery": { "description": "Sample Query captures metadata to be used for evaluation.", "id": "GoogleCloudDiscoveryengineV1betaSampleQuery", @@ -20690,14 +21101,14 @@ "id": "GoogleCloudDiscoveryengineV1betaSearchRequestNaturalLanguageQueryUnderstandingSpec", "properties": { "filterExtractionCondition": { - "description": "The condition under which filter extraction should occur. Default to Condition.DISABLED.", + "description": "The condition under which filter extraction should occur. Server behavior defaults to `DISABLED`.", "enum": [ "CONDITION_UNSPECIFIED", "DISABLED", "ENABLED" ], "enumDescriptions": [ - "Server behavior defaults to Condition.DISABLED.", + "Server behavior defaults to `DISABLED`.", "Disables NL filter extraction.", "Enables NL filter extraction." ], @@ -21535,7 +21946,7 @@ "type": "array" }, "rankingExpression": { - "description": "The ranking expression controls the customized ranking on retrieval documents. To leverage this, document embedding is required. The ranking expression setting in ServingConfig applies to all search requests served by the serving config. However, if SearchRequest.ranking_expression is specified, it overrides the ServingConfig ranking expression. The ranking expression is a single function or multiple functions that are joined by \"+\". * ranking_expression = function, { \" + \", function }; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between embedding_field_path and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`.", + "description": "The ranking expression controls the customized ranking on retrieval documents. To leverage this, document embedding is required. The ranking expression setting in ServingConfig applies to all search requests served by the serving config. However, if `SearchRequest.ranking_expression` is specified, it overrides the ServingConfig ranking expression. The ranking expression is a single function or multiple functions that are joined by \"+\". * ranking_expression = function, { \" + \", function }; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between embedding_field_path and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`.", "type": "string" }, "redirectControlIds": { @@ -21831,7 +22242,7 @@ "id": "GoogleCloudDiscoveryengineV1betaTargetSite", "properties": { "exactMatch": { - "description": "Input only. If set to false, a uri_pattern is generated to include all pages whose address contains the provided_uri_pattern. If set to true, an uri_pattern is generated to try to be an exact match of the provided_uri_pattern or just the specific page if the provided_uri_pattern is a specific one. provided_uri_pattern is always normalized to generate the URI pattern to be used by the search engine.", + "description": "Immutable. If set to false, a uri_pattern is generated to include all pages whose address contains the provided_uri_pattern. If set to true, an uri_pattern is generated to try to be an exact match of the provided_uri_pattern or just the specific page if the provided_uri_pattern is a specific one. provided_uri_pattern is always normalized to generate the URI pattern to be used by the search engine.", "type": "boolean" }, "failureReason": { diff --git a/discoveryengine/v1beta/discoveryengine-gen.go b/discoveryengine/v1beta/discoveryengine-gen.go index 33d6b1684ac..f17f2d1174d 100644 --- a/discoveryengine/v1beta/discoveryengine-gen.go +++ b/discoveryengine/v1beta/discoveryengine-gen.go @@ -1675,6 +1675,28 @@ func (s GoogleCloudDiscoveryengineLoggingSourceLocation) MarshalJSON() ([]byte, // GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig: Configuration data for // advance site search. type GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig struct { + // DisableAutomaticRefresh: If set true, automatic refresh is disabled for the + // DataStore. + DisableAutomaticRefresh bool `json:"disableAutomaticRefresh,omitempty"` + // DisableInitialIndex: If set true, initial indexing is disabled for the + // DataStore. + DisableInitialIndex bool `json:"disableInitialIndex,omitempty"` + // ForceSendFields is a list of field names (e.g. "DisableAutomaticRefresh") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "DisableAutomaticRefresh") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } // GoogleCloudDiscoveryengineV1BatchCreateTargetSiteMetadata: Metadata related @@ -1942,8 +1964,8 @@ func (s GoogleCloudDiscoveryengineV1Control) MarshalJSON() ([]byte, error) { // GoogleCloudDiscoveryengineV1ControlBoostAction: Adjusts order of products in // returned list. type GoogleCloudDiscoveryengineV1ControlBoostAction struct { - // Boost: Required. Strength of the boost, which should be in [-1, 1]. Negative - // boost means demotion. Default is 0.0 (No-op). + // Boost: Strength of the boost, which should be in [-1, 1]. Negative boost + // means demotion. Default is 0.0 (No-op). Boost float64 `json:"boost,omitempty"` // DataStore: Required. Specifies which data store's documents can be boosted // by this control. Full data store name e.g. @@ -1955,6 +1977,9 @@ type GoogleCloudDiscoveryengineV1ControlBoostAction struct { // documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum // length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown. Filter string `json:"filter,omitempty"` + // FixedBoost: Optional. Strength of the boost, which should be in [-1, 1]. + // Negative boost means demotion. Default is 0.0 (No-op). + FixedBoost float64 `json:"fixedBoost,omitempty"` // ForceSendFields is a list of field names (e.g. "Boost") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See @@ -1976,7 +2001,8 @@ func (s GoogleCloudDiscoveryengineV1ControlBoostAction) MarshalJSON() ([]byte, e func (s *GoogleCloudDiscoveryengineV1ControlBoostAction) UnmarshalJSON(data []byte) error { type NoMethod GoogleCloudDiscoveryengineV1ControlBoostAction var s1 struct { - Boost gensupport.JSONFloat64 `json:"boost"` + Boost gensupport.JSONFloat64 `json:"boost"` + FixedBoost gensupport.JSONFloat64 `json:"fixedBoost"` *NoMethod } s1.NoMethod = (*NoMethod)(s) @@ -1984,6 +2010,7 @@ func (s *GoogleCloudDiscoveryengineV1ControlBoostAction) UnmarshalJSON(data []by return err } s.Boost = float64(s1.Boost) + s.FixedBoost = float64(s1.FixedBoost) return nil } @@ -2418,6 +2445,34 @@ func (s GoogleCloudDiscoveryengineV1DeleteEngineMetadata) MarshalJSON() ([]byte, return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1DeleteIdentityMappingStoreMetadata: Metadata +// related to the progress of the +// IdentityMappingStoreService.DeleteIdentityMappingStore operation. This will +// be returned by the google.longrunning.Operation.metadata field. +type GoogleCloudDiscoveryengineV1DeleteIdentityMappingStoreMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + // UpdateTime: Operation last update time. If the operation is done, this is + // also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "CreateTime") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CreateTime") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1DeleteIdentityMappingStoreMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DeleteIdentityMappingStoreMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1DeleteSchemaMetadata: Metadata for DeleteSchema // LRO. type GoogleCloudDiscoveryengineV1DeleteSchemaMetadata struct { @@ -3888,7 +3943,7 @@ type GoogleCloudDiscoveryengineV1ServingConfig struct { // RankingExpression: The ranking expression controls the customized ranking on // retrieval documents. To leverage this, document embedding is required. The // ranking expression setting in ServingConfig applies to all search requests - // served by the serving config. However, if SearchRequest.ranking_expression + // served by the serving config. However, if `SearchRequest.ranking_expression` // is specified, it overrides the ServingConfig ranking expression. The ranking // expression is a single function or multiple functions that are joined by // "+". * ranking_expression = function, { " + ", function }; Supported @@ -4103,7 +4158,7 @@ func (s GoogleCloudDiscoveryengineV1SiteVerificationInfo) MarshalJSON() ([]byte, // GoogleCloudDiscoveryengineV1TargetSite: A target site for the // SiteSearchEngine. type GoogleCloudDiscoveryengineV1TargetSite struct { - // ExactMatch: Input only. If set to false, a uri_pattern is generated to + // ExactMatch: Immutable. If set to false, a uri_pattern is generated to // include all pages whose address contains the provided_uri_pattern. If set to // true, an uri_pattern is generated to try to be an exact match of the // provided_uri_pattern or just the specific page if the provided_uri_pattern @@ -4544,6 +4599,8 @@ type GoogleCloudDiscoveryengineV1alphaAnswer struct { References []*GoogleCloudDiscoveryengineV1alphaAnswerReference `json:"references,omitempty"` // RelatedQuestions: Suggested related questions. RelatedQuestions []string `json:"relatedQuestions,omitempty"` + // SafetyRatings: Optional. Safety ratings. + SafetyRatings []*GoogleCloudDiscoveryengineV1alphaSafetyRating `json:"safetyRatings,omitempty"` // State: The state of the answer generation. // // Possible values: @@ -5274,8 +5331,8 @@ type GoogleCloudDiscoveryengineV1alphaCollection struct { // connector on an existing Collection is not supported. This output only field // contains a subset of the DataConnector fields, including `name`, // `data_source`, `entities.entity_name` and `entities.data_store`. To get more - // details about a data connector, use the DataConnector.GetDataConnector - // method. + // details about a data connector, use the + // DataConnectorService.GetDataConnector method. DataConnector *GoogleCloudDiscoveryengineV1alphaDataConnector `json:"dataConnector,omitempty"` // DisplayName: Required. The Collection display name. This field must be a // UTF-8 encoded string with a length limit of 128 characters. Otherwise, an @@ -5593,8 +5650,8 @@ func (s GoogleCloudDiscoveryengineV1alphaControl) MarshalJSON() ([]byte, error) // GoogleCloudDiscoveryengineV1alphaControlBoostAction: Adjusts order of // products in returned list. type GoogleCloudDiscoveryengineV1alphaControlBoostAction struct { - // Boost: Required. Strength of the boost, which should be in [-1, 1]. Negative - // boost means demotion. Default is 0.0 (No-op). + // Boost: Strength of the boost, which should be in [-1, 1]. Negative boost + // means demotion. Default is 0.0 (No-op). Boost float64 `json:"boost,omitempty"` // DataStore: Required. Specifies which data store's documents can be boosted // by this control. Full data store name e.g. @@ -5606,6 +5663,9 @@ type GoogleCloudDiscoveryengineV1alphaControlBoostAction struct { // documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum // length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown. Filter string `json:"filter,omitempty"` + // FixedBoost: Optional. Strength of the boost, which should be in [-1, 1]. + // Negative boost means demotion. Default is 0.0 (No-op). + FixedBoost float64 `json:"fixedBoost,omitempty"` // ForceSendFields is a list of field names (e.g. "Boost") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See @@ -5627,7 +5687,8 @@ func (s GoogleCloudDiscoveryengineV1alphaControlBoostAction) MarshalJSON() ([]by func (s *GoogleCloudDiscoveryengineV1alphaControlBoostAction) UnmarshalJSON(data []byte) error { type NoMethod GoogleCloudDiscoveryengineV1alphaControlBoostAction var s1 struct { - Boost gensupport.JSONFloat64 `json:"boost"` + Boost gensupport.JSONFloat64 `json:"boost"` + FixedBoost gensupport.JSONFloat64 `json:"fixedBoost"` *NoMethod } s1.NoMethod = (*NoMethod)(s) @@ -5635,6 +5696,7 @@ func (s *GoogleCloudDiscoveryengineV1alphaControlBoostAction) UnmarshalJSON(data return err } s.Boost = float64(s1.Boost) + s.FixedBoost = float64(s1.FixedBoost) return nil } @@ -5935,8 +5997,8 @@ func (s GoogleCloudDiscoveryengineV1alphaCustomFineTuningSpec) MarshalJSON() ([] // GoogleCloudDiscoveryengineV1alphaDataConnector: Manages the connection to // external data sources for all data stores grouped under a Collection. It's a // singleton resource of Collection. The initialization is only supported -// through SetUpDataConnector method, which will create a new Collection and -// initialize its DataConnector. // +// through DataConnectorService.SetUpDataConnector method, which will create a +// new Collection and initialize its DataConnector. type GoogleCloudDiscoveryengineV1alphaDataConnector struct { // ActionConfig: Optional. Action configurations to make the connector support // actions. @@ -6412,6 +6474,34 @@ func (s GoogleCloudDiscoveryengineV1alphaDeleteEngineMetadata) MarshalJSON() ([] return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaDeleteIdentityMappingStoreMetadata: +// Metadata related to the progress of the +// IdentityMappingStoreService.DeleteIdentityMappingStore operation. This will +// be returned by the google.longrunning.Operation.metadata field. +type GoogleCloudDiscoveryengineV1alphaDeleteIdentityMappingStoreMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + // UpdateTime: Operation last update time. If the operation is done, this is + // also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "CreateTime") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CreateTime") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaDeleteIdentityMappingStoreMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaDeleteIdentityMappingStoreMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaDeleteSchemaMetadata: Metadata for // DeleteSchema LRO. type GoogleCloudDiscoveryengineV1alphaDeleteSchemaMetadata struct { @@ -7639,21 +7729,26 @@ func (s GoogleCloudDiscoveryengineV1alphaGetUriPatternDocumentDataResponse) Mars // GoogleCloudDiscoveryengineV1alphaIdentityScheduleConfig: The configuration // for the identity data synchronization runs. type GoogleCloudDiscoveryengineV1alphaIdentityScheduleConfig struct { + // NextSyncTime: Optional. The UTC time when the next data sync is expected to + // start for the Data Connector. Customers are only able to specify the hour + // and minute to schedule the data sync. This is utilized when the data + // connector has a refresh interval greater than 1 day. + NextSyncTime *GoogleTypeDateTime `json:"nextSyncTime,omitempty"` // RefreshInterval: Optional. The refresh interval to sync the Access Control // List information for the documents ingested by this connector. If not set, // the access control list will be refreshed at the default interval of 30 // minutes. The identity refresh interval can be at least 30 minutes and at // most 7 days. RefreshInterval string `json:"refreshInterval,omitempty"` - // ForceSendFields is a list of field names (e.g. "RefreshInterval") to + // ForceSendFields is a list of field names (e.g. "NextSyncTime") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "RefreshInterval") to include in - // API requests with the JSON null value. By default, fields with empty values - // are omitted from API requests. See + // NullFields is a list of field names (e.g. "NextSyncTime") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -8865,6 +8960,140 @@ func (s GoogleCloudDiscoveryengineV1alphaRecrawlUrisResponseFailureInfoFailureRe return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateMetadata: Metadata +// related to the progress of the +// CrawlRateManagementService.RemoveDedicatedCrawlRate operation. This will be +// returned by the google.longrunning.Operation.metadata field. +type GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + // UpdateTime: Operation last update time. If the operation is done, this is + // also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "CreateTime") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CreateTime") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateResponse: Response +// message for CrawlRateManagementService.RemoveDedicatedCrawlRate method. It +// simply returns the state of the response, and an error message if the state +// is FAILED. +type GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateResponse struct { + // Error: Errors from service when handling the request. + Error *GoogleRpcStatus `json:"error,omitempty"` + // State: Output only. The state of the response. + // + // Possible values: + // "STATE_UNSPECIFIED" - The state is unspecified. + // "SUCCEEDED" - The state is successful. + // "FAILED" - The state is failed. + State string `json:"state,omitempty"` + // ForceSendFields is a list of field names (e.g. "Error") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Error") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaRemoveDedicatedCrawlRateResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaSafetyRating: Safety rating corresponding +// to the generated content. +type GoogleCloudDiscoveryengineV1alphaSafetyRating struct { + // Blocked: Output only. Indicates whether the content was filtered out because + // of this rating. + Blocked bool `json:"blocked,omitempty"` + // Category: Output only. Harm category. + // + // Possible values: + // "HARM_CATEGORY_UNSPECIFIED" - The harm category is unspecified. + // "HARM_CATEGORY_HATE_SPEECH" - The harm category is hate speech. + // "HARM_CATEGORY_DANGEROUS_CONTENT" - The harm category is dangerous + // content. + // "HARM_CATEGORY_HARASSMENT" - The harm category is harassment. + // "HARM_CATEGORY_SEXUALLY_EXPLICIT" - The harm category is sexually explicit + // content. + // "HARM_CATEGORY_CIVIC_INTEGRITY" - The harm category is civic integrity. + Category string `json:"category,omitempty"` + // Probability: Output only. Harm probability levels in the content. + // + // Possible values: + // "HARM_PROBABILITY_UNSPECIFIED" - Harm probability unspecified. + // "NEGLIGIBLE" - Negligible level of harm. + // "LOW" - Low level of harm. + // "MEDIUM" - Medium level of harm. + // "HIGH" - High level of harm. + Probability string `json:"probability,omitempty"` + // ProbabilityScore: Output only. Harm probability score. + ProbabilityScore float64 `json:"probabilityScore,omitempty"` + // Severity: Output only. Harm severity levels in the content. + // + // Possible values: + // "HARM_SEVERITY_UNSPECIFIED" - Harm severity unspecified. + // "HARM_SEVERITY_NEGLIGIBLE" - Negligible level of harm severity. + // "HARM_SEVERITY_LOW" - Low level of harm severity. + // "HARM_SEVERITY_MEDIUM" - Medium level of harm severity. + // "HARM_SEVERITY_HIGH" - High level of harm severity. + Severity string `json:"severity,omitempty"` + // SeverityScore: Output only. Harm severity score. + SeverityScore float64 `json:"severityScore,omitempty"` + // ForceSendFields is a list of field names (e.g. "Blocked") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Blocked") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaSafetyRating) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaSafetyRating + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleCloudDiscoveryengineV1alphaSafetyRating) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudDiscoveryengineV1alphaSafetyRating + var s1 struct { + ProbabilityScore gensupport.JSONFloat64 `json:"probabilityScore"` + SeverityScore gensupport.JSONFloat64 `json:"severityScore"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.ProbabilityScore = float64(s1.ProbabilityScore) + s.SeverityScore = float64(s1.SeverityScore) + return nil +} + // GoogleCloudDiscoveryengineV1alphaSchema: Defines the structure and layout of // a type of document data. type GoogleCloudDiscoveryengineV1alphaSchema struct { @@ -9908,10 +10137,10 @@ func (s GoogleCloudDiscoveryengineV1alphaSearchRequestImageQuery) MarshalJSON() // for search requests. type GoogleCloudDiscoveryengineV1alphaSearchRequestNaturalLanguageQueryUnderstandingSpec struct { // FilterExtractionCondition: The condition under which filter extraction - // should occur. Default to Condition.DISABLED. + // should occur. Server behavior defaults to `DISABLED`. // // Possible values: - // "CONDITION_UNSPECIFIED" - Server behavior defaults to Condition.DISABLED. + // "CONDITION_UNSPECIFIED" - Server behavior defaults to `DISABLED`. // "DISABLED" - Disables NL filter extraction. // "ENABLED" - Enables NL filter extraction. FilterExtractionCondition string `json:"filterExtractionCondition,omitempty"` @@ -10182,6 +10411,66 @@ func (s GoogleCloudDiscoveryengineV1alphaSessionTurn) MarshalJSON() ([]byte, err return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateMetadata: Metadata +// related to the progress of the +// CrawlRateManagementService.SetDedicatedCrawlRate operation. This will be +// returned by the google.longrunning.Operation.metadata field. +type GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + // UpdateTime: Operation last update time. If the operation is done, this is + // also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "CreateTime") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CreateTime") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateResponse: Response +// message for CrawlRateManagementService.SetDedicatedCrawlRate method. It +// simply returns the state of the response, and an error message if the state +// is FAILED. +type GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateResponse struct { + // Error: Errors from service when handling the request. + Error *GoogleRpcStatus `json:"error,omitempty"` + // State: Output only. The state of the response. + // + // Possible values: + // "STATE_UNSPECIFIED" - The state is unspecified. + // "SUCCEEDED" - The state is successful. + // "FAILED" - The state is failed. + State string `json:"state,omitempty"` + // ForceSendFields is a list of field names (e.g. "Error") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Error") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaSetDedicatedCrawlRateResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaSetUpDataConnectorMetadata: Metadata for // DataConnectorService.SetUpDataConnector method. type GoogleCloudDiscoveryengineV1alphaSetUpDataConnectorMetadata struct { @@ -10311,7 +10600,7 @@ func (s GoogleCloudDiscoveryengineV1alphaSitemap) MarshalJSON() ([]byte, error) // GoogleCloudDiscoveryengineV1alphaTargetSite: A target site for the // SiteSearchEngine. type GoogleCloudDiscoveryengineV1alphaTargetSite struct { - // ExactMatch: Input only. If set to false, a uri_pattern is generated to + // ExactMatch: Immutable. If set to false, a uri_pattern is generated to // include all pages whose address contains the provided_uri_pattern. If set to // true, an uri_pattern is generated to try to be an exact match of the // provided_uri_pattern or just the specific page if the provided_uri_pattern @@ -11052,6 +11341,28 @@ func (s GoogleCloudDiscoveryengineV1betaAdvancedCompleteQueryResponseRecentSearc // GoogleCloudDiscoveryengineV1betaAdvancedSiteSearchConfig: Configuration data // for advance site search. type GoogleCloudDiscoveryengineV1betaAdvancedSiteSearchConfig struct { + // DisableAutomaticRefresh: If set true, automatic refresh is disabled for the + // DataStore. + DisableAutomaticRefresh bool `json:"disableAutomaticRefresh,omitempty"` + // DisableInitialIndex: If set true, initial indexing is disabled for the + // DataStore. + DisableInitialIndex bool `json:"disableInitialIndex,omitempty"` + // ForceSendFields is a list of field names (e.g. "DisableAutomaticRefresh") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "DisableAutomaticRefresh") to + // include in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1betaAdvancedSiteSearchConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaAdvancedSiteSearchConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } // GoogleCloudDiscoveryengineV1betaAlloyDbSource: AlloyDB source import data @@ -11150,6 +11461,8 @@ type GoogleCloudDiscoveryengineV1betaAnswer struct { References []*GoogleCloudDiscoveryengineV1betaAnswerReference `json:"references,omitempty"` // RelatedQuestions: Suggested related questions. RelatedQuestions []string `json:"relatedQuestions,omitempty"` + // SafetyRatings: Optional. Safety ratings. + SafetyRatings []*GoogleCloudDiscoveryengineV1betaSafetyRating `json:"safetyRatings,omitempty"` // State: The state of the answer generation. // // Possible values: @@ -11654,6 +11967,9 @@ type GoogleCloudDiscoveryengineV1betaAnswerQueryRequestSafetySpec struct { // Enable: Enable the safety filtering on the answer response. It is false by // default. Enable bool `json:"enable,omitempty"` + // SafetySettings: Optional. Safety settings. This settings are effective only + // when the safety_spec.enable is true. + SafetySettings []*GoogleCloudDiscoveryengineV1betaAnswerQueryRequestSafetySpecSafetySetting `json:"safetySettings,omitempty"` // ForceSendFields is a list of field names (e.g. "Enable") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See @@ -11672,6 +11988,49 @@ func (s GoogleCloudDiscoveryengineV1betaAnswerQueryRequestSafetySpec) MarshalJSO return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1betaAnswerQueryRequestSafetySpecSafetySetting: +// Safety settings. +type GoogleCloudDiscoveryengineV1betaAnswerQueryRequestSafetySpecSafetySetting struct { + // Category: Required. Harm category. + // + // Possible values: + // "HARM_CATEGORY_UNSPECIFIED" - The harm category is unspecified. + // "HARM_CATEGORY_HATE_SPEECH" - The harm category is hate speech. + // "HARM_CATEGORY_DANGEROUS_CONTENT" - The harm category is dangerous + // content. + // "HARM_CATEGORY_HARASSMENT" - The harm category is harassment. + // "HARM_CATEGORY_SEXUALLY_EXPLICIT" - The harm category is sexually explicit + // content. + // "HARM_CATEGORY_CIVIC_INTEGRITY" - The harm category is civic integrity. + Category string `json:"category,omitempty"` + // Threshold: Required. The harm block threshold. + // + // Possible values: + // "HARM_BLOCK_THRESHOLD_UNSPECIFIED" - Unspecified harm block threshold. + // "BLOCK_LOW_AND_ABOVE" - Block low threshold and above (i.e. block more). + // "BLOCK_MEDIUM_AND_ABOVE" - Block medium threshold and above. + // "BLOCK_ONLY_HIGH" - Block only high threshold (i.e. block less). + // "BLOCK_NONE" - Block none. + // "OFF" - Turn off the safety filter. + Threshold string `json:"threshold,omitempty"` + // ForceSendFields is a list of field names (e.g. "Category") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Category") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1betaAnswerQueryRequestSafetySpecSafetySetting) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaAnswerQueryRequestSafetySpecSafetySetting + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1betaAnswerQueryRequestSearchSpec: Search // specification. type GoogleCloudDiscoveryengineV1betaAnswerQueryRequestSearchSpec struct { @@ -13618,8 +13977,8 @@ func (s GoogleCloudDiscoveryengineV1betaControl) MarshalJSON() ([]byte, error) { // GoogleCloudDiscoveryengineV1betaControlBoostAction: Adjusts order of // products in returned list. type GoogleCloudDiscoveryengineV1betaControlBoostAction struct { - // Boost: Required. Strength of the boost, which should be in [-1, 1]. Negative - // boost means demotion. Default is 0.0 (No-op). + // Boost: Strength of the boost, which should be in [-1, 1]. Negative boost + // means demotion. Default is 0.0 (No-op). Boost float64 `json:"boost,omitempty"` // DataStore: Required. Specifies which data store's documents can be boosted // by this control. Full data store name e.g. @@ -13631,6 +13990,9 @@ type GoogleCloudDiscoveryengineV1betaControlBoostAction struct { // documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum // length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown. Filter string `json:"filter,omitempty"` + // FixedBoost: Optional. Strength of the boost, which should be in [-1, 1]. + // Negative boost means demotion. Default is 0.0 (No-op). + FixedBoost float64 `json:"fixedBoost,omitempty"` // ForceSendFields is a list of field names (e.g. "Boost") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See @@ -13652,7 +14014,8 @@ func (s GoogleCloudDiscoveryengineV1betaControlBoostAction) MarshalJSON() ([]byt func (s *GoogleCloudDiscoveryengineV1betaControlBoostAction) UnmarshalJSON(data []byte) error { type NoMethod GoogleCloudDiscoveryengineV1betaControlBoostAction var s1 struct { - Boost gensupport.JSONFloat64 `json:"boost"` + Boost gensupport.JSONFloat64 `json:"boost"` + FixedBoost gensupport.JSONFloat64 `json:"fixedBoost"` *NoMethod } s1.NoMethod = (*NoMethod)(s) @@ -13660,6 +14023,7 @@ func (s *GoogleCloudDiscoveryengineV1betaControlBoostAction) UnmarshalJSON(data return err } s.Boost = float64(s1.Boost) + s.FixedBoost = float64(s1.FixedBoost) return nil } @@ -14462,6 +14826,34 @@ func (s GoogleCloudDiscoveryengineV1betaDeleteEngineMetadata) MarshalJSON() ([]b return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1betaDeleteIdentityMappingStoreMetadata: Metadata +// related to the progress of the +// IdentityMappingStoreService.DeleteIdentityMappingStore operation. This will +// be returned by the google.longrunning.Operation.metadata field. +type GoogleCloudDiscoveryengineV1betaDeleteIdentityMappingStoreMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + // UpdateTime: Operation last update time. If the operation is done, this is + // also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "CreateTime") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "CreateTime") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1betaDeleteIdentityMappingStoreMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaDeleteIdentityMappingStoreMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1betaDeleteSchemaMetadata: Metadata for // DeleteSchema LRO. type GoogleCloudDiscoveryengineV1betaDeleteSchemaMetadata struct { @@ -14590,7 +14982,7 @@ type GoogleCloudDiscoveryengineV1betaDocument struct { // derived data that are not in the original input document. DerivedStructData googleapi.RawMessage `json:"derivedStructData,omitempty"` // Id: Immutable. The identifier of the document. Id should conform to RFC-1034 - // (https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 + // (https://tools.ietf.org/html/rfc1034) standard with a length limit of 128 // characters. Id string `json:"id,omitempty"` // IndexStatus: Output only. The index status of the document. * If document is @@ -17202,7 +17594,7 @@ func (s GoogleCloudDiscoveryengineV1betaListEnginesResponse) MarshalJSON() ([]by // GoogleCloudDiscoveryengineV1betaListEvaluationResultsResponse: Response // message for EvaluationService.ListEvaluationResults method. type GoogleCloudDiscoveryengineV1betaListEvaluationResultsResponse struct { - // EvaluationResults: The EvaluationResults. + // EvaluationResults: The evaluation results for the SampleQuerys. EvaluationResults []*GoogleCloudDiscoveryengineV1betaListEvaluationResultsResponseEvaluationResult `json:"evaluationResults,omitempty"` // NextPageToken: A token that can be sent as // ListEvaluationResultsRequest.page_token to retrieve the next page. If this @@ -18401,7 +18793,8 @@ func (s GoogleCloudDiscoveryengineV1betaRecommendResponseRecommendationResult) M // GoogleCloudDiscoveryengineV1betaRecrawlUrisRequest: Request message for // SiteSearchEngineService.RecrawlUris method. type GoogleCloudDiscoveryengineV1betaRecrawlUrisRequest struct { - // SiteCredential: Optional. Full resource name of the SiteCredential, such as + // SiteCredential: Optional. Full resource name of the `SiteCredential`, such + // as // `projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine/siteCrede // ntials/*`. Only set to crawl private URIs. SiteCredential string `json:"siteCredential,omitempty"` @@ -18486,6 +18879,80 @@ func (s GoogleCloudDiscoveryengineV1betaReplyReference) MarshalJSON() ([]byte, e type GoogleCloudDiscoveryengineV1betaResumeEngineRequest struct { } +// GoogleCloudDiscoveryengineV1betaSafetyRating: Safety rating corresponding to +// the generated content. +type GoogleCloudDiscoveryengineV1betaSafetyRating struct { + // Blocked: Output only. Indicates whether the content was filtered out because + // of this rating. + Blocked bool `json:"blocked,omitempty"` + // Category: Output only. Harm category. + // + // Possible values: + // "HARM_CATEGORY_UNSPECIFIED" - The harm category is unspecified. + // "HARM_CATEGORY_HATE_SPEECH" - The harm category is hate speech. + // "HARM_CATEGORY_DANGEROUS_CONTENT" - The harm category is dangerous + // content. + // "HARM_CATEGORY_HARASSMENT" - The harm category is harassment. + // "HARM_CATEGORY_SEXUALLY_EXPLICIT" - The harm category is sexually explicit + // content. + // "HARM_CATEGORY_CIVIC_INTEGRITY" - The harm category is civic integrity. + Category string `json:"category,omitempty"` + // Probability: Output only. Harm probability levels in the content. + // + // Possible values: + // "HARM_PROBABILITY_UNSPECIFIED" - Harm probability unspecified. + // "NEGLIGIBLE" - Negligible level of harm. + // "LOW" - Low level of harm. + // "MEDIUM" - Medium level of harm. + // "HIGH" - High level of harm. + Probability string `json:"probability,omitempty"` + // ProbabilityScore: Output only. Harm probability score. + ProbabilityScore float64 `json:"probabilityScore,omitempty"` + // Severity: Output only. Harm severity levels in the content. + // + // Possible values: + // "HARM_SEVERITY_UNSPECIFIED" - Harm severity unspecified. + // "HARM_SEVERITY_NEGLIGIBLE" - Negligible level of harm severity. + // "HARM_SEVERITY_LOW" - Low level of harm severity. + // "HARM_SEVERITY_MEDIUM" - Medium level of harm severity. + // "HARM_SEVERITY_HIGH" - High level of harm severity. + Severity string `json:"severity,omitempty"` + // SeverityScore: Output only. Harm severity score. + SeverityScore float64 `json:"severityScore,omitempty"` + // ForceSendFields is a list of field names (e.g. "Blocked") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Blocked") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudDiscoveryengineV1betaSafetyRating) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaSafetyRating + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleCloudDiscoveryengineV1betaSafetyRating) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudDiscoveryengineV1betaSafetyRating + var s1 struct { + ProbabilityScore gensupport.JSONFloat64 `json:"probabilityScore"` + SeverityScore gensupport.JSONFloat64 `json:"severityScore"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.ProbabilityScore = float64(s1.ProbabilityScore) + s.SeverityScore = float64(s1.SeverityScore) + return nil +} + // GoogleCloudDiscoveryengineV1betaSampleQuery: Sample Query captures metadata // to be used for evaluation. type GoogleCloudDiscoveryengineV1betaSampleQuery struct { @@ -19709,10 +20176,10 @@ func (s GoogleCloudDiscoveryengineV1betaSearchRequestImageQuery) MarshalJSON() ( // for search requests. type GoogleCloudDiscoveryengineV1betaSearchRequestNaturalLanguageQueryUnderstandingSpec struct { // FilterExtractionCondition: The condition under which filter extraction - // should occur. Default to Condition.DISABLED. + // should occur. Server behavior defaults to `DISABLED`. // // Possible values: - // "CONDITION_UNSPECIFIED" - Server behavior defaults to Condition.DISABLED. + // "CONDITION_UNSPECIFIED" - Server behavior defaults to `DISABLED`. // "DISABLED" - Disables NL filter extraction. // "ENABLED" - Enables NL filter extraction. FilterExtractionCondition string `json:"filterExtractionCondition,omitempty"` @@ -20847,7 +21314,7 @@ type GoogleCloudDiscoveryengineV1betaServingConfig struct { // RankingExpression: The ranking expression controls the customized ranking on // retrieval documents. To leverage this, document embedding is required. The // ranking expression setting in ServingConfig applies to all search requests - // served by the serving config. However, if SearchRequest.ranking_expression + // served by the serving config. However, if `SearchRequest.ranking_expression` // is specified, it overrides the ServingConfig ranking expression. The ranking // expression is a single function or multiple functions that are joined by // "+". * ranking_expression = function, { " + ", function }; Supported @@ -21270,7 +21737,7 @@ func (s GoogleCloudDiscoveryengineV1betaSuggestionDenyListEntry) MarshalJSON() ( // GoogleCloudDiscoveryengineV1betaTargetSite: A target site for the // SiteSearchEngine. type GoogleCloudDiscoveryengineV1betaTargetSite struct { - // ExactMatch: Input only. If set to false, a uri_pattern is generated to + // ExactMatch: Immutable. If set to false, a uri_pattern is generated to // include all pages whose address contains the provided_uri_pattern. If set to // true, an uri_pattern is generated to try to be an exact match of the // provided_uri_pattern or just the specific page if the provided_uri_pattern @@ -24062,7 +24529,7 @@ func (r *ProjectsLocationsCollectionsDataStoresBranchesDocumentsService) Create( // whether or not it exists, a `PERMISSION_DENIED` error is returned. This // field must be unique among all Documents with the same parent. Otherwise, an // `ALREADY_EXISTS` error is returned. This field must conform to RFC-1034 -// (https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 +// (https://tools.ietf.org/html/rfc1034) standard with a length limit of 128 // characters. Otherwise, an `INVALID_ARGUMENT` error is returned. func (c *ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall) DocumentId(documentId string) *ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall { c.urlParams_.Set("documentId", documentId) @@ -38436,7 +38903,7 @@ func (r *ProjectsLocationsDataStoresBranchesDocumentsService) Create(parent stri // whether or not it exists, a `PERMISSION_DENIED` error is returned. This // field must be unique among all Documents with the same parent. Otherwise, an // `ALREADY_EXISTS` error is returned. This field must conform to RFC-1034 -// (https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 +// (https://tools.ietf.org/html/rfc1034) standard with a length limit of 128 // characters. Otherwise, an `INVALID_ARGUMENT` error is returned. func (c *ProjectsLocationsDataStoresBranchesDocumentsCreateCall) DocumentId(documentId string) *ProjectsLocationsDataStoresBranchesDocumentsCreateCall { c.urlParams_.Set("documentId", documentId) @@ -46492,8 +46959,9 @@ type ProjectsLocationsEvaluationsListResultsCall struct { // // - evaluation: The evaluation resource name, such as // `projects/{project}/locations/{location}/evaluations/{evaluation}`. If the -// caller does not have permission to list EvaluationResult under this -// evaluation, regardless of whether or not this evaluation set exists, a +// caller does not have permission to list +// ListEvaluationResultsResponse.EvaluationResult under this evaluation, +// regardless of whether or not this evaluation set exists, a // `PERMISSION_DENIED` error is returned. func (r *ProjectsLocationsEvaluationsService) ListResults(evaluation string) *ProjectsLocationsEvaluationsListResultsCall { c := &ProjectsLocationsEvaluationsListResultsCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -46502,9 +46970,10 @@ func (r *ProjectsLocationsEvaluationsService) ListResults(evaluation string) *Pr } // PageSize sets the optional parameter "pageSize": Maximum number of -// EvaluationResult to return. If unspecified, defaults to 100. The maximum -// allowed value is 1000. Values above 1000 will be coerced to 1000. If this -// field is negative, an `INVALID_ARGUMENT` error is returned. +// ListEvaluationResultsResponse.EvaluationResult to return. If unspecified, +// defaults to 100. The maximum allowed value is 1000. Values above 1000 will +// be coerced to 1000. If this field is negative, an `INVALID_ARGUMENT` error +// is returned. func (c *ProjectsLocationsEvaluationsListResultsCall) PageSize(pageSize int64) *ProjectsLocationsEvaluationsListResultsCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c diff --git a/dns/v1/dns-api.json b/dns/v1/dns-api.json index ba51c634b1d..055878ccd14 100644 --- a/dns/v1/dns-api.json +++ b/dns/v1/dns-api.json @@ -1824,7 +1824,7 @@ } } }, - "revision": "20240719", + "revision": "20250102", "rootUrl": "https://dns.googleapis.com/", "schemas": { "Change": { @@ -2753,6 +2753,10 @@ "description": "A mutable string of at most 1024 characters associated with this resource for the user's convenience. Has no effect on the policy's function.", "type": "string" }, + "dns64Config": { + "$ref": "PolicyDns64Config", + "description": "Configurations related to DNS64 for this Policy." + }, "enableInboundForwarding": { "description": "Allows networks bound to this policy to receive DNS queries sent by VMs or applications over VPN connections. When enabled, a virtual IP address is allocated from each of the subnetworks that are bound to this policy.", "type": "boolean" @@ -2831,6 +2835,35 @@ }, "type": "object" }, + "PolicyDns64Config": { + "description": "DNS64 policies", + "id": "PolicyDns64Config", + "properties": { + "kind": { + "default": "dns#policyDns64Config", + "type": "string" + }, + "scope": { + "$ref": "PolicyDns64ConfigScope", + "description": "The scope to which DNS64 config will be applied to." + } + }, + "type": "object" + }, + "PolicyDns64ConfigScope": { + "id": "PolicyDns64ConfigScope", + "properties": { + "allQueries": { + "description": "Controls whether DNS64 is enabled globally at the network level.", + "type": "boolean" + }, + "kind": { + "default": "dns#policyDns64ConfigScope", + "type": "string" + } + }, + "type": "object" + }, "PolicyNetwork": { "id": "PolicyNetwork", "properties": { diff --git a/dns/v1/dns-gen.go b/dns/v1/dns-gen.go index 469a894d295..021900ca5a7 100644 --- a/dns/v1/dns-gen.go +++ b/dns/v1/dns-gen.go @@ -1680,6 +1680,8 @@ type Policy struct { // this resource for the user's convenience. Has no effect on the policy's // function. Description string `json:"description,omitempty"` + // Dns64Config: Configurations related to DNS64 for this Policy. + Dns64Config *PolicyDns64Config `json:"dns64Config,omitempty"` // EnableInboundForwarding: Allows networks bound to this policy to receive DNS // queries sent by VMs or applications over VPN connections. When enabled, a // virtual IP address is allocated from each of the subnetworks that are bound @@ -1779,6 +1781,51 @@ func (s PolicyAlternativeNameServerConfigTargetNameServer) MarshalJSON() ([]byte return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// PolicyDns64Config: DNS64 policies +type PolicyDns64Config struct { + Kind string `json:"kind,omitempty"` + // Scope: The scope to which DNS64 config will be applied to. + Scope *PolicyDns64ConfigScope `json:"scope,omitempty"` + // ForceSendFields is a list of field names (e.g. "Kind") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Kind") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s PolicyDns64Config) MarshalJSON() ([]byte, error) { + type NoMethod PolicyDns64Config + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type PolicyDns64ConfigScope struct { + // AllQueries: Controls whether DNS64 is enabled globally at the network level. + AllQueries bool `json:"allQueries,omitempty"` + Kind string `json:"kind,omitempty"` + // ForceSendFields is a list of field names (e.g. "AllQueries") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AllQueries") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s PolicyDns64ConfigScope) MarshalJSON() ([]byte, error) { + type NoMethod PolicyDns64ConfigScope + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type PolicyNetwork struct { Kind string `json:"kind,omitempty"` // NetworkUrl: The fully qualified URL of the VPC network to bind to. This diff --git a/dns/v1beta2/dns-api.json b/dns/v1beta2/dns-api.json index 7544acd9cd8..d99e4835e96 100644 --- a/dns/v1beta2/dns-api.json +++ b/dns/v1beta2/dns-api.json @@ -1821,7 +1821,7 @@ } } }, - "revision": "20240719", + "revision": "20250102", "rootUrl": "https://dns.googleapis.com/", "schemas": { "Change": { @@ -2750,6 +2750,10 @@ "description": "A mutable string of at most 1024 characters associated with this resource for the user's convenience. Has no effect on the policy's function.", "type": "string" }, + "dns64Config": { + "$ref": "PolicyDns64Config", + "description": "Configurations related to DNS64 for this Policy." + }, "enableInboundForwarding": { "description": "Allows networks bound to this policy to receive DNS queries sent by VMs or applications over VPN connections. When enabled, a virtual IP address is allocated from each of the subnetworks that are bound to this policy.", "type": "boolean" @@ -2828,6 +2832,35 @@ }, "type": "object" }, + "PolicyDns64Config": { + "description": "DNS64 policies", + "id": "PolicyDns64Config", + "properties": { + "kind": { + "default": "dns#policyDns64Config", + "type": "string" + }, + "scope": { + "$ref": "PolicyDns64ConfigScope", + "description": "The scope to which DNS64 config will be applied to." + } + }, + "type": "object" + }, + "PolicyDns64ConfigScope": { + "id": "PolicyDns64ConfigScope", + "properties": { + "allQueries": { + "description": "Controls whether DNS64 is enabled globally at the network level.", + "type": "boolean" + }, + "kind": { + "default": "dns#policyDns64ConfigScope", + "type": "string" + } + }, + "type": "object" + }, "PolicyNetwork": { "id": "PolicyNetwork", "properties": { diff --git a/dns/v1beta2/dns-gen.go b/dns/v1beta2/dns-gen.go index f4d4e34cf7d..6a86ac0213d 100644 --- a/dns/v1beta2/dns-gen.go +++ b/dns/v1beta2/dns-gen.go @@ -1680,6 +1680,8 @@ type Policy struct { // this resource for the user's convenience. Has no effect on the policy's // function. Description string `json:"description,omitempty"` + // Dns64Config: Configurations related to DNS64 for this Policy. + Dns64Config *PolicyDns64Config `json:"dns64Config,omitempty"` // EnableInboundForwarding: Allows networks bound to this policy to receive DNS // queries sent by VMs or applications over VPN connections. When enabled, a // virtual IP address is allocated from each of the subnetworks that are bound @@ -1779,6 +1781,51 @@ func (s PolicyAlternativeNameServerConfigTargetNameServer) MarshalJSON() ([]byte return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// PolicyDns64Config: DNS64 policies +type PolicyDns64Config struct { + Kind string `json:"kind,omitempty"` + // Scope: The scope to which DNS64 config will be applied to. + Scope *PolicyDns64ConfigScope `json:"scope,omitempty"` + // ForceSendFields is a list of field names (e.g. "Kind") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Kind") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s PolicyDns64Config) MarshalJSON() ([]byte, error) { + type NoMethod PolicyDns64Config + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +type PolicyDns64ConfigScope struct { + // AllQueries: Controls whether DNS64 is enabled globally at the network level. + AllQueries bool `json:"allQueries,omitempty"` + Kind string `json:"kind,omitempty"` + // ForceSendFields is a list of field names (e.g. "AllQueries") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AllQueries") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s PolicyDns64ConfigScope) MarshalJSON() ([]byte, error) { + type NoMethod PolicyDns64ConfigScope + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type PolicyNetwork struct { Kind string `json:"kind,omitempty"` // NetworkUrl: The fully qualified URL of the VPC network to bind to. This diff --git a/eventarc/v1/eventarc-api.json b/eventarc/v1/eventarc-api.json index a2baddb086b..0ff64f19626 100644 --- a/eventarc/v1/eventarc-api.json +++ b/eventarc/v1/eventarc-api.json @@ -1278,6 +1278,97 @@ } } }, + "kafkaSources": { + "methods": { + "getIamPolicy": { + "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/kafkaSources/{kafkaSourcesId}:getIamPolicy", + "httpMethod": "GET", + "id": "eventarc.projects.locations.kafkaSources.getIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "options.requestedPolicyVersion": { + "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", + "format": "int32", + "location": "query", + "type": "integer" + }, + "resource": { + "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/kafkaSources/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/kafkaSources/{kafkaSourcesId}:setIamPolicy", + "httpMethod": "POST", + "id": "eventarc.projects.locations.kafkaSources.setIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/kafkaSources/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:setIamPolicy", + "request": { + "$ref": "SetIamPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/kafkaSources/{kafkaSourcesId}:testIamPermissions", + "httpMethod": "POST", + "id": "eventarc.projects.locations.kafkaSources.testIamPermissions", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/kafkaSources/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:testIamPermissions", + "request": { + "$ref": "TestIamPermissionsRequest" + }, + "response": { + "$ref": "TestIamPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "messageBuses": { "methods": { "create": { @@ -2369,7 +2460,7 @@ } } }, - "revision": "20241203", + "revision": "20250103", "rootUrl": "https://eventarc.googleapis.com/", "schemas": { "AuditConfig": { diff --git a/eventarc/v1/eventarc-gen.go b/eventarc/v1/eventarc-gen.go index 34692fe4c99..0ce9186890d 100644 --- a/eventarc/v1/eventarc-gen.go +++ b/eventarc/v1/eventarc-gen.go @@ -175,6 +175,7 @@ func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { rs.Channels = NewProjectsLocationsChannelsService(s) rs.Enrollments = NewProjectsLocationsEnrollmentsService(s) rs.GoogleApiSources = NewProjectsLocationsGoogleApiSourcesService(s) + rs.KafkaSources = NewProjectsLocationsKafkaSourcesService(s) rs.MessageBuses = NewProjectsLocationsMessageBusesService(s) rs.Operations = NewProjectsLocationsOperationsService(s) rs.Pipelines = NewProjectsLocationsPipelinesService(s) @@ -194,6 +195,8 @@ type ProjectsLocationsService struct { GoogleApiSources *ProjectsLocationsGoogleApiSourcesService + KafkaSources *ProjectsLocationsKafkaSourcesService + MessageBuses *ProjectsLocationsMessageBusesService Operations *ProjectsLocationsOperationsService @@ -241,6 +244,15 @@ type ProjectsLocationsGoogleApiSourcesService struct { s *Service } +func NewProjectsLocationsKafkaSourcesService(s *Service) *ProjectsLocationsKafkaSourcesService { + rs := &ProjectsLocationsKafkaSourcesService{s: s} + return rs +} + +type ProjectsLocationsKafkaSourcesService struct { + s *Service +} + func NewProjectsLocationsMessageBusesService(s *Service) *ProjectsLocationsMessageBusesService { rs := &ProjectsLocationsMessageBusesService{s: s} return rs @@ -6921,6 +6933,353 @@ func (c *ProjectsLocationsGoogleApiSourcesTestIamPermissionsCall) Do(opts ...goo return ret, nil } +type ProjectsLocationsKafkaSourcesGetIamPolicyCall struct { + s *Service + resource string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetIamPolicy: Gets the access control policy for a resource. Returns an +// empty policy if the resource exists and does not have a policy set. +// +// - resource: REQUIRED: The resource for which the policy is being requested. +// See Resource names (https://cloud.google.com/apis/design/resource_names) +// for the appropriate value for this field. +func (r *ProjectsLocationsKafkaSourcesService) GetIamPolicy(resource string) *ProjectsLocationsKafkaSourcesGetIamPolicyCall { + c := &ProjectsLocationsKafkaSourcesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + return c +} + +// OptionsRequestedPolicyVersion sets the optional parameter +// "options.requestedPolicyVersion": The maximum policy version that will be +// used to format the policy. Valid values are 0, 1, and 3. Requests specifying +// an invalid value will be rejected. Requests for policies with any +// conditional role bindings must specify version 3. Policies with no +// conditional role bindings may specify any valid value or leave the field +// unset. The policy in the response might use the policy version that you +// specified, or it might use a lower policy version. For example, if you +// specify version 3, but the policy has no conditional role bindings, the +// response uses version 1. To learn which resources support conditions in +// their IAM policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +func (c *ProjectsLocationsKafkaSourcesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsKafkaSourcesGetIamPolicyCall { + c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsKafkaSourcesGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsKafkaSourcesGetIamPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets an optional parameter which makes the operation fail if the +// object's ETag matches the given value. This is useful for getting updates +// only after the object has changed since the last request. +func (c *ProjectsLocationsKafkaSourcesGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsKafkaSourcesGetIamPolicyCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsKafkaSourcesGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsKafkaSourcesGetIamPolicyCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsKafkaSourcesGetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsKafkaSourcesGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:getIamPolicy") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, nil) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "resource": c.resource, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "eventarc.projects.locations.kafkaSources.getIamPolicy", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "eventarc.projects.locations.kafkaSources.getIamPolicy" call. +// Any non-2xx status code is an error. Response headers are in either +// *Policy.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 *ProjectsLocationsKafkaSourcesGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, 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 := &Policy{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "eventarc.projects.locations.kafkaSources.getIamPolicy", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsKafkaSourcesSetIamPolicyCall struct { + s *Service + resource string + setiampolicyrequest *SetIamPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetIamPolicy: Sets the access control policy on the specified resource. +// Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, +// and `PERMISSION_DENIED` errors. +// +// - resource: REQUIRED: The resource for which the policy is being specified. +// See Resource names (https://cloud.google.com/apis/design/resource_names) +// for the appropriate value for this field. +func (r *ProjectsLocationsKafkaSourcesService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsKafkaSourcesSetIamPolicyCall { + c := &ProjectsLocationsKafkaSourcesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.setiampolicyrequest = setiampolicyrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsKafkaSourcesSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsKafkaSourcesSetIamPolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsKafkaSourcesSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsKafkaSourcesSetIamPolicyCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsKafkaSourcesSetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsKafkaSourcesSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.setiampolicyrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:setIamPolicy") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "resource": c.resource, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "eventarc.projects.locations.kafkaSources.setIamPolicy", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "eventarc.projects.locations.kafkaSources.setIamPolicy" call. +// Any non-2xx status code is an error. Response headers are in either +// *Policy.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 *ProjectsLocationsKafkaSourcesSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, 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 := &Policy{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "eventarc.projects.locations.kafkaSources.setIamPolicy", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsKafkaSourcesTestIamPermissionsCall struct { + s *Service + resource string + testiampermissionsrequest *TestIamPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// TestIamPermissions: Returns permissions that a caller has on the specified +// resource. If the resource does not exist, this will return an empty set of +// permissions, not a `NOT_FOUND` error. Note: This operation is designed to be +// used for building permission-aware UIs and command-line tools, not for +// authorization checking. This operation may "fail open" without warning. +// +// - resource: REQUIRED: The resource for which the policy detail is being +// requested. See Resource names +// (https://cloud.google.com/apis/design/resource_names) for the appropriate +// value for this field. +func (r *ProjectsLocationsKafkaSourcesService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsKafkaSourcesTestIamPermissionsCall { + c := &ProjectsLocationsKafkaSourcesTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.testiampermissionsrequest = testiampermissionsrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsKafkaSourcesTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsKafkaSourcesTestIamPermissionsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsKafkaSourcesTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsKafkaSourcesTestIamPermissionsCall { + c.ctx_ = ctx + return c +} + +// Header returns a http.Header that can be modified by the caller to add +// headers to the request. +func (c *ProjectsLocationsKafkaSourcesTestIamPermissionsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsKafkaSourcesTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.testiampermissionsrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:testIamPermissions") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "resource": c.resource, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "eventarc.projects.locations.kafkaSources.testIamPermissions", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "eventarc.projects.locations.kafkaSources.testIamPermissions" call. +// Any non-2xx status code is an error. Response headers are in either +// *TestIamPermissionsResponse.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 *ProjectsLocationsKafkaSourcesTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestIamPermissionsResponse, 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 := &TestIamPermissionsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + b, err := gensupport.DecodeResponseBytes(target, res) + if err != nil { + return nil, err + } + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "eventarc.projects.locations.kafkaSources.testIamPermissions", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type ProjectsLocationsMessageBusesCreateCall struct { s *Service parent string diff --git a/firebaseml/v2beta/firebaseml-api.json b/firebaseml/v2beta/firebaseml-api.json index 5a549333a01..0834a228009 100644 --- a/firebaseml/v2beta/firebaseml-api.json +++ b/firebaseml/v2beta/firebaseml-api.json @@ -206,7 +206,7 @@ } } }, - "revision": "20241217", + "revision": "20241231", "rootUrl": "https://firebaseml.googleapis.com/", "schemas": { "Date": { @@ -1307,6 +1307,21 @@ }, "type": "object" }, + "GoogleCloudAiplatformV1beta1RetrievalConfig": { + "description": "Retrieval config.", + "id": "GoogleCloudAiplatformV1beta1RetrievalConfig", + "properties": { + "languageCode": { + "description": "The language code of the user.", + "type": "string" + }, + "latLng": { + "$ref": "LatLng", + "description": "The location of the user." + } + }, + "type": "object" + }, "GoogleCloudAiplatformV1beta1RetrievalMetadata": { "description": "Metadata related to retrieval in the grounding flow.", "id": "GoogleCloudAiplatformV1beta1RetrievalMetadata", @@ -1699,6 +1714,10 @@ "functionCallingConfig": { "$ref": "GoogleCloudAiplatformV1beta1FunctionCallingConfig", "description": "Optional. Function calling config." + }, + "retrievalConfig": { + "$ref": "GoogleCloudAiplatformV1beta1RetrievalConfig", + "description": "Optional. Retrieval config." } }, "type": "object" @@ -1804,6 +1823,23 @@ }, "type": "object" }, + "LatLng": { + "description": "An object that represents a latitude/longitude pair. This is expressed as a pair of doubles to represent degrees latitude and degrees longitude. Unless specified otherwise, this object must conform to the WGS84 standard. Values must be within normalized ranges.", + "id": "LatLng", + "properties": { + "latitude": { + "description": "The latitude in degrees. It must be in the range [-90.0, +90.0].", + "format": "double", + "type": "number" + }, + "longitude": { + "description": "The longitude in degrees. It must be in the range [-180.0, +180.0].", + "format": "double", + "type": "number" + } + }, + "type": "object" + }, "ModelOperationMetadata": { "description": "This is returned in the longrunning operations for create/update.", "id": "ModelOperationMetadata", diff --git a/firebaseml/v2beta/firebaseml-gen.go b/firebaseml/v2beta/firebaseml-gen.go index ae73273224e..571cab3dac6 100644 --- a/firebaseml/v2beta/firebaseml-gen.go +++ b/firebaseml/v2beta/firebaseml-gen.go @@ -1681,6 +1681,30 @@ func (s GoogleCloudAiplatformV1beta1Retrieval) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudAiplatformV1beta1RetrievalConfig: Retrieval config. +type GoogleCloudAiplatformV1beta1RetrievalConfig struct { + // LanguageCode: The language code of the user. + LanguageCode string `json:"languageCode,omitempty"` + // LatLng: The location of the user. + LatLng *LatLng `json:"latLng,omitempty"` + // ForceSendFields is a list of field names (e.g. "LanguageCode") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "LanguageCode") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudAiplatformV1beta1RetrievalConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1beta1RetrievalConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAiplatformV1beta1RetrievalMetadata: Metadata related to retrieval // in the grounding flow. type GoogleCloudAiplatformV1beta1RetrievalMetadata struct { @@ -2093,6 +2117,8 @@ type GoogleCloudAiplatformV1beta1ToolCodeExecution struct { type GoogleCloudAiplatformV1beta1ToolConfig struct { // FunctionCallingConfig: Optional. Function calling config. FunctionCallingConfig *GoogleCloudAiplatformV1beta1FunctionCallingConfig `json:"functionCallingConfig,omitempty"` + // RetrievalConfig: Optional. Retrieval config. + RetrievalConfig *GoogleCloudAiplatformV1beta1RetrievalConfig `json:"retrievalConfig,omitempty"` // ForceSendFields is a list of field names (e.g. "FunctionCallingConfig") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -2267,6 +2293,50 @@ func (s GoogleCloudAiplatformV1beta1VoiceConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// LatLng: An object that represents a latitude/longitude pair. This is +// expressed as a pair of doubles to represent degrees latitude and degrees +// longitude. Unless specified otherwise, this object must conform to the WGS84 +// standard. Values must be within normalized ranges. +type LatLng struct { + // Latitude: The latitude in degrees. It must be in the range [-90.0, +90.0]. + Latitude float64 `json:"latitude,omitempty"` + // Longitude: The longitude in degrees. It must be in the range [-180.0, + // +180.0]. + Longitude float64 `json:"longitude,omitempty"` + // ForceSendFields is a list of field names (e.g. "Latitude") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Latitude") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s LatLng) MarshalJSON() ([]byte, error) { + type NoMethod LatLng + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *LatLng) UnmarshalJSON(data []byte) error { + type NoMethod LatLng + var s1 struct { + Latitude gensupport.JSONFloat64 `json:"latitude"` + Longitude gensupport.JSONFloat64 `json:"longitude"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Latitude = float64(s1.Latitude) + s.Longitude = float64(s1.Longitude) + return nil +} + // ModelOperationMetadata: This is returned in the longrunning operations for // create/update. type ModelOperationMetadata struct { diff --git a/gkebackup/v1/gkebackup-api.json b/gkebackup/v1/gkebackup-api.json index 47278945b0e..83ec59370a8 100644 --- a/gkebackup/v1/gkebackup-api.json +++ b/gkebackup/v1/gkebackup-api.json @@ -1713,7 +1713,7 @@ } } }, - "revision": "20241203", + "revision": "20250101", "rootUrl": "https://gkebackup.googleapis.com/", "schemas": { "AuditConfig": { @@ -1914,7 +1914,7 @@ "type": "string" }, "stateReason": { - "description": "Output only. Human-readable description of why the backup is in the current `state`.", + "description": "Output only. Human-readable description of why the backup is in the current `state`. This field is only meant for human readability and should not be used programmatically as this field is not guaranteed to be consistent.", "readOnly": true, "type": "string" }, @@ -2065,7 +2065,7 @@ "type": "string" }, "stateReason": { - "description": "Output only. Human-readable description of why BackupPlan is in the current `state`", + "description": "Output only. Human-readable description of why BackupPlan is in the current `state`. This field is only meant for human readability and should not be used programmatically as this field is not guaranteed to be consistent.", "readOnly": true, "type": "string" }, @@ -2887,7 +2887,7 @@ "type": "string" }, "stateReason": { - "description": "Output only. Human-readable description of why the Restore is in its current state.", + "description": "Output only. Human-readable description of why the Restore is in its current state. This field is only meant for human readability and should not be used programmatically as this field is not guaranteed to be consistent.", "readOnly": true, "type": "string" }, @@ -3101,7 +3101,7 @@ "type": "string" }, "stateReason": { - "description": "Output only. Human-readable description of why RestorePlan is in the current `state`", + "description": "Output only. Human-readable description of why RestorePlan is in the current `state`. This field is only meant for human readability and should not be used programmatically as this field is not guaranteed to be consistent.", "readOnly": true, "type": "string" }, @@ -3425,7 +3425,7 @@ "type": "string" }, "stateMessage": { - "description": "Output only. A human readable message explaining why the VolumeBackup is in its current state.", + "description": "Output only. A human readable message explaining why the VolumeBackup is in its current state. This field is only meant for human consumption and should not be used programmatically as this field is not guaranteed to be consistent.", "readOnly": true, "type": "string" }, diff --git a/gkebackup/v1/gkebackup-gen.go b/gkebackup/v1/gkebackup-gen.go index b502b3b9bb8..c767cf9011d 100644 --- a/gkebackup/v1/gkebackup-gen.go +++ b/gkebackup/v1/gkebackup-gen.go @@ -442,7 +442,9 @@ type Backup struct { // process of being deleted. State string `json:"state,omitempty"` // StateReason: Output only. Human-readable description of why the backup is in - // the current `state`. + // the current `state`. This field is only meant for human readability and + // should not be used programmatically as this field is not guaranteed to be + // consistent. StateReason string `json:"stateReason,omitempty"` // Uid: Output only. Server generated global unique identifier of UUID4 // (https://en.wikipedia.org/wiki/Universally_unique_identifier) @@ -586,7 +588,9 @@ type BackupPlan struct { // "DELETING" - The BackupPlan is in the process of being deleted. State string `json:"state,omitempty"` // StateReason: Output only. Human-readable description of why BackupPlan is in - // the current `state` + // the current `state`. This field is only meant for human readability and + // should not be used programmatically as this field is not guaranteed to be + // consistent. StateReason string `json:"stateReason,omitempty"` // Uid: Output only. Server generated global unique identifier of UUID // (https://en.wikipedia.org/wiki/Universally_unique_identifier) format. @@ -1817,7 +1821,9 @@ type Restore struct { // validated. State string `json:"state,omitempty"` // StateReason: Output only. Human-readable description of why the Restore is - // in its current state. + // in its current state. This field is only meant for human readability and + // should not be used programmatically as this field is not guaranteed to be + // consistent. StateReason string `json:"stateReason,omitempty"` // Uid: Output only. Server generated global unique identifier of UUID // (https://en.wikipedia.org/wiki/Universally_unique_identifier) format. @@ -2065,7 +2071,9 @@ type RestorePlan struct { // "DELETING" - The RestorePlan is in the process of being deleted. State string `json:"state,omitempty"` // StateReason: Output only. Human-readable description of why RestorePlan is - // in the current `state` + // in the current `state`. This field is only meant for human readability and + // should not be used programmatically as this field is not guaranteed to be + // consistent. StateReason string `json:"stateReason,omitempty"` // Uid: Output only. Server generated global unique identifier of UUID // (https://en.wikipedia.org/wiki/Universally_unique_identifier) format. @@ -2531,7 +2539,9 @@ type VolumeBackup struct { // in the process of being deleted. State string `json:"state,omitempty"` // StateMessage: Output only. A human readable message explaining why the - // VolumeBackup is in its current state. + // VolumeBackup is in its current state. This field is only meant for human + // consumption and should not be used programmatically as this field is not + // guaranteed to be consistent. StateMessage string `json:"stateMessage,omitempty"` // StorageBytes: Output only. The aggregate size of the underlying artifacts // associated with this VolumeBackup in the backup storage. This may change diff --git a/gkehub/v1alpha/gkehub-api.json b/gkehub/v1alpha/gkehub-api.json index 1fdf5c5857d..8dabae5f0d8 100644 --- a/gkehub/v1alpha/gkehub-api.json +++ b/gkehub/v1alpha/gkehub-api.json @@ -2255,7 +2255,7 @@ } } }, - "revision": "20241206", + "revision": "20250103", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AnthosObservabilityFeatureSpec": { @@ -2992,36 +2992,36 @@ "properties": { "allowVerticalScale": { "deprecated": true, - "description": "Set to true to allow the vertical scaling. Defaults to false which disallows vertical scaling. This field is deprecated.", + "description": "Optional. Set to true to allow the vertical scaling. Defaults to false which disallows vertical scaling. This field is deprecated.", "type": "boolean" }, "enabled": { - "description": "Enables the installation of ConfigSync. If set to true, ConfigSync resources will be created and the other ConfigSync fields will be applied if exist. If set to false, all other ConfigSync fields will be ignored, ConfigSync resources will be deleted. If omitted, ConfigSync resources will be managed depends on the presence of the git or oci field.", + "description": "Optional. Enables the installation of ConfigSync. If set to true, ConfigSync resources will be created and the other ConfigSync fields will be applied if exist. If set to false, all other ConfigSync fields will be ignored, ConfigSync resources will be deleted. If omitted, ConfigSync resources will be managed depends on the presence of the git or oci field.", "type": "boolean" }, "git": { "$ref": "ConfigManagementGitConfig", - "description": "Git repo configuration for the cluster." + "description": "Optional. Git repo configuration for the cluster." }, "metricsGcpServiceAccountEmail": { "deprecated": true, - "description": "The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.", + "description": "Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.", "type": "string" }, "oci": { "$ref": "ConfigManagementOciConfig", - "description": "OCI repo configuration for the cluster" + "description": "Optional. OCI repo configuration for the cluster" }, "preventDrift": { - "description": "Set to true to enable the Config Sync admission webhook to prevent drifts. If set to `false`, disables the Config Sync admission webhook and does not prevent drifts.", + "description": "Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to `false`, disables the Config Sync admission webhook and does not prevent drifts.", "type": "boolean" }, "sourceFormat": { - "description": "Specifies whether the Config Sync Repo is in \"hierarchical\" or \"unstructured\" mode.", + "description": "Optional. Specifies whether the Config Sync Repo is in \"hierarchical\" or \"unstructured\" mode.", "type": "string" }, "stopSyncing": { - "description": "Set to true to stop syncing configs for a single cluster. Default to false.", + "description": "Optional. Set to true to stop syncing configs for a single cluster. Default to false.", "type": "boolean" } }, @@ -3212,7 +3212,7 @@ "id": "ConfigManagementConfigSyncState", "properties": { "clusterLevelStopSyncingState": { - "description": "Whether syncing resources to the cluster is stopped at the cluster level.", + "description": "Output only. Whether syncing resources to the cluster is stopped at the cluster level.", "enum": [ "STOP_SYNCING_STATE_UNSPECIFIED", "NOT_STOPPED", @@ -3225,6 +3225,7 @@ "Some reconcilers stop syncing resources to the cluster, while others are still syncing.", "Syncing resources to the cluster is stopped at the cluster level." ], + "readOnly": true, "type": "string" }, "crCount": { @@ -3235,17 +3236,19 @@ }, "deploymentState": { "$ref": "ConfigManagementConfigSyncDeploymentState", - "description": "Information about the deployment of ConfigSync, including the version of the various Pods deployed" + "description": "Output only. Information about the deployment of ConfigSync, including the version of the various Pods deployed", + "readOnly": true }, "errors": { - "description": "Errors pertaining to the installation of Config Sync.", + "description": "Output only. Errors pertaining to the installation of Config Sync.", "items": { "$ref": "ConfigManagementConfigSyncError" }, + "readOnly": true, "type": "array" }, "reposyncCrd": { - "description": "The state of the Reposync CRD", + "description": "Output only. The state of the Reposync CRD", "enum": [ "CRD_STATE_UNSPECIFIED", "NOT_INSTALLED", @@ -3260,10 +3263,11 @@ "CRD is terminating (i.e., it has been deleted and is cleaning up)", "CRD is installing" ], + "readOnly": true, "type": "string" }, "rootsyncCrd": { - "description": "The state of the RootSync CRD", + "description": "Output only. The state of the RootSync CRD", "enum": [ "CRD_STATE_UNSPECIFIED", "NOT_INSTALLED", @@ -3278,10 +3282,11 @@ "CRD is terminating (i.e., it has been deleted and is cleaning up)", "CRD is installing" ], + "readOnly": true, "type": "string" }, "state": { - "description": "The state of CS This field summarizes the other fields in this message.", + "description": "Output only. The state of CS This field summarizes the other fields in this message.", "enum": [ "STATE_UNSPECIFIED", "CONFIG_SYNC_NOT_INSTALLED", @@ -3296,15 +3301,18 @@ "CS encounters errors.", "CS is installing or terminating." ], + "readOnly": true, "type": "string" }, "syncState": { "$ref": "ConfigManagementSyncState", - "description": "The state of ConfigSync's process to sync configs to a cluster" + "description": "Output only. The state of ConfigSync's process to sync configs to a cluster", + "readOnly": true }, "version": { "$ref": "ConfigManagementConfigSyncVersion", - "description": "The version of ConfigSync deployed" + "description": "Output only. The version of ConfigSync deployed", + "readOnly": true } }, "type": "object" @@ -3441,35 +3449,35 @@ "id": "ConfigManagementGitConfig", "properties": { "gcpServiceAccountEmail": { - "description": "The Google Cloud Service Account Email used for auth when secret_type is gcpServiceAccount.", + "description": "Optional. The Google Cloud Service Account Email used for auth when secret_type is gcpServiceAccount.", "type": "string" }, "httpsProxy": { - "description": "URL for the HTTPS proxy to be used when communicating with the Git repo.", + "description": "Optional. URL for the HTTPS proxy to be used when communicating with the Git repo.", "type": "string" }, "policyDir": { - "description": "The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.", + "description": "Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.", "type": "string" }, "secretType": { - "description": "Type of secret configured for access to the Git repo. Must be one of ssh, cookiefile, gcenode, token, gcpserviceaccount or none. The validation of this is case-sensitive. Required.", + "description": "Required. Type of secret configured for access to the Git repo. Must be one of ssh, cookiefile, gcenode, token, gcpserviceaccount or none. The validation of this is case-sensitive. Required.", "type": "string" }, "syncBranch": { - "description": "The branch of the repository to sync from. Default: master.", + "description": "Optional. The branch of the repository to sync from. Default: master.", "type": "string" }, "syncRepo": { - "description": "The URL of the Git repository to use as the source of truth.", + "description": "Optional. The URL of the Git repository to use as the source of truth.", "type": "string" }, "syncRev": { - "description": "Git revision (tag or hash) to check out. Default HEAD.", + "description": "Optional. Git revision (tag or hash) to check out. Default HEAD.", "type": "string" }, "syncWaitSecs": { - "description": "Period in seconds between consecutive syncs. Default: 15.", + "description": "Optional. Period in seconds between consecutive syncs. Default: 15.", "format": "int64", "type": "string" } @@ -3605,22 +3613,23 @@ "binauthz": { "$ref": "ConfigManagementBinauthzConfig", "deprecated": true, - "description": "Binauthz conifguration for the cluster. Deprecated: This field will be ignored and should not be set." + "description": "Optional. Binauthz conifguration for the cluster. Deprecated: This field will be ignored and should not be set." }, "cluster": { - "description": "The user-specified cluster name used by Config Sync cluster-name-selector annotation or ClusterSelector, for applying configs to only a subset of clusters. Omit this field if the cluster's fleet membership name is used by Config Sync cluster-name-selector annotation or ClusterSelector. Set this field if a name different from the cluster's fleet membership name is used by Config Sync cluster-name-selector annotation or ClusterSelector.", + "description": "Optional. The user-specified cluster name used by Config Sync cluster-name-selector annotation or ClusterSelector, for applying configs to only a subset of clusters. Omit this field if the cluster's fleet membership name is used by Config Sync cluster-name-selector annotation or ClusterSelector. Set this field if a name different from the cluster's fleet membership name is used by Config Sync cluster-name-selector annotation or ClusterSelector.", "type": "string" }, "configSync": { "$ref": "ConfigManagementConfigSync", - "description": "Config Sync configuration for the cluster." + "description": "Optional. Config Sync configuration for the cluster." }, "hierarchyController": { "$ref": "ConfigManagementHierarchyControllerConfig", - "description": "Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead." + "deprecated": true, + "description": "Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead." }, "management": { - "description": "Enables automatic Feature management.", + "description": "Optional. Enables automatic Feature management.", "enum": [ "MANAGEMENT_UNSPECIFIED", "MANAGEMENT_AUTOMATIC", @@ -3635,10 +3644,11 @@ }, "policyController": { "$ref": "ConfigManagementPolicyController", - "description": "Policy Controller configuration for the cluster. Deprecated: Configuring Policy Controller through the configmanagement feature is no longer recommended. Use the policycontroller feature instead." + "deprecated": true, + "description": "Optional. Policy Controller configuration for the cluster. Deprecated: Configuring Policy Controller through the configmanagement feature is no longer recommended. Use the policycontroller feature instead." }, "version": { - "description": "Version of ACM installed.", + "description": "Optional. Version of ACM installed.", "type": "string" } }, @@ -3650,31 +3660,38 @@ "properties": { "binauthzState": { "$ref": "ConfigManagementBinauthzState", - "description": "Binauthz status" + "description": "Output only. Binauthz status", + "readOnly": true }, "clusterName": { - "description": "This field is set to the `cluster_name` field of the Membership Spec if it is not empty. Otherwise, it is set to the cluster's fleet membership name.", + "description": "Output only. This field is set to the `cluster_name` field of the Membership Spec if it is not empty. Otherwise, it is set to the cluster's fleet membership name.", + "readOnly": true, "type": "string" }, "configSyncState": { "$ref": "ConfigManagementConfigSyncState", - "description": "Current sync status" + "description": "Output only. Current sync status", + "readOnly": true }, "hierarchyControllerState": { "$ref": "ConfigManagementHierarchyControllerState", - "description": "Hierarchy Controller status" + "description": "Output only. Hierarchy Controller status", + "readOnly": true }, "membershipSpec": { "$ref": "ConfigManagementMembershipSpec", - "description": "Membership configuration in the cluster. This represents the actual state in the cluster, while the MembershipSpec in the FeatureSpec represents the intended state" + "description": "Output only. Membership configuration in the cluster. This represents the actual state in the cluster, while the MembershipSpec in the FeatureSpec represents the intended state", + "readOnly": true }, "operatorState": { "$ref": "ConfigManagementOperatorState", - "description": "Current install status of ACM's Operator" + "description": "Output only. Current install status of ACM's Operator", + "readOnly": true }, "policyControllerState": { "$ref": "ConfigManagementPolicyControllerState", - "description": "PolicyController status" + "description": "Output only. PolicyController status", + "readOnly": true } }, "type": "object" @@ -3684,23 +3701,23 @@ "id": "ConfigManagementOciConfig", "properties": { "gcpServiceAccountEmail": { - "description": "The Google Cloud Service Account Email used for auth when secret_type is gcpServiceAccount.", + "description": "Optional. The Google Cloud Service Account Email used for auth when secret_type is gcpServiceAccount.", "type": "string" }, "policyDir": { - "description": "The absolute path of the directory that contains the local resources. Default: the root directory of the image.", + "description": "Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.", "type": "string" }, "secretType": { - "description": "Type of secret configured for access to the Git repo.", + "description": "Optional. Type of secret configured for access to the Git repo.", "type": "string" }, "syncRepo": { - "description": "The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.", + "description": "Optional. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.", "type": "string" }, "syncWaitSecs": { - "description": "Period in seconds between consecutive syncs. Default: 15.", + "description": "Optional. Period in seconds between consecutive syncs. Default: 15.", "format": "int64", "type": "string" } @@ -7242,12 +7259,14 @@ "enum": [ "VALIDATOR_TYPE_UNSPECIFIED", "MEMBERSHIP_ID", - "CROSS_PROJECT_PERMISSION" + "CROSS_PROJECT_PERMISSION", + "FLEET_ALLOWED_FOR_PROJECT_GUARDRAIL" ], "enumDescriptions": [ "UNSPECIFIED validator.", "MEMBERSHIP_ID validator validates that the membership_id is still available.", - "CROSS_PROJECT_PERMISSION validator validates that the cross-project role binding for the service agent is in place." + "CROSS_PROJECT_PERMISSION validator validates that the cross-project role binding for the service agent is in place.", + "FLEET_ALLOWED_FOR_PROJECT_GUARDRAIL validator validates that the fleet project is allowed for the project guardrail." ], "type": "string" } diff --git a/gkehub/v1alpha/gkehub-gen.go b/gkehub/v1alpha/gkehub-gen.go index 115a92aecfb..a420bd087dc 100644 --- a/gkehub/v1alpha/gkehub-gen.go +++ b/gkehub/v1alpha/gkehub-gen.go @@ -1392,38 +1392,39 @@ func (s ConfigManagementBinauthzVersion) MarshalJSON() ([]byte, error) { // ConfigManagementConfigSync: Configuration for Config Sync type ConfigManagementConfigSync struct { - // AllowVerticalScale: Set to true to allow the vertical scaling. Defaults to - // false which disallows vertical scaling. This field is deprecated. + // AllowVerticalScale: Optional. Set to true to allow the vertical scaling. + // Defaults to false which disallows vertical scaling. This field is + // deprecated. AllowVerticalScale bool `json:"allowVerticalScale,omitempty"` - // Enabled: Enables the installation of ConfigSync. If set to true, ConfigSync - // resources will be created and the other ConfigSync fields will be applied if - // exist. If set to false, all other ConfigSync fields will be ignored, - // ConfigSync resources will be deleted. If omitted, ConfigSync resources will - // be managed depends on the presence of the git or oci field. + // Enabled: Optional. Enables the installation of ConfigSync. If set to true, + // ConfigSync resources will be created and the other ConfigSync fields will be + // applied if exist. If set to false, all other ConfigSync fields will be + // ignored, ConfigSync resources will be deleted. If omitted, ConfigSync + // resources will be managed depends on the presence of the git or oci field. Enabled bool `json:"enabled,omitempty"` - // Git: Git repo configuration for the cluster. + // Git: Optional. Git repo configuration for the cluster. Git *ConfigManagementGitConfig `json:"git,omitempty"` - // MetricsGcpServiceAccountEmail: The Email of the Google Cloud Service Account - // (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud - // Monarch when Workload Identity is enabled. The GSA should have the - // Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The - // Kubernetes ServiceAccount `default` in the namespace + // MetricsGcpServiceAccountEmail: Optional. The Email of the Google Cloud + // Service Account (GSA) used for exporting Config Sync metrics to Cloud + // Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA + // should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM + // role. The Kubernetes ServiceAccount `default` in the namespace // `config-management-monitoring` should be bound to the GSA. Deprecated: If // Workload Identity Federation for GKE is enabled, Google Cloud Service // Account is no longer needed for exporting Config Sync metrics: // https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring. MetricsGcpServiceAccountEmail string `json:"metricsGcpServiceAccountEmail,omitempty"` - // Oci: OCI repo configuration for the cluster + // Oci: Optional. OCI repo configuration for the cluster Oci *ConfigManagementOciConfig `json:"oci,omitempty"` - // PreventDrift: Set to true to enable the Config Sync admission webhook to - // prevent drifts. If set to `false`, disables the Config Sync admission - // webhook and does not prevent drifts. + // PreventDrift: Optional. Set to true to enable the Config Sync admission + // webhook to prevent drifts. If set to `false`, disables the Config Sync + // admission webhook and does not prevent drifts. PreventDrift bool `json:"preventDrift,omitempty"` - // SourceFormat: Specifies whether the Config Sync Repo is in "hierarchical" or - // "unstructured" mode. + // SourceFormat: Optional. Specifies whether the Config Sync Repo is in + // "hierarchical" or "unstructured" mode. SourceFormat string `json:"sourceFormat,omitempty"` - // StopSyncing: Set to true to stop syncing configs for a single cluster. - // Default to false. + // StopSyncing: Optional. Set to true to stop syncing configs for a single + // cluster. Default to false. StopSyncing bool `json:"stopSyncing,omitempty"` // ForceSendFields is a list of field names (e.g. "AllowVerticalScale") to // unconditionally include in API requests. By default, fields with empty or @@ -1571,8 +1572,8 @@ func (s ConfigManagementConfigSyncError) MarshalJSON() ([]byte, error) { // ConfigManagementConfigSyncState: State information for ConfigSync type ConfigManagementConfigSyncState struct { - // ClusterLevelStopSyncingState: Whether syncing resources to the cluster is - // stopped at the cluster level. + // ClusterLevelStopSyncingState: Output only. Whether syncing resources to the + // cluster is stopped at the cluster level. // // Possible values: // "STOP_SYNCING_STATE_UNSPECIFIED" - State cannot be determined @@ -1586,12 +1587,12 @@ type ConfigManagementConfigSyncState struct { // CrCount: Output only. The number of RootSync and RepoSync CRs in the // cluster. CrCount int64 `json:"crCount,omitempty"` - // DeploymentState: Information about the deployment of ConfigSync, including - // the version of the various Pods deployed + // DeploymentState: Output only. Information about the deployment of + // ConfigSync, including the version of the various Pods deployed DeploymentState *ConfigManagementConfigSyncDeploymentState `json:"deploymentState,omitempty"` - // Errors: Errors pertaining to the installation of Config Sync. + // Errors: Output only. Errors pertaining to the installation of Config Sync. Errors []*ConfigManagementConfigSyncError `json:"errors,omitempty"` - // ReposyncCrd: The state of the Reposync CRD + // ReposyncCrd: Output only. The state of the Reposync CRD // // Possible values: // "CRD_STATE_UNSPECIFIED" - CRD's state cannot be determined @@ -1601,7 +1602,7 @@ type ConfigManagementConfigSyncState struct { // cleaning up) // "INSTALLING" - CRD is installing ReposyncCrd string `json:"reposyncCrd,omitempty"` - // RootsyncCrd: The state of the RootSync CRD + // RootsyncCrd: Output only. The state of the RootSync CRD // // Possible values: // "CRD_STATE_UNSPECIFIED" - CRD's state cannot be determined @@ -1611,8 +1612,8 @@ type ConfigManagementConfigSyncState struct { // cleaning up) // "INSTALLING" - CRD is installing RootsyncCrd string `json:"rootsyncCrd,omitempty"` - // State: The state of CS This field summarizes the other fields in this - // message. + // State: Output only. The state of CS This field summarizes the other fields + // in this message. // // Possible values: // "STATE_UNSPECIFIED" - CS's state cannot be determined. @@ -1622,9 +1623,10 @@ type ConfigManagementConfigSyncState struct { // "CONFIG_SYNC_ERROR" - CS encounters errors. // "CONFIG_SYNC_PENDING" - CS is installing or terminating. State string `json:"state,omitempty"` - // SyncState: The state of ConfigSync's process to sync configs to a cluster + // SyncState: Output only. The state of ConfigSync's process to sync configs to + // a cluster SyncState *ConfigManagementSyncState `json:"syncState,omitempty"` - // Version: The version of ConfigSync deployed + // Version: Output only. The version of ConfigSync deployed Version *ConfigManagementConfigSyncVersion `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. // "ClusterLevelStopSyncingState") to unconditionally include in API requests. @@ -1765,26 +1767,30 @@ func (s ConfigManagementGatekeeperDeploymentState) MarshalJSON() ([]byte, error) // ConfigManagementGitConfig: Git repo configuration for a single cluster. type ConfigManagementGitConfig struct { - // GcpServiceAccountEmail: The Google Cloud Service Account Email used for auth - // when secret_type is gcpServiceAccount. + // GcpServiceAccountEmail: Optional. The Google Cloud Service Account Email + // used for auth when secret_type is gcpServiceAccount. GcpServiceAccountEmail string `json:"gcpServiceAccountEmail,omitempty"` - // HttpsProxy: URL for the HTTPS proxy to be used when communicating with the - // Git repo. + // HttpsProxy: Optional. URL for the HTTPS proxy to be used when communicating + // with the Git repo. HttpsProxy string `json:"httpsProxy,omitempty"` - // PolicyDir: The path within the Git repository that represents the top level - // of the repo to sync. Default: the root directory of the repository. + // PolicyDir: Optional. The path within the Git repository that represents the + // top level of the repo to sync. Default: the root directory of the + // repository. PolicyDir string `json:"policyDir,omitempty"` - // SecretType: Type of secret configured for access to the Git repo. Must be - // one of ssh, cookiefile, gcenode, token, gcpserviceaccount or none. The - // validation of this is case-sensitive. Required. + // SecretType: Required. Type of secret configured for access to the Git repo. + // Must be one of ssh, cookiefile, gcenode, token, gcpserviceaccount or none. + // The validation of this is case-sensitive. Required. SecretType string `json:"secretType,omitempty"` - // SyncBranch: The branch of the repository to sync from. Default: master. + // SyncBranch: Optional. The branch of the repository to sync from. Default: + // master. SyncBranch string `json:"syncBranch,omitempty"` - // SyncRepo: The URL of the Git repository to use as the source of truth. + // SyncRepo: Optional. The URL of the Git repository to use as the source of + // truth. SyncRepo string `json:"syncRepo,omitempty"` - // SyncRev: Git revision (tag or hash) to check out. Default HEAD. + // SyncRev: Optional. Git revision (tag or hash) to check out. Default HEAD. SyncRev string `json:"syncRev,omitempty"` - // SyncWaitSecs: Period in seconds between consecutive syncs. Default: 15. + // SyncWaitSecs: Optional. Period in seconds between consecutive syncs. + // Default: 15. SyncWaitSecs int64 `json:"syncWaitSecs,omitempty,string"` // ForceSendFields is a list of field names (e.g. "GcpServiceAccountEmail") to // unconditionally include in API requests. By default, fields with empty or @@ -1972,10 +1978,10 @@ func (s ConfigManagementInstallError) MarshalJSON() ([]byte, error) { // ConfigManagementMembershipSpec: **Anthos Config Management**: Configuration // for a single cluster. Intended to parallel the ConfigManagement CR. type ConfigManagementMembershipSpec struct { - // Binauthz: Binauthz conifguration for the cluster. Deprecated: This field - // will be ignored and should not be set. + // Binauthz: Optional. Binauthz conifguration for the cluster. Deprecated: This + // field will be ignored and should not be set. Binauthz *ConfigManagementBinauthzConfig `json:"binauthz,omitempty"` - // Cluster: The user-specified cluster name used by Config Sync + // Cluster: Optional. The user-specified cluster name used by Config Sync // cluster-name-selector annotation or ClusterSelector, for applying configs to // only a subset of clusters. Omit this field if the cluster's fleet membership // name is used by Config Sync cluster-name-selector annotation or @@ -1983,14 +1989,14 @@ type ConfigManagementMembershipSpec struct { // membership name is used by Config Sync cluster-name-selector annotation or // ClusterSelector. Cluster string `json:"cluster,omitempty"` - // ConfigSync: Config Sync configuration for the cluster. + // ConfigSync: Optional. Config Sync configuration for the cluster. ConfigSync *ConfigManagementConfigSync `json:"configSync,omitempty"` - // HierarchyController: Hierarchy Controller configuration for the cluster. - // Deprecated: Configuring Hierarchy Controller through the configmanagement - // feature is no longer recommended. Use + // HierarchyController: Optional. Hierarchy Controller configuration for the + // cluster. Deprecated: Configuring Hierarchy Controller through the + // configmanagement feature is no longer recommended. Use // https://github.com/kubernetes-sigs/hierarchical-namespaces instead. HierarchyController *ConfigManagementHierarchyControllerConfig `json:"hierarchyController,omitempty"` - // Management: Enables automatic Feature management. + // Management: Optional. Enables automatic Feature management. // // Possible values: // "MANAGEMENT_UNSPECIFIED" - Unspecified @@ -1998,11 +2004,11 @@ type ConfigManagementMembershipSpec struct { // "MANAGEMENT_MANUAL" - User will manually manage the Feature for the // cluster. Management string `json:"management,omitempty"` - // PolicyController: Policy Controller configuration for the cluster. + // PolicyController: Optional. Policy Controller configuration for the cluster. // Deprecated: Configuring Policy Controller through the configmanagement // feature is no longer recommended. Use the policycontroller feature instead. PolicyController *ConfigManagementPolicyController `json:"policyController,omitempty"` - // Version: Version of ACM installed. + // Version: Optional. Version of ACM installed. Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "Binauthz") to // unconditionally include in API requests. By default, fields with empty or @@ -2025,23 +2031,23 @@ func (s ConfigManagementMembershipSpec) MarshalJSON() ([]byte, error) { // ConfigManagementMembershipState: **Anthos Config Management**: State for a // single cluster. type ConfigManagementMembershipState struct { - // BinauthzState: Binauthz status + // BinauthzState: Output only. Binauthz status BinauthzState *ConfigManagementBinauthzState `json:"binauthzState,omitempty"` - // ClusterName: This field is set to the `cluster_name` field of the Membership - // Spec if it is not empty. Otherwise, it is set to the cluster's fleet - // membership name. + // ClusterName: Output only. This field is set to the `cluster_name` field of + // the Membership Spec if it is not empty. Otherwise, it is set to the + // cluster's fleet membership name. ClusterName string `json:"clusterName,omitempty"` - // ConfigSyncState: Current sync status + // ConfigSyncState: Output only. Current sync status ConfigSyncState *ConfigManagementConfigSyncState `json:"configSyncState,omitempty"` - // HierarchyControllerState: Hierarchy Controller status + // HierarchyControllerState: Output only. Hierarchy Controller status HierarchyControllerState *ConfigManagementHierarchyControllerState `json:"hierarchyControllerState,omitempty"` - // MembershipSpec: Membership configuration in the cluster. This represents the - // actual state in the cluster, while the MembershipSpec in the FeatureSpec - // represents the intended state + // MembershipSpec: Output only. Membership configuration in the cluster. This + // represents the actual state in the cluster, while the MembershipSpec in the + // FeatureSpec represents the intended state MembershipSpec *ConfigManagementMembershipSpec `json:"membershipSpec,omitempty"` - // OperatorState: Current install status of ACM's Operator + // OperatorState: Output only. Current install status of ACM's Operator OperatorState *ConfigManagementOperatorState `json:"operatorState,omitempty"` - // PolicyControllerState: PolicyController status + // PolicyControllerState: Output only. PolicyController status PolicyControllerState *ConfigManagementPolicyControllerState `json:"policyControllerState,omitempty"` // ForceSendFields is a list of field names (e.g. "BinauthzState") to // unconditionally include in API requests. By default, fields with empty or @@ -2063,18 +2069,20 @@ func (s ConfigManagementMembershipState) MarshalJSON() ([]byte, error) { // ConfigManagementOciConfig: OCI repo configuration for a single cluster type ConfigManagementOciConfig struct { - // GcpServiceAccountEmail: The Google Cloud Service Account Email used for auth - // when secret_type is gcpServiceAccount. + // GcpServiceAccountEmail: Optional. The Google Cloud Service Account Email + // used for auth when secret_type is gcpServiceAccount. GcpServiceAccountEmail string `json:"gcpServiceAccountEmail,omitempty"` - // PolicyDir: The absolute path of the directory that contains the local - // resources. Default: the root directory of the image. + // PolicyDir: Optional. The absolute path of the directory that contains the + // local resources. Default: the root directory of the image. PolicyDir string `json:"policyDir,omitempty"` - // SecretType: Type of secret configured for access to the Git repo. + // SecretType: Optional. Type of secret configured for access to the Git repo. SecretType string `json:"secretType,omitempty"` - // SyncRepo: The OCI image repository URL for the package to sync from. e.g. + // SyncRepo: Optional. The OCI image repository URL for the package to sync + // from. e.g. // `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`. SyncRepo string `json:"syncRepo,omitempty"` - // SyncWaitSecs: Period in seconds between consecutive syncs. Default: 15. + // SyncWaitSecs: Optional. Period in seconds between consecutive syncs. + // Default: 15. SyncWaitSecs int64 `json:"syncWaitSecs,omitempty,string"` // ForceSendFields is a list of field names (e.g. "GcpServiceAccountEmail") to // unconditionally include in API requests. By default, fields with empty or @@ -6570,6 +6578,9 @@ type ValidationResult struct { // is still available. // "CROSS_PROJECT_PERMISSION" - CROSS_PROJECT_PERMISSION validator validates // that the cross-project role binding for the service agent is in place. + // "FLEET_ALLOWED_FOR_PROJECT_GUARDRAIL" - + // FLEET_ALLOWED_FOR_PROJECT_GUARDRAIL validator validates that the fleet + // project is allowed for the project guardrail. Validator string `json:"validator,omitempty"` // ForceSendFields is a list of field names (e.g. "Result") to unconditionally // include in API requests. By default, fields with empty or default values are diff --git a/gkehub/v1beta/gkehub-api.json b/gkehub/v1beta/gkehub-api.json index c0e53cce2bb..75bc61904d4 100644 --- a/gkehub/v1beta/gkehub-api.json +++ b/gkehub/v1beta/gkehub-api.json @@ -2111,7 +2111,7 @@ } } }, - "revision": "20241206", + "revision": "20250103", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AnthosObservabilityFeatureSpec": { @@ -2732,36 +2732,36 @@ "properties": { "allowVerticalScale": { "deprecated": true, - "description": "Set to true to allow the vertical scaling. Defaults to false which disallows vertical scaling. This field is deprecated.", + "description": "Optional. Set to true to allow the vertical scaling. Defaults to false which disallows vertical scaling. This field is deprecated.", "type": "boolean" }, "enabled": { - "description": "Enables the installation of ConfigSync. If set to true, ConfigSync resources will be created and the other ConfigSync fields will be applied if exist. If set to false, all other ConfigSync fields will be ignored, ConfigSync resources will be deleted. If omitted, ConfigSync resources will be managed depends on the presence of the git or oci field.", + "description": "Optional. Enables the installation of ConfigSync. If set to true, ConfigSync resources will be created and the other ConfigSync fields will be applied if exist. If set to false, all other ConfigSync fields will be ignored, ConfigSync resources will be deleted. If omitted, ConfigSync resources will be managed depends on the presence of the git or oci field.", "type": "boolean" }, "git": { "$ref": "ConfigManagementGitConfig", - "description": "Git repo configuration for the cluster." + "description": "Optional. Git repo configuration for the cluster." }, "metricsGcpServiceAccountEmail": { "deprecated": true, - "description": "The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.", + "description": "Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.", "type": "string" }, "oci": { "$ref": "ConfigManagementOciConfig", - "description": "OCI repo configuration for the cluster" + "description": "Optional. OCI repo configuration for the cluster" }, "preventDrift": { - "description": "Set to true to enable the Config Sync admission webhook to prevent drifts. If set to `false`, disables the Config Sync admission webhook and does not prevent drifts.", + "description": "Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to `false`, disables the Config Sync admission webhook and does not prevent drifts.", "type": "boolean" }, "sourceFormat": { - "description": "Specifies whether the Config Sync Repo is in \"hierarchical\" or \"unstructured\" mode.", + "description": "Optional. Specifies whether the Config Sync Repo is in \"hierarchical\" or \"unstructured\" mode.", "type": "string" }, "stopSyncing": { - "description": "Set to true to stop syncing configs for a single cluster. Default to false.", + "description": "Optional. Set to true to stop syncing configs for a single cluster. Default to false.", "type": "boolean" } }, @@ -2952,7 +2952,7 @@ "id": "ConfigManagementConfigSyncState", "properties": { "clusterLevelStopSyncingState": { - "description": "Whether syncing resources to the cluster is stopped at the cluster level.", + "description": "Output only. Whether syncing resources to the cluster is stopped at the cluster level.", "enum": [ "STOP_SYNCING_STATE_UNSPECIFIED", "NOT_STOPPED", @@ -2965,6 +2965,7 @@ "Some reconcilers stop syncing resources to the cluster, while others are still syncing.", "Syncing resources to the cluster is stopped at the cluster level." ], + "readOnly": true, "type": "string" }, "crCount": { @@ -2975,17 +2976,19 @@ }, "deploymentState": { "$ref": "ConfigManagementConfigSyncDeploymentState", - "description": "Information about the deployment of ConfigSync, including the version of the various Pods deployed" + "description": "Output only. Information about the deployment of ConfigSync, including the version of the various Pods deployed", + "readOnly": true }, "errors": { - "description": "Errors pertaining to the installation of Config Sync.", + "description": "Output only. Errors pertaining to the installation of Config Sync.", "items": { "$ref": "ConfigManagementConfigSyncError" }, + "readOnly": true, "type": "array" }, "reposyncCrd": { - "description": "The state of the Reposync CRD", + "description": "Output only. The state of the Reposync CRD", "enum": [ "CRD_STATE_UNSPECIFIED", "NOT_INSTALLED", @@ -3000,10 +3003,11 @@ "CRD is terminating (i.e., it has been deleted and is cleaning up)", "CRD is installing" ], + "readOnly": true, "type": "string" }, "rootsyncCrd": { - "description": "The state of the RootSync CRD", + "description": "Output only. The state of the RootSync CRD", "enum": [ "CRD_STATE_UNSPECIFIED", "NOT_INSTALLED", @@ -3018,10 +3022,11 @@ "CRD is terminating (i.e., it has been deleted and is cleaning up)", "CRD is installing" ], + "readOnly": true, "type": "string" }, "state": { - "description": "The state of CS This field summarizes the other fields in this message.", + "description": "Output only. The state of CS This field summarizes the other fields in this message.", "enum": [ "STATE_UNSPECIFIED", "CONFIG_SYNC_NOT_INSTALLED", @@ -3036,15 +3041,18 @@ "CS encounters errors.", "CS is installing or terminating." ], + "readOnly": true, "type": "string" }, "syncState": { "$ref": "ConfigManagementSyncState", - "description": "The state of ConfigSync's process to sync configs to a cluster" + "description": "Output only. The state of ConfigSync's process to sync configs to a cluster", + "readOnly": true }, "version": { "$ref": "ConfigManagementConfigSyncVersion", - "description": "The version of ConfigSync deployed" + "description": "Output only. The version of ConfigSync deployed", + "readOnly": true } }, "type": "object" @@ -3181,35 +3189,35 @@ "id": "ConfigManagementGitConfig", "properties": { "gcpServiceAccountEmail": { - "description": "The Google Cloud Service Account Email used for auth when secret_type is gcpServiceAccount.", + "description": "Optional. The Google Cloud Service Account Email used for auth when secret_type is gcpServiceAccount.", "type": "string" }, "httpsProxy": { - "description": "URL for the HTTPS proxy to be used when communicating with the Git repo.", + "description": "Optional. URL for the HTTPS proxy to be used when communicating with the Git repo.", "type": "string" }, "policyDir": { - "description": "The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.", + "description": "Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.", "type": "string" }, "secretType": { - "description": "Type of secret configured for access to the Git repo. Must be one of ssh, cookiefile, gcenode, token, gcpserviceaccount or none. The validation of this is case-sensitive. Required.", + "description": "Required. Type of secret configured for access to the Git repo. Must be one of ssh, cookiefile, gcenode, token, gcpserviceaccount or none. The validation of this is case-sensitive. Required.", "type": "string" }, "syncBranch": { - "description": "The branch of the repository to sync from. Default: master.", + "description": "Optional. The branch of the repository to sync from. Default: master.", "type": "string" }, "syncRepo": { - "description": "The URL of the Git repository to use as the source of truth.", + "description": "Optional. The URL of the Git repository to use as the source of truth.", "type": "string" }, "syncRev": { - "description": "Git revision (tag or hash) to check out. Default HEAD.", + "description": "Optional. Git revision (tag or hash) to check out. Default HEAD.", "type": "string" }, "syncWaitSecs": { - "description": "Period in seconds between consecutive syncs. Default: 15.", + "description": "Optional. Period in seconds between consecutive syncs. Default: 15.", "format": "int64", "type": "string" } @@ -3345,22 +3353,23 @@ "binauthz": { "$ref": "ConfigManagementBinauthzConfig", "deprecated": true, - "description": "Binauthz conifguration for the cluster. Deprecated: This field will be ignored and should not be set." + "description": "Optional. Binauthz conifguration for the cluster. Deprecated: This field will be ignored and should not be set." }, "cluster": { - "description": "The user-specified cluster name used by Config Sync cluster-name-selector annotation or ClusterSelector, for applying configs to only a subset of clusters. Omit this field if the cluster's fleet membership name is used by Config Sync cluster-name-selector annotation or ClusterSelector. Set this field if a name different from the cluster's fleet membership name is used by Config Sync cluster-name-selector annotation or ClusterSelector.", + "description": "Optional. The user-specified cluster name used by Config Sync cluster-name-selector annotation or ClusterSelector, for applying configs to only a subset of clusters. Omit this field if the cluster's fleet membership name is used by Config Sync cluster-name-selector annotation or ClusterSelector. Set this field if a name different from the cluster's fleet membership name is used by Config Sync cluster-name-selector annotation or ClusterSelector.", "type": "string" }, "configSync": { "$ref": "ConfigManagementConfigSync", - "description": "Config Sync configuration for the cluster." + "description": "Optional. Config Sync configuration for the cluster." }, "hierarchyController": { "$ref": "ConfigManagementHierarchyControllerConfig", - "description": "Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead." + "deprecated": true, + "description": "Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead." }, "management": { - "description": "Enables automatic Feature management.", + "description": "Optional. Enables automatic Feature management.", "enum": [ "MANAGEMENT_UNSPECIFIED", "MANAGEMENT_AUTOMATIC", @@ -3375,10 +3384,11 @@ }, "policyController": { "$ref": "ConfigManagementPolicyController", - "description": "Policy Controller configuration for the cluster. Deprecated: Configuring Policy Controller through the configmanagement feature is no longer recommended. Use the policycontroller feature instead." + "deprecated": true, + "description": "Optional. Policy Controller configuration for the cluster. Deprecated: Configuring Policy Controller through the configmanagement feature is no longer recommended. Use the policycontroller feature instead." }, "version": { - "description": "Version of ACM installed.", + "description": "Optional. Version of ACM installed.", "type": "string" } }, @@ -3390,31 +3400,38 @@ "properties": { "binauthzState": { "$ref": "ConfigManagementBinauthzState", - "description": "Binauthz status" + "description": "Output only. Binauthz status", + "readOnly": true }, "clusterName": { - "description": "This field is set to the `cluster_name` field of the Membership Spec if it is not empty. Otherwise, it is set to the cluster's fleet membership name.", + "description": "Output only. This field is set to the `cluster_name` field of the Membership Spec if it is not empty. Otherwise, it is set to the cluster's fleet membership name.", + "readOnly": true, "type": "string" }, "configSyncState": { "$ref": "ConfigManagementConfigSyncState", - "description": "Current sync status" + "description": "Output only. Current sync status", + "readOnly": true }, "hierarchyControllerState": { "$ref": "ConfigManagementHierarchyControllerState", - "description": "Hierarchy Controller status" + "description": "Output only. Hierarchy Controller status", + "readOnly": true }, "membershipSpec": { "$ref": "ConfigManagementMembershipSpec", - "description": "Membership configuration in the cluster. This represents the actual state in the cluster, while the MembershipSpec in the FeatureSpec represents the intended state" + "description": "Output only. Membership configuration in the cluster. This represents the actual state in the cluster, while the MembershipSpec in the FeatureSpec represents the intended state", + "readOnly": true }, "operatorState": { "$ref": "ConfigManagementOperatorState", - "description": "Current install status of ACM's Operator" + "description": "Output only. Current install status of ACM's Operator", + "readOnly": true }, "policyControllerState": { "$ref": "ConfigManagementPolicyControllerState", - "description": "PolicyController status" + "description": "Output only. PolicyController status", + "readOnly": true } }, "type": "object" @@ -3424,23 +3441,23 @@ "id": "ConfigManagementOciConfig", "properties": { "gcpServiceAccountEmail": { - "description": "The Google Cloud Service Account Email used for auth when secret_type is gcpServiceAccount.", + "description": "Optional. The Google Cloud Service Account Email used for auth when secret_type is gcpServiceAccount.", "type": "string" }, "policyDir": { - "description": "The absolute path of the directory that contains the local resources. Default: the root directory of the image.", + "description": "Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.", "type": "string" }, "secretType": { - "description": "Type of secret configured for access to the Git repo.", + "description": "Optional. Type of secret configured for access to the Git repo.", "type": "string" }, "syncRepo": { - "description": "The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.", + "description": "Optional. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.", "type": "string" }, "syncWaitSecs": { - "description": "Period in seconds between consecutive syncs. Default: 15.", + "description": "Optional. Period in seconds between consecutive syncs. Default: 15.", "format": "int64", "type": "string" } diff --git a/gkehub/v1beta/gkehub-gen.go b/gkehub/v1beta/gkehub-gen.go index aa65fc2a79f..b4ea525ad3b 100644 --- a/gkehub/v1beta/gkehub-gen.go +++ b/gkehub/v1beta/gkehub-gen.go @@ -1253,38 +1253,39 @@ func (s ConfigManagementBinauthzVersion) MarshalJSON() ([]byte, error) { // ConfigManagementConfigSync: Configuration for Config Sync type ConfigManagementConfigSync struct { - // AllowVerticalScale: Set to true to allow the vertical scaling. Defaults to - // false which disallows vertical scaling. This field is deprecated. + // AllowVerticalScale: Optional. Set to true to allow the vertical scaling. + // Defaults to false which disallows vertical scaling. This field is + // deprecated. AllowVerticalScale bool `json:"allowVerticalScale,omitempty"` - // Enabled: Enables the installation of ConfigSync. If set to true, ConfigSync - // resources will be created and the other ConfigSync fields will be applied if - // exist. If set to false, all other ConfigSync fields will be ignored, - // ConfigSync resources will be deleted. If omitted, ConfigSync resources will - // be managed depends on the presence of the git or oci field. + // Enabled: Optional. Enables the installation of ConfigSync. If set to true, + // ConfigSync resources will be created and the other ConfigSync fields will be + // applied if exist. If set to false, all other ConfigSync fields will be + // ignored, ConfigSync resources will be deleted. If omitted, ConfigSync + // resources will be managed depends on the presence of the git or oci field. Enabled bool `json:"enabled,omitempty"` - // Git: Git repo configuration for the cluster. + // Git: Optional. Git repo configuration for the cluster. Git *ConfigManagementGitConfig `json:"git,omitempty"` - // MetricsGcpServiceAccountEmail: The Email of the Google Cloud Service Account - // (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud - // Monarch when Workload Identity is enabled. The GSA should have the - // Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The - // Kubernetes ServiceAccount `default` in the namespace + // MetricsGcpServiceAccountEmail: Optional. The Email of the Google Cloud + // Service Account (GSA) used for exporting Config Sync metrics to Cloud + // Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA + // should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM + // role. The Kubernetes ServiceAccount `default` in the namespace // `config-management-monitoring` should be bound to the GSA. Deprecated: If // Workload Identity Federation for GKE is enabled, Google Cloud Service // Account is no longer needed for exporting Config Sync metrics: // https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring. MetricsGcpServiceAccountEmail string `json:"metricsGcpServiceAccountEmail,omitempty"` - // Oci: OCI repo configuration for the cluster + // Oci: Optional. OCI repo configuration for the cluster Oci *ConfigManagementOciConfig `json:"oci,omitempty"` - // PreventDrift: Set to true to enable the Config Sync admission webhook to - // prevent drifts. If set to `false`, disables the Config Sync admission - // webhook and does not prevent drifts. + // PreventDrift: Optional. Set to true to enable the Config Sync admission + // webhook to prevent drifts. If set to `false`, disables the Config Sync + // admission webhook and does not prevent drifts. PreventDrift bool `json:"preventDrift,omitempty"` - // SourceFormat: Specifies whether the Config Sync Repo is in "hierarchical" or - // "unstructured" mode. + // SourceFormat: Optional. Specifies whether the Config Sync Repo is in + // "hierarchical" or "unstructured" mode. SourceFormat string `json:"sourceFormat,omitempty"` - // StopSyncing: Set to true to stop syncing configs for a single cluster. - // Default to false. + // StopSyncing: Optional. Set to true to stop syncing configs for a single + // cluster. Default to false. StopSyncing bool `json:"stopSyncing,omitempty"` // ForceSendFields is a list of field names (e.g. "AllowVerticalScale") to // unconditionally include in API requests. By default, fields with empty or @@ -1432,8 +1433,8 @@ func (s ConfigManagementConfigSyncError) MarshalJSON() ([]byte, error) { // ConfigManagementConfigSyncState: State information for ConfigSync type ConfigManagementConfigSyncState struct { - // ClusterLevelStopSyncingState: Whether syncing resources to the cluster is - // stopped at the cluster level. + // ClusterLevelStopSyncingState: Output only. Whether syncing resources to the + // cluster is stopped at the cluster level. // // Possible values: // "STOP_SYNCING_STATE_UNSPECIFIED" - State cannot be determined @@ -1447,12 +1448,12 @@ type ConfigManagementConfigSyncState struct { // CrCount: Output only. The number of RootSync and RepoSync CRs in the // cluster. CrCount int64 `json:"crCount,omitempty"` - // DeploymentState: Information about the deployment of ConfigSync, including - // the version of the various Pods deployed + // DeploymentState: Output only. Information about the deployment of + // ConfigSync, including the version of the various Pods deployed DeploymentState *ConfigManagementConfigSyncDeploymentState `json:"deploymentState,omitempty"` - // Errors: Errors pertaining to the installation of Config Sync. + // Errors: Output only. Errors pertaining to the installation of Config Sync. Errors []*ConfigManagementConfigSyncError `json:"errors,omitempty"` - // ReposyncCrd: The state of the Reposync CRD + // ReposyncCrd: Output only. The state of the Reposync CRD // // Possible values: // "CRD_STATE_UNSPECIFIED" - CRD's state cannot be determined @@ -1462,7 +1463,7 @@ type ConfigManagementConfigSyncState struct { // cleaning up) // "INSTALLING" - CRD is installing ReposyncCrd string `json:"reposyncCrd,omitempty"` - // RootsyncCrd: The state of the RootSync CRD + // RootsyncCrd: Output only. The state of the RootSync CRD // // Possible values: // "CRD_STATE_UNSPECIFIED" - CRD's state cannot be determined @@ -1472,8 +1473,8 @@ type ConfigManagementConfigSyncState struct { // cleaning up) // "INSTALLING" - CRD is installing RootsyncCrd string `json:"rootsyncCrd,omitempty"` - // State: The state of CS This field summarizes the other fields in this - // message. + // State: Output only. The state of CS This field summarizes the other fields + // in this message. // // Possible values: // "STATE_UNSPECIFIED" - CS's state cannot be determined. @@ -1483,9 +1484,10 @@ type ConfigManagementConfigSyncState struct { // "CONFIG_SYNC_ERROR" - CS encounters errors. // "CONFIG_SYNC_PENDING" - CS is installing or terminating. State string `json:"state,omitempty"` - // SyncState: The state of ConfigSync's process to sync configs to a cluster + // SyncState: Output only. The state of ConfigSync's process to sync configs to + // a cluster SyncState *ConfigManagementSyncState `json:"syncState,omitempty"` - // Version: The version of ConfigSync deployed + // Version: Output only. The version of ConfigSync deployed Version *ConfigManagementConfigSyncVersion `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. // "ClusterLevelStopSyncingState") to unconditionally include in API requests. @@ -1626,26 +1628,30 @@ func (s ConfigManagementGatekeeperDeploymentState) MarshalJSON() ([]byte, error) // ConfigManagementGitConfig: Git repo configuration for a single cluster. type ConfigManagementGitConfig struct { - // GcpServiceAccountEmail: The Google Cloud Service Account Email used for auth - // when secret_type is gcpServiceAccount. + // GcpServiceAccountEmail: Optional. The Google Cloud Service Account Email + // used for auth when secret_type is gcpServiceAccount. GcpServiceAccountEmail string `json:"gcpServiceAccountEmail,omitempty"` - // HttpsProxy: URL for the HTTPS proxy to be used when communicating with the - // Git repo. + // HttpsProxy: Optional. URL for the HTTPS proxy to be used when communicating + // with the Git repo. HttpsProxy string `json:"httpsProxy,omitempty"` - // PolicyDir: The path within the Git repository that represents the top level - // of the repo to sync. Default: the root directory of the repository. + // PolicyDir: Optional. The path within the Git repository that represents the + // top level of the repo to sync. Default: the root directory of the + // repository. PolicyDir string `json:"policyDir,omitempty"` - // SecretType: Type of secret configured for access to the Git repo. Must be - // one of ssh, cookiefile, gcenode, token, gcpserviceaccount or none. The - // validation of this is case-sensitive. Required. + // SecretType: Required. Type of secret configured for access to the Git repo. + // Must be one of ssh, cookiefile, gcenode, token, gcpserviceaccount or none. + // The validation of this is case-sensitive. Required. SecretType string `json:"secretType,omitempty"` - // SyncBranch: The branch of the repository to sync from. Default: master. + // SyncBranch: Optional. The branch of the repository to sync from. Default: + // master. SyncBranch string `json:"syncBranch,omitempty"` - // SyncRepo: The URL of the Git repository to use as the source of truth. + // SyncRepo: Optional. The URL of the Git repository to use as the source of + // truth. SyncRepo string `json:"syncRepo,omitempty"` - // SyncRev: Git revision (tag or hash) to check out. Default HEAD. + // SyncRev: Optional. Git revision (tag or hash) to check out. Default HEAD. SyncRev string `json:"syncRev,omitempty"` - // SyncWaitSecs: Period in seconds between consecutive syncs. Default: 15. + // SyncWaitSecs: Optional. Period in seconds between consecutive syncs. + // Default: 15. SyncWaitSecs int64 `json:"syncWaitSecs,omitempty,string"` // ForceSendFields is a list of field names (e.g. "GcpServiceAccountEmail") to // unconditionally include in API requests. By default, fields with empty or @@ -1833,10 +1839,10 @@ func (s ConfigManagementInstallError) MarshalJSON() ([]byte, error) { // ConfigManagementMembershipSpec: **Anthos Config Management**: Configuration // for a single cluster. Intended to parallel the ConfigManagement CR. type ConfigManagementMembershipSpec struct { - // Binauthz: Binauthz conifguration for the cluster. Deprecated: This field - // will be ignored and should not be set. + // Binauthz: Optional. Binauthz conifguration for the cluster. Deprecated: This + // field will be ignored and should not be set. Binauthz *ConfigManagementBinauthzConfig `json:"binauthz,omitempty"` - // Cluster: The user-specified cluster name used by Config Sync + // Cluster: Optional. The user-specified cluster name used by Config Sync // cluster-name-selector annotation or ClusterSelector, for applying configs to // only a subset of clusters. Omit this field if the cluster's fleet membership // name is used by Config Sync cluster-name-selector annotation or @@ -1844,14 +1850,14 @@ type ConfigManagementMembershipSpec struct { // membership name is used by Config Sync cluster-name-selector annotation or // ClusterSelector. Cluster string `json:"cluster,omitempty"` - // ConfigSync: Config Sync configuration for the cluster. + // ConfigSync: Optional. Config Sync configuration for the cluster. ConfigSync *ConfigManagementConfigSync `json:"configSync,omitempty"` - // HierarchyController: Hierarchy Controller configuration for the cluster. - // Deprecated: Configuring Hierarchy Controller through the configmanagement - // feature is no longer recommended. Use + // HierarchyController: Optional. Hierarchy Controller configuration for the + // cluster. Deprecated: Configuring Hierarchy Controller through the + // configmanagement feature is no longer recommended. Use // https://github.com/kubernetes-sigs/hierarchical-namespaces instead. HierarchyController *ConfigManagementHierarchyControllerConfig `json:"hierarchyController,omitempty"` - // Management: Enables automatic Feature management. + // Management: Optional. Enables automatic Feature management. // // Possible values: // "MANAGEMENT_UNSPECIFIED" - Unspecified @@ -1859,11 +1865,11 @@ type ConfigManagementMembershipSpec struct { // "MANAGEMENT_MANUAL" - User will manually manage the Feature for the // cluster. Management string `json:"management,omitempty"` - // PolicyController: Policy Controller configuration for the cluster. + // PolicyController: Optional. Policy Controller configuration for the cluster. // Deprecated: Configuring Policy Controller through the configmanagement // feature is no longer recommended. Use the policycontroller feature instead. PolicyController *ConfigManagementPolicyController `json:"policyController,omitempty"` - // Version: Version of ACM installed. + // Version: Optional. Version of ACM installed. Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "Binauthz") to // unconditionally include in API requests. By default, fields with empty or @@ -1886,23 +1892,23 @@ func (s ConfigManagementMembershipSpec) MarshalJSON() ([]byte, error) { // ConfigManagementMembershipState: **Anthos Config Management**: State for a // single cluster. type ConfigManagementMembershipState struct { - // BinauthzState: Binauthz status + // BinauthzState: Output only. Binauthz status BinauthzState *ConfigManagementBinauthzState `json:"binauthzState,omitempty"` - // ClusterName: This field is set to the `cluster_name` field of the Membership - // Spec if it is not empty. Otherwise, it is set to the cluster's fleet - // membership name. + // ClusterName: Output only. This field is set to the `cluster_name` field of + // the Membership Spec if it is not empty. Otherwise, it is set to the + // cluster's fleet membership name. ClusterName string `json:"clusterName,omitempty"` - // ConfigSyncState: Current sync status + // ConfigSyncState: Output only. Current sync status ConfigSyncState *ConfigManagementConfigSyncState `json:"configSyncState,omitempty"` - // HierarchyControllerState: Hierarchy Controller status + // HierarchyControllerState: Output only. Hierarchy Controller status HierarchyControllerState *ConfigManagementHierarchyControllerState `json:"hierarchyControllerState,omitempty"` - // MembershipSpec: Membership configuration in the cluster. This represents the - // actual state in the cluster, while the MembershipSpec in the FeatureSpec - // represents the intended state + // MembershipSpec: Output only. Membership configuration in the cluster. This + // represents the actual state in the cluster, while the MembershipSpec in the + // FeatureSpec represents the intended state MembershipSpec *ConfigManagementMembershipSpec `json:"membershipSpec,omitempty"` - // OperatorState: Current install status of ACM's Operator + // OperatorState: Output only. Current install status of ACM's Operator OperatorState *ConfigManagementOperatorState `json:"operatorState,omitempty"` - // PolicyControllerState: PolicyController status + // PolicyControllerState: Output only. PolicyController status PolicyControllerState *ConfigManagementPolicyControllerState `json:"policyControllerState,omitempty"` // ForceSendFields is a list of field names (e.g. "BinauthzState") to // unconditionally include in API requests. By default, fields with empty or @@ -1924,18 +1930,20 @@ func (s ConfigManagementMembershipState) MarshalJSON() ([]byte, error) { // ConfigManagementOciConfig: OCI repo configuration for a single cluster type ConfigManagementOciConfig struct { - // GcpServiceAccountEmail: The Google Cloud Service Account Email used for auth - // when secret_type is gcpServiceAccount. + // GcpServiceAccountEmail: Optional. The Google Cloud Service Account Email + // used for auth when secret_type is gcpServiceAccount. GcpServiceAccountEmail string `json:"gcpServiceAccountEmail,omitempty"` - // PolicyDir: The absolute path of the directory that contains the local - // resources. Default: the root directory of the image. + // PolicyDir: Optional. The absolute path of the directory that contains the + // local resources. Default: the root directory of the image. PolicyDir string `json:"policyDir,omitempty"` - // SecretType: Type of secret configured for access to the Git repo. + // SecretType: Optional. Type of secret configured for access to the Git repo. SecretType string `json:"secretType,omitempty"` - // SyncRepo: The OCI image repository URL for the package to sync from. e.g. + // SyncRepo: Optional. The OCI image repository URL for the package to sync + // from. e.g. // `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`. SyncRepo string `json:"syncRepo,omitempty"` - // SyncWaitSecs: Period in seconds between consecutive syncs. Default: 15. + // SyncWaitSecs: Optional. Period in seconds between consecutive syncs. + // Default: 15. SyncWaitSecs int64 `json:"syncWaitSecs,omitempty,string"` // ForceSendFields is a list of field names (e.g. "GcpServiceAccountEmail") to // unconditionally include in API requests. By default, fields with empty or diff --git a/gkehub/v2alpha/gkehub-api.json b/gkehub/v2alpha/gkehub-api.json index 6846d1775da..45645efd92e 100644 --- a/gkehub/v2alpha/gkehub-api.json +++ b/gkehub/v2alpha/gkehub-api.json @@ -471,7 +471,7 @@ } } }, - "revision": "20241206", + "revision": "20250103", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AppDevExperienceState": { @@ -702,36 +702,36 @@ "properties": { "allowVerticalScale": { "deprecated": true, - "description": "Set to true to allow the vertical scaling. Defaults to false which disallows vertical scaling. This field is deprecated.", + "description": "Optional. Set to true to allow the vertical scaling. Defaults to false which disallows vertical scaling. This field is deprecated.", "type": "boolean" }, "enabled": { - "description": "Enables the installation of ConfigSync. If set to true, ConfigSync resources will be created and the other ConfigSync fields will be applied if exist. If set to false, all other ConfigSync fields will be ignored, ConfigSync resources will be deleted. If omitted, ConfigSync resources will be managed depends on the presence of the git or oci field.", + "description": "Optional. Enables the installation of ConfigSync. If set to true, ConfigSync resources will be created and the other ConfigSync fields will be applied if exist. If set to false, all other ConfigSync fields will be ignored, ConfigSync resources will be deleted. If omitted, ConfigSync resources will be managed depends on the presence of the git or oci field.", "type": "boolean" }, "git": { "$ref": "ConfigManagementGitConfig", - "description": "Git repo configuration for the cluster." + "description": "Optional. Git repo configuration for the cluster." }, "metricsGcpServiceAccountEmail": { "deprecated": true, - "description": "The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.", + "description": "Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.", "type": "string" }, "oci": { "$ref": "ConfigManagementOciConfig", - "description": "OCI repo configuration for the cluster." + "description": "Optional. OCI repo configuration for the cluster." }, "preventDrift": { - "description": "Set to true to enable the Config Sync admission webhook to prevent drifts. If set to `false`, disables the Config Sync admission webhook and does not prevent drifts.", + "description": "Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to `false`, disables the Config Sync admission webhook and does not prevent drifts.", "type": "boolean" }, "sourceFormat": { - "description": "Specifies whether the Config Sync Repo is in \"hierarchical\" or \"unstructured\" mode.", + "description": "Optional. Specifies whether the Config Sync Repo is in \"hierarchical\" or \"unstructured\" mode.", "type": "string" }, "stopSyncing": { - "description": "Set to true to stop syncing configs for a single cluster. Default to false.", + "description": "Optional. Set to true to stop syncing configs for a single cluster. Default to false.", "type": "boolean" } }, @@ -922,7 +922,7 @@ "id": "ConfigManagementConfigSyncState", "properties": { "clusterLevelStopSyncingState": { - "description": "Whether syncing resources to the cluster is stopped at the cluster level.", + "description": "Output only. Whether syncing resources to the cluster is stopped at the cluster level.", "enum": [ "STOP_SYNCING_STATE_UNSPECIFIED", "NOT_STOPPED", @@ -935,6 +935,7 @@ "Some reconcilers stop syncing resources to the cluster, while others are still syncing.", "Syncing resources to the cluster is stopped at the cluster level." ], + "readOnly": true, "type": "string" }, "crCount": { @@ -945,17 +946,19 @@ }, "deploymentState": { "$ref": "ConfigManagementConfigSyncDeploymentState", - "description": "Information about the deployment of ConfigSync, including the version. of the various Pods deployed" + "description": "Output only. Information about the deployment of ConfigSync, including the version. of the various Pods deployed", + "readOnly": true }, "errors": { - "description": "Errors pertaining to the installation of Config Sync.", + "description": "Output only. Errors pertaining to the installation of Config Sync.", "items": { "$ref": "ConfigManagementConfigSyncError" }, + "readOnly": true, "type": "array" }, "reposyncCrd": { - "description": "The state of the Reposync CRD", + "description": "Output only. The state of the Reposync CRD", "enum": [ "CRD_STATE_UNSPECIFIED", "NOT_INSTALLED", @@ -970,10 +973,11 @@ "CRD is terminating (i.e., it has been deleted and is cleaning up)", "CRD is installing" ], + "readOnly": true, "type": "string" }, "rootsyncCrd": { - "description": "The state of the RootSync CRD", + "description": "Output only. The state of the RootSync CRD", "enum": [ "CRD_STATE_UNSPECIFIED", "NOT_INSTALLED", @@ -988,10 +992,11 @@ "CRD is terminating (i.e., it has been deleted and is cleaning up)", "CRD is installing" ], + "readOnly": true, "type": "string" }, "state": { - "description": "The state of CS This field summarizes the other fields in this message.", + "description": "Output only. The state of CS This field summarizes the other fields in this message.", "enum": [ "STATE_UNSPECIFIED", "CONFIG_SYNC_NOT_INSTALLED", @@ -1006,15 +1011,18 @@ "CS encounters errors.", "CS is installing or terminating." ], + "readOnly": true, "type": "string" }, "syncState": { "$ref": "ConfigManagementSyncState", - "description": "The state of ConfigSync's process to sync configs to a cluster." + "description": "Output only. The state of ConfigSync's process to sync configs to a cluster.", + "readOnly": true }, "version": { "$ref": "ConfigManagementConfigSyncVersion", - "description": "The version of ConfigSync deployed." + "description": "Output only. The version of ConfigSync deployed.", + "readOnly": true } }, "type": "object" @@ -1151,35 +1159,35 @@ "id": "ConfigManagementGitConfig", "properties": { "gcpServiceAccountEmail": { - "description": "The Google Cloud Service Account Email used for auth when secret_type is gcpServiceAccount.", + "description": "Optional. The Google Cloud Service Account Email used for auth when secret_type is gcpServiceAccount.", "type": "string" }, "httpsProxy": { - "description": "URL for the HTTPS proxy to be used when communicating with the Git repo.", + "description": "Optional. URL for the HTTPS proxy to be used when communicating with the Git repo.", "type": "string" }, "policyDir": { - "description": "The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.", + "description": "Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.", "type": "string" }, "secretType": { - "description": "Type of secret configured for access to the Git repo. Must be one of ssh, cookiefile, gcenode, token, gcpserviceaccount or none. The validation of this is case-sensitive. Required.", + "description": "Required. Type of secret configured for access to the Git repo. Must be one of ssh, cookiefile, gcenode, token, gcpserviceaccount or none. The validation of this is case-sensitive. Required.", "type": "string" }, "syncBranch": { - "description": "The branch of the repository to sync from. Default: master.", + "description": "Optional. The branch of the repository to sync from. Default: master.", "type": "string" }, "syncRepo": { - "description": "The URL of the Git repository to use as the source of truth.", + "description": "Optional. The URL of the Git repository to use as the source of truth.", "type": "string" }, "syncRev": { - "description": "Git revision (tag or hash) to check out. Default HEAD.", + "description": "Optional. Git revision (tag or hash) to check out. Default HEAD.", "type": "string" }, "syncWaitSecs": { - "description": "Period in seconds between consecutive syncs. Default: 15.", + "description": "Optional. Period in seconds between consecutive syncs. Default: 15.", "format": "int64", "type": "string" } @@ -1313,23 +1321,23 @@ "id": "ConfigManagementOciConfig", "properties": { "gcpServiceAccountEmail": { - "description": "The Google Cloud Service Account Email used for auth when secret_type is gcpServiceAccount.", + "description": "Optional. The Google Cloud Service Account Email used for auth when secret_type is gcpServiceAccount.", "type": "string" }, "policyDir": { - "description": "The absolute path of the directory that contains the local resources. Default: the root directory of the image.", + "description": "Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.", "type": "string" }, "secretType": { - "description": "Type of secret configured for access to the Git repo.", + "description": "Optional. Type of secret configured for access to the Git repo.", "type": "string" }, "syncRepo": { - "description": "The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.", + "description": "Optional. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.", "type": "string" }, "syncWaitSecs": { - "description": "Period in seconds between consecutive syncs. Default: 15.", + "description": "Optional. Period in seconds between consecutive syncs. Default: 15.", "format": "int64", "type": "string" } @@ -1508,22 +1516,23 @@ "binauthz": { "$ref": "ConfigManagementBinauthzConfig", "deprecated": true, - "description": "Binauthz conifguration for the cluster. Deprecated: This field will be ignored and should not be set." + "description": "Optional. Binauthz conifguration for the cluster. Deprecated: This field will be ignored and should not be set." }, "cluster": { - "description": "The user-specified cluster name used by Config Sync cluster-name-selector annotation or ClusterSelector, for applying configs to only a subset of clusters. Omit this field if the cluster's fleet membership name is used by Config Sync cluster-name-selector annotation or ClusterSelector. Set this field if a name different from the cluster's fleet membership name is used by Config Sync cluster-name-selector annotation or ClusterSelector.", + "description": "Optional. The user-specified cluster name used by Config Sync cluster-name-selector annotation or ClusterSelector, for applying configs to only a subset of clusters. Omit this field if the cluster's fleet membership name is used by Config Sync cluster-name-selector annotation or ClusterSelector. Set this field if a name different from the cluster's fleet membership name is used by Config Sync cluster-name-selector annotation or ClusterSelector.", "type": "string" }, "configSync": { "$ref": "ConfigManagementConfigSync", - "description": "Config Sync configuration for the cluster." + "description": "Optional. Config Sync configuration for the cluster." }, "hierarchyController": { "$ref": "ConfigManagementHierarchyControllerConfig", - "description": "Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead." + "deprecated": true, + "description": "Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead." }, "management": { - "description": "Enables automatic Feature management.", + "description": "Optional. Enables automatic Feature management.", "enum": [ "MANAGEMENT_UNSPECIFIED", "MANAGEMENT_AUTOMATIC", @@ -1538,10 +1547,11 @@ }, "policyController": { "$ref": "ConfigManagementPolicyController", - "description": "Policy Controller configuration for the cluster. Deprecated: Configuring Policy Controller through the configmanagement feature is no longer recommended. Use the policycontroller feature instead." + "deprecated": true, + "description": "Optional. Policy Controller configuration for the cluster. Deprecated: Configuring Policy Controller through the configmanagement feature is no longer recommended. Use the policycontroller feature instead." }, "version": { - "description": "Version of ACM installed.", + "description": "Optional. Version of ACM installed.", "type": "string" } }, @@ -1553,31 +1563,38 @@ "properties": { "binauthzState": { "$ref": "ConfigManagementBinauthzState", - "description": "Binauthz status." + "description": "Output only. Binauthz status.", + "readOnly": true }, "clusterName": { - "description": "This field is set to the `cluster_name` field of the Membership Spec if it is not empty. Otherwise, it is set to the cluster's fleet membership name.", + "description": "Output only. This field is set to the `cluster_name` field of the Membership Spec if it is not empty. Otherwise, it is set to the cluster's fleet membership name.", + "readOnly": true, "type": "string" }, "configSyncState": { "$ref": "ConfigManagementConfigSyncState", - "description": "Current sync status." + "description": "Output only. Current sync status.", + "readOnly": true }, "hierarchyControllerState": { "$ref": "ConfigManagementHierarchyControllerState", - "description": "Hierarchy Controller status." + "description": "Output only. Hierarchy Controller status.", + "readOnly": true }, "membershipSpec": { "$ref": "ConfigManagementSpec", - "description": "Membership configuration in the cluster. This represents the actual state in the cluster, while the MembershipSpec in the FeatureSpec represents the intended state." + "description": "Output only. Membership configuration in the cluster. This represents the actual state in the cluster, while the MembershipSpec in the FeatureSpec represents the intended state.", + "readOnly": true }, "operatorState": { "$ref": "ConfigManagementOperatorState", - "description": "Current install status of ACM's Operator." + "description": "Output only. Current install status of ACM's Operator.", + "readOnly": true }, "policyControllerState": { "$ref": "ConfigManagementPolicyControllerState", - "description": "PolicyController status." + "description": "Output only. PolicyController status.", + "readOnly": true } }, "type": "object" diff --git a/gkehub/v2alpha/gkehub-gen.go b/gkehub/v2alpha/gkehub-gen.go index f14d5104fd1..532d67c09d4 100644 --- a/gkehub/v2alpha/gkehub-gen.go +++ b/gkehub/v2alpha/gkehub-gen.go @@ -529,38 +529,39 @@ func (s ConfigManagementBinauthzVersion) MarshalJSON() ([]byte, error) { // ConfigManagementConfigSync: Configuration for Config Sync type ConfigManagementConfigSync struct { - // AllowVerticalScale: Set to true to allow the vertical scaling. Defaults to - // false which disallows vertical scaling. This field is deprecated. + // AllowVerticalScale: Optional. Set to true to allow the vertical scaling. + // Defaults to false which disallows vertical scaling. This field is + // deprecated. AllowVerticalScale bool `json:"allowVerticalScale,omitempty"` - // Enabled: Enables the installation of ConfigSync. If set to true, ConfigSync - // resources will be created and the other ConfigSync fields will be applied if - // exist. If set to false, all other ConfigSync fields will be ignored, - // ConfigSync resources will be deleted. If omitted, ConfigSync resources will - // be managed depends on the presence of the git or oci field. + // Enabled: Optional. Enables the installation of ConfigSync. If set to true, + // ConfigSync resources will be created and the other ConfigSync fields will be + // applied if exist. If set to false, all other ConfigSync fields will be + // ignored, ConfigSync resources will be deleted. If omitted, ConfigSync + // resources will be managed depends on the presence of the git or oci field. Enabled bool `json:"enabled,omitempty"` - // Git: Git repo configuration for the cluster. + // Git: Optional. Git repo configuration for the cluster. Git *ConfigManagementGitConfig `json:"git,omitempty"` - // MetricsGcpServiceAccountEmail: The Email of the Google Cloud Service Account - // (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud - // Monarch when Workload Identity is enabled. The GSA should have the - // Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The - // Kubernetes ServiceAccount `default` in the namespace + // MetricsGcpServiceAccountEmail: Optional. The Email of the Google Cloud + // Service Account (GSA) used for exporting Config Sync metrics to Cloud + // Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA + // should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM + // role. The Kubernetes ServiceAccount `default` in the namespace // `config-management-monitoring` should be bound to the GSA. Deprecated: If // Workload Identity Federation for GKE is enabled, Google Cloud Service // Account is no longer needed for exporting Config Sync metrics: // https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring. MetricsGcpServiceAccountEmail string `json:"metricsGcpServiceAccountEmail,omitempty"` - // Oci: OCI repo configuration for the cluster. + // Oci: Optional. OCI repo configuration for the cluster. Oci *ConfigManagementOciConfig `json:"oci,omitempty"` - // PreventDrift: Set to true to enable the Config Sync admission webhook to - // prevent drifts. If set to `false`, disables the Config Sync admission - // webhook and does not prevent drifts. + // PreventDrift: Optional. Set to true to enable the Config Sync admission + // webhook to prevent drifts. If set to `false`, disables the Config Sync + // admission webhook and does not prevent drifts. PreventDrift bool `json:"preventDrift,omitempty"` - // SourceFormat: Specifies whether the Config Sync Repo is in "hierarchical" or - // "unstructured" mode. + // SourceFormat: Optional. Specifies whether the Config Sync Repo is in + // "hierarchical" or "unstructured" mode. SourceFormat string `json:"sourceFormat,omitempty"` - // StopSyncing: Set to true to stop syncing configs for a single cluster. - // Default to false. + // StopSyncing: Optional. Set to true to stop syncing configs for a single + // cluster. Default to false. StopSyncing bool `json:"stopSyncing,omitempty"` // ForceSendFields is a list of field names (e.g. "AllowVerticalScale") to // unconditionally include in API requests. By default, fields with empty or @@ -708,8 +709,8 @@ func (s ConfigManagementConfigSyncError) MarshalJSON() ([]byte, error) { // ConfigManagementConfigSyncState: State information for ConfigSync. type ConfigManagementConfigSyncState struct { - // ClusterLevelStopSyncingState: Whether syncing resources to the cluster is - // stopped at the cluster level. + // ClusterLevelStopSyncingState: Output only. Whether syncing resources to the + // cluster is stopped at the cluster level. // // Possible values: // "STOP_SYNCING_STATE_UNSPECIFIED" - State cannot be determined @@ -723,12 +724,12 @@ type ConfigManagementConfigSyncState struct { // CrCount: Output only. The number of RootSync and RepoSync CRs in the // cluster. CrCount int64 `json:"crCount,omitempty"` - // DeploymentState: Information about the deployment of ConfigSync, including - // the version. of the various Pods deployed + // DeploymentState: Output only. Information about the deployment of + // ConfigSync, including the version. of the various Pods deployed DeploymentState *ConfigManagementConfigSyncDeploymentState `json:"deploymentState,omitempty"` - // Errors: Errors pertaining to the installation of Config Sync. + // Errors: Output only. Errors pertaining to the installation of Config Sync. Errors []*ConfigManagementConfigSyncError `json:"errors,omitempty"` - // ReposyncCrd: The state of the Reposync CRD + // ReposyncCrd: Output only. The state of the Reposync CRD // // Possible values: // "CRD_STATE_UNSPECIFIED" - CRD's state cannot be determined @@ -738,7 +739,7 @@ type ConfigManagementConfigSyncState struct { // cleaning up) // "INSTALLING" - CRD is installing ReposyncCrd string `json:"reposyncCrd,omitempty"` - // RootsyncCrd: The state of the RootSync CRD + // RootsyncCrd: Output only. The state of the RootSync CRD // // Possible values: // "CRD_STATE_UNSPECIFIED" - CRD's state cannot be determined @@ -748,8 +749,8 @@ type ConfigManagementConfigSyncState struct { // cleaning up) // "INSTALLING" - CRD is installing RootsyncCrd string `json:"rootsyncCrd,omitempty"` - // State: The state of CS This field summarizes the other fields in this - // message. + // State: Output only. The state of CS This field summarizes the other fields + // in this message. // // Possible values: // "STATE_UNSPECIFIED" - CS's state cannot be determined. @@ -759,9 +760,10 @@ type ConfigManagementConfigSyncState struct { // "CONFIG_SYNC_ERROR" - CS encounters errors. // "CONFIG_SYNC_PENDING" - CS is installing or terminating. State string `json:"state,omitempty"` - // SyncState: The state of ConfigSync's process to sync configs to a cluster. + // SyncState: Output only. The state of ConfigSync's process to sync configs to + // a cluster. SyncState *ConfigManagementSyncState `json:"syncState,omitempty"` - // Version: The version of ConfigSync deployed. + // Version: Output only. The version of ConfigSync deployed. Version *ConfigManagementConfigSyncVersion `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. // "ClusterLevelStopSyncingState") to unconditionally include in API requests. @@ -902,26 +904,30 @@ func (s ConfigManagementGatekeeperDeploymentState) MarshalJSON() ([]byte, error) // ConfigManagementGitConfig: Git repo configuration for a single cluster. type ConfigManagementGitConfig struct { - // GcpServiceAccountEmail: The Google Cloud Service Account Email used for auth - // when secret_type is gcpServiceAccount. + // GcpServiceAccountEmail: Optional. The Google Cloud Service Account Email + // used for auth when secret_type is gcpServiceAccount. GcpServiceAccountEmail string `json:"gcpServiceAccountEmail,omitempty"` - // HttpsProxy: URL for the HTTPS proxy to be used when communicating with the - // Git repo. + // HttpsProxy: Optional. URL for the HTTPS proxy to be used when communicating + // with the Git repo. HttpsProxy string `json:"httpsProxy,omitempty"` - // PolicyDir: The path within the Git repository that represents the top level - // of the repo to sync. Default: the root directory of the repository. + // PolicyDir: Optional. The path within the Git repository that represents the + // top level of the repo to sync. Default: the root directory of the + // repository. PolicyDir string `json:"policyDir,omitempty"` - // SecretType: Type of secret configured for access to the Git repo. Must be - // one of ssh, cookiefile, gcenode, token, gcpserviceaccount or none. The - // validation of this is case-sensitive. Required. + // SecretType: Required. Type of secret configured for access to the Git repo. + // Must be one of ssh, cookiefile, gcenode, token, gcpserviceaccount or none. + // The validation of this is case-sensitive. Required. SecretType string `json:"secretType,omitempty"` - // SyncBranch: The branch of the repository to sync from. Default: master. + // SyncBranch: Optional. The branch of the repository to sync from. Default: + // master. SyncBranch string `json:"syncBranch,omitempty"` - // SyncRepo: The URL of the Git repository to use as the source of truth. + // SyncRepo: Optional. The URL of the Git repository to use as the source of + // truth. SyncRepo string `json:"syncRepo,omitempty"` - // SyncRev: Git revision (tag or hash) to check out. Default HEAD. + // SyncRev: Optional. Git revision (tag or hash) to check out. Default HEAD. SyncRev string `json:"syncRev,omitempty"` - // SyncWaitSecs: Period in seconds between consecutive syncs. Default: 15. + // SyncWaitSecs: Optional. Period in seconds between consecutive syncs. + // Default: 15. SyncWaitSecs int64 `json:"syncWaitSecs,omitempty,string"` // ForceSendFields is a list of field names (e.g. "GcpServiceAccountEmail") to // unconditionally include in API requests. By default, fields with empty or @@ -1109,18 +1115,20 @@ func (s ConfigManagementInstallError) MarshalJSON() ([]byte, error) { // ConfigManagementOciConfig: OCI repo configuration for a single cluster. type ConfigManagementOciConfig struct { - // GcpServiceAccountEmail: The Google Cloud Service Account Email used for auth - // when secret_type is gcpServiceAccount. + // GcpServiceAccountEmail: Optional. The Google Cloud Service Account Email + // used for auth when secret_type is gcpServiceAccount. GcpServiceAccountEmail string `json:"gcpServiceAccountEmail,omitempty"` - // PolicyDir: The absolute path of the directory that contains the local - // resources. Default: the root directory of the image. + // PolicyDir: Optional. The absolute path of the directory that contains the + // local resources. Default: the root directory of the image. PolicyDir string `json:"policyDir,omitempty"` - // SecretType: Type of secret configured for access to the Git repo. + // SecretType: Optional. Type of secret configured for access to the Git repo. SecretType string `json:"secretType,omitempty"` - // SyncRepo: The OCI image repository URL for the package to sync from. e.g. + // SyncRepo: Optional. The OCI image repository URL for the package to sync + // from. e.g. // `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`. SyncRepo string `json:"syncRepo,omitempty"` - // SyncWaitSecs: Period in seconds between consecutive syncs. Default: 15. + // SyncWaitSecs: Optional. Period in seconds between consecutive syncs. + // Default: 15. SyncWaitSecs int64 `json:"syncWaitSecs,omitempty,string"` // ForceSendFields is a list of field names (e.g. "GcpServiceAccountEmail") to // unconditionally include in API requests. By default, fields with empty or @@ -1334,10 +1342,10 @@ func (s ConfigManagementPolicyControllerVersion) MarshalJSON() ([]byte, error) { // ConfigManagementSpec: **Anthos Config Management**: Configuration for a // single cluster. Intended to parallel the ConfigManagement CR. type ConfigManagementSpec struct { - // Binauthz: Binauthz conifguration for the cluster. Deprecated: This field - // will be ignored and should not be set. + // Binauthz: Optional. Binauthz conifguration for the cluster. Deprecated: This + // field will be ignored and should not be set. Binauthz *ConfigManagementBinauthzConfig `json:"binauthz,omitempty"` - // Cluster: The user-specified cluster name used by Config Sync + // Cluster: Optional. The user-specified cluster name used by Config Sync // cluster-name-selector annotation or ClusterSelector, for applying configs to // only a subset of clusters. Omit this field if the cluster's fleet membership // name is used by Config Sync cluster-name-selector annotation or @@ -1345,14 +1353,14 @@ type ConfigManagementSpec struct { // membership name is used by Config Sync cluster-name-selector annotation or // ClusterSelector. Cluster string `json:"cluster,omitempty"` - // ConfigSync: Config Sync configuration for the cluster. + // ConfigSync: Optional. Config Sync configuration for the cluster. ConfigSync *ConfigManagementConfigSync `json:"configSync,omitempty"` - // HierarchyController: Hierarchy Controller configuration for the cluster. - // Deprecated: Configuring Hierarchy Controller through the configmanagement - // feature is no longer recommended. Use + // HierarchyController: Optional. Hierarchy Controller configuration for the + // cluster. Deprecated: Configuring Hierarchy Controller through the + // configmanagement feature is no longer recommended. Use // https://github.com/kubernetes-sigs/hierarchical-namespaces instead. HierarchyController *ConfigManagementHierarchyControllerConfig `json:"hierarchyController,omitempty"` - // Management: Enables automatic Feature management. + // Management: Optional. Enables automatic Feature management. // // Possible values: // "MANAGEMENT_UNSPECIFIED" - Unspecified @@ -1360,11 +1368,11 @@ type ConfigManagementSpec struct { // "MANAGEMENT_MANUAL" - User will manually manage the Feature for the // cluster. Management string `json:"management,omitempty"` - // PolicyController: Policy Controller configuration for the cluster. + // PolicyController: Optional. Policy Controller configuration for the cluster. // Deprecated: Configuring Policy Controller through the configmanagement // feature is no longer recommended. Use the policycontroller feature instead. PolicyController *ConfigManagementPolicyController `json:"policyController,omitempty"` - // Version: Version of ACM installed. + // Version: Optional. Version of ACM installed. Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "Binauthz") to // unconditionally include in API requests. By default, fields with empty or @@ -1387,23 +1395,23 @@ func (s ConfigManagementSpec) MarshalJSON() ([]byte, error) { // ConfigManagementState: **Anthos Config Management**: State for a single // cluster. type ConfigManagementState struct { - // BinauthzState: Binauthz status. + // BinauthzState: Output only. Binauthz status. BinauthzState *ConfigManagementBinauthzState `json:"binauthzState,omitempty"` - // ClusterName: This field is set to the `cluster_name` field of the Membership - // Spec if it is not empty. Otherwise, it is set to the cluster's fleet - // membership name. + // ClusterName: Output only. This field is set to the `cluster_name` field of + // the Membership Spec if it is not empty. Otherwise, it is set to the + // cluster's fleet membership name. ClusterName string `json:"clusterName,omitempty"` - // ConfigSyncState: Current sync status. + // ConfigSyncState: Output only. Current sync status. ConfigSyncState *ConfigManagementConfigSyncState `json:"configSyncState,omitempty"` - // HierarchyControllerState: Hierarchy Controller status. + // HierarchyControllerState: Output only. Hierarchy Controller status. HierarchyControllerState *ConfigManagementHierarchyControllerState `json:"hierarchyControllerState,omitempty"` - // MembershipSpec: Membership configuration in the cluster. This represents the - // actual state in the cluster, while the MembershipSpec in the FeatureSpec - // represents the intended state. + // MembershipSpec: Output only. Membership configuration in the cluster. This + // represents the actual state in the cluster, while the MembershipSpec in the + // FeatureSpec represents the intended state. MembershipSpec *ConfigManagementSpec `json:"membershipSpec,omitempty"` - // OperatorState: Current install status of ACM's Operator. + // OperatorState: Output only. Current install status of ACM's Operator. OperatorState *ConfigManagementOperatorState `json:"operatorState,omitempty"` - // PolicyControllerState: PolicyController status. + // PolicyControllerState: Output only. PolicyController status. PolicyControllerState *ConfigManagementPolicyControllerState `json:"policyControllerState,omitempty"` // ForceSendFields is a list of field names (e.g. "BinauthzState") to // unconditionally include in API requests. By default, fields with empty or diff --git a/go.mod b/go.mod index d3f63ecdcfb..78ccfdf0e87 100644 --- a/go.mod +++ b/go.mod @@ -1,6 +1,6 @@ module google.golang.org/api -go 1.21 +go 1.22 require ( cloud.google.com/go/auth v0.13.0 @@ -14,12 +14,12 @@ require ( go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc v0.54.0 go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.54.0 golang.org/x/net v0.33.0 - golang.org/x/oauth2 v0.24.0 + golang.org/x/oauth2 v0.25.0 golang.org/x/sync v0.10.0 - golang.org/x/time v0.8.0 - google.golang.org/genproto/googleapis/bytestream v0.0.0-20241223144023-3abc09e42ca8 - google.golang.org/genproto/googleapis/rpc v0.0.0-20241223144023-3abc09e42ca8 - google.golang.org/grpc v1.67.1 + golang.org/x/time v0.9.0 + google.golang.org/genproto/googleapis/bytestream v0.0.0-20250102185135-69823020774d + google.golang.org/genproto/googleapis/rpc v0.0.0-20250102185135-69823020774d + google.golang.org/grpc v1.69.2 google.golang.org/protobuf v1.36.1 ) @@ -27,9 +27,9 @@ require ( github.com/felixge/httpsnoop v1.0.4 // indirect github.com/go-logr/logr v1.4.2 // indirect github.com/go-logr/stdr v1.2.2 // indirect - go.opentelemetry.io/otel v1.29.0 // indirect - go.opentelemetry.io/otel/metric v1.29.0 // indirect - go.opentelemetry.io/otel/trace v1.29.0 // indirect + go.opentelemetry.io/otel v1.31.0 // indirect + go.opentelemetry.io/otel/metric v1.31.0 // indirect + go.opentelemetry.io/otel/trace v1.31.0 // indirect golang.org/x/crypto v0.31.0 // indirect golang.org/x/sys v0.28.0 // indirect golang.org/x/text v0.21.0 // indirect diff --git a/go.sum b/go.sum index c35545d8548..03a204d65fd 100644 --- a/go.sum +++ b/go.sum @@ -13,6 +13,8 @@ github.com/go-logr/logr v1.4.2 h1:6pFjapn8bFcIbiKo3XT4j/BhANplGihG6tvd+8rYgrY= github.com/go-logr/logr v1.4.2/go.mod h1:9T104GzyrTigFIr8wt5mBrctHMim0Nb2HLGrmQ40KvY= github.com/go-logr/stdr v1.2.2 h1:hSWxHoqTgW2S2qGc0LTAI563KZ5YKYRhT3MFKZMbjag= github.com/go-logr/stdr v1.2.2/go.mod h1:mMo/vtBO5dYbehREoey6XUKy/eSumjCCveDpRre4VKE= +github.com/golang/protobuf v1.5.4 h1:i7eJL8qZTpSEXOPTxNKhASYpMn+8e5Q6AdndVa1dWek= +github.com/golang/protobuf v1.5.4/go.mod h1:lnTiLA8Wa4RWRcIUkrtSVa5nRhsEGBg48fD6rSs7xps= github.com/google/go-cmp v0.6.0 h1:ofyhxvXcZhMsU5ulbFiLKl/XBFqE1GSq7atu8tAmTRI= github.com/google/go-cmp v0.6.0/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY= github.com/google/s2a-go v0.1.8 h1:zZDs9gcbt9ZPLV0ndSyQk6Kacx2g/X+SKYovpnz3SMM= @@ -31,34 +33,38 @@ go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc v0.5 go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc v0.54.0/go.mod h1:B9yO6b04uB80CzjedvewuqDhxJxi11s7/GtiGa8bAjI= go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.54.0 h1:TT4fX+nBOA/+LUkobKGW1ydGcn+G3vRw9+g5HwCphpk= go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.54.0/go.mod h1:L7UH0GbB0p47T4Rri3uHjbpCFYrVrwc1I25QhNPiGK8= -go.opentelemetry.io/otel v1.29.0 h1:PdomN/Al4q/lN6iBJEN3AwPvUiHPMlt93c8bqTG5Llw= -go.opentelemetry.io/otel v1.29.0/go.mod h1:N/WtXPs1CNCUEx+Agz5uouwCba+i+bJGFicT8SR4NP8= -go.opentelemetry.io/otel/metric v1.29.0 h1:vPf/HFWTNkPu1aYeIsc98l4ktOQaL6LeSoeV2g+8YLc= -go.opentelemetry.io/otel/metric v1.29.0/go.mod h1:auu/QWieFVWx+DmQOUMgj0F8LHWdgalxXqvp7BII/W8= -go.opentelemetry.io/otel/trace v1.29.0 h1:J/8ZNK4XgR7a21DZUAsbF8pZ5Jcw1VhACmnYt39JTi4= -go.opentelemetry.io/otel/trace v1.29.0/go.mod h1:eHl3w0sp3paPkYstJOmAimxhiFXPg+MMTlEh3nsQgWQ= +go.opentelemetry.io/otel v1.31.0 h1:NsJcKPIW0D0H3NgzPDHmo0WW6SptzPdqg/L1zsIm2hY= +go.opentelemetry.io/otel v1.31.0/go.mod h1:O0C14Yl9FgkjqcCZAsE053C13OaddMYr/hz6clDkEJE= +go.opentelemetry.io/otel/metric v1.31.0 h1:FSErL0ATQAmYHUIzSezZibnyVlft1ybhy4ozRPcF2fE= +go.opentelemetry.io/otel/metric v1.31.0/go.mod h1:C3dEloVbLuYoX41KpmAhOqNriGbA+qqH6PQ5E5mUfnY= +go.opentelemetry.io/otel/sdk v1.31.0 h1:xLY3abVHYZ5HSfOg3l2E5LUj2Cwva5Y7yGxnSW9H5Gk= +go.opentelemetry.io/otel/sdk v1.31.0/go.mod h1:TfRbMdhvxIIr/B2N2LQW2S5v9m3gOQ/08KsbbO5BPT0= +go.opentelemetry.io/otel/sdk/metric v1.31.0 h1:i9hxxLJF/9kkvfHppyLL55aW7iIJz4JjxTeYusH7zMc= +go.opentelemetry.io/otel/sdk/metric v1.31.0/go.mod h1:CRInTMVvNhUKgSAMbKyTMxqOBC0zgyxzW55lZzX43Y8= +go.opentelemetry.io/otel/trace v1.31.0 h1:ffjsj1aRouKewfr85U2aGagJ46+MvodynlQ1HYdmJys= +go.opentelemetry.io/otel/trace v1.31.0/go.mod h1:TXZkRk7SM2ZQLtR6eoAWQFIHPvzQ06FJAsO1tJg480A= golang.org/x/crypto v0.31.0 h1:ihbySMvVjLAeSH1IbfcRTkD/iNscyz8rGzjF/E5hV6U= golang.org/x/crypto v0.31.0/go.mod h1:kDsLvtWBEx7MV9tJOj9bnXsPbxwJQ6csT/x4KIN4Ssk= golang.org/x/net v0.33.0 h1:74SYHlV8BIgHIFC/LrYkOGIwL19eTYXQ5wc6TBuO36I= golang.org/x/net v0.33.0/go.mod h1:HXLR5J+9DxmrqMwG9qjGCxZ+zKXxBru04zlTvWlWuN4= -golang.org/x/oauth2 v0.24.0 h1:KTBBxWqUa0ykRPLtV69rRto9TLXcqYkeswu48x/gvNE= -golang.org/x/oauth2 v0.24.0/go.mod h1:XYTD2NtWslqkgxebSiOHnXEap4TF09sJSc7H1sXbhtI= +golang.org/x/oauth2 v0.25.0 h1:CY4y7XT9v0cRI9oupztF8AgiIu99L/ksR/Xp/6jrZ70= +golang.org/x/oauth2 v0.25.0/go.mod h1:XYTD2NtWslqkgxebSiOHnXEap4TF09sJSc7H1sXbhtI= golang.org/x/sync v0.10.0 h1:3NQrjDixjgGwUOCaF8w2+VYHv0Ve/vGYSbdkTa98gmQ= golang.org/x/sync v0.10.0/go.mod h1:Czt+wKu1gCyEFDUtn0jG5QVvpJ6rzVqr5aXyt9drQfk= golang.org/x/sys v0.28.0 h1:Fksou7UEQUWlKvIdsqzJmUmCX3cZuD2+P3XyyzwMhlA= golang.org/x/sys v0.28.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA= golang.org/x/text v0.21.0 h1:zyQAAkrwaneQ066sspRyJaG9VNi/YJ1NfzcGB3hZ/qo= golang.org/x/text v0.21.0/go.mod h1:4IBbMaMmOPCJ8SecivzSH54+73PCFmPWxNTLm+vZkEQ= -golang.org/x/time v0.8.0 h1:9i3RxcPv3PZnitoVGMPDKZSq1xW1gK1Xy3ArNOGZfEg= -golang.org/x/time v0.8.0/go.mod h1:3BpzKBy/shNhVucY/MWOyx10tF3SFh9QdLuxbVysPQM= +golang.org/x/time v0.9.0 h1:EsRrnYcQiGH+5FfbgvV4AP7qEZstoyrHB0DzarOQ4ZY= +golang.org/x/time v0.9.0/go.mod h1:3BpzKBy/shNhVucY/MWOyx10tF3SFh9QdLuxbVysPQM= google.golang.org/genproto/googleapis/api v0.0.0-20241209162323-e6fa225c2576 h1:CkkIfIt50+lT6NHAVoRYEyAvQGFM7xEwXUUywFvEb3Q= google.golang.org/genproto/googleapis/api v0.0.0-20241209162323-e6fa225c2576/go.mod h1:1R3kvZ1dtP3+4p4d3G8uJ8rFk/fWlScl38vanWACI08= -google.golang.org/genproto/googleapis/bytestream v0.0.0-20241223144023-3abc09e42ca8 h1:qlXhWiX84AGgaN7LuORWBEQCCTqj3szNbh2am45O3W8= -google.golang.org/genproto/googleapis/bytestream v0.0.0-20241223144023-3abc09e42ca8/go.mod h1:bLYPejkLzwgJuAHlIk1gdPOlx9CUYXLZi2rZxL/ursM= -google.golang.org/genproto/googleapis/rpc v0.0.0-20241223144023-3abc09e42ca8 h1:TqExAhdPaB60Ux47Cn0oLV07rGnxZzIsaRhQaqS666A= -google.golang.org/genproto/googleapis/rpc v0.0.0-20241223144023-3abc09e42ca8/go.mod h1:lcTa1sDdWEIHMWlITnIczmw5w60CF9ffkb8Z+DVmmjA= -google.golang.org/grpc v1.67.1 h1:zWnc1Vrcno+lHZCOofnIMvycFcc0QRGIzm9dhnDX68E= -google.golang.org/grpc v1.67.1/go.mod h1:1gLDyUQU7CTLJI90u3nXZ9ekeghjeM7pTDZlqFNg2AA= +google.golang.org/genproto/googleapis/bytestream v0.0.0-20250102185135-69823020774d h1:NZBSeFsuFS5YrgHMW/8xfTbzNXMshQPNgq2Yb7xipEs= +google.golang.org/genproto/googleapis/bytestream v0.0.0-20250102185135-69823020774d/go.mod h1:s4mHJ3FfG8P6A3O+gZ8TVqB3ufjOl9UG3ANCMMwCHmo= +google.golang.org/genproto/googleapis/rpc v0.0.0-20250102185135-69823020774d h1:xJJRGY7TJcvIlpSrN3K6LAWgNFUILlO+OMAqtg9aqnw= +google.golang.org/genproto/googleapis/rpc v0.0.0-20250102185135-69823020774d/go.mod h1:3ENsm/5D1mzDyhpzeRi1NR784I0BcofWBoSc5QqqMK4= +google.golang.org/grpc v1.69.2 h1:U3S9QEtbXC0bYNvRtcoklF3xGtLViumSYxWykJS+7AU= +google.golang.org/grpc v1.69.2/go.mod h1:vyjdE6jLBI76dgpDojsFGNaHlxdjXN9ghpnd2o7JGZ4= google.golang.org/protobuf v1.36.1 h1:yBPeRvTftaleIgM3PZ/WBIZ7XM/eEYAaEyCwvyjq/gk= google.golang.org/protobuf v1.36.1/go.mod h1:9fA7Ob0pmnwhb644+1+CVWFRbNajQ6iRojtC/QF5bRE= gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA= diff --git a/go.work b/go.work index 6ac9264e8cd..38292e939aa 100644 --- a/go.work +++ b/go.work @@ -1,4 +1,4 @@ -go 1.21 +go 1.22 use ( . diff --git a/internal/kokoro/discogen/go.mod b/internal/kokoro/discogen/go.mod index 86e85a537f8..12017dd1a81 100644 --- a/internal/kokoro/discogen/go.mod +++ b/internal/kokoro/discogen/go.mod @@ -1,13 +1,11 @@ module google.golang.org/api/internal/kokoro/discogen -go 1.21 - -toolchain go1.21.13 +go 1.22 require ( - github.com/go-git/go-git/v5 v5.13.0 + github.com/go-git/go-git/v5 v5.13.1 github.com/google/go-github/v59 v59.0.0 - golang.org/x/oauth2 v0.24.0 + golang.org/x/oauth2 v0.25.0 ) require ( @@ -15,10 +13,10 @@ require ( github.com/Microsoft/go-winio v0.6.1 // indirect github.com/ProtonMail/go-crypto v1.1.3 // indirect github.com/cloudflare/circl v1.3.7 // indirect - github.com/cyphar/filepath-securejoin v0.2.5 // indirect + github.com/cyphar/filepath-securejoin v0.3.6 // indirect github.com/emirpasic/gods v1.18.1 // indirect github.com/go-git/gcfg v1.5.1-0.20230307220236-3a3c6141e376 // indirect - github.com/go-git/go-billy/v5 v5.6.0 // indirect + github.com/go-git/go-billy/v5 v5.6.1 // indirect github.com/golang/groupcache v0.0.0-20210331224755-41bb18bfe9da // indirect github.com/google/go-querystring v1.1.0 // indirect github.com/jbenet/go-context v0.0.0-20150711004518-d14ea06fba99 // indirect diff --git a/internal/kokoro/discogen/go.sum b/internal/kokoro/discogen/go.sum index 57db4d26ec0..2f559f81883 100644 --- a/internal/kokoro/discogen/go.sum +++ b/internal/kokoro/discogen/go.sum @@ -11,25 +11,25 @@ github.com/armon/go-socks5 v0.0.0-20160902184237-e75332964ef5 h1:0CwZNZbxp69SHPd github.com/armon/go-socks5 v0.0.0-20160902184237-e75332964ef5/go.mod h1:wHh0iHkYZB8zMSxRWpUBQtwG5a7fFgvEO+odwuTv2gs= github.com/cloudflare/circl v1.3.7 h1:qlCDlTPz2n9fu58M0Nh1J/JzcFpfgkFHHX3O35r5vcU= github.com/cloudflare/circl v1.3.7/go.mod h1:sRTcRWXGLrKw6yIGJ+l7amYJFfAXbZG0kBSc8r4zxgA= -github.com/cyphar/filepath-securejoin v0.2.5 h1:6iR5tXJ/e6tJZzzdMc1km3Sa7RRIVBKAK32O2s7AYfo= -github.com/cyphar/filepath-securejoin v0.2.5/go.mod h1:aPGpWjXOXUn2NCNjFvBE6aRxGGx79pTxQpKOJNYHHl4= +github.com/cyphar/filepath-securejoin v0.3.6 h1:4d9N5ykBnSp5Xn2JkhocYDkOpURL/18CYMpo6xB9uWM= +github.com/cyphar/filepath-securejoin v0.3.6/go.mod h1:Sdj7gXlvMcPZsbhwhQ33GguGLDGQL7h7bg04C/+u9jI= github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c= github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= -github.com/elazarl/goproxy v1.2.1 h1:njjgvO6cRG9rIqN2ebkqy6cQz2Njkx7Fsfv/zIZqgug= -github.com/elazarl/goproxy v1.2.1/go.mod h1:YfEbZtqP4AetfO6d40vWchF3znWX7C7Vd6ZMfdL8z64= +github.com/elazarl/goproxy v1.2.3 h1:xwIyKHbaP5yfT6O9KIeYJR5549MXRQkoQMRXGztz8YQ= +github.com/elazarl/goproxy v1.2.3/go.mod h1:YfEbZtqP4AetfO6d40vWchF3znWX7C7Vd6ZMfdL8z64= github.com/emirpasic/gods v1.18.1 h1:FXtiHYKDGKCW2KzwZKx0iC0PQmdlorYgdFG9jPXJ1Bc= github.com/emirpasic/gods v1.18.1/go.mod h1:8tpGGwCnJ5H4r6BWwaV6OrWmMoPhUl5jm/FMNAnJvWQ= github.com/gliderlabs/ssh v0.3.8 h1:a4YXD1V7xMF9g5nTkdfnja3Sxy1PVDCj1Zg4Wb8vY6c= github.com/gliderlabs/ssh v0.3.8/go.mod h1:xYoytBv1sV0aL3CavoDuJIQNURXkkfPA/wxQ1pL1fAU= github.com/go-git/gcfg v1.5.1-0.20230307220236-3a3c6141e376 h1:+zs/tPmkDkHx3U66DAb0lQFJrpS6731Oaa12ikc+DiI= github.com/go-git/gcfg v1.5.1-0.20230307220236-3a3c6141e376/go.mod h1:an3vInlBmSxCcxctByoQdvwPiA7DTK7jaaFDBTtu0ic= -github.com/go-git/go-billy/v5 v5.6.0 h1:w2hPNtoehvJIxR00Vb4xX94qHQi/ApZfX+nBE2Cjio8= -github.com/go-git/go-billy/v5 v5.6.0/go.mod h1:sFDq7xD3fn3E0GOwUSZqHo9lrkmx8xJhA0ZrfvjBRGM= +github.com/go-git/go-billy/v5 v5.6.1 h1:u+dcrgaguSSkbjzHwelEjc0Yj300NUevrrPphk/SoRA= +github.com/go-git/go-billy/v5 v5.6.1/go.mod h1:0AsLr1z2+Uksi4NlElmMblP5rPcDZNRCD8ujZCRR2BE= github.com/go-git/go-git-fixtures/v4 v4.3.2-0.20231010084843-55a94097c399 h1:eMje31YglSBqCdIqdhKBW8lokaMrL3uTkpGYlE2OOT4= github.com/go-git/go-git-fixtures/v4 v4.3.2-0.20231010084843-55a94097c399/go.mod h1:1OCfN199q1Jm3HZlxleg+Dw/mwps2Wbk9frAWm+4FII= -github.com/go-git/go-git/v5 v5.13.0 h1:vLn5wlGIh/X78El6r3Jr+30W16Blk0CTcxTYcYPWi5E= -github.com/go-git/go-git/v5 v5.13.0/go.mod h1:Wjo7/JyVKtQgUNdXYXIepzWfJQkUEIGvkvVkiXRR/zw= +github.com/go-git/go-git/v5 v5.13.1 h1:DAQ9APonnlvSWpvolXWIuV6Q6zXy2wHbN4cVlNR5Q+M= +github.com/go-git/go-git/v5 v5.13.1/go.mod h1:qryJB4cSBoq3FRoBRf5A77joojuBcmPJ0qu3XXXVixc= github.com/golang/groupcache v0.0.0-20210331224755-41bb18bfe9da h1:oI5xCqsCo564l8iNU+DwB5epxmsaqB+rhGL0m5jtYqE= github.com/golang/groupcache v0.0.0-20210331224755-41bb18bfe9da/go.mod h1:cIg4eruTrX1D+g88fzRXU5OdNfaM+9IcxsU14FzY7Hc= github.com/google/go-cmp v0.5.2/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= @@ -58,8 +58,8 @@ github.com/pkg/errors v0.9.1 h1:FEBLx1zS214owpjy7qsBeixbURkuhQAwrK5UwLGTwt4= github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= -github.com/rogpeppe/go-internal v1.11.0 h1:cWPaGQEPrBb5/AsnsZesgZZ9yb1OQ+GOISoDNXVBh4M= -github.com/rogpeppe/go-internal v1.11.0/go.mod h1:ddIwULY96R17DhadqLgMfk9H9tvdUzkipdSkR5nkCZA= +github.com/rogpeppe/go-internal v1.12.0 h1:exVL4IDcn6na9z1rAb56Vxr+CgyK3nn3O+epU5NdKM8= +github.com/rogpeppe/go-internal v1.12.0/go.mod h1:E+RYuTGaKKdloAfM02xzb0FW3Paa99yedzYV+kq4uf4= github.com/sergi/go-diff v1.3.2-0.20230802210424-5b0b94c5c0d3 h1:n661drycOFuPLCN3Uc8sB6B/s6Z4t2xvBgU1htSHuq8= github.com/sergi/go-diff v1.3.2-0.20230802210424-5b0b94c5c0d3/go.mod h1:A0bzQcvG0E7Rwjx0REVgAGH58e96+X0MeOfepqsbeW4= github.com/sirupsen/logrus v1.7.0/go.mod h1:yWOB1SBYBC5VeMP7gHvWumXLIWorT60ONWic61uBYv0= @@ -82,8 +82,8 @@ golang.org/x/mod v0.17.0/go.mod h1:hTbmBsO62+eylJbnUtE2MGJUyE7QWk4xUqPFrRgJ+7c= golang.org/x/net v0.0.0-20211112202133-69e39bad7dc2/go.mod h1:9nx3DQGgdP8bBQD5qxJ1jj9UTztislL4KSBs9R2vV5Y= golang.org/x/net v0.33.0 h1:74SYHlV8BIgHIFC/LrYkOGIwL19eTYXQ5wc6TBuO36I= golang.org/x/net v0.33.0/go.mod h1:HXLR5J+9DxmrqMwG9qjGCxZ+zKXxBru04zlTvWlWuN4= -golang.org/x/oauth2 v0.24.0 h1:KTBBxWqUa0ykRPLtV69rRto9TLXcqYkeswu48x/gvNE= -golang.org/x/oauth2 v0.24.0/go.mod h1:XYTD2NtWslqkgxebSiOHnXEap4TF09sJSc7H1sXbhtI= +golang.org/x/oauth2 v0.25.0 h1:CY4y7XT9v0cRI9oupztF8AgiIu99L/ksR/Xp/6jrZ70= +golang.org/x/oauth2 v0.25.0/go.mod h1:XYTD2NtWslqkgxebSiOHnXEap4TF09sJSc7H1sXbhtI= golang.org/x/sync v0.10.0 h1:3NQrjDixjgGwUOCaF8w2+VYHv0Ve/vGYSbdkTa98gmQ= golang.org/x/sync v0.10.0/go.mod h1:Czt+wKu1gCyEFDUtn0jG5QVvpJ6rzVqr5aXyt9drQfk= golang.org/x/sys v0.0.0-20191026070338-33540a1f6037/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= diff --git a/internal/version.go b/internal/version.go index 63449651ff8..6920d538153 100644 --- a/internal/version.go +++ b/internal/version.go @@ -5,4 +5,4 @@ package internal // Version is the current tagged release of the library. -const Version = "0.215.0" +const Version = "0.216.0" diff --git a/language/v1/language-api.json b/language/v1/language-api.json index 16b76bb26df..4f414cacbf1 100644 --- a/language/v1/language-api.json +++ b/language/v1/language-api.json @@ -246,7 +246,7 @@ } } }, - "revision": "20241103", + "revision": "20250105", "rootUrl": "https://language.googleapis.com/", "schemas": { "AnalyzeEntitiesRequest": { @@ -761,6 +761,7 @@ "A3_HIGHGPU_4G", "A3_HIGHGPU_8G", "A3_MEGAGPU_8G", + "A3_ULTRAGPU_8G", "E2_STANDARD_2", "E2_STANDARD_4", "E2_STANDARD_8", @@ -1050,6 +1051,7 @@ "", "", "", + "", "" ], "type": "string" @@ -1486,6 +1488,7 @@ "A3_HIGHGPU_4G", "A3_HIGHGPU_8G", "A3_MEGAGPU_8G", + "A3_ULTRAGPU_8G", "E2_STANDARD_2", "E2_STANDARD_4", "E2_STANDARD_8", @@ -1775,6 +1778,7 @@ "", "", "", + "", "" ], "type": "string" @@ -2170,6 +2174,7 @@ "A3_HIGHGPU_4G", "A3_HIGHGPU_8G", "A3_MEGAGPU_8G", + "A3_ULTRAGPU_8G", "E2_STANDARD_2", "E2_STANDARD_4", "E2_STANDARD_8", @@ -2459,6 +2464,7 @@ "", "", "", + "", "" ], "type": "string" @@ -3640,6 +3646,7 @@ "NVIDIA_L4", "NVIDIA_H100_80GB", "NVIDIA_H100_MEGA_80GB", + "NVIDIA_H200_141GB", "TPU_V2", "TPU_V3", "TPU_V4_POD", @@ -3657,6 +3664,7 @@ "Nvidia L4 GPU.", "Nvidia H100 80Gb GPU.", "Nvidia H100 80Gb GPU.", + "Nvidia H200 141Gb GPU.", "TPU v2 (JellyFish).", "TPU v3 (DragonFish).", "TPU_v4 (PufferFish).", diff --git a/language/v1/language-gen.go b/language/v1/language-gen.go index a981d929c60..cfc562df19b 100644 --- a/language/v1/language-gen.go +++ b/language/v1/language-gen.go @@ -892,6 +892,7 @@ type CpuMetric struct { // "A3_HIGHGPU_4G" // "A3_HIGHGPU_8G" // "A3_MEGAGPU_8G" + // "A3_ULTRAGPU_8G" // "E2_STANDARD_2" // "E2_STANDARD_4" // "E2_STANDARD_8" @@ -1410,6 +1411,7 @@ type GpuMetric struct { // "A3_HIGHGPU_4G" // "A3_HIGHGPU_8G" // "A3_MEGAGPU_8G" + // "A3_ULTRAGPU_8G" // "E2_STANDARD_2" // "E2_STANDARD_4" // "E2_STANDARD_8" @@ -1844,6 +1846,7 @@ type RamMetric struct { // "A3_HIGHGPU_4G" // "A3_HIGHGPU_8G" // "A3_MEGAGPU_8G" + // "A3_ULTRAGPU_8G" // "E2_STANDARD_2" // "E2_STANDARD_4" // "E2_STANDARD_8" @@ -3486,6 +3489,7 @@ type XPSImageModelServingSpecModelThroughputEstimation struct { // "NVIDIA_L4" - Nvidia L4 GPU. // "NVIDIA_H100_80GB" - Nvidia H100 80Gb GPU. // "NVIDIA_H100_MEGA_80GB" - Nvidia H100 80Gb GPU. + // "NVIDIA_H200_141GB" - Nvidia H200 141Gb GPU. // "TPU_V2" - TPU v2 (JellyFish). // "TPU_V3" - TPU v3 (DragonFish). // "TPU_V4_POD" - TPU_v4 (PufferFish). diff --git a/language/v1beta2/language-api.json b/language/v1beta2/language-api.json index 7ced69ab1ef..9ed7a51a88e 100644 --- a/language/v1beta2/language-api.json +++ b/language/v1beta2/language-api.json @@ -246,7 +246,7 @@ } } }, - "revision": "20241110", + "revision": "20250105", "rootUrl": "https://language.googleapis.com/", "schemas": { "AnalyzeEntitiesRequest": { @@ -761,6 +761,7 @@ "A3_HIGHGPU_4G", "A3_HIGHGPU_8G", "A3_MEGAGPU_8G", + "A3_ULTRAGPU_8G", "E2_STANDARD_2", "E2_STANDARD_4", "E2_STANDARD_8", @@ -1050,6 +1051,7 @@ "", "", "", + "", "" ], "type": "string" @@ -1504,6 +1506,7 @@ "A3_HIGHGPU_4G", "A3_HIGHGPU_8G", "A3_MEGAGPU_8G", + "A3_ULTRAGPU_8G", "E2_STANDARD_2", "E2_STANDARD_4", "E2_STANDARD_8", @@ -1793,6 +1796,7 @@ "", "", "", + "", "" ], "type": "string" @@ -2188,6 +2192,7 @@ "A3_HIGHGPU_4G", "A3_HIGHGPU_8G", "A3_MEGAGPU_8G", + "A3_ULTRAGPU_8G", "E2_STANDARD_2", "E2_STANDARD_4", "E2_STANDARD_8", @@ -2477,6 +2482,7 @@ "", "", "", + "", "" ], "type": "string" @@ -3658,6 +3664,7 @@ "NVIDIA_L4", "NVIDIA_H100_80GB", "NVIDIA_H100_MEGA_80GB", + "NVIDIA_H200_141GB", "TPU_V2", "TPU_V3", "TPU_V4_POD", @@ -3675,6 +3682,7 @@ "Nvidia L4 GPU.", "Nvidia H100 80Gb GPU.", "Nvidia H100 80Gb GPU.", + "Nvidia H200 141Gb GPU.", "TPU v2 (JellyFish).", "TPU v3 (DragonFish).", "TPU_v4 (PufferFish).", diff --git a/language/v1beta2/language-gen.go b/language/v1beta2/language-gen.go index 8d8217c15db..371f3b1a5cf 100644 --- a/language/v1beta2/language-gen.go +++ b/language/v1beta2/language-gen.go @@ -894,6 +894,7 @@ type CpuMetric struct { // "A3_HIGHGPU_4G" // "A3_HIGHGPU_8G" // "A3_MEGAGPU_8G" + // "A3_ULTRAGPU_8G" // "E2_STANDARD_2" // "E2_STANDARD_4" // "E2_STANDARD_8" @@ -1424,6 +1425,7 @@ type GpuMetric struct { // "A3_HIGHGPU_4G" // "A3_HIGHGPU_8G" // "A3_MEGAGPU_8G" + // "A3_ULTRAGPU_8G" // "E2_STANDARD_2" // "E2_STANDARD_4" // "E2_STANDARD_8" @@ -1856,6 +1858,7 @@ type RamMetric struct { // "A3_HIGHGPU_4G" // "A3_HIGHGPU_8G" // "A3_MEGAGPU_8G" + // "A3_ULTRAGPU_8G" // "E2_STANDARD_2" // "E2_STANDARD_4" // "E2_STANDARD_8" @@ -3498,6 +3501,7 @@ type XPSImageModelServingSpecModelThroughputEstimation struct { // "NVIDIA_L4" - Nvidia L4 GPU. // "NVIDIA_H100_80GB" - Nvidia H100 80Gb GPU. // "NVIDIA_H100_MEGA_80GB" - Nvidia H100 80Gb GPU. + // "NVIDIA_H200_141GB" - Nvidia H200 141Gb GPU. // "TPU_V2" - TPU v2 (JellyFish). // "TPU_V3" - TPU v3 (DragonFish). // "TPU_V4_POD" - TPU_v4 (PufferFish). diff --git a/language/v2/language-api.json b/language/v2/language-api.json index e12e5826619..bdb5121de08 100644 --- a/language/v2/language-api.json +++ b/language/v2/language-api.json @@ -208,7 +208,7 @@ } } }, - "revision": "20241110", + "revision": "20250105", "rootUrl": "https://language.googleapis.com/", "schemas": { "AnalyzeEntitiesRequest": { @@ -586,6 +586,7 @@ "A3_HIGHGPU_4G", "A3_HIGHGPU_8G", "A3_MEGAGPU_8G", + "A3_ULTRAGPU_8G", "E2_STANDARD_2", "E2_STANDARD_4", "E2_STANDARD_8", @@ -875,6 +876,7 @@ "", "", "", + "", "" ], "type": "string" @@ -1125,6 +1127,7 @@ "A3_HIGHGPU_4G", "A3_HIGHGPU_8G", "A3_MEGAGPU_8G", + "A3_ULTRAGPU_8G", "E2_STANDARD_2", "E2_STANDARD_4", "E2_STANDARD_8", @@ -1414,6 +1417,7 @@ "", "", "", + "", "" ], "type": "string" @@ -1564,6 +1568,7 @@ "A3_HIGHGPU_4G", "A3_HIGHGPU_8G", "A3_MEGAGPU_8G", + "A3_ULTRAGPU_8G", "E2_STANDARD_2", "E2_STANDARD_4", "E2_STANDARD_8", @@ -1853,6 +1858,7 @@ "", "", "", + "", "" ], "type": "string" @@ -3011,6 +3017,7 @@ "NVIDIA_L4", "NVIDIA_H100_80GB", "NVIDIA_H100_MEGA_80GB", + "NVIDIA_H200_141GB", "TPU_V2", "TPU_V3", "TPU_V4_POD", @@ -3028,6 +3035,7 @@ "Nvidia L4 GPU.", "Nvidia H100 80Gb GPU.", "Nvidia H100 80Gb GPU.", + "Nvidia H200 141Gb GPU.", "TPU v2 (JellyFish).", "TPU v3 (DragonFish).", "TPU_v4 (PufferFish).", diff --git a/language/v2/language-gen.go b/language/v2/language-gen.go index 06b8819b772..c1053d6766b 100644 --- a/language/v2/language-gen.go +++ b/language/v2/language-gen.go @@ -708,6 +708,7 @@ type CpuMetric struct { // "A3_HIGHGPU_4G" // "A3_HIGHGPU_8G" // "A3_MEGAGPU_8G" + // "A3_ULTRAGPU_8G" // "E2_STANDARD_2" // "E2_STANDARD_4" // "E2_STANDARD_8" @@ -1104,6 +1105,7 @@ type GpuMetric struct { // "A3_HIGHGPU_4G" // "A3_HIGHGPU_8G" // "A3_MEGAGPU_8G" + // "A3_ULTRAGPU_8G" // "E2_STANDARD_2" // "E2_STANDARD_4" // "E2_STANDARD_8" @@ -1395,6 +1397,7 @@ type RamMetric struct { // "A3_HIGHGPU_4G" // "A3_HIGHGPU_8G" // "A3_MEGAGPU_8G" + // "A3_ULTRAGPU_8G" // "E2_STANDARD_2" // "E2_STANDARD_4" // "E2_STANDARD_8" @@ -3008,6 +3011,7 @@ type XPSImageModelServingSpecModelThroughputEstimation struct { // "NVIDIA_L4" - Nvidia L4 GPU. // "NVIDIA_H100_80GB" - Nvidia H100 80Gb GPU. // "NVIDIA_H100_MEGA_80GB" - Nvidia H100 80Gb GPU. + // "NVIDIA_H200_141GB" - Nvidia H200 141Gb GPU. // "TPU_V2" - TPU v2 (JellyFish). // "TPU_V3" - TPU v3 (DragonFish). // "TPU_V4_POD" - TPU_v4 (PufferFish). diff --git a/merchantapi/products_v1beta/merchantapi-api.json b/merchantapi/products_v1beta/merchantapi-api.json index 77f7fc9a920..77a453cb0d4 100644 --- a/merchantapi/products_v1beta/merchantapi-api.json +++ b/merchantapi/products_v1beta/merchantapi-api.json @@ -242,7 +242,7 @@ } } }, - "revision": "20241217", + "revision": "20250106", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "Attributes": { @@ -1349,7 +1349,7 @@ "description": "Optional. A list of product attributes." }, "channel": { - "description": "Required. Immutable. The [channel](https://support.google.com/merchants/answer/7361332) of the product.", + "description": "Immutable. The [channel](https://support.google.com/merchants/answer/7361332) of the product.", "enum": [ "CHANNEL_ENUM_UNSPECIFIED", "ONLINE", diff --git a/merchantapi/products_v1beta/merchantapi-gen.go b/merchantapi/products_v1beta/merchantapi-gen.go index 8789526dfcc..07104cd46c9 100644 --- a/merchantapi/products_v1beta/merchantapi-gen.go +++ b/merchantapi/products_v1beta/merchantapi-gen.go @@ -1241,7 +1241,7 @@ func (s *ProductDimension) UnmarshalJSON(data []byte) error { type ProductInput struct { // Attributes: Optional. A list of product attributes. Attributes *Attributes `json:"attributes,omitempty"` - // Channel: Required. Immutable. The channel + // Channel: Immutable. The channel // (https://support.google.com/merchants/answer/7361332) of the product. // // Possible values: diff --git a/networkconnectivity/v1/networkconnectivity-api.json b/networkconnectivity/v1/networkconnectivity-api.json index 2d1fa3f57cc..9c2a6536152 100644 --- a/networkconnectivity/v1/networkconnectivity-api.json +++ b/networkconnectivity/v1/networkconnectivity-api.json @@ -486,7 +486,7 @@ ] }, "queryStatus": { - "description": "Query PSC propagation status the status of a Network Connectivity Center hub.", + "description": "Query the Private Service Connect propagation status of a Network Connectivity Center hub.", "flatPath": "v1/projects/{projectsId}/locations/global/hubs/{hubsId}:queryStatus", "httpMethod": "GET", "id": "networkconnectivity.projects.locations.global.hubs.queryStatus", @@ -495,12 +495,12 @@ ], "parameters": { "filter": { - "description": "Optional. An expression that filters the list of results. The filter can be used to filter the results by the following fields: * psc_propagation_status.source_spoke * psc_propagation_status.source_group * psc_propagation_status.source_forwarding_rule * psc_propagation_status.target_spoke * psc_propagation_status.target_group * psc_propagation_status.code * psc_propagation_status.message", + "description": "Optional. An expression that filters the list of results. The filter can be used to filter the results by the following fields: * `psc_propagation_status.source_spoke` * `psc_propagation_status.source_group` * `psc_propagation_status.source_forwarding_rule` * `psc_propagation_status.target_spoke` * `psc_propagation_status.target_group` * `psc_propagation_status.code` * `psc_propagation_status.message`", "location": "query", "type": "string" }, "groupBy": { - "description": "Optional. A field that counts are grouped by. A comma-separated list of any of these fields: * psc_propagation_status.source_spoke * psc_propagation_status.source_group * psc_propagation_status.source_forwarding_rule * psc_propagation_status.target_spoke * psc_propagation_status.target_group * psc_propagation_status.code", + "description": "Optional. Aggregate the results by the specified fields. A comma-separated list of any of these fields: * `psc_propagation_status.source_spoke` * `psc_propagation_status.source_group` * `psc_propagation_status.source_forwarding_rule` * `psc_propagation_status.target_spoke` * `psc_propagation_status.target_group` * `psc_propagation_status.code`", "location": "query", "type": "string" }, @@ -512,7 +512,7 @@ "type": "string" }, "orderBy": { - "description": "Optional. Sort the results in the ascending order by specific fields returned in the response. A comma-separated list of any of these fields: * psc_propagation_status.source_spoke * psc_propagation_status.source_group * psc_propagation_status.source_forwarding_rule * psc_propagation_status.target_spoke * psc_propagation_status.target_group * psc_propagation_status.code If `group_by` is set, the value of the `order_by` field must be the same as or a subset of the `group_by` field.", + "description": "Optional. Sort the results in ascending order by the specified fields. A comma-separated list of any of these fields: * `psc_propagation_status.source_spoke` * `psc_propagation_status.source_group` * `psc_propagation_status.source_forwarding_rule` * `psc_propagation_status.target_spoke` * `psc_propagation_status.target_group` * `psc_propagation_status.code` If `group_by` is set, the value of the `order_by` field must be the same as or a subset of the `group_by` field.", "location": "query", "type": "string" }, @@ -1394,7 +1394,7 @@ "operations": { "methods": { "cancel": { - "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", + "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", "httpMethod": "POST", "id": "networkconnectivity.projects.locations.operations.cancel", @@ -2863,7 +2863,7 @@ } } }, - "revision": "20241112", + "revision": "20250101", "rootUrl": "https://networkconnectivity.googleapis.com/", "schemas": { "AcceptHubSpokeRequest": { @@ -2945,7 +2945,7 @@ "id": "AutoAccept", "properties": { "autoAcceptProjects": { - "description": "A list of project ids or project numbers for which you want to enable auto-accept. The auto-accept setting is applied to spokes being created or updated in these projects.", + "description": "Optional. A list of project ids or project numbers for which you want to enable auto-accept. The auto-accept setting is applied to spokes being created or updated in these projects.", "items": { "type": "string" }, @@ -3298,7 +3298,7 @@ "additionalProperties": { "type": "string" }, - "description": "Additional structured details about this error. Keys must match /a-z+/ but should ideally be lowerCamelCase. Also they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than {\"instanceLimit\": \"100/request\"}, should be returned as, {\"instanceLimitPerRequest\": \"100\"}, if the client exceeds the number of instances that can be created in a single (batch) request.", + "description": "Additional structured details about this error. Keys must match a regular expression of `a-z+` but should ideally be lowerCamelCase. Also, they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than `{\"instanceLimit\": \"100/request\"}`, should be returned as, `{\"instanceLimitPerRequest\": \"100\"}`, if the client exceeds the number of instances that can be created in a single (batch) request.", "type": "object" }, "reason": { @@ -3421,7 +3421,7 @@ "type": "string" }, "description": { - "description": "An optional description of the hub.", + "description": "Optional. An optional description of the hub.", "type": "string" }, "exportPsc": { @@ -3527,21 +3527,21 @@ "type": "object" }, "HubStatusEntry": { - "description": "The hub status entry.", + "description": "A hub status entry represents the status of a set of propagated Private Service Connect connections grouped by certain fields.", "id": "HubStatusEntry", "properties": { "count": { - "description": "The number of status. If group_by is not set in the request, the default is 1.", + "description": "The number of propagated Private Service Connect connections with this status. If the `group_by` field was not set in the request message, the value of this field is 1.", "format": "int32", "type": "integer" }, "groupBy": { - "description": "The same group_by field from the request.", + "description": "The fields that this entry is grouped by. This has the same value as the `group_by` field in the request message.", "type": "string" }, "pscPropagationStatus": { "$ref": "PscPropagationStatus", - "description": "The PSC propagation status." + "description": "The Private Service Connect propagation status." } }, "type": "object" @@ -3558,7 +3558,7 @@ "type": "object" }, "InternalRange": { - "description": "The internal range resource for IPAM operations within a VPC network. Used to represent a private address range along with behavioral characterstics of that range (its usage and peering behavior). Networking resources can link to this range if they are created as belonging to it.", + "description": "The internal range resource for IPAM operations within a VPC network. Used to represent a private address range along with behavioral characteristics of that range (its usage and peering behavior). Networking resources can link to this range if they are created as belonging to it.", "id": "InternalRange", "properties": { "createTime": { @@ -4640,7 +4640,7 @@ "type": "object" }, "PscPropagationStatus": { - "description": "The PSC propagation status in a hub.", + "description": "The status of one or more propagated Private Service Connect connections in a hub.", "id": "PscPropagationStatus", "properties": { "code": { @@ -4656,17 +4656,17 @@ ], "enumDescriptions": [ "The code is unspecified.", - "The propagated PSC connection is ready.", - "PSC connection is propagating. This is a transient state.", - "The PSC connection propagation failed because the VPC network or the project of the target spoke has exceeded the connection limit set by the producer.", - "The PSC connection propagation failed because the NAT IP subnet space has been exhausted. It is equivalent to the `Needs attention` status of the PSC connection. See https://cloud.google.com/vpc/docs/about-accessing-vpc-hosted-services-endpoints#connection-statuses.", - "PSC connection propagation failed because the `PSC_ILB_CONSUMER_FORWARDING_RULES_PER_PRODUCER_NETWORK` quota in the producer VPC network has been exceeded.", - "The PSC connection propagation failed because the `PSC_PROPAGATED_CONNECTIONS_PER_VPC_NETWORK` quota in the consumer VPC network has been exceeded." + "The propagated Private Service Connect connection is ready.", + "The Private Service Connect connection is propagating. This is a transient state.", + "The Private Service Connect connection propagation failed because the VPC network or the project of the target spoke has exceeded the connection limit set by the producer.", + "The Private Service Connect connection propagation failed because the NAT IP subnet space has been exhausted. It is equivalent to the `Needs attention` status of the Private Service Connect connection. See https://cloud.google.com/vpc/docs/about-accessing-vpc-hosted-services-endpoints#connection-statuses.", + "The Private Service Connect connection propagation failed because the `PSC_ILB_CONSUMER_FORWARDING_RULES_PER_PRODUCER_NETWORK` quota in the producer VPC network has been exceeded.", + "The Private Service Connect connection propagation failed because the `PSC_PROPAGATED_CONNECTIONS_PER_VPC_NETWORK` quota in the consumer VPC network has been exceeded." ], "type": "string" }, "message": { - "description": "The human-readable summary of the PSC connection propagation status.", + "description": "The human-readable summary of the Private Service Connect connection propagation status.", "type": "string" }, "sourceForwardingRule": { @@ -5147,7 +5147,7 @@ "type": "string" }, "token": { - "description": "The token provided by the consumer. This token authenticates that the consumer can create a connecton within the specified project and network.", + "description": "The token provided by the consumer. This token authenticates that the consumer can create a connection within the specified project and network.", "type": "string" }, "updateTime": { @@ -5310,7 +5310,7 @@ "type": "string" }, "description": { - "description": "An optional description of the spoke.", + "description": "Optional. An optional description of the spoke.", "type": "string" }, "group": { @@ -5330,7 +5330,7 @@ }, "linkedInterconnectAttachments": { "$ref": "LinkedInterconnectAttachments", - "description": "VLAN attachments that are associated with the spoke." + "description": "Optional. VLAN attachments that are associated with the spoke." }, "linkedProducerVpcNetwork": { "$ref": "LinkedProducerVpcNetwork", @@ -5338,7 +5338,7 @@ }, "linkedRouterApplianceInstances": { "$ref": "LinkedRouterApplianceInstances", - "description": "Router appliance instances that are associated with the spoke." + "description": "Optional. Router appliance instances that are associated with the spoke." }, "linkedVpcNetwork": { "$ref": "LinkedVpcNetwork", @@ -5346,7 +5346,7 @@ }, "linkedVpnTunnels": { "$ref": "LinkedVpnTunnels", - "description": "VPN tunnels that are associated with the spoke." + "description": "Optional. VPN tunnels that are associated with the spoke." }, "name": { "description": "Immutable. The name of the spoke. Spoke names must be unique. They use the following form: `projects/{project_number}/locations/{region}/spokes/{spoke_id}`", diff --git a/networkconnectivity/v1/networkconnectivity-gen.go b/networkconnectivity/v1/networkconnectivity-gen.go index 61cd5fd8371..8f20eb2195c 100644 --- a/networkconnectivity/v1/networkconnectivity-gen.go +++ b/networkconnectivity/v1/networkconnectivity-gen.go @@ -485,9 +485,9 @@ func (s AuditLogConfig) MarshalJSON() ([]byte, error) { // the spoke goes to the INACTIVE state, and it must be reviewed and accepted // by a hub administrator. type AutoAccept struct { - // AutoAcceptProjects: A list of project ids or project numbers for which you - // want to enable auto-accept. The auto-accept setting is applied to spokes - // being created or updated in these projects. + // AutoAcceptProjects: Optional. A list of project ids or project numbers for + // which you want to enable auto-accept. The auto-accept setting is applied to + // spokes being created or updated in these projects. AutoAcceptProjects []string `json:"autoAcceptProjects,omitempty"` // ForceSendFields is a list of field names (e.g. "AutoAcceptProjects") to // unconditionally include in API requests. By default, fields with empty or @@ -963,13 +963,14 @@ type GoogleRpcErrorInfo struct { // unique value that identifies the infrastructure. For Google API // infrastructure, the error domain is "googleapis.com". Domain string `json:"domain,omitempty"` - // Metadata: Additional structured details about this error. Keys must match - // /a-z+/ but should ideally be lowerCamelCase. Also they must be limited to 64 - // characters in length. When identifying the current value of an exceeded - // limit, the units should be contained in the key, not the value. For example, - // rather than {"instanceLimit": "100/request"}, should be returned as, - // {"instanceLimitPerRequest": "100"}, if the client exceeds the number of - // instances that can be created in a single (batch) request. + // Metadata: Additional structured details about this error. Keys must match a + // regular expression of `a-z+` but should ideally be lowerCamelCase. Also, + // they must be limited to 64 characters in length. When identifying the + // current value of an exceeded limit, the units should be contained in the + // key, not the value. For example, rather than `{"instanceLimit": + // "100/request"}`, should be returned as, `{"instanceLimitPerRequest": + // "100"}`, if the client exceeds the number of instances that can be created + // in a single (batch) request. Metadata map[string]string `json:"metadata,omitempty"` // Reason: The reason of the error. This is a constant value that identifies // the proximate cause of the error. Error reasons are unique within a @@ -1100,7 +1101,7 @@ func (s Group) MarshalJSON() ([]byte, error) { type Hub struct { // CreateTime: Output only. The time the hub was created. CreateTime string `json:"createTime,omitempty"` - // Description: An optional description of the hub. + // Description: Optional. An optional description of the hub. Description string `json:"description,omitempty"` // ExportPsc: Optional. Whether Private Service Connect transitivity is enabled // for the hub. If true, Private Service Connect endpoints in VPC spokes @@ -1193,14 +1194,17 @@ func (s Hub) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// HubStatusEntry: The hub status entry. +// HubStatusEntry: A hub status entry represents the status of a set of +// propagated Private Service Connect connections grouped by certain fields. type HubStatusEntry struct { - // Count: The number of status. If group_by is not set in the request, the - // default is 1. + // Count: The number of propagated Private Service Connect connections with + // this status. If the `group_by` field was not set in the request message, the + // value of this field is 1. Count int64 `json:"count,omitempty"` - // GroupBy: The same group_by field from the request. + // GroupBy: The fields that this entry is grouped by. This has the same value + // as the `group_by` field in the request message. GroupBy string `json:"groupBy,omitempty"` - // PscPropagationStatus: The PSC propagation status. + // PscPropagationStatus: The Private Service Connect propagation status. PscPropagationStatus *PscPropagationStatus `json:"pscPropagationStatus,omitempty"` // ForceSendFields is a list of field names (e.g. "Count") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -1246,7 +1250,7 @@ func (s InterconnectAttachment) MarshalJSON() ([]byte, error) { // InternalRange: The internal range resource for IPAM operations within a VPC // network. Used to represent a private address range along with behavioral -// characterstics of that range (its usage and peering behavior). Networking +// characteristics of that range (its usage and peering behavior). Networking // resources can link to this range if they are created as belonging to it. type InternalRange struct { // CreateTime: Time when the internal range was created. @@ -2563,30 +2567,35 @@ func (s PscConnection) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// PscPropagationStatus: The PSC propagation status in a hub. +// PscPropagationStatus: The status of one or more propagated Private Service +// Connect connections in a hub. type PscPropagationStatus struct { // Code: The propagation status. // // Possible values: // "CODE_UNSPECIFIED" - The code is unspecified. - // "READY" - The propagated PSC connection is ready. - // "PROPAGATING" - PSC connection is propagating. This is a transient state. - // "ERROR_PRODUCER_PROPAGATED_CONNECTION_LIMIT_EXCEEDED" - The PSC connection - // propagation failed because the VPC network or the project of the target - // spoke has exceeded the connection limit set by the producer. - // "ERROR_PRODUCER_NAT_IP_SPACE_EXHAUSTED" - The PSC connection propagation - // failed because the NAT IP subnet space has been exhausted. It is equivalent - // to the `Needs attention` status of the PSC connection. See + // "READY" - The propagated Private Service Connect connection is ready. + // "PROPAGATING" - The Private Service Connect connection is propagating. + // This is a transient state. + // "ERROR_PRODUCER_PROPAGATED_CONNECTION_LIMIT_EXCEEDED" - The Private + // Service Connect connection propagation failed because the VPC network or the + // project of the target spoke has exceeded the connection limit set by the + // producer. + // "ERROR_PRODUCER_NAT_IP_SPACE_EXHAUSTED" - The Private Service Connect + // connection propagation failed because the NAT IP subnet space has been + // exhausted. It is equivalent to the `Needs attention` status of the Private + // Service Connect connection. See // https://cloud.google.com/vpc/docs/about-accessing-vpc-hosted-services-endpoints#connection-statuses. - // "ERROR_PRODUCER_QUOTA_EXCEEDED" - PSC connection propagation failed - // because the `PSC_ILB_CONSUMER_FORWARDING_RULES_PER_PRODUCER_NETWORK` quota - // in the producer VPC network has been exceeded. - // "ERROR_CONSUMER_QUOTA_EXCEEDED" - The PSC connection propagation failed - // because the `PSC_PROPAGATED_CONNECTIONS_PER_VPC_NETWORK` quota in the - // consumer VPC network has been exceeded. + // "ERROR_PRODUCER_QUOTA_EXCEEDED" - The Private Service Connect connection + // propagation failed because the + // `PSC_ILB_CONSUMER_FORWARDING_RULES_PER_PRODUCER_NETWORK` quota in the + // producer VPC network has been exceeded. + // "ERROR_CONSUMER_QUOTA_EXCEEDED" - The Private Service Connect connection + // propagation failed because the `PSC_PROPAGATED_CONNECTIONS_PER_VPC_NETWORK` + // quota in the consumer VPC network has been exceeded. Code string `json:"code,omitempty"` - // Message: The human-readable summary of the PSC connection propagation - // status. + // Message: The human-readable summary of the Private Service Connect + // connection propagation status. Message string `json:"message,omitempty"` // SourceForwardingRule: The name of the forwarding rule exported to the hub. SourceForwardingRule string `json:"sourceForwardingRule,omitempty"` @@ -3069,7 +3078,7 @@ type ServiceConnectionMap struct { // ServiceConnectionMap is for. ServiceClassUri string `json:"serviceClassUri,omitempty"` // Token: The token provided by the consumer. This token authenticates that the - // consumer can create a connecton within the specified project and network. + // consumer can create a connection within the specified project and network. Token string `json:"token,omitempty"` // UpdateTime: Output only. Time when the ServiceConnectionMap was updated. UpdateTime string `json:"updateTime,omitempty"` @@ -3242,7 +3251,7 @@ func (s SetIamPolicyRequest) MarshalJSON() ([]byte, error) { type Spoke struct { // CreateTime: Output only. The time the spoke was created. CreateTime string `json:"createTime,omitempty"` - // Description: An optional description of the spoke. + // Description: Optional. An optional description of the spoke. Description string `json:"description,omitempty"` // Group: Optional. The name of the group that this spoke is associated with. Group string `json:"group,omitempty"` @@ -3252,18 +3261,18 @@ type Spoke struct { // labels, see Requirements for labels // (https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements). Labels map[string]string `json:"labels,omitempty"` - // LinkedInterconnectAttachments: VLAN attachments that are associated with the - // spoke. + // LinkedInterconnectAttachments: Optional. VLAN attachments that are + // associated with the spoke. LinkedInterconnectAttachments *LinkedInterconnectAttachments `json:"linkedInterconnectAttachments,omitempty"` // LinkedProducerVpcNetwork: Optional. The linked producer VPC that is // associated with the spoke. LinkedProducerVpcNetwork *LinkedProducerVpcNetwork `json:"linkedProducerVpcNetwork,omitempty"` - // LinkedRouterApplianceInstances: Router appliance instances that are - // associated with the spoke. + // LinkedRouterApplianceInstances: Optional. Router appliance instances that + // are associated with the spoke. LinkedRouterApplianceInstances *LinkedRouterApplianceInstances `json:"linkedRouterApplianceInstances,omitempty"` // LinkedVpcNetwork: Optional. VPC network that is associated with the spoke. LinkedVpcNetwork *LinkedVpcNetwork `json:"linkedVpcNetwork,omitempty"` - // LinkedVpnTunnels: VPN tunnels that are associated with the spoke. + // LinkedVpnTunnels: Optional. VPN tunnels that are associated with the spoke. LinkedVpnTunnels *LinkedVpnTunnels `json:"linkedVpnTunnels,omitempty"` // Name: Immutable. The name of the spoke. Spoke names must be unique. They use // the following form: @@ -4971,8 +4980,8 @@ type ProjectsLocationsGlobalHubsQueryStatusCall struct { header_ http.Header } -// QueryStatus: Query PSC propagation status the status of a Network -// Connectivity Center hub. +// QueryStatus: Query the Private Service Connect propagation status of a +// Network Connectivity Center hub. // // - name: The name of the hub. func (r *ProjectsLocationsGlobalHubsService) QueryStatus(name string) *ProjectsLocationsGlobalHubsQueryStatusCall { @@ -4983,35 +4992,38 @@ func (r *ProjectsLocationsGlobalHubsService) QueryStatus(name string) *ProjectsL // Filter sets the optional parameter "filter": An expression that filters the // list of results. The filter can be used to filter the results by the -// following fields: * psc_propagation_status.source_spoke * -// psc_propagation_status.source_group * -// psc_propagation_status.source_forwarding_rule * -// psc_propagation_status.target_spoke * psc_propagation_status.target_group * -// psc_propagation_status.code * psc_propagation_status.message +// following fields: * `psc_propagation_status.source_spoke` * +// `psc_propagation_status.source_group` * +// `psc_propagation_status.source_forwarding_rule` * +// `psc_propagation_status.target_spoke` * +// `psc_propagation_status.target_group` * `psc_propagation_status.code` * +// `psc_propagation_status.message` func (c *ProjectsLocationsGlobalHubsQueryStatusCall) Filter(filter string) *ProjectsLocationsGlobalHubsQueryStatusCall { c.urlParams_.Set("filter", filter) return c } -// GroupBy sets the optional parameter "groupBy": A field that counts are -// grouped by. A comma-separated list of any of these fields: * -// psc_propagation_status.source_spoke * psc_propagation_status.source_group * -// psc_propagation_status.source_forwarding_rule * -// psc_propagation_status.target_spoke * psc_propagation_status.target_group * -// psc_propagation_status.code +// GroupBy sets the optional parameter "groupBy": Aggregate the results by the +// specified fields. A comma-separated list of any of these fields: * +// `psc_propagation_status.source_spoke` * +// `psc_propagation_status.source_group` * +// `psc_propagation_status.source_forwarding_rule` * +// `psc_propagation_status.target_spoke` * +// `psc_propagation_status.target_group` * `psc_propagation_status.code` func (c *ProjectsLocationsGlobalHubsQueryStatusCall) GroupBy(groupBy string) *ProjectsLocationsGlobalHubsQueryStatusCall { c.urlParams_.Set("groupBy", groupBy) return c } -// OrderBy sets the optional parameter "orderBy": Sort the results in the -// ascending order by specific fields returned in the response. A -// comma-separated list of any of these fields: * -// psc_propagation_status.source_spoke * psc_propagation_status.source_group * -// psc_propagation_status.source_forwarding_rule * -// psc_propagation_status.target_spoke * psc_propagation_status.target_group * -// psc_propagation_status.code If `group_by` is set, the value of the -// `order_by` field must be the same as or a subset of the `group_by` field. +// OrderBy sets the optional parameter "orderBy": Sort the results in ascending +// order by the specified fields. A comma-separated list of any of these +// fields: * `psc_propagation_status.source_spoke` * +// `psc_propagation_status.source_group` * +// `psc_propagation_status.source_forwarding_rule` * +// `psc_propagation_status.target_spoke` * +// `psc_propagation_status.target_group` * `psc_propagation_status.code` If +// `group_by` is set, the value of the `order_by` field must be the same as or +// a subset of the `group_by` field. func (c *ProjectsLocationsGlobalHubsQueryStatusCall) OrderBy(orderBy string) *ProjectsLocationsGlobalHubsQueryStatusCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -8263,7 +8275,7 @@ type ProjectsLocationsOperationsCancelCall struct { // other methods to check whether the cancellation succeeded or whether the // operation completed despite cancellation. On successful cancellation, the // operation is not deleted; instead, it becomes an operation with an -// Operation.error value with a google.rpc.Status.code of 1, corresponding to +// Operation.error value with a google.rpc.Status.code of `1`, corresponding to // `Code.CANCELLED`. // // - name: The name of the operation resource to be cancelled. diff --git a/places/v1/places-api.json b/places/v1/places-api.json index 587f5fbbc84..4b781f83b89 100644 --- a/places/v1/places-api.json +++ b/places/v1/places-api.json @@ -280,7 +280,7 @@ } } }, - "revision": "20241117", + "revision": "20241231", "rootUrl": "https://places.googleapis.com/", "schemas": { "GoogleGeoTypeViewport": { @@ -1231,7 +1231,7 @@ }, "regularOpeningHours": { "$ref": "GoogleMapsPlacesV1PlaceOpeningHours", - "description": "The regular hours of operation. Note that if a place is always open (24 hours), the `close` field will not be set. Clients can rely on always open (24 hours) being represented as an `open` period containing day with value `0`, hour with value `0`, and minute with value `0`." + "description": "The regular hours of operation. Note that if a place is always open (24 hours), the `close` field will not be set. Clients can rely on always open (24 hours) being represented as an `open` period containing `day` with value `0`, `hour` with value `0`, and `minute` with value `0`." }, "regularSecondaryOpeningHours": { "description": "Contains an array of entries for information about regular secondary hours of a business. Secondary hours are different from a business's main hours. For example, a restaurant can specify drive through hours or delivery hours as its secondary hours. This field populates the type subfield, which draws from a predefined list of opening hours types (such as DRIVE_THROUGH, PICKUP, or TAKEOUT) based on the types of the place.", diff --git a/places/v1/places-gen.go b/places/v1/places-gen.go index 3f86e4609d5..eaad73963ef 100644 --- a/places/v1/places-gen.go +++ b/places/v1/places-gen.go @@ -1455,7 +1455,7 @@ type GoogleMapsPlacesV1Place struct { // RegularOpeningHours: The regular hours of operation. Note that if a place is // always open (24 hours), the `close` field will not be set. Clients can rely // on always open (24 hours) being represented as an `open` period containing - // day with value `0`, hour with value `0`, and minute with value `0`. + // `day` with value `0`, `hour` with value `0`, and `minute` with value `0`. RegularOpeningHours *GoogleMapsPlacesV1PlaceOpeningHours `json:"regularOpeningHours,omitempty"` // RegularSecondaryOpeningHours: Contains an array of entries for information // about regular secondary hours of a business. Secondary hours are different diff --git a/pubsub/v1/pubsub-api.json b/pubsub/v1/pubsub-api.json index b66e6350544..18562072d96 100644 --- a/pubsub/v1/pubsub-api.json +++ b/pubsub/v1/pubsub-api.json @@ -1638,7 +1638,7 @@ } } }, - "revision": "20241212", + "revision": "20241231", "rootUrl": "https://pubsub.googleapis.com/", "schemas": { "AcknowledgeRequest": { @@ -1735,6 +1735,110 @@ }, "type": "object" }, + "AwsMsk": { + "description": "Ingestion settings for Amazon MSK.", + "id": "AwsMsk", + "properties": { + "awsRoleArn": { + "description": "Required. AWS role ARN to be used for Federated Identity authentication with Amazon MSK. Check the Pub/Sub docs for how to set up this role and the required permissions that need to be attached to it.", + "type": "string" + }, + "clusterArn": { + "description": "Required. The Amazon Resource Name (ARN) that uniquely identifies the cluster.", + "type": "string" + }, + "gcpServiceAccount": { + "description": "Required. The GCP service account to be used for Federated Identity authentication with Amazon MSK (via a `AssumeRoleWithWebIdentity` call for the provided role). The `aws_role_arn` must be set up with `accounts.google.com:sub` equals to this service account number.", + "type": "string" + }, + "state": { + "description": "Output only. An output-only field that indicates the state of the Amazon MSK ingestion source.", + "enum": [ + "STATE_UNSPECIFIED", + "ACTIVE", + "MSK_PERMISSION_DENIED", + "PUBLISH_PERMISSION_DENIED", + "CLUSTER_NOT_FOUND", + "TOPIC_NOT_FOUND" + ], + "enumDescriptions": [ + "Default value. This value is unused.", + "Ingestion is active.", + "Permission denied encountered while consuming data from Amazon MSK.", + "Permission denied encountered while publishing to the topic.", + "The provided MSK cluster wasn't found.", + "The provided topic wasn't found." + ], + "readOnly": true, + "type": "string" + }, + "topic": { + "description": "Required. The name of the topic in the Amazon MSK cluster that Pub/Sub will import from.", + "type": "string" + } + }, + "type": "object" + }, + "AzureEventHubs": { + "description": "Ingestion settings for Azure Event Hubs.", + "id": "AzureEventHubs", + "properties": { + "clientId": { + "description": "Optional. The client id of the Azure application that is being used to authenticate Pub/Sub.", + "type": "string" + }, + "eventHub": { + "description": "Optional. The name of the Event Hub.", + "type": "string" + }, + "gcpServiceAccount": { + "description": "Optional. The GCP service account to be used for Federated Identity authentication.", + "type": "string" + }, + "namespace": { + "description": "Optional. The name of the Event Hubs namespace.", + "type": "string" + }, + "resourceGroup": { + "description": "Optional. Name of the resource group within the azure subscription.", + "type": "string" + }, + "state": { + "description": "Output only. An output-only field that indicates the state of the Event Hubs ingestion source.", + "enum": [ + "STATE_UNSPECIFIED", + "ACTIVE", + "EVENT_HUBS_PERMISSION_DENIED", + "PUBLISH_PERMISSION_DENIED", + "NAMESPACE_NOT_FOUND", + "EVENT_HUB_NOT_FOUND", + "SUBSCRIPTION_NOT_FOUND", + "RESOURCE_GROUP_NOT_FOUND" + ], + "enumDescriptions": [ + "Default value. This value is unused.", + "Ingestion is active.", + "Permission denied encountered while consuming data from Event Hubs. This can happen when `client_id`, or `tenant_id` are invalid. Or the right permissions haven't been granted.", + "Permission denied encountered while publishing to the topic.", + "The provided Event Hubs namespace couldn't be found.", + "The provided Event Hub couldn't be found.", + "The provided Event Hubs subscription couldn't be found.", + "The provided Event Hubs resource group couldn't be found." + ], + "readOnly": true, + "type": "string" + }, + "subscriptionId": { + "description": "Optional. The Azure subscription id.", + "type": "string" + }, + "tenantId": { + "description": "Optional. The tenant id of the Azure application that is being used to authenticate Pub/Sub.", + "type": "string" + } + }, + "type": "object" + }, "BigQueryConfig": { "description": "Configuration for a BigQuery subscription.", "id": "BigQueryConfig", @@ -1944,6 +2048,56 @@ }, "type": "object" }, + "ConfluentCloud": { + "description": "Ingestion settings for Confluent Cloud.", + "id": "ConfluentCloud", + "properties": { + "bootstrapServer": { + "description": "Required. The address of the bootstrap server. The format is url:port.", + "type": "string" + }, + "clusterId": { + "description": "Required. The id of the cluster.", + "type": "string" + }, + "gcpServiceAccount": { + "description": "Required. The GCP service account to be used for Federated Identity authentication with `identity_pool_id`.", + "type": "string" + }, + "identityPoolId": { + "description": "Required. The id of the identity pool to be used for Federated Identity authentication with Confluent Cloud. See https://docs.confluent.io/cloud/current/security/authenticate/workload-identities/identity-providers/oauth/identity-pools.html#add-oauth-identity-pools.", + "type": "string" + }, + "state": { + "description": "Output only. An output-only field that indicates the state of the Confluent Cloud ingestion source.", + "enum": [ + "STATE_UNSPECIFIED", + "ACTIVE", + "CONFLUENT_CLOUD_PERMISSION_DENIED", + "PUBLISH_PERMISSION_DENIED", + "UNREACHABLE_BOOTSTRAP_SERVER", + "CLUSTER_NOT_FOUND", + "TOPIC_NOT_FOUND" + ], + "enumDescriptions": [ + "Default value. This value is unused.", + "Ingestion is active.", + "Permission denied encountered while consuming data from Confluent Cloud.", + "Permission denied encountered while publishing to the topic.", + "The provided bootstrap server address is unreachable.", + "The provided cluster wasn't found.", + "The provided topic wasn't found." + ], + "readOnly": true, + "type": "string" + }, + "topic": { + "description": "Required. The name of the topic in the Confluent Cloud cluster that Pub/Sub will import from.", + "type": "string" + } + }, + "type": "object" + }, "CreateSnapshotRequest": { "description": "Request for the `CreateSnapshot` method.", "id": "CreateSnapshotRequest", @@ -2033,10 +2187,22 @@ "$ref": "AwsKinesis", "description": "Optional. Amazon Kinesis Data Streams." }, + "awsMsk": { + "$ref": "AwsMsk", + "description": "Optional. Amazon MSK." + }, + "azureEventHubs": { + "$ref": "AzureEventHubs", + "description": "Optional. Azure Event Hubs." + }, "cloudStorage": { "$ref": "CloudStorage", "description": "Optional. Cloud Storage." }, + "confluentCloud": { + "$ref": "ConfluentCloud", + "description": "Optional. Confluent Cloud." + }, "platformLogsSettings": { "$ref": "PlatformLogsSettings", "description": "Optional. Platform Logs settings. If unset, no Platform Logs will be generated." diff --git a/pubsub/v1/pubsub-gen.go b/pubsub/v1/pubsub-gen.go index b6c0a82a82d..5c7f031bec5 100644 --- a/pubsub/v1/pubsub-gen.go +++ b/pubsub/v1/pubsub-gen.go @@ -397,6 +397,112 @@ func (s AwsKinesis) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// AwsMsk: Ingestion settings for Amazon MSK. +type AwsMsk struct { + // AwsRoleArn: Required. AWS role ARN to be used for Federated Identity + // authentication with Amazon MSK. Check the Pub/Sub docs for how to set up + // this role and the required permissions that need to be attached to it. + AwsRoleArn string `json:"awsRoleArn,omitempty"` + // ClusterArn: Required. The Amazon Resource Name (ARN) that uniquely + // identifies the cluster. + ClusterArn string `json:"clusterArn,omitempty"` + // GcpServiceAccount: Required. The GCP service account to be used for + // Federated Identity authentication with Amazon MSK (via a + // `AssumeRoleWithWebIdentity` call for the provided role). The `aws_role_arn` + // must be set up with `accounts.google.com:sub` equals to this service account + // number. + GcpServiceAccount string `json:"gcpServiceAccount,omitempty"` + // State: Output only. An output-only field that indicates the state of the + // Amazon MSK ingestion source. + // + // Possible values: + // "STATE_UNSPECIFIED" - Default value. This value is unused. + // "ACTIVE" - Ingestion is active. + // "MSK_PERMISSION_DENIED" - Permission denied encountered while consuming + // data from Amazon MSK. + // "PUBLISH_PERMISSION_DENIED" - Permission denied encountered while + // publishing to the topic. + // "CLUSTER_NOT_FOUND" - The provided MSK cluster wasn't found. + // "TOPIC_NOT_FOUND" - The provided topic wasn't found. + State string `json:"state,omitempty"` + // Topic: Required. The name of the topic in the Amazon MSK cluster that + // Pub/Sub will import from. + Topic string `json:"topic,omitempty"` + // ForceSendFields is a list of field names (e.g. "AwsRoleArn") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "AwsRoleArn") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s AwsMsk) MarshalJSON() ([]byte, error) { + type NoMethod AwsMsk + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// AzureEventHubs: Ingestion settings for Azure Event Hubs. +type AzureEventHubs struct { + // ClientId: Optional. The client id of the Azure application that is being + // used to authenticate Pub/Sub. + ClientId string `json:"clientId,omitempty"` + // EventHub: Optional. The name of the Event Hub. + EventHub string `json:"eventHub,omitempty"` + // GcpServiceAccount: Optional. The GCP service account to be used for + // Federated Identity authentication. + GcpServiceAccount string `json:"gcpServiceAccount,omitempty"` + // Namespace: Optional. The name of the Event Hubs namespace. + Namespace string `json:"namespace,omitempty"` + // ResourceGroup: Optional. Name of the resource group within the azure + // subscription. + ResourceGroup string `json:"resourceGroup,omitempty"` + // State: Output only. An output-only field that indicates the state of the + // Event Hubs ingestion source. + // + // Possible values: + // "STATE_UNSPECIFIED" - Default value. This value is unused. + // "ACTIVE" - Ingestion is active. + // "EVENT_HUBS_PERMISSION_DENIED" - Permission denied encountered while + // consuming data from Event Hubs. This can happen when `client_id`, or + // `tenant_id` are invalid. Or the right permissions haven't been granted. + // "PUBLISH_PERMISSION_DENIED" - Permission denied encountered while + // publishing to the topic. + // "NAMESPACE_NOT_FOUND" - The provided Event Hubs namespace couldn't be + // found. + // "EVENT_HUB_NOT_FOUND" - The provided Event Hub couldn't be found. + // "SUBSCRIPTION_NOT_FOUND" - The provided Event Hubs subscription couldn't + // be found. + // "RESOURCE_GROUP_NOT_FOUND" - The provided Event Hubs resource group + // couldn't be found. + State string `json:"state,omitempty"` + // SubscriptionId: Optional. The Azure subscription id. + SubscriptionId string `json:"subscriptionId,omitempty"` + // TenantId: Optional. The tenant id of the Azure application that is being + // used to authenticate Pub/Sub. + TenantId string `json:"tenantId,omitempty"` + // ForceSendFields is a list of field names (e.g. "ClientId") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "ClientId") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s AzureEventHubs) MarshalJSON() ([]byte, error) { + type NoMethod AzureEventHubs + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // BigQueryConfig: Configuration for a BigQuery subscription. type BigQueryConfig struct { // DropUnknownFields: Optional. When true and use_topic_schema is true, any @@ -729,6 +835,56 @@ func (s CommitSchemaRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ConfluentCloud: Ingestion settings for Confluent Cloud. +type ConfluentCloud struct { + // BootstrapServer: Required. The address of the bootstrap server. The format + // is url:port. + BootstrapServer string `json:"bootstrapServer,omitempty"` + // ClusterId: Required. The id of the cluster. + ClusterId string `json:"clusterId,omitempty"` + // GcpServiceAccount: Required. The GCP service account to be used for + // Federated Identity authentication with `identity_pool_id`. + GcpServiceAccount string `json:"gcpServiceAccount,omitempty"` + // IdentityPoolId: Required. The id of the identity pool to be used for + // Federated Identity authentication with Confluent Cloud. See + // https://docs.confluent.io/cloud/current/security/authenticate/workload-identities/identity-providers/oauth/identity-pools.html#add-oauth-identity-pools. + IdentityPoolId string `json:"identityPoolId,omitempty"` + // State: Output only. An output-only field that indicates the state of the + // Confluent Cloud ingestion source. + // + // Possible values: + // "STATE_UNSPECIFIED" - Default value. This value is unused. + // "ACTIVE" - Ingestion is active. + // "CONFLUENT_CLOUD_PERMISSION_DENIED" - Permission denied encountered while + // consuming data from Confluent Cloud. + // "PUBLISH_PERMISSION_DENIED" - Permission denied encountered while + // publishing to the topic. + // "UNREACHABLE_BOOTSTRAP_SERVER" - The provided bootstrap server address is + // unreachable. + // "CLUSTER_NOT_FOUND" - The provided cluster wasn't found. + // "TOPIC_NOT_FOUND" - The provided topic wasn't found. + State string `json:"state,omitempty"` + // Topic: Required. The name of the topic in the Confluent Cloud cluster that + // Pub/Sub will import from. + Topic string `json:"topic,omitempty"` + // ForceSendFields is a list of field names (e.g. "BootstrapServer") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "BootstrapServer") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s ConfluentCloud) MarshalJSON() ([]byte, error) { + type NoMethod ConfluentCloud + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // CreateSnapshotRequest: Request for the `CreateSnapshot` method. type CreateSnapshotRequest struct { // Labels: Optional. See Creating and managing labels @@ -899,8 +1055,14 @@ func (s Expr) MarshalJSON() ([]byte, error) { type IngestionDataSourceSettings struct { // AwsKinesis: Optional. Amazon Kinesis Data Streams. AwsKinesis *AwsKinesis `json:"awsKinesis,omitempty"` + // AwsMsk: Optional. Amazon MSK. + AwsMsk *AwsMsk `json:"awsMsk,omitempty"` + // AzureEventHubs: Optional. Azure Event Hubs. + AzureEventHubs *AzureEventHubs `json:"azureEventHubs,omitempty"` // CloudStorage: Optional. Cloud Storage. CloudStorage *CloudStorage `json:"cloudStorage,omitempty"` + // ConfluentCloud: Optional. Confluent Cloud. + ConfluentCloud *ConfluentCloud `json:"confluentCloud,omitempty"` // PlatformLogsSettings: Optional. Platform Logs settings. If unset, no // Platform Logs will be generated. PlatformLogsSettings *PlatformLogsSettings `json:"platformLogsSettings,omitempty"` diff --git a/retail/v2/retail-api.json b/retail/v2/retail-api.json index 682da451a9c..9fc069488f7 100644 --- a/retail/v2/retail-api.json +++ b/retail/v2/retail-api.json @@ -2223,7 +2223,7 @@ } } }, - "revision": "20241220", + "revision": "20250107", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -2869,7 +2869,7 @@ "id": "GoogleCloudRetailV2ColorInfo", "properties": { "colorFamilies": { - "description": "The standard color families. Strongly recommended to use the following standard color groups: \"Red\", \"Pink\", \"Orange\", \"Yellow\", \"Purple\", \"Green\", \"Cyan\", \"Blue\", \"Brown\", \"White\", \"Gray\", \"Black\" and \"Mixed\". Normally it is expected to have only 1 color family. May consider using single \"Mixed\" instead of multiple values. A maximum of 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).", + "description": "The standard color families. Strongly recommended to use the following standard color groups: \"Red\", \"Pink\", \"Orange\", \"Yellow\", \"Purple\", \"Green\", \"Cyan\", \"Blue\", \"Brown\", \"White\", \"Gray\", \"Black\" and \"Mixed\". Normally it is expected to have only 1 color family. May consider using single \"Mixed\" instead of multiple values. A maximum of 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color). The colorFamilies field as a system attribute is not a required field but strongly recommended to be specified. Google Search models treat this field as more important than a custom product attribute when specified.", "items": { "type": "string" }, @@ -4908,6 +4908,10 @@ "$ref": "GoogleCloudRetailV2RuleOnewaySynonymsAction", "description": "Treats specific term as a synonym with a group of terms. Group of terms will not be treated as synonyms with the specific term." }, + "pinAction": { + "$ref": "GoogleCloudRetailV2RulePinAction", + "description": "Pins one or more specified products to a specific position in the results." + }, "redirectAction": { "$ref": "GoogleCloudRetailV2RuleRedirectAction", "description": "Redirects a shopper to a specific page." @@ -5054,6 +5058,20 @@ }, "type": "object" }, + "GoogleCloudRetailV2RulePinAction": { + "description": "Pins one or more specified products to a specific position in the results. * Rule Condition: Must specify non-empty Condition.query_terms (for search only) or Condition.page_categories (for browse only), but can't specify both. * Action Input: mapping of `[pin_position, product_id]` pairs (pin position uses 1-based indexing). * Action Result: Will pin products with matching ids to the position specified in the final result order. Example: Suppose the query is `shoes`, the Condition.query_terms is `shoes` and the pin_map has `{1, \"pid1\"}`, then product with `pid1` will be pinned to the top position in the final results. If multiple PinActions are matched to a single request the actions will be processed from most to least recently updated. Pins to positions larger than the max allowed page size of 120 are not allowed.", + "id": "GoogleCloudRetailV2RulePinAction", + "properties": { + "pinMap": { + "additionalProperties": { + "type": "string" + }, + "description": "Required. A map of positions to product_ids. Partial matches per action are allowed, if a certain position in the map is already filled that `[position, product_id]` pair will be ignored but the rest may still be applied. This case will only occur if multiple pin actions are matched to a single request, as the map guarantees that pin positions are unique within the same action. Duplicate product_ids are not permitted within a single pin map. The max size of this map is 120, equivalent to the max [request page size](https://cloud.google.com/retail/docs/reference/rest/v2/projects.locations.catalogs.placements/search#request-body).", + "type": "object" + } + }, + "type": "object" + }, "GoogleCloudRetailV2RuleRedirectAction": { "description": "Redirects a shopper to a specific page. * Rule Condition: Must specify Condition.query_terms. * Action Input: Request Query * Action Result: Redirects shopper to provided uri.", "id": "GoogleCloudRetailV2RuleRedirectAction", diff --git a/retail/v2/retail-gen.go b/retail/v2/retail-gen.go index e7d1679bb86..b6bbe2cb637 100644 --- a/retail/v2/retail-gen.go +++ b/retail/v2/retail-gen.go @@ -1353,7 +1353,10 @@ type GoogleCloudRetailV2ColorInfo struct { // 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google // Merchant Center property color // (https://support.google.com/merchants/answer/6324487). Schema.org property - // Product.color (https://schema.org/color). + // Product.color (https://schema.org/color). The colorFamilies field as a + // system attribute is not a required field but strongly recommended to be + // specified. Google Search models treat this field as more important than a + // custom product attribute when specified. ColorFamilies []string `json:"colorFamilies,omitempty"` // Colors: The color display names, which may be different from standard color // family names, such as the color aliases used in the website frontend. @@ -4549,6 +4552,9 @@ type GoogleCloudRetailV2Rule struct { // terms. Group of terms will not be treated as synonyms with the specific // term. OnewaySynonymsAction *GoogleCloudRetailV2RuleOnewaySynonymsAction `json:"onewaySynonymsAction,omitempty"` + // PinAction: Pins one or more specified products to a specific position in the + // results. + PinAction *GoogleCloudRetailV2RulePinAction `json:"pinAction,omitempty"` // RedirectAction: Redirects a shopper to a specific page. RedirectAction *GoogleCloudRetailV2RuleRedirectAction `json:"redirectAction,omitempty"` // RemoveFacetAction: Remove an attribute as a facet in the request (if @@ -4818,6 +4824,47 @@ func (s GoogleCloudRetailV2RuleOnewaySynonymsAction) MarshalJSON() ([]byte, erro return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudRetailV2RulePinAction: Pins one or more specified products to a +// specific position in the results. * Rule Condition: Must specify non-empty +// Condition.query_terms (for search only) or Condition.page_categories (for +// browse only), but can't specify both. * Action Input: mapping of +// `[pin_position, product_id]` pairs (pin position uses 1-based indexing). * +// Action Result: Will pin products with matching ids to the position specified +// in the final result order. Example: Suppose the query is `shoes`, the +// Condition.query_terms is `shoes` and the pin_map has `{1, "pid1"}`, then +// product with `pid1` will be pinned to the top position in the final results. +// If multiple PinActions are matched to a single request the actions will be +// processed from most to least recently updated. Pins to positions larger than +// the max allowed page size of 120 are not allowed. +type GoogleCloudRetailV2RulePinAction struct { + // PinMap: Required. A map of positions to product_ids. Partial matches per + // action are allowed, if a certain position in the map is already filled that + // `[position, product_id]` pair will be ignored but the rest may still be + // applied. This case will only occur if multiple pin actions are matched to a + // single request, as the map guarantees that pin positions are unique within + // the same action. Duplicate product_ids are not permitted within a single pin + // map. The max size of this map is 120, equivalent to the max request page + // size + // (https://cloud.google.com/retail/docs/reference/rest/v2/projects.locations.catalogs.placements/search#request-body). + PinMap map[string]string `json:"pinMap,omitempty"` + // ForceSendFields is a list of field names (e.g. "PinMap") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "PinMap") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudRetailV2RulePinAction) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2RulePinAction + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudRetailV2RuleRedirectAction: Redirects a shopper to a specific // page. * Rule Condition: Must specify Condition.query_terms. * Action Input: // Request Query * Action Result: Redirects shopper to provided uri. diff --git a/retail/v2alpha/retail-api.json b/retail/v2alpha/retail-api.json index 44a2472cb62..18301771d0d 100644 --- a/retail/v2alpha/retail-api.json +++ b/retail/v2alpha/retail-api.json @@ -2744,7 +2744,7 @@ } } }, - "revision": "20241220", + "revision": "20250107", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -4180,7 +4180,7 @@ "id": "GoogleCloudRetailV2alphaColorInfo", "properties": { "colorFamilies": { - "description": "The standard color families. Strongly recommended to use the following standard color groups: \"Red\", \"Pink\", \"Orange\", \"Yellow\", \"Purple\", \"Green\", \"Cyan\", \"Blue\", \"Brown\", \"White\", \"Gray\", \"Black\" and \"Mixed\". Normally it is expected to have only 1 color family. May consider using single \"Mixed\" instead of multiple values. A maximum of 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).", + "description": "The standard color families. Strongly recommended to use the following standard color groups: \"Red\", \"Pink\", \"Orange\", \"Yellow\", \"Purple\", \"Green\", \"Cyan\", \"Blue\", \"Brown\", \"White\", \"Gray\", \"Black\" and \"Mixed\". Normally it is expected to have only 1 color family. May consider using single \"Mixed\" instead of multiple values. A maximum of 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color). The colorFamilies field as a system attribute is not a required field but strongly recommended to be specified. Google Search models treat this field as more important than a custom product attribute when specified.", "items": { "type": "string" }, @@ -6761,6 +6761,10 @@ "$ref": "GoogleCloudRetailV2alphaRuleOnewaySynonymsAction", "description": "Treats specific term as a synonym with a group of terms. Group of terms will not be treated as synonyms with the specific term." }, + "pinAction": { + "$ref": "GoogleCloudRetailV2alphaRulePinAction", + "description": "Pins one or more specified products to a specific position in the results." + }, "redirectAction": { "$ref": "GoogleCloudRetailV2alphaRuleRedirectAction", "description": "Redirects a shopper to a specific page." @@ -6907,6 +6911,20 @@ }, "type": "object" }, + "GoogleCloudRetailV2alphaRulePinAction": { + "description": "Pins one or more specified products to a specific position in the results. * Rule Condition: Must specify non-empty Condition.query_terms (for search only) or Condition.page_categories (for browse only), but can't specify both. * Action Input: mapping of `[pin_position, product_id]` pairs (pin position uses 1-based indexing). * Action Result: Will pin products with matching ids to the position specified in the final result order. Example: Suppose the query is `shoes`, the Condition.query_terms is `shoes` and the pin_map has `{1, \"pid1\"}`, then product with `pid1` will be pinned to the top position in the final results. If multiple PinActions are matched to a single request the actions will be processed from most to least recently updated. Pins to positions larger than the max allowed page size of 120 are not allowed.", + "id": "GoogleCloudRetailV2alphaRulePinAction", + "properties": { + "pinMap": { + "additionalProperties": { + "type": "string" + }, + "description": "Required. A map of positions to product_ids. Partial matches per action are allowed, if a certain position in the map is already filled that `[position, product_id]` pair will be ignored but the rest may still be applied. This case will only occur if multiple pin actions are matched to a single request, as the map guarantees that pin positions are unique within the same action. Duplicate product_ids are not permitted within a single pin map. The max size of this map is 120, equivalent to the max [request page size](https://cloud.google.com/retail/docs/reference/rest/v2/projects.locations.catalogs.placements/search#request-body).", + "type": "object" + } + }, + "type": "object" + }, "GoogleCloudRetailV2alphaRuleRedirectAction": { "description": "Redirects a shopper to a specific page. * Rule Condition: Must specify Condition.query_terms. * Action Input: Request Query * Action Result: Redirects shopper to provided uri.", "id": "GoogleCloudRetailV2alphaRuleRedirectAction", diff --git a/retail/v2alpha/retail-gen.go b/retail/v2alpha/retail-gen.go index d4cbd297393..40d1a7b46eb 100644 --- a/retail/v2alpha/retail-gen.go +++ b/retail/v2alpha/retail-gen.go @@ -2521,7 +2521,10 @@ type GoogleCloudRetailV2alphaColorInfo struct { // 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google // Merchant Center property color // (https://support.google.com/merchants/answer/6324487). Schema.org property - // Product.color (https://schema.org/color). + // Product.color (https://schema.org/color). The colorFamilies field as a + // system attribute is not a required field but strongly recommended to be + // specified. Google Search models treat this field as more important than a + // custom product attribute when specified. ColorFamilies []string `json:"colorFamilies,omitempty"` // Colors: The color display names, which may be different from standard color // family names, such as the color aliases used in the website frontend. @@ -6583,6 +6586,9 @@ type GoogleCloudRetailV2alphaRule struct { // terms. Group of terms will not be treated as synonyms with the specific // term. OnewaySynonymsAction *GoogleCloudRetailV2alphaRuleOnewaySynonymsAction `json:"onewaySynonymsAction,omitempty"` + // PinAction: Pins one or more specified products to a specific position in the + // results. + PinAction *GoogleCloudRetailV2alphaRulePinAction `json:"pinAction,omitempty"` // RedirectAction: Redirects a shopper to a specific page. RedirectAction *GoogleCloudRetailV2alphaRuleRedirectAction `json:"redirectAction,omitempty"` // RemoveFacetAction: Remove an attribute as a facet in the request (if @@ -6852,6 +6858,47 @@ func (s GoogleCloudRetailV2alphaRuleOnewaySynonymsAction) MarshalJSON() ([]byte, return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudRetailV2alphaRulePinAction: Pins one or more specified products +// to a specific position in the results. * Rule Condition: Must specify +// non-empty Condition.query_terms (for search only) or +// Condition.page_categories (for browse only), but can't specify both. * +// Action Input: mapping of `[pin_position, product_id]` pairs (pin position +// uses 1-based indexing). * Action Result: Will pin products with matching ids +// to the position specified in the final result order. Example: Suppose the +// query is `shoes`, the Condition.query_terms is `shoes` and the pin_map has +// `{1, "pid1"}`, then product with `pid1` will be pinned to the top position +// in the final results. If multiple PinActions are matched to a single request +// the actions will be processed from most to least recently updated. Pins to +// positions larger than the max allowed page size of 120 are not allowed. +type GoogleCloudRetailV2alphaRulePinAction struct { + // PinMap: Required. A map of positions to product_ids. Partial matches per + // action are allowed, if a certain position in the map is already filled that + // `[position, product_id]` pair will be ignored but the rest may still be + // applied. This case will only occur if multiple pin actions are matched to a + // single request, as the map guarantees that pin positions are unique within + // the same action. Duplicate product_ids are not permitted within a single pin + // map. The max size of this map is 120, equivalent to the max request page + // size + // (https://cloud.google.com/retail/docs/reference/rest/v2/projects.locations.catalogs.placements/search#request-body). + PinMap map[string]string `json:"pinMap,omitempty"` + // ForceSendFields is a list of field names (e.g. "PinMap") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "PinMap") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudRetailV2alphaRulePinAction) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2alphaRulePinAction + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudRetailV2alphaRuleRedirectAction: Redirects a shopper to a // specific page. * Rule Condition: Must specify Condition.query_terms. * // Action Input: Request Query * Action Result: Redirects shopper to provided diff --git a/retail/v2beta/retail-api.json b/retail/v2beta/retail-api.json index 070cca6ab22..edbb2e26661 100644 --- a/retail/v2beta/retail-api.json +++ b/retail/v2beta/retail-api.json @@ -2368,7 +2368,7 @@ } } }, - "revision": "20241220", + "revision": "20250107", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -4523,7 +4523,7 @@ "id": "GoogleCloudRetailV2betaColorInfo", "properties": { "colorFamilies": { - "description": "The standard color families. Strongly recommended to use the following standard color groups: \"Red\", \"Pink\", \"Orange\", \"Yellow\", \"Purple\", \"Green\", \"Cyan\", \"Blue\", \"Brown\", \"White\", \"Gray\", \"Black\" and \"Mixed\". Normally it is expected to have only 1 color family. May consider using single \"Mixed\" instead of multiple values. A maximum of 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).", + "description": "The standard color families. Strongly recommended to use the following standard color groups: \"Red\", \"Pink\", \"Orange\", \"Yellow\", \"Purple\", \"Green\", \"Cyan\", \"Blue\", \"Brown\", \"White\", \"Gray\", \"Black\" and \"Mixed\". Normally it is expected to have only 1 color family. May consider using single \"Mixed\" instead of multiple values. A maximum of 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color). The colorFamilies field as a system attribute is not a required field but strongly recommended to be specified. Google Search models treat this field as more important than a custom product attribute when specified.", "items": { "type": "string" }, @@ -6709,6 +6709,10 @@ "$ref": "GoogleCloudRetailV2betaRuleOnewaySynonymsAction", "description": "Treats specific term as a synonym with a group of terms. Group of terms will not be treated as synonyms with the specific term." }, + "pinAction": { + "$ref": "GoogleCloudRetailV2betaRulePinAction", + "description": "Pins one or more specified products to a specific position in the results." + }, "redirectAction": { "$ref": "GoogleCloudRetailV2betaRuleRedirectAction", "description": "Redirects a shopper to a specific page." @@ -6855,6 +6859,20 @@ }, "type": "object" }, + "GoogleCloudRetailV2betaRulePinAction": { + "description": "Pins one or more specified products to a specific position in the results. * Rule Condition: Must specify non-empty Condition.query_terms (for search only) or Condition.page_categories (for browse only), but can't specify both. * Action Input: mapping of `[pin_position, product_id]` pairs (pin position uses 1-based indexing). * Action Result: Will pin products with matching ids to the position specified in the final result order. Example: Suppose the query is `shoes`, the Condition.query_terms is `shoes` and the pin_map has `{1, \"pid1\"}`, then product with `pid1` will be pinned to the top position in the final results. If multiple PinActions are matched to a single request the actions will be processed from most to least recently updated. Pins to positions larger than the max allowed page size of 120 are not allowed.", + "id": "GoogleCloudRetailV2betaRulePinAction", + "properties": { + "pinMap": { + "additionalProperties": { + "type": "string" + }, + "description": "Required. A map of positions to product_ids. Partial matches per action are allowed, if a certain position in the map is already filled that `[position, product_id]` pair will be ignored but the rest may still be applied. This case will only occur if multiple pin actions are matched to a single request, as the map guarantees that pin positions are unique within the same action. Duplicate product_ids are not permitted within a single pin map. The max size of this map is 120, equivalent to the max [request page size](https://cloud.google.com/retail/docs/reference/rest/v2/projects.locations.catalogs.placements/search#request-body).", + "type": "object" + } + }, + "type": "object" + }, "GoogleCloudRetailV2betaRuleRedirectAction": { "description": "Redirects a shopper to a specific page. * Rule Condition: Must specify Condition.query_terms. * Action Input: Request Query * Action Result: Redirects shopper to provided uri.", "id": "GoogleCloudRetailV2betaRuleRedirectAction", diff --git a/retail/v2beta/retail-gen.go b/retail/v2beta/retail-gen.go index cadb7a7a125..90d3fef4183 100644 --- a/retail/v2beta/retail-gen.go +++ b/retail/v2beta/retail-gen.go @@ -3490,7 +3490,10 @@ type GoogleCloudRetailV2betaColorInfo struct { // 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google // Merchant Center property color // (https://support.google.com/merchants/answer/6324487). Schema.org property - // Product.color (https://schema.org/color). + // Product.color (https://schema.org/color). The colorFamilies field as a + // system attribute is not a required field but strongly recommended to be + // specified. Google Search models treat this field as more important than a + // custom product attribute when specified. ColorFamilies []string `json:"colorFamilies,omitempty"` // Colors: The color display names, which may be different from standard color // family names, such as the color aliases used in the website frontend. @@ -6955,6 +6958,9 @@ type GoogleCloudRetailV2betaRule struct { // terms. Group of terms will not be treated as synonyms with the specific // term. OnewaySynonymsAction *GoogleCloudRetailV2betaRuleOnewaySynonymsAction `json:"onewaySynonymsAction,omitempty"` + // PinAction: Pins one or more specified products to a specific position in the + // results. + PinAction *GoogleCloudRetailV2betaRulePinAction `json:"pinAction,omitempty"` // RedirectAction: Redirects a shopper to a specific page. RedirectAction *GoogleCloudRetailV2betaRuleRedirectAction `json:"redirectAction,omitempty"` // RemoveFacetAction: Remove an attribute as a facet in the request (if @@ -7224,6 +7230,47 @@ func (s GoogleCloudRetailV2betaRuleOnewaySynonymsAction) MarshalJSON() ([]byte, return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudRetailV2betaRulePinAction: Pins one or more specified products to +// a specific position in the results. * Rule Condition: Must specify non-empty +// Condition.query_terms (for search only) or Condition.page_categories (for +// browse only), but can't specify both. * Action Input: mapping of +// `[pin_position, product_id]` pairs (pin position uses 1-based indexing). * +// Action Result: Will pin products with matching ids to the position specified +// in the final result order. Example: Suppose the query is `shoes`, the +// Condition.query_terms is `shoes` and the pin_map has `{1, "pid1"}`, then +// product with `pid1` will be pinned to the top position in the final results. +// If multiple PinActions are matched to a single request the actions will be +// processed from most to least recently updated. Pins to positions larger than +// the max allowed page size of 120 are not allowed. +type GoogleCloudRetailV2betaRulePinAction struct { + // PinMap: Required. A map of positions to product_ids. Partial matches per + // action are allowed, if a certain position in the map is already filled that + // `[position, product_id]` pair will be ignored but the rest may still be + // applied. This case will only occur if multiple pin actions are matched to a + // single request, as the map guarantees that pin positions are unique within + // the same action. Duplicate product_ids are not permitted within a single pin + // map. The max size of this map is 120, equivalent to the max request page + // size + // (https://cloud.google.com/retail/docs/reference/rest/v2/projects.locations.catalogs.placements/search#request-body). + PinMap map[string]string `json:"pinMap,omitempty"` + // ForceSendFields is a list of field names (e.g. "PinMap") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "PinMap") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GoogleCloudRetailV2betaRulePinAction) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2betaRulePinAction + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudRetailV2betaRuleRedirectAction: Redirects a shopper to a specific // page. * Rule Condition: Must specify Condition.query_terms. * Action Input: // Request Query * Action Result: Redirects shopper to provided uri. diff --git a/securitycenter/v1/securitycenter-api.json b/securitycenter/v1/securitycenter-api.json index ff84de51051..fc56e0d283d 100644 --- a/securitycenter/v1/securitycenter-api.json +++ b/securitycenter/v1/securitycenter-api.json @@ -5938,7 +5938,7 @@ } } }, - "revision": "20241206", + "revision": "20250103", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -6145,14 +6145,26 @@ "type": "string" }, "volumeBps": { - "description": "Total BPS (bytes per second) volume of attack.", + "deprecated": true, + "description": "Total BPS (bytes per second) volume of attack. Deprecated - refer to volume_bps_long instead.", "format": "int32", "type": "integer" }, + "volumeBpsLong": { + "description": "Total BPS (bytes per second) volume of attack.", + "format": "int64", + "type": "string" + }, "volumePps": { - "description": "Total PPS (packets per second) volume of attack.", + "deprecated": true, + "description": "Total PPS (packets per second) volume of attack. Deprecated - refer to volume_pps_long instead.", "format": "int32", "type": "integer" + }, + "volumePpsLong": { + "description": "Total PPS (packets per second) volume of attack.", + "format": "int64", + "type": "string" } }, "type": "object" @@ -9131,14 +9143,26 @@ "type": "string" }, "volumeBps": { - "description": "Total BPS (bytes per second) volume of attack.", + "deprecated": true, + "description": "Total BPS (bytes per second) volume of attack. Deprecated - refer to volume_bps_long instead.", "format": "int32", "type": "integer" }, + "volumeBpsLong": { + "description": "Total BPS (bytes per second) volume of attack.", + "format": "int64", + "type": "string" + }, "volumePps": { - "description": "Total PPS (packets per second) volume of attack.", + "deprecated": true, + "description": "Total PPS (packets per second) volume of attack. Deprecated - refer to volume_pps_long instead.", "format": "int32", "type": "integer" + }, + "volumePpsLong": { + "description": "Total PPS (packets per second) volume of attack.", + "format": "int64", + "type": "string" } }, "type": "object" diff --git a/securitycenter/v1/securitycenter-gen.go b/securitycenter/v1/securitycenter-gen.go index 44ed8314eb5..1113acd528c 100644 --- a/securitycenter/v1/securitycenter-gen.go +++ b/securitycenter/v1/securitycenter-gen.go @@ -1175,10 +1175,16 @@ type Attack struct { // Classification: Type of attack, for example, 'SYN-flood', 'NTP-udp', or // 'CHARGEN-udp'. Classification string `json:"classification,omitempty"` - // VolumeBps: Total BPS (bytes per second) volume of attack. + // VolumeBps: Total BPS (bytes per second) volume of attack. Deprecated - refer + // to volume_bps_long instead. VolumeBps int64 `json:"volumeBps,omitempty"` - // VolumePps: Total PPS (packets per second) volume of attack. + // VolumeBpsLong: Total BPS (bytes per second) volume of attack. + VolumeBpsLong int64 `json:"volumeBpsLong,omitempty,string"` + // VolumePps: Total PPS (packets per second) volume of attack. Deprecated - + // refer to volume_pps_long instead. VolumePps int64 `json:"volumePps,omitempty"` + // VolumePpsLong: Total PPS (packets per second) volume of attack. + VolumePpsLong int64 `json:"volumePpsLong,omitempty,string"` // ForceSendFields is a list of field names (e.g. "Classification") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -4855,10 +4861,16 @@ type GoogleCloudSecuritycenterV2Attack struct { // Classification: Type of attack, for example, 'SYN-flood', 'NTP-udp', or // 'CHARGEN-udp'. Classification string `json:"classification,omitempty"` - // VolumeBps: Total BPS (bytes per second) volume of attack. + // VolumeBps: Total BPS (bytes per second) volume of attack. Deprecated - refer + // to volume_bps_long instead. VolumeBps int64 `json:"volumeBps,omitempty"` - // VolumePps: Total PPS (packets per second) volume of attack. + // VolumeBpsLong: Total BPS (bytes per second) volume of attack. + VolumeBpsLong int64 `json:"volumeBpsLong,omitempty,string"` + // VolumePps: Total PPS (packets per second) volume of attack. Deprecated - + // refer to volume_pps_long instead. VolumePps int64 `json:"volumePps,omitempty"` + // VolumePpsLong: Total PPS (packets per second) volume of attack. + VolumePpsLong int64 `json:"volumePpsLong,omitempty,string"` // ForceSendFields is a list of field names (e.g. "Classification") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See diff --git a/servicecontrol/v1/servicecontrol-api.json b/servicecontrol/v1/servicecontrol-api.json index dda7ac42fd8..7074eee1446 100644 --- a/servicecontrol/v1/servicecontrol-api.json +++ b/servicecontrol/v1/servicecontrol-api.json @@ -197,7 +197,7 @@ } } }, - "revision": "20240802", + "revision": "20250103", "rootUrl": "https://servicecontrol.googleapis.com/", "schemas": { "AllocateInfo": { @@ -289,7 +289,7 @@ "additionalProperties": { "$ref": "AttributeValue" }, - "description": "The set of attributes. Each attribute's key can be up to 128 bytes long. The value can be a string up to 256 bytes, a signed 64-bit integer, or the Boolean values `true` and `false`. For example: \"/instance_id\": \"my-instance\" \"/http/user_agent\": \"\" \"/http/request_bytes\": 300 \"abc.com/myattribute\": true", + "description": "The set of attributes. Each attribute's key can be up to 128 bytes long. The value can be a string up to 256 bytes, a signed 64-bit integer, or the Boolean values `true` and `false`. For example: \"/instance_id\": \"my-instance\" \"/http/user_agent\": \"\" \"/http/request_bytes\": 300 \"example.com/myattribute\": true", "type": "object" }, "droppedAttributesCount": { @@ -418,10 +418,6 @@ "description": "Structured claims presented with the credential. JWTs include `{key: value}` pairs for standard and private claims. The following is a subset of the standard required and optional claims that would typically be presented for a Google-based JWT: {'iss': 'accounts.google.com', 'sub': '113289723416554971153', 'aud': ['123456789012', 'pubsub.googleapis.com'], 'azp': '123456789012.apps.googleusercontent.com', 'email': 'jsmith@example.com', 'iat': 1353601026, 'exp': 1353604926} SAML assertions are similarly specified, but with an identity provider dependent structure.", "type": "object" }, - "credentialId": { - "description": "Identifies the client credential id used for authentication. credential_id is in the format of AUTH_METHOD:IDENTIFIER, e.g. \"serviceaccount:XXXXX, apikey:XXXXX\" where the format of the IDENTIFIER can vary for different AUTH_METHODs.", - "type": "string" - }, "presenter": { "description": "The authorized presenter of the credential. Reflects the optional Authorized Presenter (`azp`) claim within a JWT or the OAuth client id. For example, a Google Cloud Platform client id looks as follows: \"123456789012.apps.googleusercontent.com\".", "type": "string" @@ -905,7 +901,7 @@ "type": "string" }, "referer": { - "description": "The referer URL of the request, as defined in [HTTP/1.1 Header Field Definitions](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).", + "description": "The referer URL of the request, as defined in [HTTP/1.1 Header Field Definitions](https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).", "type": "string" }, "remoteIp": { @@ -1994,7 +1990,7 @@ "type": "string" }, "referer": { - "description": "The referer URL of the request, as defined in [HTTP/1.1 Header Field Definitions](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).", + "description": "The referer URL of the request, as defined in [HTTP/1.1 Header Field Definitions](https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).", "type": "string" }, "remoteIp": { diff --git a/servicecontrol/v1/servicecontrol-gen.go b/servicecontrol/v1/servicecontrol-gen.go index 61331f8919a..79c788f025b 100644 --- a/servicecontrol/v1/servicecontrol-gen.go +++ b/servicecontrol/v1/servicecontrol-gen.go @@ -300,7 +300,7 @@ type Attributes struct { // bytes long. The value can be a string up to 256 bytes, a signed 64-bit // integer, or the Boolean values `true` and `false`. For example: // "/instance_id": "my-instance" "/http/user_agent": "" "/http/request_bytes": - // 300 "abc.com/myattribute": true + // 300 "example.com/myattribute": true AttributeMap map[string]AttributeValue `json:"attributeMap,omitempty"` // DroppedAttributesCount: The number of attributes that were discarded. // Attributes can be discarded because their keys are too long or because there @@ -434,11 +434,6 @@ type Auth struct { // 'jsmith@example.com', 'iat': 1353601026, 'exp': 1353604926} SAML assertions // are similarly specified, but with an identity provider dependent structure. Claims googleapi.RawMessage `json:"claims,omitempty"` - // CredentialId: Identifies the client credential id used for authentication. - // credential_id is in the format of AUTH_METHOD:IDENTIFIER, e.g. - // "serviceaccount:XXXXX, apikey:XXXXX" where the format of the IDENTIFIER can - // vary for different AUTH_METHODs. - CredentialId string `json:"credentialId,omitempty"` // Presenter: The authorized presenter of the credential. Reflects the optional // Authorized Presenter (`azp`) claim within a JWT or the OAuth client id. For // example, a Google Cloud Platform client id looks as follows: @@ -1095,7 +1090,7 @@ type HttpRequest struct { // "websocket" Protocol string `json:"protocol,omitempty"` // Referer: The referer URL of the request, as defined in HTTP/1.1 Header Field - // Definitions (http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html). + // Definitions (https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html). Referer string `json:"referer,omitempty"` // RemoteIp: The IP address (IPv4 or IPv6) of the client that issued the HTTP // request. Examples: "192.168.1.1", "FE80::0202:B3FF:FE1E:8329". @@ -2525,7 +2520,7 @@ type V1HttpRequest struct { // "websocket" Protocol string `json:"protocol,omitempty"` // Referer: The referer URL of the request, as defined in HTTP/1.1 Header Field - // Definitions (http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html). + // Definitions (https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html). Referer string `json:"referer,omitempty"` // RemoteIp: The IP address (IPv4 or IPv6) of the client that issued the HTTP // request. Examples: "192.168.1.1", "FE80::0202:B3FF:FE1E:8329". diff --git a/servicecontrol/v2/servicecontrol-api.json b/servicecontrol/v2/servicecontrol-api.json index 664fa107baf..00d6e9e5f5e 100644 --- a/servicecontrol/v2/servicecontrol-api.json +++ b/servicecontrol/v2/servicecontrol-api.json @@ -169,7 +169,7 @@ } } }, - "revision": "20241205", + "revision": "20250103", "rootUrl": "https://servicecontrol.googleapis.com/", "schemas": { "Api": { @@ -359,10 +359,6 @@ "description": "Structured claims presented with the credential. JWTs include `{key: value}` pairs for standard and private claims. The following is a subset of the standard required and optional claims that would typically be presented for a Google-based JWT: {'iss': 'accounts.google.com', 'sub': '113289723416554971153', 'aud': ['123456789012', 'pubsub.googleapis.com'], 'azp': '123456789012.apps.googleusercontent.com', 'email': 'jsmith@example.com', 'iat': 1353601026, 'exp': 1353604926} SAML assertions are similarly specified, but with an identity provider dependent structure.", "type": "object" }, - "credentialId": { - "description": "Identifies the client credential id used for authentication. credential_id is in the format of AUTH_METHOD:IDENTIFIER, e.g. \"serviceaccount:XXXXX, apikey:XXXXX\" where the format of the IDENTIFIER can vary for different AUTH_METHODs.", - "type": "string" - }, "presenter": { "description": "The authorized presenter of the credential. Reflects the optional Authorized Presenter (`azp`) claim within a JWT or the OAuth client id. For example, a Google Cloud Platform client id looks as follows: \"123456789012.apps.googleusercontent.com\".", "type": "string" @@ -1015,7 +1011,7 @@ "type": "string" }, "referer": { - "description": "The referer URL of the request, as defined in [HTTP/1.1 Header Field Definitions](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).", + "description": "The referer URL of the request, as defined in [HTTP/1.1 Header Field Definitions](https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).", "type": "string" }, "remoteIp": { diff --git a/servicecontrol/v2/servicecontrol-gen.go b/servicecontrol/v2/servicecontrol-gen.go index 1cb0d6cf880..66aa94653f9 100644 --- a/servicecontrol/v2/servicecontrol-gen.go +++ b/servicecontrol/v2/servicecontrol-gen.go @@ -377,11 +377,6 @@ type Auth struct { // 'jsmith@example.com', 'iat': 1353601026, 'exp': 1353604926} SAML assertions // are similarly specified, but with an identity provider dependent structure. Claims googleapi.RawMessage `json:"claims,omitempty"` - // CredentialId: Identifies the client credential id used for authentication. - // credential_id is in the format of AUTH_METHOD:IDENTIFIER, e.g. - // "serviceaccount:XXXXX, apikey:XXXXX" where the format of the IDENTIFIER can - // vary for different AUTH_METHODs. - CredentialId string `json:"credentialId,omitempty"` // Presenter: The authorized presenter of the credential. Reflects the optional // Authorized Presenter (`azp`) claim within a JWT or the OAuth client id. For // example, a Google Cloud Platform client id looks as follows: @@ -1261,7 +1256,7 @@ type V2HttpRequest struct { // "websocket" Protocol string `json:"protocol,omitempty"` // Referer: The referer URL of the request, as defined in HTTP/1.1 Header Field - // Definitions (http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html). + // Definitions (https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html). Referer string `json:"referer,omitempty"` // RemoteIp: The IP address (IPv4 or IPv6) of the client that issued the HTTP // request. Examples: "192.168.1.1", "FE80::0202:B3FF:FE1E:8329". diff --git a/serviceusage/v1/serviceusage-api.json b/serviceusage/v1/serviceusage-api.json index 097ca7f58d2..de2e334e636 100644 --- a/serviceusage/v1/serviceusage-api.json +++ b/serviceusage/v1/serviceusage-api.json @@ -426,7 +426,7 @@ } } }, - "revision": "20241205", + "revision": "20241219", "rootUrl": "https://serviceusage.googleapis.com/", "schemas": { "AddEnableRulesMetadata": { @@ -502,12 +502,14 @@ "enum": [ "ANALYSIS_TYPE_UNSPECIFIED", "ANALYSIS_TYPE_DEPENDENCY", - "ANALYSIS_TYPE_RESOURCE_USAGE" + "ANALYSIS_TYPE_RESOURCE_USAGE", + "ANALYSIS_TYPE_RESOURCE_EXISTENCE" ], "enumDescriptions": [ "Unspecified analysis type. Do not use.", "The analysis of service dependencies.", - "The analysis of service resource usage." + "The analysis of service resource usage.", + "The analysis of service resource existence." ], "readOnly": true, "type": "string" @@ -2305,14 +2307,20 @@ "description": "Output only. The type of impact.", "enum": [ "IMPACT_TYPE_UNSPECIFIED", - "DEPENDENCY_MISSING_DEPENDENCIES" + "DEPENDENCY_MISSING_DEPENDENCIES", + "RESOURCE_EXISTENCE_PROJECT" ], "enumDescriptions": [ - "Reserved Blocks (Block n contains codes from 100n to 100(n+1) -1 Block 0 - Special/Admin codes Block 1 - Impact Type of ANALYSIS_TYPE_DEPENDENCY Block 2 - Impact Type of ANALYSIS_TYPE_RESOURCE_USAGE ...", - "Block 1 - Impact Type of ANALYSIS_TYPE_DEPENDENCY" + "Reserved Blocks (Block n contains codes from 100n to 100(n+1) -1 Block 0 - Special/Admin codes Block 1 - Impact Type of ANALYSIS_TYPE_DEPENDENCY Block 2 - Impact Type of ANALYSIS_TYPE_RESOURCE_USAGE Block 3 - Impact Type of ANALYSIS_TYPE_RESOURCE_EXISTENCE ...", + "Block 1 - Impact Type of ANALYSIS_TYPE_DEPENDENCY", + "Block 3 - Impact Type of ANALYSIS_TYPE_RESOURCE_EXISTENCE" ], "readOnly": true, "type": "string" + }, + "parent": { + "description": "The parent resource that the analysis is based on and the service name that the analysis is for. Example: `projects/100/services/compute.googleapis.com`, folders/101/services/compute.googleapis.com` and `organizations/102/services/compute.googleapis.com`. Usually, the parent resource here is same as the parent resource of the analyzed policy. However, for some analysis types, the parent can be different. For example, for resource existence analysis, if the parent resource of the analyzed policy is a folder or an organization, the parent resource here can still be the project that contains the resources.", + "type": "string" } }, "type": "object" diff --git a/serviceusage/v1/serviceusage-gen.go b/serviceusage/v1/serviceusage-gen.go index 5934e7095e7..0178941563c 100644 --- a/serviceusage/v1/serviceusage-gen.go +++ b/serviceusage/v1/serviceusage-gen.go @@ -282,6 +282,8 @@ type Analysis struct { // "ANALYSIS_TYPE_UNSPECIFIED" - Unspecified analysis type. Do not use. // "ANALYSIS_TYPE_DEPENDENCY" - The analysis of service dependencies. // "ANALYSIS_TYPE_RESOURCE_USAGE" - The analysis of service resource usage. + // "ANALYSIS_TYPE_RESOURCE_EXISTENCE" - The analysis of service resource + // existence. AnalysisType string `json:"analysisType,omitempty"` // DisplayName: Output only. The user friendly display name of the analysis // type. E.g. service dependency analysis, service resource usage analysis, @@ -2744,10 +2746,24 @@ type Impact struct { // "IMPACT_TYPE_UNSPECIFIED" - Reserved Blocks (Block n contains codes from // 100n to 100(n+1) -1 Block 0 - Special/Admin codes Block 1 - Impact Type of // ANALYSIS_TYPE_DEPENDENCY Block 2 - Impact Type of - // ANALYSIS_TYPE_RESOURCE_USAGE ... + // ANALYSIS_TYPE_RESOURCE_USAGE Block 3 - Impact Type of + // ANALYSIS_TYPE_RESOURCE_EXISTENCE ... // "DEPENDENCY_MISSING_DEPENDENCIES" - Block 1 - Impact Type of // ANALYSIS_TYPE_DEPENDENCY + // "RESOURCE_EXISTENCE_PROJECT" - Block 3 - Impact Type of + // ANALYSIS_TYPE_RESOURCE_EXISTENCE ImpactType string `json:"impactType,omitempty"` + // Parent: The parent resource that the analysis is based on and the service + // name that the analysis is for. Example: + // `projects/100/services/compute.googleapis.com`, + // folders/101/services/compute.googleapis.com` and + // `organizations/102/services/compute.googleapis.com`. Usually, the parent + // resource here is same as the parent resource of the analyzed policy. + // However, for some analysis types, the parent can be different. For example, + // for resource existence analysis, if the parent resource of the analyzed + // policy is a folder or an organization, the parent resource here can still be + // the project that contains the resources. + Parent string `json:"parent,omitempty"` // ForceSendFields is a list of field names (e.g. "Detail") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See diff --git a/serviceusage/v1beta1/serviceusage-api.json b/serviceusage/v1beta1/serviceusage-api.json index e3a1daf1824..5af7c35d662 100644 --- a/serviceusage/v1beta1/serviceusage-api.json +++ b/serviceusage/v1beta1/serviceusage-api.json @@ -964,7 +964,7 @@ } } }, - "revision": "20241205", + "revision": "20241219", "rootUrl": "https://serviceusage.googleapis.com/", "schemas": { "AddEnableRulesMetadata": { @@ -1040,12 +1040,14 @@ "enum": [ "ANALYSIS_TYPE_UNSPECIFIED", "ANALYSIS_TYPE_DEPENDENCY", - "ANALYSIS_TYPE_RESOURCE_USAGE" + "ANALYSIS_TYPE_RESOURCE_USAGE", + "ANALYSIS_TYPE_RESOURCE_EXISTENCE" ], "enumDescriptions": [ "Unspecified analysis type. Do not use.", "The analysis of service dependencies.", - "The analysis of service resource usage." + "The analysis of service resource usage.", + "The analysis of service resource existence." ], "readOnly": true, "type": "string" @@ -2882,14 +2884,20 @@ "description": "Output only. The type of impact.", "enum": [ "IMPACT_TYPE_UNSPECIFIED", - "DEPENDENCY_MISSING_DEPENDENCIES" + "DEPENDENCY_MISSING_DEPENDENCIES", + "RESOURCE_EXISTENCE_PROJECT" ], "enumDescriptions": [ - "Reserved Blocks (Block n contains codes from 100n to 100(n+1) -1 Block 0 - Special/Admin codes Block 1 - Impact Type of ANALYSIS_TYPE_DEPENDENCY Block 2 - Impact Type of ANALYSIS_TYPE_RESOURCE_USAGE ...", - "Block 1 - Impact Type of ANALYSIS_TYPE_DEPENDENCY" + "Reserved Blocks (Block n contains codes from 100n to 100(n+1) -1 Block 0 - Special/Admin codes Block 1 - Impact Type of ANALYSIS_TYPE_DEPENDENCY Block 2 - Impact Type of ANALYSIS_TYPE_RESOURCE_USAGE Block 3 - Impact Type of ANALYSIS_TYPE_RESOURCE_EXISTENCE ...", + "Block 1 - Impact Type of ANALYSIS_TYPE_DEPENDENCY", + "Block 3 - Impact Type of ANALYSIS_TYPE_RESOURCE_EXISTENCE" ], "readOnly": true, "type": "string" + }, + "parent": { + "description": "The parent resource that the analysis is based on and the service name that the analysis is for. Example: `projects/100/services/compute.googleapis.com`, folders/101/services/compute.googleapis.com` and `organizations/102/services/compute.googleapis.com`. Usually, the parent resource here is same as the parent resource of the analyzed policy. However, for some analysis types, the parent can be different. For example, for resource existence analysis, if the parent resource of the analyzed policy is a folder or an organization, the parent resource here can still be the project that contains the resources.", + "type": "string" } }, "type": "object" diff --git a/serviceusage/v1beta1/serviceusage-gen.go b/serviceusage/v1beta1/serviceusage-gen.go index ec5262806c4..eae0cbf70b0 100644 --- a/serviceusage/v1beta1/serviceusage-gen.go +++ b/serviceusage/v1beta1/serviceusage-gen.go @@ -330,6 +330,8 @@ type Analysis struct { // "ANALYSIS_TYPE_UNSPECIFIED" - Unspecified analysis type. Do not use. // "ANALYSIS_TYPE_DEPENDENCY" - The analysis of service dependencies. // "ANALYSIS_TYPE_RESOURCE_USAGE" - The analysis of service resource usage. + // "ANALYSIS_TYPE_RESOURCE_EXISTENCE" - The analysis of service resource + // existence. AnalysisType string `json:"analysisType,omitempty"` // DisplayName: Output only. The user friendly display name of the analysis // type. E.g. service dependency analysis, service resource usage analysis, @@ -2820,10 +2822,24 @@ type Impact struct { // "IMPACT_TYPE_UNSPECIFIED" - Reserved Blocks (Block n contains codes from // 100n to 100(n+1) -1 Block 0 - Special/Admin codes Block 1 - Impact Type of // ANALYSIS_TYPE_DEPENDENCY Block 2 - Impact Type of - // ANALYSIS_TYPE_RESOURCE_USAGE ... + // ANALYSIS_TYPE_RESOURCE_USAGE Block 3 - Impact Type of + // ANALYSIS_TYPE_RESOURCE_EXISTENCE ... // "DEPENDENCY_MISSING_DEPENDENCIES" - Block 1 - Impact Type of // ANALYSIS_TYPE_DEPENDENCY + // "RESOURCE_EXISTENCE_PROJECT" - Block 3 - Impact Type of + // ANALYSIS_TYPE_RESOURCE_EXISTENCE ImpactType string `json:"impactType,omitempty"` + // Parent: The parent resource that the analysis is based on and the service + // name that the analysis is for. Example: + // `projects/100/services/compute.googleapis.com`, + // folders/101/services/compute.googleapis.com` and + // `organizations/102/services/compute.googleapis.com`. Usually, the parent + // resource here is same as the parent resource of the analyzed policy. + // However, for some analysis types, the parent can be different. For example, + // for resource existence analysis, if the parent resource of the analyzed + // policy is a folder or an organization, the parent resource here can still be + // the project that contains the resources. + Parent string `json:"parent,omitempty"` // ForceSendFields is a list of field names (e.g. "Detail") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See diff --git a/sqladmin/v1/sqladmin-api.json b/sqladmin/v1/sqladmin-api.json index ec6c5a8c032..dadc1657da8 100644 --- a/sqladmin/v1/sqladmin-api.json +++ b/sqladmin/v1/sqladmin-api.json @@ -2366,7 +2366,7 @@ } } }, - "revision": "20241204", + "revision": "20241210", "rootUrl": "https://sqladmin.googleapis.com/", "schemas": { "AclEntry": { @@ -5216,7 +5216,6 @@ "description": "Optional. The sub operation based on the operation type." }, "targetId": { - "description": "Name of the database instance related to this operation.", "type": "string" }, "targetLink": { diff --git a/sqladmin/v1/sqladmin-gen.go b/sqladmin/v1/sqladmin-gen.go index 97c038ed286..9f1a8b626f6 100644 --- a/sqladmin/v1/sqladmin-gen.go +++ b/sqladmin/v1/sqladmin-gen.go @@ -3284,9 +3284,8 @@ type Operation struct { Status string `json:"status,omitempty"` // SubOperationType: Optional. The sub operation based on the operation type. SubOperationType *SqlSubOperationType `json:"subOperationType,omitempty"` - // TargetId: Name of the database instance related to this operation. - TargetId string `json:"targetId,omitempty"` - TargetLink string `json:"targetLink,omitempty"` + TargetId string `json:"targetId,omitempty"` + TargetLink string `json:"targetLink,omitempty"` // TargetProject: The project ID of the target instance related to this // operation. TargetProject string `json:"targetProject,omitempty"` diff --git a/sqladmin/v1beta4/sqladmin-api.json b/sqladmin/v1beta4/sqladmin-api.json index e3bad66ab34..3c04df7a722 100644 --- a/sqladmin/v1beta4/sqladmin-api.json +++ b/sqladmin/v1beta4/sqladmin-api.json @@ -2366,7 +2366,7 @@ } } }, - "revision": "20241204", + "revision": "20241210", "rootUrl": "https://sqladmin.googleapis.com/", "schemas": { "AclEntry": { @@ -5217,7 +5217,6 @@ "description": "Optional. The sub operation based on the operation type." }, "targetId": { - "description": "Name of the database instance related to this operation.", "type": "string" }, "targetLink": { diff --git a/sqladmin/v1beta4/sqladmin-gen.go b/sqladmin/v1beta4/sqladmin-gen.go index f92dfc6c1f8..f057f2d83d9 100644 --- a/sqladmin/v1beta4/sqladmin-gen.go +++ b/sqladmin/v1beta4/sqladmin-gen.go @@ -3290,9 +3290,8 @@ type Operation struct { Status string `json:"status,omitempty"` // SubOperationType: Optional. The sub operation based on the operation type. SubOperationType *SqlSubOperationType `json:"subOperationType,omitempty"` - // TargetId: Name of the database instance related to this operation. - TargetId string `json:"targetId,omitempty"` - TargetLink string `json:"targetLink,omitempty"` + TargetId string `json:"targetId,omitempty"` + TargetLink string `json:"targetLink,omitempty"` // TargetProject: The project ID of the target instance related to this // operation. TargetProject string `json:"targetProject,omitempty"` diff --git a/tasks/v1/tasks-api.json b/tasks/v1/tasks-api.json index 62f7c80abf2..08812a2772b 100644 --- a/tasks/v1/tasks-api.json +++ b/tasks/v1/tasks-api.json @@ -475,12 +475,12 @@ "type": "string" }, "parent": { - "description": "New parent task identifier. If the task is moved to the top level, this parameter is omitted. Assigned tasks can not be set as parent task (have subtasks) or be moved under a parent task (become subtasks). Optional.", + "description": "New parent task identifier. If the task is moved to the top level, this parameter is omitted. The task set as parent must exist in the task list and can not be hidden. Assigned tasks can not be set as parent task (have subtasks) or be moved under a parent task (become subtasks). Optional.", "location": "query", "type": "string" }, "previous": { - "description": "New previous sibling task identifier. If the task is moved to the first position among its siblings, this parameter is omitted. Optional.", + "description": "New previous sibling task identifier. If the task is moved to the first position among its siblings, this parameter is omitted. The task set as previous must exist in the task list and can not be hidden. Optional.", "location": "query", "type": "string" }, @@ -576,7 +576,7 @@ } } }, - "revision": "20240630", + "revision": "20250105", "rootUrl": "https://tasks.googleapis.com/", "schemas": { "AssignmentInfo": { diff --git a/tasks/v1/tasks-gen.go b/tasks/v1/tasks-gen.go index d3b9e55a885..c78f1b8c658 100644 --- a/tasks/v1/tasks-gen.go +++ b/tasks/v1/tasks-gen.go @@ -1749,9 +1749,10 @@ func (c *TasksMoveCall) DestinationTasklist(destinationTasklist string) *TasksMo } // Parent sets the optional parameter "parent": New parent task identifier. If -// the task is moved to the top level, this parameter is omitted. Assigned -// tasks can not be set as parent task (have subtasks) or be moved under a -// parent task (become subtasks). +// the task is moved to the top level, this parameter is omitted. The task set +// as parent must exist in the task list and can not be hidden. Assigned tasks +// can not be set as parent task (have subtasks) or be moved under a parent +// task (become subtasks). func (c *TasksMoveCall) Parent(parent string) *TasksMoveCall { c.urlParams_.Set("parent", parent) return c @@ -1759,7 +1760,8 @@ func (c *TasksMoveCall) Parent(parent string) *TasksMoveCall { // Previous sets the optional parameter "previous": New previous sibling task // identifier. If the task is moved to the first position among its siblings, -// this parameter is omitted. +// this parameter is omitted. The task set as previous must exist in the task +// list and can not be hidden. func (c *TasksMoveCall) Previous(previous string) *TasksMoveCall { c.urlParams_.Set("previous", previous) return c diff --git a/testing/v1/testing-api.json b/testing/v1/testing-api.json index cd2b5ba5894..2c5c202dbea 100644 --- a/testing/v1/testing-api.json +++ b/testing/v1/testing-api.json @@ -449,7 +449,7 @@ } } }, - "revision": "20241105", + "revision": "20241231", "rootUrl": "https://testing.googleapis.com/", "schemas": { "Account": { @@ -1573,7 +1573,7 @@ }, "roboScript": { "$ref": "FileReference", - "description": "An optional Roboscript to customize the crawl. See https://firebase.google.com/docs/test-lab/android/robo-scripts-reference for more information about Roboscripts." + "description": "An optional Roboscript to customize the crawl. See https://firebase.google.com/docs/test-lab/android/robo-scripts-reference for more information about Roboscripts. The maximum allowed file size of the roboscript is 10MiB." } }, "type": "object" diff --git a/testing/v1/testing-gen.go b/testing/v1/testing-gen.go index 6ed632b481c..99ef069363e 100644 --- a/testing/v1/testing-gen.go +++ b/testing/v1/testing-gen.go @@ -1534,7 +1534,8 @@ type IosRoboTest struct { AppIpa *FileReference `json:"appIpa,omitempty"` // RoboScript: An optional Roboscript to customize the crawl. See // https://firebase.google.com/docs/test-lab/android/robo-scripts-reference for - // more information about Roboscripts. + // more information about Roboscripts. The maximum allowed file size of the + // roboscript is 10MiB. RoboScript *FileReference `json:"roboScript,omitempty"` // ForceSendFields is a list of field names (e.g. "AppBundleId") to // unconditionally include in API requests. By default, fields with empty or diff --git a/workstations/v1/workstations-api.json b/workstations/v1/workstations-api.json index 17375eca087..b8ee4c23eda 100644 --- a/workstations/v1/workstations-api.json +++ b/workstations/v1/workstations-api.json @@ -1195,7 +1195,7 @@ } } }, - "revision": "20241202", + "revision": "20250101", "rootUrl": "https://workstations.googleapis.com/", "schemas": { "Accelerator": { @@ -1285,7 +1285,7 @@ "type": "object" }, "BoostConfig": { - "description": "A boost configuration is a set of resources that a workstation can use to increase its performance. If a boost configuration is specified, when starting a workstation, users can choose to use a VM provisioned under the boost config by passing the boost config id in the start request. If no boost config id is provided in the start request, the system will choose a VM from the pool provisioned under the default config.", + "description": "A boost configuration is a set of resources that a workstation can use to increase its performance. If you specify a boost configuration, upon startup, workstation users can choose to use a VM provisioned under the boost config by passing the boost config ID in the start request. If the workstation user does not provide a boost config ID in the start request, the system will choose a VM from the pool provisioned under the default config.", "id": "BoostConfig", "properties": { "accelerators": { @@ -1305,7 +1305,7 @@ "type": "boolean" }, "id": { - "description": "Required. The id to be used for the boost configuration.", + "description": "Required. The ID to be used for the boost configuration.", "type": "string" }, "machineType": { @@ -1528,6 +1528,28 @@ }, "type": "object" }, + "GceInstanceHost": { + "description": "The Compute Engine instance host.", + "id": "GceInstanceHost", + "properties": { + "id": { + "description": "Optional. Output only. The ID of the Compute Engine instance.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Optional. Output only. The name of the Compute Engine instance.", + "readOnly": true, + "type": "string" + }, + "zone": { + "description": "Optional. Output only. The zone of the Compute Engine instance.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "GcePersistentDisk": { "description": "An EphemeralDirectory is backed by a Compute Engine persistent disk.", "id": "GcePersistentDisk", @@ -1938,7 +1960,7 @@ "type": "object" }, "PersistentDirectory": { - "description": "A directory to persist across workstation sessions.", + "description": "A directory to persist across workstation sessions. Updates to this field will not update existing workstations and will only take effect on new workstations.", "id": "PersistentDirectory", "properties": { "gcePd": { @@ -2044,6 +2066,17 @@ }, "type": "object" }, + "RuntimeHost": { + "description": "Runtime host for the workstation.", + "id": "RuntimeHost", + "properties": { + "gceInstanceHost": { + "$ref": "GceInstanceHost", + "description": "Specifies a Compute Engine instance as the host." + } + }, + "type": "object" + }, "SetIamPolicyRequest": { "description": "Request message for `SetIamPolicy` method.", "id": "SetIamPolicyRequest", @@ -2064,6 +2097,10 @@ "description": "Request message for StartWorkstation.", "id": "StartWorkstationRequest", "properties": { + "boostConfig": { + "description": "Optional. If set, the workstation starts using the boost configuration with the specified ID.", + "type": "string" + }, "etag": { "description": "Optional. If set, the request will be rejected if the latest version of the workstation on the server does not have this ETag.", "type": "string" @@ -2209,6 +2246,15 @@ "readOnly": true, "type": "boolean" }, + "runtimeHost": { + "$ref": "RuntimeHost", + "description": "Optional. Output only. Runtime host for the workstation when in STATE_RUNNING.", + "readOnly": true + }, + "sourceWorkstation": { + "description": "Optional. The source workstation from which this workstation's persistent directories were cloned on creation.", + "type": "string" + }, "startTime": { "description": "Output only. Time when this workstation was most recently successfully started, regardless of the workstation's initial state.", "format": "google-datetime", diff --git a/workstations/v1/workstations-gen.go b/workstations/v1/workstations-gen.go index 73846a60b39..a51fdb08586 100644 --- a/workstations/v1/workstations-gen.go +++ b/workstations/v1/workstations-gen.go @@ -427,11 +427,12 @@ func (s Binding) MarshalJSON() ([]byte, error) { } // BoostConfig: A boost configuration is a set of resources that a workstation -// can use to increase its performance. If a boost configuration is specified, -// when starting a workstation, users can choose to use a VM provisioned under -// the boost config by passing the boost config id in the start request. If no -// boost config id is provided in the start request, the system will choose a -// VM from the pool provisioned under the default config. +// can use to increase its performance. If you specify a boost configuration, +// upon startup, workstation users can choose to use a VM provisioned under the +// boost config by passing the boost config ID in the start request. If the +// workstation user does not provide a boost config ID in the start request, +// the system will choose a VM from the pool provisioned under the default +// config. type BoostConfig struct { // Accelerators: Optional. A list of the type and count of accelerator cards // attached to the boost instance. Defaults to `none`. @@ -459,7 +460,7 @@ type BoostConfig struct { // nested virtualization can only be enabled on boost configurations that // specify a machine_type in the N1 or N2 machine series. EnableNestedVirtualization bool `json:"enableNestedVirtualization,omitempty"` - // Id: Required. The id to be used for the boost configuration. + // Id: Required. The ID to be used for the boost configuration. Id string `json:"id,omitempty"` // MachineType: Optional. The type of machine that boosted VM instances will // use—for example, `e2-standard-4`. For more information about machine types @@ -804,6 +805,32 @@ func (s GceInstance) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GceInstanceHost: The Compute Engine instance host. +type GceInstanceHost struct { + // Id: Optional. Output only. The ID of the Compute Engine instance. + Id string `json:"id,omitempty"` + // Name: Optional. Output only. The name of the Compute Engine instance. + Name string `json:"name,omitempty"` + // Zone: Optional. Output only. The zone of the Compute Engine instance. + Zone string `json:"zone,omitempty"` + // ForceSendFields is a list of field names (e.g. "Id") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Id") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GceInstanceHost) MarshalJSON() ([]byte, error) { + type NoMethod GceInstanceHost + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GcePersistentDisk: An EphemeralDirectory is backed by a Compute Engine // persistent disk. type GcePersistentDisk struct { @@ -1346,6 +1373,8 @@ func (s OperationMetadata) MarshalJSON() ([]byte, error) { } // PersistentDirectory: A directory to persist across workstation sessions. +// Updates to this field will not update existing workstations and will only +// take effect on new workstations. type PersistentDirectory struct { // GcePd: A PersistentDirectory backed by a Compute Engine persistent disk. GcePd *GceRegionalPersistentDisk `json:"gcePd,omitempty"` @@ -1551,6 +1580,28 @@ func (s ReadinessCheck) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// RuntimeHost: Runtime host for the workstation. +type RuntimeHost struct { + // GceInstanceHost: Specifies a Compute Engine instance as the host. + GceInstanceHost *GceInstanceHost `json:"gceInstanceHost,omitempty"` + // ForceSendFields is a list of field names (e.g. "GceInstanceHost") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "GceInstanceHost") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s RuntimeHost) MarshalJSON() ([]byte, error) { + type NoMethod RuntimeHost + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // SetIamPolicyRequest: Request message for `SetIamPolicy` method. type SetIamPolicyRequest struct { // Policy: REQUIRED: The complete policy to be applied to the `resource`. The @@ -1582,21 +1633,24 @@ func (s SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // StartWorkstationRequest: Request message for StartWorkstation. type StartWorkstationRequest struct { + // BoostConfig: Optional. If set, the workstation starts using the boost + // configuration with the specified ID. + BoostConfig string `json:"boostConfig,omitempty"` // Etag: Optional. If set, the request will be rejected if the latest version // of the workstation on the server does not have this ETag. Etag string `json:"etag,omitempty"` // ValidateOnly: Optional. If set, validate the request and preview the review, // but do not actually apply it. ValidateOnly bool `json:"validateOnly,omitempty"` - // ForceSendFields is a list of field names (e.g. "Etag") to unconditionally - // include in API requests. By default, fields with empty or default values are - // omitted from API requests. See + // ForceSendFields is a list of field names (e.g. "BoostConfig") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Etag") to include in API requests - // with the JSON null value. By default, fields with empty values are omitted - // from API requests. See + // NullFields is a list of field names (e.g. "BoostConfig") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` } @@ -1756,6 +1810,12 @@ type Workstation struct { // Reconciling: Output only. Indicates whether this workstation is currently // being updated to match its intended state. Reconciling bool `json:"reconciling,omitempty"` + // RuntimeHost: Optional. Output only. Runtime host for the workstation when in + // STATE_RUNNING. + RuntimeHost *RuntimeHost `json:"runtimeHost,omitempty"` + // SourceWorkstation: Optional. The source workstation from which this + // workstation's persistent directories were cloned on creation. + SourceWorkstation string `json:"sourceWorkstation,omitempty"` // StartTime: Output only. Time when this workstation was most recently // successfully started, regardless of the workstation's initial state. StartTime string `json:"startTime,omitempty"` diff --git a/workstations/v1beta/workstations-api.json b/workstations/v1beta/workstations-api.json index f705471818a..3e35137fd63 100644 --- a/workstations/v1beta/workstations-api.json +++ b/workstations/v1beta/workstations-api.json @@ -1127,7 +1127,7 @@ } } }, - "revision": "20241202", + "revision": "20250101", "rootUrl": "https://workstations.googleapis.com/", "schemas": { "Accelerator": { @@ -1217,7 +1217,7 @@ "type": "object" }, "BoostConfig": { - "description": "A boost configuration is a set of resources that a workstation can use to increase its performance. If a boost configuration is specified, when starting a workstation, users can choose to use a VM provisioned under the boost config by passing the boost config id in the start request. If no boost config id is provided in the start request, the system will choose a VM from the pool provisioned under the default config.", + "description": "A boost configuration is a set of resources that a workstation can use to increase its performance. If you specify a boost configuration, upon startup, workstation users can choose to use a VM provisioned under the boost config by passing the boost config ID in the start request. If the workstation user does not provide a boost config ID in the start request, the system will choose a VM from the pool provisioned under the default config.", "id": "BoostConfig", "properties": { "accelerators": { @@ -1237,7 +1237,7 @@ "type": "boolean" }, "id": { - "description": "Required. The id to be used for the boost configuration.", + "description": "Required. The ID to be used for the boost configuration.", "type": "string" }, "machineType": { @@ -1460,6 +1460,28 @@ }, "type": "object" }, + "GceInstanceHost": { + "description": "The Compute Engine instance host.", + "id": "GceInstanceHost", + "properties": { + "id": { + "description": "Optional. Output only. The ID of the Compute Engine instance.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Optional. Output only. The name of the Compute Engine instance.", + "readOnly": true, + "type": "string" + }, + "zone": { + "description": "Optional. Output only. The zone of the Compute Engine instance.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "GcePersistentDisk": { "description": "An EphemeralDirectory is backed by a Compute Engine persistent disk.", "id": "GcePersistentDisk", @@ -1602,6 +1624,10 @@ "allowedUnauthenticatedCorsPreflightRequests": { "description": "Optional. By default, the workstations service makes sure that all requests to the workstation are authenticated. CORS preflight requests do not include cookies or custom headers, and so are considered unauthenticated and blocked by the workstations service. Enabling this option allows these unauthenticated CORS preflight requests through to the workstation, where it becomes the responsibility of the destination server in the workstation to validate the request.", "type": "boolean" + }, + "disableLocalhostReplacement": { + "description": "Optional. By default, the workstations service replaces references to localhost, 127.0.0.1, and 0.0.0.0 with the workstation's hostname in http responses from the workstation so that applications under development run properly on the workstation. This may intefere with some applications, and so this option allows that behavior to be disabled.", + "type": "boolean" } }, "type": "object" @@ -1829,7 +1855,7 @@ "type": "object" }, "PersistentDirectory": { - "description": "A directory to persist across workstation sessions.", + "description": "A directory to persist across workstation sessions. Updates to this field will not update existing workstations and will only take effect on new workstations.", "id": "PersistentDirectory", "properties": { "gcePd": { @@ -1935,6 +1961,17 @@ }, "type": "object" }, + "RuntimeHost": { + "description": "Runtime host for the workstation.", + "id": "RuntimeHost", + "properties": { + "gceInstanceHost": { + "$ref": "GceInstanceHost", + "description": "Specifies a Compute Engine instance as the host." + } + }, + "type": "object" + }, "SetIamPolicyRequest": { "description": "Request message for `SetIamPolicy` method.", "id": "SetIamPolicyRequest", @@ -2112,6 +2149,11 @@ "readOnly": true, "type": "boolean" }, + "runtimeHost": { + "$ref": "RuntimeHost", + "description": "Optional. Output only. Runtime host for the workstation when in STATE_RUNNING.", + "readOnly": true + }, "satisfiesPzi": { "description": "Output only. Reserved for future use.", "readOnly": true, diff --git a/workstations/v1beta/workstations-gen.go b/workstations/v1beta/workstations-gen.go index 2214dddb2e2..4683a0d93c8 100644 --- a/workstations/v1beta/workstations-gen.go +++ b/workstations/v1beta/workstations-gen.go @@ -427,11 +427,12 @@ func (s Binding) MarshalJSON() ([]byte, error) { } // BoostConfig: A boost configuration is a set of resources that a workstation -// can use to increase its performance. If a boost configuration is specified, -// when starting a workstation, users can choose to use a VM provisioned under -// the boost config by passing the boost config id in the start request. If no -// boost config id is provided in the start request, the system will choose a -// VM from the pool provisioned under the default config. +// can use to increase its performance. If you specify a boost configuration, +// upon startup, workstation users can choose to use a VM provisioned under the +// boost config by passing the boost config ID in the start request. If the +// workstation user does not provide a boost config ID in the start request, +// the system will choose a VM from the pool provisioned under the default +// config. type BoostConfig struct { // Accelerators: Optional. A list of the type and count of accelerator cards // attached to the boost instance. Defaults to `none`. @@ -459,7 +460,7 @@ type BoostConfig struct { // nested virtualization can only be enabled on boost configurations that // specify a machine_type in the N1 or N2 machine series. EnableNestedVirtualization bool `json:"enableNestedVirtualization,omitempty"` - // Id: Required. The id to be used for the boost configuration. + // Id: Required. The ID to be used for the boost configuration. Id string `json:"id,omitempty"` // MachineType: Optional. The type of machine that boosted VM instances will // use—for example, `e2-standard-4`. For more information about machine types @@ -804,6 +805,32 @@ func (s GceInstance) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GceInstanceHost: The Compute Engine instance host. +type GceInstanceHost struct { + // Id: Optional. Output only. The ID of the Compute Engine instance. + Id string `json:"id,omitempty"` + // Name: Optional. Output only. The name of the Compute Engine instance. + Name string `json:"name,omitempty"` + // Zone: Optional. Output only. The zone of the Compute Engine instance. + Zone string `json:"zone,omitempty"` + // ForceSendFields is a list of field names (e.g. "Id") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Id") to include in API requests + // with the JSON null value. By default, fields with empty values are omitted + // from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s GceInstanceHost) MarshalJSON() ([]byte, error) { + type NoMethod GceInstanceHost + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GcePersistentDisk: An EphemeralDirectory is backed by a Compute Engine // persistent disk. type GcePersistentDisk struct { @@ -1027,6 +1054,13 @@ type HttpOptions struct { // responsibility of the destination server in the workstation to validate the // request. AllowedUnauthenticatedCorsPreflightRequests bool `json:"allowedUnauthenticatedCorsPreflightRequests,omitempty"` + // DisableLocalhostReplacement: Optional. By default, the workstations service + // replaces references to localhost, 127.0.0.1, and 0.0.0.0 with the + // workstation's hostname in http responses from the workstation so that + // applications under development run properly on the workstation. This may + // intefere with some applications, and so this option allows that behavior to + // be disabled. + DisableLocalhostReplacement bool `json:"disableLocalhostReplacement,omitempty"` // ForceSendFields is a list of field names (e.g. // "AllowedUnauthenticatedCorsPreflightRequests") to unconditionally include in // API requests. By default, fields with empty or default values are omitted @@ -1311,6 +1345,8 @@ func (s OperationMetadata) MarshalJSON() ([]byte, error) { } // PersistentDirectory: A directory to persist across workstation sessions. +// Updates to this field will not update existing workstations and will only +// take effect on new workstations. type PersistentDirectory struct { // GcePd: A PersistentDirectory backed by a Compute Engine persistent disk. GcePd *GceRegionalPersistentDisk `json:"gcePd,omitempty"` @@ -1516,6 +1552,28 @@ func (s ReadinessCheck) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// RuntimeHost: Runtime host for the workstation. +type RuntimeHost struct { + // GceInstanceHost: Specifies a Compute Engine instance as the host. + GceInstanceHost *GceInstanceHost `json:"gceInstanceHost,omitempty"` + // ForceSendFields is a list of field names (e.g. "GceInstanceHost") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "GceInstanceHost") to include in + // API requests with the JSON null value. By default, fields with empty values + // are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s RuntimeHost) MarshalJSON() ([]byte, error) { + type NoMethod RuntimeHost + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // SetIamPolicyRequest: Request message for `SetIamPolicy` method. type SetIamPolicyRequest struct { // Policy: REQUIRED: The complete policy to be applied to the `resource`. The @@ -1727,6 +1785,9 @@ type Workstation struct { // Reconciling: Output only. Indicates whether this workstation is currently // being updated to match its intended state. Reconciling bool `json:"reconciling,omitempty"` + // RuntimeHost: Optional. Output only. Runtime host for the workstation when in + // STATE_RUNNING. + RuntimeHost *RuntimeHost `json:"runtimeHost,omitempty"` // SatisfiesPzi: Output only. Reserved for future use. SatisfiesPzi bool `json:"satisfiesPzi,omitempty"` // SatisfiesPzs: Output only. Reserved for future use. diff --git a/youtube/v3/youtube-api.json b/youtube/v3/youtube-api.json index 5e898ab78c6..e5d1d31c539 100644 --- a/youtube/v3/youtube-api.json +++ b/youtube/v3/youtube-api.json @@ -4072,7 +4072,7 @@ } } }, - "revision": "20241203", + "revision": "20250101", "rootUrl": "https://youtube.googleapis.com/", "schemas": { "AbuseReport": { @@ -12219,7 +12219,7 @@ "type": "object" }, "VideoSuggestionsTagSuggestion": { - "description": "A single tag suggestion with it's relevance information.", + "description": "A single tag suggestion with its relevance information.", "id": "VideoSuggestionsTagSuggestion", "properties": { "categoryRestricts": { diff --git a/youtube/v3/youtube-gen.go b/youtube/v3/youtube-gen.go index 62516fd25b4..cd04643e324 100644 --- a/youtube/v3/youtube-gen.go +++ b/youtube/v3/youtube-gen.go @@ -8531,7 +8531,7 @@ func (s VideoSuggestions) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// VideoSuggestionsTagSuggestion: A single tag suggestion with it's relevance +// VideoSuggestionsTagSuggestion: A single tag suggestion with its relevance // information. type VideoSuggestionsTagSuggestion struct { // CategoryRestricts: A set of video categories for which the tag is relevant.