From 1a64053bacb7cbba2b991a5c6197eccc447279ab Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Tue, 19 Apr 2022 07:14:58 +0000 Subject: [PATCH] feat(all): auto-regenerate discovery clients --- analyticsdata/v1beta/analyticsdata-api.json | 6 +- analyticsdata/v1beta/analyticsdata-gen.go | 12 +- api-list.json | 15 + bigtableadmin/v2/bigtableadmin-api.json | 120 +- bigtableadmin/v2/bigtableadmin-gen.go | 369 +++- clouddeploy/v1/clouddeploy-api.json | 153 +- clouddeploy/v1/clouddeploy-gen.go | 234 ++- file/v1/file-api.json | 30 +- file/v1/file-gen.go | 73 +- gameservices/v1/gameservices-api.json | 10 +- gameservices/v1/gameservices-gen.go | 14 +- gameservices/v1beta/gameservices-api.json | 10 +- gameservices/v1beta/gameservices-gen.go | 14 +- gkebackup/v1/gkebackup-api.json | 244 +-- gkebackup/v1/gkebackup-gen.go | 569 +++--- iam/v2beta/iam-api.json | 623 ++++++ iam/v2beta/iam-gen.go | 1757 +++++++++++++++++ .../v1/policytroubleshooter-api.json | 36 +- .../v1/policytroubleshooter-gen.go | 47 + privateca/v1/privateca-api.json | 10 +- privateca/v1/privateca-gen.go | 14 +- .../v1alpha1/prod_tt_sasportal-api.json | 396 +--- .../v1alpha1/prod_tt_sasportal-gen.go | 396 +--- .../v1/servicemanagement-api.json | 4 +- servicemanagement/v1/servicemanagement-gen.go | 8 +- sheets/v4/sheets-api.json | 6 +- sheets/v4/sheets-gen.go | 46 +- tpu/v1/tpu-api.json | 6 +- tpu/v1/tpu-gen.go | 9 +- 29 files changed, 4048 insertions(+), 1183 deletions(-) create mode 100644 iam/v2beta/iam-api.json create mode 100644 iam/v2beta/iam-gen.go diff --git a/analyticsdata/v1beta/analyticsdata-api.json b/analyticsdata/v1beta/analyticsdata-api.json index f1a9e39b5d5..edad5d57564 100644 --- a/analyticsdata/v1beta/analyticsdata-api.json +++ b/analyticsdata/v1beta/analyticsdata-api.json @@ -253,7 +253,7 @@ ] }, "runRealtimeReport": { - "description": "The Google Analytics Realtime API returns a customized report of realtime event data for your property. These reports show events and usage from the last 30 minutes.", + "description": "The Google Analytics Realtime API returns a customized report of realtime event data for your property. These reports show events and usage from the last 30 minutes. For a guide to constructing realtime requests \u0026 understanding responses, see [Creating a Realtime Report](https://developers.google.com/analytics/devguides/reporting/data/v1/realtime-basics).", "flatPath": "v1beta/properties/{propertiesId}:runRealtimeReport", "httpMethod": "POST", "id": "analyticsdata.properties.runRealtimeReport", @@ -282,7 +282,7 @@ ] }, "runReport": { - "description": "Returns a customized report of your Google Analytics event data. Reports contain statistics derived from data collected by the Google Analytics tracking code. The data returned from the API is as a table with columns for the requested dimensions and metrics. Metrics are individual measurements of user activity on your property, such as active users or event count. Dimensions break down metrics across some common criteria, such as country or event name.", + "description": "Returns a customized report of your Google Analytics event data. Reports contain statistics derived from data collected by the Google Analytics tracking code. The data returned from the API is as a table with columns for the requested dimensions and metrics. Metrics are individual measurements of user activity on your property, such as active users or event count. Dimensions break down metrics across some common criteria, such as country or event name. For a guide to constructing requests \u0026 understanding responses, see [Creating a Report](https://developers.google.com/analytics/devguides/reporting/data/v1/basics).", "flatPath": "v1beta/properties/{propertiesId}:runReport", "httpMethod": "POST", "id": "analyticsdata.properties.runReport", @@ -313,7 +313,7 @@ } } }, - "revision": "20220322", + "revision": "20220416", "rootUrl": "https://analyticsdata.googleapis.com/", "schemas": { "ActiveMetricRestriction": { diff --git a/analyticsdata/v1beta/analyticsdata-gen.go b/analyticsdata/v1beta/analyticsdata-gen.go index bbcb59db653..f847a623cda 100644 --- a/analyticsdata/v1beta/analyticsdata-gen.go +++ b/analyticsdata/v1beta/analyticsdata-gen.go @@ -3485,7 +3485,10 @@ type PropertiesRunRealtimeReportCall struct { // RunRealtimeReport: The Google Analytics Realtime API returns a // customized report of realtime event data for your property. These -// reports show events and usage from the last 30 minutes. +// reports show events and usage from the last 30 minutes. For a guide +// to constructing realtime requests & understanding responses, see +// Creating a Realtime Report +// (https://developers.google.com/analytics/devguides/reporting/data/v1/realtime-basics). // // - property: A Google Analytics GA4 property identifier whose events // are tracked. Specified in the URL path and not the body. To learn @@ -3590,7 +3593,7 @@ func (c *PropertiesRunRealtimeReportCall) Do(opts ...googleapi.CallOption) (*Run } return ret, nil // { - // "description": "The Google Analytics Realtime API returns a customized report of realtime event data for your property. These reports show events and usage from the last 30 minutes.", + // "description": "The Google Analytics Realtime API returns a customized report of realtime event data for your property. These reports show events and usage from the last 30 minutes. For a guide to constructing realtime requests \u0026 understanding responses, see [Creating a Realtime Report](https://developers.google.com/analytics/devguides/reporting/data/v1/realtime-basics).", // "flatPath": "v1beta/properties/{propertiesId}:runRealtimeReport", // "httpMethod": "POST", // "id": "analyticsdata.properties.runRealtimeReport", @@ -3639,6 +3642,9 @@ type PropertiesRunReportCall struct { // Metrics are individual measurements of user activity on your // property, such as active users or event count. Dimensions break down // metrics across some common criteria, such as country or event name. +// For a guide to constructing requests & understanding responses, see +// Creating a Report +// (https://developers.google.com/analytics/devguides/reporting/data/v1/basics). // // - property: A Google Analytics GA4 property identifier whose events // are tracked. Specified in the URL path and not the body. To learn @@ -3745,7 +3751,7 @@ func (c *PropertiesRunReportCall) Do(opts ...googleapi.CallOption) (*RunReportRe } return ret, nil // { - // "description": "Returns a customized report of your Google Analytics event data. Reports contain statistics derived from data collected by the Google Analytics tracking code. The data returned from the API is as a table with columns for the requested dimensions and metrics. Metrics are individual measurements of user activity on your property, such as active users or event count. Dimensions break down metrics across some common criteria, such as country or event name.", + // "description": "Returns a customized report of your Google Analytics event data. Reports contain statistics derived from data collected by the Google Analytics tracking code. The data returned from the API is as a table with columns for the requested dimensions and metrics. Metrics are individual measurements of user activity on your property, such as active users or event count. Dimensions break down metrics across some common criteria, such as country or event name. For a guide to constructing requests \u0026 understanding responses, see [Creating a Report](https://developers.google.com/analytics/devguides/reporting/data/v1/basics).", // "flatPath": "v1beta/properties/{propertiesId}:runReport", // "httpMethod": "POST", // "id": "analyticsdata.properties.runReport", diff --git a/api-list.json b/api-list.json index 8f163d55730..0446f6be8f5 100644 --- a/api-list.json +++ b/api-list.json @@ -3036,6 +3036,21 @@ "documentationLink": "https://developers.google.com/actions/smarthome/create-app#request-sync", "preferred": true }, + { + "kind": "discovery#directoryItem", + "id": "iam:v2beta", + "name": "iam", + "version": "v2beta", + "title": "Identity and Access Management (IAM) API", + "description": "Manages identity and access control for Google Cloud Platform resources, including the creation of service accounts, which you can use to authenticate to Google and make API calls.", + "discoveryRestUrl": "https://iam.googleapis.com/$discovery/rest?version=v2beta", + "icons": { + "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png", + "x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png" + }, + "documentationLink": "https://cloud.google.com/iam/", + "preferred": false + }, { "kind": "discovery#directoryItem", "id": "iam:v1", diff --git a/bigtableadmin/v2/bigtableadmin-api.json b/bigtableadmin/v2/bigtableadmin-api.json index cb78e19e017..379ac8555ce 100644 --- a/bigtableadmin/v2/bigtableadmin-api.json +++ b/bigtableadmin/v2/bigtableadmin-api.json @@ -1279,6 +1279,63 @@ ] } } + }, + "hotTablets": { + "methods": { + "list": { + "description": "Lists hot tablets in a cluster, within the time range provided. Hot tablets are ordered based on CPU usage.", + "flatPath": "v2/projects/{projectsId}/instances/{instancesId}/clusters/{clustersId}/hotTablets", + "httpMethod": "GET", + "id": "bigtableadmin.projects.instances.clusters.hotTablets.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "endTime": { + "description": "The end time to list hot tablets.", + "format": "google-datetime", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Maximum number of results per page. A page_size that is empty or zero lets the server choose the number of items to return. A page_size which is strictly positive will return at most that many items. A negative page_size will cause an error. Following the first request, subsequent paginated calls do not need a page_size field. If a page_size is set in subsequent calls, it must match the page_size given in the first request.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The value of `next_page_token` returned by a previous call.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The cluster name to list hot tablets. Value is in the following form: `projects/{project}/instances/{instance}/clusters/{cluster}`.", + "location": "path", + "pattern": "^projects/[^/]+/instances/[^/]+/clusters/[^/]+$", + "required": true, + "type": "string" + }, + "startTime": { + "description": "The start time to list hot tablets. The hot tablets in the response will have start times between the requested start time and end time. Start time defaults to Now if it is unset, and end time defaults to Now - 24 hours if it is unset. The start time should be less than the end time, and the maximum allowed time range between start time and end time is 48 hours. Start time and end time should have values between Now and Now - 14 days.", + "format": "google-datetime", + "location": "query", + "type": "string" + } + }, + "path": "v2/{+parent}/hotTablets", + "response": { + "$ref": "ListHotTabletsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/bigtable.admin", + "https://www.googleapis.com/auth/bigtable.admin.cluster", + "https://www.googleapis.com/auth/bigtable.admin.instance", + "https://www.googleapis.com/auth/cloud-bigtable.admin", + "https://www.googleapis.com/auth/cloud-bigtable.admin.cluster", + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } } } }, @@ -1803,7 +1860,7 @@ } } }, - "revision": "20220329", + "revision": "20220412", "rootUrl": "https://bigtableadmin.googleapis.com/", "schemas": { "AppProfile": { @@ -2276,7 +2333,7 @@ "additionalProperties": { "$ref": "Cluster" }, - "description": "Required. The clusters to be created within the instance, mapped by desired cluster ID, e.g., just `mycluster` rather than `projects/myproject/instances/myinstance/clusters/mycluster`. Fields marked `OutputOnly` must be left blank. Currently, at most four clusters can be specified.", + "description": "Required. The clusters to be created within the instance, mapped by desired cluster ID, e.g., just `mycluster` rather than `projects/myproject/instances/myinstance/clusters/mycluster`. Fields marked `OutputOnly` must be left blank.", "type": "object" }, "instance": { @@ -2469,6 +2526,47 @@ }, "type": "object" }, + "HotTablet": { + "description": "A tablet is a defined by a start and end key and is explained in https://cloud.google.com/bigtable/docs/overview#architecture and https://cloud.google.com/bigtable/docs/performance#optimization. A Hot tablet is a tablet that exhibits high average cpu usage during the time interval from start time to end time.", + "id": "HotTablet", + "properties": { + "endKey": { + "description": "Tablet End Key (inclusive).", + "type": "string" + }, + "endTime": { + "description": "Output only. The end time of the hot tablet.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "The unique name of the hot tablet. Values are of the form `projects/{project}/instances/{instance}/clusters/{cluster}/hotTablets/[a-zA-Z0-9_-]*`.", + "type": "string" + }, + "nodeCpuUsagePercent": { + "description": "Output only. The average CPU usage spent by a node on this tablet over the start_time to end_time time range. The percentage is the amount of CPU used by the node to serve the tablet, from 0% (tablet was not interacted with) to 100% (the node spent all cycles serving the hot tablet).", + "format": "float", + "readOnly": true, + "type": "number" + }, + "startKey": { + "description": "Tablet Start Key (inclusive).", + "type": "string" + }, + "startTime": { + "description": "Output only. The start time of the hot tablet.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "tableName": { + "description": "Name of the table that contains the tablet. Values are of the form `projects/{project}/instances/{instance}/tables/_a-zA-Z0-9*`.", + "type": "string" + } + }, + "type": "object" + }, "Instance": { "description": "A collection of Bigtable Tables and the resources that serve them. All tables in an instance are served from all Clusters in the instance.", "id": "Instance", @@ -2608,6 +2706,24 @@ }, "type": "object" }, + "ListHotTabletsResponse": { + "description": "Response message for BigtableInstanceAdmin.ListHotTablets.", + "id": "ListHotTabletsResponse", + "properties": { + "hotTablets": { + "description": "List of hot tablets in the tables of the requested cluster that fall within the requested time range. Hot tablets are ordered by node cpu usage percent. If there are multiple hot tablets that correspond to the same tablet within a 15-minute interval, only the hot tablet with the highest node cpu usage will be included in the response.", + "items": { + "$ref": "HotTablet" + }, + "type": "array" + }, + "nextPageToken": { + "description": "Set if not all hot tablets could be returned in a single response. Pass this value to `page_token` in another request to get the next page of results.", + "type": "string" + } + }, + "type": "object" + }, "ListInstancesResponse": { "description": "Response message for BigtableInstanceAdmin.ListInstances.", "id": "ListInstancesResponse", diff --git a/bigtableadmin/v2/bigtableadmin-gen.go b/bigtableadmin/v2/bigtableadmin-gen.go index 01fa9fe2f37..49336471e2e 100644 --- a/bigtableadmin/v2/bigtableadmin-gen.go +++ b/bigtableadmin/v2/bigtableadmin-gen.go @@ -255,6 +255,7 @@ type ProjectsInstancesAppProfilesService struct { func NewProjectsInstancesClustersService(s *Service) *ProjectsInstancesClustersService { rs := &ProjectsInstancesClustersService{s: s} rs.Backups = NewProjectsInstancesClustersBackupsService(s) + rs.HotTablets = NewProjectsInstancesClustersHotTabletsService(s) return rs } @@ -262,6 +263,8 @@ type ProjectsInstancesClustersService struct { s *Service Backups *ProjectsInstancesClustersBackupsService + + HotTablets *ProjectsInstancesClustersHotTabletsService } func NewProjectsInstancesClustersBackupsService(s *Service) *ProjectsInstancesClustersBackupsService { @@ -273,6 +276,15 @@ type ProjectsInstancesClustersBackupsService struct { s *Service } +func NewProjectsInstancesClustersHotTabletsService(s *Service) *ProjectsInstancesClustersHotTabletsService { + rs := &ProjectsInstancesClustersHotTabletsService{s: s} + return rs +} + +type ProjectsInstancesClustersHotTabletsService struct { + s *Service +} + func NewProjectsInstancesTablesService(s *Service) *ProjectsInstancesTablesService { rs := &ProjectsInstancesTablesService{s: s} return rs @@ -1168,8 +1180,7 @@ type CreateInstanceRequest struct { // Clusters: Required. The clusters to be created within the instance, // mapped by desired cluster ID, e.g., just `mycluster` rather than // `projects/myproject/instances/myinstance/clusters/mycluster`. Fields - // marked `OutputOnly` must be left blank. Currently, at most four - // clusters can be specified. + // marked `OutputOnly` must be left blank. Clusters map[string]Cluster `json:"clusters,omitempty"` // Instance: Required. The instance to create. Fields marked @@ -1608,6 +1619,79 @@ func (s *GetPolicyOptions) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// HotTablet: A tablet is a defined by a start and end key and is +// explained in +// https://cloud.google.com/bigtable/docs/overview#architecture and +// https://cloud.google.com/bigtable/docs/performance#optimization. A +// Hot tablet is a tablet that exhibits high average cpu usage during +// the time interval from start time to end time. +type HotTablet struct { + // EndKey: Tablet End Key (inclusive). + EndKey string `json:"endKey,omitempty"` + + // EndTime: Output only. The end time of the hot tablet. + EndTime string `json:"endTime,omitempty"` + + // Name: The unique name of the hot tablet. Values are of the form + // `projects/{project}/instances/{instance}/clusters/{cluster}/hotTablets + // /[a-zA-Z0-9_-]*`. + Name string `json:"name,omitempty"` + + // NodeCpuUsagePercent: Output only. The average CPU usage spent by a + // node on this tablet over the start_time to end_time time range. The + // percentage is the amount of CPU used by the node to serve the tablet, + // from 0% (tablet was not interacted with) to 100% (the node spent all + // cycles serving the hot tablet). + NodeCpuUsagePercent float64 `json:"nodeCpuUsagePercent,omitempty"` + + // StartKey: Tablet Start Key (inclusive). + StartKey string `json:"startKey,omitempty"` + + // StartTime: Output only. The start time of the hot tablet. + StartTime string `json:"startTime,omitempty"` + + // TableName: Name of the table that contains the tablet. Values are of + // the form + // `projects/{project}/instances/{instance}/tables/_a-zA-Z0-9*`. + TableName string `json:"tableName,omitempty"` + + // ForceSendFields is a list of field names (e.g. "EndKey") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "EndKey") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *HotTablet) MarshalJSON() ([]byte, error) { + type NoMethod HotTablet + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +func (s *HotTablet) UnmarshalJSON(data []byte) error { + type NoMethod HotTablet + var s1 struct { + NodeCpuUsagePercent gensupport.JSONFloat64 `json:"nodeCpuUsagePercent"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.NodeCpuUsagePercent = float64(s1.NodeCpuUsagePercent) + return nil +} + // Instance: A collection of Bigtable Tables and the resources that // serve them. All tables in an instance are served from all Clusters in // the instance. @@ -1842,6 +1926,49 @@ func (s *ListClustersResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ListHotTabletsResponse: Response message for +// BigtableInstanceAdmin.ListHotTablets. +type ListHotTabletsResponse struct { + // HotTablets: List of hot tablets in the tables of the requested + // cluster that fall within the requested time range. Hot tablets are + // ordered by node cpu usage percent. If there are multiple hot tablets + // that correspond to the same tablet within a 15-minute interval, only + // the hot tablet with the highest node cpu usage will be included in + // the response. + HotTablets []*HotTablet `json:"hotTablets,omitempty"` + + // NextPageToken: Set if not all hot tablets could be returned in a + // single response. Pass this value to `page_token` in another request + // to get the next page of results. + NextPageToken string `json:"nextPageToken,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "HotTablets") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "HotTablets") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ListHotTabletsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListHotTabletsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ListInstancesResponse: Response message for // BigtableInstanceAdmin.ListInstances. type ListInstancesResponse struct { @@ -8276,6 +8403,244 @@ func (c *ProjectsInstancesClustersBackupsTestIamPermissionsCall) Do(opts ...goog } +// method id "bigtableadmin.projects.instances.clusters.hotTablets.list": + +type ProjectsInstancesClustersHotTabletsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists hot tablets in a cluster, within the time range provided. +// Hot tablets are ordered based on CPU usage. +// +// - parent: The cluster name to list hot tablets. Value is in the +// following form: +// `projects/{project}/instances/{instance}/clusters/{cluster}`. +func (r *ProjectsInstancesClustersHotTabletsService) List(parent string) *ProjectsInstancesClustersHotTabletsListCall { + c := &ProjectsInstancesClustersHotTabletsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// EndTime sets the optional parameter "endTime": The end time to list +// hot tablets. +func (c *ProjectsInstancesClustersHotTabletsListCall) EndTime(endTime string) *ProjectsInstancesClustersHotTabletsListCall { + c.urlParams_.Set("endTime", endTime) + return c +} + +// PageSize sets the optional parameter "pageSize": Maximum number of +// results per page. A page_size that is empty or zero lets the server +// choose the number of items to return. A page_size which is strictly +// positive will return at most that many items. A negative page_size +// will cause an error. Following the first request, subsequent +// paginated calls do not need a page_size field. If a page_size is set +// in subsequent calls, it must match the page_size given in the first +// request. +func (c *ProjectsInstancesClustersHotTabletsListCall) PageSize(pageSize int64) *ProjectsInstancesClustersHotTabletsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The value of +// `next_page_token` returned by a previous call. +func (c *ProjectsInstancesClustersHotTabletsListCall) PageToken(pageToken string) *ProjectsInstancesClustersHotTabletsListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// StartTime sets the optional parameter "startTime": The start time to +// list hot tablets. The hot tablets in the response will have start +// times between the requested start time and end time. Start time +// defaults to Now if it is unset, and end time defaults to Now - 24 +// hours if it is unset. The start time should be less than the end +// time, and the maximum allowed time range between start time and end +// time is 48 hours. Start time and end time should have values between +// Now and Now - 14 days. +func (c *ProjectsInstancesClustersHotTabletsListCall) StartTime(startTime string) *ProjectsInstancesClustersHotTabletsListCall { + c.urlParams_.Set("startTime", startTime) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsInstancesClustersHotTabletsListCall) Fields(s ...googleapi.Field) *ProjectsInstancesClustersHotTabletsListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *ProjectsInstancesClustersHotTabletsListCall) IfNoneMatch(entityTag string) *ProjectsInstancesClustersHotTabletsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *ProjectsInstancesClustersHotTabletsListCall) Context(ctx context.Context) *ProjectsInstancesClustersHotTabletsListCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *ProjectsInstancesClustersHotTabletsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsInstancesClustersHotTabletsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+parent}/hotTablets") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "bigtableadmin.projects.instances.clusters.hotTablets.list" call. +// Exactly one of *ListHotTabletsResponse or error will be non-nil. Any +// non-2xx status code is an error. Response headers are in either +// *ListHotTabletsResponse.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 *ProjectsInstancesClustersHotTabletsListCall) Do(opts ...googleapi.CallOption) (*ListHotTabletsResponse, 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, &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, err + } + ret := &ListHotTabletsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Lists hot tablets in a cluster, within the time range provided. Hot tablets are ordered based on CPU usage.", + // "flatPath": "v2/projects/{projectsId}/instances/{instancesId}/clusters/{clustersId}/hotTablets", + // "httpMethod": "GET", + // "id": "bigtableadmin.projects.instances.clusters.hotTablets.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "endTime": { + // "description": "The end time to list hot tablets.", + // "format": "google-datetime", + // "location": "query", + // "type": "string" + // }, + // "pageSize": { + // "description": "Maximum number of results per page. A page_size that is empty or zero lets the server choose the number of items to return. A page_size which is strictly positive will return at most that many items. A negative page_size will cause an error. Following the first request, subsequent paginated calls do not need a page_size field. If a page_size is set in subsequent calls, it must match the page_size given in the first request.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "The value of `next_page_token` returned by a previous call.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The cluster name to list hot tablets. Value is in the following form: `projects/{project}/instances/{instance}/clusters/{cluster}`.", + // "location": "path", + // "pattern": "^projects/[^/]+/instances/[^/]+/clusters/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "startTime": { + // "description": "The start time to list hot tablets. The hot tablets in the response will have start times between the requested start time and end time. Start time defaults to Now if it is unset, and end time defaults to Now - 24 hours if it is unset. The start time should be less than the end time, and the maximum allowed time range between start time and end time is 48 hours. Start time and end time should have values between Now and Now - 14 days.", + // "format": "google-datetime", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v2/{+parent}/hotTablets", + // "response": { + // "$ref": "ListHotTabletsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/bigtable.admin", + // "https://www.googleapis.com/auth/bigtable.admin.cluster", + // "https://www.googleapis.com/auth/bigtable.admin.instance", + // "https://www.googleapis.com/auth/cloud-bigtable.admin", + // "https://www.googleapis.com/auth/cloud-bigtable.admin.cluster", + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// 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 *ProjectsInstancesClustersHotTabletsListCall) Pages(ctx context.Context, f func(*ListHotTabletsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point + 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) + } +} + // method id "bigtableadmin.projects.instances.tables.checkConsistency": type ProjectsInstancesTablesCheckConsistencyCall struct { diff --git a/clouddeploy/v1/clouddeploy-api.json b/clouddeploy/v1/clouddeploy-api.json index a7351c29744..3f961f8e6fa 100644 --- a/clouddeploy/v1/clouddeploy-api.json +++ b/clouddeploy/v1/clouddeploy-api.json @@ -169,7 +169,7 @@ ], "parameters": { "filter": { - "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like \"displayName=tokyo\", and is documented in more detail in [AIP-160](https://google.aip.dev/160).", + "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).", "location": "query", "type": "string" }, @@ -1201,7 +1201,7 @@ } } }, - "revision": "20220330", + "revision": "20220413", "rootUrl": "https://clouddeploy.googleapis.com/", "schemas": { "AnthosCluster": { @@ -1289,7 +1289,7 @@ "description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)." }, "members": { - "description": "Specifies the principals requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ", + "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ", "items": { "type": "string" }, @@ -1443,6 +1443,35 @@ }, "type": "object" }, + "DeliveryPipelineNotificationEvent": { + "description": "Payload proto for \"clouddeploy.googleapis.com/deliverypipeline_notification\" Platform Log event that describes the failure to send delivery pipeline status change Pub/Sub notification.", + "id": "DeliveryPipelineNotificationEvent", + "properties": { + "deliveryPipeline": { + "description": "The name of the `Delivery Pipeline`.", + "type": "string" + }, + "message": { + "description": "Debug message for when a notification fails to send.", + "type": "string" + }, + "type": { + "description": "Type of this notification, e.g. for a Pub/Sub failure.", + "enum": [ + "TYPE_UNSPECIFIED", + "TYPE_PUBSUB_NOTIFICATION_FAILURE", + "TYPE_RENDER_STATUES_CHANGE" + ], + "enumDescriptions": [ + "Type is unspecified.", + "A Pub/Sub notification failed to be sent.", + "Release render status changed notification." + ], + "type": "string" + } + }, + "type": "object" + }, "Empty": { "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", "id": "Empty", @@ -1982,6 +2011,50 @@ }, "type": "object" }, + "ReleaseNotificationEvent": { + "description": "Payload proto for \"clouddeploy.googleapis.com/release_notification\" Platform Log event that describes the failure to send release status change Pub/Sub notification.", + "id": "ReleaseNotificationEvent", + "properties": { + "message": { + "description": "Debug message for when a notification fails to send.", + "type": "string" + }, + "release": { + "description": "The name of the `Release`.", + "type": "string" + }, + "type": { + "description": "Type of this notification, e.g. for a Pub/Sub failure.", + "enum": [ + "TYPE_UNSPECIFIED", + "TYPE_PUBSUB_NOTIFICATION_FAILURE", + "TYPE_RENDER_STATUES_CHANGE" + ], + "enumDescriptions": [ + "Type is unspecified.", + "A Pub/Sub notification failed to be sent.", + "Release render status changed notification." + ], + "type": "string" + } + }, + "type": "object" + }, + "ReleaseRenderEvent": { + "description": "Payload proto for \"clouddeploy.googleapis.com/release_render\" Platform Log event that describes the render status change.", + "id": "ReleaseRenderEvent", + "properties": { + "message": { + "description": "Debug message for when a render transition occurs. Provides further details as rendering progresses through render states.", + "type": "string" + }, + "release": { + "description": "The name of the `Release`.", + "type": "string" + } + }, + "type": "object" + }, "Rollout": { "description": "A `Rollout` resource in the Google Cloud Deploy API. A `Rollout` contains information around a specific deployment to a `Target`.", "id": "Rollout", @@ -2127,6 +2200,47 @@ }, "type": "object" }, + "RolloutNotificationEvent": { + "description": "Payload proto for \"clouddeploy.googleapis.com/rollout_notification\" Platform Log event that describes the failure to send rollout status change Pub/Sub notification.", + "id": "RolloutNotificationEvent", + "properties": { + "message": { + "description": "Debug message for when a notification fails to send.", + "type": "string" + }, + "pipelineUid": { + "description": "Unique identifier of the `DeliveryPipeline`.", + "type": "string" + }, + "releaseUid": { + "description": "Unique identifier of the `Release`.", + "type": "string" + }, + "rollout": { + "description": "The name of the `Rollout`.", + "type": "string" + }, + "targetId": { + "description": "ID of the `Target` that the rollout is deployed to.", + "type": "string" + }, + "type": { + "description": "Type of this notification, e.g. for a Pub/Sub failure.", + "enum": [ + "TYPE_UNSPECIFIED", + "TYPE_PUBSUB_NOTIFICATION_FAILURE", + "TYPE_RENDER_STATUES_CHANGE" + ], + "enumDescriptions": [ + "Type is unspecified.", + "A Pub/Sub notification failed to be sent.", + "Release render status changed notification." + ], + "type": "string" + } + }, + "type": "object" + }, "SerialPipeline": { "description": "SerialPipeline defines a sequential set of stages for a `DeliveryPipeline`.", "id": "SerialPipeline", @@ -2147,7 +2261,7 @@ "properties": { "policy": { "$ref": "Policy", - "description": "REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Cloud Platform services (such as Projects) might reject them." + "description": "REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Google Cloud services (such as Projects) might reject them." }, "updateMask": { "description": "OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only the fields in the mask will be modified. If no mask is provided, the following default mask is used: `paths: \"bindings, etag\"`", @@ -2313,6 +2427,35 @@ }, "type": "object" }, + "TargetNotificationEvent": { + "description": "Payload proto for \"clouddeploy.googleapis.com/target_notification\" Platform Log event that describes the failure to send target status change Pub/Sub notification.", + "id": "TargetNotificationEvent", + "properties": { + "message": { + "description": "Debug message for when a notification fails to send.", + "type": "string" + }, + "target": { + "description": "The name of the `Target`.", + "type": "string" + }, + "type": { + "description": "Type of this notification, e.g. for a Pub/Sub failure.", + "enum": [ + "TYPE_UNSPECIFIED", + "TYPE_PUBSUB_NOTIFICATION_FAILURE", + "TYPE_RENDER_STATUES_CHANGE" + ], + "enumDescriptions": [ + "Type is unspecified.", + "A Pub/Sub notification failed to be sent.", + "Release render status changed notification." + ], + "type": "string" + } + }, + "type": "object" + }, "TargetRender": { "description": "Details of rendering for a single target.", "id": "TargetRender", @@ -2385,7 +2528,7 @@ "id": "TestIamPermissionsRequest", "properties": { "permissions": { - "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as '*' or 'storage.*') are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", + "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as `*` or `storage.*`) are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", "items": { "type": "string" }, diff --git a/clouddeploy/v1/clouddeploy-gen.go b/clouddeploy/v1/clouddeploy-gen.go index a2c98aed904..bec6e504c09 100644 --- a/clouddeploy/v1/clouddeploy-gen.go +++ b/clouddeploy/v1/clouddeploy-gen.go @@ -393,8 +393,8 @@ type Binding struct { // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` - // Members: Specifies the principals requesting access for a Cloud - // Platform resource. `members` can have the following values: * + // Members: Specifies the principals requesting access for a Google + // Cloud resource. `members` can have the following values: * // `allUsers`: A special identifier that represents anyone who is on the // internet; with or without a Google account. * // `allAuthenticatedUsers`: A special identifier that represents anyone @@ -698,6 +698,51 @@ func (s *DeliveryPipeline) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// DeliveryPipelineNotificationEvent: Payload proto for +// "clouddeploy.googleapis.com/deliverypipeline_notification" Platform +// Log event that describes the failure to send delivery pipeline status +// change Pub/Sub notification. +type DeliveryPipelineNotificationEvent struct { + // DeliveryPipeline: The name of the `Delivery Pipeline`. + DeliveryPipeline string `json:"deliveryPipeline,omitempty"` + + // Message: Debug message for when a notification fails to send. + Message string `json:"message,omitempty"` + + // Type: Type of this notification, e.g. for a Pub/Sub failure. + // + // Possible values: + // "TYPE_UNSPECIFIED" - Type is unspecified. + // "TYPE_PUBSUB_NOTIFICATION_FAILURE" - A Pub/Sub notification failed + // to be sent. + // "TYPE_RENDER_STATUES_CHANGE" - Release render status changed + // notification. + Type string `json:"type,omitempty"` + + // ForceSendFields is a list of field names (e.g. "DeliveryPipeline") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "DeliveryPipeline") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *DeliveryPipelineNotificationEvent) MarshalJSON() ([]byte, error) { + type NoMethod DeliveryPipelineNotificationEvent + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // Empty: A generic empty message that you can re-use to avoid defining // duplicated empty messages in your APIs. A typical example is to use // it as the request or the response type of an API method. For @@ -1608,6 +1653,84 @@ func (s *Release) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ReleaseNotificationEvent: Payload proto for +// "clouddeploy.googleapis.com/release_notification" Platform Log event +// that describes the failure to send release status change Pub/Sub +// notification. +type ReleaseNotificationEvent struct { + // Message: Debug message for when a notification fails to send. + Message string `json:"message,omitempty"` + + // Release: The name of the `Release`. + Release string `json:"release,omitempty"` + + // Type: Type of this notification, e.g. for a Pub/Sub failure. + // + // Possible values: + // "TYPE_UNSPECIFIED" - Type is unspecified. + // "TYPE_PUBSUB_NOTIFICATION_FAILURE" - A Pub/Sub notification failed + // to be sent. + // "TYPE_RENDER_STATUES_CHANGE" - Release render status changed + // notification. + Type string `json:"type,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Message") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Message") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ReleaseNotificationEvent) MarshalJSON() ([]byte, error) { + type NoMethod ReleaseNotificationEvent + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ReleaseRenderEvent: Payload proto for +// "clouddeploy.googleapis.com/release_render" Platform Log event that +// describes the render status change. +type ReleaseRenderEvent struct { + // Message: Debug message for when a render transition occurs. Provides + // further details as rendering progresses through render states. + Message string `json:"message,omitempty"` + + // Release: The name of the `Release`. + Release string `json:"release,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Message") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Message") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ReleaseRenderEvent) MarshalJSON() ([]byte, error) { + type NoMethod ReleaseRenderEvent + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // Rollout: A `Rollout` resource in the Google Cloud Deploy API. A // `Rollout` contains information around a specific deployment to a // `Target`. @@ -1745,6 +1868,59 @@ func (s *Rollout) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// RolloutNotificationEvent: Payload proto for +// "clouddeploy.googleapis.com/rollout_notification" Platform Log event +// that describes the failure to send rollout status change Pub/Sub +// notification. +type RolloutNotificationEvent struct { + // Message: Debug message for when a notification fails to send. + Message string `json:"message,omitempty"` + + // PipelineUid: Unique identifier of the `DeliveryPipeline`. + PipelineUid string `json:"pipelineUid,omitempty"` + + // ReleaseUid: Unique identifier of the `Release`. + ReleaseUid string `json:"releaseUid,omitempty"` + + // Rollout: The name of the `Rollout`. + Rollout string `json:"rollout,omitempty"` + + // TargetId: ID of the `Target` that the rollout is deployed to. + TargetId string `json:"targetId,omitempty"` + + // Type: Type of this notification, e.g. for a Pub/Sub failure. + // + // Possible values: + // "TYPE_UNSPECIFIED" - Type is unspecified. + // "TYPE_PUBSUB_NOTIFICATION_FAILURE" - A Pub/Sub notification failed + // to be sent. + // "TYPE_RENDER_STATUES_CHANGE" - Release render status changed + // notification. + Type string `json:"type,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Message") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Message") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *RolloutNotificationEvent) MarshalJSON() ([]byte, error) { + type NoMethod RolloutNotificationEvent + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // SerialPipeline: SerialPipeline defines a sequential set of stages for // a `DeliveryPipeline`. type SerialPipeline struct { @@ -1779,7 +1955,7 @@ func (s *SerialPipeline) MarshalJSON() ([]byte, error) { type SetIamPolicyRequest struct { // Policy: REQUIRED: The complete policy to be applied to the // `resource`. The size of the policy is limited to a few 10s of KB. An - // empty policy is a valid policy but certain Cloud Platform services + // empty policy is a valid policy but certain Google Cloud services // (such as Projects) might reject them. Policy *Policy `json:"policy,omitempty"` @@ -2056,6 +2232,50 @@ func (s *TargetArtifact) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// TargetNotificationEvent: Payload proto for +// "clouddeploy.googleapis.com/target_notification" Platform Log event +// that describes the failure to send target status change Pub/Sub +// notification. +type TargetNotificationEvent struct { + // Message: Debug message for when a notification fails to send. + Message string `json:"message,omitempty"` + + // Target: The name of the `Target`. + Target string `json:"target,omitempty"` + + // Type: Type of this notification, e.g. for a Pub/Sub failure. + // + // Possible values: + // "TYPE_UNSPECIFIED" - Type is unspecified. + // "TYPE_PUBSUB_NOTIFICATION_FAILURE" - A Pub/Sub notification failed + // to be sent. + // "TYPE_RENDER_STATUES_CHANGE" - Release render status changed + // notification. + Type string `json:"type,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Message") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Message") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *TargetNotificationEvent) MarshalJSON() ([]byte, error) { + type NoMethod TargetNotificationEvent + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // TargetRender: Details of rendering for a single target. type TargetRender struct { // FailureCause: Output only. Reason this render failed. This will @@ -2154,7 +2374,7 @@ func (s *TargetsPresentCondition) MarshalJSON() ([]byte, error) { // method. type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. - // Permissions with wildcards (such as '*' or 'storage.*') are not + // Permissions with wildcards (such as `*` or `storage.*`) are not // allowed. For more information see IAM Overview // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` @@ -2532,8 +2752,8 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall // Filter sets the optional parameter "filter": A filter to narrow down // results to a preferred subset. The filtering language accepts strings -// like "displayName=tokyo", and is documented in more detail in AIP-160 -// (https://google.aip.dev/160). +// like "displayName=tokyo", and is documented in more detail in +// AIP-160 (https://google.aip.dev/160). func (c *ProjectsLocationsListCall) Filter(filter string) *ProjectsLocationsListCall { c.urlParams_.Set("filter", filter) return c @@ -2662,7 +2882,7 @@ func (c *ProjectsLocationsListCall) Do(opts ...googleapi.CallOption) (*ListLocat // ], // "parameters": { // "filter": { - // "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like \"displayName=tokyo\", and is documented in more detail in [AIP-160](https://google.aip.dev/160).", + // "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).", // "location": "query", // "type": "string" // }, diff --git a/file/v1/file-api.json b/file/v1/file-api.json index 44fb626a78e..0735b7527aa 100644 --- a/file/v1/file-api.json +++ b/file/v1/file-api.json @@ -144,7 +144,7 @@ ], "parameters": { "filter": { - "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like \"displayName=tokyo\", and is documented in more detail in [AIP-160](https://google.aip.dev/160).", + "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).", "location": "query", "type": "string" }, @@ -846,7 +846,7 @@ } } }, - "revision": "20220222", + "revision": "20220407", "rootUrl": "https://file.googleapis.com/", "schemas": { "Backup": { @@ -974,7 +974,7 @@ "type": "object" }, "Date": { - "description": "Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values * A month and day, with a zero year (e.g., an anniversary) * A year on its own, with a zero month and a zero day * A year and month, with a zero day (e.g., a credit card expiration date) Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp", + "description": "Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp", "id": "Date", "properties": { "day": { @@ -1015,7 +1015,7 @@ "type": "object" }, "Empty": { - "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.", + "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", "id": "Empty", "properties": {}, "type": "object" @@ -1061,7 +1061,7 @@ "type": "string" }, "instanceType": { - "description": "Optional. The instance_type of this instance of format: projects/{project_id}/locations/{location_id}/instanceTypes/{instance_type_id}. Instance Type represents a high-level tier or SKU of the service that this instance belong to. When enabled(eg: Maintenance Rollout), Rollout uses 'instance_type' along with 'software_versions' to determine whether instance needs an update or not.", + "description": "Optional. The instance_type of this instance of format: projects/{project_number}/locations/{location_id}/instanceTypes/{instance_type_id}. Instance Type represents a high-level tier or SKU of the service that this instance belong to. When enabled(eg: Maintenance Rollout), Rollout uses 'instance_type' along with 'software_versions' to determine whether instance needs an update or not.", "type": "string" }, "labels": { @@ -1090,14 +1090,14 @@ "description": "Optional. The MaintenanceSettings associated with instance." }, "name": { - "description": "Unique name of the resource. It uses the form: `projects/{project_id|project_number}/locations/{location_id}/instances/{instance_id}` Note: Either project_id or project_number can be used, but keep it consistent with other APIs (e.g. RescheduleUpdate)", + "description": "Unique name of the resource. It uses the form: `projects/{project_number}/locations/{location_id}/instances/{instance_id}` Note: This name is passed, stored and logged across the rollout system. So use of consumer project_id or any other consumer PII in the name is strongly discouraged for wipeout (go/wipeout) compliance. See go/elysium/project_ids#storage-guidance for more details.", "type": "string" }, "notificationParameters": { "additionalProperties": { - "type": "string" + "$ref": "GoogleCloudSaasacceleratorManagementProvidersV1NotificationParameter" }, - "description": "Optional. notification_parameters are information that service producers may like to include that is not relevant to Rollout. This parameter will only be passed to Gamma and Cloud Logging for notification/logging purpose.", + "description": "Optional. notification_parameter are information that service producers may like to include that is not relevant to Rollout. This parameter will only be passed to Gamma and Cloud Logging for notification/logging purpose.", "type": "object" }, "producerMetadata": { @@ -1240,6 +1240,20 @@ }, "type": "object" }, + "GoogleCloudSaasacceleratorManagementProvidersV1NotificationParameter": { + "description": "Contains notification related data.", + "id": "GoogleCloudSaasacceleratorManagementProvidersV1NotificationParameter", + "properties": { + "values": { + "description": "Optional. Array of string values. e.g. instance's replica information.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudSaasacceleratorManagementProvidersV1PerSliSloEligibility": { "description": "PerSliSloEligibility is a mapping from an SLI name to eligibility.", "id": "GoogleCloudSaasacceleratorManagementProvidersV1PerSliSloEligibility", diff --git a/file/v1/file-gen.go b/file/v1/file-gen.go index ce6d3ec4d3d..29d748276cb 100644 --- a/file/v1/file-gen.go +++ b/file/v1/file-gen.go @@ -349,11 +349,12 @@ func (s *DailyCycle) MarshalJSON() ([]byte, error) { // birthday. The time of day and time zone are either specified // elsewhere or are insignificant. The date is relative to the Gregorian // Calendar. This can represent one of the following: * A full date, -// with non-zero year, month, and day values * A month and day, with a -// zero year (e.g., an anniversary) * A year on its own, with a zero -// month and a zero day * A year and month, with a zero day (e.g., a -// credit card expiration date) Related types: * google.type.TimeOfDay * -// google.type.DateTime * google.protobuf.Timestamp +// with non-zero year, month, and day values. * A month and day, with a +// zero year (for example, an anniversary). * A year on its own, with a +// zero month and a zero day. * A year and month, with a zero day (for +// example, a credit card expiration date). Related types: * +// google.type.TimeOfDay * google.type.DateTime * +// google.protobuf.Timestamp type Date struct { // Day: Day of a month. Must be from 1 to 31 and valid for the year and // month, or 0 to specify a year by itself or a year and month where the @@ -439,8 +440,7 @@ func (s *DenyMaintenancePeriod) MarshalJSON() ([]byte, error) { // duplicated empty messages in your APIs. A typical example is to use // it as the request or the response type of an API method. For // instance: service Foo { rpc Bar(google.protobuf.Empty) returns -// (google.protobuf.Empty); } The JSON representation for `Empty` is -// empty JSON object `{}`. +// (google.protobuf.Empty); } type Empty struct { // ServerResponse contains the HTTP response code and headers from the // server. @@ -500,11 +500,12 @@ type GoogleCloudSaasacceleratorManagementProvidersV1Instance struct { CreateTime string `json:"createTime,omitempty"` // InstanceType: Optional. The instance_type of this instance of format: - // projects/{project_id}/locations/{location_id}/instanceTypes/{instance_ - // type_id}. Instance Type represents a high-level tier or SKU of the - // service that this instance belong to. When enabled(eg: Maintenance - // Rollout), Rollout uses 'instance_type' along with 'software_versions' - // to determine whether instance needs an update or not. + // projects/{project_number}/locations/{location_id}/instanceTypes/{insta + // nce_type_id}. Instance Type represents a high-level tier or SKU of + // the service that this instance belong to. When enabled(eg: + // Maintenance Rollout), Rollout uses 'instance_type' along with + // 'software_versions' to determine whether instance needs an update or + // not. InstanceType string `json:"instanceType,omitempty"` // Labels: Optional. Resource labels to represent user provided @@ -529,16 +530,18 @@ type GoogleCloudSaasacceleratorManagementProvidersV1Instance struct { MaintenanceSettings *GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings `json:"maintenanceSettings,omitempty"` // Name: Unique name of the resource. It uses the form: - // `projects/{project_id|project_number}/locations/{location_id}/instance - // s/{instance_id}` Note: Either project_id or project_number can be - // used, but keep it consistent with other APIs (e.g. RescheduleUpdate) + // `projects/{project_number}/locations/{location_id}/instances/{instance + // _id}` Note: This name is passed, stored and logged across the rollout + // system. So use of consumer project_id or any other consumer PII in + // the name is strongly discouraged for wipeout (go/wipeout) compliance. + // See go/elysium/project_ids#storage-guidance for more details. Name string `json:"name,omitempty"` - // NotificationParameters: Optional. notification_parameters are + // NotificationParameters: Optional. notification_parameter are // information that service producers may like to include that is not // relevant to Rollout. This parameter will only be passed to Gamma and // Cloud Logging for notification/logging purpose. - NotificationParameters map[string]string `json:"notificationParameters,omitempty"` + NotificationParameters map[string]GoogleCloudSaasacceleratorManagementProvidersV1NotificationParameter `json:"notificationParameters,omitempty"` // ProducerMetadata: Output only. Custom string attributes used // primarily to expose producer-specific information in monitoring @@ -752,6 +755,36 @@ func (s *GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata) Marshal return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudSaasacceleratorManagementProvidersV1NotificationParameter: +// Contains notification related data. +type GoogleCloudSaasacceleratorManagementProvidersV1NotificationParameter struct { + // Values: Optional. Array of string values. e.g. instance's replica + // information. + Values []string `json:"values,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Values") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Values") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudSaasacceleratorManagementProvidersV1NotificationParameter) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudSaasacceleratorManagementProvidersV1NotificationParameter + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudSaasacceleratorManagementProvidersV1PerSliSloEligibility: // PerSliSloEligibility is a mapping from an SLI name to eligibility. type GoogleCloudSaasacceleratorManagementProvidersV1PerSliSloEligibility struct { @@ -2093,8 +2126,8 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall // Filter sets the optional parameter "filter": A filter to narrow down // results to a preferred subset. The filtering language accepts strings -// like "displayName=tokyo", and is documented in more detail in AIP-160 -// (https://google.aip.dev/160). +// like "displayName=tokyo", and is documented in more detail in +// AIP-160 (https://google.aip.dev/160). func (c *ProjectsLocationsListCall) Filter(filter string) *ProjectsLocationsListCall { c.urlParams_.Set("filter", filter) return c @@ -2231,7 +2264,7 @@ func (c *ProjectsLocationsListCall) Do(opts ...googleapi.CallOption) (*ListLocat // ], // "parameters": { // "filter": { - // "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like \"displayName=tokyo\", and is documented in more detail in [AIP-160](https://google.aip.dev/160).", + // "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).", // "location": "query", // "type": "string" // }, diff --git a/gameservices/v1/gameservices-api.json b/gameservices/v1/gameservices-api.json index e4ce357d2c1..8a73d25e287 100644 --- a/gameservices/v1/gameservices-api.json +++ b/gameservices/v1/gameservices-api.json @@ -144,7 +144,7 @@ ], "parameters": { "filter": { - "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like \"displayName=tokyo\", and is documented in more detail in [AIP-160](https://google.aip.dev/160).", + "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).", "location": "query", "type": "string" }, @@ -1357,7 +1357,7 @@ } } }, - "revision": "20220323", + "revision": "20220406", "rootUrl": "https://gameservices.googleapis.com/", "schemas": { "AuditConfig": { @@ -1448,7 +1448,7 @@ "description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)." }, "members": { - "description": "Specifies the principals requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ", + "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ", "items": { "type": "string" }, @@ -2706,7 +2706,7 @@ "properties": { "policy": { "$ref": "Policy", - "description": "REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Cloud Platform services (such as Projects) might reject them." + "description": "REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Google Cloud services (such as Projects) might reject them." }, "updateMask": { "description": "OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only the fields in the mask will be modified. If no mask is provided, the following default mask is used: `paths: \"bindings, etag\"`", @@ -2844,7 +2844,7 @@ "id": "TestIamPermissionsRequest", "properties": { "permissions": { - "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as '*' or 'storage.*') are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", + "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as `*` or `storage.*`) are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", "items": { "type": "string" }, diff --git a/gameservices/v1/gameservices-gen.go b/gameservices/v1/gameservices-gen.go index 022440e443d..e099c16cd5b 100644 --- a/gameservices/v1/gameservices-gen.go +++ b/gameservices/v1/gameservices-gen.go @@ -368,8 +368,8 @@ type Binding struct { // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` - // Members: Specifies the principals requesting access for a Cloud - // Platform resource. `members` can have the following values: * + // Members: Specifies the principals requesting access for a Google + // Cloud resource. `members` can have the following values: * // `allUsers`: A special identifier that represents anyone who is on the // internet; with or without a Google account. * // `allAuthenticatedUsers`: A special identifier that represents anyone @@ -2511,7 +2511,7 @@ func (s *Schedule) MarshalJSON() ([]byte, error) { type SetIamPolicyRequest struct { // Policy: REQUIRED: The complete policy to be applied to the // `resource`. The size of the policy is limited to a few 10s of KB. An - // empty policy is a valid policy but certain Cloud Platform services + // empty policy is a valid policy but certain Google Cloud services // (such as Projects) might reject them. Policy *Policy `json:"policy,omitempty"` @@ -2792,7 +2792,7 @@ func (s *TargetState) MarshalJSON() ([]byte, error) { // method. type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. - // Permissions with wildcards (such as '*' or 'storage.*') are not + // Permissions with wildcards (such as `*` or `storage.*`) are not // allowed. For more information see IAM Overview // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` @@ -3024,8 +3024,8 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall // Filter sets the optional parameter "filter": A filter to narrow down // results to a preferred subset. The filtering language accepts strings -// like "displayName=tokyo", and is documented in more detail in AIP-160 -// (https://google.aip.dev/160). +// like "displayName=tokyo", and is documented in more detail in +// AIP-160 (https://google.aip.dev/160). func (c *ProjectsLocationsListCall) Filter(filter string) *ProjectsLocationsListCall { c.urlParams_.Set("filter", filter) return c @@ -3162,7 +3162,7 @@ func (c *ProjectsLocationsListCall) Do(opts ...googleapi.CallOption) (*ListLocat // ], // "parameters": { // "filter": { - // "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like \"displayName=tokyo\", and is documented in more detail in [AIP-160](https://google.aip.dev/160).", + // "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).", // "location": "query", // "type": "string" // }, diff --git a/gameservices/v1beta/gameservices-api.json b/gameservices/v1beta/gameservices-api.json index bc0ce7887f5..fb54b67f88c 100644 --- a/gameservices/v1beta/gameservices-api.json +++ b/gameservices/v1beta/gameservices-api.json @@ -144,7 +144,7 @@ ], "parameters": { "filter": { - "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like \"displayName=tokyo\", and is documented in more detail in [AIP-160](https://google.aip.dev/160).", + "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).", "location": "query", "type": "string" }, @@ -1357,7 +1357,7 @@ } } }, - "revision": "20220323", + "revision": "20220406", "rootUrl": "https://gameservices.googleapis.com/", "schemas": { "AuditConfig": { @@ -1448,7 +1448,7 @@ "description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)." }, "members": { - "description": "Specifies the principals requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ", + "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ", "items": { "type": "string" }, @@ -2706,7 +2706,7 @@ "properties": { "policy": { "$ref": "Policy", - "description": "REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Cloud Platform services (such as Projects) might reject them." + "description": "REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Google Cloud services (such as Projects) might reject them." }, "updateMask": { "description": "OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only the fields in the mask will be modified. If no mask is provided, the following default mask is used: `paths: \"bindings, etag\"`", @@ -2844,7 +2844,7 @@ "id": "TestIamPermissionsRequest", "properties": { "permissions": { - "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as '*' or 'storage.*') are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", + "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as `*` or `storage.*`) are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", "items": { "type": "string" }, diff --git a/gameservices/v1beta/gameservices-gen.go b/gameservices/v1beta/gameservices-gen.go index 6cd5a2bce53..5fd1fbc6281 100644 --- a/gameservices/v1beta/gameservices-gen.go +++ b/gameservices/v1beta/gameservices-gen.go @@ -368,8 +368,8 @@ type Binding struct { // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` - // Members: Specifies the principals requesting access for a Cloud - // Platform resource. `members` can have the following values: * + // Members: Specifies the principals requesting access for a Google + // Cloud resource. `members` can have the following values: * // `allUsers`: A special identifier that represents anyone who is on the // internet; with or without a Google account. * // `allAuthenticatedUsers`: A special identifier that represents anyone @@ -2511,7 +2511,7 @@ func (s *Schedule) MarshalJSON() ([]byte, error) { type SetIamPolicyRequest struct { // Policy: REQUIRED: The complete policy to be applied to the // `resource`. The size of the policy is limited to a few 10s of KB. An - // empty policy is a valid policy but certain Cloud Platform services + // empty policy is a valid policy but certain Google Cloud services // (such as Projects) might reject them. Policy *Policy `json:"policy,omitempty"` @@ -2792,7 +2792,7 @@ func (s *TargetState) MarshalJSON() ([]byte, error) { // method. type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. - // Permissions with wildcards (such as '*' or 'storage.*') are not + // Permissions with wildcards (such as `*` or `storage.*`) are not // allowed. For more information see IAM Overview // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` @@ -3024,8 +3024,8 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall // Filter sets the optional parameter "filter": A filter to narrow down // results to a preferred subset. The filtering language accepts strings -// like "displayName=tokyo", and is documented in more detail in AIP-160 -// (https://google.aip.dev/160). +// like "displayName=tokyo", and is documented in more detail in +// AIP-160 (https://google.aip.dev/160). func (c *ProjectsLocationsListCall) Filter(filter string) *ProjectsLocationsListCall { c.urlParams_.Set("filter", filter) return c @@ -3162,7 +3162,7 @@ func (c *ProjectsLocationsListCall) Do(opts ...googleapi.CallOption) (*ListLocat // ], // "parameters": { // "filter": { - // "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like \"displayName=tokyo\", and is documented in more detail in [AIP-160](https://google.aip.dev/160).", + // "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).", // "location": "query", // "type": "string" // }, diff --git a/gkebackup/v1/gkebackup-api.json b/gkebackup/v1/gkebackup-api.json index 17ba7557b80..6425b2da197 100644 --- a/gkebackup/v1/gkebackup-api.json +++ b/gkebackup/v1/gkebackup-api.json @@ -214,12 +214,12 @@ ], "parameters": { "backupPlanId": { - "description": "Required. The client-provided short name for the BackupPlan resource. This name must: a. be between 1 and 63 characters long (inclusive) b. consist of only lower-case ASCII letters, numbers, and dashes c. start with a lower-case letter d. end with a lower-case letter or number e. be unique within the set of BackupPlans in this location", + "description": "Required. The client-provided short name for the BackupPlan resource. This name must: - be between 1 and 63 characters long (inclusive) - consist of only lower-case ASCII letters, numbers, and dashes - start with a lower-case letter - end with a lower-case letter or number - be unique within the set of BackupPlans in this location", "location": "query", "type": "string" }, "parent": { - "description": "Required. The location within which to create the BackupPlan. Format: projects/{project}/locations/{location}", + "description": "Required. The location within which to create the BackupPlan. Format: projects/*/locations/*", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -247,12 +247,12 @@ ], "parameters": { "etag": { - "description": "If provided, this value must match the value currently assigned to the target resource.", + "description": "If provided, this value must match the current value of the target BackupPlan's etag field or the request is rejected.", "location": "query", "type": "string" }, "name": { - "description": "Required. Fully qualified BackupPlan name. Format: projects/{project}/locations/{location}/backupPlans/{backup_plan}", + "description": "Required. Fully qualified BackupPlan name. Format: projects/*/locations/*/backupPlans/*", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+$", "required": true, @@ -277,7 +277,7 @@ ], "parameters": { "name": { - "description": "Required. Fully qualified BackupPlan name. Format: projects/{project}/locations/{location}/backupPlans/{backup_plan}", + "description": "Required. Fully qualified BackupPlan name. Format: projects/*/locations/*/backupPlans/*", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+$", "required": true, @@ -333,12 +333,12 @@ ], "parameters": { "filter": { - "description": "List filter.", + "description": "Field match expression used to filter the results.", "location": "query", "type": "string" }, "orderBy": { - "description": "Sort results.", + "description": "Field by which to sort the results.", "location": "query", "type": "string" }, @@ -354,7 +354,7 @@ "type": "string" }, "parent": { - "description": "Required. The location that contains the BackupPlans to list. Format: projects/{project}/locations/{location}", + "description": "Required. The location that contains the BackupPlans to list. Format: projects/*/locations/*", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -379,7 +379,7 @@ ], "parameters": { "name": { - "description": "Output only. [Output Only] The full name of the BackupPlan resource. Format: projects/*/locations/*/backupPlans/*", + "description": "Output only. The full name of the BackupPlan resource. Format: projects/*/locations/*/backupPlans/*", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+$", "required": true, @@ -473,12 +473,12 @@ ], "parameters": { "backupId": { - "description": "The client-provided short name for the Backup resource. This name must: a. be between 1 and 63 characters long (inclusive) b. consist of only lower-case ASCII letters, numbers, and dashes c. start with a lower-case letter d. end with a lower-case letter or number e. be unique within the set of Backups in this BackupPlan", + "description": "The client-provided short name for the Backup resource. This name must: - be between 1 and 63 characters long (inclusive) - consist of only lower-case ASCII letters, numbers, and dashes - start with a lower-case letter - end with a lower-case letter or number - be unique within the set of Backups in this BackupPlan", "location": "query", "type": "string" }, "parent": { - "description": "Required. The BackupPlan within which to create the Backup. Format: projects/{project}/locations/{location}/backupPlans/{backup_plan}", + "description": "Required. The BackupPlan within which to create the Backup. Format: projects/*/locations/*/backupPlans/*", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+$", "required": true, @@ -506,17 +506,17 @@ ], "parameters": { "etag": { - "description": "etag, if provided, it must match the server's etag for the delete to happen.", + "description": "If provided, this value must match the current value of the target Backup's etag field or the request is rejected.", "location": "query", "type": "string" }, "force": { - "description": "If set to true, any volumeBackups below this backup will also be deleted. Otherwise, the request will only succeed if the backup has no volumeBackups.", + "description": "If set to true, any VolumeBackups below this Backup will also be deleted. Otherwise, the request will only succeed if the Backup has no VolumeBackups.", "location": "query", "type": "boolean" }, "name": { - "description": "Required. Name of the Backup resource. Format: projects/{project}/locations/{location}/backupPlans/{backup_plan}/backups/{backup}", + "description": "Required. Name of the Backup resource. Format: projects/*/locations/*/backupPlans/*/backups/*", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+/backups/[^/]+$", "required": true, @@ -541,7 +541,7 @@ ], "parameters": { "name": { - "description": "Required. Full name of the Backup resource. Format: projects/{project}/locations/{location}/backupPlans/{backup_plan}/backups/{backup}", + "description": "Required. Full name of the Backup resource. Format: projects/*/locations/*/backupPlans/*/backups/*", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+/backups/[^/]+$", "required": true, @@ -597,12 +597,12 @@ ], "parameters": { "filter": { - "description": "List filter.", + "description": "Field match expression used to filter the results.", "location": "query", "type": "string" }, "orderBy": { - "description": "Sort results.", + "description": "Field by which to sort the results.", "location": "query", "type": "string" }, @@ -618,7 +618,7 @@ "type": "string" }, "parent": { - "description": "Required. The BackupPlan that contains the Backups to list. Format: projects/{project}/locations/{location}/backupPlans/{backup_plan}", + "description": "Required. The BackupPlan that contains the Backups to list. Format: projects/*/locations/*/backupPlans/*", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+$", "required": true, @@ -737,7 +737,7 @@ ], "parameters": { "name": { - "description": "Required. Full name of the VolumeBackup resource. Format: projects/{project}/locations/{location}/backupPlans/{backup_plan}/backups/{backup}/volumeBackups/{volume_backup}", + "description": "Required. Full name of the VolumeBackup resource. Format: projects/*/locations/*/backupPlans/*/backups/*/volumeBackups/*", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+/backups/[^/]+/volumeBackups/[^/]+$", "required": true, @@ -793,12 +793,12 @@ ], "parameters": { "filter": { - "description": "List filter.", + "description": "Field match expression used to filter the results.", "location": "query", "type": "string" }, "orderBy": { - "description": "Sort results.", + "description": "Field by which to sort the results.", "location": "query", "type": "string" }, @@ -814,7 +814,7 @@ "type": "string" }, "parent": { - "description": "Required. The Backup that contains the VolumeBackups to list. Format: projects/{project}/locations/{location}/backupPlans/{backup_plan}/backups/{backup}", + "description": "Required. The Backup that contains the VolumeBackups to list. Format: projects/*/locations/*/backupPlans/*/backups/*", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+/backups/[^/]+$", "required": true, @@ -1001,14 +1001,14 @@ ], "parameters": { "parent": { - "description": "Required. The location within which to create the RestorePlan. Format: projects/{project}/locations/{location}", + "description": "Required. The location within which to create the RestorePlan. Format: projects/*/locations/*", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "type": "string" }, "restorePlanId": { - "description": "Required. The client-provided short name for the RestorePlan resource. This name must: a. be between 1 and 63 characters long (inclusive) b. consist of only lower-case ASCII letters, numbers, and dashes c. start with a lower-case letter d. end with a lower-case letter or number e. be unique within the set of RestorePlans in this location", + "description": "Required. The client-provided short name for the RestorePlan resource. This name must: - be between 1 and 63 characters long (inclusive) - consist of only lower-case ASCII letters, numbers, and dashes - start with a lower-case letter - end with a lower-case letter or number - be unique within the set of RestorePlans in this location", "location": "query", "type": "string" } @@ -1034,17 +1034,17 @@ ], "parameters": { "etag": { - "description": "If provided, this value must match the value currently assigned to the target resource.", + "description": "If provided, this value must match the current value of the target RestorePlan's etag field or the request is rejected.", "location": "query", "type": "string" }, "force": { - "description": "If set to true, any restores below this restorePlan will also be deleted. Otherwise, the request will only succeed if the restorePlan has no restores.", + "description": "If set to true, any Restores below this RestorePlan will also be deleted. Otherwise, the request will only succeed if the RestorePlan has no Restores.", "location": "query", "type": "boolean" }, "name": { - "description": "Required. Fully qualified RestorePlan name. Format: projects/{project}/locations/{location}/restorePlans/{restore_plan}", + "description": "Required. Fully qualified RestorePlan name. Format: projects/*/locations/*/restorePlans/*", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+$", "required": true, @@ -1069,7 +1069,7 @@ ], "parameters": { "name": { - "description": "Required. Fully qualified RestorePlan name. Format: projects/{project}/locations/{location}/restorePlans/{restore_plan}", + "description": "Required. Fully qualified RestorePlan name. Format: projects/*/locations/*/restorePlans/*", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+$", "required": true, @@ -1125,12 +1125,12 @@ ], "parameters": { "filter": { - "description": "List filter.", + "description": "Field match expression used to filter the results.", "location": "query", "type": "string" }, "orderBy": { - "description": "Sort results.", + "description": "Field by which to sort the results.", "location": "query", "type": "string" }, @@ -1146,7 +1146,7 @@ "type": "string" }, "parent": { - "description": "Required. The location that contains the RestorePlans to list. Format: projects/{project}/locations/{location}", + "description": "Required. The location that contains the RestorePlans to list. Format: projects/*/locations/*", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -1171,7 +1171,7 @@ ], "parameters": { "name": { - "description": "Output only. [Output Only] The full name of the RestorePlan resource. Format: projects/*/locations/*/restorePlans/*", + "description": "Output only. The full name of the RestorePlan resource. Format: projects/*/locations/*/restorePlans/*.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+$", "required": true, @@ -1265,14 +1265,14 @@ ], "parameters": { "parent": { - "description": "Required. The RestorePlan within which to create the Restore. Format: projects/{project}/locations/{location}/restorePlans/{restore_plan}", + "description": "Required. The RestorePlan within which to create the Restore. Format: projects/*/locations/*/restorePlans/*", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+$", "required": true, "type": "string" }, "restoreId": { - "description": "Required. The client-provided short name for the Restore resource. This name must: a. be between 1 and 63 characters long (inclusive) b. consist of only lower-case ASCII letters, numbers, and dashes c. start with a lower-case letter d. end with a lower-case letter or number e. be unique within the set of Restores in this RestorePlan.", + "description": "Required. The client-provided short name for the Restore resource. This name must: - be between 1 and 63 characters long (inclusive) - consist of only lower-case ASCII letters, numbers, and dashes - start with a lower-case letter - end with a lower-case letter or number - be unique within the set of Restores in this RestorePlan.", "location": "query", "type": "string" } @@ -1298,17 +1298,17 @@ ], "parameters": { "etag": { - "description": "etag, if provided, it must match the server's etag for delete to happen.", + "description": "If provided, this value must match the current value of the target Restore's etag field or the request is rejected.", "location": "query", "type": "string" }, "force": { - "description": "If set to true, any volumeRestores below this restore will also be deleted. Otherwise, the request will only succeed if the restore has no volumeRestores.", + "description": "If set to true, any VolumeRestores below this restore will also be deleted. Otherwise, the request will only succeed if the restore has no VolumeRestores.", "location": "query", "type": "boolean" }, "name": { - "description": "Required. Full name of the Restore Format: projects/{project}/locations/{location}/restorePlans/{restore_plan}/restores/{restore}", + "description": "Required. Full name of the Restore Format: projects/*/locations/*/restorePlans/*/restores/*", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+/restores/[^/]+$", "required": true, @@ -1333,7 +1333,7 @@ ], "parameters": { "name": { - "description": "Required. Name of the restore resource. Format: projects/{project}/locations/{location}/restorePlans/{restore_plan}/restores/{restore}", + "description": "Required. Name of the restore resource. Format: projects/*/locations/*/restorePlans/*/restores/*", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+/restores/[^/]+$", "required": true, @@ -1389,12 +1389,12 @@ ], "parameters": { "filter": { - "description": "List filter.", + "description": "Field match expression used to filter the results.", "location": "query", "type": "string" }, "orderBy": { - "description": "Sort results.", + "description": "Field by which to sort the results.", "location": "query", "type": "string" }, @@ -1410,7 +1410,7 @@ "type": "string" }, "parent": { - "description": "Required. The RestorePlan that contains the Restores to list. Format: projects/{project}/locations/{location}/restorePlans/{restore_plan}", + "description": "Required. The RestorePlan that contains the Restores to list. Format: projects/*/locations/*/restorePlans/*", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+$", "required": true, @@ -1529,7 +1529,7 @@ ], "parameters": { "name": { - "description": "Required. Full name of the VolumeRestore resource. Format: projects/{project}/locations/{location}/restorePlans/{restore_plan}/restores/{restore}/volumeRestores/{volume_restore}", + "description": "Required. Full name of the VolumeRestore resource. Format: projects/*/locations/*/restorePlans/*/restores/*/volumeRestores/*", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+/restores/[^/]+/volumeRestores/[^/]+$", "required": true, @@ -1585,12 +1585,12 @@ ], "parameters": { "filter": { - "description": "List filter.", + "description": "Field match expression used to filter the results.", "location": "query", "type": "string" }, "orderBy": { - "description": "Sort results.", + "description": "Field by which to sort the results.", "location": "query", "type": "string" }, @@ -1606,7 +1606,7 @@ "type": "string" }, "parent": { - "description": "Required. The Restore that contains the VolumeRestores to list. Format: projects/{project}/locations/{location}/restorePlans/{restore_plan}/restores/{restore}", + "description": "Required. The Restore that contains the VolumeRestores to list. Format: projects/*/locations/*/restorePlans/*/restores/*", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+/restores/[^/]+$", "required": true, @@ -1688,7 +1688,7 @@ } } }, - "revision": "20220406", + "revision": "20220413", "rootUrl": "https://gkebackup.googleapis.com/", "schemas": { "AuditConfig": { @@ -1760,29 +1760,29 @@ "type": "string" }, "configBackupSizeBytes": { - "description": "Output only. cluster config backup size in bytes.", + "description": "Output only. The size of the config backup in bytes.", "format": "int64", "readOnly": true, "type": "string" }, "containsSecrets": { - "description": "Output only. Whether or not the Backup contains Kubernetes Secrets. Inherited from the parent BackupPlan's backup_config.include_secrets.", + "description": "Output only. Whether or not the Backup contains Kubernetes Secrets. Controlled by the parent BackupPlan's include_secrets value.", "readOnly": true, "type": "boolean" }, "containsVolumeData": { - "description": "Output only. Whether or not the Backup contains volume data. Inherited from the parent BackupPlan's backup_config.include_volume_data.", + "description": "Output only. Whether or not the Backup contains volume data. Controlled by the parent BackupPlan's include_volume_data value.", "readOnly": true, "type": "boolean" }, "createTime": { - "description": "Output only. [Output Only] The timestamp when this Backup resource was created - can be converted to and from [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)", + "description": "Output only. The timestamp when this Backup resource was created.", "format": "google-datetime", "readOnly": true, "type": "string" }, "deleteLockDays": { - "description": "Minimum age for this Backup (in days). If this field is set to a non-zero value, the Backup will be \"locked\" against deletion (either manual or automatic deletion) for the number of days provided (measured from the creation time of the Backup). This value is inherited from the parent BackupPlan's retention_policy.backup_delete_lock_days value and may only be increased (either at creation time or in a subsequent update). This field MUST be an integer value between 0-90 (inclusive). Default: inherited from BackupPlan.", + "description": "Minimum age for this Backup (in days). If this field is set to a non-zero value, the Backup will be \"locked\" against deletion (either manual or automatic deletion) for the number of days provided (measured from the creation time of the Backup). MUST be an integer value between 0-90 (inclusive). Defaults to parent BackupPlan's backup_delete_lock_days setting and may only be increased (either at creation time or in a subsequent update).", "format": "int32", "type": "integer" }, @@ -1798,11 +1798,11 @@ }, "encryptionKey": { "$ref": "EncryptionKey", - "description": "Output only. The customer managed encryption key that was used to encrypt the Backup's artifacts. Inherited from the parent BackupPlan's backup_config.encryption_key.", + "description": "Output only. The customer managed encryption key that was used to encrypt the Backup's artifacts. Inherited from the parent BackupPlan's encryption_key value.", "readOnly": true }, "etag": { - "description": "Output only. `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a backup from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform backup updates in order to avoid race conditions: An `etag` is returned in the response to `GetBackup`, and systems are expected to put that etag in the request to `UpdateBackup` to ensure that their change will be applied to the same version.", + "description": "Output only. `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a backup from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform backup updates in order to avoid race conditions: An `etag` is returned in the response to `GetBackup`, and systems are expected to put that etag in the request to `UpdateBackup` or `DeleteBackup` to ensure that their change will be applied to the same version of the resource.", "readOnly": true, "type": "string" }, @@ -1836,7 +1836,7 @@ "type": "integer" }, "retainDays": { - "description": "The age (in days) after which this Backup will be automatically deleted. If not specified at Backup creation time, this value is inherited from the parent BackupPlan's retention_policy.backup_retain_days value. Once a Backup is created, this value may only be increased. This must be an integer value \u003e= 0. If 0, no automatic deletion will occur for this Backup. If not 0, this must be \u003e= delete_lock_days. Default: inherited from BackupPlan.", + "description": "The age (in days) after which this Backup will be automatically deleted. Must be an integer value \u003e= 0: - If 0, no automatic deletion will occur for this Backup. - If not 0, this must be \u003e= delete_lock_days. Once a Backup is created, this value may only be increased. Defaults to the parent BackupPlan's backup_retain_days value.", "format": "int32", "type": "integer" }, @@ -1889,12 +1889,12 @@ "type": "string" }, "uid": { - "description": "Output only. [Output Only] Server generated global unique identifier of [UUID4](https://en.wikipedia.org/wiki/Universally_unique_identifier)", + "description": "Output only. Server generated global unique identifier of [UUID4](https://en.wikipedia.org/wiki/Universally_unique_identifier)", "readOnly": true, "type": "string" }, "updateTime": { - "description": "Output only. [Output Only] The timestamp when this Backup resource was last updated - can be converted to and from [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)", + "description": "Output only. The timestamp when this Backup resource was last updated.", "format": "google-datetime", "readOnly": true, "type": "string" @@ -1918,7 +1918,7 @@ }, "encryptionKey": { "$ref": "EncryptionKey", - "description": "This defines a customer managed encryption key that will be used to encrypt the Backup artifacts for Backups created via this BackupPlan." + "description": "This defines a customer managed encryption key that will be used to encrypt the \"config\" portion (the Kubernetes resources) of Backups created via this plan. Default (empty): Config backup artifacts will not be encrypted." }, "includeSecrets": { "description": "This flag specifies whether Kubernetes Secret resources should be included when they fall into the scope of Backups. Default: False", @@ -1934,7 +1934,7 @@ }, "selectedNamespaces": { "$ref": "Namespaces", - "description": "If set, include just the resources in the listed namespaces" + "description": "If set, include just the resources in the listed namespaces." } }, "type": "object" @@ -1952,17 +1952,17 @@ "description": "Defines a schedule for automatic Backup creation via this BackupPlan." }, "cluster": { - "description": "Required. Immutable. The source cluster from which Backups will be created via this BackupPlan. Possible formats: 1. projects/*/locations/*/clusters/* 2. projects/*/zones/*/clusters/*", + "description": "Required. Immutable. The source cluster from which Backups will be created via this BackupPlan. Valid formats: - projects/*/locations/*/clusters/* - projects/*/zones/*/clusters/*", "type": "string" }, "createTime": { - "description": "Output only. [Output Only] The timestamp when this BackupPlan resource was created - can be converted to and from [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)", + "description": "Output only. The timestamp when this BackupPlan resource was created.", "format": "google-datetime", "readOnly": true, "type": "string" }, "deactivated": { - "description": "This flag indicates whether this BackupPlan has been deactivated. Setting this field to True locks the BackupPlan such that no further updates will be allowed, including the deactivated field. It also prevents any new Backups from being created via this BackupPlan (including scheduled Backups). Default: False", + "description": "This flag indicates whether this BackupPlan has been deactivated. Setting this field to True locks the BackupPlan such that no further updates will be allowed (except deletes), including the deactivated field itself. It also prevents any new Backups from being created via this BackupPlan (including scheduled Backups). Default: False", "type": "boolean" }, "description": { @@ -1970,7 +1970,7 @@ "type": "string" }, "etag": { - "description": "Output only. `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a backup plan from overwriting each other. It is strongly suggested that systems make use of the 'etag' in the read-modify-write cycle to perform BackupPlan updates in order to avoid race conditions: An `etag` is returned in the response to `GetBackupPlan`, and systems are expected to put that etag in the request to `UpdateBackupPlan` to ensure that their change will be applied to the same version.", + "description": "Output only. `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a backup plan from overwriting each other. It is strongly suggested that systems make use of the 'etag' in the read-modify-write cycle to perform BackupPlan updates in order to avoid race conditions: An `etag` is returned in the response to `GetBackupPlan`, and systems are expected to put that etag in the request to `UpdateBackupPlan` or `DeleteBackupPlan` to ensure that their change will be applied to the same version of the resource.", "readOnly": true, "type": "string" }, @@ -1982,12 +1982,12 @@ "type": "object" }, "name": { - "description": "Output only. [Output Only] The full name of the BackupPlan resource. Format: projects/*/locations/*/backupPlans/*", + "description": "Output only. The full name of the BackupPlan resource. Format: projects/*/locations/*/backupPlans/*", "readOnly": true, "type": "string" }, "protectedPodCount": { - "description": "Output only. [Output Only] Represents the number of Kubernetes Pods backed up in the last successful Backup created underneath this BackupPlan.", + "description": "Output only. The number of Kubernetes Pods backed up in the last successful Backup created via this BackupPlan.", "format": "int32", "readOnly": true, "type": "integer" @@ -1997,12 +1997,12 @@ "description": "RetentionPolicy governs lifecycle of Backups created under this plan." }, "uid": { - "description": "Output only. [Output Only] Server generated global unique identifier of [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier) format.", + "description": "Output only. Server generated global unique identifier of [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier) format.", "readOnly": true, "type": "string" }, "updateTime": { - "description": "Output only. [Output Only] The timestamp when this BackupPlan resource was last updated - can be converted to and from [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)", + "description": "Output only. The timestamp when this BackupPlan resource was last updated.", "format": "google-datetime", "readOnly": true, "type": "string" @@ -2048,7 +2048,7 @@ "type": "object" }, "cluster": { - "description": "The source cluster from which this Backup was created. Possible formats: 1. projects/*/locations/*/clusters/* 2. projects/*/zones/*/clusters/* This will be the same value as the parent BackupPlan's cluster field.", + "description": "The source cluster from which this Backup was created. Valid formats: - projects/*/locations/*/clusters/* - projects/*/zones/*/clusters/* This is inherited from the parent BackupPlan's cluster field.", "type": "string" }, "gkeVersion": { @@ -2087,7 +2087,7 @@ "id": "EncryptionKey", "properties": { "gcpKmsEncryptionKey": { - "description": "Google Cloud KMS encryption key. Format: projects//locations//keyRings//cryptoKeys/", + "description": "Google Cloud KMS encryption key. Format: projects/*/locations/*/keyRings/*/cryptoKeys/*", "type": "string" } }, @@ -2222,14 +2222,14 @@ "id": "ListBackupPlansResponse", "properties": { "backupPlans": { - "description": "The list of BackupPlans.", + "description": "The list of BackupPlans matching the given criteria.", "items": { "$ref": "BackupPlan" }, "type": "array" }, "nextPageToken": { - "description": "A token which may be sent as `page_token` in a subsequent `ListBackupPlans` call to retrieve the next page of results. If this field is omitted or empty, then there are no more results to return.", + "description": "A token which may be sent as page_token in a subsequent `ListBackupPlans` call to retrieve the next page of results. If this field is omitted or empty, then there are no more results to return.", "type": "string" }, "unreachable": { @@ -2247,14 +2247,14 @@ "id": "ListBackupsResponse", "properties": { "backups": { - "description": "The list of restore resources within the parent.", + "description": "The list of Backups matching the given criteria.", "items": { "$ref": "Backup" }, "type": "array" }, "nextPageToken": { - "description": "A token which may be sent as `page_token` in a subsequent `ListBackups` call to retrieve the next page of results. If this field is omitted or empty, then there are no more results to return.", + "description": "A token which may be sent as page_token in a subsequent `ListBackups` call to retrieve the next page of results. If this field is omitted or empty, then there are no more results to return.", "type": "string" } }, @@ -2283,11 +2283,11 @@ "id": "ListRestorePlansResponse", "properties": { "nextPageToken": { - "description": "A token which may be sent as `page_token` in a subsequent `ListRestorePlans` call to retrieve the next page of results. If this field is omitted or empty, then there are no more results to return.", + "description": "A token which may be sent as page_token in a subsequent `ListRestorePlans` call to retrieve the next page of results. If this field is omitted or empty, then there are no more results to return.", "type": "string" }, "restorePlans": { - "description": "The list of RestorePlans.", + "description": "The list of RestorePlans matching the given criteria.", "items": { "$ref": "RestorePlan" }, @@ -2308,11 +2308,11 @@ "id": "ListRestoresResponse", "properties": { "nextPageToken": { - "description": "A token which may be sent as `page_token` in a subsequent `ListRestores` call to retrieve the next page of results. If this field is omitted or empty, then there are no more results to return.", + "description": "A token which may be sent as page_token in a subsequent `ListRestores` call to retrieve the next page of results. If this field is omitted or empty, then there are no more results to return.", "type": "string" }, "restores": { - "description": "The list of restore resources within the parent.", + "description": "The list of Restores matching the given criteria.", "items": { "$ref": "Restore" }, @@ -2333,11 +2333,11 @@ "id": "ListVolumeBackupsResponse", "properties": { "nextPageToken": { - "description": "A token which may be sent as `page_token` in a subsequent `ListVolumeBackups` call to retrieve the next page of results. If this field is omitted or empty, then there are no more results to return.", + "description": "A token which may be sent as page_token in a subsequent `ListVolumeBackups` call to retrieve the next page of results. If this field is omitted or empty, then there are no more results to return.", "type": "string" }, "volumeBackups": { - "description": "The list of VolumeBackups resources within the parent.", + "description": "The list of VolumeBackups matching the given criteria.", "items": { "$ref": "VolumeBackup" }, @@ -2351,11 +2351,11 @@ "id": "ListVolumeRestoresResponse", "properties": { "nextPageToken": { - "description": "A token which may be sent as `page_token` in a subsequent `ListVolumeRestores` call to retrieve the next page of results. If this field is omitted or empty, then there are no more results to return.", + "description": "A token which may be sent as page_token in a subsequent `ListVolumeRestores` call to retrieve the next page of results. If this field is omitted or empty, then there are no more results to return.", "type": "string" }, "volumeRestores": { - "description": "The list of VolumeRestores resources within the parent.", + "description": "The list of VolumeRestores matching the given criteria.", "items": { "$ref": "VolumeRestore" }, @@ -2521,22 +2521,22 @@ "id": "Restore", "properties": { "backup": { - "description": "Required. Immutable. The Backup used as the source from which this Restore will restore. Note that this Backup must be a sub-resource of the RestorePlan's backup_plan. Format: projects/*/locations/*/backupPlans/*/backups/*.", + "description": "Required. Immutable. A reference to the Backup used as the source from which this Restore will restore. Note that this Backup must be a sub-resource of the RestorePlan's backup_plan. Format: projects/*/locations/*/backupPlans/*/backups/*.", "type": "string" }, "cluster": { - "description": "Output only. The target cluster into which this Restore will restore data. Possible formats: 1. projects/*/locations/*/clusters/* 2. projects/*/zones/*/clusters/* Inherited from parent RestorePlan's cluster field.", + "description": "Output only. The target cluster into which this Restore will restore data. Valid formats: - projects/*/locations/*/clusters/* - projects/*/zones/*/clusters/* Inherited from parent RestorePlan's cluster value.", "readOnly": true, "type": "string" }, "completeTime": { - "description": "Output only. When the restore operation either successfully completed or failed.", + "description": "Output only. Timestamp of when the restore operation completed.", "format": "google-datetime", "readOnly": true, "type": "string" }, "createTime": { - "description": "Output only. [Output Only] The timestamp when this Restore resource was created - can be converted to and from [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)", + "description": "Output only. The timestamp when this Restore resource was created.", "format": "google-datetime", "readOnly": true, "type": "string" @@ -2546,7 +2546,7 @@ "type": "string" }, "etag": { - "description": "Output only. `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a restore from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform restore updates in order to avoid race conditions: An `etag` is returned in the response to `GetRestore`, and systems are expected to put that etag in the request to `UpdateRestore` to ensure that their change will be applied to the same version.", + "description": "Output only. `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a restore from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform restore updates in order to avoid race conditions: An `etag` is returned in the response to `GetRestore`, and systems are expected to put that etag in the request to `UpdateRestore` or `DeleteRestore` to ensure that their change will be applied to the same version of the resource.", "readOnly": true, "type": "string" }, @@ -2554,7 +2554,7 @@ "additionalProperties": { "type": "string" }, - "description": "GCP Labels.", + "description": "A set of custom labels supplied by user.", "type": "object" }, "name": { @@ -2563,19 +2563,19 @@ "type": "string" }, "resourcesExcludedCount": { - "description": "Output only. Number of resources excluded in this restore action.", + "description": "Output only. Number of resources excluded during the restore execution.", "format": "int32", "readOnly": true, "type": "integer" }, "resourcesFailedCount": { - "description": "Output only. Number of resources failed to be restored in this restore action.", + "description": "Output only. Number of resources that failed to be restored during the restore execution.", "format": "int32", "readOnly": true, "type": "integer" }, "resourcesRestoredCount": { - "description": "Output only. Number of resources restored in this restore action.", + "description": "Output only. Number of resources restored during the restore execution.", "format": "int32", "readOnly": true, "type": "integer" @@ -2612,18 +2612,18 @@ "type": "string" }, "uid": { - "description": "Output only. [Output Only] Server generated global unique identifier of [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier) format.", + "description": "Output only. Server generated global unique identifier of [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier) format.", "readOnly": true, "type": "string" }, "updateTime": { - "description": "Output only. [Output Only] The timestamp when this Restore resource was last updated - can be converted to and from [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)", + "description": "Output only. The timestamp when this Restore resource was last updated.", "format": "google-datetime", "readOnly": true, "type": "string" }, "volumesRestoredCount": { - "description": "Output only. Number of volumes restored in this restore action.", + "description": "Output only. Number of volumes restored during the restore execution.", "format": "int32", "readOnly": true, "type": "integer" @@ -2658,14 +2658,14 @@ "description": "Identifies the cluster-scoped resources to restore from the Backup. Not specifying it means NO cluster resource will be restored." }, "namespacedResourceRestoreMode": { - "description": "Defines the behavior for handling the situation where sets of namespaced resources being restored already exist in the target cluster. This MUST be set to a value other than NAMESPACED_RESOURCE_RESTORE_MODE_UNSPECIFIED if any namespaced restoration is configured via namespaced_resource_restore_scope .", + "description": "Defines the behavior for handling the situation where sets of namespaced resources being restored already exist in the target cluster. This MUST be set to a value other than NAMESPACED_RESOURCE_RESTORE_MODE_UNSPECIFIED.", "enum": [ "NAMESPACED_RESOURCE_RESTORE_MODE_UNSPECIFIED", "DELETE_AND_RESTORE", "FAIL_ON_CONFLICT" ], "enumDescriptions": [ - "Unspecified. Only allowed if no namespaced resources will be restored.", + "Unspecified (invalid).", "When conflicting top-level resources (either Namespaces or ProtectedApplications, depending upon the scope) are encountered, this will first trigger a delete of the conflicting resource AND ALL OF ITS REFERENCED RESOURCES (e.g., all resources in the Namespace or all resources referenced by the ProtectedApplication) before restoring the resources from the Backup. This mode should only be used when you are intending to revert some portion of a cluster to an earlier state.", "If conflicting top-level resources (either Namespaces or ProtectedApplications, depending upon the scope) are encountered at the beginning of a restore process, the Restore will fail. If a conflict occurs during the restore process itself (e.g., because an out of band process creates conflicting resources), a conflict will be reported." ], @@ -2695,7 +2695,7 @@ "NO_VOLUME_DATA_RESTORATION" ], "enumDescriptions": [ - "unspecified, default value", + "Unspecified (illegal).", "For each PVC to be restored, will create a new underlying volume (and PV) from the corresponding VolumeBackup contained within the Backup.", "For each PVC to be restored, attempt to reuse the original PV contained in the Backup (with its original underlying volume). Note that option is likely only usable when restoring a workload to its original cluster.", "For each PVC to be restored, PVCs will be created without any particular action to restore data. In this case, the normal Kubernetes provisioning logic would kick in, and this would likely result in either dynamically provisioning blank PVs or binding to statically provisioned PVs." @@ -2710,15 +2710,15 @@ "id": "RestorePlan", "properties": { "backupPlan": { - "description": "Required. Immutable. The BackupPlan from which Backups may be used as the source for Restores created via this RestorePlan. Format: projects/*/locations/*/backupPlans/*.", + "description": "Required. Immutable. A reference to the BackupPlan from which Backups may be used as the source for Restores created via this RestorePlan. Format: projects/*/locations/*/backupPlans/*.", "type": "string" }, "cluster": { - "description": "Required. Immutable. The target cluster into which Restores created via this RestorePlan will restore data. NOTE: the cluster's region must be the same as the RestorePlan. Possible formats: 1. projects/*/locations/*/clusters/* 2. projects/*/zones/*/clusters/*", + "description": "Required. Immutable. The target cluster into which Restores created via this RestorePlan will restore data. NOTE: the cluster's region must be the same as the RestorePlan. Valid formats: - projects/*/locations/*/clusters/* - projects/*/zones/*/clusters/*", "type": "string" }, "createTime": { - "description": "Output only. [Output Only] The timestamp when this RestorePlan resource was created - can be converted to and from [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)", + "description": "Output only. The timestamp when this RestorePlan resource was created.", "format": "google-datetime", "readOnly": true, "type": "string" @@ -2728,7 +2728,7 @@ "type": "string" }, "etag": { - "description": "Output only. `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a restore from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform restore updates in order to avoid race conditions: An `etag` is returned in the response to `GetRestorePlan`, and systems are expected to put that etag in the request to `UpdateRestorePlan` to ensure that their change will be applied to the same version.", + "description": "Output only. `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a restore from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform restore updates in order to avoid race conditions: An `etag` is returned in the response to `GetRestorePlan`, and systems are expected to put that etag in the request to `UpdateRestorePlan` or `DeleteRestorePlan` to ensure that their change will be applied to the same version of the resource.", "readOnly": true, "type": "string" }, @@ -2740,7 +2740,7 @@ "type": "object" }, "name": { - "description": "Output only. [Output Only] The full name of the RestorePlan resource. Format: projects/*/locations/*/restorePlans/*", + "description": "Output only. The full name of the RestorePlan resource. Format: projects/*/locations/*/restorePlans/*.", "readOnly": true, "type": "string" }, @@ -2749,12 +2749,12 @@ "description": "Required. Configuration of Restores created via this RestorePlan." }, "uid": { - "description": "Output only. [Output Only] Server generated global unique identifier of [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier) format.", + "description": "Output only. Server generated global unique identifier of [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier) format.", "readOnly": true, "type": "string" }, "updateTime": { - "description": "Output only. [Output Only] The timestamp when this RestorePlan resource was last updated - can be converted to and from [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)", + "description": "Output only. The timestamp when this RestorePlan resource was last updated.", "format": "google-datetime", "readOnly": true, "type": "string" @@ -2763,16 +2763,16 @@ "type": "object" }, "RetentionPolicy": { - "description": "RentionPolicy is an inner message type to define: 1. Minimum age for Backups created via this BackupPlan - deletion (either manual or automatic) of Backups younger than this age will be blocked 2. Default maximum age of Backups created via this BackupPlan, after which automatic deletion will occur 3. Lock to disallow any changes to any RetentionPolicy settings", + "description": "RetentionPolicy defines a Backup retention policy for a BackupPlan.", "id": "RetentionPolicy", "properties": { "backupDeleteLockDays": { - "description": "Minimum age for Backups created via this BackupPlan (in days). This field MUST be an integer value between 0-90(inclusive). A Backup created under this BackupPlan will NOT be deletable until it reaches Backup's create_time + backup_delete_lock_days. Updating this field of a BackupPlan does NOT affect existing Backups under it. Backups created AFTER a successful update will inherit the new value. Default: 0 (no delete blocking)", + "description": "Minimum age for Backups created via this BackupPlan (in days). This field MUST be an integer value between 0-90 (inclusive). A Backup created under this BackupPlan will NOT be deletable until it reaches Backup's (create_time + backup_delete_lock_days). Updating this field of a BackupPlan does NOT affect existing Backups under it. Backups created AFTER a successful update will inherit the new value. Default: 0 (no delete blocking)", "format": "int32", "type": "integer" }, "backupRetainDays": { - "description": "The default maximum age of a Backup created via this BackupPlan. This field MUST be an integer value \u003e= 0. If specified, a Backup created under this BackupPlan will be automatically deleted after its age reaches create_time + backup_retain_days. If not specified, Backups created under this BackupPlan will NOT be subject to automatic deletion. Updating this field does NOT affect existing Backups under it. Backups created AFTER a successful update will automatically pick up the new value. NOTE: Specifying a backup_retain_days smaller than backup_delete_lock_days at creation/updating time will be considered as invalid, and the request will be rejected immediately. Default: 0 (no automatic deletion)", + "description": "The default maximum age of a Backup created via this BackupPlan. This field MUST be an integer value \u003e= 0. If specified, a Backup created under this BackupPlan will be automatically deleted after its age reaches (create_time + backup_retain_days). If not specified, Backups created under this BackupPlan will NOT be subject to automatic deletion. Updating this field does NOT affect existing Backups under it. Backups created AFTER a successful update will automatically pick up the new value. NOTE: backup_retain_days must be \u003e= backup_delete_lock_days. Default: 0 (no automatic deletion)", "format": "int32", "type": "integer" }, @@ -2788,7 +2788,7 @@ "id": "Schedule", "properties": { "cronSchedule": { - "description": "A standard cron-style string that defines a repeating schedule for creating Backups via this BackupPlan.", + "description": "A standard [cron](https://wikipedia.com/wiki/cron) string that defines a repeating schedule for creating Backups via this BackupPlan. Default (empty): no automatic backup creation will occur.", "type": "string" }, "paused": { @@ -2880,13 +2880,13 @@ "id": "VolumeBackup", "properties": { "completeTime": { - "description": "Output only. [Output Only] The timestamp when the associated underlying volume backup operation completes - can be converted to and from [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)", + "description": "Output only. The timestamp when the associated underlying volume backup operation completed.", "format": "google-datetime", "readOnly": true, "type": "string" }, "createTime": { - "description": "Output only. [Output Only] The timestamp when this VolumeBackup resource was created - can be converted to and from [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)", + "description": "Output only. The timestamp when this VolumeBackup resource was created.", "format": "google-datetime", "readOnly": true, "type": "string" @@ -2898,7 +2898,7 @@ "type": "string" }, "etag": { - "description": "Output only. `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a volume backup from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform volume backup updates in order to avoid race conditions: An `etag` is returned in the response to `GetVolumeBackup', and systems are expected to put that etag in the request to `UpdateVolumeBackup` to ensure that their change will be applied to the same version.", + "description": "Output only. `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a volume backup from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform volume backup updates in order to avoid race conditions.", "readOnly": true, "type": "string" }, @@ -2916,7 +2916,7 @@ "type": "string" }, "name": { - "description": "Output only. [Output Only] The full name of the VolumeBackup resource. Format: projects/*/locations/*/backupPlans/*/backups/*/volumeBackups/* Note that the last segment of the name will have the format: 'pvc-'.", + "description": "Output only. The full name of the VolumeBackup resource. Format: projects/*/locations/*/backupPlans/*/backups/*/volumeBackups/*.", "readOnly": true, "type": "string" }, @@ -2960,18 +2960,18 @@ "type": "string" }, "uid": { - "description": "Output only. [Output Only] Server generated global unique identifier of [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier) format.", + "description": "Output only. Server generated global unique identifier of [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier) format.", "readOnly": true, "type": "string" }, "updateTime": { - "description": "Output only. [Output Only] The timestamp when this VolumeBackup resource was last updated - can be converted to and from [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)", + "description": "Output only. The timestamp when this VolumeBackup resource was last updated.", "format": "google-datetime", "readOnly": true, "type": "string" }, "volumeBackupHandle": { - "description": "Output only. A storage system-specific opaque handle to the underlying volume backup. This field is interpreted by the volume backup and restore drivers running in the GKE cluster and not by the service.", + "description": "Output only. A storage system-specific opaque handle to the underlying volume backup.", "readOnly": true, "type": "string" } @@ -2983,29 +2983,29 @@ "id": "VolumeRestore", "properties": { "completeTime": { - "description": "Output only. [Output Only] The timestamp when the associated underlying volume restoration completed - can be converted to and from [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)", + "description": "Output only. The timestamp when the associated underlying volume restoration completed.", "format": "google-datetime", "readOnly": true, "type": "string" }, "createTime": { - "description": "Output only. [Output Only] The timestamp when this VolumeRestore resource was created - can be converted to and from [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)", + "description": "Output only. The timestamp when this VolumeRestore resource was created.", "format": "google-datetime", "readOnly": true, "type": "string" }, "etag": { - "description": "Output only. `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a volume restore from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform volume restore updates in order to avoid race conditions: An `etag` is returned in the response to `GetVolumeRestore', and systems are expected to put that etag in the request to `UpdateVolumeRestore` to ensure that their change will be applied to the same version.", + "description": "Output only. `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a volume restore from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform volume restore updates in order to avoid race conditions.", "readOnly": true, "type": "string" }, "name": { - "description": "Output only. Full name of the VolumeRestore resource. Format: projects/*/locations/*/restorePlans/*/restores/*/volumeRestores/* Note that the last segment of the name will have the format: 'pvc-'.", + "description": "Output only. Full name of the VolumeRestore resource. Format: projects/*/locations/*/restorePlans/*/restores/*/volumeRestores/*.", "readOnly": true, "type": "string" }, "state": { - "description": "Output only. The current state of this VolumeRestore", + "description": "Output only. The current state of this VolumeRestore.", "enum": [ "STATE_UNSPECIFIED", "CREATING", @@ -3036,23 +3036,23 @@ "readOnly": true }, "uid": { - "description": "Output only. [Output Only] Server generated global unique identifier of [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier) format.", + "description": "Output only. Server generated global unique identifier of [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier) format.", "readOnly": true, "type": "string" }, "updateTime": { - "description": "Output only. [Output Only] The timestamp when this VolumeRestore resource was last updated - can be converted to and from [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)", + "description": "Output only. The timestamp when this VolumeRestore resource was last updated.", "format": "google-datetime", "readOnly": true, "type": "string" }, "volumeBackup": { - "description": "Output only. The full name of the VolumeBackup from which the volume will be restored. Format: projects/*/locations/*/backupPlans/*/backups/*/volumeBackups/*", + "description": "Output only. The full name of the VolumeBackup from which the volume will be restored. Format: projects/*/locations/*/backupPlans/*/backups/*/volumeBackups/*.", "readOnly": true, "type": "string" }, "volumeHandle": { - "description": "Output only. A storage system-specific opaque handler to the underlying volume created for the target PVC from the volume backup. This field is interpreted by the volume backup and restore drivers running in the GKE cluster and not by the service.", + "description": "Output only. A storage system-specific opaque handler to the underlying volume created for the target PVC from the volume backup.", "readOnly": true, "type": "string" }, diff --git a/gkebackup/v1/gkebackup-gen.go b/gkebackup/v1/gkebackup-gen.go index 7b912df6293..1b477f65606 100644 --- a/gkebackup/v1/gkebackup-gen.go +++ b/gkebackup/v1/gkebackup-gen.go @@ -356,34 +356,31 @@ type Backup struct { // CompleteTime: Output only. Completion time of the Backup CompleteTime string `json:"completeTime,omitempty"` - // ConfigBackupSizeBytes: Output only. cluster config backup size in + // ConfigBackupSizeBytes: Output only. The size of the config backup in // bytes. ConfigBackupSizeBytes int64 `json:"configBackupSizeBytes,omitempty,string"` // ContainsSecrets: Output only. Whether or not the Backup contains - // Kubernetes Secrets. Inherited from the parent BackupPlan's - // backup_config.include_secrets. + // Kubernetes Secrets. Controlled by the parent BackupPlan's + // include_secrets value. ContainsSecrets bool `json:"containsSecrets,omitempty"` // ContainsVolumeData: Output only. Whether or not the Backup contains - // volume data. Inherited from the parent BackupPlan's - // backup_config.include_volume_data. + // volume data. Controlled by the parent BackupPlan's + // include_volume_data value. ContainsVolumeData bool `json:"containsVolumeData,omitempty"` - // CreateTime: Output only. [Output Only] The timestamp when this Backup - // resource was created - can be converted to and from RFC3339 - // (https://www.ietf.org/rfc/rfc3339.txt) + // CreateTime: Output only. The timestamp when this Backup resource was + // created. CreateTime string `json:"createTime,omitempty"` // DeleteLockDays: Minimum age for this Backup (in days). If this field // is set to a non-zero value, the Backup will be "locked" against // deletion (either manual or automatic deletion) for the number of days - // provided (measured from the creation time of the Backup). This value - // is inherited from the parent BackupPlan's - // retention_policy.backup_delete_lock_days value and may only be - // increased (either at creation time or in a subsequent update). This - // field MUST be an integer value between 0-90 (inclusive). Default: - // inherited from BackupPlan. + // provided (measured from the creation time of the Backup). MUST be an + // integer value between 0-90 (inclusive). Defaults to parent + // BackupPlan's backup_delete_lock_days setting and may only be + // increased (either at creation time or in a subsequent update). DeleteLockDays int64 `json:"deleteLockDays,omitempty"` // DeleteLockExpireTime: Output only. The time at which an existing @@ -396,7 +393,7 @@ type Backup struct { // EncryptionKey: Output only. The customer managed encryption key that // was used to encrypt the Backup's artifacts. Inherited from the parent - // BackupPlan's backup_config.encryption_key. + // BackupPlan's encryption_key value. EncryptionKey *EncryptionKey `json:"encryptionKey,omitempty"` // Etag: Output only. `etag` is used for optimistic concurrency control @@ -405,8 +402,9 @@ type Backup struct { // use of the `etag` in the read-modify-write cycle to perform backup // updates in order to avoid race conditions: An `etag` is returned in // the response to `GetBackup`, and systems are expected to put that - // etag in the request to `UpdateBackup` to ensure that their change - // will be applied to the same version. + // etag in the request to `UpdateBackup` or `DeleteBackup` to ensure + // that their change will be applied to the same version of the + // resource. Etag string `json:"etag,omitempty"` // Labels: A set of custom labels supplied by user. @@ -430,12 +428,11 @@ type Backup struct { ResourceCount int64 `json:"resourceCount,omitempty"` // RetainDays: The age (in days) after which this Backup will be - // automatically deleted. If not specified at Backup creation time, this - // value is inherited from the parent BackupPlan's - // retention_policy.backup_retain_days value. Once a Backup is created, - // this value may only be increased. This must be an integer value >= 0. - // If 0, no automatic deletion will occur for this Backup. If not 0, - // this must be >= delete_lock_days. Default: inherited from BackupPlan. + // automatically deleted. Must be an integer value >= 0: - If 0, no + // automatic deletion will occur for this Backup. - If not 0, this must + // be >= delete_lock_days. Once a Backup is created, this value may only + // be increased. Defaults to the parent BackupPlan's backup_retain_days + // value. RetainDays int64 `json:"retainDays,omitempty"` // RetainExpireTime: Output only. The time at which this Backup will be @@ -474,14 +471,12 @@ type Backup struct { // backup is in the current `state`. StateReason string `json:"stateReason,omitempty"` - // Uid: Output only. [Output Only] Server generated global unique - // identifier of UUID4 + // Uid: Output only. Server generated global unique identifier of UUID4 // (https://en.wikipedia.org/wiki/Universally_unique_identifier) Uid string `json:"uid,omitempty"` - // UpdateTime: Output only. [Output Only] The timestamp when this Backup - // resource was last updated - can be converted to and from RFC3339 - // (https://www.ietf.org/rfc/rfc3339.txt) + // UpdateTime: Output only. The timestamp when this Backup resource was + // last updated. UpdateTime string `json:"updateTime,omitempty"` // VolumeCount: Output only. The total number of volume backups @@ -522,8 +517,9 @@ type BackupConfig struct { AllNamespaces bool `json:"allNamespaces,omitempty"` // EncryptionKey: This defines a customer managed encryption key that - // will be used to encrypt the Backup artifacts for Backups created via - // this BackupPlan. + // will be used to encrypt the "config" portion (the Kubernetes + // resources) of Backups created via this plan. Default (empty): Config + // backup artifacts will not be encrypted. EncryptionKey *EncryptionKey `json:"encryptionKey,omitempty"` // IncludeSecrets: This flag specifies whether Kubernetes Secret @@ -541,7 +537,7 @@ type BackupConfig struct { SelectedApplications *NamespacedNames `json:"selectedApplications,omitempty"` // SelectedNamespaces: If set, include just the resources in the listed - // namespaces + // namespaces. SelectedNamespaces *Namespaces `json:"selectedNamespaces,omitempty"` // ForceSendFields is a list of field names (e.g. "AllNamespaces") to @@ -579,20 +575,20 @@ type BackupPlan struct { BackupSchedule *Schedule `json:"backupSchedule,omitempty"` // Cluster: Required. Immutable. The source cluster from which Backups - // will be created via this BackupPlan. Possible formats: 1. - // projects/*/locations/*/clusters/* 2. projects/*/zones/*/clusters/* + // will be created via this BackupPlan. Valid formats: - + // projects/*/locations/*/clusters/* - projects/*/zones/*/clusters/* Cluster string `json:"cluster,omitempty"` - // CreateTime: Output only. [Output Only] The timestamp when this - // BackupPlan resource was created - can be converted to and from - // RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) + // CreateTime: Output only. The timestamp when this BackupPlan resource + // was created. CreateTime string `json:"createTime,omitempty"` // Deactivated: This flag indicates whether this BackupPlan has been // deactivated. Setting this field to True locks the BackupPlan such - // that no further updates will be allowed, including the deactivated - // field. It also prevents any new Backups from being created via this - // BackupPlan (including scheduled Backups). Default: False + // that no further updates will be allowed (except deletes), including + // the deactivated field itself. It also prevents any new Backups from + // being created via this BackupPlan (including scheduled Backups). + // Default: False Deactivated bool `json:"deactivated,omitempty"` // Description: User specified descriptive string for this BackupPlan. @@ -604,34 +600,32 @@ type BackupPlan struct { // use of the 'etag' in the read-modify-write cycle to perform // BackupPlan updates in order to avoid race conditions: An `etag` is // returned in the response to `GetBackupPlan`, and systems are expected - // to put that etag in the request to `UpdateBackupPlan` to ensure that - // their change will be applied to the same version. + // to put that etag in the request to `UpdateBackupPlan` or + // `DeleteBackupPlan` to ensure that their change will be applied to the + // same version of the resource. Etag string `json:"etag,omitempty"` // Labels: A set of custom labels supplied by user. Labels map[string]string `json:"labels,omitempty"` - // Name: Output only. [Output Only] The full name of the BackupPlan - // resource. Format: projects/*/locations/*/backupPlans/* + // Name: Output only. The full name of the BackupPlan resource. Format: + // projects/*/locations/*/backupPlans/* Name string `json:"name,omitempty"` - // ProtectedPodCount: Output only. [Output Only] Represents the number - // of Kubernetes Pods backed up in the last successful Backup created - // underneath this BackupPlan. + // ProtectedPodCount: Output only. The number of Kubernetes Pods backed + // up in the last successful Backup created via this BackupPlan. ProtectedPodCount int64 `json:"protectedPodCount,omitempty"` // RetentionPolicy: RetentionPolicy governs lifecycle of Backups created // under this plan. RetentionPolicy *RetentionPolicy `json:"retentionPolicy,omitempty"` - // Uid: Output only. [Output Only] Server generated global unique - // identifier of UUID + // Uid: Output only. Server generated global unique identifier of UUID // (https://en.wikipedia.org/wiki/Universally_unique_identifier) format. Uid string `json:"uid,omitempty"` - // UpdateTime: Output only. [Output Only] The timestamp when this - // BackupPlan resource was last updated - can be converted to and from - // RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) + // UpdateTime: Output only. The timestamp when this BackupPlan resource + // was last updated. UpdateTime string `json:"updateTime,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -744,10 +738,10 @@ type ClusterMetadata struct { // the cluster. BackupCrdVersions map[string]string `json:"backupCrdVersions,omitempty"` - // Cluster: The source cluster from which this Backup was created. - // Possible formats: 1. projects/*/locations/*/clusters/* 2. - // projects/*/zones/*/clusters/* This will be the same value as the - // parent BackupPlan's cluster field. + // Cluster: The source cluster from which this Backup was created. Valid + // formats: - projects/*/locations/*/clusters/* - + // projects/*/zones/*/clusters/* This is inherited from the parent + // BackupPlan's cluster field. Cluster string `json:"cluster,omitempty"` // GkeVersion: GKE version @@ -828,7 +822,7 @@ type Empty struct { // used to encrypt Backup artifacts. type EncryptionKey struct { // GcpKmsEncryptionKey: Google Cloud KMS encryption key. Format: - // projects//locations//keyRings//cryptoKeys/ + // projects/*/locations/*/keyRings/*/cryptoKeys/* GcpKmsEncryptionKey string `json:"gcpKmsEncryptionKey,omitempty"` // ForceSendFields is a list of field names (e.g. "GcpKmsEncryptionKey") @@ -1102,10 +1096,10 @@ func (s *GroupKind) MarshalJSON() ([]byte, error) { // ListBackupPlansResponse: Response message for ListBackupPlans. type ListBackupPlansResponse struct { - // BackupPlans: The list of BackupPlans. + // BackupPlans: The list of BackupPlans matching the given criteria. BackupPlans []*BackupPlan `json:"backupPlans,omitempty"` - // NextPageToken: A token which may be sent as `page_token` in a + // NextPageToken: A token which may be sent as page_token in a // subsequent `ListBackupPlans` call to retrieve the next page of // results. If this field is omitted or empty, then there are no more // results to return. @@ -1143,10 +1137,10 @@ func (s *ListBackupPlansResponse) MarshalJSON() ([]byte, error) { // ListBackupsResponse: Response message for ListBackups. type ListBackupsResponse struct { - // Backups: The list of restore resources within the parent. + // Backups: The list of Backups matching the given criteria. Backups []*Backup `json:"backups,omitempty"` - // NextPageToken: A token which may be sent as `page_token` in a + // NextPageToken: A token which may be sent as page_token in a // subsequent `ListBackups` call to retrieve the next page of results. // If this field is omitted or empty, then there are no more results to // return. @@ -1218,13 +1212,13 @@ func (s *ListLocationsResponse) MarshalJSON() ([]byte, error) { // ListRestorePlansResponse: Response message for ListRestorePlans. type ListRestorePlansResponse struct { - // NextPageToken: A token which may be sent as `page_token` in a + // NextPageToken: A token which may be sent as page_token in a // subsequent `ListRestorePlans` call to retrieve the next page of // results. If this field is omitted or empty, then there are no more // results to return. NextPageToken string `json:"nextPageToken,omitempty"` - // RestorePlans: The list of RestorePlans. + // RestorePlans: The list of RestorePlans matching the given criteria. RestorePlans []*RestorePlan `json:"restorePlans,omitempty"` // Unreachable: Locations that could not be reached. @@ -1259,13 +1253,13 @@ func (s *ListRestorePlansResponse) MarshalJSON() ([]byte, error) { // ListRestoresResponse: Response message for ListRestores. type ListRestoresResponse struct { - // NextPageToken: A token which may be sent as `page_token` in a + // NextPageToken: A token which may be sent as page_token in a // subsequent `ListRestores` call to retrieve the next page of results. // If this field is omitted or empty, then there are no more results to // return. NextPageToken string `json:"nextPageToken,omitempty"` - // Restores: The list of restore resources within the parent. + // Restores: The list of Restores matching the given criteria. Restores []*Restore `json:"restores,omitempty"` // Unreachable: Locations that could not be reached. @@ -1300,13 +1294,13 @@ func (s *ListRestoresResponse) MarshalJSON() ([]byte, error) { // ListVolumeBackupsResponse: Response message for ListVolumeBackups. type ListVolumeBackupsResponse struct { - // NextPageToken: A token which may be sent as `page_token` in a + // NextPageToken: A token which may be sent as page_token in a // subsequent `ListVolumeBackups` call to retrieve the next page of // results. If this field is omitted or empty, then there are no more // results to return. NextPageToken string `json:"nextPageToken,omitempty"` - // VolumeBackups: The list of VolumeBackups resources within the parent. + // VolumeBackups: The list of VolumeBackups matching the given criteria. VolumeBackups []*VolumeBackup `json:"volumeBackups,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1338,14 +1332,14 @@ func (s *ListVolumeBackupsResponse) MarshalJSON() ([]byte, error) { // ListVolumeRestoresResponse: Response message for ListVolumeRestores. type ListVolumeRestoresResponse struct { - // NextPageToken: A token which may be sent as `page_token` in a + // NextPageToken: A token which may be sent as page_token in a // subsequent `ListVolumeRestores` call to retrieve the next page of // results. If this field is omitted or empty, then there are no more // results to return. NextPageToken string `json:"nextPageToken,omitempty"` - // VolumeRestores: The list of VolumeRestores resources within the - // parent. + // VolumeRestores: The list of VolumeRestores matching the given + // criteria. VolumeRestores []*VolumeRestore `json:"volumeRestores,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1679,25 +1673,24 @@ func (s *Policy) MarshalJSON() ([]byte, error) { // Backup into a target GKE cluster and a record of the restore // operation itself. Next id: 18 type Restore struct { - // Backup: Required. Immutable. The Backup used as the source from which - // this Restore will restore. Note that this Backup must be a - // sub-resource of the RestorePlan's backup_plan. Format: + // Backup: Required. Immutable. A reference to the Backup used as the + // source from which this Restore will restore. Note that this Backup + // must be a sub-resource of the RestorePlan's backup_plan. Format: // projects/*/locations/*/backupPlans/*/backups/*. Backup string `json:"backup,omitempty"` // Cluster: Output only. The target cluster into which this Restore will - // restore data. Possible formats: 1. projects/*/locations/*/clusters/* - // 2. projects/*/zones/*/clusters/* Inherited from parent RestorePlan's - // cluster field. + // restore data. Valid formats: - projects/*/locations/*/clusters/* - + // projects/*/zones/*/clusters/* Inherited from parent RestorePlan's + // cluster value. Cluster string `json:"cluster,omitempty"` - // CompleteTime: Output only. When the restore operation either - // successfully completed or failed. + // CompleteTime: Output only. Timestamp of when the restore operation + // completed. CompleteTime string `json:"completeTime,omitempty"` - // CreateTime: Output only. [Output Only] The timestamp when this - // Restore resource was created - can be converted to and from RFC3339 - // (https://www.ietf.org/rfc/rfc3339.txt) + // CreateTime: Output only. The timestamp when this Restore resource was + // created. CreateTime string `json:"createTime,omitempty"` // Description: User specified descriptive string for this Restore. @@ -1709,27 +1702,28 @@ type Restore struct { // use of the `etag` in the read-modify-write cycle to perform restore // updates in order to avoid race conditions: An `etag` is returned in // the response to `GetRestore`, and systems are expected to put that - // etag in the request to `UpdateRestore` to ensure that their change - // will be applied to the same version. + // etag in the request to `UpdateRestore` or `DeleteRestore` to ensure + // that their change will be applied to the same version of the + // resource. Etag string `json:"etag,omitempty"` - // Labels: GCP Labels. + // Labels: A set of custom labels supplied by user. Labels map[string]string `json:"labels,omitempty"` // Name: Output only. The full name of the Restore resource. Format: // projects/*/locations/*/restorePlans/*/restores/* Name string `json:"name,omitempty"` - // ResourcesExcludedCount: Output only. Number of resources excluded in - // this restore action. + // ResourcesExcludedCount: Output only. Number of resources excluded + // during the restore execution. ResourcesExcludedCount int64 `json:"resourcesExcludedCount,omitempty"` - // ResourcesFailedCount: Output only. Number of resources failed to be - // restored in this restore action. + // ResourcesFailedCount: Output only. Number of resources that failed to + // be restored during the restore execution. ResourcesFailedCount int64 `json:"resourcesFailedCount,omitempty"` - // ResourcesRestoredCount: Output only. Number of resources restored in - // this restore action. + // ResourcesRestoredCount: Output only. Number of resources restored + // during the restore execution. ResourcesRestoredCount int64 `json:"resourcesRestoredCount,omitempty"` // RestoreConfig: Output only. Configuration of the Restore. Inherited @@ -1757,18 +1751,16 @@ type Restore struct { // Restore is in its current state. StateReason string `json:"stateReason,omitempty"` - // Uid: Output only. [Output Only] Server generated global unique - // identifier of UUID + // Uid: Output only. Server generated global unique identifier of UUID // (https://en.wikipedia.org/wiki/Universally_unique_identifier) format. Uid string `json:"uid,omitempty"` - // UpdateTime: Output only. [Output Only] The timestamp when this - // Restore resource was last updated - can be converted to and from - // RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) + // UpdateTime: Output only. The timestamp when this Restore resource was + // last updated. UpdateTime string `json:"updateTime,omitempty"` - // VolumesRestoredCount: Output only. Number of volumes restored in this - // restore action. + // VolumesRestoredCount: Output only. Number of volumes restored during + // the restore execution. VolumesRestoredCount int64 `json:"volumesRestoredCount,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1830,12 +1822,11 @@ type RestoreConfig struct { // NamespacedResourceRestoreMode: Defines the behavior for handling the // situation where sets of namespaced resources being restored already // exist in the target cluster. This MUST be set to a value other than - // NAMESPACED_RESOURCE_RESTORE_MODE_UNSPECIFIED if any namespaced - // restoration is configured via namespaced_resource_restore_scope . + // NAMESPACED_RESOURCE_RESTORE_MODE_UNSPECIFIED. // // Possible values: - // "NAMESPACED_RESOURCE_RESTORE_MODE_UNSPECIFIED" - Unspecified. Only - // allowed if no namespaced resources will be restored. + // "NAMESPACED_RESOURCE_RESTORE_MODE_UNSPECIFIED" - Unspecified + // (invalid). // "DELETE_AND_RESTORE" - When conflicting top-level resources (either // Namespaces or ProtectedApplications, depending upon the scope) are // encountered, this will first trigger a delete of the conflicting @@ -1874,8 +1865,7 @@ type RestoreConfig struct { // (will be treated as NO_VOLUME_DATA_RESTORATION). // // Possible values: - // "VOLUME_DATA_RESTORE_POLICY_UNSPECIFIED" - unspecified, default - // value + // "VOLUME_DATA_RESTORE_POLICY_UNSPECIFIED" - Unspecified (illegal). // "RESTORE_VOLUME_DATA_FROM_BACKUP" - For each PVC to be restored, // will create a new underlying volume (and PV) from the corresponding // VolumeBackup contained within the Backup. @@ -1917,20 +1907,19 @@ func (s *RestoreConfig) MarshalJSON() ([]byte, error) { // operations to be performed against Backups belong to a particular // BackupPlan. Next id: 11 type RestorePlan struct { - // BackupPlan: Required. Immutable. The BackupPlan from which Backups - // may be used as the source for Restores created via this RestorePlan. - // Format: projects/*/locations/*/backupPlans/*. + // BackupPlan: Required. Immutable. A reference to the BackupPlan from + // which Backups may be used as the source for Restores created via this + // RestorePlan. Format: projects/*/locations/*/backupPlans/*. BackupPlan string `json:"backupPlan,omitempty"` // Cluster: Required. Immutable. The target cluster into which Restores // created via this RestorePlan will restore data. NOTE: the cluster's - // region must be the same as the RestorePlan. Possible formats: 1. - // projects/*/locations/*/clusters/* 2. projects/*/zones/*/clusters/* + // region must be the same as the RestorePlan. Valid formats: - + // projects/*/locations/*/clusters/* - projects/*/zones/*/clusters/* Cluster string `json:"cluster,omitempty"` - // CreateTime: Output only. [Output Only] The timestamp when this - // RestorePlan resource was created - can be converted to and from - // RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) + // CreateTime: Output only. The timestamp when this RestorePlan resource + // was created. CreateTime string `json:"createTime,omitempty"` // Description: User specified descriptive string for this RestorePlan. @@ -1942,29 +1931,28 @@ type RestorePlan struct { // use of the `etag` in the read-modify-write cycle to perform restore // updates in order to avoid race conditions: An `etag` is returned in // the response to `GetRestorePlan`, and systems are expected to put - // that etag in the request to `UpdateRestorePlan` to ensure that their - // change will be applied to the same version. + // that etag in the request to `UpdateRestorePlan` or + // `DeleteRestorePlan` to ensure that their change will be applied to + // the same version of the resource. Etag string `json:"etag,omitempty"` // Labels: A set of custom labels supplied by user. Labels map[string]string `json:"labels,omitempty"` - // Name: Output only. [Output Only] The full name of the RestorePlan - // resource. Format: projects/*/locations/*/restorePlans/* + // Name: Output only. The full name of the RestorePlan resource. Format: + // projects/*/locations/*/restorePlans/*. Name string `json:"name,omitempty"` // RestoreConfig: Required. Configuration of Restores created via this // RestorePlan. RestoreConfig *RestoreConfig `json:"restoreConfig,omitempty"` - // Uid: Output only. [Output Only] Server generated global unique - // identifier of UUID + // Uid: Output only. Server generated global unique identifier of UUID // (https://en.wikipedia.org/wiki/Universally_unique_identifier) format. Uid string `json:"uid,omitempty"` - // UpdateTime: Output only. [Output Only] The timestamp when this - // RestorePlan resource was last updated - can be converted to and from - // RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) + // UpdateTime: Output only. The timestamp when this RestorePlan resource + // was last updated. UpdateTime string `json:"updateTime,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1994,34 +1982,29 @@ func (s *RestorePlan) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// RetentionPolicy: RentionPolicy is an inner message type to define: 1. -// Minimum age for Backups created via this BackupPlan - deletion -// (either manual or automatic) of Backups younger than this age will be -// blocked 2. Default maximum age of Backups created via this -// BackupPlan, after which automatic deletion will occur 3. Lock to -// disallow any changes to any RetentionPolicy settings +// RetentionPolicy: RetentionPolicy defines a Backup retention policy +// for a BackupPlan. type RetentionPolicy struct { // BackupDeleteLockDays: Minimum age for Backups created via this // BackupPlan (in days). This field MUST be an integer value between - // 0-90(inclusive). A Backup created under this BackupPlan will NOT be - // deletable until it reaches Backup's create_time + - // backup_delete_lock_days. Updating this field of a BackupPlan does NOT - // affect existing Backups under it. Backups created AFTER a successful - // update will inherit the new value. Default: 0 (no delete blocking) + // 0-90 (inclusive). A Backup created under this BackupPlan will NOT be + // deletable until it reaches Backup's (create_time + + // backup_delete_lock_days). Updating this field of a BackupPlan does + // NOT affect existing Backups under it. Backups created AFTER a + // successful update will inherit the new value. Default: 0 (no delete + // blocking) BackupDeleteLockDays int64 `json:"backupDeleteLockDays,omitempty"` // BackupRetainDays: The default maximum age of a Backup created via // this BackupPlan. This field MUST be an integer value >= 0. If // specified, a Backup created under this BackupPlan will be - // automatically deleted after its age reaches create_time + - // backup_retain_days. If not specified, Backups created under this + // automatically deleted after its age reaches (create_time + + // backup_retain_days). If not specified, Backups created under this // BackupPlan will NOT be subject to automatic deletion. Updating this // field does NOT affect existing Backups under it. Backups created // AFTER a successful update will automatically pick up the new value. - // NOTE: Specifying a backup_retain_days smaller than - // backup_delete_lock_days at creation/updating time will be considered - // as invalid, and the request will be rejected immediately. Default: 0 - // (no automatic deletion) + // NOTE: backup_retain_days must be >= backup_delete_lock_days. Default: + // 0 (no automatic deletion) BackupRetainDays int64 `json:"backupRetainDays,omitempty"` // Locked: This flag denotes whether the retention policy of this @@ -2057,8 +2040,10 @@ func (s *RetentionPolicy) MarshalJSON() ([]byte, error) { // Schedule: Schedule defines scheduling parameters for automatically // creating Backups via this BackupPlan. type Schedule struct { - // CronSchedule: A standard cron-style string that defines a repeating - // schedule for creating Backups via this BackupPlan. + // CronSchedule: A standard cron (https://wikipedia.com/wiki/cron) + // string that defines a repeating schedule for creating Backups via + // this BackupPlan. Default (empty): no automatic backup creation will + // occur. CronSchedule string `json:"cronSchedule,omitempty"` // Paused: This flag denotes whether automatic Backup creation is paused @@ -2265,14 +2250,12 @@ func (s *TestIamPermissionsResponse) MarshalJSON() ([]byte, error) { // as a component of a Backup - both the record of the operation and a // pointer to the underlying storage-specific artifacts. Next id: 14 type VolumeBackup struct { - // CompleteTime: Output only. [Output Only] The timestamp when the - // associated underlying volume backup operation completes - can be - // converted to and from RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) + // CompleteTime: Output only. The timestamp when the associated + // underlying volume backup operation completed. CompleteTime string `json:"completeTime,omitempty"` - // CreateTime: Output only. [Output Only] The timestamp when this - // VolumeBackup resource was created - can be converted to and from - // RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) + // CreateTime: Output only. The timestamp when this VolumeBackup + // resource was created. CreateTime string `json:"createTime,omitempty"` // DiskSizeBytes: Output only. The minimum size of the disk to which @@ -2283,10 +2266,7 @@ type VolumeBackup struct { // as a way to help prevent simultaneous updates of a volume backup from // overwriting each other. It is strongly suggested that systems make // use of the `etag` in the read-modify-write cycle to perform volume - // backup updates in order to avoid race conditions: An `etag` is - // returned in the response to `GetVolumeBackup', and systems are - // expected to put that etag in the request to `UpdateVolumeBackup` to - // ensure that their change will be applied to the same version. + // backup updates in order to avoid race conditions. Etag string `json:"etag,omitempty"` // Format: Output only. The format used for the volume backup. @@ -2297,10 +2277,9 @@ type VolumeBackup struct { // based volume backup. Format string `json:"format,omitempty"` - // Name: Output only. [Output Only] The full name of the VolumeBackup - // resource. Format: - // projects/*/locations/*/backupPlans/*/backups/*/volumeBackups/* Note - // that the last segment of the name will have the format: 'pvc-'. + // Name: Output only. The full name of the VolumeBackup resource. + // Format: + // projects/*/locations/*/backupPlans/*/backups/*/volumeBackups/*. Name string `json:"name,omitempty"` // SourcePvc: Output only. A reference to the source Kubernetes PVC from @@ -2339,20 +2318,16 @@ type VolumeBackup struct { // volume is deleted. StorageBytes int64 `json:"storageBytes,omitempty,string"` - // Uid: Output only. [Output Only] Server generated global unique - // identifier of UUID + // Uid: Output only. Server generated global unique identifier of UUID // (https://en.wikipedia.org/wiki/Universally_unique_identifier) format. Uid string `json:"uid,omitempty"` - // UpdateTime: Output only. [Output Only] The timestamp when this - // VolumeBackup resource was last updated - can be converted to and from - // RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) + // UpdateTime: Output only. The timestamp when this VolumeBackup + // resource was last updated. UpdateTime string `json:"updateTime,omitempty"` // VolumeBackupHandle: Output only. A storage system-specific opaque - // handle to the underlying volume backup. This field is interpreted by - // the volume backup and restore drivers running in the GKE cluster and - // not by the service. + // handle to the underlying volume backup. VolumeBackupHandle string `json:"volumeBackupHandle,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2385,32 +2360,26 @@ func (s *VolumeBackup) MarshalJSON() ([]byte, error) { // VolumeRestore: Represents the operation of restoring a volume from a // VolumeBackup. Next id: 13 type VolumeRestore struct { - // CompleteTime: Output only. [Output Only] The timestamp when the - // associated underlying volume restoration completed - can be converted - // to and from RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) + // CompleteTime: Output only. The timestamp when the associated + // underlying volume restoration completed. CompleteTime string `json:"completeTime,omitempty"` - // CreateTime: Output only. [Output Only] The timestamp when this - // VolumeRestore resource was created - can be converted to and from - // RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) + // CreateTime: Output only. The timestamp when this VolumeRestore + // resource was created. CreateTime string `json:"createTime,omitempty"` // Etag: Output only. `etag` is used for optimistic concurrency control // as a way to help prevent simultaneous updates of a volume restore // from overwriting each other. It is strongly suggested that systems // make use of the `etag` in the read-modify-write cycle to perform - // volume restore updates in order to avoid race conditions: An `etag` - // is returned in the response to `GetVolumeRestore', and systems are - // expected to put that etag in the request to `UpdateVolumeRestore` to - // ensure that their change will be applied to the same version. + // volume restore updates in order to avoid race conditions. Etag string `json:"etag,omitempty"` // Name: Output only. Full name of the VolumeRestore resource. Format: - // projects/*/locations/*/restorePlans/*/restores/*/volumeRestores/* - // Note that the last segment of the name will have the format: 'pvc-'. + // projects/*/locations/*/restorePlans/*/restores/*/volumeRestores/*. Name string `json:"name,omitempty"` - // State: Output only. The current state of this VolumeRestore + // State: Output only. The current state of this VolumeRestore. // // Possible values: // "STATE_UNSPECIFIED" - This is an illegal state and should not be @@ -2432,25 +2401,22 @@ type VolumeRestore struct { // be restored. TargetPvc *NamespacedName `json:"targetPvc,omitempty"` - // Uid: Output only. [Output Only] Server generated global unique - // identifier of UUID + // Uid: Output only. Server generated global unique identifier of UUID // (https://en.wikipedia.org/wiki/Universally_unique_identifier) format. Uid string `json:"uid,omitempty"` - // UpdateTime: Output only. [Output Only] The timestamp when this - // VolumeRestore resource was last updated - can be converted to and - // from RFC3339 (https://www.ietf.org/rfc/rfc3339.txt) + // UpdateTime: Output only. The timestamp when this VolumeRestore + // resource was last updated. UpdateTime string `json:"updateTime,omitempty"` // VolumeBackup: Output only. The full name of the VolumeBackup from // which the volume will be restored. Format: - // projects/*/locations/*/backupPlans/*/backups/*/volumeBackups/* + // projects/*/locations/*/backupPlans/*/backups/*/volumeBackups/*. VolumeBackup string `json:"volumeBackup,omitempty"` // VolumeHandle: Output only. A storage system-specific opaque handler // to the underlying volume created for the target PVC from the volume - // backup. This field is interpreted by the volume backup and restore - // drivers running in the GKE cluster and not by the service. + // backup. VolumeHandle string `json:"volumeHandle,omitempty"` // VolumeType: Output only. The type of volume provisioned @@ -2991,7 +2957,7 @@ type ProjectsLocationsBackupPlansCreateCall struct { // Create: Creates a new BackupPlan in a given location. // // - parent: The location within which to create the BackupPlan. Format: -// projects/{project}/locations/{location}. +// projects/*/locations/*. func (r *ProjectsLocationsBackupPlansService) Create(parent string, backupplan *BackupPlan) *ProjectsLocationsBackupPlansCreateCall { c := &ProjectsLocationsBackupPlansCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -3001,9 +2967,9 @@ func (r *ProjectsLocationsBackupPlansService) Create(parent string, backupplan * // BackupPlanId sets the optional parameter "backupPlanId": Required. // The client-provided short name for the BackupPlan resource. This name -// must: a. be between 1 and 63 characters long (inclusive) b. consist -// of only lower-case ASCII letters, numbers, and dashes c. start with a -// lower-case letter d. end with a lower-case letter or number e. be +// must: - be between 1 and 63 characters long (inclusive) - consist of +// only lower-case ASCII letters, numbers, and dashes - start with a +// lower-case letter - end with a lower-case letter or number - be // unique within the set of BackupPlans in this location func (c *ProjectsLocationsBackupPlansCreateCall) BackupPlanId(backupPlanId string) *ProjectsLocationsBackupPlansCreateCall { c.urlParams_.Set("backupPlanId", backupPlanId) @@ -3110,12 +3076,12 @@ func (c *ProjectsLocationsBackupPlansCreateCall) Do(opts ...googleapi.CallOption // ], // "parameters": { // "backupPlanId": { - // "description": "Required. The client-provided short name for the BackupPlan resource. This name must: a. be between 1 and 63 characters long (inclusive) b. consist of only lower-case ASCII letters, numbers, and dashes c. start with a lower-case letter d. end with a lower-case letter or number e. be unique within the set of BackupPlans in this location", + // "description": "Required. The client-provided short name for the BackupPlan resource. This name must: - be between 1 and 63 characters long (inclusive) - consist of only lower-case ASCII letters, numbers, and dashes - start with a lower-case letter - end with a lower-case letter or number - be unique within the set of BackupPlans in this location", // "location": "query", // "type": "string" // }, // "parent": { - // "description": "Required. The location within which to create the BackupPlan. Format: projects/{project}/locations/{location}", + // "description": "Required. The location within which to create the BackupPlan. Format: projects/*/locations/*", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+$", // "required": true, @@ -3149,7 +3115,7 @@ type ProjectsLocationsBackupPlansDeleteCall struct { // Delete: Deletes an existing BackupPlan. // // - name: Fully qualified BackupPlan name. Format: -// projects/{project}/locations/{location}/backupPlans/{backup_plan}. +// projects/*/locations/*/backupPlans/*. func (r *ProjectsLocationsBackupPlansService) Delete(name string) *ProjectsLocationsBackupPlansDeleteCall { c := &ProjectsLocationsBackupPlansDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -3157,7 +3123,8 @@ func (r *ProjectsLocationsBackupPlansService) Delete(name string) *ProjectsLocat } // Etag sets the optional parameter "etag": If provided, this value must -// match the value currently assigned to the target resource. +// match the current value of the target BackupPlan's etag field or the +// request is rejected. func (c *ProjectsLocationsBackupPlansDeleteCall) Etag(etag string) *ProjectsLocationsBackupPlansDeleteCall { c.urlParams_.Set("etag", etag) return c @@ -3258,12 +3225,12 @@ func (c *ProjectsLocationsBackupPlansDeleteCall) Do(opts ...googleapi.CallOption // ], // "parameters": { // "etag": { - // "description": "If provided, this value must match the value currently assigned to the target resource.", + // "description": "If provided, this value must match the current value of the target BackupPlan's etag field or the request is rejected.", // "location": "query", // "type": "string" // }, // "name": { - // "description": "Required. Fully qualified BackupPlan name. Format: projects/{project}/locations/{location}/backupPlans/{backup_plan}", + // "description": "Required. Fully qualified BackupPlan name. Format: projects/*/locations/*/backupPlans/*", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+$", // "required": true, @@ -3295,7 +3262,7 @@ type ProjectsLocationsBackupPlansGetCall struct { // Get: Retrieve the details of a single BackupPlan. // // - name: Fully qualified BackupPlan name. Format: -// projects/{project}/locations/{location}/backupPlans/{backup_plan}. +// projects/*/locations/*/backupPlans/*. func (r *ProjectsLocationsBackupPlansService) Get(name string) *ProjectsLocationsBackupPlansGetCall { c := &ProjectsLocationsBackupPlansGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -3410,7 +3377,7 @@ func (c *ProjectsLocationsBackupPlansGetCall) Do(opts ...googleapi.CallOption) ( // ], // "parameters": { // "name": { - // "description": "Required. Fully qualified BackupPlan name. Format: projects/{project}/locations/{location}/backupPlans/{backup_plan}", + // "description": "Required. Fully qualified BackupPlan name. Format: projects/*/locations/*/backupPlans/*", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+$", // "required": true, @@ -3616,20 +3583,22 @@ type ProjectsLocationsBackupPlansListCall struct { // List: Lists BackupPlans in a given location. // // - parent: The location that contains the BackupPlans to list. Format: -// projects/{project}/locations/{location}. +// projects/*/locations/*. func (r *ProjectsLocationsBackupPlansService) List(parent string) *ProjectsLocationsBackupPlansListCall { c := &ProjectsLocationsBackupPlansListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent return c } -// Filter sets the optional parameter "filter": List filter. +// Filter sets the optional parameter "filter": Field match expression +// used to filter the results. func (c *ProjectsLocationsBackupPlansListCall) Filter(filter string) *ProjectsLocationsBackupPlansListCall { c.urlParams_.Set("filter", filter) return c } -// OrderBy sets the optional parameter "orderBy": Sort results. +// OrderBy sets the optional parameter "orderBy": Field by which to sort +// the results. func (c *ProjectsLocationsBackupPlansListCall) OrderBy(orderBy string) *ProjectsLocationsBackupPlansListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -3764,12 +3733,12 @@ func (c *ProjectsLocationsBackupPlansListCall) Do(opts ...googleapi.CallOption) // ], // "parameters": { // "filter": { - // "description": "List filter.", + // "description": "Field match expression used to filter the results.", // "location": "query", // "type": "string" // }, // "orderBy": { - // "description": "Sort results.", + // "description": "Field by which to sort the results.", // "location": "query", // "type": "string" // }, @@ -3785,7 +3754,7 @@ func (c *ProjectsLocationsBackupPlansListCall) Do(opts ...googleapi.CallOption) // "type": "string" // }, // "parent": { - // "description": "Required. The location that contains the BackupPlans to list. Format: projects/{project}/locations/{location}", + // "description": "Required. The location that contains the BackupPlans to list. Format: projects/*/locations/*", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+$", // "required": true, @@ -3837,8 +3806,8 @@ type ProjectsLocationsBackupPlansPatchCall struct { // Patch: Update a BackupPlan. // -// - name: Output only. [Output Only] The full name of the BackupPlan -// resource. Format: projects/*/locations/*/backupPlans/*. +// - name: Output only. The full name of the BackupPlan resource. +// Format: projects/*/locations/*/backupPlans/*. func (r *ProjectsLocationsBackupPlansService) Patch(name string, backupplan *BackupPlan) *ProjectsLocationsBackupPlansPatchCall { c := &ProjectsLocationsBackupPlansPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -3961,7 +3930,7 @@ func (c *ProjectsLocationsBackupPlansPatchCall) Do(opts ...googleapi.CallOption) // ], // "parameters": { // "name": { - // "description": "Output only. [Output Only] The full name of the BackupPlan resource. Format: projects/*/locations/*/backupPlans/*", + // "description": "Output only. The full name of the BackupPlan resource. Format: projects/*/locations/*/backupPlans/*", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+$", // "required": true, @@ -4297,7 +4266,7 @@ type ProjectsLocationsBackupPlansBackupsCreateCall struct { // Create: Creates a Backup for the given BackupPlan. // // - parent: The BackupPlan within which to create the Backup. Format: -// projects/{project}/locations/{location}/backupPlans/{backup_plan}. +// projects/*/locations/*/backupPlans/*. func (r *ProjectsLocationsBackupPlansBackupsService) Create(parent string, backup *Backup) *ProjectsLocationsBackupPlansBackupsCreateCall { c := &ProjectsLocationsBackupPlansBackupsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -4306,11 +4275,11 @@ func (r *ProjectsLocationsBackupPlansBackupsService) Create(parent string, backu } // BackupId sets the optional parameter "backupId": The client-provided -// short name for the Backup resource. This name must: a. be between 1 -// and 63 characters long (inclusive) b. consist of only lower-case -// ASCII letters, numbers, and dashes c. start with a lower-case letter -// d. end with a lower-case letter or number e. be unique within the set -// of Backups in this BackupPlan +// short name for the Backup resource. This name must: - be between 1 +// and 63 characters long (inclusive) - consist of only lower-case ASCII +// letters, numbers, and dashes - start with a lower-case letter - end +// with a lower-case letter or number - be unique within the set of +// Backups in this BackupPlan func (c *ProjectsLocationsBackupPlansBackupsCreateCall) BackupId(backupId string) *ProjectsLocationsBackupPlansBackupsCreateCall { c.urlParams_.Set("backupId", backupId) return c @@ -4416,12 +4385,12 @@ func (c *ProjectsLocationsBackupPlansBackupsCreateCall) Do(opts ...googleapi.Cal // ], // "parameters": { // "backupId": { - // "description": "The client-provided short name for the Backup resource. This name must: a. be between 1 and 63 characters long (inclusive) b. consist of only lower-case ASCII letters, numbers, and dashes c. start with a lower-case letter d. end with a lower-case letter or number e. be unique within the set of Backups in this BackupPlan", + // "description": "The client-provided short name for the Backup resource. This name must: - be between 1 and 63 characters long (inclusive) - consist of only lower-case ASCII letters, numbers, and dashes - start with a lower-case letter - end with a lower-case letter or number - be unique within the set of Backups in this BackupPlan", // "location": "query", // "type": "string" // }, // "parent": { - // "description": "Required. The BackupPlan within which to create the Backup. Format: projects/{project}/locations/{location}/backupPlans/{backup_plan}", + // "description": "Required. The BackupPlan within which to create the Backup. Format: projects/*/locations/*/backupPlans/*", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+$", // "required": true, @@ -4455,24 +4424,24 @@ type ProjectsLocationsBackupPlansBackupsDeleteCall struct { // Delete: Deletes an existing Backup. // // - name: Name of the Backup resource. Format: -// projects/{project}/locations/{location}/backupPlans/{backup_plan}/ba -// ckups/{backup}. +// projects/*/locations/*/backupPlans/*/backups/*. func (r *ProjectsLocationsBackupPlansBackupsService) Delete(name string) *ProjectsLocationsBackupPlansBackupsDeleteCall { c := &ProjectsLocationsBackupPlansBackupsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } -// Etag sets the optional parameter "etag": etag, if provided, it must -// match the server's etag for the delete to happen. +// Etag sets the optional parameter "etag": If provided, this value must +// match the current value of the target Backup's etag field or the +// request is rejected. func (c *ProjectsLocationsBackupPlansBackupsDeleteCall) Etag(etag string) *ProjectsLocationsBackupPlansBackupsDeleteCall { c.urlParams_.Set("etag", etag) return c } // Force sets the optional parameter "force": If set to true, any -// volumeBackups below this backup will also be deleted. Otherwise, the -// request will only succeed if the backup has no volumeBackups. +// VolumeBackups below this Backup will also be deleted. Otherwise, the +// request will only succeed if the Backup has no VolumeBackups. func (c *ProjectsLocationsBackupPlansBackupsDeleteCall) Force(force bool) *ProjectsLocationsBackupPlansBackupsDeleteCall { c.urlParams_.Set("force", fmt.Sprint(force)) return c @@ -4573,17 +4542,17 @@ func (c *ProjectsLocationsBackupPlansBackupsDeleteCall) Do(opts ...googleapi.Cal // ], // "parameters": { // "etag": { - // "description": "etag, if provided, it must match the server's etag for the delete to happen.", + // "description": "If provided, this value must match the current value of the target Backup's etag field or the request is rejected.", // "location": "query", // "type": "string" // }, // "force": { - // "description": "If set to true, any volumeBackups below this backup will also be deleted. Otherwise, the request will only succeed if the backup has no volumeBackups.", + // "description": "If set to true, any VolumeBackups below this Backup will also be deleted. Otherwise, the request will only succeed if the Backup has no VolumeBackups.", // "location": "query", // "type": "boolean" // }, // "name": { - // "description": "Required. Name of the Backup resource. Format: projects/{project}/locations/{location}/backupPlans/{backup_plan}/backups/{backup}", + // "description": "Required. Name of the Backup resource. Format: projects/*/locations/*/backupPlans/*/backups/*", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+/backups/[^/]+$", // "required": true, @@ -4615,8 +4584,7 @@ type ProjectsLocationsBackupPlansBackupsGetCall struct { // Get: Retrieve the details of a single Backup. // // - name: Full name of the Backup resource. Format: -// projects/{project}/locations/{location}/backupPlans/{backup_plan}/ba -// ckups/{backup}. +// projects/*/locations/*/backupPlans/*/backups/*. func (r *ProjectsLocationsBackupPlansBackupsService) Get(name string) *ProjectsLocationsBackupPlansBackupsGetCall { c := &ProjectsLocationsBackupPlansBackupsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -4731,7 +4699,7 @@ func (c *ProjectsLocationsBackupPlansBackupsGetCall) Do(opts ...googleapi.CallOp // ], // "parameters": { // "name": { - // "description": "Required. Full name of the Backup resource. Format: projects/{project}/locations/{location}/backupPlans/{backup_plan}/backups/{backup}", + // "description": "Required. Full name of the Backup resource. Format: projects/*/locations/*/backupPlans/*/backups/*", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+/backups/[^/]+$", // "required": true, @@ -4937,20 +4905,22 @@ type ProjectsLocationsBackupPlansBackupsListCall struct { // List: Lists the Backups for a given BackupPlan. // // - parent: The BackupPlan that contains the Backups to list. Format: -// projects/{project}/locations/{location}/backupPlans/{backup_plan}. +// projects/*/locations/*/backupPlans/*. func (r *ProjectsLocationsBackupPlansBackupsService) List(parent string) *ProjectsLocationsBackupPlansBackupsListCall { c := &ProjectsLocationsBackupPlansBackupsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent return c } -// Filter sets the optional parameter "filter": List filter. +// Filter sets the optional parameter "filter": Field match expression +// used to filter the results. func (c *ProjectsLocationsBackupPlansBackupsListCall) Filter(filter string) *ProjectsLocationsBackupPlansBackupsListCall { c.urlParams_.Set("filter", filter) return c } -// OrderBy sets the optional parameter "orderBy": Sort results. +// OrderBy sets the optional parameter "orderBy": Field by which to sort +// the results. func (c *ProjectsLocationsBackupPlansBackupsListCall) OrderBy(orderBy string) *ProjectsLocationsBackupPlansBackupsListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -5085,12 +5055,12 @@ func (c *ProjectsLocationsBackupPlansBackupsListCall) Do(opts ...googleapi.CallO // ], // "parameters": { // "filter": { - // "description": "List filter.", + // "description": "Field match expression used to filter the results.", // "location": "query", // "type": "string" // }, // "orderBy": { - // "description": "Sort results.", + // "description": "Field by which to sort the results.", // "location": "query", // "type": "string" // }, @@ -5106,7 +5076,7 @@ func (c *ProjectsLocationsBackupPlansBackupsListCall) Do(opts ...googleapi.CallO // "type": "string" // }, // "parent": { - // "description": "Required. The BackupPlan that contains the Backups to list. Format: projects/{project}/locations/{location}/backupPlans/{backup_plan}", + // "description": "Required. The BackupPlan that contains the Backups to list. Format: projects/*/locations/*/backupPlans/*", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+$", // "required": true, @@ -5616,8 +5586,7 @@ type ProjectsLocationsBackupPlansBackupsVolumeBackupsGetCall struct { // Get: Retrieve the details of a single VolumeBackup. // // - name: Full name of the VolumeBackup resource. Format: -// projects/{project}/locations/{location}/backupPlans/{backup_plan}/ba -// ckups/{backup}/volumeBackups/{volume_backup}. +// projects/*/locations/*/backupPlans/*/backups/*/volumeBackups/*. func (r *ProjectsLocationsBackupPlansBackupsVolumeBackupsService) Get(name string) *ProjectsLocationsBackupPlansBackupsVolumeBackupsGetCall { c := &ProjectsLocationsBackupPlansBackupsVolumeBackupsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -5732,7 +5701,7 @@ func (c *ProjectsLocationsBackupPlansBackupsVolumeBackupsGetCall) Do(opts ...goo // ], // "parameters": { // "name": { - // "description": "Required. Full name of the VolumeBackup resource. Format: projects/{project}/locations/{location}/backupPlans/{backup_plan}/backups/{backup}/volumeBackups/{volume_backup}", + // "description": "Required. Full name of the VolumeBackup resource. Format: projects/*/locations/*/backupPlans/*/backups/*/volumeBackups/*", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+/backups/[^/]+/volumeBackups/[^/]+$", // "required": true, @@ -5938,21 +5907,22 @@ type ProjectsLocationsBackupPlansBackupsVolumeBackupsListCall struct { // List: Lists the VolumeBackups for a given Backup. // // - parent: The Backup that contains the VolumeBackups to list. Format: -// projects/{project}/locations/{location}/backupPlans/{backup_plan}/ba -// ckups/{backup}. +// projects/*/locations/*/backupPlans/*/backups/*. func (r *ProjectsLocationsBackupPlansBackupsVolumeBackupsService) List(parent string) *ProjectsLocationsBackupPlansBackupsVolumeBackupsListCall { c := &ProjectsLocationsBackupPlansBackupsVolumeBackupsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent return c } -// Filter sets the optional parameter "filter": List filter. +// Filter sets the optional parameter "filter": Field match expression +// used to filter the results. func (c *ProjectsLocationsBackupPlansBackupsVolumeBackupsListCall) Filter(filter string) *ProjectsLocationsBackupPlansBackupsVolumeBackupsListCall { c.urlParams_.Set("filter", filter) return c } -// OrderBy sets the optional parameter "orderBy": Sort results. +// OrderBy sets the optional parameter "orderBy": Field by which to sort +// the results. func (c *ProjectsLocationsBackupPlansBackupsVolumeBackupsListCall) OrderBy(orderBy string) *ProjectsLocationsBackupPlansBackupsVolumeBackupsListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -6087,12 +6057,12 @@ func (c *ProjectsLocationsBackupPlansBackupsVolumeBackupsListCall) Do(opts ...go // ], // "parameters": { // "filter": { - // "description": "List filter.", + // "description": "Field match expression used to filter the results.", // "location": "query", // "type": "string" // }, // "orderBy": { - // "description": "Sort results.", + // "description": "Field by which to sort the results.", // "location": "query", // "type": "string" // }, @@ -6108,7 +6078,7 @@ func (c *ProjectsLocationsBackupPlansBackupsVolumeBackupsListCall) Do(opts ...go // "type": "string" // }, // "parent": { - // "description": "Required. The Backup that contains the VolumeBackups to list. Format: projects/{project}/locations/{location}/backupPlans/{backup_plan}/backups/{backup}", + // "description": "Required. The Backup that contains the VolumeBackups to list. Format: projects/*/locations/*/backupPlans/*/backups/*", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+/backups/[^/]+$", // "required": true, @@ -6969,7 +6939,7 @@ type ProjectsLocationsRestorePlansCreateCall struct { // Create: Creates a new RestorePlan in a given location. // // - parent: The location within which to create the RestorePlan. -// Format: projects/{project}/locations/{location}. +// Format: projects/*/locations/*. func (r *ProjectsLocationsRestorePlansService) Create(parent string, restoreplan *RestorePlan) *ProjectsLocationsRestorePlansCreateCall { c := &ProjectsLocationsRestorePlansCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -6979,10 +6949,10 @@ func (r *ProjectsLocationsRestorePlansService) Create(parent string, restoreplan // RestorePlanId sets the optional parameter "restorePlanId": Required. // The client-provided short name for the RestorePlan resource. This -// name must: a. be between 1 and 63 characters long (inclusive) b. -// consist of only lower-case ASCII letters, numbers, and dashes c. -// start with a lower-case letter d. end with a lower-case letter or -// number e. be unique within the set of RestorePlans in this location +// name must: - be between 1 and 63 characters long (inclusive) - +// consist of only lower-case ASCII letters, numbers, and dashes - start +// with a lower-case letter - end with a lower-case letter or number - +// be unique within the set of RestorePlans in this location func (c *ProjectsLocationsRestorePlansCreateCall) RestorePlanId(restorePlanId string) *ProjectsLocationsRestorePlansCreateCall { c.urlParams_.Set("restorePlanId", restorePlanId) return c @@ -7088,14 +7058,14 @@ func (c *ProjectsLocationsRestorePlansCreateCall) Do(opts ...googleapi.CallOptio // ], // "parameters": { // "parent": { - // "description": "Required. The location within which to create the RestorePlan. Format: projects/{project}/locations/{location}", + // "description": "Required. The location within which to create the RestorePlan. Format: projects/*/locations/*", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+$", // "required": true, // "type": "string" // }, // "restorePlanId": { - // "description": "Required. The client-provided short name for the RestorePlan resource. This name must: a. be between 1 and 63 characters long (inclusive) b. consist of only lower-case ASCII letters, numbers, and dashes c. start with a lower-case letter d. end with a lower-case letter or number e. be unique within the set of RestorePlans in this location", + // "description": "Required. The client-provided short name for the RestorePlan resource. This name must: - be between 1 and 63 characters long (inclusive) - consist of only lower-case ASCII letters, numbers, and dashes - start with a lower-case letter - end with a lower-case letter or number - be unique within the set of RestorePlans in this location", // "location": "query", // "type": "string" // } @@ -7127,7 +7097,7 @@ type ProjectsLocationsRestorePlansDeleteCall struct { // Delete: Deletes an existing RestorePlan. // // - name: Fully qualified RestorePlan name. Format: -// projects/{project}/locations/{location}/restorePlans/{restore_plan}. +// projects/*/locations/*/restorePlans/*. func (r *ProjectsLocationsRestorePlansService) Delete(name string) *ProjectsLocationsRestorePlansDeleteCall { c := &ProjectsLocationsRestorePlansDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -7135,15 +7105,16 @@ func (r *ProjectsLocationsRestorePlansService) Delete(name string) *ProjectsLoca } // Etag sets the optional parameter "etag": If provided, this value must -// match the value currently assigned to the target resource. +// match the current value of the target RestorePlan's etag field or the +// request is rejected. func (c *ProjectsLocationsRestorePlansDeleteCall) Etag(etag string) *ProjectsLocationsRestorePlansDeleteCall { c.urlParams_.Set("etag", etag) return c } // Force sets the optional parameter "force": If set to true, any -// restores below this restorePlan will also be deleted. Otherwise, the -// request will only succeed if the restorePlan has no restores. +// Restores below this RestorePlan will also be deleted. Otherwise, the +// request will only succeed if the RestorePlan has no Restores. func (c *ProjectsLocationsRestorePlansDeleteCall) Force(force bool) *ProjectsLocationsRestorePlansDeleteCall { c.urlParams_.Set("force", fmt.Sprint(force)) return c @@ -7244,17 +7215,17 @@ func (c *ProjectsLocationsRestorePlansDeleteCall) Do(opts ...googleapi.CallOptio // ], // "parameters": { // "etag": { - // "description": "If provided, this value must match the value currently assigned to the target resource.", + // "description": "If provided, this value must match the current value of the target RestorePlan's etag field or the request is rejected.", // "location": "query", // "type": "string" // }, // "force": { - // "description": "If set to true, any restores below this restorePlan will also be deleted. Otherwise, the request will only succeed if the restorePlan has no restores.", + // "description": "If set to true, any Restores below this RestorePlan will also be deleted. Otherwise, the request will only succeed if the RestorePlan has no Restores.", // "location": "query", // "type": "boolean" // }, // "name": { - // "description": "Required. Fully qualified RestorePlan name. Format: projects/{project}/locations/{location}/restorePlans/{restore_plan}", + // "description": "Required. Fully qualified RestorePlan name. Format: projects/*/locations/*/restorePlans/*", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+$", // "required": true, @@ -7286,7 +7257,7 @@ type ProjectsLocationsRestorePlansGetCall struct { // Get: Retrieve the details of a single RestorePlan. // // - name: Fully qualified RestorePlan name. Format: -// projects/{project}/locations/{location}/restorePlans/{restore_plan}. +// projects/*/locations/*/restorePlans/*. func (r *ProjectsLocationsRestorePlansService) Get(name string) *ProjectsLocationsRestorePlansGetCall { c := &ProjectsLocationsRestorePlansGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -7401,7 +7372,7 @@ func (c *ProjectsLocationsRestorePlansGetCall) Do(opts ...googleapi.CallOption) // ], // "parameters": { // "name": { - // "description": "Required. Fully qualified RestorePlan name. Format: projects/{project}/locations/{location}/restorePlans/{restore_plan}", + // "description": "Required. Fully qualified RestorePlan name. Format: projects/*/locations/*/restorePlans/*", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+$", // "required": true, @@ -7607,20 +7578,22 @@ type ProjectsLocationsRestorePlansListCall struct { // List: Lists RestorePlans in a given location. // // - parent: The location that contains the RestorePlans to list. -// Format: projects/{project}/locations/{location}. +// Format: projects/*/locations/*. func (r *ProjectsLocationsRestorePlansService) List(parent string) *ProjectsLocationsRestorePlansListCall { c := &ProjectsLocationsRestorePlansListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent return c } -// Filter sets the optional parameter "filter": List filter. +// Filter sets the optional parameter "filter": Field match expression +// used to filter the results. func (c *ProjectsLocationsRestorePlansListCall) Filter(filter string) *ProjectsLocationsRestorePlansListCall { c.urlParams_.Set("filter", filter) return c } -// OrderBy sets the optional parameter "orderBy": Sort results. +// OrderBy sets the optional parameter "orderBy": Field by which to sort +// the results. func (c *ProjectsLocationsRestorePlansListCall) OrderBy(orderBy string) *ProjectsLocationsRestorePlansListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -7755,12 +7728,12 @@ func (c *ProjectsLocationsRestorePlansListCall) Do(opts ...googleapi.CallOption) // ], // "parameters": { // "filter": { - // "description": "List filter.", + // "description": "Field match expression used to filter the results.", // "location": "query", // "type": "string" // }, // "orderBy": { - // "description": "Sort results.", + // "description": "Field by which to sort the results.", // "location": "query", // "type": "string" // }, @@ -7776,7 +7749,7 @@ func (c *ProjectsLocationsRestorePlansListCall) Do(opts ...googleapi.CallOption) // "type": "string" // }, // "parent": { - // "description": "Required. The location that contains the RestorePlans to list. Format: projects/{project}/locations/{location}", + // "description": "Required. The location that contains the RestorePlans to list. Format: projects/*/locations/*", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+$", // "required": true, @@ -7828,8 +7801,8 @@ type ProjectsLocationsRestorePlansPatchCall struct { // Patch: Update a RestorePlan. // -// - name: Output only. [Output Only] The full name of the RestorePlan -// resource. Format: projects/*/locations/*/restorePlans/*. +// - name: Output only. The full name of the RestorePlan resource. +// Format: projects/*/locations/*/restorePlans/*. func (r *ProjectsLocationsRestorePlansService) Patch(name string, restoreplan *RestorePlan) *ProjectsLocationsRestorePlansPatchCall { c := &ProjectsLocationsRestorePlansPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -7951,7 +7924,7 @@ func (c *ProjectsLocationsRestorePlansPatchCall) Do(opts ...googleapi.CallOption // ], // "parameters": { // "name": { - // "description": "Output only. [Output Only] The full name of the RestorePlan resource. Format: projects/*/locations/*/restorePlans/*", + // "description": "Output only. The full name of the RestorePlan resource. Format: projects/*/locations/*/restorePlans/*.", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+$", // "required": true, @@ -8287,7 +8260,7 @@ type ProjectsLocationsRestorePlansRestoresCreateCall struct { // Create: Creates a new Restore for the given RestorePlan. // // - parent: The RestorePlan within which to create the Restore. Format: -// projects/{project}/locations/{location}/restorePlans/{restore_plan}. +// projects/*/locations/*/restorePlans/*. func (r *ProjectsLocationsRestorePlansRestoresService) Create(parent string, restore *Restore) *ProjectsLocationsRestorePlansRestoresCreateCall { c := &ProjectsLocationsRestorePlansRestoresCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8297,9 +8270,9 @@ func (r *ProjectsLocationsRestorePlansRestoresService) Create(parent string, res // RestoreId sets the optional parameter "restoreId": Required. The // client-provided short name for the Restore resource. This name must: -// a. be between 1 and 63 characters long (inclusive) b. consist of only -// lower-case ASCII letters, numbers, and dashes c. start with a -// lower-case letter d. end with a lower-case letter or number e. be +// - be between 1 and 63 characters long (inclusive) - consist of only +// lower-case ASCII letters, numbers, and dashes - start with a +// lower-case letter - end with a lower-case letter or number - be // unique within the set of Restores in this RestorePlan. func (c *ProjectsLocationsRestorePlansRestoresCreateCall) RestoreId(restoreId string) *ProjectsLocationsRestorePlansRestoresCreateCall { c.urlParams_.Set("restoreId", restoreId) @@ -8406,14 +8379,14 @@ func (c *ProjectsLocationsRestorePlansRestoresCreateCall) Do(opts ...googleapi.C // ], // "parameters": { // "parent": { - // "description": "Required. The RestorePlan within which to create the Restore. Format: projects/{project}/locations/{location}/restorePlans/{restore_plan}", + // "description": "Required. The RestorePlan within which to create the Restore. Format: projects/*/locations/*/restorePlans/*", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+$", // "required": true, // "type": "string" // }, // "restoreId": { - // "description": "Required. The client-provided short name for the Restore resource. This name must: a. be between 1 and 63 characters long (inclusive) b. consist of only lower-case ASCII letters, numbers, and dashes c. start with a lower-case letter d. end with a lower-case letter or number e. be unique within the set of Restores in this RestorePlan.", + // "description": "Required. The client-provided short name for the Restore resource. This name must: - be between 1 and 63 characters long (inclusive) - consist of only lower-case ASCII letters, numbers, and dashes - start with a lower-case letter - end with a lower-case letter or number - be unique within the set of Restores in this RestorePlan.", // "location": "query", // "type": "string" // } @@ -8445,24 +8418,24 @@ type ProjectsLocationsRestorePlansRestoresDeleteCall struct { // Delete: Deletes an existing Restore. // // - name: Full name of the Restore Format: -// projects/{project}/locations/{location}/restorePlans/{restore_plan}/ -// restores/{restore}. +// projects/*/locations/*/restorePlans/*/restores/*. func (r *ProjectsLocationsRestorePlansRestoresService) Delete(name string) *ProjectsLocationsRestorePlansRestoresDeleteCall { c := &ProjectsLocationsRestorePlansRestoresDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } -// Etag sets the optional parameter "etag": etag, if provided, it must -// match the server's etag for delete to happen. +// Etag sets the optional parameter "etag": If provided, this value must +// match the current value of the target Restore's etag field or the +// request is rejected. func (c *ProjectsLocationsRestorePlansRestoresDeleteCall) Etag(etag string) *ProjectsLocationsRestorePlansRestoresDeleteCall { c.urlParams_.Set("etag", etag) return c } // Force sets the optional parameter "force": If set to true, any -// volumeRestores below this restore will also be deleted. Otherwise, -// the request will only succeed if the restore has no volumeRestores. +// VolumeRestores below this restore will also be deleted. Otherwise, +// the request will only succeed if the restore has no VolumeRestores. func (c *ProjectsLocationsRestorePlansRestoresDeleteCall) Force(force bool) *ProjectsLocationsRestorePlansRestoresDeleteCall { c.urlParams_.Set("force", fmt.Sprint(force)) return c @@ -8563,17 +8536,17 @@ func (c *ProjectsLocationsRestorePlansRestoresDeleteCall) Do(opts ...googleapi.C // ], // "parameters": { // "etag": { - // "description": "etag, if provided, it must match the server's etag for delete to happen.", + // "description": "If provided, this value must match the current value of the target Restore's etag field or the request is rejected.", // "location": "query", // "type": "string" // }, // "force": { - // "description": "If set to true, any volumeRestores below this restore will also be deleted. Otherwise, the request will only succeed if the restore has no volumeRestores.", + // "description": "If set to true, any VolumeRestores below this restore will also be deleted. Otherwise, the request will only succeed if the restore has no VolumeRestores.", // "location": "query", // "type": "boolean" // }, // "name": { - // "description": "Required. Full name of the Restore Format: projects/{project}/locations/{location}/restorePlans/{restore_plan}/restores/{restore}", + // "description": "Required. Full name of the Restore Format: projects/*/locations/*/restorePlans/*/restores/*", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+/restores/[^/]+$", // "required": true, @@ -8605,8 +8578,7 @@ type ProjectsLocationsRestorePlansRestoresGetCall struct { // Get: Retrieves the details of a single Restore. // // - name: Name of the restore resource. Format: -// projects/{project}/locations/{location}/restorePlans/{restore_plan}/ -// restores/{restore}. +// projects/*/locations/*/restorePlans/*/restores/*. func (r *ProjectsLocationsRestorePlansRestoresService) Get(name string) *ProjectsLocationsRestorePlansRestoresGetCall { c := &ProjectsLocationsRestorePlansRestoresGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -8721,7 +8693,7 @@ func (c *ProjectsLocationsRestorePlansRestoresGetCall) Do(opts ...googleapi.Call // ], // "parameters": { // "name": { - // "description": "Required. Name of the restore resource. Format: projects/{project}/locations/{location}/restorePlans/{restore_plan}/restores/{restore}", + // "description": "Required. Name of the restore resource. Format: projects/*/locations/*/restorePlans/*/restores/*", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+/restores/[^/]+$", // "required": true, @@ -8927,20 +8899,22 @@ type ProjectsLocationsRestorePlansRestoresListCall struct { // List: Lists the Restores for a given RestorePlan. // // - parent: The RestorePlan that contains the Restores to list. Format: -// projects/{project}/locations/{location}/restorePlans/{restore_plan}. +// projects/*/locations/*/restorePlans/*. func (r *ProjectsLocationsRestorePlansRestoresService) List(parent string) *ProjectsLocationsRestorePlansRestoresListCall { c := &ProjectsLocationsRestorePlansRestoresListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent return c } -// Filter sets the optional parameter "filter": List filter. +// Filter sets the optional parameter "filter": Field match expression +// used to filter the results. func (c *ProjectsLocationsRestorePlansRestoresListCall) Filter(filter string) *ProjectsLocationsRestorePlansRestoresListCall { c.urlParams_.Set("filter", filter) return c } -// OrderBy sets the optional parameter "orderBy": Sort results. +// OrderBy sets the optional parameter "orderBy": Field by which to sort +// the results. func (c *ProjectsLocationsRestorePlansRestoresListCall) OrderBy(orderBy string) *ProjectsLocationsRestorePlansRestoresListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -9075,12 +9049,12 @@ func (c *ProjectsLocationsRestorePlansRestoresListCall) Do(opts ...googleapi.Cal // ], // "parameters": { // "filter": { - // "description": "List filter.", + // "description": "Field match expression used to filter the results.", // "location": "query", // "type": "string" // }, // "orderBy": { - // "description": "Sort results.", + // "description": "Field by which to sort the results.", // "location": "query", // "type": "string" // }, @@ -9096,7 +9070,7 @@ func (c *ProjectsLocationsRestorePlansRestoresListCall) Do(opts ...googleapi.Cal // "type": "string" // }, // "parent": { - // "description": "Required. The RestorePlan that contains the Restores to list. Format: projects/{project}/locations/{location}/restorePlans/{restore_plan}", + // "description": "Required. The RestorePlan that contains the Restores to list. Format: projects/*/locations/*/restorePlans/*", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+$", // "required": true, @@ -9606,8 +9580,7 @@ type ProjectsLocationsRestorePlansRestoresVolumeRestoresGetCall struct { // Get: Retrieve the details of a single VolumeRestore. // // - name: Full name of the VolumeRestore resource. Format: -// projects/{project}/locations/{location}/restorePlans/{restore_plan}/ -// restores/{restore}/volumeRestores/{volume_restore}. +// projects/*/locations/*/restorePlans/*/restores/*/volumeRestores/*. func (r *ProjectsLocationsRestorePlansRestoresVolumeRestoresService) Get(name string) *ProjectsLocationsRestorePlansRestoresVolumeRestoresGetCall { c := &ProjectsLocationsRestorePlansRestoresVolumeRestoresGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -9722,7 +9695,7 @@ func (c *ProjectsLocationsRestorePlansRestoresVolumeRestoresGetCall) Do(opts ... // ], // "parameters": { // "name": { - // "description": "Required. Full name of the VolumeRestore resource. Format: projects/{project}/locations/{location}/restorePlans/{restore_plan}/restores/{restore}/volumeRestores/{volume_restore}", + // "description": "Required. Full name of the VolumeRestore resource. Format: projects/*/locations/*/restorePlans/*/restores/*/volumeRestores/*", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+/restores/[^/]+/volumeRestores/[^/]+$", // "required": true, @@ -9928,22 +9901,22 @@ type ProjectsLocationsRestorePlansRestoresVolumeRestoresListCall struct { // List: Lists the VolumeRestores for a given Restore. // // - parent: The Restore that contains the VolumeRestores to list. -// Format: -// projects/{project}/locations/{location}/restorePlans/{restore_plan}/ -// restores/{restore}. +// Format: projects/*/locations/*/restorePlans/*/restores/*. func (r *ProjectsLocationsRestorePlansRestoresVolumeRestoresService) List(parent string) *ProjectsLocationsRestorePlansRestoresVolumeRestoresListCall { c := &ProjectsLocationsRestorePlansRestoresVolumeRestoresListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent return c } -// Filter sets the optional parameter "filter": List filter. +// Filter sets the optional parameter "filter": Field match expression +// used to filter the results. func (c *ProjectsLocationsRestorePlansRestoresVolumeRestoresListCall) Filter(filter string) *ProjectsLocationsRestorePlansRestoresVolumeRestoresListCall { c.urlParams_.Set("filter", filter) return c } -// OrderBy sets the optional parameter "orderBy": Sort results. +// OrderBy sets the optional parameter "orderBy": Field by which to sort +// the results. func (c *ProjectsLocationsRestorePlansRestoresVolumeRestoresListCall) OrderBy(orderBy string) *ProjectsLocationsRestorePlansRestoresVolumeRestoresListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -10079,12 +10052,12 @@ func (c *ProjectsLocationsRestorePlansRestoresVolumeRestoresListCall) Do(opts .. // ], // "parameters": { // "filter": { - // "description": "List filter.", + // "description": "Field match expression used to filter the results.", // "location": "query", // "type": "string" // }, // "orderBy": { - // "description": "Sort results.", + // "description": "Field by which to sort the results.", // "location": "query", // "type": "string" // }, @@ -10100,7 +10073,7 @@ func (c *ProjectsLocationsRestorePlansRestoresVolumeRestoresListCall) Do(opts .. // "type": "string" // }, // "parent": { - // "description": "Required. The Restore that contains the VolumeRestores to list. Format: projects/{project}/locations/{location}/restorePlans/{restore_plan}/restores/{restore}", + // "description": "Required. The Restore that contains the VolumeRestores to list. Format: projects/*/locations/*/restorePlans/*/restores/*", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+/restores/[^/]+$", // "required": true, diff --git a/iam/v2beta/iam-api.json b/iam/v2beta/iam-api.json new file mode 100644 index 00000000000..3bdf4b287f8 --- /dev/null +++ b/iam/v2beta/iam-api.json @@ -0,0 +1,623 @@ +{ + "auth": { + "oauth2": { + "scopes": { + "https://www.googleapis.com/auth/cloud-platform": { + "description": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account." + } + } + } + }, + "basePath": "", + "baseUrl": "https://iam.googleapis.com/", + "batchPath": "batch", + "canonicalName": "Iam", + "description": "Manages identity and access control for Google Cloud Platform resources, including the creation of service accounts, which you can use to authenticate to Google and make API calls. ", + "discoveryVersion": "v1", + "documentationLink": "https://cloud.google.com/iam/", + "fullyEncodeReservedExpansion": true, + "icons": { + "x16": "http://www.google.com/images/icons/product/search-16.gif", + "x32": "http://www.google.com/images/icons/product/search-32.gif" + }, + "id": "iam:v2beta", + "kind": "discovery#restDescription", + "mtlsRootUrl": "https://iam.mtls.googleapis.com/", + "name": "iam", + "ownerDomain": "google.com", + "ownerName": "Google", + "parameters": { + "$.xgafv": { + "description": "V1 error format.", + "enum": [ + "1", + "2" + ], + "enumDescriptions": [ + "v1 error format", + "v2 error format" + ], + "location": "query", + "type": "string" + }, + "access_token": { + "description": "OAuth access token.", + "location": "query", + "type": "string" + }, + "alt": { + "default": "json", + "description": "Data format for response.", + "enum": [ + "json", + "media", + "proto" + ], + "enumDescriptions": [ + "Responses with Content-Type of application/json", + "Media download with context-dependent Content-Type", + "Responses with Content-Type of application/x-protobuf" + ], + "location": "query", + "type": "string" + }, + "callback": { + "description": "JSONP", + "location": "query", + "type": "string" + }, + "fields": { + "description": "Selector specifying which fields to include in a partial response.", + "location": "query", + "type": "string" + }, + "key": { + "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.", + "location": "query", + "type": "string" + }, + "oauth_token": { + "description": "OAuth 2.0 token for the current user.", + "location": "query", + "type": "string" + }, + "prettyPrint": { + "default": "true", + "description": "Returns response with indentations and line breaks.", + "location": "query", + "type": "boolean" + }, + "quotaUser": { + "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", + "location": "query", + "type": "string" + }, + "uploadType": { + "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", + "location": "query", + "type": "string" + }, + "upload_protocol": { + "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", + "location": "query", + "type": "string" + } + }, + "protocol": "rest", + "resources": { + "policies": { + "methods": { + "createPolicy": { + "description": "Creates a policy.", + "flatPath": "v2beta/policies/{policiesId}/{policiesId1}", + "httpMethod": "POST", + "id": "iam.policies.createPolicy", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The resource that the policy is attached to, along with the kind of policy to create. Format: `policies/{attachment-point}/denypolicies` The attachment point is identified by its URL-encoded full resource name, which means that the forward-slash character, `/`, must be written as `%2F`. For example, `policies/cloudresourcemanager.googleapis.com%2Fprojects%2Fmy-project/denypolicies`. For organizations and folders, use the numeric ID in the full resource name. For projects, you can use the alphanumeric or the numeric ID.", + "location": "path", + "pattern": "^policies/[^/]+/[^/]+$", + "required": true, + "type": "string" + }, + "policyId": { + "description": "The ID to use for this policy, which will become the final component of the policy's resource name. The ID must contain 3 to 63 characters. It can contain lowercase letters and numbers, as well as dashes (`-`) and periods (`.`). The first character must be a lowercase letter.", + "location": "query", + "type": "string" + } + }, + "path": "v2beta/{+parent}", + "request": { + "$ref": "GoogleIamV2betaPolicy" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes a policy. This action is permanent.", + "flatPath": "v2beta/policies/{policiesId}/{policiesId1}/{policiesId2}", + "httpMethod": "DELETE", + "id": "iam.policies.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "etag": { + "description": "Optional. The expected `etag` of the policy to delete. If the value does not match the value that is stored in IAM, the request fails with a `409` error code and `ABORTED` status. If you omit this field, the policy is deleted regardless of its current `etag`.", + "location": "query", + "type": "string" + }, + "name": { + "description": "Required. The resource name of the policy to delete. Format: `policies/{attachment-point}/denypolicies/{policy-id}` Use the URL-encoded full resource name, which means that the forward-slash character, `/`, must be written as `%2F`. For example, `policies/cloudresourcemanager.googleapis.com%2Fprojects%2Fmy-project/denypolicies/my-policy`. For organizations and folders, use the numeric ID in the full resource name. For projects, you can use the alphanumeric or the numeric ID.", + "location": "path", + "pattern": "^policies/[^/]+/[^/]+/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+name}", + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets a policy.", + "flatPath": "v2beta/policies/{policiesId}/{policiesId1}/{policiesId2}", + "httpMethod": "GET", + "id": "iam.policies.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource name of the policy to retrieve. Format: `policies/{attachment-point}/denypolicies/{policy-id}` Use the URL-encoded full resource name, which means that the forward-slash character, `/`, must be written as `%2F`. For example, `policies/cloudresourcemanager.googleapis.com%2Fprojects%2Fmy-project/denypolicies/my-policy`. For organizations and folders, use the numeric ID in the full resource name. For projects, you can use the alphanumeric or the numeric ID.", + "location": "path", + "pattern": "^policies/[^/]+/[^/]+/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+name}", + "response": { + "$ref": "GoogleIamV2betaPolicy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "listPolicies": { + "description": "Retrieves the policies of the specified kind that are attached to a resource. The response lists only policy metadata. In particular, policy rules are omitted.", + "flatPath": "v2beta/policies/{policiesId}/{policiesId1}", + "httpMethod": "GET", + "id": "iam.policies.listPolicies", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "The maximum number of policies to return. IAM ignores this value and uses the value 1000.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "A page token received in a ListPoliciesResponse. Provide this token to retrieve the next page.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The resource that the policy is attached to, along with the kind of policy to list. Format: `policies/{attachment-point}/denypolicies` The attachment point is identified by its URL-encoded full resource name, which means that the forward-slash character, `/`, must be written as `%2F`. For example, `policies/cloudresourcemanager.googleapis.com%2Fprojects%2Fmy-project/denypolicies`. For organizations and folders, use the numeric ID in the full resource name. For projects, you can use the alphanumeric or the numeric ID.", + "location": "path", + "pattern": "^policies/[^/]+/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+parent}", + "response": { + "$ref": "GoogleIamV2betaListPoliciesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "update": { + "description": "Updates the specified policy. You can update only the rules and the display name for the policy. To update a policy, you should use a read-modify-write loop: 1. Use GetPolicy to read the current version of the policy. 2. Modify the policy as needed. 3. Use `UpdatePolicy` to write the updated policy. This pattern helps prevent conflicts between concurrent updates.", + "flatPath": "v2beta/policies/{policiesId}/{policiesId1}/{policiesId2}", + "httpMethod": "PUT", + "id": "iam.policies.update", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Immutable. The resource name of the `Policy`, which must be unique. Format: `policies/{attachment-point}/denypolicies/{policy-id}` The attachment point is identified by its URL-encoded full resource name, which means that the forward-slash character, `/`, must be written as `%2F`. For example, `policies/cloudresourcemanager.googleapis.com%2Fprojects%2Fmy-project/denypolicies/my-deny-policy`. For organizations and folders, use the numeric ID in the full resource name. For projects, requests can use the alphanumeric or the numeric ID. Responses always contain the numeric ID.", + "location": "path", + "pattern": "^policies/[^/]+/[^/]+/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+name}", + "request": { + "$ref": "GoogleIamV2betaPolicy" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, + "resources": { + "operations": { + "methods": { + "get": { + "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", + "flatPath": "v2beta/policies/{policiesId}/{policiesId1}/{policiesId2}/operations/{operationsId}", + "httpMethod": "GET", + "id": "iam.policies.operations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource.", + "location": "path", + "pattern": "^policies/[^/]+/[^/]+/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+name}", + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + } + }, + "revision": "20220331", + "rootUrl": "https://iam.googleapis.com/", + "schemas": { + "GoogleIamAdminV1AuditData": { + "description": "Audit log information specific to Cloud IAM admin APIs. This message is serialized as an `Any` type in the `ServiceData` message of an `AuditLog` message.", + "id": "GoogleIamAdminV1AuditData", + "properties": { + "permissionDelta": { + "$ref": "GoogleIamAdminV1AuditDataPermissionDelta", + "description": "The permission_delta when when creating or updating a Role." + } + }, + "type": "object" + }, + "GoogleIamAdminV1AuditDataPermissionDelta": { + "description": "A PermissionDelta message to record the added_permissions and removed_permissions inside a role.", + "id": "GoogleIamAdminV1AuditDataPermissionDelta", + "properties": { + "addedPermissions": { + "description": "Added permissions.", + "items": { + "type": "string" + }, + "type": "array" + }, + "removedPermissions": { + "description": "Removed permissions.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleIamV1BindingDelta": { + "description": "One delta entry for Binding. Each individual change (only one member in each entry) to a binding will be a separate entry.", + "id": "GoogleIamV1BindingDelta", + "properties": { + "action": { + "description": "The action that was performed on a Binding. Required", + "enum": [ + "ACTION_UNSPECIFIED", + "ADD", + "REMOVE" + ], + "enumDescriptions": [ + "Unspecified.", + "Addition of a Binding.", + "Removal of a Binding." + ], + "type": "string" + }, + "condition": { + "$ref": "GoogleTypeExpr", + "description": "The condition that is associated with this binding." + }, + "member": { + "description": "A single identity requesting access for a Cloud Platform resource. Follows the same format of Binding.members. Required", + "type": "string" + }, + "role": { + "description": "Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. Required", + "type": "string" + } + }, + "type": "object" + }, + "GoogleIamV1LoggingAuditData": { + "description": "Audit log information specific to Cloud IAM. This message is serialized as an `Any` type in the `ServiceData` message of an `AuditLog` message.", + "id": "GoogleIamV1LoggingAuditData", + "properties": { + "policyDelta": { + "$ref": "GoogleIamV1PolicyDelta", + "description": "Policy delta between the original policy and the newly set policy." + } + }, + "type": "object" + }, + "GoogleIamV1PolicyDelta": { + "description": "The difference delta between two policies.", + "id": "GoogleIamV1PolicyDelta", + "properties": { + "bindingDeltas": { + "description": "The delta for Bindings between two policies.", + "items": { + "$ref": "GoogleIamV1BindingDelta" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleIamV2betaDenyRule": { + "description": "A deny rule in an IAM deny policy.", + "id": "GoogleIamV2betaDenyRule", + "properties": { + "denialCondition": { + "$ref": "GoogleTypeExpr", + "description": "The condition that determines whether this deny rule applies to a request. If the condition expression evaluates to `true`, then the deny rule is applied; otherwise, the deny rule is not applied. Each deny rule is evaluated independently. If this deny rule does not apply to a request, other deny rules might still apply. The condition can use CEL functions that evaluate [resource tags](https://cloud.google.com/iam/help/conditions/resource-tags). Other functions and operators are not supported." + }, + "deniedPermissions": { + "description": "The permissions that are explicitly denied by this rule. Each permission uses the format `{service-fqdn}/{resource}.{verb}`, where `{service-fqdn}` is the fully qualified domain name for the service. For example, `iam.googleapis.com/roles.list`.", + "items": { + "type": "string" + }, + "type": "array" + }, + "deniedPrincipals": { + "description": "The identities that are prevented from using one or more permissions on Google Cloud resources. This field can contain the following values: * `principalSet://goog/public:all`: A special identifier that represents any user who is on the internet, even if they do not have a Google Account or are not logged in. * `principal://goog/subject/{email-id}`: A specific Google Account. Includes Gmail, Cloud Identity, and Google Workspace user accounts. For example, `principal://goog/subject/alice@example.com`. * `deleted:principal://goog/subject/{email-id}?uid={uid}`: A specific Google Account that was deleted recently. For example, `deleted:principal://goog/subject/alice@example.com?uid=1234567890`. If the Google Account is recovered, this identifier reverts to the standard identifier for a Google Account. * `principalSet://goog/group/{group-id}`: A Google group. For example, `principalSet://goog/group/admins@example.com`. * `deleted:principalSet://goog/group/{group-id}?uid={uid}`: A Google group that was deleted recently. For example, `deleted:principalSet://goog/group/admins@example.com?uid=1234567890`. If the Google group is restored, this identifier reverts to the standard identifier for a Google group. * `principal://iam.googleapis.com/projects/-/serviceAccounts/{service-account-id}`: A Google Cloud service account. For example, `principal://iam.googleapis.com/projects/-/serviceAccounts/my-service-account@iam.gserviceaccount.com`. * `deleted:principal://iam.googleapis.com/projects/-/serviceAccounts/{service-account-id}?uid={uid}`: A Google Cloud service account that was deleted recently. For example, `deleted:principal://iam.googleapis.com/projects/-/serviceAccounts/my-service-account@iam.gserviceaccount.com?uid=1234567890`. If the service account is undeleted, this identifier reverts to the standard identifier for a service account. * `principalSet://goog/cloudIdentityCustomerId/{customer-id}`: All of the principals associated with the specified Google Workspace or Cloud Identity customer ID. For example, `principalSet://goog/cloudIdentityCustomerId/C01Abc35`.", + "items": { + "type": "string" + }, + "type": "array" + }, + "exceptionPermissions": { + "description": "Specifies the permissions that this rule excludes from the set of denied permissions given by `denied_permissions`. If a permission appears in `denied_permissions` _and_ in `exception_permissions` then it will _not_ be denied. The excluded permissions can be specified using the same syntax as `denied_permissions`.", + "items": { + "type": "string" + }, + "type": "array" + }, + "exceptionPrincipals": { + "description": "The identities that are excluded from the deny rule, even if they are listed in the `denied_principals`. For example, you could add a Google group to the `denied_principals`, then exclude specific users who belong to that group. This field can contain the same values as the `denied_principals` field, excluding `principalSet://goog/public:all`, which represents all users on the internet.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleIamV2betaListPoliciesResponse": { + "description": "Response message for `ListPolicies`.", + "id": "GoogleIamV2betaListPoliciesResponse", + "properties": { + "nextPageToken": { + "description": "A page token that you can use in a ListPoliciesRequest to retrieve the next page. If this field is omitted, there are no additional pages.", + "type": "string" + }, + "policies": { + "description": "Metadata for the policies that are attached to the resource.", + "items": { + "$ref": "GoogleIamV2betaPolicy" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleIamV2betaPolicy": { + "description": "Data for an IAM policy.", + "id": "GoogleIamV2betaPolicy", + "properties": { + "annotations": { + "additionalProperties": { + "type": "string" + }, + "description": "A key-value map to store arbitrary metadata for the `Policy`. Keys can be up to 63 characters. Values can be up to 255 characters.", + "type": "object" + }, + "createTime": { + "description": "Output only. The time when the `Policy` was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "deleteTime": { + "description": "Output only. The time when the `Policy` was deleted. Empty if the policy is not deleted.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "displayName": { + "description": "A user-specified description of the `Policy`. This value can be up to 63 characters.", + "type": "string" + }, + "etag": { + "description": "An opaque tag that identifies the current version of the `Policy`. IAM uses this value to help manage concurrent updates, so they do not cause one update to be overwritten by another. If this field is present in a CreatePolicy request, the value is ignored.", + "type": "string" + }, + "kind": { + "description": "Output only. The kind of the `Policy`. Always contains the value `DenyPolicy`.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Immutable. The resource name of the `Policy`, which must be unique. Format: `policies/{attachment-point}/denypolicies/{policy-id}` The attachment point is identified by its URL-encoded full resource name, which means that the forward-slash character, `/`, must be written as `%2F`. For example, `policies/cloudresourcemanager.googleapis.com%2Fprojects%2Fmy-project/denypolicies/my-deny-policy`. For organizations and folders, use the numeric ID in the full resource name. For projects, requests can use the alphanumeric or the numeric ID. Responses always contain the numeric ID.", + "type": "string" + }, + "rules": { + "description": "A list of rules that specify the behavior of the `Policy`. All of the rules should be of the `kind` specified in the `Policy`.", + "items": { + "$ref": "GoogleIamV2betaPolicyRule" + }, + "type": "array" + }, + "uid": { + "description": "Immutable. The globally unique ID of the `Policy`. Assigned automatically when the `Policy` is created.", + "type": "string" + }, + "updateTime": { + "description": "Output only. The time when the `Policy` was last updated.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleIamV2betaPolicyOperationMetadata": { + "description": "Metadata for long-running `Policy` operations.", + "id": "GoogleIamV2betaPolicyOperationMetadata", + "properties": { + "createTime": { + "description": "Timestamp when the `google.longrunning.Operation` was created.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleIamV2betaPolicyRule": { + "description": "A single rule in a `Policy`.", + "id": "GoogleIamV2betaPolicyRule", + "properties": { + "denyRule": { + "$ref": "GoogleIamV2betaDenyRule", + "description": "A rule for a deny policy." + }, + "description": { + "description": "A user-specified description of the rule. This value can be up to 256 characters.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleLongrunningOperation": { + "description": "This resource represents a long-running operation that is the result of a network API call.", + "id": "GoogleLongrunningOperation", + "properties": { + "done": { + "description": "If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.", + "type": "boolean" + }, + "error": { + "$ref": "GoogleRpcStatus", + "description": "The error result of the operation in case of failure or cancellation." + }, + "metadata": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "description": "Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.", + "type": "object" + }, + "name": { + "description": "The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.", + "type": "string" + }, + "response": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "description": "The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.", + "type": "object" + } + }, + "type": "object" + }, + "GoogleRpcStatus": { + "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", + "id": "GoogleRpcStatus", + "properties": { + "code": { + "description": "The status code, which should be an enum value of google.rpc.Code.", + "format": "int32", + "type": "integer" + }, + "details": { + "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", + "items": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleTypeExpr": { + "description": "Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: \"Summary size limit\" description: \"Determines if a summary is less than 100 chars\" expression: \"document.summary.size() \u003c 100\" Example (Equality): title: \"Requestor is owner\" description: \"Determines if requestor is the document owner\" expression: \"document.owner == request.auth.claims.email\" Example (Logic): title: \"Public documents\" description: \"Determine whether the document should be publicly visible\" expression: \"document.type != 'private' \u0026\u0026 document.type != 'internal'\" Example (Data Manipulation): title: \"Notification string\" description: \"Create a notification string with a timestamp.\" expression: \"'New message received at ' + string(document.create_time)\" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information.", + "id": "GoogleTypeExpr", + "properties": { + "description": { + "description": "Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.", + "type": "string" + }, + "expression": { + "description": "Textual representation of an expression in Common Expression Language syntax.", + "type": "string" + }, + "location": { + "description": "Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file.", + "type": "string" + }, + "title": { + "description": "Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression.", + "type": "string" + } + }, + "type": "object" + } + }, + "servicePath": "", + "title": "Identity and Access Management (IAM) API", + "version": "v2beta", + "version_module": true +} \ No newline at end of file diff --git a/iam/v2beta/iam-gen.go b/iam/v2beta/iam-gen.go new file mode 100644 index 00000000000..266455bfa40 --- /dev/null +++ b/iam/v2beta/iam-gen.go @@ -0,0 +1,1757 @@ +// Copyright 2022 Google LLC. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +// Code generated file. DO NOT EDIT. + +// Package iam provides access to the Identity and Access Management (IAM) API. +// +// For product documentation, see: https://cloud.google.com/iam/ +// +// Creating a client +// +// Usage example: +// +// import "google.golang.org/api/iam/v2beta" +// ... +// ctx := context.Background() +// iamService, err := iam.NewService(ctx) +// +// In this example, Google Application Default Credentials are used for authentication. +// +// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials. +// +// Other authentication options +// +// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey: +// +// iamService, err := iam.NewService(ctx, option.WithAPIKey("AIza...")) +// +// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource: +// +// config := &oauth2.Config{...} +// // ... +// token, err := config.Exchange(ctx, ...) +// iamService, err := iam.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token))) +// +// See https://godoc.org/google.golang.org/api/option/ for details on options. +package iam // import "google.golang.org/api/iam/v2beta" + +import ( + "bytes" + "context" + "encoding/json" + "errors" + "fmt" + "io" + "net/http" + "net/url" + "strconv" + "strings" + + googleapi "google.golang.org/api/googleapi" + internal "google.golang.org/api/internal" + gensupport "google.golang.org/api/internal/gensupport" + option "google.golang.org/api/option" + internaloption "google.golang.org/api/option/internaloption" + htransport "google.golang.org/api/transport/http" +) + +// Always reference these packages, just in case the auto-generated code +// below doesn't. +var _ = bytes.NewBuffer +var _ = strconv.Itoa +var _ = fmt.Sprintf +var _ = json.NewDecoder +var _ = io.Copy +var _ = url.Parse +var _ = gensupport.MarshalJSON +var _ = googleapi.Version +var _ = errors.New +var _ = strings.Replace +var _ = context.Canceled +var _ = internaloption.WithDefaultEndpoint + +const apiId = "iam:v2beta" +const apiName = "iam" +const apiVersion = "v2beta" +const basePath = "https://iam.googleapis.com/" +const mtlsBasePath = "https://iam.mtls.googleapis.com/" + +// OAuth2 scopes used by this API. +const ( + // See, edit, configure, and delete your Google Cloud data and see the + // email address for your Google Account. + CloudPlatformScope = "https://www.googleapis.com/auth/cloud-platform" +) + +// NewService creates a new Service. +func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, error) { + scopesOption := internaloption.WithDefaultScopes( + "https://www.googleapis.com/auth/cloud-platform", + ) + // NOTE: prepend, so we don't override user-specified scopes. + opts = append([]option.ClientOption{scopesOption}, opts...) + opts = append(opts, internaloption.WithDefaultEndpoint(basePath)) + opts = append(opts, internaloption.WithDefaultMTLSEndpoint(mtlsBasePath)) + client, endpoint, err := htransport.NewClient(ctx, opts...) + if err != nil { + return nil, err + } + s, err := New(client) + if err != nil { + return nil, err + } + if endpoint != "" { + s.BasePath = endpoint + } + return s, nil +} + +// New creates a new Service. It uses the provided http.Client for requests. +// +// Deprecated: please use NewService instead. +// To provide a custom HTTP client, use option.WithHTTPClient. +// If you are using google.golang.org/api/googleapis/transport.APIKey, use option.WithAPIKey with NewService instead. +func New(client *http.Client) (*Service, error) { + if client == nil { + return nil, errors.New("client is nil") + } + s := &Service{client: client, BasePath: basePath} + s.Policies = NewPoliciesService(s) + return s, nil +} + +type Service struct { + client *http.Client + BasePath string // API endpoint base URL + UserAgent string // optional additional User-Agent fragment + + Policies *PoliciesService +} + +func (s *Service) userAgent() string { + if s.UserAgent == "" { + return googleapi.UserAgent + } + return googleapi.UserAgent + " " + s.UserAgent +} + +func NewPoliciesService(s *Service) *PoliciesService { + rs := &PoliciesService{s: s} + rs.Operations = NewPoliciesOperationsService(s) + return rs +} + +type PoliciesService struct { + s *Service + + Operations *PoliciesOperationsService +} + +func NewPoliciesOperationsService(s *Service) *PoliciesOperationsService { + rs := &PoliciesOperationsService{s: s} + return rs +} + +type PoliciesOperationsService struct { + s *Service +} + +// GoogleIamAdminV1AuditData: Audit log information specific to Cloud +// IAM admin APIs. This message is serialized as an `Any` type in the +// `ServiceData` message of an `AuditLog` message. +type GoogleIamAdminV1AuditData struct { + // PermissionDelta: The permission_delta when when creating or updating + // a Role. + PermissionDelta *GoogleIamAdminV1AuditDataPermissionDelta `json:"permissionDelta,omitempty"` + + // ForceSendFields is a list of field names (e.g. "PermissionDelta") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "PermissionDelta") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *GoogleIamAdminV1AuditData) MarshalJSON() ([]byte, error) { + type NoMethod GoogleIamAdminV1AuditData + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleIamAdminV1AuditDataPermissionDelta: A PermissionDelta message +// to record the added_permissions and removed_permissions inside a +// role. +type GoogleIamAdminV1AuditDataPermissionDelta struct { + // AddedPermissions: Added permissions. + AddedPermissions []string `json:"addedPermissions,omitempty"` + + // RemovedPermissions: Removed permissions. + RemovedPermissions []string `json:"removedPermissions,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AddedPermissions") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "AddedPermissions") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *GoogleIamAdminV1AuditDataPermissionDelta) MarshalJSON() ([]byte, error) { + type NoMethod GoogleIamAdminV1AuditDataPermissionDelta + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleIamV1BindingDelta: One delta entry for Binding. Each individual +// change (only one member in each entry) to a binding will be a +// separate entry. +type GoogleIamV1BindingDelta struct { + // Action: The action that was performed on a Binding. Required + // + // Possible values: + // "ACTION_UNSPECIFIED" - Unspecified. + // "ADD" - Addition of a Binding. + // "REMOVE" - Removal of a Binding. + Action string `json:"action,omitempty"` + + // Condition: The condition that is associated with this binding. + Condition *GoogleTypeExpr `json:"condition,omitempty"` + + // Member: A single identity requesting access for a Cloud Platform + // resource. Follows the same format of Binding.members. Required + Member string `json:"member,omitempty"` + + // Role: Role that is assigned to `members`. For example, + // `roles/viewer`, `roles/editor`, or `roles/owner`. Required + Role string `json:"role,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Action") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Action") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleIamV1BindingDelta) MarshalJSON() ([]byte, error) { + type NoMethod GoogleIamV1BindingDelta + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleIamV1LoggingAuditData: Audit log information specific to Cloud +// IAM. This message is serialized as an `Any` type in the `ServiceData` +// message of an `AuditLog` message. +type GoogleIamV1LoggingAuditData struct { + // PolicyDelta: Policy delta between the original policy and the newly + // set policy. + PolicyDelta *GoogleIamV1PolicyDelta `json:"policyDelta,omitempty"` + + // ForceSendFields is a list of field names (e.g. "PolicyDelta") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "PolicyDelta") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleIamV1LoggingAuditData) MarshalJSON() ([]byte, error) { + type NoMethod GoogleIamV1LoggingAuditData + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleIamV1PolicyDelta: The difference delta between two policies. +type GoogleIamV1PolicyDelta struct { + // BindingDeltas: The delta for Bindings between two policies. + BindingDeltas []*GoogleIamV1BindingDelta `json:"bindingDeltas,omitempty"` + + // ForceSendFields is a list of field names (e.g. "BindingDeltas") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "BindingDeltas") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleIamV1PolicyDelta) MarshalJSON() ([]byte, error) { + type NoMethod GoogleIamV1PolicyDelta + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleIamV2betaDenyRule: A deny rule in an IAM deny policy. +type GoogleIamV2betaDenyRule struct { + // DenialCondition: The condition that determines whether this deny rule + // applies to a request. If the condition expression evaluates to + // `true`, then the deny rule is applied; otherwise, the deny rule is + // not applied. Each deny rule is evaluated independently. If this deny + // rule does not apply to a request, other deny rules might still apply. + // The condition can use CEL functions that evaluate resource tags + // (https://cloud.google.com/iam/help/conditions/resource-tags). Other + // functions and operators are not supported. + DenialCondition *GoogleTypeExpr `json:"denialCondition,omitempty"` + + // DeniedPermissions: The permissions that are explicitly denied by this + // rule. Each permission uses the format + // `{service-fqdn}/{resource}.{verb}`, where `{service-fqdn}` is the + // fully qualified domain name for the service. For example, + // `iam.googleapis.com/roles.list`. + DeniedPermissions []string `json:"deniedPermissions,omitempty"` + + // DeniedPrincipals: The identities that are prevented from using one or + // more permissions on Google Cloud resources. This field can contain + // the following values: * `principalSet://goog/public:all`: A special + // identifier that represents any user who is on the internet, even if + // they do not have a Google Account or are not logged in. * + // `principal://goog/subject/{email-id}`: A specific Google Account. + // Includes Gmail, Cloud Identity, and Google Workspace user accounts. + // For example, `principal://goog/subject/alice@example.com`. * + // `deleted:principal://goog/subject/{email-id}?uid={uid}`: A specific + // Google Account that was deleted recently. For example, + // `deleted:principal://goog/subject/alice@example.com?uid=1234567890`. + // If the Google Account is recovered, this identifier reverts to the + // standard identifier for a Google Account. * + // `principalSet://goog/group/{group-id}`: A Google group. For example, + // `principalSet://goog/group/admins@example.com`. * + // `deleted:principalSet://goog/group/{group-id}?uid={uid}`: A Google + // group that was deleted recently. For example, + // `deleted:principalSet://goog/group/admins@example.com?uid=1234567890`. + // If the Google group is restored, this identifier reverts to the + // standard identifier for a Google group. * + // `principal://iam.googleapis.com/projects/-/serviceAccounts/{service-ac + // count-id}`: A Google Cloud service account. For example, + // `principal://iam.googleapis.com/projects/-/serviceAccounts/my-service- + // account@iam.gserviceaccount.com`. * + // `deleted:principal://iam.googleapis.com/projects/-/serviceAccounts/{se + // rvice-account-id}?uid={uid}`: A Google Cloud service account that was + // deleted recently. For example, + // `deleted:principal://iam.googleapis.com/projects/-/serviceAccounts/my- + // service-account@iam.gserviceaccount.com?uid=1234567890`. If the + // service account is undeleted, this identifier reverts to the standard + // identifier for a service account. * + // `principalSet://goog/cloudIdentityCustomerId/{customer-id}`: All of + // the principals associated with the specified Google Workspace or + // Cloud Identity customer ID. For example, + // `principalSet://goog/cloudIdentityCustomerId/C01Abc35`. + DeniedPrincipals []string `json:"deniedPrincipals,omitempty"` + + // ExceptionPermissions: Specifies the permissions that this rule + // excludes from the set of denied permissions given by + // `denied_permissions`. If a permission appears in `denied_permissions` + // _and_ in `exception_permissions` then it will _not_ be denied. The + // excluded permissions can be specified using the same syntax as + // `denied_permissions`. + ExceptionPermissions []string `json:"exceptionPermissions,omitempty"` + + // ExceptionPrincipals: The identities that are excluded from the deny + // rule, even if they are listed in the `denied_principals`. For + // example, you could add a Google group to the `denied_principals`, + // then exclude specific users who belong to that group. This field can + // contain the same values as the `denied_principals` field, excluding + // `principalSet://goog/public:all`, which represents all users on the + // internet. + ExceptionPrincipals []string `json:"exceptionPrincipals,omitempty"` + + // ForceSendFields is a list of field names (e.g. "DenialCondition") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "DenialCondition") to + // include in API requests with the JSON null value. By default, fields + // with empty values are omitted from API requests. However, any field + // with an empty value appearing in NullFields will be sent to the + // server as null. It is an error if a field in this list has a + // non-empty value. This may be used to include null fields in Patch + // requests. + NullFields []string `json:"-"` +} + +func (s *GoogleIamV2betaDenyRule) MarshalJSON() ([]byte, error) { + type NoMethod GoogleIamV2betaDenyRule + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleIamV2betaListPoliciesResponse: Response message for +// `ListPolicies`. +type GoogleIamV2betaListPoliciesResponse struct { + // NextPageToken: A page token that you can use in a ListPoliciesRequest + // to retrieve the next page. If this field is omitted, there are no + // additional pages. + NextPageToken string `json:"nextPageToken,omitempty"` + + // Policies: Metadata for the policies that are attached to the + // resource. + Policies []*GoogleIamV2betaPolicy `json:"policies,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. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "NextPageToken") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleIamV2betaListPoliciesResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleIamV2betaListPoliciesResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleIamV2betaPolicy: Data for an IAM policy. +type GoogleIamV2betaPolicy struct { + // Annotations: A key-value map to store arbitrary metadata for the + // `Policy`. Keys can be up to 63 characters. Values can be up to 255 + // characters. + Annotations map[string]string `json:"annotations,omitempty"` + + // CreateTime: Output only. The time when the `Policy` was created. + CreateTime string `json:"createTime,omitempty"` + + // DeleteTime: Output only. The time when the `Policy` was deleted. + // Empty if the policy is not deleted. + DeleteTime string `json:"deleteTime,omitempty"` + + // DisplayName: A user-specified description of the `Policy`. This value + // can be up to 63 characters. + DisplayName string `json:"displayName,omitempty"` + + // Etag: An opaque tag that identifies the current version of the + // `Policy`. IAM uses this value to help manage concurrent updates, so + // they do not cause one update to be overwritten by another. If this + // field is present in a CreatePolicy request, the value is ignored. + Etag string `json:"etag,omitempty"` + + // Kind: Output only. The kind of the `Policy`. Always contains the + // value `DenyPolicy`. + Kind string `json:"kind,omitempty"` + + // Name: Immutable. The resource name of the `Policy`, which must be + // unique. Format: + // `policies/{attachment-point}/denypolicies/{policy-id}` The attachment + // point is identified by its URL-encoded full resource name, which + // means that the forward-slash character, `/`, must be written as + // `%2F`. For example, + // `policies/cloudresourcemanager.googleapis.com%2Fprojects%2Fmy-project/ + // denypolicies/my-deny-policy`. For organizations and folders, use the + // numeric ID in the full resource name. For projects, requests can use + // the alphanumeric or the numeric ID. Responses always contain the + // numeric ID. + Name string `json:"name,omitempty"` + + // Rules: A list of rules that specify the behavior of the `Policy`. All + // of the rules should be of the `kind` specified in the `Policy`. + Rules []*GoogleIamV2betaPolicyRule `json:"rules,omitempty"` + + // Uid: Immutable. The globally unique ID of the `Policy`. Assigned + // automatically when the `Policy` is created. + Uid string `json:"uid,omitempty"` + + // UpdateTime: Output only. The time when the `Policy` was last updated. + UpdateTime string `json:"updateTime,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "Annotations") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Annotations") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleIamV2betaPolicy) MarshalJSON() ([]byte, error) { + type NoMethod GoogleIamV2betaPolicy + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleIamV2betaPolicyOperationMetadata: Metadata for long-running +// `Policy` operations. +type GoogleIamV2betaPolicyOperationMetadata struct { + // CreateTime: Timestamp when the `google.longrunning.Operation` was + // created. + CreateTime string `json:"createTime,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. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "CreateTime") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleIamV2betaPolicyOperationMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleIamV2betaPolicyOperationMetadata + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleIamV2betaPolicyRule: A single rule in a `Policy`. +type GoogleIamV2betaPolicyRule struct { + // DenyRule: A rule for a deny policy. + DenyRule *GoogleIamV2betaDenyRule `json:"denyRule,omitempty"` + + // Description: A user-specified description of the rule. This value can + // be up to 256 characters. + Description string `json:"description,omitempty"` + + // ForceSendFields is a list of field names (e.g. "DenyRule") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "DenyRule") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleIamV2betaPolicyRule) MarshalJSON() ([]byte, error) { + type NoMethod GoogleIamV2betaPolicyRule + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleLongrunningOperation: This resource represents a long-running +// operation that is the result of a network API call. +type GoogleLongrunningOperation struct { + // Done: If the value is `false`, it means the operation is still in + // progress. If `true`, the operation is completed, and either `error` + // or `response` is available. + Done bool `json:"done,omitempty"` + + // Error: The error result of the operation in case of failure or + // cancellation. + Error *GoogleRpcStatus `json:"error,omitempty"` + + // Metadata: Service-specific metadata associated with the operation. It + // typically contains progress information and common metadata such as + // create time. Some services might not provide such metadata. Any + // method that returns a long-running operation should document the + // metadata type, if any. + Metadata googleapi.RawMessage `json:"metadata,omitempty"` + + // Name: The server-assigned name, which is only unique within the same + // service that originally returns it. If you use the default HTTP + // mapping, the `name` should be a resource name ending with + // `operations/{unique_id}`. + Name string `json:"name,omitempty"` + + // Response: The normal response of the operation in case of success. If + // the original method returns no data on success, such as `Delete`, the + // response is `google.protobuf.Empty`. If the original method is + // standard `Get`/`Create`/`Update`, the response should be the + // resource. For other methods, the response should have the type + // `XxxResponse`, where `Xxx` is the original method name. For example, + // if the original method name is `TakeSnapshot()`, the inferred + // response type is `TakeSnapshotResponse`. + Response googleapi.RawMessage `json:"response,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "Done") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Done") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleLongrunningOperation) MarshalJSON() ([]byte, error) { + type NoMethod GoogleLongrunningOperation + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleRpcStatus: The `Status` type defines a logical error model that +// is suitable for different programming environments, including REST +// APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). +type GoogleRpcStatus struct { + // Code: The status code, which should be an enum value of + // google.rpc.Code. + Code int64 `json:"code,omitempty"` + + // Details: A list of messages that carry the error details. There is a + // common set of message types for APIs to use. + Details []googleapi.RawMessage `json:"details,omitempty"` + + // Message: A developer-facing error message, which should be in + // English. Any user-facing error message should be localized and sent + // in the google.rpc.Status.details field, or localized by the client. + 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. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Code") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleRpcStatus) MarshalJSON() ([]byte, error) { + type NoMethod GoogleRpcStatus + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleTypeExpr: Represents a textual expression in the Common +// Expression Language (CEL) syntax. CEL is a C-like expression +// language. The syntax and semantics of CEL are documented at +// https://github.com/google/cel-spec. Example (Comparison): title: +// "Summary size limit" description: "Determines if a summary is less +// than 100 chars" expression: "document.summary.size() < 100" Example +// (Equality): title: "Requestor is owner" description: "Determines if +// requestor is the document owner" expression: "document.owner == +// request.auth.claims.email" Example (Logic): title: "Public documents" +// description: "Determine whether the document should be publicly +// visible" expression: "document.type != 'private' && document.type != +// 'internal'" Example (Data Manipulation): title: "Notification string" +// description: "Create a notification string with a timestamp." +// expression: "'New message received at ' + +// string(document.create_time)" The exact variables and functions that +// may be referenced within an expression are determined by the service +// that evaluates it. See the service documentation for additional +// information. +type GoogleTypeExpr struct { + // Description: Optional. Description of the expression. This is a + // longer text which describes the expression, e.g. when hovered over it + // in a UI. + Description string `json:"description,omitempty"` + + // Expression: Textual representation of an expression in Common + // Expression Language syntax. + Expression string `json:"expression,omitempty"` + + // Location: Optional. String indicating the location of the expression + // for error reporting, e.g. a file name and a position in the file. + Location string `json:"location,omitempty"` + + // Title: Optional. Title for the expression, i.e. a short string + // describing its purpose. This can be used e.g. in UIs which allow to + // enter the expression. + Title string `json:"title,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Description") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Description") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleTypeExpr) MarshalJSON() ([]byte, error) { + type NoMethod GoogleTypeExpr + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// method id "iam.policies.createPolicy": + +type PoliciesCreatePolicyCall struct { + s *Service + parent string + googleiamv2betapolicy *GoogleIamV2betaPolicy + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// CreatePolicy: Creates a policy. +// +// - parent: The resource that the policy is attached to, along with the +// kind of policy to create. Format: +// `policies/{attachment-point}/denypolicies` The attachment point is +// identified by its URL-encoded full resource name, which means that +// the forward-slash character, `/`, must be written as `%2F`. For +// example, +// `policies/cloudresourcemanager.googleapis.com%2Fprojects%2Fmy-projec +// t/denypolicies`. For organizations and folders, use the numeric ID +// in the full resource name. For projects, you can use the +// alphanumeric or the numeric ID. +func (r *PoliciesService) CreatePolicy(parent string, googleiamv2betapolicy *GoogleIamV2betaPolicy) *PoliciesCreatePolicyCall { + c := &PoliciesCreatePolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleiamv2betapolicy = googleiamv2betapolicy + return c +} + +// PolicyId sets the optional parameter "policyId": The ID to use for +// this policy, which will become the final component of the policy's +// resource name. The ID must contain 3 to 63 characters. It can contain +// lowercase letters and numbers, as well as dashes (`-`) and periods +// (`.`). The first character must be a lowercase letter. +func (c *PoliciesCreatePolicyCall) PolicyId(policyId string) *PoliciesCreatePolicyCall { + c.urlParams_.Set("policyId", policyId) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *PoliciesCreatePolicyCall) Fields(s ...googleapi.Field) *PoliciesCreatePolicyCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *PoliciesCreatePolicyCall) Context(ctx context.Context) *PoliciesCreatePolicyCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *PoliciesCreatePolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *PoliciesCreatePolicyCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleiamv2betapolicy) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2beta/{+parent}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "iam.policies.createPolicy" call. +// Exactly one of *GoogleLongrunningOperation or error will be non-nil. +// 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 *PoliciesCreatePolicyCall) 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, &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, err + } + ret := &GoogleLongrunningOperation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Creates a policy.", + // "flatPath": "v2beta/policies/{policiesId}/{policiesId1}", + // "httpMethod": "POST", + // "id": "iam.policies.createPolicy", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "parent": { + // "description": "Required. The resource that the policy is attached to, along with the kind of policy to create. Format: `policies/{attachment-point}/denypolicies` The attachment point is identified by its URL-encoded full resource name, which means that the forward-slash character, `/`, must be written as `%2F`. For example, `policies/cloudresourcemanager.googleapis.com%2Fprojects%2Fmy-project/denypolicies`. For organizations and folders, use the numeric ID in the full resource name. For projects, you can use the alphanumeric or the numeric ID.", + // "location": "path", + // "pattern": "^policies/[^/]+/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "policyId": { + // "description": "The ID to use for this policy, which will become the final component of the policy's resource name. The ID must contain 3 to 63 characters. It can contain lowercase letters and numbers, as well as dashes (`-`) and periods (`.`). The first character must be a lowercase letter.", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v2beta/{+parent}", + // "request": { + // "$ref": "GoogleIamV2betaPolicy" + // }, + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "iam.policies.delete": + +type PoliciesDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes a policy. This action is permanent. +// +// - name: The resource name of the policy to delete. Format: +// `policies/{attachment-point}/denypolicies/{policy-id}` Use the +// URL-encoded full resource name, which means that the forward-slash +// character, `/`, must be written as `%2F`. For example, +// `policies/cloudresourcemanager.googleapis.com%2Fprojects%2Fmy-projec +// t/denypolicies/my-policy`. For organizations and folders, use the +// numeric ID in the full resource name. For projects, you can use the +// alphanumeric or the numeric ID. +func (r *PoliciesService) Delete(name string) *PoliciesDeleteCall { + c := &PoliciesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Etag sets the optional parameter "etag": The expected `etag` of the +// policy to delete. If the value does not match the value that is +// stored in IAM, the request fails with a `409` error code and +// `ABORTED` status. If you omit this field, the policy is deleted +// regardless of its current `etag`. +func (c *PoliciesDeleteCall) Etag(etag string) *PoliciesDeleteCall { + c.urlParams_.Set("etag", etag) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *PoliciesDeleteCall) Fields(s ...googleapi.Field) *PoliciesDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *PoliciesDeleteCall) Context(ctx context.Context) *PoliciesDeleteCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *PoliciesDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *PoliciesDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2beta/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("DELETE", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "iam.policies.delete" call. +// Exactly one of *GoogleLongrunningOperation or error will be non-nil. +// 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 *PoliciesDeleteCall) 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, &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, err + } + ret := &GoogleLongrunningOperation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Deletes a policy. This action is permanent.", + // "flatPath": "v2beta/policies/{policiesId}/{policiesId1}/{policiesId2}", + // "httpMethod": "DELETE", + // "id": "iam.policies.delete", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "etag": { + // "description": "Optional. The expected `etag` of the policy to delete. If the value does not match the value that is stored in IAM, the request fails with a `409` error code and `ABORTED` status. If you omit this field, the policy is deleted regardless of its current `etag`.", + // "location": "query", + // "type": "string" + // }, + // "name": { + // "description": "Required. The resource name of the policy to delete. Format: `policies/{attachment-point}/denypolicies/{policy-id}` Use the URL-encoded full resource name, which means that the forward-slash character, `/`, must be written as `%2F`. For example, `policies/cloudresourcemanager.googleapis.com%2Fprojects%2Fmy-project/denypolicies/my-policy`. For organizations and folders, use the numeric ID in the full resource name. For projects, you can use the alphanumeric or the numeric ID.", + // "location": "path", + // "pattern": "^policies/[^/]+/[^/]+/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v2beta/{+name}", + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "iam.policies.get": + +type PoliciesGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets a policy. +// +// - name: The resource name of the policy to retrieve. Format: +// `policies/{attachment-point}/denypolicies/{policy-id}` Use the +// URL-encoded full resource name, which means that the forward-slash +// character, `/`, must be written as `%2F`. For example, +// `policies/cloudresourcemanager.googleapis.com%2Fprojects%2Fmy-projec +// t/denypolicies/my-policy`. For organizations and folders, use the +// numeric ID in the full resource name. For projects, you can use the +// alphanumeric or the numeric ID. +func (r *PoliciesService) Get(name string) *PoliciesGetCall { + c := &PoliciesGetCall{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 information. +func (c *PoliciesGetCall) Fields(s ...googleapi.Field) *PoliciesGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *PoliciesGetCall) IfNoneMatch(entityTag string) *PoliciesGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *PoliciesGetCall) Context(ctx context.Context) *PoliciesGetCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *PoliciesGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *PoliciesGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2beta/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "iam.policies.get" call. +// Exactly one of *GoogleIamV2betaPolicy or error will be non-nil. Any +// non-2xx status code is an error. Response headers are in either +// *GoogleIamV2betaPolicy.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 *PoliciesGetCall) Do(opts ...googleapi.CallOption) (*GoogleIamV2betaPolicy, 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, &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, err + } + ret := &GoogleIamV2betaPolicy{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets a policy.", + // "flatPath": "v2beta/policies/{policiesId}/{policiesId1}/{policiesId2}", + // "httpMethod": "GET", + // "id": "iam.policies.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. The resource name of the policy to retrieve. Format: `policies/{attachment-point}/denypolicies/{policy-id}` Use the URL-encoded full resource name, which means that the forward-slash character, `/`, must be written as `%2F`. For example, `policies/cloudresourcemanager.googleapis.com%2Fprojects%2Fmy-project/denypolicies/my-policy`. For organizations and folders, use the numeric ID in the full resource name. For projects, you can use the alphanumeric or the numeric ID.", + // "location": "path", + // "pattern": "^policies/[^/]+/[^/]+/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v2beta/{+name}", + // "response": { + // "$ref": "GoogleIamV2betaPolicy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "iam.policies.listPolicies": + +type PoliciesListPoliciesCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// ListPolicies: Retrieves the policies of the specified kind that are +// attached to a resource. The response lists only policy metadata. In +// particular, policy rules are omitted. +// +// - parent: The resource that the policy is attached to, along with the +// kind of policy to list. Format: +// `policies/{attachment-point}/denypolicies` The attachment point is +// identified by its URL-encoded full resource name, which means that +// the forward-slash character, `/`, must be written as `%2F`. For +// example, +// `policies/cloudresourcemanager.googleapis.com%2Fprojects%2Fmy-projec +// t/denypolicies`. For organizations and folders, use the numeric ID +// in the full resource name. For projects, you can use the +// alphanumeric or the numeric ID. +func (r *PoliciesService) ListPolicies(parent string) *PoliciesListPoliciesCall { + c := &PoliciesListPoliciesCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number +// of policies to return. IAM ignores this value and uses the value +// 1000. +func (c *PoliciesListPoliciesCall) PageSize(pageSize int64) *PoliciesListPoliciesCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A page token +// received in a ListPoliciesResponse. Provide this token to retrieve +// the next page. +func (c *PoliciesListPoliciesCall) PageToken(pageToken string) *PoliciesListPoliciesCall { + 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 information. +func (c *PoliciesListPoliciesCall) Fields(s ...googleapi.Field) *PoliciesListPoliciesCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *PoliciesListPoliciesCall) IfNoneMatch(entityTag string) *PoliciesListPoliciesCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *PoliciesListPoliciesCall) Context(ctx context.Context) *PoliciesListPoliciesCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *PoliciesListPoliciesCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *PoliciesListPoliciesCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2beta/{+parent}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "iam.policies.listPolicies" call. +// Exactly one of *GoogleIamV2betaListPoliciesResponse or error will be +// non-nil. Any non-2xx status code is an error. Response headers are in +// either *GoogleIamV2betaListPoliciesResponse.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 *PoliciesListPoliciesCall) Do(opts ...googleapi.CallOption) (*GoogleIamV2betaListPoliciesResponse, 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, &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, err + } + ret := &GoogleIamV2betaListPoliciesResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Retrieves the policies of the specified kind that are attached to a resource. The response lists only policy metadata. In particular, policy rules are omitted.", + // "flatPath": "v2beta/policies/{policiesId}/{policiesId1}", + // "httpMethod": "GET", + // "id": "iam.policies.listPolicies", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "pageSize": { + // "description": "The maximum number of policies to return. IAM ignores this value and uses the value 1000.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "A page token received in a ListPoliciesResponse. Provide this token to retrieve the next page.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The resource that the policy is attached to, along with the kind of policy to list. Format: `policies/{attachment-point}/denypolicies` The attachment point is identified by its URL-encoded full resource name, which means that the forward-slash character, `/`, must be written as `%2F`. For example, `policies/cloudresourcemanager.googleapis.com%2Fprojects%2Fmy-project/denypolicies`. For organizations and folders, use the numeric ID in the full resource name. For projects, you can use the alphanumeric or the numeric ID.", + // "location": "path", + // "pattern": "^policies/[^/]+/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v2beta/{+parent}", + // "response": { + // "$ref": "GoogleIamV2betaListPoliciesResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// 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 *PoliciesListPoliciesCall) Pages(ctx context.Context, f func(*GoogleIamV2betaListPoliciesResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point + 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) + } +} + +// method id "iam.policies.update": + +type PoliciesUpdateCall struct { + s *Service + name string + googleiamv2betapolicy *GoogleIamV2betaPolicy + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Update: Updates the specified policy. You can update only the rules +// and the display name for the policy. To update a policy, you should +// use a read-modify-write loop: 1. Use GetPolicy to read the current +// version of the policy. 2. Modify the policy as needed. 3. Use +// `UpdatePolicy` to write the updated policy. This pattern helps +// prevent conflicts between concurrent updates. +// +// - name: Immutable. The resource name of the `Policy`, which must be +// unique. Format: +// `policies/{attachment-point}/denypolicies/{policy-id}` The +// attachment point is identified by its URL-encoded full resource +// name, which means that the forward-slash character, `/`, must be +// written as `%2F`. For example, +// `policies/cloudresourcemanager.googleapis.com%2Fprojects%2Fmy-projec +// t/denypolicies/my-deny-policy`. For organizations and folders, use +// the numeric ID in the full resource name. For projects, requests +// can use the alphanumeric or the numeric ID. Responses always +// contain the numeric ID. +func (r *PoliciesService) Update(name string, googleiamv2betapolicy *GoogleIamV2betaPolicy) *PoliciesUpdateCall { + c := &PoliciesUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googleiamv2betapolicy = googleiamv2betapolicy + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *PoliciesUpdateCall) Fields(s ...googleapi.Field) *PoliciesUpdateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *PoliciesUpdateCall) Context(ctx context.Context) *PoliciesUpdateCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *PoliciesUpdateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *PoliciesUpdateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.googleiamv2betapolicy) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2beta/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PUT", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "iam.policies.update" call. +// Exactly one of *GoogleLongrunningOperation or error will be non-nil. +// 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 *PoliciesUpdateCall) 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, &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, err + } + ret := &GoogleLongrunningOperation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Updates the specified policy. You can update only the rules and the display name for the policy. To update a policy, you should use a read-modify-write loop: 1. Use GetPolicy to read the current version of the policy. 2. Modify the policy as needed. 3. Use `UpdatePolicy` to write the updated policy. This pattern helps prevent conflicts between concurrent updates.", + // "flatPath": "v2beta/policies/{policiesId}/{policiesId1}/{policiesId2}", + // "httpMethod": "PUT", + // "id": "iam.policies.update", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Immutable. The resource name of the `Policy`, which must be unique. Format: `policies/{attachment-point}/denypolicies/{policy-id}` The attachment point is identified by its URL-encoded full resource name, which means that the forward-slash character, `/`, must be written as `%2F`. For example, `policies/cloudresourcemanager.googleapis.com%2Fprojects%2Fmy-project/denypolicies/my-deny-policy`. For organizations and folders, use the numeric ID in the full resource name. For projects, requests can use the alphanumeric or the numeric ID. Responses always contain the numeric ID.", + // "location": "path", + // "pattern": "^policies/[^/]+/[^/]+/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v2beta/{+name}", + // "request": { + // "$ref": "GoogleIamV2betaPolicy" + // }, + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "iam.policies.operations.get": + +type PoliciesOperationsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets the latest state of a long-running operation. Clients can +// use this method to poll the operation result at intervals as +// recommended by the API service. +// +// - name: The name of the operation resource. +func (r *PoliciesOperationsService) Get(name string) *PoliciesOperationsGetCall { + c := &PoliciesOperationsGetCall{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 information. +func (c *PoliciesOperationsGetCall) Fields(s ...googleapi.Field) *PoliciesOperationsGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *PoliciesOperationsGetCall) IfNoneMatch(entityTag string) *PoliciesOperationsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *PoliciesOperationsGetCall) Context(ctx context.Context) *PoliciesOperationsGetCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *PoliciesOperationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *PoliciesOperationsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2beta/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "iam.policies.operations.get" call. +// Exactly one of *GoogleLongrunningOperation or error will be non-nil. +// 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 *PoliciesOperationsGetCall) 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, &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, err + } + ret := &GoogleLongrunningOperation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", + // "flatPath": "v2beta/policies/{policiesId}/{policiesId1}/{policiesId2}/operations/{operationsId}", + // "httpMethod": "GET", + // "id": "iam.policies.operations.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "The name of the operation resource.", + // "location": "path", + // "pattern": "^policies/[^/]+/[^/]+/[^/]+/operations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v2beta/{+name}", + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} diff --git a/policytroubleshooter/v1/policytroubleshooter-api.json b/policytroubleshooter/v1/policytroubleshooter-api.json index a0360864cc5..bed2c89369e 100644 --- a/policytroubleshooter/v1/policytroubleshooter-api.json +++ b/policytroubleshooter/v1/policytroubleshooter-api.json @@ -128,7 +128,7 @@ } } }, - "revision": "20220402", + "revision": "20220415", "rootUrl": "https://policytroubleshooter.googleapis.com/", "schemas": { "GoogleCloudPolicytroubleshooterV1AccessTuple": { @@ -360,6 +360,13 @@ ], "type": "string" }, + "errors": { + "description": "The general errors contained in the troubleshooting response.", + "items": { + "$ref": "GoogleRpcStatus" + }, + "type": "array" + }, "explainedPolicies": { "description": "List of IAM policies that were evaluated to check the principal's permissions, with annotations to indicate how each policy contributed to the final result. The list of policies can include the policy for the resource itself. It can also include policies that are inherited from higher levels of the resource hierarchy, including the organization, the folder, and the project. To learn more about the resource hierarchy, see https://cloud.google.com/iam/help/resource-hierarchy.", "items": { @@ -471,6 +478,33 @@ }, "type": "object" }, + "GoogleRpcStatus": { + "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", + "id": "GoogleRpcStatus", + "properties": { + "code": { + "description": "The status code, which should be an enum value of google.rpc.Code.", + "format": "int32", + "type": "integer" + }, + "details": { + "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", + "items": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.", + "type": "string" + } + }, + "type": "object" + }, "GoogleTypeExpr": { "description": "Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: \"Summary size limit\" description: \"Determines if a summary is less than 100 chars\" expression: \"document.summary.size() \u003c 100\" Example (Equality): title: \"Requestor is owner\" description: \"Determines if requestor is the document owner\" expression: \"document.owner == request.auth.claims.email\" Example (Logic): title: \"Public documents\" description: \"Determine whether the document should be publicly visible\" expression: \"document.type != 'private' \u0026\u0026 document.type != 'internal'\" Example (Data Manipulation): title: \"Notification string\" description: \"Create a notification string with a timestamp.\" expression: \"'New message received at ' + string(document.create_time)\" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information.", "id": "GoogleTypeExpr", diff --git a/policytroubleshooter/v1/policytroubleshooter-gen.go b/policytroubleshooter/v1/policytroubleshooter-gen.go index de67ebf64ab..6fe2fc90abc 100644 --- a/policytroubleshooter/v1/policytroubleshooter-gen.go +++ b/policytroubleshooter/v1/policytroubleshooter-gen.go @@ -494,6 +494,9 @@ type GoogleCloudPolicytroubleshooterV1TroubleshootIamPolicyResponse struct { // evaluate. Access string `json:"access,omitempty"` + // Errors: The general errors contained in the troubleshooting response. + Errors []*GoogleRpcStatus `json:"errors,omitempty"` + // ExplainedPolicies: List of IAM policies that were evaluated to check // the principal's permissions, with annotations to indicate how each // policy contributed to the final result. The list of policies can @@ -808,6 +811,50 @@ func (s *GoogleIamV1Policy) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleRpcStatus: The `Status` type defines a logical error model that +// is suitable for different programming environments, including REST +// APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each +// `Status` message contains three pieces of data: error code, error +// message, and error details. You can find out more about this error +// model and how to work with it in the API Design Guide +// (https://cloud.google.com/apis/design/errors). +type GoogleRpcStatus struct { + // Code: The status code, which should be an enum value of + // google.rpc.Code. + Code int64 `json:"code,omitempty"` + + // Details: A list of messages that carry the error details. There is a + // common set of message types for APIs to use. + Details []googleapi.RawMessage `json:"details,omitempty"` + + // Message: A developer-facing error message, which should be in + // English. Any user-facing error message should be localized and sent + // in the google.rpc.Status.details field, or localized by the client. + 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. However, any + // non-pointer, non-interface field appearing in ForceSendFields will be + // sent to the server regardless of whether the field is empty or not. + // This may be used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Code") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *GoogleRpcStatus) MarshalJSON() ([]byte, error) { + type NoMethod GoogleRpcStatus + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleTypeExpr: Represents a textual expression in the Common // Expression Language (CEL) syntax. CEL is a C-like expression // language. The syntax and semantics of CEL are documented at diff --git a/privateca/v1/privateca-api.json b/privateca/v1/privateca-api.json index 2c0b6da08d6..5147792706f 100644 --- a/privateca/v1/privateca-api.json +++ b/privateca/v1/privateca-api.json @@ -144,7 +144,7 @@ ], "parameters": { "filter": { - "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like \"displayName=tokyo\", and is documented in more detail in [AIP-160](https://google.aip.dev/160).", + "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).", "location": "query", "type": "string" }, @@ -1595,7 +1595,7 @@ } } }, - "revision": "20220323", + "revision": "20220406", "rootUrl": "https://privateca.googleapis.com/", "schemas": { "AccessUrls": { @@ -1707,7 +1707,7 @@ "description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)." }, "members": { - "description": "Specifies the principals requesting access for a Cloud Platform resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ", + "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ", "items": { "type": "string" }, @@ -3101,7 +3101,7 @@ "properties": { "policy": { "$ref": "Policy", - "description": "REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Cloud Platform services (such as Projects) might reject them." + "description": "REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Google Cloud services (such as Projects) might reject them." }, "updateMask": { "description": "OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only the fields in the mask will be modified. If no mask is provided, the following default mask is used: `paths: \"bindings, etag\"`", @@ -3302,7 +3302,7 @@ "id": "TestIamPermissionsRequest", "properties": { "permissions": { - "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as '*' or 'storage.*') are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", + "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as `*` or `storage.*`) are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", "items": { "type": "string" }, diff --git a/privateca/v1/privateca-gen.go b/privateca/v1/privateca-gen.go index 3aca202b924..0310149c390 100644 --- a/privateca/v1/privateca-gen.go +++ b/privateca/v1/privateca-gen.go @@ -459,8 +459,8 @@ type Binding struct { // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *Expr `json:"condition,omitempty"` - // Members: Specifies the principals requesting access for a Cloud - // Platform resource. `members` can have the following values: * + // Members: Specifies the principals requesting access for a Google + // Cloud resource. `members` can have the following values: * // `allUsers`: A special identifier that represents anyone who is on the // internet; with or without a Google account. * // `allAuthenticatedUsers`: A special identifier that represents anyone @@ -2870,7 +2870,7 @@ func (s *RsaKeyType) MarshalJSON() ([]byte, error) { type SetIamPolicyRequest struct { // Policy: REQUIRED: The complete policy to be applied to the // `resource`. The size of the policy is limited to a few 10s of KB. An - // empty policy is a valid policy but certain Cloud Platform services + // empty policy is a valid policy but certain Google Cloud services // (such as Projects) might reject them. Policy *Policy `json:"policy,omitempty"` @@ -3203,7 +3203,7 @@ func (s *SubordinateConfigChain) MarshalJSON() ([]byte, error) { // method. type TestIamPermissionsRequest struct { // Permissions: The set of permissions to check for the `resource`. - // Permissions with wildcards (such as '*' or 'storage.*') are not + // Permissions with wildcards (such as `*` or `storage.*`) are not // allowed. For more information see IAM Overview // (https://cloud.google.com/iam/docs/overview#permissions). Permissions []string `json:"permissions,omitempty"` @@ -3563,8 +3563,8 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall // Filter sets the optional parameter "filter": A filter to narrow down // results to a preferred subset. The filtering language accepts strings -// like "displayName=tokyo", and is documented in more detail in AIP-160 -// (https://google.aip.dev/160). +// like "displayName=tokyo", and is documented in more detail in +// AIP-160 (https://google.aip.dev/160). func (c *ProjectsLocationsListCall) Filter(filter string) *ProjectsLocationsListCall { c.urlParams_.Set("filter", filter) return c @@ -3693,7 +3693,7 @@ func (c *ProjectsLocationsListCall) Do(opts ...googleapi.CallOption) (*ListLocat // ], // "parameters": { // "filter": { - // "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like \"displayName=tokyo\", and is documented in more detail in [AIP-160](https://google.aip.dev/160).", + // "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).", // "location": "query", // "type": "string" // }, diff --git a/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-api.json b/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-api.json index 95d1479bf2a..23b02af155b 100644 --- a/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-api.json +++ b/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-api.json @@ -1,13 +1,4 @@ { - "auth": { - "oauth2": { - "scopes": { - "https://www.googleapis.com/auth/userinfo.email": { - "description": "See your primary Google Account email address" - } - } - } - }, "basePath": "", "baseUrl": "https://prod-tt-sasportal.googleapis.com/", "batchPath": "batch", @@ -127,10 +118,7 @@ "path": "v1alpha1/{+name}", "response": { "$ref": "SasPortalCustomer" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "list": { "description": "Returns a list of requested customers.", @@ -154,10 +142,7 @@ "path": "v1alpha1/customers", "response": { "$ref": "SasPortalListCustomersResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "patch": { "description": "Updates an existing customer.", @@ -188,10 +173,7 @@ }, "response": { "$ref": "SasPortalCustomer" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } } }, "resources": { @@ -220,10 +202,7 @@ }, "response": { "$ref": "SasPortalDeployment" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "delete": { "description": "Deletes a deployment.", @@ -245,10 +224,7 @@ "path": "v1alpha1/{+name}", "response": { "$ref": "SasPortalEmpty" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "get": { "description": "Returns a requested deployment.", @@ -270,10 +246,7 @@ "path": "v1alpha1/{+name}", "response": { "$ref": "SasPortalDeployment" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "list": { "description": "Lists deployments.", @@ -311,10 +284,7 @@ "path": "v1alpha1/{+parent}/deployments", "response": { "$ref": "SasPortalListDeploymentsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "move": { "description": "Moves a deployment under another node or customer.", @@ -339,10 +309,7 @@ }, "response": { "$ref": "SasPortalOperation" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "patch": { "description": "Updates an existing deployment.", @@ -373,10 +340,7 @@ }, "response": { "$ref": "SasPortalDeployment" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } } }, "resources": { @@ -405,10 +369,7 @@ }, "response": { "$ref": "SasPortalDevice" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "createSigned": { "description": "Creates a signed device under a node or customer.", @@ -433,10 +394,7 @@ }, "response": { "$ref": "SasPortalDevice" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "list": { "description": "Lists devices under a node or customer.", @@ -474,10 +432,7 @@ "path": "v1alpha1/{+parent}/devices", "response": { "$ref": "SasPortalListDevicesResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } } } } @@ -508,10 +463,7 @@ }, "response": { "$ref": "SasPortalDevice" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "createSigned": { "description": "Creates a signed device under a node or customer.", @@ -536,10 +488,7 @@ }, "response": { "$ref": "SasPortalDevice" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "delete": { "description": "Deletes a device.", @@ -561,10 +510,7 @@ "path": "v1alpha1/{+name}", "response": { "$ref": "SasPortalEmpty" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "get": { "description": "Gets details about a device.", @@ -586,10 +532,7 @@ "path": "v1alpha1/{+name}", "response": { "$ref": "SasPortalDevice" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "list": { "description": "Lists devices under a node or customer.", @@ -627,10 +570,7 @@ "path": "v1alpha1/{+parent}/devices", "response": { "$ref": "SasPortalListDevicesResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "move": { "description": "Moves a device under another node or customer.", @@ -655,10 +595,7 @@ }, "response": { "$ref": "SasPortalOperation" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "patch": { "description": "Updates a device.", @@ -689,10 +626,7 @@ }, "response": { "$ref": "SasPortalDevice" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "signDevice": { "description": "Signs a device.", @@ -717,10 +651,7 @@ }, "response": { "$ref": "SasPortalEmpty" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "updateSigned": { "description": "Updates a signed device.", @@ -745,10 +676,7 @@ }, "response": { "$ref": "SasPortalDevice" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } } } }, @@ -777,10 +705,7 @@ }, "response": { "$ref": "SasPortalNode" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "delete": { "description": "Deletes a node.", @@ -802,10 +727,7 @@ "path": "v1alpha1/{+name}", "response": { "$ref": "SasPortalEmpty" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "get": { "description": "Returns a requested node.", @@ -827,10 +749,7 @@ "path": "v1alpha1/{+name}", "response": { "$ref": "SasPortalNode" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "list": { "description": "Lists nodes.", @@ -868,10 +787,7 @@ "path": "v1alpha1/{+parent}/nodes", "response": { "$ref": "SasPortalListNodesResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "move": { "description": "Moves a node under another node or customer.", @@ -896,10 +812,7 @@ }, "response": { "$ref": "SasPortalOperation" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "patch": { "description": "Updates an existing node.", @@ -930,10 +843,7 @@ }, "response": { "$ref": "SasPortalNode" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } } }, "resources": { @@ -962,10 +872,7 @@ }, "response": { "$ref": "SasPortalDeployment" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "list": { "description": "Lists deployments.", @@ -1003,10 +910,7 @@ "path": "v1alpha1/{+parent}/deployments", "response": { "$ref": "SasPortalListDeploymentsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } } } }, @@ -1035,10 +939,7 @@ }, "response": { "$ref": "SasPortalDevice" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "createSigned": { "description": "Creates a signed device under a node or customer.", @@ -1063,10 +964,7 @@ }, "response": { "$ref": "SasPortalDevice" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "list": { "description": "Lists devices under a node or customer.", @@ -1104,10 +1002,7 @@ "path": "v1alpha1/{+parent}/devices", "response": { "$ref": "SasPortalListDevicesResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } } } }, @@ -1136,10 +1031,7 @@ }, "response": { "$ref": "SasPortalNode" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "list": { "description": "Lists nodes.", @@ -1177,10 +1069,7 @@ "path": "v1alpha1/{+parent}/nodes", "response": { "$ref": "SasPortalListNodesResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } } } } @@ -1210,10 +1099,7 @@ "path": "v1alpha1/{+name}", "response": { "$ref": "SasPortalDeployment" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } } }, "resources": { @@ -1239,10 +1125,7 @@ "path": "v1alpha1/{+name}", "response": { "$ref": "SasPortalEmpty" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "get": { "description": "Gets details about a device.", @@ -1264,10 +1147,7 @@ "path": "v1alpha1/{+name}", "response": { "$ref": "SasPortalDevice" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "move": { "description": "Moves a device under another node or customer.", @@ -1292,10 +1172,7 @@ }, "response": { "$ref": "SasPortalOperation" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "patch": { "description": "Updates a device.", @@ -1326,10 +1203,7 @@ }, "response": { "$ref": "SasPortalDevice" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "signDevice": { "description": "Signs a device.", @@ -1354,10 +1228,7 @@ }, "response": { "$ref": "SasPortalEmpty" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "updateSigned": { "description": "Updates a signed device.", @@ -1382,10 +1253,7 @@ }, "response": { "$ref": "SasPortalDevice" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } } } } @@ -1406,10 +1274,7 @@ }, "response": { "$ref": "SasPortalGenerateSecretResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "validate": { "description": "Validates the identity of a Certified Professional Installer (CPI).", @@ -1424,10 +1289,7 @@ }, "response": { "$ref": "SasPortalValidateInstallerResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } } } }, @@ -1453,10 +1315,7 @@ "path": "v1alpha1/{+name}", "response": { "$ref": "SasPortalNode" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } } }, "resources": { @@ -1482,10 +1341,7 @@ "path": "v1alpha1/{+name}", "response": { "$ref": "SasPortalEmpty" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "get": { "description": "Returns a requested deployment.", @@ -1507,10 +1363,7 @@ "path": "v1alpha1/{+name}", "response": { "$ref": "SasPortalDeployment" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "list": { "description": "Lists deployments.", @@ -1548,10 +1401,7 @@ "path": "v1alpha1/{+parent}/deployments", "response": { "$ref": "SasPortalListDeploymentsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "move": { "description": "Moves a deployment under another node or customer.", @@ -1576,10 +1426,7 @@ }, "response": { "$ref": "SasPortalOperation" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "patch": { "description": "Updates an existing deployment.", @@ -1610,10 +1457,7 @@ }, "response": { "$ref": "SasPortalDeployment" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } } }, "resources": { @@ -1642,10 +1486,7 @@ }, "response": { "$ref": "SasPortalDevice" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "createSigned": { "description": "Creates a signed device under a node or customer.", @@ -1670,10 +1511,7 @@ }, "response": { "$ref": "SasPortalDevice" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "list": { "description": "Lists devices under a node or customer.", @@ -1711,10 +1549,7 @@ "path": "v1alpha1/{+parent}/devices", "response": { "$ref": "SasPortalListDevicesResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } } } } @@ -1745,10 +1580,7 @@ }, "response": { "$ref": "SasPortalDevice" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "createSigned": { "description": "Creates a signed device under a node or customer.", @@ -1773,10 +1605,7 @@ }, "response": { "$ref": "SasPortalDevice" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "delete": { "description": "Deletes a device.", @@ -1798,10 +1627,7 @@ "path": "v1alpha1/{+name}", "response": { "$ref": "SasPortalEmpty" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "get": { "description": "Gets details about a device.", @@ -1823,10 +1649,7 @@ "path": "v1alpha1/{+name}", "response": { "$ref": "SasPortalDevice" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "list": { "description": "Lists devices under a node or customer.", @@ -1864,10 +1687,7 @@ "path": "v1alpha1/{+parent}/devices", "response": { "$ref": "SasPortalListDevicesResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "move": { "description": "Moves a device under another node or customer.", @@ -1892,10 +1712,7 @@ }, "response": { "$ref": "SasPortalOperation" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "patch": { "description": "Updates a device.", @@ -1926,10 +1743,7 @@ }, "response": { "$ref": "SasPortalDevice" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "signDevice": { "description": "Signs a device.", @@ -1954,10 +1768,7 @@ }, "response": { "$ref": "SasPortalEmpty" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "updateSigned": { "description": "Updates a signed device.", @@ -1982,10 +1793,7 @@ }, "response": { "$ref": "SasPortalDevice" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } } } }, @@ -2014,10 +1822,7 @@ }, "response": { "$ref": "SasPortalNode" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "delete": { "description": "Deletes a node.", @@ -2039,10 +1844,7 @@ "path": "v1alpha1/{+name}", "response": { "$ref": "SasPortalEmpty" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "get": { "description": "Returns a requested node.", @@ -2064,10 +1866,7 @@ "path": "v1alpha1/{+name}", "response": { "$ref": "SasPortalNode" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "list": { "description": "Lists nodes.", @@ -2105,10 +1904,7 @@ "path": "v1alpha1/{+parent}/nodes", "response": { "$ref": "SasPortalListNodesResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "move": { "description": "Moves a node under another node or customer.", @@ -2133,10 +1929,7 @@ }, "response": { "$ref": "SasPortalOperation" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "patch": { "description": "Updates an existing node.", @@ -2167,10 +1960,7 @@ }, "response": { "$ref": "SasPortalNode" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } } }, "resources": { @@ -2199,10 +1989,7 @@ }, "response": { "$ref": "SasPortalDeployment" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "list": { "description": "Lists deployments.", @@ -2240,10 +2027,7 @@ "path": "v1alpha1/{+parent}/deployments", "response": { "$ref": "SasPortalListDeploymentsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } } } }, @@ -2272,10 +2056,7 @@ }, "response": { "$ref": "SasPortalDevice" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "createSigned": { "description": "Creates a signed device under a node or customer.", @@ -2300,10 +2081,7 @@ }, "response": { "$ref": "SasPortalDevice" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "list": { "description": "Lists devices under a node or customer.", @@ -2341,10 +2119,7 @@ "path": "v1alpha1/{+parent}/devices", "response": { "$ref": "SasPortalListDevicesResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } } } }, @@ -2373,10 +2148,7 @@ }, "response": { "$ref": "SasPortalNode" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "list": { "description": "Lists nodes.", @@ -2414,10 +2186,7 @@ "path": "v1alpha1/{+parent}/nodes", "response": { "$ref": "SasPortalListNodesResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } } } } @@ -2440,10 +2209,7 @@ }, "response": { "$ref": "SasPortalPolicy" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "set": { "description": "Sets the access control policy on the specified resource. Replaces any existing policy.", @@ -2458,10 +2224,7 @@ }, "response": { "$ref": "SasPortalPolicy" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } }, "test": { "description": "Returns permissions that a caller has on the specified resource.", @@ -2476,15 +2239,12 @@ }, "response": { "$ref": "SasPortalTestPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/userinfo.email" - ] + } } } } }, - "revision": "20220319", + "revision": "20220415", "rootUrl": "https://prod-tt-sasportal.googleapis.com/", "schemas": { "SasPortalAssignment": { diff --git a/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-gen.go b/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-gen.go index 3c628164280..3c5a6e42287 100644 --- a/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-gen.go +++ b/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-gen.go @@ -78,19 +78,8 @@ const apiVersion = "v1alpha1" const basePath = "https://prod-tt-sasportal.googleapis.com/" const mtlsBasePath = "https://prod-tt-sasportal.mtls.googleapis.com/" -// OAuth2 scopes used by this API. -const ( - // See your primary Google Account email address - UserinfoEmailScope = "https://www.googleapis.com/auth/userinfo.email" -) - // NewService creates a new Service. func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, error) { - scopesOption := internaloption.WithDefaultScopes( - "https://www.googleapis.com/auth/userinfo.email", - ) - // NOTE: prepend, so we don't override user-specified scopes. - opts = append([]option.ClientOption{scopesOption}, opts...) opts = append(opts, internaloption.WithDefaultEndpoint(basePath)) opts = append(opts, internaloption.WithDefaultMTLSEndpoint(mtlsBasePath)) client, endpoint, err := htransport.NewClient(ctx, opts...) @@ -2061,10 +2050,7 @@ func (c *CustomersGetCall) Do(opts ...googleapi.CallOption) (*SasPortalCustomer, // "path": "v1alpha1/{+name}", // "response": { // "$ref": "SasPortalCustomer" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -2217,10 +2203,7 @@ func (c *CustomersListCall) Do(opts ...googleapi.CallOption) (*SasPortalListCust // "path": "v1alpha1/customers", // "response": { // "$ref": "SasPortalListCustomersResponse" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -2393,10 +2376,7 @@ func (c *CustomersPatchCall) Do(opts ...googleapi.CallOption) (*SasPortalCustome // }, // "response": { // "$ref": "SasPortalCustomer" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -2536,10 +2516,7 @@ func (c *CustomersDeploymentsCreateCall) Do(opts ...googleapi.CallOption) (*SasP // }, // "response": { // "$ref": "SasPortalDeployment" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -2668,10 +2645,7 @@ func (c *CustomersDeploymentsDeleteCall) Do(opts ...googleapi.CallOption) (*SasP // "path": "v1alpha1/{+name}", // "response": { // "$ref": "SasPortalEmpty" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -2814,10 +2788,7 @@ func (c *CustomersDeploymentsGetCall) Do(opts ...googleapi.CallOption) (*SasPort // "path": "v1alpha1/{+name}", // "response": { // "$ref": "SasPortalDeployment" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -3001,10 +2972,7 @@ func (c *CustomersDeploymentsListCall) Do(opts ...googleapi.CallOption) (*SasPor // "path": "v1alpha1/{+parent}/deployments", // "response": { // "$ref": "SasPortalListDeploymentsResponse" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -3164,10 +3132,7 @@ func (c *CustomersDeploymentsMoveCall) Do(opts ...googleapi.CallOption) (*SasPor // }, // "response": { // "$ref": "SasPortalOperation" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -3319,10 +3284,7 @@ func (c *CustomersDeploymentsPatchCall) Do(opts ...googleapi.CallOption) (*SasPo // }, // "response": { // "$ref": "SasPortalDeployment" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -3461,10 +3423,7 @@ func (c *CustomersDeploymentsDevicesCreateCall) Do(opts ...googleapi.CallOption) // }, // "response": { // "$ref": "SasPortalDevice" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -3603,10 +3562,7 @@ func (c *CustomersDeploymentsDevicesCreateSignedCall) Do(opts ...googleapi.CallO // }, // "response": { // "$ref": "SasPortalDevice" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -3790,10 +3746,7 @@ func (c *CustomersDeploymentsDevicesListCall) Do(opts ...googleapi.CallOption) ( // "path": "v1alpha1/{+parent}/devices", // "response": { // "$ref": "SasPortalListDevicesResponse" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -3953,10 +3906,7 @@ func (c *CustomersDevicesCreateCall) Do(opts ...googleapi.CallOption) (*SasPorta // }, // "response": { // "$ref": "SasPortalDevice" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -4095,10 +4045,7 @@ func (c *CustomersDevicesCreateSignedCall) Do(opts ...googleapi.CallOption) (*Sa // }, // "response": { // "$ref": "SasPortalDevice" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -4227,10 +4174,7 @@ func (c *CustomersDevicesDeleteCall) Do(opts ...googleapi.CallOption) (*SasPorta // "path": "v1alpha1/{+name}", // "response": { // "$ref": "SasPortalEmpty" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -4373,10 +4317,7 @@ func (c *CustomersDevicesGetCall) Do(opts ...googleapi.CallOption) (*SasPortalDe // "path": "v1alpha1/{+name}", // "response": { // "$ref": "SasPortalDevice" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -4560,10 +4501,7 @@ func (c *CustomersDevicesListCall) Do(opts ...googleapi.CallOption) (*SasPortalL // "path": "v1alpha1/{+parent}/devices", // "response": { // "$ref": "SasPortalListDevicesResponse" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -4723,10 +4661,7 @@ func (c *CustomersDevicesMoveCall) Do(opts ...googleapi.CallOption) (*SasPortalO // }, // "response": { // "$ref": "SasPortalOperation" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -4878,10 +4813,7 @@ func (c *CustomersDevicesPatchCall) Do(opts ...googleapi.CallOption) (*SasPortal // }, // "response": { // "$ref": "SasPortalDevice" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -5020,10 +4952,7 @@ func (c *CustomersDevicesSignDeviceCall) Do(opts ...googleapi.CallOption) (*SasP // }, // "response": { // "$ref": "SasPortalEmpty" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -5162,10 +5091,7 @@ func (c *CustomersDevicesUpdateSignedCall) Do(opts ...googleapi.CallOption) (*Sa // }, // "response": { // "$ref": "SasPortalDevice" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -5304,10 +5230,7 @@ func (c *CustomersNodesCreateCall) Do(opts ...googleapi.CallOption) (*SasPortalN // }, // "response": { // "$ref": "SasPortalNode" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -5436,10 +5359,7 @@ func (c *CustomersNodesDeleteCall) Do(opts ...googleapi.CallOption) (*SasPortalE // "path": "v1alpha1/{+name}", // "response": { // "$ref": "SasPortalEmpty" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -5582,10 +5502,7 @@ func (c *CustomersNodesGetCall) Do(opts ...googleapi.CallOption) (*SasPortalNode // "path": "v1alpha1/{+name}", // "response": { // "$ref": "SasPortalNode" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -5768,10 +5685,7 @@ func (c *CustomersNodesListCall) Do(opts ...googleapi.CallOption) (*SasPortalLis // "path": "v1alpha1/{+parent}/nodes", // "response": { // "$ref": "SasPortalListNodesResponse" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -5931,10 +5845,7 @@ func (c *CustomersNodesMoveCall) Do(opts ...googleapi.CallOption) (*SasPortalOpe // }, // "response": { // "$ref": "SasPortalOperation" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -6086,10 +5997,7 @@ func (c *CustomersNodesPatchCall) Do(opts ...googleapi.CallOption) (*SasPortalNo // }, // "response": { // "$ref": "SasPortalNode" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -6229,10 +6137,7 @@ func (c *CustomersNodesDeploymentsCreateCall) Do(opts ...googleapi.CallOption) ( // }, // "response": { // "$ref": "SasPortalDeployment" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -6416,10 +6321,7 @@ func (c *CustomersNodesDeploymentsListCall) Do(opts ...googleapi.CallOption) (*S // "path": "v1alpha1/{+parent}/deployments", // "response": { // "$ref": "SasPortalListDeploymentsResponse" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -6579,10 +6481,7 @@ func (c *CustomersNodesDevicesCreateCall) Do(opts ...googleapi.CallOption) (*Sas // }, // "response": { // "$ref": "SasPortalDevice" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -6721,10 +6620,7 @@ func (c *CustomersNodesDevicesCreateSignedCall) Do(opts ...googleapi.CallOption) // }, // "response": { // "$ref": "SasPortalDevice" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -6908,10 +6804,7 @@ func (c *CustomersNodesDevicesListCall) Do(opts ...googleapi.CallOption) (*SasPo // "path": "v1alpha1/{+parent}/devices", // "response": { // "$ref": "SasPortalListDevicesResponse" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -7071,10 +6964,7 @@ func (c *CustomersNodesNodesCreateCall) Do(opts ...googleapi.CallOption) (*SasPo // }, // "response": { // "$ref": "SasPortalNode" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -7257,10 +7147,7 @@ func (c *CustomersNodesNodesListCall) Do(opts ...googleapi.CallOption) (*SasPort // "path": "v1alpha1/{+parent}/nodes", // "response": { // "$ref": "SasPortalListNodesResponse" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -7424,10 +7311,7 @@ func (c *DeploymentsGetCall) Do(opts ...googleapi.CallOption) (*SasPortalDeploym // "path": "v1alpha1/{+name}", // "response": { // "$ref": "SasPortalDeployment" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -7556,10 +7440,7 @@ func (c *DeploymentsDevicesDeleteCall) Do(opts ...googleapi.CallOption) (*SasPor // "path": "v1alpha1/{+name}", // "response": { // "$ref": "SasPortalEmpty" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -7702,10 +7583,7 @@ func (c *DeploymentsDevicesGetCall) Do(opts ...googleapi.CallOption) (*SasPortal // "path": "v1alpha1/{+name}", // "response": { // "$ref": "SasPortalDevice" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -7844,10 +7722,7 @@ func (c *DeploymentsDevicesMoveCall) Do(opts ...googleapi.CallOption) (*SasPorta // }, // "response": { // "$ref": "SasPortalOperation" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -7999,10 +7874,7 @@ func (c *DeploymentsDevicesPatchCall) Do(opts ...googleapi.CallOption) (*SasPort // }, // "response": { // "$ref": "SasPortalDevice" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -8141,10 +8013,7 @@ func (c *DeploymentsDevicesSignDeviceCall) Do(opts ...googleapi.CallOption) (*Sa // }, // "response": { // "$ref": "SasPortalEmpty" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -8283,10 +8152,7 @@ func (c *DeploymentsDevicesUpdateSignedCall) Do(opts ...googleapi.CallOption) (* // }, // "response": { // "$ref": "SasPortalDevice" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -8409,10 +8275,7 @@ func (c *InstallerGenerateSecretCall) Do(opts ...googleapi.CallOption) (*SasPort // }, // "response": { // "$ref": "SasPortalGenerateSecretResponse" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -8536,10 +8399,7 @@ func (c *InstallerValidateCall) Do(opts ...googleapi.CallOption) (*SasPortalVali // }, // "response": { // "$ref": "SasPortalValidateInstallerResponse" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -8682,10 +8542,7 @@ func (c *NodesGetCall) Do(opts ...googleapi.CallOption) (*SasPortalNode, error) // "path": "v1alpha1/{+name}", // "response": { // "$ref": "SasPortalNode" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -8814,10 +8671,7 @@ func (c *NodesDeploymentsDeleteCall) Do(opts ...googleapi.CallOption) (*SasPorta // "path": "v1alpha1/{+name}", // "response": { // "$ref": "SasPortalEmpty" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -8960,10 +8814,7 @@ func (c *NodesDeploymentsGetCall) Do(opts ...googleapi.CallOption) (*SasPortalDe // "path": "v1alpha1/{+name}", // "response": { // "$ref": "SasPortalDeployment" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -9147,10 +8998,7 @@ func (c *NodesDeploymentsListCall) Do(opts ...googleapi.CallOption) (*SasPortalL // "path": "v1alpha1/{+parent}/deployments", // "response": { // "$ref": "SasPortalListDeploymentsResponse" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -9310,10 +9158,7 @@ func (c *NodesDeploymentsMoveCall) Do(opts ...googleapi.CallOption) (*SasPortalO // }, // "response": { // "$ref": "SasPortalOperation" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -9465,10 +9310,7 @@ func (c *NodesDeploymentsPatchCall) Do(opts ...googleapi.CallOption) (*SasPortal // }, // "response": { // "$ref": "SasPortalDeployment" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -9607,10 +9449,7 @@ func (c *NodesDeploymentsDevicesCreateCall) Do(opts ...googleapi.CallOption) (*S // }, // "response": { // "$ref": "SasPortalDevice" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -9749,10 +9588,7 @@ func (c *NodesDeploymentsDevicesCreateSignedCall) Do(opts ...googleapi.CallOptio // }, // "response": { // "$ref": "SasPortalDevice" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -9936,10 +9772,7 @@ func (c *NodesDeploymentsDevicesListCall) Do(opts ...googleapi.CallOption) (*Sas // "path": "v1alpha1/{+parent}/devices", // "response": { // "$ref": "SasPortalListDevicesResponse" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -10099,10 +9932,7 @@ func (c *NodesDevicesCreateCall) Do(opts ...googleapi.CallOption) (*SasPortalDev // }, // "response": { // "$ref": "SasPortalDevice" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -10241,10 +10071,7 @@ func (c *NodesDevicesCreateSignedCall) Do(opts ...googleapi.CallOption) (*SasPor // }, // "response": { // "$ref": "SasPortalDevice" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -10373,10 +10200,7 @@ func (c *NodesDevicesDeleteCall) Do(opts ...googleapi.CallOption) (*SasPortalEmp // "path": "v1alpha1/{+name}", // "response": { // "$ref": "SasPortalEmpty" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -10519,10 +10343,7 @@ func (c *NodesDevicesGetCall) Do(opts ...googleapi.CallOption) (*SasPortalDevice // "path": "v1alpha1/{+name}", // "response": { // "$ref": "SasPortalDevice" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -10706,10 +10527,7 @@ func (c *NodesDevicesListCall) Do(opts ...googleapi.CallOption) (*SasPortalListD // "path": "v1alpha1/{+parent}/devices", // "response": { // "$ref": "SasPortalListDevicesResponse" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -10869,10 +10687,7 @@ func (c *NodesDevicesMoveCall) Do(opts ...googleapi.CallOption) (*SasPortalOpera // }, // "response": { // "$ref": "SasPortalOperation" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -11024,10 +10839,7 @@ func (c *NodesDevicesPatchCall) Do(opts ...googleapi.CallOption) (*SasPortalDevi // }, // "response": { // "$ref": "SasPortalDevice" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -11166,10 +10978,7 @@ func (c *NodesDevicesSignDeviceCall) Do(opts ...googleapi.CallOption) (*SasPorta // }, // "response": { // "$ref": "SasPortalEmpty" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -11308,10 +11117,7 @@ func (c *NodesDevicesUpdateSignedCall) Do(opts ...googleapi.CallOption) (*SasPor // }, // "response": { // "$ref": "SasPortalDevice" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -11450,10 +11256,7 @@ func (c *NodesNodesCreateCall) Do(opts ...googleapi.CallOption) (*SasPortalNode, // }, // "response": { // "$ref": "SasPortalNode" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -11582,10 +11385,7 @@ func (c *NodesNodesDeleteCall) Do(opts ...googleapi.CallOption) (*SasPortalEmpty // "path": "v1alpha1/{+name}", // "response": { // "$ref": "SasPortalEmpty" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -11728,10 +11528,7 @@ func (c *NodesNodesGetCall) Do(opts ...googleapi.CallOption) (*SasPortalNode, er // "path": "v1alpha1/{+name}", // "response": { // "$ref": "SasPortalNode" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -11914,10 +11711,7 @@ func (c *NodesNodesListCall) Do(opts ...googleapi.CallOption) (*SasPortalListNod // "path": "v1alpha1/{+parent}/nodes", // "response": { // "$ref": "SasPortalListNodesResponse" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -12077,10 +11871,7 @@ func (c *NodesNodesMoveCall) Do(opts ...googleapi.CallOption) (*SasPortalOperati // }, // "response": { // "$ref": "SasPortalOperation" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -12232,10 +12023,7 @@ func (c *NodesNodesPatchCall) Do(opts ...googleapi.CallOption) (*SasPortalNode, // }, // "response": { // "$ref": "SasPortalNode" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -12375,10 +12163,7 @@ func (c *NodesNodesDeploymentsCreateCall) Do(opts ...googleapi.CallOption) (*Sas // }, // "response": { // "$ref": "SasPortalDeployment" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -12562,10 +12347,7 @@ func (c *NodesNodesDeploymentsListCall) Do(opts ...googleapi.CallOption) (*SasPo // "path": "v1alpha1/{+parent}/deployments", // "response": { // "$ref": "SasPortalListDeploymentsResponse" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -12725,10 +12507,7 @@ func (c *NodesNodesDevicesCreateCall) Do(opts ...googleapi.CallOption) (*SasPort // }, // "response": { // "$ref": "SasPortalDevice" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -12867,10 +12646,7 @@ func (c *NodesNodesDevicesCreateSignedCall) Do(opts ...googleapi.CallOption) (*S // }, // "response": { // "$ref": "SasPortalDevice" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -13054,10 +12830,7 @@ func (c *NodesNodesDevicesListCall) Do(opts ...googleapi.CallOption) (*SasPortal // "path": "v1alpha1/{+parent}/devices", // "response": { // "$ref": "SasPortalListDevicesResponse" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -13217,10 +12990,7 @@ func (c *NodesNodesNodesCreateCall) Do(opts ...googleapi.CallOption) (*SasPortal // }, // "response": { // "$ref": "SasPortalNode" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -13403,10 +13173,7 @@ func (c *NodesNodesNodesListCall) Do(opts ...googleapi.CallOption) (*SasPortalLi // "path": "v1alpha1/{+parent}/nodes", // "response": { // "$ref": "SasPortalListNodesResponse" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -13550,10 +13317,7 @@ func (c *PoliciesGetCall) Do(opts ...googleapi.CallOption) (*SasPortalPolicy, er // }, // "response": { // "$ref": "SasPortalPolicy" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -13676,10 +13440,7 @@ func (c *PoliciesSetCall) Do(opts ...googleapi.CallOption) (*SasPortalPolicy, er // }, // "response": { // "$ref": "SasPortalPolicy" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } @@ -13802,10 +13563,7 @@ func (c *PoliciesTestCall) Do(opts ...googleapi.CallOption) (*SasPortalTestPermi // }, // "response": { // "$ref": "SasPortalTestPermissionsResponse" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/userinfo.email" - // ] + // } // } } diff --git a/servicemanagement/v1/servicemanagement-api.json b/servicemanagement/v1/servicemanagement-api.json index 3696c4e27e6..92e6ab8dbae 100644 --- a/servicemanagement/v1/servicemanagement-api.json +++ b/servicemanagement/v1/servicemanagement-api.json @@ -791,7 +791,7 @@ ], "parameters": { "filter": { - "description": "Required. Use `filter` to return subset of rollouts. The following filters are supported: -- To limit the results to only those in status 'SUCCESS', use filter='status=SUCCESS' -- To limit the results to those in status 'CANCELLED' or 'FAILED', use filter='status=CANCELLED OR status=FAILED'", + "description": "Required. Use `filter` to return subset of rollouts. The following filters are supported: -- By status. For example, `filter='status=SUCCESS'` -- By strategy. For example, `filter='strategy=TrafficPercentStrategy'`", "location": "query", "type": "string" }, @@ -829,7 +829,7 @@ } } }, - "revision": "20220408", + "revision": "20220415", "rootUrl": "https://servicemanagement.googleapis.com/", "schemas": { "Advice": { diff --git a/servicemanagement/v1/servicemanagement-gen.go b/servicemanagement/v1/servicemanagement-gen.go index 8d17ceb3641..3aaef1a0cc5 100644 --- a/servicemanagement/v1/servicemanagement-gen.go +++ b/servicemanagement/v1/servicemanagement-gen.go @@ -8164,10 +8164,8 @@ func (r *ServicesRolloutsService) List(serviceName string) *ServicesRolloutsList // Filter sets the optional parameter "filter": Required. Use `filter` // to return subset of rollouts. The following filters are supported: -- -// To limit the results to only those in status 'SUCCESS', use -// filter='status=SUCCESS' -- To limit the results to those in status -// 'CANCELLED' or 'FAILED', use filter='status=CANCELLED OR -// status=FAILED' +// By status. For example, `filter='status=SUCCESS'` -- By strategy. For +// example, `filter='strategy=TrafficPercentStrategy'` func (c *ServicesRolloutsListCall) Filter(filter string) *ServicesRolloutsListCall { c.urlParams_.Set("filter", filter) return c @@ -8296,7 +8294,7 @@ func (c *ServicesRolloutsListCall) Do(opts ...googleapi.CallOption) (*ListServic // ], // "parameters": { // "filter": { - // "description": "Required. Use `filter` to return subset of rollouts. The following filters are supported: -- To limit the results to only those in status 'SUCCESS', use filter='status=SUCCESS' -- To limit the results to those in status 'CANCELLED' or 'FAILED', use filter='status=CANCELLED OR status=FAILED'", + // "description": "Required. Use `filter` to return subset of rollouts. The following filters are supported: -- By status. For example, `filter='status=SUCCESS'` -- By strategy. For example, `filter='strategy=TrafficPercentStrategy'`", // "location": "query", // "type": "string" // }, diff --git a/sheets/v4/sheets-api.json b/sheets/v4/sheets-api.json index b8ce8a881de..554e9d087b7 100644 --- a/sheets/v4/sheets-api.json +++ b/sheets/v4/sheets-api.json @@ -169,7 +169,7 @@ ] }, "get": { - "description": "Returns the spreadsheet at the given ID. The caller must specify the spreadsheet ID. By default, data within grids will not be returned. You can include grid data one of two ways: * Specify a field mask listing your desired fields using the `fields` URL parameter in HTTP * Set the includeGridData URL parameter to true. If a field mask is set, the `includeGridData` parameter is ignored For large spreadsheets, it is recommended to retrieve only the specific fields of the spreadsheet that you want. To retrieve only subsets of the spreadsheet, use the ranges URL parameter. Multiple ranges can be specified. Limiting the range will return only the portions of the spreadsheet that intersect the requested ranges. Ranges are specified using A1 notation.", + "description": "Returns the spreadsheet at the given ID. The caller must specify the spreadsheet ID. By default, data within grids is not returned. You can include grid data in one of 2 ways: * Specify a field mask listing your desired fields using the `fields` URL parameter in HTTP * Set the includeGridData URL parameter to true. If a field mask is set, the `includeGridData` parameter is ignored For large spreadsheets, as a best practice, retrieve only the specific spreadsheet fields that you want. To retrieve only subsets of spreadsheet data, use the ranges URL parameter. Ranges are specified using [A1 notation](/sheets/api/guides/concepts#cell). You can define a single cell (for example, `A1`) or multiple cells (for example, `A1:D5`). You can also get cells from other sheets within the same spreadsheet (for example, `Sheet2!A1:C4`) or retrieve multiple ranges at once (for example, `?ranges=A1:D5\u0026ranges=Sheet2!A1:C4`). Limiting the range returns only the portions of the spreadsheet that intersect the requested ranges.", "flatPath": "v4/spreadsheets/{spreadsheetId}", "httpMethod": "GET", "id": "sheets.spreadsheets.get", @@ -208,7 +208,7 @@ ] }, "getByDataFilter": { - "description": "Returns the spreadsheet at the given ID. The caller must specify the spreadsheet ID. This method differs from GetSpreadsheet in that it allows selecting which subsets of spreadsheet data to return by specifying a dataFilters parameter. Multiple DataFilters can be specified. Specifying one or more data filters will return the portions of the spreadsheet that intersect ranges matched by any of the filters. By default, data within grids will not be returned. You can include grid data one of two ways: * Specify a field mask listing your desired fields using the `fields` URL parameter in HTTP * Set the includeGridData parameter to true. If a field mask is set, the `includeGridData` parameter is ignored For large spreadsheets, it is recommended to retrieve only the specific fields of the spreadsheet that you want.", + "description": "Returns the spreadsheet at the given ID. The caller must specify the spreadsheet ID. This method differs from GetSpreadsheet in that it allows selecting which subsets of spreadsheet data to return by specifying a dataFilters parameter. Multiple DataFilters can be specified. Specifying one or more data filters returns the portions of the spreadsheet that intersect ranges matched by any of the filters. By default, data within grids is not returned. You can include grid data one of 2 ways: * Specify a field mask listing your desired fields using the `fields` URL parameter in HTTP * Set the includeGridData parameter to true. If a field mask is set, the `includeGridData` parameter is ignored For large spreadsheets, as a best practice, retrieve only the specific spreadsheet fields that you want.", "flatPath": "v4/spreadsheets/{spreadsheetId}:getByDataFilter", "httpMethod": "POST", "id": "sheets.spreadsheets.getByDataFilter", @@ -870,7 +870,7 @@ } } }, - "revision": "20220322", + "revision": "20220411", "rootUrl": "https://sheets.googleapis.com/", "schemas": { "AddBandingRequest": { diff --git a/sheets/v4/sheets-gen.go b/sheets/v4/sheets-gen.go index abbdc3ed2cc..bf70fc951ce 100644 --- a/sheets/v4/sheets-gen.go +++ b/sheets/v4/sheets-gen.go @@ -11871,17 +11871,21 @@ type SpreadsheetsGetCall struct { } // Get: Returns the spreadsheet at the given ID. The caller must specify -// the spreadsheet ID. By default, data within grids will not be -// returned. You can include grid data one of two ways: * Specify a -// field mask listing your desired fields using the `fields` URL -// parameter in HTTP * Set the includeGridData URL parameter to true. If -// a field mask is set, the `includeGridData` parameter is ignored For -// large spreadsheets, it is recommended to retrieve only the specific -// fields of the spreadsheet that you want. To retrieve only subsets of -// the spreadsheet, use the ranges URL parameter. Multiple ranges can be -// specified. Limiting the range will return only the portions of the -// spreadsheet that intersect the requested ranges. Ranges are specified -// using A1 notation. +// the spreadsheet ID. By default, data within grids is not returned. +// You can include grid data in one of 2 ways: * Specify a field mask +// listing your desired fields using the `fields` URL parameter in HTTP +// * Set the includeGridData URL parameter to true. If a field mask is +// set, the `includeGridData` parameter is ignored For large +// spreadsheets, as a best practice, retrieve only the specific +// spreadsheet fields that you want. To retrieve only subsets of +// spreadsheet data, use the ranges URL parameter. Ranges are specified +// using A1 notation (/sheets/api/guides/concepts#cell). You can define +// a single cell (for example, `A1`) or multiple cells (for example, +// `A1:D5`). You can also get cells from other sheets within the same +// spreadsheet (for example, `Sheet2!A1:C4`) or retrieve multiple ranges +// at once (for example, `?ranges=A1:D5&ranges=Sheet2!A1:C4`). Limiting +// the range returns only the portions of the spreadsheet that intersect +// the requested ranges. // // - spreadsheetId: The spreadsheet to request. func (r *SpreadsheetsService) Get(spreadsheetId string) *SpreadsheetsGetCall { @@ -12004,7 +12008,7 @@ func (c *SpreadsheetsGetCall) Do(opts ...googleapi.CallOption) (*Spreadsheet, er } return ret, nil // { - // "description": "Returns the spreadsheet at the given ID. The caller must specify the spreadsheet ID. By default, data within grids will not be returned. You can include grid data one of two ways: * Specify a field mask listing your desired fields using the `fields` URL parameter in HTTP * Set the includeGridData URL parameter to true. If a field mask is set, the `includeGridData` parameter is ignored For large spreadsheets, it is recommended to retrieve only the specific fields of the spreadsheet that you want. To retrieve only subsets of the spreadsheet, use the ranges URL parameter. Multiple ranges can be specified. Limiting the range will return only the portions of the spreadsheet that intersect the requested ranges. Ranges are specified using A1 notation.", + // "description": "Returns the spreadsheet at the given ID. The caller must specify the spreadsheet ID. By default, data within grids is not returned. You can include grid data in one of 2 ways: * Specify a field mask listing your desired fields using the `fields` URL parameter in HTTP * Set the includeGridData URL parameter to true. If a field mask is set, the `includeGridData` parameter is ignored For large spreadsheets, as a best practice, retrieve only the specific spreadsheet fields that you want. To retrieve only subsets of spreadsheet data, use the ranges URL parameter. Ranges are specified using [A1 notation](/sheets/api/guides/concepts#cell). You can define a single cell (for example, `A1`) or multiple cells (for example, `A1:D5`). You can also get cells from other sheets within the same spreadsheet (for example, `Sheet2!A1:C4`) or retrieve multiple ranges at once (for example, `?ranges=A1:D5\u0026ranges=Sheet2!A1:C4`). Limiting the range returns only the portions of the spreadsheet that intersect the requested ranges.", // "flatPath": "v4/spreadsheets/{spreadsheetId}", // "httpMethod": "GET", // "id": "sheets.spreadsheets.get", @@ -12061,14 +12065,14 @@ type SpreadsheetsGetByDataFilterCall struct { // GetSpreadsheet in that it allows selecting which subsets of // spreadsheet data to return by specifying a dataFilters parameter. // Multiple DataFilters can be specified. Specifying one or more data -// filters will return the portions of the spreadsheet that intersect -// ranges matched by any of the filters. By default, data within grids -// will not be returned. You can include grid data one of two ways: * -// Specify a field mask listing your desired fields using the `fields` -// URL parameter in HTTP * Set the includeGridData parameter to true. If -// a field mask is set, the `includeGridData` parameter is ignored For -// large spreadsheets, it is recommended to retrieve only the specific -// fields of the spreadsheet that you want. +// filters returns the portions of the spreadsheet that intersect ranges +// matched by any of the filters. By default, data within grids is not +// returned. You can include grid data one of 2 ways: * Specify a field +// mask listing your desired fields using the `fields` URL parameter in +// HTTP * Set the includeGridData parameter to true. If a field mask is +// set, the `includeGridData` parameter is ignored For large +// spreadsheets, as a best practice, retrieve only the specific +// spreadsheet fields that you want. // // - spreadsheetId: The spreadsheet to request. func (r *SpreadsheetsService) GetByDataFilter(spreadsheetId string, getspreadsheetbydatafilterrequest *GetSpreadsheetByDataFilterRequest) *SpreadsheetsGetByDataFilterCall { @@ -12169,7 +12173,7 @@ func (c *SpreadsheetsGetByDataFilterCall) Do(opts ...googleapi.CallOption) (*Spr } return ret, nil // { - // "description": "Returns the spreadsheet at the given ID. The caller must specify the spreadsheet ID. This method differs from GetSpreadsheet in that it allows selecting which subsets of spreadsheet data to return by specifying a dataFilters parameter. Multiple DataFilters can be specified. Specifying one or more data filters will return the portions of the spreadsheet that intersect ranges matched by any of the filters. By default, data within grids will not be returned. You can include grid data one of two ways: * Specify a field mask listing your desired fields using the `fields` URL parameter in HTTP * Set the includeGridData parameter to true. If a field mask is set, the `includeGridData` parameter is ignored For large spreadsheets, it is recommended to retrieve only the specific fields of the spreadsheet that you want.", + // "description": "Returns the spreadsheet at the given ID. The caller must specify the spreadsheet ID. This method differs from GetSpreadsheet in that it allows selecting which subsets of spreadsheet data to return by specifying a dataFilters parameter. Multiple DataFilters can be specified. Specifying one or more data filters returns the portions of the spreadsheet that intersect ranges matched by any of the filters. By default, data within grids is not returned. You can include grid data one of 2 ways: * Specify a field mask listing your desired fields using the `fields` URL parameter in HTTP * Set the includeGridData parameter to true. If a field mask is set, the `includeGridData` parameter is ignored For large spreadsheets, as a best practice, retrieve only the specific spreadsheet fields that you want.", // "flatPath": "v4/spreadsheets/{spreadsheetId}:getByDataFilter", // "httpMethod": "POST", // "id": "sheets.spreadsheets.getByDataFilter", diff --git a/tpu/v1/tpu-api.json b/tpu/v1/tpu-api.json index ba03d434d20..345816125a7 100644 --- a/tpu/v1/tpu-api.json +++ b/tpu/v1/tpu-api.json @@ -144,7 +144,7 @@ ], "parameters": { "filter": { - "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like \"displayName=tokyo\", and is documented in more detail in [AIP-160](https://google.aip.dev/160).", + "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).", "location": "query", "type": "string" }, @@ -659,7 +659,7 @@ } } }, - "revision": "20220301", + "revision": "20220412", "rootUrl": "https://tpu.googleapis.com/", "schemas": { "AcceleratorType": { @@ -678,7 +678,7 @@ "type": "object" }, "Empty": { - "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.", + "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", "id": "Empty", "properties": {}, "type": "object" diff --git a/tpu/v1/tpu-gen.go b/tpu/v1/tpu-gen.go index 164ddcc6642..9aba5ded5b3 100644 --- a/tpu/v1/tpu-gen.go +++ b/tpu/v1/tpu-gen.go @@ -246,8 +246,7 @@ func (s *AcceleratorType) MarshalJSON() ([]byte, error) { // duplicated empty messages in your APIs. A typical example is to use // it as the request or the response type of an API method. For // instance: service Foo { rpc Bar(google.protobuf.Empty) returns -// (google.protobuf.Empty); } The JSON representation for `Empty` is -// empty JSON object `{}`. +// (google.protobuf.Empty); } type Empty struct { // ServerResponse contains the HTTP response code and headers from the // server. @@ -1154,8 +1153,8 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall // Filter sets the optional parameter "filter": A filter to narrow down // results to a preferred subset. The filtering language accepts strings -// like "displayName=tokyo", and is documented in more detail in AIP-160 -// (https://google.aip.dev/160). +// like "displayName=tokyo", and is documented in more detail in +// AIP-160 (https://google.aip.dev/160). func (c *ProjectsLocationsListCall) Filter(filter string) *ProjectsLocationsListCall { c.urlParams_.Set("filter", filter) return c @@ -1284,7 +1283,7 @@ func (c *ProjectsLocationsListCall) Do(opts ...googleapi.CallOption) (*ListLocat // ], // "parameters": { // "filter": { - // "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like \"displayName=tokyo\", and is documented in more detail in [AIP-160](https://google.aip.dev/160).", + // "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).", // "location": "query", // "type": "string" // },